百度和谷歌上很难找到的texlive和sphinx

在文章的开始，我想先说几句，呵呵！texlive和sphinx真的很难搜索到，我以后可能很少会再研究这个了，希望我的这点微弱的资料能给大家学习带来一点点轻松。如果在这里看的效果感觉不是很好的话，大家可以到51CTO的下载中心去下载PDF版的。还是希望大家到下载中心去下载，时间原因，我这个也是从我的源文件那里复制过来的，大家看的时候可能会发现这篇文档和你以往看过的有点不太一样，因为我这个可以说是源文件。(最后我希望看过我的文档的人能够给予评价，不管好坏我都会接受的，因为这里面有一个小小的故事，关于我的一个小小的故事，我比较关注大家看完之后的感受。以后会一直专攻linux，但可能不会再弄texlive和sphinx了)



                                        Texlive和sphinx的安装和简单应用
=================================
前言
=================================

文档内容简介
=======================

本文档主要介绍的texlive2009和sphinx的安装及他们的简单应用。在下面的章节中，我们所用到的系统环境是ubuntu操作系统以及ubuntu的常用命令和gedit 编辑器，我所执行的命令都是在终端模式下执行的。但并没有太多的特殊命令，都是linux里边常用的一些命令，没有什么太大的难度。希望大家能够仔细的阅读本文档，希望大家能够对本文档提出意见与建议，让我们共同进步！

联系方式
=======================

我的邮箱：[email protected]

我的MSN :[email protected]

我的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命令也为我们提供了良好的显示效果。

专注分享微软技术，九年相伴！

如果您觉得作者的文章写的不错，请通过“支付宝”或“微信”奖励作者一些银子~

不需要太多，一点心意就好！