在 GitHub Pages Jekyll 站点上呈现 GitHub wiki

Question

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

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

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

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

Answer 1

这个想法是：

1. 下载我的插件
2. 阅读文档
3. 安装和耙
4. 喝啤酒

安装和配置后 raketask/插件正在做什么（5 分钟）：

1. rake wikisub添加一个指向你的 wiki 的 git 子模块。 必须是公共维基，但可以在另一个存储库上
2. 将下载的 wiki 页面复制和转换为带有 yaml 前台的 Markdown
3. 构建 Jekyll，然后插件拦截 wiki 页面链接转换，将它们转换为 Jekyll 链接
4. 订购比萨饼

目前唯一的问题（或不是）是 Kramdown 与 Github markdown 的关系不佳。 你必须切换到红地毯。

其他两个任务可用：

• rake wikibuild : 重建维基页面

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

跳！