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