jeklly本地服务器搭建及使用

方便日后换电脑配置博客环境

Posted by Leezw on February 22, 2018

换了新笔记本,发现得从新配置jeklly环境。
发现搜到的文章没有能一步到位的,还是自己记录一篇。
所以步骤从0开始记录一下,可以实时本地编译,不用频繁上传github

安装 Ruby Version Manager (RVM)

(可选操作,如果需要升级ruby,需要此步骤)
命令粘贴至终端

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

如果报错:Failed to connect to raw.githubusercontent.com port 443: Operation timed out

先去 https://githubusercontent.com.ipaddress.com/raw.githubusercontent.com 这个链接获取raw.githubusercontent.com的ip地址 然后修改host文件(路径:/etc/) 添加:

IP地址 raw.githubusercontent.com

然后再执行安装命令

安装Ruby环境

mac自带ruby,windows则下载 rubyinstaller 并运行,安装后再命令行输入

ruby -- version
ruby - v

查看是否安装成功,如果无法查看需重启或手动添加bin目录到环境变量

安装Gem

Gem是Ruby第三方插件管理器,官网安装教程:https://rubygems.org/pages/download
下载Gem到本地后,在终端输入如下代码

## 检查gem版本
gem -v
## 更新Gem(提示权限)
gem update --system

gem update –system。这一步需要翻墙,否则会出现404错误。解决办法参考:https://ruby.taobao.org/

安装Jekyll
## 安装jekyll(提示权限)
gem install jekyll
## 安装成功之后,查看版本号
jekyll -v

出现Gem::RemoteFetcher::FetchError) 则可能需要代理服务器 在本地仓库下使用touch Gemfile创建一个Gemfile,添加文本 source 'https://rubygems.org' gem 'github-pages'

使用Jekyll

打开终端,先cd到本地的 **.github.io 文件目录下,然后执行以下命令,开启服务器并实时编译(control+c 关闭)

jekyll serve -w

服务器启动后会,默认将项目自动编译在_site文件夹下,使用git提交的时候记得在项目文件中添加.gitignore 文件,并添加“_site/”

使用浏览器浏览

在浏览器中输入 http://localhost:4000 即可访问博客站点
不能访问请检查_config.yml配置文件是否需要修改

较老版本使用 jekyll –server 执行 jekyll build 命令报错

ERROR: YOUR SITE COULD NOT BE BUILT:
   Missing dependency: rdiscount

解决:rdiscount是 Jekyll依赖的一个包,可以通过安装这个包来解决。
安装rdiscount

gem install rdiscount

如果缺少其他包,同理使用 gem install 解决

安装各种依赖包的时候可能会提示权限不足,比如安装rdiscount提示我/usr/bin没有写入权限 解决:

sudo chmod -R 777

安装完毕后将/usr/bin权限设置回操作前的权限。否则下次终端启动时可能报错。