git - 在 GitHub Pages Jekyll 站点上呈现 GitHub wiki

Question

我有一个包含 80 多页 wiki 的知识库。我想在项目的 Jekyll (GitHub Pages) 网站上呈现所有 wiki 页面的索引，并使用自定义布局呈现网站上的每个页面，并使用网站其余部分的样式。

为此，我的第一直觉是使用 git 子模块将来自 wiki 的页面(GitHub 作为 git 存储库公开)包含在 Jekyll 站点的存储库中。但就我所知:据我所知，Jekyll 不会接受不符合帖子要求的 Markdown 文件。它们没有以日期命名，也没有任何前言，所以 Jekyll 会忽略它们。

为了解决这个问题，我通常只写一个插件来做我想做的事。但是因为该站点托管在 GitHub 页面上，所以它不允许我创建的任何插件。

所以，我真的不知道如何进行。甚至没有自定义插件也可能吗？

Answer 1

想法是:

1. 下载我的plugin
2. 阅读文档
3. 安装并抓取
4. 喝啤酒

安装和配置后 raketask/插件正在做什么(5 分钟):

1. rake wikisub 添加一个指向您的 wiki 的 git 子模块。必须是公共(public)维基，但可以在另一个存储库上
2. 复制下载的 wiki 页面并将其转换为带有 yaml front matter 的 markdown
3. 构建 Jekyll，然后插件拦截 wiki 页面链接转换，将它们转换为 Jekyll 链接
4. 点披萨

目前唯一的问题(或不是)是 Kramdown 不能很好地与 Github markdown 兼容。你必须切换到红地毯。

还有两个任务可用:

• rake wikibuild : 重建 wiki 页面

• rake wiki:同步 wiki 页面，构建并选择性地将更改推送到 Jekyll 存储库

再跳!