使用markdown在github中发布页面的方法,而无需安装jekyll或其他工具

时间:2013-12-28 17:29:41

标签: git github github-pages

我打算在github上的用户页面上发表文章。我想把我的文章写成markdown文件并将它们推送到我的user.github.io repo中的一个分支,让github自动为我生成HTML文件,而不必使用像Jekyll这样的工具。可以吗?如果是这样我该怎么办?我将index.markdown文件推送到gh-pages分支,但无法找到任何自动生成的html文件。

1 个答案:

答案 0 :(得分:3)

不,你需要从你的降价代码生成你的html页面,作为静态网站,以便你的GitHub域显示所述的html页面。

生成此类网站的一种简单方法是通过基于go(go=golang)框架 Hugo (GitHub网站:https://github.com/spf13/hugo)。 /> 这意味着您需要在本地安装“其他工具”以从降价源生成这些页面。

Hugo documentation site本身由Hugo生成,并在project page上发布。

另请参阅GitHub帮助页面“Creating Project Pages manually”,在您的回购邮件的gh-pages分支中添加自己的html页面。


2016年8月更新: Simpler GitHub Pages publishing 现在允许将您的网页文件保存在相同分支的子文件夹中(不再需要gh-pages) :

Now you can select a source in your repository settings and GitHub Pages will look for your content there.

现在,您可以在主分支的子文件夹中生成文件。