github - 保持 GH 主页与 README.md 同步

Question

在为我的项目创建 GitHub Pages 时，建议我导入现有的 README.md 作为项目的主页。后来，我将 gh-pages 与 master 合并，最终得到了 index.html 和 README.md。

“问题”是 README.md 的更新不会影响 index.html。有什么简单的方法可以让它们保持同步吗？最好是零 Jekyll 知识...

Answer 1

如果有人感兴趣，这就是我的想法。

通常我使用 Jade 编写 HTML预处理器，幸运的是它确实支持 GitHub Flavored Markdown这是 README.md 编写的语言。所以我的步骤如下:

1. 将 GH Pages 生成的 index.html 转换为 Jade。我网上用过html2jade工具；
2. 将输出保存到index.jade；

3. 在 index.jade 中的结果标记中找到 section block ，并将其整个内容替换为:

   部分 包括:md README.md

4. 运行jade index.jade，它会生成新的、自动生成的index.html；
5. 将两个文件提交到 gh-pages。

参见 this 中的示例在 GitHub 上提交。