我正在使用 GitHub Pages 的“自动生成器”,我看到它只生成一个 index.html 和其他网络资源。
如果我想从其他 Markdown 文件生成多页网站,它是如何工作的?
我正在使用 GitHub Pages 的“自动生成器”,我看到它只生成一个 index.html 和其他网络资源。
如果我想从其他 Markdown 文件生成多页网站,它是如何工作的?
通过确保 .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
如果您包含 markdown 文件,Github 会自动为您创建页面。
yourname.github.io/project-name/
yourname.github.io/project-name/about
yourname.github.io/project-name/foo
对此进行了测试并可以正常工作。
如果你想进入真正有趣的东西 - 你需要进入 Jekyll http://jekyllrb.com/
Github Pages 使用Jekyll 站点生成器,它支持将任意数量的 markdown 文件转换为 HTML,并通过布局文件应用周围的模板。参见 github 关于使用 Jekyll 的文档:https ://help.github.com/articles/using-jekyll-with-pages
诀窍是您必须下载一个 jekyll 模板/主题并将其包含在您自己的 gh-pages 分支中(标准 jekyll 配置),而不是仅仅允许 Github Pages 使用它自己的内置文件自动生成一个文件主题。
刚刚制作了gh-pages-generator - 用于从多个具有相互链接的降价文件导航生成站点的实用程序。
“Github pages”将 index.md / readme.md 中的网页作为主页。但是,如果您有一个 index.html 文件,那么它将从 html 文件托管。但是,如果您尝试使用“Jekyll 主题”托管一个多页面网站,那么 Jekyll 主题不会直接部署在辅助页面中。
案例 1)您正在使用降价来托管您的页面 index.md -> 主页 page1.md -> 您网站的第 1 页 .. 依此类推
要使用 github 页面生成多页网站,只需给出所需页面的相对路径,无需扩展名,即制作一个按钮
<a href="./page1">Go to next page</a>
通过单击此按钮,您将被定向到部署了 jekyll 主题的 page1