如何在 github.io 上使用 Jekyll 制作一本书

Question

我在 GitHub 存储库（书）中有大约 1000 个常规静态 html 页面。我经常使用特殊程序编辑这些页面。每个页面只包含内容；没有页眉、页脚或目录。 我想使用 Jekyll 在 Github Pages 上托管它们，以便每个页面都有页眉、页脚和导航块——浏览器左侧的树状目录。目录也是一个准备好的静态html文件，全书通用。

最简单的方法是使用框架，但这并不是最佳选择。

我希望结果类似于https://rust-lang-nursery.github.io/rust-cookbook/

我已经扫描了 github（在所有存储库中搜索 _config.yml 文件），但没有发现 Jekyll 的任何类似用途。 我可以用 Jekyll 做这样的事情吗？

Answer 1

这是 Jekyll 等静态站点生成器的理想用例：

• 您可能需要将内容转换为 Markdown 或根据 HTML 进行清理
• 每个页面都有一个带有页眉、页脚和导航的通用布局
• 您可以通过在单独的模板中迭代您的页面来为目录制作单独的页面

这里并没有真正简洁的答案，只是学习更多 Jekyll 的功能集以熟悉上面提到的概念：

• https://jekyllrb.com/docs/
• https://cloudcannon.com/community/learn/jekyll-101/

这是一个带有现场演示的模板，用于托管一本书。您可以以此为起点：https://github.com/CloudCannon/author-jekyll-template