在文章的開始,我想先說幾句,呵呵！texlive和sphinx真的很難搜索到,我以後可能很少會再研究這個了,希望我的這點微弱的資料能給大家學習帶來一點點輕鬆.如果在這裡看的效果感覺不是很好的話,大家可以到51CTO的下載中心去下載PDF版的.還是希望大家到下載中心去下載,時間原因,我這個也是從我的源文件那裡複製過來的,大家看的時候可能會發現這篇文檔和你以往看過的有點不太一樣,因為我這個可以說是源文件.(
我希望看過我的文檔的人能夠給予評價,不管好壞我都會接受的,因為這裡面有一個小小的故事,關於我的一個小小的故事,我比較關注大家看完之後的感受.以後會一直專攻linux,但可能不會再弄texlive和sphinx了)
Texlive和sphinx的安裝和簡單應用
=================================
前言
=================================
文檔內容簡介
=======================
本文檔主要介紹的texlive2009和sphinx的安裝及他們的簡單應用.在下面的章節中,我們所用到的系統環境是ubuntu操作系統以及ubuntu的常用命令和gedit 編輯器,我所執行的命令都是在終端模式下執行的.但並沒有太多的特殊命令,都是linux裡邊常用的一些命令,沒有什麼太大的難度.希望大家能夠仔細的閱讀本文檔,希望大家能夠對本文檔提出意見與建議,讓我們共同進步！
聯繫方式
=======================
我的郵箱：zyliday@gmail.com
我的MSN :zyliday@live.cn
我的QQ：759147273
=================================
texlive2009的安裝及簡單應用
=================================
texlive簡介
===========================
目前世界上有許多電子排版系統.這些系統各有特點,也各有自己的適用範圍.TeX 就是一種優秀的電子排版系統.TeX 提供了一套功能強大並且十分靈活的排版語言,它多達 900 多條指令,並且 TeX 有宏功能,用戶可以不斷地定義自己適用的新命令來擴展 TeX 系統的功能.許多人利用 TeX 提供的宏定義功能對 TeX 進行了二次開發,其中比較著名的有美國數學學會推薦的非常適合於數學家使用的 AMS-TeX 以及適合於一般文章、報告、書籍的 LaTeX 系統.
TeX 系統是公認的數學公式排得最好的系統.美國數學學會（AMS） 鼓勵數學家們使用 TeX 系統向它的期刊投稿.世界上許多一流的出版社如 Kluwer、Addison-Wesley、牛津大學出版社等也利用 TeX 系統出版書籍和期刊.大部分的 TeX 系統都是免費的.Knuth 教授還公開了他的全部源程序.TeX 系統目前已經在數百種計算機系統上得到實現.TeX 系統的排版結果 DVI（DeVice Independent）文件與輸出設備無關.DVI 文件可以顯示、列印、照排,幾乎可以在所有的輸出設備上輸出.TeX 排版源文件及結果在各種計算機系統上互相兼容.本文檔只介紹texlive的安裝及簡單應用.
texlive2009的下載地址：http://mirrors.xmu.edu.cn/CTAN/systems/texlive/Images
我用的是 texlive2009.iso.xz
texlive的安裝
===========================
新建texlive2009的安裝目錄：
$mkdir /home/user/src/texlive
掛載光碟鏡像（以下路徑是我電腦上的光碟鏡像存放位置,大家掛載的時候適情況而定）：
$sudo mount -t iso9660 -o loop /home/user/zhangxiaofeng/texlive2009.iso /mnt
進入掛載目錄並安裝：
$cd /mnt
$sudo ./install-tl -gui
出來圖形界面後點擊「修改」,將路徑改為/home/user/src/texlive(這個路徑要改為當前登錄用戶有許可權管理的路徑),然後點擊「安裝texlive",再點擊「完成」.查看是否安裝成功使用以下命令,以下命令會顯示texlive的版本號等信息：
$tex --version
圖形界面管理texlive2009：
$tlmgr -gui
注意：默認情況下,texlive/2009中的tlpkg文件的屬主和屬組為 root,其他用戶要用tlmgr命令管理時,要改屬主和屬組及其他的許可權為W,否則打開管理界面會提示無權訪問.
texlive的簡單應用
===========================
我們的目的
-----------------------------------
以下文檔介紹中我們要實現的效果就是將linux中的普通的文本用texlive轉換成為pdf格式.
將普通文本轉換為pdf格式的文本
-----------------------------------
新建test目錄,在test目錄中新建aa.tex文件並編輯文件：
$mkdir test
$cd test
$gedit aa.tex
寫入以下信息：
documentclass{article}
begin{document}
hello this is texlive test space
end{document}
將其保存,執行以下命令將文檔轉換為pdf格式並查看文檔：
$latex aa.tex
$pdflatex aa.tex
$evince aa.pdf
＆＆目前為止,我們所生成的pdf文件是不支持中文的,下面的操作是使生成的pdf文件支持中文.
texlive中支持中文
-----------------------------------
修改aa.tex文件：
$gedit aa.tex
在documentclass{article}下面添加一行：
usepackage{tex-live-zh-cn}
保存aa.tex文件.
用以下命令找到目前系統支持的中文語言,（並將所支持的語言複製）：
$fc-list
將tex-live-zh-cn.sty文件里的和字體有關文字的全部替換為剛才複製的字體（本系統為WenQuanYi ZenHei）,另外有些沒必要的行要用%註釋掉,然後再將tex-live-zh-cn.sty這個文件複製到/home/user/.texlive2009/texmf-var/tex中（但我不知道這個文件來源於哪裡,應該是自己寫的texlive支持中文的文件吧.）
然後執行以下命令重新生成pdf文件並查看：
$xelatex aa.tex
$evince aa.pdf
這個時候我們可以看到生成的pdf已經支持中文了.
========================
sphinx的安裝及簡單應用
========================
sphinx簡介
=====================================================
Sphinx是一款文檔編製軟體.該工具可以將一系列 reStructuredText 源文本轉換成各種不同的輸出格式,並自動製作交叉引用（cross-references)、索引等.也就是說,如果某目錄中有一系列的 reST 格式文檔（可能子目錄中也有）, Sphinx 可以製作一份組織得非常完美的 HTML 文件（在其它目錄中）,便於瀏覽和查找.但是從同一組源文件,它也可以製作一份 LaTex 文件,以便你將其轉換為 PDF 格式的文檔.本文檔只介紹sphinx的安裝及簡單的應用.
sphinx的下載地址： http://pypi.python.org/pypi/Sphinx
我用的是Sphinx-0.6.5.tar.gz (md5)
sphinx的安裝
=====================================================
解壓縮源文件到指定目錄並安裝sphinx：
$cd /home/user/Downloads
$tar zxvf sphinx.tar.gz /home/user/zhangxiaofeng
$sudo sphinx-quickstart
指定sphinx的安裝路徑(此安裝路徑適自己情況而定)：
> Root path for the documentation [.]: /home/user/src/sphinx_test
這個選項保持默認,直接回車
這裡也是保持默認,直接回車
> Project name: sphinx（自定義）
> Author name(s): zyliday（自定義）
> Project version:0.1（自定義）
接下來的選項保持默認,全部按回車直到完成安裝（安裝過程中好多地方直接回車就可以了,因為不影響sphinx的安裝結果,
在這裡不詳細的介紹安裝過程中的選項）.
驗證安裝是否成功的命令：
$cd /home/user/src/sphinx
$ls
用以上命令,如果看到生成一些文件則安裝成功.
sphinx的簡單應用
=====================================================
我們的目的：
-----------------------------------------------
以下文檔介紹中我們要實現的效果就是將linux中的普通的文本用sphinx轉換成為pdf格式.
轉換前的準備工作,修改index.rst文件
-----------------------------------------------
進入sphinx目錄並編輯index.rst文件:
$cd /home/user/src/sphinx
$gedit index.rst
寫入以下信息：
.. toctree::
:maxdepth: 2
childdir/test
保存文件.
sphinx中轉換普通文件為pdf文件
----------------------------------------------
在/home/user/src/sphinx目錄中新建childdir目錄,並在childdir目錄中新建test.rst文件,然後編輯文件：
::
$cd /home/user/src/sphinx
$mkdir childdir
$gedit test.rst
這個文件是存放pdf文件的內容的,直接在這裡輸入文章內容就可以了.
然後執行以下命令生成pdf文件：
$cd /home/user/src/sphinx
$make latex
$cd /home/user/src/_build/latex
$make
$xelatex sphinx.tex
＆＆目前在test.rst中輸入英文,在輸出的中結果是可以顯示的,但輸入中文還是不能顯示.下面的操作是使生成的pdf支持中文.
sphinx中支持中文
-----------------------------------
進入目錄編輯conf.py文件:
$cd /home/user/src/sphinx
$gedit conf.py
找到$ Additional stuff for the LaTeX preamble.$ latex_preamble = ''這兩行,並將其改為：
$ Additional stuff for the LaTeX preamble.
latex_preamble = 'usepackage{tex-live-zh-cn}'
再執行以下命令使之重新生成pdf文件並查看：
$cd /home/user/src/sphinx
$make latex
$cd /home/user/src/sphinx/_build/latex
$xelatex sphinx.tex
$evince sphinx.pdf
我們已經將texlive及sphinx 的安裝及簡單應用完成了,目前為止我們已經可以將一篇文檔用pdf的格式瀏覽了,envice命令也為我們提供了良好的顯示效果.
