搭建自己的GitHub Pages

2.1 安装 Ruby 环境#

下载 Ruby 环境和开发者工具包。下载地址：Ruby Windows 平台。

Ruby 环境安装包：

Ruby DevKit 安装包：

安装完成后打开命令行(或 Win + R, 输入 cmd 回车)输入 ruby -version ：

2.2 安装 Jekyll#

在命令行中使用如下命令安装 Jekyll:

1
> gem install jekyll

笔者出现安装失败的情况。Google 之后一说百说的推荐了淘宝 Gem 仓库，但是博主无法成功更换使用淘宝的 Gem（HTTPS）。(淘宝的 Gem 目前已不支持 Http 连接)。 经过一番研究解决,博主命令如下:

1
> gem sources --remove https://rubygems.org/ -a http://rubygems.org/

怀疑可能是 Windows Installer 安装的 Ruby 对 Https 支持不是很好。更换为 http 源就解决问题了。

2.3 markdown 文档解析#

Jekyll 默认的 md 文档解析器是 kramdown，缺省的代码高亮插件是 rouge。详细的缺省配置见:Jekyll 缺省配置.

未安装的可以使用以下命令安装.

1
> gem install kramdown
2
> gem install rouge

2.4 代码高亮#

无代码高亮需求的小伙伴无视本节内容即可。Jekyll 相关的代码高亮插件有很多。本站使用 CodeRay + rouge 实现代码高亮。示例配置如下:

1
markdown: kramdown  #  [rdiscount, karkdown]
2
highlighter: rouge #  [rouge, pygments]
3
kramdown:
4
  input: GFM
5
  extensions:
6
    - autolink
7
    - footnotes
8
    - smart
9
  enable_coderay: true
10
  syntax_highlighter: rouge
11
  coderay:
12
    coderay_line_numbers:  nil

2.4 创建 Jekyll 模板#

创建一个简单的缺省页面示例。

1
> jekyll new myblog
2
> jekyll build
3
> jekyll server

在浏览器访问127.0.0.1:4000预览文字及内容

本站使用的是 Jekyll-uno 模板，遵循 MIT 开源协议(博主通过 Google 搜索出来的)。