是否有工具可以在Windows上从Markdown(或类似的RST)生成PDF和CHM文档。
我们目前正在使用Sphinx,但无法在Windows上使用PDF生成(this guy有同样的问题)。在Windows上生成CHM和在Linux上生成PDF版本是很痛苦的(我需要生成两个版本)。
是否有可以执行此任务的替代工具(免费或廉价的商业广告)?
源格式必须采用纯文本格式进行版本控制,其中Markdown和RST就是例子。
答案 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目录
中