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

Posted 2023-03-28

【中文标题】如何在 github.io 上使用 Jekyll 制作一本书

【英文标题】：How to make a book using Jekyll on github.io

【发布时间】：2021-10-08 23:06:45

【问题描述】：

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

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

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

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

【参考方案1】：

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

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

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

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

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