没有 Jekyll(或模板引擎)的带有内联 markdown 的静态站点——可以做到吗?

Static site with inline markdown, without Jekyll (or templating engine) -- can it be done?

Github 页,杰基尔,Prose.io。这些东西似乎都是为了相互配合而创造的。

我知道 Jekyll,它利用 Markdown 内容制作 "blog aware" 静态页面,yada yada。问题是,我并不是真的想要 Jekyll 的所有功能,但我确实想利用 Github 页面来托管静态站点。而且我确实想要一种比 HTML.

更人性化的方式来编辑网站上的内容

我想知道的是,我是否可以采用 Prose 生成的 .md 文件(将内容推送到您的 Github Pages 存储库),并将其放在某种 .md 文件中。 md 包括我的 index.html 文件的“#aboutMe”div。

如果没有 Jekyll 就无法做到这一点,是否有功能较弱的模板引擎,我可以将其添加到我的网站之上而无需生成整个内容?当与 Github 页面一起使用时,替代方案是否可行?

此外,如果没有某种模板替代方案,是否有 Prose 的替代方案,它在推送到 Github 时将 MD 内容转换为 HTML,这样我就可以包含那些 "content" 文件在我的页面中用 JS?如果他们需要更改内容,我会需要它然后拉出这些相同的文件以在 MD 中进行编辑。据我所知,您只能使用 Prose 发布 .md 文件。我不想先在本地预处理 HTML - 我只想将 .md 文件推送到 github 并让它工作。这是真的吗?

正如之前在 中所建议的那样,Jekyll + GitHub Pages 可以满足您的所有需求。

它的功能还很多,但您不需要使用任何一个。


您可以在 Git 中心页面上设置一个简单的 Jekyll 站点,仅包含:

  • 单个布局文件(带有某种动态导航,当您添加新页面时通过循环自动更新site.pages
  • 多个页面,包含 .md 个使用该布局文件的文件

之后,您再也不会触摸布局文件的 HTML。
您只需将 Markdown 写入 .md 文件,在 Git 中提交这些文件并推送到 GitHub(您甚至可以在 GitHub 的网站 UI 中编辑它们,完全不使用 Git 或您的本地计算机)。

GitHub Pages 将构建您的网站。
当然,您的站点 确实 需要构建,但 GitHub 会为您完成。您不需要在本地计算机上 create/preprocess 任何东西。