diff options
author | Jjgod Jiang <gzjjgod@gmail.com> | 2008-07-31 06:51:53 +0000 |
---|---|---|
committer | Jjgod Jiang <gzjjgod@gmail.com> | 2008-07-31 06:51:53 +0000 |
commit | 3140f5121bb5ad5aef787c48690f9f64eecdc087 (patch) | |
tree | 7579f08da2aaf215c472fd8ad5c3ef9cf94db4e4 /Master | |
parent | 769faf297f118f738193eba85eba1a965b8d08f6 (diff) |
1. Remove unused xcp.py file.
2. Update README to reflect new build instructions.
3. Finish proof reading for section 2.
git-svn-id: svn://tug.org/texlive/trunk@9927 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
3 files changed, 92 insertions, 234 deletions
diff --git a/Master/texmf-doc/source/texlive/texlive-zh-cn/README-live.ZH-CN b/Master/texmf-doc/source/texlive/texlive-zh-cn/README-live.ZH-CN index d8fcc64f94f..a308e7daaa1 100644 --- a/Master/texmf-doc/source/texlive/texlive-zh-cn/README-live.ZH-CN +++ b/Master/texmf-doc/source/texlive/texlive-zh-cn/README-live.ZH-CN @@ -3,34 +3,31 @@ TeX Live Guide Translation (Simplified Chinese) To compile live.tex, you need: -1. Xe(La)TeX (and related packages like fontspec). +1. Xe(La)TeX (and related packages like fontspec) +0.997+ (a recent version is bundled with TeX Live). -2. Python 2.4 (required by xcp.py, a preprocess -script for tuning Chinese support in XeTeX). +2. xeCJK macro package. -3. xcp.py (already included). - -4. At least one CJK font (with Simpified Chinese +3. At least one CJK font (with Simpified Chinese glyphs), preferably two, one for normal text, another for emphasized text. To change the font, -open tex-live.sty (line 21): +open tex-live.sty (line 23 - 25): -\newfontinstance\zhfont[BoldFont=Adobe Heiti Std, - ItalicFont=Adobe Heiti Std]{Adobe Song Std} + \setCJKmainfont[BoldFont=Adobe Heiti Std]{Adobe Song Std} + \setCJKmonofont[Scale=0.9]{Adobe Kaiti Std} + \setCJKfamilyfont{song}[BoldFont=Adobe Heiti Std]{Adobe Song Std} Replace "Adobe Heiti Std" and "Adobe Song Std" to some OpenType/TrueType fonts you already installed. -5. Type make (yep, you need GNU make or other make -variants). +4. Type make or simply -6. To make sure cross reference are generated, -try running make 3 times or more. + xelatex texlive-zh-cn.tex -7. Some temporary files named "live.true.*" will be -generated, you can ignore or remove them safely. +for several times to make sure cross-references are +correctly generated. -8. If you have any problems, please contact: +5. If you have any problems, please contact: gzjjgod at gmail dot com jjgod, 2007/01/03. diff --git a/Master/texmf-doc/source/texlive/texlive-zh-cn/texlive-zh-cn.tex b/Master/texmf-doc/source/texlive/texlive-zh-cn/texlive-zh-cn.tex index 10f32a6e1c0..4e6dddb58c7 100644 --- a/Master/texmf-doc/source/texlive/texlive-zh-cn/texlive-zh-cn.tex +++ b/Master/texmf-doc/source/texlive/texlive-zh-cn/texlive-zh-cn.tex @@ -150,73 +150,81 @@ Catalogue 就是你首先该找的地方。这里是所有 \TeX{} 相关内容 % don't use \TL so the \uppercase in the headline works. Also so % tex4ht ends up with the right TeX. Likewise the \protect's. -\section{\protect\TeX\protect\ Live 的结构} +\section{\protect\TeX\protect\ Live 概览} \label{sec:overview-tl} -这个小节描述的是 \TL{} 的结构与内容,以及包含 \TL{} 的 \TK{}。 +这个小节描述的是 \TL{} 的内容,以及包含 \TL{} 的 \TK{}。 \subsection{\TL, pro\TeX{}t, Mac\TeX\ 的大集合: \TK} \label{sec:tl-coll-dists} -\TK{} 的 \DVD{} 包含了以下的發行版: + +\TK{} 的 \DVD{} 包含了以下内容: \begin{description} -\item [\TL] 是一個完整的 \TeX{} 系統, 它可以直接在光盘上運行, 也可以安裝在本地的磁盘上. +\item [\TL] 是一个完整的 \TeX{} 系统,它可以直接在光盘上运行,也可以安装在本 +地磁盘上。 + +\item [Mac\TeX] 在 \TL{} 的基础上增加了原生的 \MacOSX\ 的安装程序和一些其它的 +Mac 应用程序。它的主页在 \url{http://www.tug.org/mactex/}。 -\item [Mac\TeX] 在 \TL{} 的基礎上, 又增加了一个 \MacOSX\ 的安装程序和其它的 Mac 应用. 它的官方主页在 \url{http://www.tug.org/mactex/} \item [pro\TeX{}t] 是 Windows 下的 \MIKTEX\ 发行版的一个增强版本。\ProTeXt\ 在 -\MIKTEX\ 基础上增加了一些额外的工具,简化了安装过程。它是完全独立于 \TL{} 的,有其 +\MIKTEX\ 基础上增加了一些工具,简化了安装。它完全独立于 \TL{},有其 自己的安装步骤。\ProTeXt\ 的主页在 \url{http://tug.org/protext}。 -\item [CTAN] 一个 \CTAN{} 的快照. +\item [CTAN] 一份 \CTAN{} 仓库的快照。 -\item[\texttt{texmf-extra}] 一个提供额外的安装包的目录. +\item[\texttt{texmf-extra}] 一个提供额外的配套软件包的目录。 \end{description} -\CTAN{}, \pkgname{protext} 和 \dirname{texmf-extra} 并不一定遵循 \TL{} 的版权协议, 因此当你在分发或修改它们时, 要格外地小心. +\CTAN{}, \pkgname{protext} 和 \dirname{texmf-extra} 并不一定遵循 \TL{} +的版权协议,因此在分发或修改时要格外地小心。 \subsection{\TL{} 的顶层目录} \label{sec:tld} -这里是对 \TL{} 发行版顶层目录的一个简短的列表和描述。 -注意在 \pkgname{live} \DVD\ 中,整个 \TL{} 目录结构都存放于 \dirname{texlive} 子目录中,而非光盘的顶层目录下。 +这里是 \TL{} 发行版顶层目录的一个简短的列表和描述。注意在 \pkgname{live} +\DVD\ 中,整个 \TL{} 目录结构都存放于 \dirname{texlive} 子目录中,而非 +光盘的顶层目录下。 \begin{ttdescription} -\item[bin] \TeX{} 系统程序,按平台组织。 +\item[bin] \TeX{} 系统程序,按平台组织。 % -\item[readme.html] 提供了多种语言的网页格式的简介和有用的链接. +\item[readme.html] 网页,提供了多种语言的简介和有用的链接。 % -\item[source] 所有程序的源代码,包括主要的 \Webc{} \TeX{} 和 \MF{} +\item[source] 所有程序的源代码,包括主要的 \Webc{} \TeX{} 和 \MF{} 发行版。 % -\item[support] 各类辅助性宏包与程序。这些内容\emph{不会}自动安装。包括了各类编辑器和 - \TeX\ 的前端 (外壳) 程序。 +\item[support] 各类辅助性宏包与程序。这些内容\emph{不会}自动安装。 +包括配套的编辑器和 \TeX\ 的前端 (外壳) 程序。 % \item[texmf] 见下文的 \dirname{TEXMFMAIN}。 % \item[texmf-dist] 见下文的 \dirname{TEXMFDIST}。 % -\item[texmf-doc] 这个目录树用于存放和具体程序、宏包关系不大的纯粹文档,按语言组织。 +\item[texmf-doc] 这个目录树用于存放和具体程序、宏包关系不大的纯粹 +文档,按语言组织。 % -\item[tlpkg] 用来维护安装程序所用到的脚本, 程序和数据. 它同时还内置了 Windows 版本的 Perl 和 Ghostscript, 这些程序不能在 \TL 外使用. -同时它还包括了 Windows 下新版本的 PostScript 阅读器 PSView. +\item[tlpkg] 用来维护安装程序所用到的脚本,程序和数据。还内置了 +Windows 下 Perl 和 Ghostscript 的专有版本,它们不能在 \TL 外使用。 +还有一个新的 Windows PostScript 阅读器 PSView。 \end{ttdescription} 上述目录之外,安装脚本和 (多种语言的) \filename{README} 文件也存放在发行版的顶层目录下。 -\dirname{texmf-doc} 目录只包含不隶属于任何特定程序的文档。程序的文档 -(手册,man page, Info 文件等) 在 \dirname{texmf/doc} 目录下,因为这些程序 -本身是属于 \dirname{texmf} 目录的。与之类似,\TeX\ 宏包与格式文件 -的文档放在 \dirname{texmf-dist/doc} 目录。但不管放在哪个地方,你都可以使用 +\dirname{texmf-doc} 目录包含了那些不隶属于任何特定宏包或程序的文档。 +程序的文档 (手册,man page, Info 文件等) 在 \dirname{texmf/doc} +目录下,因为这些程序本身是属于 \dirname{texmf} 目录的。\TeX\ 宏包与格式文件 +的文档则放在 \dirname{texmf-dist/doc} 目录。但不管放在哪个地方,你都可以使用 \cmdname{texdoc} 或 \cmdname{texdoctk} 程序来寻找这些文档。顶层目录下的 \OnCD{doc.html} 文件中提供的完整的链接也会有所帮助。 -\TL\ 本身的文档在 \dirname{texmf-doc} 目录下, 这个目录包含了以下的语言的文档: +\TL\ 本身的文档在 \dirname{texmf-doc} 目录下,有一下这些语言的版本: - \begin{itemize*} +\begin{itemize*} \item{简体中文:} \OnCD{texmf-doc/doc/chinese/texlive-zh-cn} -\item{捷克斯洛伐克语:} \OnCD{texmf-doc/doc/czechslovak/texlive-cz} +\item{捷克/斯洛伐克语:} \OnCD{texmf-doc/doc/czechslovak/texlive-cz} \item{英语:} \OnCD{texmf-doc/doc/english/texlive-en} \item{法语:} \OnCD{texmf-doc/doc/french/texlive-fr} \item{德语:} \OnCD{texmf-doc/doc/german/texlive-de} @@ -228,70 +236,69 @@ Catalogue 就是你首先该找的地方。这里是所有 \TeX{} 相关内容 \subsection{预定义的 texmf 目录树概览} \label{sec:texmftrees} -本小节列出了系统中用于指定 texmf 目录的所有预定义变量及其用途。\texttt{texconfig conf} -命令可以列出这些变量的值,这样你可以很容易找到它们和你所安装到的目录名称的对应关系。 +本小节列出了系统中用于指定 texmf 目录的所有预定义变量及其用途, +还有一个 \TL{} 系统的默认布局。\texttt{texconfig conf} 命令可 +以列出这些变量的值,这样你可以很容易找到它们和你所安装到的目录 +名称的对应关系。 \begin{ttdescription} \item [TEXMFMAIN] 存储系统核心部件的目录树,包括辅助脚本 (比如 -\verb+web2c/mktexdir+)和其他辅助性文件, 以及它们的文档。 -这个目录不包括 \TeX\ 格式和宏包. +\verb+web2c/mktexdir+) 和其他支持文件和文档。 +这个目录不包含 \TeX\ 格式文件和宏包。 \item [TEXMFDIST] 存储主要的宏包、字体等等,即一开始就在发行版中包括的而非自己 后续添加的那些文件。 \item [TEXMFLOCAL] 系统管理员用来安装供整个系统使用的额外的或更新过的宏包、字体的目录。 \item [TEXMFHOME] 给用户存放它们自己独立安装的的宏包、字体等等。 这个变量根据不同的用户选择不同的主目录。 \item [TEXMFCONFIG] 给 \verb+texconfig+、\verb+updmap+、和 \verb+fmtutil+ -这些程序存储修改过的配置文件。 默认使用 \envname{TEXMFHOME}. +这些程序存储修改过的配置文件。默认在 \envname{TEXMFHOME} 目录树下。 \item [TEXMFSYSCONFIG] 给 \verb+texconfig-sys+、\verb+updmap-sys+、和 \verb+fmtutil-sys+ 这些程序存储修改过的文件. \item [TEXMFVAR] 这个目录是给 \verb+texconfig+、\verb+updmap+ 和 \verb+fmtutil+ 存储 (缓存) 格式文件、生成的 map 文件这类运行时数据的。默认是在 \envname{TEXMFHOME} 目录下。 \item [TEXMFSYSVAR] 给 \verb+texconfig-sys+、\verb+updmap-sys+ 和 -\verb+fmtutil-sys+ 这三个命令存储、缓存运行时使用的格式文件和生成的 map 文件。 +\verb+fmtutil-sys+ 还有 \verb+tlmgr+ 这几个命令存储、缓存运行时使用的格式文件和 +生成的 map 文件。 \end{ttdescription} - \noindent 默认的目录结构: \begin{description} - \item[system-wide root] can span multiple \TL{} releases: + \item[全系统根目录] 可以包含多个 \TL{} 版本: \begin{ttdescription} - \item[2007] A previous release. + \item[2007] 上一个版本。 \begin{ttdescription} \item [...] \end{ttdescription} - \item[2008] The current release. + \item[2008] 当前版本。 \begin{ttdescription} \item [bin] ~ \begin{ttdescription} - \item [i386-linux] \GNU/Linux binaries + \item [i386-linux] \GNU/Linux 二进制文件 \item [...] - \item [universal-darwin] \MacOSX binaries - \item [win32] Windows binaries + \item [universal-darwin] \MacOSX 二进制文件 + \item [win32] Windows 二进制文件 \end{ttdescription} - \item [texmf] This is \envname{TEXMFMAIN}. + \item [texmf] 这是 \envname{TEXMFMAIN}。 \item [texmf-dist] \envname{TEXMFDIST} \item [texmf-doc] \envname{TEXMFDOC} \item [texmf-var] \envname{TEXMFSYSVAR} \item [texmf-config] \envname{TEXMFSYSCONFIG} \end{ttdescription} - \item [texmf-local] \envname{TEXMFLOCAL}, intended to be - retained from release to release. + \item [texmf-local] \envname{TEXMFLOCAL} 用来存放在不同版本间共享的数据。 \end{ttdescription} - \item[user's home] (\texttt{\$HOME} or + \item[用户主 (home) 目录] (\texttt{\$HOME} 或 \texttt{\%USERPROFILE\%}) \begin{ttdescription} - \item[.texlive2007] Privately generated and configuration data - for a previous release. - \item[.texlive2008] Privately generated and configuration data - for the current release. + \item[.texlive2007] 给上个版本的,个人生成和配置的数据。 + \item[.texlive2008] 给这个版本的,个人生成和配置的数据。 \begin{ttdescription} \item [texmf-var] \envname{TEXMFVAR} \item [texmf-config] \envname{TEXMFCONFIG} \end{ttdescription} - \item[texmf] \envname{TEXMFHOME} Personal macros. - \textit{etc.} + \item[texmf] \envname{TEXMFHOME} 个人的宏包文件。 + \textit{等等} \end{ttdescription} \end{description} @@ -299,32 +306,35 @@ Catalogue 就是你首先该找的地方。这里是所有 \TeX{} 相关内容 \subsection{\protect\TeX\ 的扩展版本} \label{sec:tex-extensions} -\TeX{} 本身己经停止开发了, 仅仅修改除去发现的极其少量的错误. -在现在以及可预见的未来, \TL\ 中仍然提供 \prog{tex} 这个程序. -除此以外, \TL{} 包括了一些建立在 \TeX\ 基础上的的扩展程序. +\TeX{} 的开发已经冻结了,仅仅修改除去发现的极其少量的错误。 +在现在以及可预见的未来,\TL\ 中仍然提供 \prog{tex} 这个程序。 +除此以外,\TL{} 包括了一些建立在 \TeX\ 基础上的的扩展程序。 \TL{} 包括下列 \TeX\ 扩展版本: \begin{description} -\item [\eTeX] 为 \TeX\ 增加了一套小而有用的新原语 (primitive)。 +\item [\eTeX] 为 \TeX\ 增加了一套新的原语 (primitive)。 \label{text:etex} (包括宏展开,字符扫描,mark 的分类,额外的调试功能,等等) 以及用于双向排版的 \TeXXeT{} 扩展模式。在默认模式下,\eTeX{} 是与原始的 \TeX\ 100\% 兼容的。参见 \OnCD{texmf-dist/doc/etex/base/etex_man.pdf}。 \item [pdf\TeX] 在 \eTeX\ 扩展的基础上构建,在 \dvi{} 输出之外增加对 \acro{PDF} 输出的支持。 -当执行 \prog{etex}, \prog{latex} 或 \prog{pdflatex} 命令时, 实际上都是启动了这个种序. 见 \url{http://www.pdftex.org}. -文档在 \OnCD{texmf/doc/pdftex/manual} 下可以找到, 同时, 它的一些功能的例子可在 \OnCD{texmf/doc/pdftex/manual/samplepdf/samplepdf.tex} 找到. - -\item [Lua\TeX] 是 pdf\TeX\ 的后继者, 它尽可能地保持着向后兼容. -它同时也是 Aleph (见后) 的继任者. -它内置的 Lua 语言解释器 (\url{http://www.lua.org}) 使得很多 \TeX{} 的棘手问题变得轻松容易. -当执行 \filename{texlua} 时, 它就像一个标准的 Lua 解释器一样工作, -所以, Lua\TeX\ 在 \TL\ 中也被作为 Lua 程序的解释器. -见 \url{http://www.luatex.org} 和 \OnCD{texmf-dist/doc/luatex/luatexref-t.pdf} - -\item [Xe\TeX] 通过第三方库,增加对 Unicode 输入文本和 OpenType 字体的支持。 -参见 \url{http://scripts.sil.org/xetex}。 +这是针对 \prog{etex}, \prog{latex} 或 \prog{pdflatex} 这些格式使用的缺省程序。 +见 \url{http://www.pdftex.org}。它的手册在 \OnCD{texmf/doc/pdftex/manual}。展 +示其一些功能的例子可以在 \OnCD{texmf/doc/pdftex/manual/samplepdf/samplepdf.tex} +中找到。 + +\item [Lua\TeX] 是 pdf\TeX\ 指定的后继者,尽可能对 pdf\TeX\ 保持向前兼容。 +它同时也是 Aleph (见后) 的继任者。 +它内置的 Lua 语言解释器 (\url{http://www.lua.org}) 为许多 \TeX{} 的棘手问题 +提供了优雅的解决方案。 +当以 \filename{texlua} 命令执行时,它就像一个标准的 Lua 解释器一样工作, +所以,Lua\TeX\ 在 \TL\ 中也被作为 Lua 程序的解释器。 +见 \url{http://www.luatex.org} 和 \OnCD{texmf-dist/doc/luatex/luatexref-t.pdf}。 + +\item [Xe\TeX] 通过第三方库,增加对 Unicode 输入文本和 OpenType 字体的支持, +能够直接使用系统字体。参见 \url{http://scripts.sil.org/xetex}。 \item [\OMEGA\ (Omega)] 基于 Unicode (16 位字符集),因而同时支持处理世界上 几乎所有的语言。它同时还支持所谓的 `\OMEGA{} Translation Processes' (\acro{OTP}), @@ -368,15 +378,16 @@ pdf\TeX\ 的一套替换方案。参见 \pkgname{ps4pdf} 和 \item [texexec, texmfstart] Con\TeX{}t 和 \acro{PDF} 处理工具。 -\item [tex4ht] \TeX{} 到 \acro{HTML} 的转换器。 +\item [tex4ht] \TeX{} 到 \acro{HTML} (还有 \acro{XML} 等其他格式) +的转换器。 \end{cmddescription} \subsection{\TL\ 中的字体} -\TL{} 中包括了很多的高质量矢量字体, 见 \url{http://tug.org/fonts} 和 -\OnCD{texmf-doc/english/free-math-fonts-survey} +\TL{} 中包括了很多的高质量矢量字体,参见 \url{http://tug.org/fonts} 和 +\OnCD{texmf-doc/english/free-math-fonts-survey}。 \section{安装} \label{sec:install} diff --git a/Master/texmf-doc/source/texlive/texlive-zh-cn/xcp.py b/Master/texmf-doc/source/texlive/texlive-zh-cn/xcp.py deleted file mode 100644 index a256f846756..00000000000 --- a/Master/texmf-doc/source/texlive/texlive-zh-cn/xcp.py +++ /dev/null @@ -1,150 +0,0 @@ -# xcp.py: XeTeX Chinese Proprocessor 0.2.2 -# Changelog: -# 0.2.2: prevent unnecessary processing with '@' -# before '{' -# 0.2.1: minor upgrade to fix comment handling - -import codecs, sys - -LINE_END = '\n' -MARK_START = '\\begin{document}' -MARK_END = '\\end{document}' - -VERB_START = '\\begin{verbatim}' -VERB_END = '\\end{verbatim}' - -try: - f = codecs.open(sys.argv[1], encoding='utf-8') -except IOError: - print "file", sys.argv[1], "no exist" - sys.exit() - -start = 0 -stdout = sys.stdout - -def output(x): - stdout.write(x.encode('utf-8')) - -def output_line_end(): - output(LINE_END) - -def isch(x): - # Punct & Radicals - if x >= 0x2e80 and x <= 0x33ff: - return 1 - - # Fullwidth Latin Characters - if x >= 0xff00 and x <= 0xffef: - return 1 - - # CJK Unified Ideographs & - # CJK Unified Ideographs Extension A - if x >= 0x4e00 and x <= 0x9fbb: - return 1 - # CJK Compatibility Ideographs - if x >= 0xf900 and x <= 0xfad9: - return 1 - - # CJK Unified Ideographs Extension B - if x >= 0x20000 and x <= 0x2a6d6: - return 1 - - # CJK Compatibility Supplement - if x >= 0x2f8000 and x <= 0x2fa1d: - return 1 - - return 0 - -ch = 0 -b = 0 -lc = 0 -comment = 0 -enable = 1 -level = 0 -verbatim = 0 - -for line in f: - if verbatim == 0 and line.find(MARK_END) != -1: - output_line_end() - start = 0 - - if start > 0: - if line.find(VERB_START) != -1: - verbatim = 1 - - if line.find(VERB_END) != -1: - verbatim = 0 - - # if last \zh{ has not yet been closed - if ch == 1 and (isch(ord(line[0])) == 0 or line[0] == '\n'): - ch = 0 - output('}') - - if isch(lc) and isch(ord(line[0])): - output('%') - - if b == 0: - b = 1 - else: - output_line_end() - - # if line.find('\\XeTeX') != -1: - # output(line[:-1]) - # continue - - if line[0] == LINE_END: - lc = ord(LINE_END) - - line_len = len(line) - for i in range(line_len): - c = line[i] - if c == '%' and lc != ord('\\'): - comment = 1 - - if c == LINE_END: - comment = 0 - break - - n = ord(c) - if comment == 1: - output(c) - lc = n - continue - - if c == '@' and i + 1 < line_len and line[i + 1] == '{': - enable = 0 - level = 0 - continue - - # match parens - if enable == 0 and c == '{': - level += 1 - - if enable == 0 and c == '}': - level -= 1 - - if enable == 0 and level == 0: - enable = 1 - - # output directly without processing - if enable == 0: - output(c) - lc = n - continue - - # chinese starts - if ch == 0 and isch(n) == 1: - output('\\zh{') - ch = 1 - - elif ch == 1 and isch(n) == 0: - output('}') - ch = 0 - lc = n - output(c) - else: - output(line) - - if line.find(MARK_START) != -1: - start = 1 - |