换了新笔记本,发现得从新配置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权限设置回操作前的权限。否则下次终端启动时可能报错。