Jekyll 简介

 “Jekyll 是一个简单的博客形态的静态站点生产机器。它有一个模版目录,其中包含原始文本格式的文档,通过一个转换器(如 Markdown)和我们的 Liquid 渲染器转化成一个完整的可发布的静态网站,你可以发布在任何你喜爱的服务器上。Jekyll 也可以运行在 GitHub Page 上,也就是说,你可以使用 GitHub 的服务来搭建你的项目页面、博客或者网站,而且是完全免费的。” jekyll image

 通过参考使用 Jekyll 创建 GitHub Pages 站点可以很快捷地在github.io域名下建立自已的站点。

要在本地环境中修改编缉网站需要下载安装jekyll到本地环境。

在windows上安装Jekyll可以参考官方教程,安装非常方便。

  1. 下载RubyInstaller Downloads,并且用默认的设置完成安装。
  2. 在安装引导程序的最后一步的命令行界面输入ridk install命令并运行。这将安装和ruby相配套的Gems,在选项框勾选MSYS2 and MINGW development tool chain选项。
  3. 打开Cmd命令行窗口,输入gem install jekyll bundler命令安装jekyll和bundler。(bundler是在ruby项目中管理gem包依赖的工具)
  4. 验证Jekyll是否成功安装,可以在命令行输入:jekyll -v。

安装Jekyll之后

可以git clone github上创建的git page repository的站点分支到本地,然后在本地站点文件夹中执行命令 jekyll build ,jekyll将在此目录中构建一个静态网站所需要的目录结构,构建完成后的网站文件会放在_site文件夹下,其余主要文件夹的目录结构通常为:

jekyll目录结构

index.html或index.md是站点的入口,在命令行中运行 bundle exec jekyll server 可以在打开一个web服务器,在网页上的更改编缉可以通过localhost:4000地址查看更改的效果。