开始在 GitHub 上写博客

准备工作如下

申请 GitHub 账户并准备代码库

安装 Jekyll

安装 Ruby

  • 如果用的是 Windows 系统, 需要先安装 Ruby , 需要下载 1.9.3 版本的 Ruby , 并且还要安装 DevKit 。
  • 如果是 Linux 或者 MAC 系统的话, 系统一般会自带 Ruby , 就不需要再安装 Ruby 了。

安装 Jekyll 引擎

打开一个命令行窗口, 输入下面的命令可以安装 Jekyll :

gem update system
gem install jekyll

如果提示有什么不兼容或者提示缺少什么库, 根据提示安装即可。

制作 Jekyll 主题模版

JekBootStrap 提供了几个主题, 如果你喜欢或者懒得动手, 直接下载一个就可以开始了。

当让, 也可以自己动手做一个。

上传文件

上传文件最简单了, 不过我的建议是在本地运行 jekyll --server , 先预览一下, 确认无误之后再上传。 只要用 Git 提交上去即可。 大约过一分钟, 新的 Github 页面就生成了, 输入 https://your-username.github.com 就可以浏览。

注意问题

  • 如果将运行 jekyll --server 之后, _site 目录下没有生成任何文件, 只要将 _config.yml 中的 auto 配置为 false , 再运行 jekyll --server ,看看错误信息, 一般都可以解决的;
  • 在 windows 系统平台上, 如果你的博客包含中文字符, 则需要将当前命令行的代码页修改为 65001 (UTF8) 才能正常运行;
  • 不要使用 windows 记事本编辑文件, 因为记事本保存的编码是 UTF8 + BOM , 无法保存为不带 BOM 的 UTF8 。