markdown/pandoc的整个网站编译？

Question

使用Sphinx-doc,您可以创建一堆ReStructureText文件,index.rst其中包含一个目录宏的文件,该宏自动生成来自其他包含文件的目录,以及一个conf.py充当编译配置的文件.然后,您可以将该批次编译为单个python-doc样式的站点,包括索引,导航工具和搜索功能.

有没有类似的降价工具(最好是pandoc式降价)？

Answer 1

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

• Jekyll非常受欢迎,也是GitHub页面背后的引擎.
• Python变种:海德或鹈鹕
• nanoc(在GitHub API文档中使用f.ex. )
• Middlemanapp:也许是最好的一个？

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

从markdown生成网站的其他有趣方法:

• Markdown- 基于文件的Wiki:f.ex.Gollum,也是GitHub使用的Wiki引擎
• 电报:商业; 由Lift-Scala框架的发明者David Pollak撰写

使用Pandoc的引擎:

• Gitit:Pandoc Wiki
• Pandoc-Plugin forIkiwiki
• Yst静态站点生成器
• Gouda - 从markdown文件目录中生成一个站点
• Rippledoc - 从markdown文件的嵌套目录生成可导航的站点

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

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

Answer 2

Pandoc,GNU make和sed命令,以及一些CSS,你需要完全自动化从Markdown开始创建静态网站.

Pandoc提供三个命令行选项,可以提供页面之间的导航以及基于页面内标题创建目录(TOC).使用CSS,您可以使导航和TOC外观和行为符合您的需要.

-B FILE, - include-before-body = FILE

在文档正文的开头包含FILE的内容(逐字)(例如,在HTML中的标记之后,或在LaTeX中的\ begin {document}命令).这可用于在HTML文档中包含导航栏或横幅.可以重复使用此选项以包含多个文件.它们将包含在指定的顺序中.意味着 - 独立.

--toc, - 表内容

包括自动生成的目录.

--toc深入= NUM​​BER

指定要包含在目录中的节级别数.默认值为3(表示内容中将列出级别1,2和3标题).

事实上,我的个人网站是以这种方式构建的.查看其makefile以获取更多详细信息.它是GNU GPL版本3下的所有免费libre开源许可.