With Sphinx-doc http://sphinx-doc.org/，您可以创建一堆 ReStructureText 文件，其中包含index.rst文件，其中包含一个目录宏，该宏可以从其他包含的文件中自动生成目录，以及conf.py充当编译配置。然后，您可以将这些内容编译成一个 python-doc 风格的网站，并配有索引、导航工具和搜索功能。
有没有类似的 Markdown 工具（最好是 pandoc 风格的 Markdown）？
一些与 Markdown 配合使用的静态站点生成器:
-
Jekyll http://jekyllrb.com/很受欢迎，也是背后的引擎GitHub 页面 http://pages.github.com/.
- Python 变体：Hyde http://ringce.com/hyde or Pelican http://docs.getpelican.com/en/3.1.1/
-
nanoc http://nanoc.ws/（例如在GitHub API 文档 http://developer.github.com/v3/)
-
中间人应用程序 http://middlemanapp.com/: 也许是最好的一个？
我认为他们都没有使用 pandoc（可能是因为它是用 Haskell 编写的），但他们都使用增强的 Markdown 语法或者可以配置为使用 pandoc。
从 Markdown 生成网站的其他有趣方法：
- 降价-Wikis基于文件的：f.ex。Gollum https://github.com/github/gollum，GitHub 也使用的 Wiki-Engine
-
Telegram https://telegr.am/index： 商业的;由 Lift-Scala 框架的发明者 David Pollak 编写
使用 Pandoc 的引擎：
-
Gitit https://github.com/jgm/gitit: 潘多克维基
-
Hakyll https://jaspervdj.be/hakyll/：Haskell库生成静态站点
- Pandoc-Ikiwiki 插件 https://github.com/dubiousjim/pandoc-iki
- Yst静态站点生成器 http://github.com/jgm/yst
- Gouda - 从 Markdown 文件目录生成站点 http://www.unexpected-vortices.com/sw/gouda/
- Rippledoc - 从 Markdown 文件的嵌套目录生成可导航站点 http://unexpected-vortices.com/sw/rippledoc/
静态站点生成器的最终列表
静态站点生成器的一个很好的概述：http://staticsitegenerators.net/ http://staticsitegenerators.net/
本文内容由网友自发贡献，版权归原作者所有，本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容，请联系:hwhale#tublm.com(使用前将#替换为@)
