10
如何将文档与Github Pages同步？
我有一个与几个人在一起的项目，我们README.md在GitHub页面上呈现了一个带有一堆GitHub Flavored Markdown的文件。我们还建立了一个GitHub Pages分支，该分支托管在GitHub Organization的子域下，并在创建页面时使用了自动页面生成器，只需将其加载到README.md文件中即可。但是，我注意到当我更新README.md文件时，它不会更新项目页面。相反，我们必须转到GitHub设置选项卡并重新创建项目页面，并README.md在执行时重新加载文件。 此外，在阅读了有关GitHub项目目录页面上文档文件之间的相对链接的信息之后。我非常喜欢markdown，因为它省了很多时间，而不必为我们的文档手工编写所有HTML。但是，我希望有一个README.md文件能够包含位于的其他文档文件的相对链接docs/*.md。我希望有一个简单的解决方案，以便其他文档文件也可以包含在gh-pages分支中，并托管在GitHub Pages子域下并进行呈现和/或主题化。 换句话说，我的问题是： 有没有办法让我的README.md文件在我的Github Page子域上自动更新？ [编辑]：如果使用自动页面生成器，似乎没有答案。您必须转到存储库的设置页面，并在每次更改时都重新加载它以进行更新。 有没有一种方法可以使我的README.md文件上的文档的相对链接在Github Pages上起作用，也许以某种方式将其同步/docs/*.md到Github Pages并以某种方式呈现和/或主题化？ [编辑]：从我写这个问题以来所学到的内容来看，这似乎只有通过使用静态网站生成器（如ruby gem Jekyll）才能在GitHub页面上实现，并且可能还提到了GitHub支持的webhooks的某些用法在下面的评论中。我目前正在尝试寻找最佳解决方案。 更好的是，有没有一种更简便的方法可以执行此操作，并且也许只有gh页和主分支上使用的README.md和文档的一个副本，使一切变得最简单？ [编辑]：看来这几乎是肯定的。我正在考虑将某些内置于GitHub的东西允许的可能性。似乎将来可以在GitHub Pages中内置对此类事物的更好支持，或者至少我绝对希望如此。