2013-03-21 70 views
3

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

我们目前正在使用Sphinx,但一直无法在Windows上运行PDF生成(this guy也有同样的问题)。在Windows上生成CHM和在Linux上生成PDF版本是非常痛苦的(而且我确实需要生成两个版本)。

是否有可以完成此任务的替代工具(免费或廉价商业)?

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

回答

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 

运行狮身人面像的 “MAKE.BAT” 生成.tex文件。

SET SPHINXOPTS=-W -E 
make.bat latex 

调用MIKTEX的pdflatex:

cd build/latex 
pdflatex.exe YOUR_PROJECT_NAME.tex 

得到的PDF将是您的构建/乳胶目录

+1

...有关CHM部分的新内容? – Wolf 2016-07-20 13:04:04

1

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

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

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

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

一个CHM项目编译之前基本上只用HTML与一对夫妇XML索引(TOC和主关键字的索引)和项目文件是一个INI文件。

通常,文档工具的HTML生成器后端会进行调整,以将其生成为特殊情况。从我在“这个人”链接中读到的东西,狮身人面像可以做到这一点。

+0

谢谢你的完整的答案。它不能满足我的需求,但这里有很多很棒的点子。 – Boinst 2013-04-12 01:17:45