安裝 Sphinx ----------- Sphinx 是一套 Python 的套件（Python Egg），所以，我們在 command line 底下，使用 easy_install 或是 pip 安裝即可。直接輸入 ``sudo easy_install sphinx`` 或是 ``sudo pip install sphinx`` 。 安裝 LaTeX ---------- 網路上面已經有人包裝好給 Mac OS X 使用的 LaTeX，請至 http://www.tug.org/mactex/ 下載 MacTeX.pkg 之後點選安裝。這個套件還頂大的，要稍微花一點耐心。 安裝完畢之後，我們要改一下 shell 設定，加入以下 path： ``/usr/local/texlive/2012/bin/universal-darwin`` 。 執行 Sphinx ----------- 建立一個空目錄，在這個目錄中，執行 sphinx-quickstart，接下來會問你一連串的問題，像是專案的名稱、版本號，要不要也輸出 epub、要不要使用 JavaScript 顯示數學式等等。大部分狀況下直接按 Enter 就好了。 接下來我們可以從 index.rst 開始編輯。Sphinx 所使用的文字格式叫做 [reStructuredText](http://docutils.sourceforge.net/rst.html) ，文件格式可以參考 Sphinx 網站上的說明： http://sphinx-doc.org/rest.html 。 修改 LaTeX 輸出設定： --------------------- 改一下我們專案目錄下的 conf.py ，找到 latex_elements 這個變數，調整一下，加入中文字體設定。我們在這邊將中文設定成儷宋、英文設定成 Georgia，也可以根據自己的需求修改字體。 latex_elements = { 'preamble': ''' \usepackage{fontspec} \usepackage{xeCJK} \setmainfont{Georgia} \setCJKmainfont[BoldFont=LiHeiPro, ItalicFont=BiauKai]{LiSungLight} \setCJKmonofont{Osaka-Mono} \setCJKsansfont{LiHeiPro} \setCJKfamilyfont{song}[BoldFont=LiSungLight]{LiSungLight} \setCJKfamilyfont{sf}[BoldFont=LiSungLight]{LiSungLight} \XeTeXlinebreaklocale "zh" \XeTeXlinebreakskip = 0pt plus 1pt ''', 'babel': '\\usepackage[english]{babel}', # The paper size ('letterpaper' or 'a4paper'). 'papersize': 'a4paper', # The font size ('10pt', '11pt' or '12pt'). 'pointsize': '12pt', } 編譯、輸出 ---------- - 到專案目錄下，執行 ``make latex`` - 到 _build/latex 目錄下，用 xelatex 輸出我們剛剛產生的 .tex 檔案，例如 ``xelatex Test.tex`` 。
discoholicmusic
annaxmalina
dededos
tangentwithtanner
prguitarman
izzy806