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

Boi*_*nst 5 pdf chm markdown python-sphinx

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

我们目前正在使用Sphinx,但无法在 Windows 上生成 PDF(这个人也有同样的问题)。在 Windows 上生成 CHM 并在 Linux 上生成 PDF 版本是一件痛苦的事情(我确实需要生成这两个版本)。

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

源格式必须是类似纯文本的格式,以便进行版本控制,例如 Markdown 和 RST。

Mar*_*ort 5

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 生成器后端会进行调整,以将其生成为特殊情况。从我在你的“这个家伙”链接中读到的内容来看,狮身人面像可以做到这一点。


Boi*_*nst 1

毕竟我能够使用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 目录中

  • ...CHM 部分有什么新内容吗? (4认同)