2013-03-21 101 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