是否有一种工具可以在 Windows 上从 Markdown（或类似的，例如 RST）生成 PDF 和 CHM 文档。
我们目前正在使用Sphinx，但无法在 Windows 上生成 PDF（这个人也有同样的问题）。必须在 Windows 上生成 CHM 并在 Linux 上生成 PDF 版本是一件痛苦的事（我确实需要生成这两个版本）。
是否有替代工具（免费或廉价的商业工具）可以完成这项任务？
源格式必须是类似纯文本的格式以进行版本控制，其中 Markdown 和 RST 就是示例。
问问题
3292 次
2 回答
4
Free Pascal发行版包含一个名为chmcmd的CHM 编译器。一些使用文档工具的人报告使用它取得了成功（例如Preshrunk-cotton python 包）
一些 Linux 发行版还独立于主 FPC 发行版打包 chm 编译器。（因为它只是一个没有依赖关系的 700k 二进制文件）。
在 Windows 上，您可以使用相同的（chmcmd 的 windows 版本）或 Microsoft Help Workshop，这是 MS 的默认 CHM 生成器。
这是 CHM 编译器部分，现在是输入：
编译前的CHM 项目基本上只是带有几个 XML 索引（TOC 和基于主关键字的索引）的 html和一个 INI 文件的项目文件。
通常，文档工具的 HTML 生成器后端会经过调整以将其生成为特殊情况。从我在您的“这个人”链接中读到的内容来看，狮身人面像可以做到这一点。
于 2013-03-22T11:56:56.393 回答
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 目录中
于 2013-04-12T01:27:45.357 回答