如何从GitHub Pages的自动生成器获取多页面站点?

Lui*_*ano 28 markdown github documentation-generation github-pages

我正在使用GitHub页面的"自动生成器",我发现它只生成一个index.html和其他Web资源.

如果我想从其他降价文件生成多页网站,它是如何工作的?

小智 22

您可以通过确保.markdown的顶部以----块开头,让github从.markdown文件生成.html文件:

---
title: This will be used as the title-tag of the page head
---

hello
=====

**You are here!**
Run Code Online (Sandbox Code Playgroud)

在这里找到:http: //xlson.com/2010/11/09/getting-started-with-github-pages.html


小智 13

如果您包含markdown文件,Github将自动为您创建页面.

  • index.html - yourname.github.io/project-name/
  • about.md - yourname.github.io/project-name/about
  • foo.md - yourname.github.io/project-name/foo

经过测试并正常工作.

如果你想进入真正有趣的东西 - 你需要进入Jekyll http://jekyllrb.com/


JB *_*zet 4

您拉取生成的页面,进行任何您喜欢的修改和添加(包括添加新页面和页面之间的链接),然后提交并推送。

生成的单页可以帮助您开始。您可以复制其布局以手动生成其他外观相似的页面。

请参阅帮助

  • 遗憾的是它只是“帮助我开始”,因为之后我需要在我的项目网站上加倍工作以保持 README.md、wiki 和网站的同步。一开始可能会有所帮助,但之后可能就没有帮助了。我错了吗? (2认同)
  • 如果我的项目中有很多 Markdown 来源,为什么不能重新生成具有多个页面的站点?当我在“master”分支上更改某些内容后,我可以重新生成 gh-pages 来自动更新站点。这就是文档生成的美妙之处。不是吗?而且,顺便说一句,即使一开始,单个页面也是一个很大的限制。 (2认同)