使用Sphinx-doc，您可以创建一堆 ReStructureText 文件，其中一个index.rst文件包含一个目录宏，该宏自动从其他包含的文件生成目录，以及一个conf.py充当编译配置的文件。然后，您可以将该批次编译成单个 python-doc 样式的站点，其中包含索引、导航工具和搜索功能。
是否有任何类似的降价工具（最好是 pandoc 风格的降价）？
问问题
7040 次
3 回答
10
一些与 Markdown 一起使用的静态站点生成器：
- Jekyll非常流行，也是GitHub 页面背后的引擎。
- Python 变体：Hyde或Pelican
- nanoc （在GitHub API 文档中使用 f.ex. ）
- Middlemanapp：也许是最好的？
我认为它们都没有使用 pandoc（可能是因为它是用 Haskell 编写的），但它们都使用增强的 Markdown 语法或者可以配置为使用 pandoc。
从 Markdown 生成网站的其他有趣方法：
使用 Pandoc 的引擎：
- Gitit : Pandoc 维基
- Pandoc-Plugin for Ikiwiki
- Yst 静态站点生成器
- Gouda - 从 Markdown 文件目录生成站点
- Rippledoc - 从 Markdown 文件的嵌套目录生成可导航站点
静态站点生成器的最终列表
静态站点生成器的一个很好的概述：http: //staticsitegenerators.net/
于 2013-03-14T06:53:56.333 回答
8
Pandoc，GNU make和sed命令，加上一些CSS，是您从Markdown开始完全自动化创建静态网站所需的一切。
Pandoc 提供了三个命令行选项，可以提供页面之间的导航以及基于页面内标题创建目录 (TOC)。使用 CSS，您可以使导航和 TOC 以您想要的方式显示和运行。
-B 文件，--include-before-body=文件
在文档正文的开头（例如在 HTML 中的标记之后，或在 LaTeX 中的 \begin{document} 命令之后）包括 FILE 的内容，逐字逐句。这可用于在 HTML 文档中包含导航栏或横幅。此选项可重复使用以包含多个文件。它们将包含在指定的顺序中。暗示 --standalone。
--toc，--目录
包括一个自动生成的目录。
--toc-depth=NUMBER
指定要包含在目录中的节级别数。默认值为 3（这意味着将在内容中列出级别 1、2 和 3 的标题）。
事实上，我的个人网站就是这样建立的。查看其makefile以了解更多详细信息。它都是在GNU GPL 版本 3下获得许可的自由开放源代码。
于 2014-01-28T12:42:44.273 回答
2
如果您可以不使用 Pandoc，mkdocs似乎可以满足您的需求。
如果你确实想使用 Pandoc 风格的 Markdown，你可以查看pdsite。我把它写成一种使用更多输入格式（如 emacs org-mode）和没有 Python 依赖项的 mkdocs 样式站点生成的方法 - 你传入一个 Markdown 文件的文件夹并得到一个 HTML 站点（包括自动生成的多级导航链接）。它类似于 Serge Stroobandt 的方法，因为它只是一个 shell 脚本（但它确实需要您tree安装）。不幸的是，它还没有搜索功能，虽然这不会太难添加......
于 2016-06-27T22:23:59.340 回答