在GitHub Pages Jekyll网站上呈现GitHub wiki

Question

我有一个存储库,其中包含一个超过80页的wiki.我想在项目的Jekyll(GitHub页面)站点上呈现所有Wiki页面的索引,以及使用自定义布局渲染网站上的每个页面,并使用站点其余部分的样式.

要做到这一点,我的第一直觉是使用git子模块来包含来自wiki的页面(GitHub公开为git repo)在Jekyll站点的repo中.但就我而言:据我所知,Jekyll无处可接受不符合帖子的降价文件.它们没有以日期命名,并且它们没有任何前沿,所以Jekyll只是忽略了它们.

为了解决这个问题,我通常会编写一个插件来完成我想要的操作.但由于该网站托管在GitHub页面上,因此不允许我创建任何插件.

所以,我真的不知道该怎么做.没有自定义插件,它甚至可能吗？

Answer 1

这个想法是:

1. 下载我的插件:https://github.com/djacquel/WikiToJekyll
2. 阅读文档
3. 安装和耙
4. 喝啤酒

我在这里测试了它:https://github.com/djacquel/JekyllTest/tree/gh-pages 这个维基页面:https://github.com/djacquel/JekyllTest/wiki

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

1. rake wikisub添加一个指向你的wiki的git子模块.必须是公共wiki,但可以在另一个存储库中
2. 使用yaml front matter复制并转换下载的wiki页面作为markdown
3. 构建Jekyll,然后插件拦截wiki页面链接转换,将它们转换为Jekyll链接
4. 订购比萨饼

目前唯一的问题(或不是)Kramdown与Github降价表现不佳.你必须切换到redcarpet.

还有其他两项任务:

• rake wikibuild :重建维基页面

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

Et hop!