reStructuredtext 是一個輕量級的標記語言,目前已經有許多人使用reST來做書的排版,詳細語法的使用方法可以直接參考官網

有了輕量級的標記語言,就需要一些Parser Component來協助輸出成文件,Docutils 就是以 Python 開發的opensource文字處理元件,可以將 reST 文字檔轉換成各種格式,包含 HTML、LaTeX、odt、rtf。由於 Docutils 在產生PDF文件時步驟較為複雜,所以可以再搭配 Rst2pdf 這個套件協助轉出PDF檔。

Docutils 安裝(必須先安裝python):
1.先到 官網 下載原始檔並解壓縮
2.安裝:

python setup.py install

3.安裝成功後就會有rst2*.py的指令可以使用(可以從Docutils/tools/裡查到有哪些指令可以使用)

#輸出成html
rst2html.py test.rst aaaa.html

Rst2pdf 安裝(必須先安裝python)
1.先到 官網 下載原始檔並解壓縮
2.安裝:

python setup.py install

3.安裝成功後就會有rst2pdf的指令可以使用

rst2pdf test.rst -o test.pdf

Rst2pdf 中文字型輸出:
1.先安裝中文字型(例如:wqy-zenhei字體)
2.編寫設定檔(選擇字型)
chinese.config

{
    "fontsAlias" : {
        "stdFont": "wqy-zenhei",
        "stdBold": "wqy-zenhei",
        "stdItalic": "wqy-zenhei",
        "stdMono": "wqy-zenhei"
    }
}

3.引入設定檔

rst2pdf test.rst -s chinese.config -o aaaa.pdf

詳細文件可以參考 這裡

另外補充,因為Rst2pdf中是透過fc-match指令去取得字型,所以如果沒有安裝fontconfig需要再手動裝一次,不然會發生找不到字型的問題

cd /usr/ports/x11-fonts/fontconfig/; make install clean
Categories: FreeBSD