documentation - markdown/pandoc 的全站编译？

Question

关闭。这个问题不满足Stack Overflow guidelines .它目前不接受答案。












想改善这个问题吗？更新问题，使其成为 on-topic对于堆栈溢出。

3年前关闭。




Improve this question




与 Sphinx-doc ，您可以创建一堆 ReStructureText 文件，带有 index.rst包含一个目录宏的文件，该宏从其他包含的文件中自动生成一个目录，以及一个 conf.py充当编译配置。然后，您可以将该批次编译为一个 Python 文档样式的站点，并配有索引、导航工具和搜索功能。

有没有类似的 Markdown 工具(最好是 pandoc 风格的 Markdown )？

Answer 1

一些使用 Markdown 的静态站点生成器 :

Jekyll非常受欢迎，也是背后的引擎GitHub pages .

Python 变体:Hyde或 Pelican

nanoc (在 GitHub API documentation 中使用 f.ex)

Middlemanapp : 也许是最好的？

我认为他们都没有使用 pandoc(可能是因为它是用 Haskell 编写的)，但是他们都使用了增强的 Markdown 语法或者可以配置为使用 pandoc。

从 Markdown 生成站点的其他有趣方法:

基于文件的 Markdown-Wiki:f.ex。 Gollum ，GitHub 也使用的 Wiki-Engine

Telegram : 商业的;由 David Pollak 编写，Lift-Scala 框架的发明者

使用 Pandoc 的引擎:

Gitit : Pandoc 维基

Pandoc-Plugin forIkiwiki

Yst static site generator

Gouda - generates a site from a directory of markdown files

Rippledoc - generates a navigable site from nested directories of markdown files

静态站点生成器的最终列表

静态站点生成器的一个很好的概述: http://staticsitegenerators.net/