使用Jekyll Bootstrap搭建博客时出现的问题

这里简单记录了我在使用 Jekyll-Bootstrap 搭建博客时出现的问题以及它们的解决方案。

  1. 使用 jekyll-sort 插件以支持对 page 的排序。这在生成页面导航时非常有用。
  2. 使用 jekyll-lunr-js-search 插件以支持对博客的全文搜索。该插件在生成搜索内容的时候有一些小问题,具体可以参考 这里
  3. 因为 github 不允许 jekyll 的 plugin 运行 的,因此我创建了一个 site_source 的分支,将 Jekyll-Bootstrap 的源码提交进去,然后将生成的 site 提交到 master 分支中。
  4. 虽然不想修改 hooligan (主题)的源码,但最终还是不得不进行了妥协。在可扩展性上 jekyll 应该还能更进一步,或许可以参考下 modex 的模板系统。
  5. 若在生成 page 或 post 时报错 “invalid byte sequence in GBK (ArgumentError)”,参考 这里
  6. 除了 Jekyll-Bootstrap 还有 ruhoh 可以做同样的事情。

参考内容:

  1. 理想的写作环境:git+github+markdown+jekyll
  2. Zero to Hosted Jekyll Blog in 3 Minutes
  3. Jekyll is a blog-aware, static site generator in Ruby
  4. Markdown 语法说明 (简体中文版)
  5. GitHub Flavored Markdown
  6. Pages don’t build: “Unable to run Jekyll”