一、搭建本地Jekyll环境
注:安装jekyll会用到ruby,最好不要用系统自带的,使用系统提供的ruby会出现没有权限问题,建议使用rbenv新安装一个ruby使用。
具体使用rbenv安装ruby可以参考: Mac环境配置
- 设置全局ruby版本
$ rbenv global 2.6.0 #例如设置新安装的2.6.0版本为全局版本 $ gem env home #验证gem
- 使用gem安装Jekyll
$ gem install jekyll
- 安装bundler
$ gem install bundler
- 使用Jekyll创建博客仓库
$ jekyll new blog
- 进入blog目录 开启Jekyll服务
$ cd blog $ jekyll serve
Jekyll服务默认端口是4000,打开浏览器,输入:http://localhost:4000就能看到一个简单的博客页面。
二、Jekyll的一些常用命令
当前文件夹中的内容将会生成到 ./_site 文件夹中。
$ jekyll build
当前文件夹中的内容将会生成到目标文件夹<destination>中。
$ jekyll build --destination <destination>
指定源文件夹<source>中的内容将会生成到目标文件夹<destination>中。
$ jekyll build --source <source> --destination <destination>
当前文件夹中的内容将会生成到 ./_site 文件夹中,查看改变,并且自动再生成。
$ jekyll build --watch
一个开发服务器将会运行在 http://localhost:4000/
$ jekyll serve
功能和`jekyll serve`命令相同,但是会脱离终端在后台运行。
如果你想关闭服务器,可以使用`kill -9 1234`命令,"1234" 是进程号(PID)。
如果你找不到进程号,那么就用`ps aux | grep jekyll`命令来查看,然后关闭服务器。
$ jekyll serve --detach
三、Jeykll的目录结构
├── _config.yml (配置文件)
├── _drafts (drafts(草稿)是未发布的文章)
| ├── begin-with-the-crazy-ideas.textile
| └── on-simplicity-in-technology.markdown
├── _includes (加载这些包含部分到你的布局)
| ├── footer.html
| └── header.html
├── _layouts (包裹在文章外部的模板)
| ├── default.html
| └── post.html
├── _posts (这里都是存放文章)
| ├── 2007-10-29-why-every-programmer-should-play-nethack.textile
| └── 2009-04-26-barcamp-boston-4-roundup.textile
├── _site (生成的页面都会生成在这个目录下)
├── .jekyll-metadata (该文件帮助 Jekyll 跟踪哪些文件从上次建立站点开始到现在没有被修改,哪些文件需要在下一次站点建立时重新生成。该文件不会被包含在生成的站点中。)
└── index.html (网站的index)
四、最后一些链接
1. 主题网站,喜欢哪个下载下来改改CSS就可以用了
2. 冰霜之地大神的博客
如何快速给自己构建一个温馨的”家”——用 Jekyll 搭建静态博客
3.疑难杂症解决链接
You don’t have write permissions for the /Library/Ruby/Gems/2.0.0 directory