[Gentoo] 安裝 SPhinx 及產生中文 PDF 檔

前言

最近想整理一些文件,本來是想要用 Markdown 和 Pandoc 來做的,但後來發現這個組合對處理中和表格是個悲劇,怎麼喬都喬不好,所以就憑著印象找到了 XDite 曾經介紹過的 Sphinx

這是一套可以從 reStructureText 格式的純文字檔轉成 HTML / ePub 和 PDF 的工具,稍微翻了一下,發現語法也還可以接受,看起來還算整齊(雖然比起 Markdown 多了些指令,而不是完全用格式判讀),所以就選定這套了,而且經過測試,中文表格用起來也很正常,程式語法彩色顯示的部份也支援非常多的語言(當然也包含了我最愛的 Scala)。

安裝

在 Gentoo 下要安裝 Sphinx 是非常簡單的,只要用下列的指令安裝即可,另外你可以透過 USE 變數來決定要不要安裝 LaTex 套件,以方便做出 PDF 檔。

  # USE="latex" emerge dev-python/sphinx

如果你需要產生 PDF 檔,請確定你的系統有以下套件,沒有的話就用 emerge 安裝一下唄。

[ebuild  N     ] dev-texlive/texlive-documentation-base-2011  USE="-source" 0 kB
[ebuild  N     ] dev-texlive/texlive-basic-2011-r1  USE="-doc -source" 0 kB
[ebuild  N     ] dev-texlive/texlive-latex-2011  USE="-doc -source" 0 kB
[ebuild  N     ] dev-texlive/texlive-pictures-2011  USE="-doc -source" 0 kB
[ebuild  N     ] dev-texlive/texlive-fontsrecommended-2011  USE="-doc -source" 0 kB
[ebuild  N     ] dev-texlive/texlive-latexextra-2011  USE="-doc -source" 0 kB
[ebuild  N     ] dev-texlive/texlive-latexrecommended-2011  USE="-doc -source" 0 kB
[ebuild  N     ] dev-texlive/texlive-langcjk-2011  USE="-doc -source" 0 kB

產生中文 PDF 檔

安照 Sphinx 的教學一步一步來,產生第一份文件後,如果你要建立 PDF 檔,要記得修改 config.py 檔案,在 LaTex 設定那一節,加上以下的設定,同時注意不能設定 config.py 裡的 language 選項

# -- Options for LaTeX output ---------------

latex_preamble = '''\usepackage{CJKutf8}\n\AtBeginDocument{\\begin{CJK}{UTF8}{bsmi}}\n\AtEndDocument{\end{CJK}}'''

加上了這個設定後,就可以直接使用 make latexpdf 來產生 PDF 的文件啦,不過 bookmarks 會變亂碼,我還沒時間看要如何解決這個問題。

回響