在 github 的 gh-pages 分支中发布和链接文件

Publishing and linking files within a gh-pages branch in github

[背景:我对 html 或其他编程语言(统计包 [R] 除外)的熟悉程度不高,但在尝试学习我面临的 Coursera 课程时在 gh-pages 中呈现作业的挑战。]

我有一个 gh-pages 分支 here, which I labeled it Stuff, and contains an index.html file, accessible through this address http://rinterested.github.io/Stuff/ online. This is the Home or "anchor" page of the website, but I want to create other pages within http://rinterested.github.io/Stuff/。为此,我一直在玩一个玩具文件,但没有成功,该文件此时位于同一个 gh-pages 文件夹中并标记为 Plotting-With-R.md。为什么 .md?因为在网上搜索了很多之后,它得到了一条线索,表明这会将页面变成 html... 不要问。

好吧,它不起作用。尽管可以清楚地在线访问 index.html,但似乎无法在线访问 Plotting-With-R.md。所以无论我做错了什么(最好直接与 Github(而不是 git)合作,你能帮我把这个额外的页面发布到网上,并链接到 index.html 吗?

嗯,由于 github 页是由 Jekyll 进行的,您必须遵守一些规则:

  • 所有 static pages 将被简单地复制 toto.md 将成为 toto.md,或者 titi.css 将在生成的站点中成为 titi.css 而不进行任何处理:原样复制.
  • 任何带有 front matter 的页面都将被处理 toto.md 将变为 toto.html。

因此,您的 Plotting-With-R.md 页面必须以

开头
---
---
<!doctype html>
...

将呈现为 Plotting-With-R.html

注意:可以去掉doctype前的无用代码

Color coded factors:
https://cloud.githubusercontent.com/....

花些时间阅读Jekyll documentation物有所值。

为了能够访问您的 Plotting-with-R.md 文件,您需要 link 到 html 版本,因为 Jekyll 会将它从 .md 转换为 .html .