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

时间:2012-12-24 18:23:02

标签: github markdown documentation-generation github-pages

我使用的是GitHub页面的“自动生成器”,我发现它只生成一个index.html和其他网络资源。

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

7 个答案:

答案 0 :(得分:22)

你可以通过确保.markdown的顶部以这样的----块开头来获取github从.markdown文件生成.html文件:

---
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

答案 1 :(得分:10)

如果您包含降价文件,Github将自动为您创建页面。

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

经过测试并正常工作。

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

答案 2 :(得分:4)

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

生成的单页可帮助您入门。您可以复制其布局以手动生成其他类似的页面。

Help

答案 3 :(得分:4)

Github Pages使用Jekyll site generator支持将任意数量的降价文件转换为HTML,并通过布局文件应用周围的模板。请参阅github有关使用Jekyll的文档:https://help.github.com/articles/using-jekyll-with-pages

诀窍是你必须download a jekyll template/theme并将它包含在你自己的gh-pages分支中(标准的jekyll配置),而不是仅允许Github Pages使用自己构建的自动生成一个文件-in themes。

答案 4 :(得分:3)

  • GitHub Pages的自动生成器只生成一个页面。
  • 您可以直接添加新文件,github页面会为您发布所有数据(包括子文件夹中的数据)。

答案 5 :(得分:1)

刚刚制作gh-pages-generator - 用于生成网站的实用程序,其中包含多个具有相互链接的降价文件的导航。

答案 6 :(得分:0)

“Github 页面”将 index.md / readme.md 中的网页作为主页。但是,如果您有一个 index.html 文件,那么它将从 html 文件托管。但是,如果您尝试使用“Jekyll 主题”托管多页网站,那么 Jekyll 主题不会直接部署在子页面中。

案例 1) 您正在使用降价来托管您的页面 index.md -> 主页 page1.md -> 您网站的第 1 页 .. 等等

要使用github页面生成多页面网站,只需提供所需页面的相对路径,无需扩展,即 制作一个按钮

<a href="./page1">Go to next page</a>

点击此按钮,您将被定向到页面 1 部署了 jekyll 主题