第零步: 环境准备

• 启动XShell
• 连接到Linux虚拟机上面
• 安装Git 和 Vim (git是一个分布式版本控制系统,vim是一个编辑器,Linux上面很好用的编辑器);
• 配置Git 和 Vim 参数

安装jekyll环境 (因为jekyll是用ruby语言开发的,所以要安装ruby语言环境,ruby要用最新版)

• 安装 wget
• 安装 bzip2
• 安装 ruby install(这是用来安装 ruby最新版 的工具) 安装的步骤比较麻烦我这里整理出来了几个步骤。

    1. wget -O ruby-install-0.6.1.tar.gz https://github.com/postmodern/ruby-install/archive/v0.6.1.tar.gz
    2. -xzvf ruby-install-0.6.1.tar.gz   
    3. cd ruby-install-0.6.1/
    4. make install
    5. ruby-install --system ruby
    6. 等到提示 >>> Sucessfully  installed ruby .... 这样就安装成功了,使用ruby -v 检查是否成功

安装 jekyll

• gem install jekyll 如果安装不成功的话可能是缺少 g++ 和 gcc 编译环境

安装 bundler

• gem install bundler

到这里就安装成功了jekyll

第一步: 在远程仓库创建项目

• 在 GitHub 上面创建一个空仓库:jekyll-demo
• 在该仓库启用 GitHub Pages 设置
• 在自己的电脑上克隆这个仓库

ps：这里使用的是 jekyll-demo，如果要使用自己的用户名访问的话，比如 allenleic.github.io 就要把仓库的名字设置为 用户名+github.io。

第二步: 创建配置文件

• 在项目根目录下面创建一个_config.yml 的文本文件

目录结构变成:

   /jekyll-demo
      |-- _config.yml

第三步: 创建模板文件

• 在项目根目录下面创建一个_layouts 目录,用于存放模板文件
• 在该目录下,创建一个 default.html 文件,作为Blog 的默认模板

目录结构变为

   /jekyll-demo
       |-- _config.yml
       |-- _layouts
       |       |-- default.html

第四步: 创建文章

• 在项目根目录创建一个_posts 文件夹,用于存放 blog 文章

目录结构变成了:

   /jekyll-demo
       |-- _config.yml
       |-- _layouts
       |       |-- default.html
       |-- _posts
       |       |-- 2018-03-12-hello-jekyll.md

第五步: 创建首页

• 在项目根目录创建一个 index.md 文件

目录结构变成了

   /jekyll-demo
       |-- _config.yml
       |-- _layouts
       |       |-- default.html
       |-- _posts
       |       |-- 2018-03-12-hello-jekyll.md
       |-- index.md

第六步: 发布内容

• 把所有的内容先加入本地的 git 仓库
• 在本地仓库利用 git 命令把内容推送到远程仓库
• 通过浏览器访问这个博客

第七步: 绑定域名

• 在域名管理网站添加域名为 CNAME 记录
• 推荐 www 和没有 www 的都添加

适用范围

本教程适合完全没有接触过 jekyll 的人来使用，目的是为了让大家了解 jekyll 的目录结构，以及体会到 jekyll 使用起来其实是非常的方便的。目前 GitHub 上面的 GitHub Pages 就是使用的jekyll 引擎的。

转载请注明: 雷聪的博客 » 点击阅读原文