33

我正在使用 GitHub Pages 的“自动生成器”,我看到它只生成一个 index.html 和其他网络资源。

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

4

7 回答 7

23

通过确保 .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

于 2013-05-02T17:34:20.100 回答
16

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

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

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

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

于 2017-02-07T21:08:16.087 回答
4

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

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

请参阅帮助

于 2012-12-24T18:29:51.640 回答
4

Github Pages 使用Jekyll 站点生成器,它支持将任意数量的 markdown 文件转换为 HTML,并通过布局文件应用周围的模板。参见 github 关于使用 Jekyll 的文档:https ://help.github.com/articles/using-jekyll-with-pages

诀窍是您必须下载一个 jekyll 模板/主题并将其包含在您自己的 gh-pages 分支中(标准 jekyll 配置),而不是仅仅允许 Github Pages 使用它自己的内置文件自动生成一个文件主题。

于 2014-05-26T16:02:15.603 回答
3
  • GitHub Pages 的自动生成器只生成一个页面。
  • 您可以直接添加新文件,github页面会为您发布所有数据(包括子文件夹内的数据)。
于 2014-02-27T10:24:12.937 回答
1

刚刚制作了gh-pages-generator - 用于从多个具有相互链接的降价文件导航生成站点的实用程序。

于 2016-04-16T21:22:32.580 回答
0

“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

于 2020-12-23T06:02:16.830 回答