用于在Windows上从Markdown生成CHM和PDF文档的工具

时间:2013-03-21 23:34:06

标签: pdf markdown python-sphinx chm

是否有工具可以在Windows上从Markdown(或类似的RST)生成PDF和CHM文档。

我们目前正在使用Sphinx,但无法在Windows上使用PDF生成(this guy有同样的问题)。在Windows上生成CHM和在Linux上生成PDF版本是很痛苦的(我需要生成两个版本)。

是否有可以执行此任务的替代工具(免费或廉价的商业广告)?

源格式必须采用纯文本格式进行版本控制,其中Markdown和RST就是例子。

2 个答案:

答案 0 :(得分:3)

Free Pascal发行版包含一个名为 chmcmd 的CHM编译器。一些拥有文档工具的人报告了它的成功(如Preshrunk-cotton python package

某些Linux发行版还独立于主FPC发行版打包chm编译器。 (因为它只是一个没有依赖关系的700k二进制文件)。

在Windows上,您可以使用相同的(Windows版本的chmcmd)或Microsoft Help Workshop,这是MS的默认CHM生成器。

这是CHM编译器部分,现在是输入:

编译前的 CHM项目基本上是只是html ,带有几个XML索引(基于TOC和主关键字的索引)和一个INI文件的项目文件。

通常会调整文档工具的HTML生成器后端以将其生成为特例。从我在你的“这个家伙”链接中读到的内容,sphinx可以做到这一点。

答案 1 :(得分:1)

毕竟我能够使用Sphinx来满足这种需求。我使用MiKTeX在Windows上生成PDF。

安装MiKTeX(< 200mb)

wget -nv -N http://mirrors.ctan.org/systems/win32/miktex/setup/miktex-portable-2.9.4757.exe
7z.exe x -y miktex-portable-2.9.4757.exe -o"miktex"

将bin目录添加到路径

SET Path=%Path%;%CD%\miktex\miktex\bin

运行Sphinx的“make.bat”以生成.tex文件。

SET SPHINXOPTS=-W -E
make.bat latex

调用MiKTeX的pdflatex:

cd build/latex
pdflatex.exe YOUR_PROJECT_NAME.tex

生成的PDF将位于您的build / latex目录