一直纠结：用什么工具来记录学习中的点滴，用什么写软件的文档

• 在线的（blog、wiki、google doc、google site、...）
• 离线的（wiki、LaTeX、sphinx、docbook、doxygen...）

...

然后觉得 git + sphinx 应该是个不错的选择，恩，生成网页、qthelp、chm文件等都还不错，可是，当想生成包含中文的pdf时，又回到了让人倍感头痛的 LaTeX中文问题上面来了...

windows下似乎没什么好说的，本文稍偏重ubuntu，总体来说latex中文比前几年好用太多了。本文最初目标，学习最基本的sphinx+latex的中文处理。

名词

相关(类似)的名词太多了，想分清真不容易

真够乱的，还好，我们只关注一部分：

LaTeX

原始的TeX已经有了一组宏集，也就是Knuth所写的著名的Plain TeX(原始的TeX和Plain Tex都是《The TeXbook 》一书中介绍的内容)。

但是这些命令仍然很底层，不够方便、直观，于是Leslie Lamport写了另一组宏，称为LaTeX，主要是它版本配置和文中内容适度分开处理。

LaTeX 2ε是自1993年以来LaTeX的一个稳定版本，是目前大部分LaTeX书籍的主体内容。

ctex

ctex宏包提供了一个统一的中文LaTeX文档框架,底层支持CCT、CJK和xeCJK三种中文LaTeX系统。

• CCT 非常不推荐了
• CJK 这个？应该在windows下工作还很不错
• xeCJK 比较推荐

ctex宏包提供了编写中文LaTeX文档常用的一些宏定义和命令。

主要文件包括ctexart.cls、ctexrep.cls、ctexbook.cls 和 ctex.sty、ctexcap.sty。

生成pdf流程

• 原始的方式

• dvipdfm(x),少一个 *.ps 步骤

• pdflatex或xelatex，直接生成 pdf

配置

TeX Live

种种迹象表明，ubuntu软件仓库中的TeX Live非常非常不好用。于是，只能从官方下载ISO镜像，或者直接网络安装了。

• 下载 texlive2011-20110705.iso
• 挂载

sudo mkdir /mnt/texlive
sudo mount -o loop texlive2011-20110705.iso /mnt/texlive

• 安装

cd /mnt/texlive
sudo ./install-tl

TeXworks

很不错的一个Tex(LaTeX、ConTeXt等)文档的创作环境，一个基于Unicode的可感知TeX的编辑器，集成了PDF浏览功能，干净、简洁的操作界面。

恩，更主要的是Qt4编写的开源软件，跨Windows、Linux、Mac OS环境。

中文配置

• 主要涉及几个宏包，这些宏包进化太快了，远没有latex稳定，可能了解它们最好的办法就是看其自带的手册了。

当前的推荐配置(?)

• 使用XeLaTeX引擎处理中文
• 使用xeCJK宏包解决中西文字体选择、标点符号位置、CJK兼容等问题
• 使用ctex宏包和文档类解决中文版式习惯的问题

不使用这两个宏包（需要设置所用字体，命令fc-list:lang=zh-cn用来查看系统字体）

\documentclass[11pt,a4paper]{article}
\usepackage{fontspec}
\setmainfont{WenQuanYi Micro Hei}
\begin{document}
TeX Live 2011，XeLaTeX，Texworks，你们好！！
\end{document}

直接使用xeCJK宏包。(属于底层的方案)

\documentclass{article}
\usepackage{xeCJK}
\setCJKmainfont{WenQuanYi Micro Hei}
\begin{document}
TeX Live 2011，XeLaTeX，Texworks，你们好！！
\end{document}

使用ctex宏包。高层的方案。(默认的字体是为windows准备的，在linux下，可以直接设置字体，但更建议采用后面的方法，修改ctex的字体文件)

\documentclass{ctexart}
\setCJKmainfont{WenQuanYi Micro Hei}
\begin{document}
TeX Live 2011，XeLaTeX，Texworks，你们好！！
\end{document}

解决字体问题后，看起来还是很简单的：

\documentclass{ctexart}
\begin{document}
TeX Live 2011，XeLaTeX，Texworks，你们好！！
\end{document}

字体

• 如果不想用linux下的字体，还可以把 Windows 下的一些字体直接拷贝到~/.fonts目录中

cp sim* ~/.fonts

• 对于xeCJK宏包，使用命令设置字体，比如：

\setCJKmainfont[BoldFont=Droid Sans Fallback, ItalicFont=AR PL UKai CN]{AR PL UMing CN}
\setCJKmonofont[Scale=0.9]{AR PL UKai CN}
\setCJKfamilyfont{song}[BoldFont=Droid Sans Fallback]{AR PL UMing CN}
\setCJKfamilyfont{sf}[BoldFont=Droid Sans Fallback]{Droid Sans Fallback}

• 使用ctex宏包时，直接修改下面这个文件：

/usr/local/texlive/2011/texmf-dist/tex/latex/ctex/fontset/ctex-xecjk-winfonts.def

其内容大致如下：

% ctex-xecjk-winfonts.def: Windows 的 xeCJK 字体设置，默认为六种中易字体
% vim:ft=tex

\setCJKmainfont[BoldFont={SimHei},ItalicFont={[SIMKAI.TTF]}]{SimSun}
\setCJKsansfont{SimHei}
\setCJKmonofont{[SIMFANG.TTF]}

\setCJKfamilyfont{zhsong}{SimSun}
\setCJKfamilyfont{zhhei}{SimHei}
\setCJKfamilyfont{zhkai}{[SIMKAI.TTF]}
\setCJKfamilyfont{zhfs}{[SIMFANG.TTF]}

\newcommand*{\songti}{\CJKfamily{zhsong}} % 宋体
\newcommand*{\heiti}{\CJKfamily{zhhei}}   % 黑体
\newcommand*{\kaishu}{\CJKfamily{zhkai}}  % 楷书
\newcommand*{\fangsong}{\CJKfamily{zhfs}} % 仿宋

\endinput

将其中的 [SIMKAI.TTF] 和 [SIMFANG.TTF] 用 KaiTi 和 FangSong 替代。(好奇怪，Windows下怎么会这个奇怪的名字，字体直接拷过来，就不需要这么奇怪的名字)

sphinx

有了前面一堆东西，终于可以回到Pyhton sphinx了

当我们运行 sphinx-build -b latex src target时，它生成

• Makefile
• XXX.tex
• ...

等文件

但是，

• 生成的 .tex 中：使用的documentclass是report或article，我们需要的是ctexrep或ctexart
• 生成的 Makefile 中：使用的latex和pdflatex，我们需要的是 xelatex

这样以来，需要简单修改一下的sphinx的latex生成器了，找到目标(这个位置不定，在python中import sphinx，然后查看sphinx.file比较容易定位)

/usr/lib/pymodules/python2.7/sphinx/writers/latex.py

* 搜索article和report，改为ctexart和ctexrep

Makefile 是通过哪个文件生成的呢？好隐蔽

/usr/share/sphinx/texinputs/Makefile

恩，一个静态文件，直接按照自己需要改就行了。不过我们直接将里面所有的pdflatex直接改成xelatex就够了

参考

• http://wiki.ctex.org/index.php/%E9%A6%96%E9%A1%B5

• http://www.newsmth.net/bbscon.php?bid=460&id=282515&ftype=11

• http://tug.ctan.org/tex-archive/language/chinese/ctex/doc/ctex.pdf

• http://code.google.com/p/texworks/