如何通过GitHub Pages创建自己的个人网站

这篇博客将展示如何像这样创建自己的网站的步骤。

组件: GitHub Pages, Jekyll, Minimal Mistakes

1. GitHub Pages

设置你的 GitHub Pages: 官方指南 清晰明了。

2. Jekyll

设置 Jekyll: 你可以通过GitHub Pages网站底部的链接或者这里访问Jekyll文档。

  1. 按照 Prerequisites 中的步骤执行并运行
    gem install jekyll bundler
  2. 确保你处于本地项目文件夹(即你刚克隆的GitHub仓库所在目录),如果不是,请运行 cd your_repository_location
  3. 运行
    jekyll new --skip-bundle
  4. 打开Jekyll创建的 Gemfile
  5. 在以 gem "jekyll" 开头的行前添加 "#" 以注释掉该行。
  6. 通过编辑以 # gem "github-pages" 开头的行添加 github-pages gem,将该行修改为: gem "github-pages", "~> GITHUB-PAGES-VERSION", group: :jekyll_plugins
  7. 替换 GITHUB-PAGES-VERSION 为最新支持的 github-pages gem版本。你可以在 这里 查找该版本。
  8. 运行
    bundle install

    故障排除
    - 如果出现 "wdm" 的错误,试着在 Gemfile 中注释掉这行: gem "wdm", "~> 0.1.1", :platforms => [:mingw, :x64_mingw, :mswin]
    - 每次修改 Gemfile 后,记得运行 bundle installbundle update

  9. 构建 网站并在本地服务器上查看
    bundle exec jekyll serve

到此为止,Jekyll 安装应该完成,你可以在 _config.yml 中进行自定义。更多详细信息请参见 官方指南

3. Minimal Mistakes

设置 Minimal Mistakes(一个Jekyll主题):

  1. 前往 Minimal Mistakes 文档 并通过 Remote theme method 进行安装。
  2. 到此为止,Minimal Mistakes 应该已经设置完成,你可以根据 官方配置 进行自定义。
  3. 你也可以查看 Minimal Mistakes 的GitHub仓库 的示例页面以供参考。

    注意: 运行 bundle exec jekyll serve 后,_site/中的所有内容将会被重建。因此,请记得将你的文件存放在其他位置。

现在,你的网站构建完成了!