Boi*_*nst 5 pdf chm markdown python-sphinx
是否有一个工具可以在 Windows 上从 Markdown(或类似的,例如 RST)生成 PDF 和 CHM 文档。
我们目前正在使用Sphinx,但无法在 Windows 上生成 PDF(这个人也有同样的问题)。在 Windows 上生成 CHM 并在 Linux 上生成 PDF 版本是一件痛苦的事情(我确实需要生成这两个版本)。
是否有替代工具(免费或廉价的商业工具)可以完成此任务?
源格式必须是类似纯文本的格式,以便进行版本控制,例如 Markdown 和 RST。
Free Pascal发行版拥有一个名为chmcmd的 CHM 编译器。一些拥有文档工具的人报告使用它取得了成功(例如Preshrunk-cotton python 包)
一些 Linux 发行版还独立于主要 FPC 发行版打包 chm 编译器。(因为它只是一个没有依赖项的 700k 二进制文件)。
在 Windows 上,您可以使用相同的(Windows 版本的 chmcmd)或 Microsoft Help Workshop(MS 的默认 CHM 生成器)。
这是 CHM 编译器部分,现在是输入:
编译前的CHM 项目基本上只是带有几个 XML 索引(TOC 和基于主关键字的索引)的html和一个 INI 文件的项目文件。
通常,文档工具的 HTML 生成器后端会进行调整,以将其生成为特殊情况。从我在你的“这个家伙”链接中读到的内容来看,狮身人面像可以做到这一点。
毕竟我能够使用Sphinx来满足这个需求。我在 Windows 上使用MiKTeX生成 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"
Run Code Online (Sandbox Code Playgroud)
将 bin 目录添加到您的路径中
SET Path=%Path%;%CD%\miktex\miktex\bin
Run Code Online (Sandbox Code Playgroud)
运行Sphinx的“make.bat”来生成.tex文件。
SET SPHINXOPTS=-W -E
make.bat latex
Run Code Online (Sandbox Code Playgroud)
调用MiKTeX的pdflatex:
cd build/latex
pdflatex.exe YOUR_PROJECT_NAME.tex
Run Code Online (Sandbox Code Playgroud)
生成的 PDF 将位于您的 build/latex 目录中