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

Question

我正在使用GitHub页面的“自动生成器”，我看到它只生成一个index.html和其他web资源。

如果我想从其他markdown文件中生成一个多页网站，它是如何工作的？

Answer 1

您可以让github从.markdown文件生成.html文件，方法是确保.markdown的顶部以-块开头，如下所示：

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

hello
=====

**You are here!**

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

Answer 2

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

yourname.github.io/project-name/

• about.md - yourname.github.io/project-name/about

• foo.md - yourname.github.io/project-name/foo

• index.html

对此进行了测试并正常工作。

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

Answer 3

Github Pages使用Jekyll site generator，它支持将任意数量的标记文件转换为超文本标记语言，并通过布局文件应用周围的模板。请参阅github关于使用Jekyll的文档：https://help.github.com/articles/using-jekyll-with-pages

诀窍是你必须自己download a jekyll template/theme并将其包含在你的gh-pages分支中(标准的jekyll配置)，而不是仅仅允许Github页面使用它自己的内置主题自动生成一个文件。