jekylljekyll入门


备注

Jekyll是一个简单的,支持博客的静态站点生成器。它需要一个模板目录,其中包含各种格式的原始文本文件,通过转换器(如Markdown)及其Liquid渲染器运行它,并吐出一个完整的,准备发布的静态网站,适合与您喜欢的Web服务器一起提供服务。 Jekyll也是GitHub Pages背后的引擎,这意味着您可以使用Jekyll免费从GitHub的服务器托管您项目的页面,博客或网站。

Jekyll的网站位于http://jekyllrb.com/ ,文档可在http://jekyllrb.com/docs/home/找到。


最新发布的:

宝石版

基本用法

Jekyll gem在终端窗口中为您提供了一个jekyll可执行文件。您可以通过多种方式使用此命令:

$ jekyll build
# => The current folder will be generated into ./_site

$ jekyll build --destination <destination>
# => The current folder will be generated into <destination>

$ jekyll build --source <source> --destination <destination>
# => The <source> folder will be generated into <destination>

$ jekyll build --watch
# => The current folder will be generated into ./_site,
#    watched for changes, and regenerated automatically.
 

Jekyll还附带了一个内置的开发服务器,允许您在本地浏览器中预览生成的网站的外观。

$ jekyll serve
# => A development server will run at http://localhost:4000/
# Auto-regeneration: enabled. Use `--no-watch` to disable.
 

创建Jekyll帖子和页面

创建新的Jekyll Post

要创建新的Jekyll Post,请在_posts 目录中使用该格式创建一个新文件

YYYY-MM-DD-title.MARKUP
 

MARKUP 替换为您要使用的语言的文件扩展名。这通常是Markdown(.md或.markdown)或HTML(.html)。

_posts/2017-01-01-hello-jekyll.md
 

创建新的Jekyll页面

要创建新的Jekyll页面,请在项目目录中未被Jekyll排除的任何文件夹或目录上创建新文件。

about.html
contact/company_info.md
 

注意: PagePost 文件都需要考虑Front Matter破折号进行处理。否则,它们只是被指定为StaticFile

Front Matter破折号应该在您的内容之前的最开始,并且看起来像这样:

---
---

< your content >
 

在Linux Mint上安装Jekyll 18

使用以下步骤在Linux Mint 18上安装jekyll:

sudo apt install ruby
sudo apt install build-essential 
sudo apt install ruby-dev
sudo gem install jekyll
 

在Windows上安装Jekyll

  1. 使用管理员访问权限打开命令提示符
  2. 安装Chocolatey: @powershell -NoProfile -ExecutionPolicy Bypass -Command "iex ((new-object net.webclient).DownloadString('https://chocolatey.org/install.ps1'))" && SET PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin
  3. 关闭命令提示符,因为在您关闭并重新打开之前,Chocolatey将不可用。
  4. 使用管理员访问权限打开命令提示符
  5. Intall Ruby: choco install ruby -y
  6. 使用管理员访问权限关闭并打开新的命令提示符
  7. 安装Jekyll: gem install jekyll

在这里找到这个指南。

安装或设置

Jekyll的快速​​入门

 $ gem install jekyll
 $ jekyll new my-awesome-site
 $ cd my-awesome-site
~/my-awesome-site $ jekyll serve
 

现在浏览到http:// localhost:4000


Jekyll与Bundler的快速入门

 $ gem install jekyll bundler
 $ jekyll new my-awesome-site
 $ cd my-awesome-site
~/my-awesome-site $ bundle exec jekyll serve
 

现在浏览到http:// localhost:4000