StepByStep教程

1. 环境配置

欢迎来到 Jekyll 的 step-by-step 教程. 本教程的目标是:让一个拥有一点前端网络开发经验的人,能够在不依靠默认 gem-based 主题的前提下,从头开始创建第一个 Jekyll 网站 . 让我们开始吧 !

安装

Jekyll 是一个 Ruby 程序,所以首先要在本地电脑上安装 Ruby. 转到 安装指南 ,并依照你的操作系统的说明操作.

使用 Ruby 安装程序,你可以在终端中运行以下命令来安装 Jekyll:

gem install jekyll bundler

创建一个新的 Gemfile 来列出项目的依赖项,运行:

bundle init

编辑这个 Gemfile 并将 jekyll 添加为依赖项:

gem "jekyll"

最后运行 bundle 来为你的项目安装 jekyll.

现在,你可以在本教程列出的所有 jekyll 命令前面加上 bundle exec 前缀,以保证你使用的 jekyll 是 Gemfile 定义的版本 .

创建网站

是时候创建一个站点了! 为你的站点新建一个文件夹, 你可以随便命名. 本教程中,我们命名为 “root” .

If you’re feeling adventurous, you can also initialize a Git repository here. One of the great things about Jekyll is there’s no database. All content and site structure are files which a Git repository can version. Using a repository is completely optional but it’s a great habit to get into. You can learn more about using Git by reading through the Git Handbook.

让我们来添加第一个文件. 在根目录下创建 index.html 文件,其内容如下:

<!doctype html>
<html>
  <head>
    <meta charset="utf-8">
    <title>主页</title>
  </head>
  <body>
    <h1>Hello World!</h1>
  </body>
</html>

构建

Jekyll 是一个静态网站生成器,所以我们需要 Jekyll 事先构建网站,然后才能浏览它。可以在站点根目录下运行以下两条命令来构建它:

  • jekyll build - 构建站点并将静态站点输出到名为 _site 的文件夹中.
  • jekyll serve - 除了与上一条做同样的事情外, 还在你做更改时实时重构,同时运行一个本地网站服务器,网址为:http://localhost:4000.

当你正在开发一个站点时,可以使用 jekyll serve 命令,因为他会实时更新你所做的任何更改.

运行 jekyll serve 并在浏览器中打开 http://localhost:4000. 你应该会看到 “Hello World!”.

Well, 你可能在想这有什么意义? Jekyll 只是把一个 HTML 文件从一个地方复制到了另一个地方。 耐心点吧,年轻人, 这才刚刚开始!

上一页
  1. 环境配置
  2. Liquid 语言
  3. Front Matter
  4. 网站布局
  5. Includes
  6. 数据文件
  7. 资源
  8. 博客
  9. 集合 Collections
  10. 部署