如何将项目readme.md文件读取到用户的github.com网站中？

Question

Github现在可以自动为项目生成页面。这很棒——它读取项目根目录中的readme.markdown文件，并使用模板创建一个整洁的站点。

不过，缺少的是用户.github.com页面。是否有办法（自动或通过传递配置文件）读取我当前所有GitHub项目的readme文档，并将其推入用户.github.com模板系统的站点设计中？

谢谢！

- willwade

Answer 1

“user.github.com”网站是通过GitHub Pages构建的。它们是独立的存储库，其名称与它们将出现的域名相匹配。例如，我的Github用户名是“alanwsmith”。我有一个名为“alanwsmith.github.com”的repo，它通过jekyll处理并可在http://alanwsmith.github.com/上使用。

由于它们是独立且有效的存储库，GitHub不会对它们应用任何自动化。通过jekyll处理只输出网站，不会影响存储库本身的内容。如果您想要在您的user.github.com域上自动列出所有项目的Readme文件，则必须构建自己的过程来收集文件并将它们放入源repo中。

当然，您的个人用户页面（例如 https://github.com/alanwsmith而不是http://alanwsmith.github.com/）列出了您的存储库。这些链接指向各个项目页面，正如您所提到的，显示自述文件。我认为这是GitHub目前能够做到的最接近您想要的功能了。

有关GitHub Pages的更多详细信息，请参阅GitHub Pages帮助部分。

- Alan W. Smith