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

Question

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

Answer 1

不，您需要从 Markdown 代码生成 html 页面作为静态站点，以便您的 GitHub 域显示所述 html 页面。

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

Hugo文档站点本身由 Hugo 生成，并发布在项目页面上。

另请参阅 GitHub 帮助页面“手动创建项目页面”，以在gh-pages存储库的分支中添加您自己的 html 页面。

2016 年 8 月更新：更简单的 GitHub Pages 发布现在允许将页面文件保存在同一分支的子文件夹中（不再gh-pages需要）：

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