diff options
Diffstat (limited to 'Master')
| -rw-r--r-- | Master/texmf-doc/source/texlive/texlive-zh-cn/texlive-zh-cn.tex | 1779 |
1 files changed, 605 insertions, 1174 deletions
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 566f7b45170..42696255393 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 @@ -3,7 +3,7 @@ % Michel Goossens, now maintained by Karl Berry and others. % Translated by Jjgod Jiang <gzjjgod@gmail.com>, % Jinsong Zhao <jinsong.zhao@gmail.com>, -% Yue Wang <yulewang@gmail.com> +% Yue Wang <yulewang@gmail.com> % Helin Gai <helin.gai@gmail.com> % Public domain. % @@ -385,6 +385,7 @@ pdf\TeX\ 的一套替换方案。参见 \pkgname{ps4pdf} 和 \subsection{\TL\ 中的字体} +\label{sec:tl-fonts} \TL{} 中包括了很多的高质量矢量字体，参见 \url{http://tug.org/fonts} 和 \OnCD{texmf-doc/english/free-math-fonts-survey}。 @@ -392,571 +393,638 @@ pdf\TeX\ 的一套替换方案。参见 \pkgname{ps4pdf} 和 \section{安装} \label{sec:install} -正如第 \ref{sec:basic} 节 (\p.\pageref{sec:basic}) -所提到的，\TL{} 有这三种用法： +\subsection{启动安装程序} +\label{sec:inst-start} -\begin{enumerate} -\item 直接从光盘执行。 -\item 安装到硬盘。 -\item 将某个或某些软件包安装到现有的 \TeX{} 安装中。 -\end{enumerate} +To start with, get the \TK{} \DVD{} or download the \TL{} net installer, +and locate the installer script: \filename{install-tl} for Unix, +\filename{install-tl.bat} for Windows. -\noindent 以下章节就是针对 Unix 系统介绍每一种用法的详细步骤。 - -\ifSingleColumn \begin{figure}[ht]\noindent \fi -\begin{warningbox} -\textbf{警告：} \TK{} \CD{} 与 \DVD{} 使用 ISO 9660 (High Sierra) -格式，\emph{加上} Rock Ridge (Windows 下是 Joliet) 扩展。 -因此，在 Unix 下为了使用 \TK{} 的全部功能，你的系统必须支持 Rock Ridge -扩展。请查阅你的 \cmdname{mount} 命令的文档以了解如何实现。如果你是在一个 -有多台机器的局域网中使用，可以在支持 Rock Ridge 的那台机器上挂载光盘，这样 -同样可以用于其他所有机器。 - -\leavevmode\quad\quad 现代的操作系统应该都可以毫无问题的使用这些光盘，如果的确 -有什么问题，请告知我们。下面的讨论都是基于你挂载的 \CD{} 可以完全兼容 Rock -Ridge 的情况下进行的。 -\end{warningbox} -\ifSingleColumn\end{figure}\fi - -% -\subsection{从光盘直接运行 \protect\TL{} (Unix 系统下)} - -\def\runlive{% text repeated in windows section -不安装到磁盘而直接在 \pkgname{live} \DVD{} 上使用 \TeX{} 系统是可行的 -(这正是 \TeX\ `Live' 这个名字的来源)。但直接从其他 \CD{} 运行 \TeX{} -是\emph{不}可能的 (参见第 \ref{sec:multiple-dist} -节，\p.\pageref{sec:multiple-dist})。 -} - -\def\startinst{% repeated in other subsections -以启用 Rock Ridge 扩展的方式挂载好 \CD{} 或 \DVD{} 之后，就可以开始使用了。 -具体的命令可能依系统的不同而有所不同，下面的例子在 Linux 下可以正常工作，不过 -设备的名称 (此处是 \filename{/dev/cdrom}) 可能会有区别。(所有我们的例子都使用 -\texttt{>} 作为 shell 提示符；所有用户的输入都有 -\Ucom{\texttt{下划线}}。) -\begin{alltt} -> \Ucom{mount -t iso9660 /dev/cdrom /mnt/cdrom} -\end{alltt} - -\noindent 将当前目录更改为挂载点： -\begin{alltt} -> \Ucom{cd /mnt/cdrom} -\end{alltt} - -\noindent \MacOSX\ 系统通常在 \dirname{/Volumes} 目录下列出自动挂载好的光盘。} - -\def\installtlsh{ -执行安装脚本 \filename{install-tl.sh}： -\begin{alltt} -> \Ucom{sh install-tl.sh}\\ -Welcome to TeX Live... -\end{alltt} +\begin{description} +\item [Net installer:] Download from \CTAN, under +\dirname{systems/texlive/tlnet}; the url +\url{http://mirror.ctan.org/systems/texlive/tlnet} will automatically +redirect to a nearby, up-to-date, mirror. You can retrieve either +\filename{install-tl.zip} which can be used under Unix and Windows and +\filename{install-unx.tar.gz} which is considerably smaller, for Unix +only. After unpacking, \filename{install-tl} and +\filename{install-tl.bat} will be in the \dirname{install-tl} +subdirectory. + +\item [\TeX{} Collection \DVD:] go to its \dirname{texlive} +subdirectory. Under Windows, the installer should start automatically +when you insert the \DVD. You can get the \DVD\ by becoming a member of +a \TeX\ user group (highly recommended, +\url{http://tug.org/usergroups.html}), or purchasing it separately +(\url{http://tug.org/store}), or burning your own from the \ISO\ +image (\url{http://tug.org/texlive/acquire.html}). -\noindent 在几行欢迎信息和列出主菜单选项之后，安装程序会要求你输入一个命令。此时输入 -对应的字符，按下回车即可，不必输入选项周围的尖括号。命令大小写均可，在示例中我们使用 -的是小写。 -} +\end{description} +The following sections explain in more detail. -\runlive -\startinst -\installtlsh +\subsubsection{Unix} -因为要直接从光盘上执行，我们的第一个命令是 \Ucom{d}，然后用第二个命令 \Ucom{1} 来设置路径。 -就算是在光盘直接执行，我们仍然需要设置一个在本地磁盘上的目录，用于存放 \TeX{} 系统 -自动生成的文件，例如字体和格式文件，并存放修改过的配置文件，如果你需要修改的话。 +\begin{figure}[tb] +\begin{boxedverbatim} +======================> TeX Live installation procedure <===================== + +=======> Note: Letters/digits in <angle brackets> indicate menu items <======= +=======> for commands or configurable options <======= + + + Detected platform: Intel x86 with GNU/Linux + + <B> binary systems: 1 out of 16 + + <S> Installation scheme (scheme-full) + + Customizing installation scheme: + <C> standard collections + <L> language collections + 83 collections out of 84, disk space required: 1666 MB + + <D> directories: + TEXDIR (the main TeX directory): + !! default location: /usr/local/texlive/2008 + !! is not writable, please select a different one! + TEXMFLOCAL (directory for site-wide local files): + /usr/local/texlive/texmf-local + TEXMFSYSVAR (directory for variable and automatically generated data): + /usr/local/texlive/2008/texmf-var + TEXMFSYSCONFIG (directory for local config): + /usr/local/texlive/2008/texmf-config + TEXMFHOME (directory for user-specific files): + ~/texmf + + <O> options: + [ ] use letter size instead of A4 by default + [X] create all format files + [X] install macro/font doc tree + [X] install macro/font source tree + [ ] create symlinks in standard directories + + <V> Install for running from DVD + +Other actions: + <I> start installation to HD + <H> help + <Q> quit + +Enter command: +\end{boxedverbatim} +\caption{Main text installer screen (\GNU/Linux)}\label{fig:text-main} +\end{figure} -在本例中，我们使用 \dirname{/opt/texlive2006}。在路径中包含年份是有好处的， -毕竟生成的文件未必是和每年发行的 \TL{} 都兼容的。(如果你能接受默认值 -\dirname{/usr/local/texlive/2006}，那也可以直接跳过这一步。) +\begin{figure}[tb] +\tlpng{install-w32-main}{\linewidth} +\caption{Main \GUI{} installer screen (Windows)}\label{fig:gui-main} +\end{figure} +\noindent +Below, \texttt{>} denotes the shell prompt; user input is +\Ucom{\texttt{bold}}. +Starting in a terminal window on a Unix-compatible system, the simplest +way: \begin{alltt} -Enter command: \Ucom{d} -Current directories setup: -<1> TEXDIR: /usr/local/texlive/2006 -... -Enter command: \Ucom{1} -New value for TEXDIR [/usr/local/texlive/TeX]: \Ucom{/opt/texlive2006} -... -Enter command: \Ucom{r} +> \Ucom{cd /path/to/installer} +> \Ucom{perl install-tl} \end{alltt} +(Or you can invoke \Ucom{perl /path/to/installer/install-tl}, or +\Ucom{./install-tl} if it stayed executable, etc.; we won't repeat all +these variations.) -\noindent 返回主菜单后，我们输入第二个命令 \Ucom{r}，这也是需要输入的最后一个命令。 -它用于设置直接从光盘执行而不安装到硬盘： +To install in \GUI\ mode (you'll need the \dirname{Perl/TK} module), use: \begin{alltt} -Enter command: \Ucom{r} -Preparing destination directories... -... -Welcome to TeX Live! -> +> \Ucom{perl install-tl -gui} \end{alltt} -\noindent 如上所示，现在我们又回到了系统提示符下。 - -下面你需要设置两个环境变量：将 \envname{PATH} 设置为一个平台相关的值 (这样我们 -才能找到要运行的程序)，将 \envname{TEXMFSYSVAR} 设置为上面指定的路径值。 -参考表~\ref{tab:archlist} 以决定对应不同机器架构的 \TL{} 系统版本。 - -\def\textruntexconfig{% -主要的安装过程完成，又设置好环境变量之后，最后一步就是执行 \cmdname{texconfig} -或者 \cmdname{texconfig-sys} 来定制你的安装了。在第 \ref{sec:texconfig} -节 (\p.\pageref{sec:texconfig}) 中对此有详细解释。 -} -\textruntexconfig - -\begin{table*}[ht] -\caption[支持的系统架构]{支持的系统架构} -\label{tab:archlist} -\begin{tabular}{>{\ttfamily}ll} -alpha-linux & HP Alpha GNU/Linux \\ -hppa-hpux & HPPA HP-UX \\ -i386-darwin & x86 \MacOSX \\ -i386-freebsd & x86 FreeBSD \\ -i386-linux & x86 GNU/Linux \\ -i386-openbsd & x86 OpenBSD \\ -i386-solaris & x86 Solaris \\ -mips-irix & SGI IRIX \\ -powerpc-aix & IBM RS/6000 AIX \\ -powerpc-darwin & PowerPC \MacOSX \\ -powerpc-linux & PowerPC GNU/Linux \\ -sparc-linux & Sun Sparc GNU/Linux \\ -sparc-solaris & Sun Sparc Solaris \\ -win32 & Windows (32-bit) \\ -x86\_64-linux & x86 64-bit GNU/Linux \\ -\hline -\end{tabular} -\end{table*} - -\label{text:path} -环境变量的格式和用于永久设置环境变量的初始化文件是和你使用哪个 shell 有关的。 -如果你使用的是 Bourne 兼容型 shell (比如 \cmdname{sh}、\cmdname{bash}、\cmdname{ksh} -之类)，就应该将下面的内容放在你的 \filename{$HOME/.profile} 文件中： +For a complete listing of the various options: \begin{alltt} -PATH=/mnt/cdrom/bin/\var{archname}:$PATH; export PATH -TEXMFSYSVAR=/opt/texlive2006/texmf-var; export TEXMFSYSVAR +> \Ucom{perl install-tl -help} \end{alltt} -\noindent 而对于 C shell 兼容型的 shell (\cmdname{csh}、\cmdname{tcsh})， -应该将下面的内容放在你的 \filename{$HOME/.cshrc} 文件中： -\begin{alltt} -setenv PATH /mnt/cdrom/bin/\var{archname}:$PATH -setenv TEXMFSYSVAR /opt/texlive2006/texmf-var -\end{alltt} +\textbf{Warning about Unix permissions:} Your \code{umask} at the time +of installation will be respected by the \TL{} installer. Therefore, if +you want your installation to be usable by users other than you, make +sure your setting is sufficiently permissive, for instance, \code{umask +002}. For more information about \code{umask}, consult your system +documentation. -\noindent 然后注销当前用户再重新登录，就可以测试你的安装是否成功了 -(参见第 \pageref{sec:test-install} 页的第 \ref{sec:test-install} 节)。 -\def\textifindoubt{% -如果对上述步骤有何疑问，请咨询你那儿对系统配置熟悉的专家，看他能否帮你解决。比如 -如何挂载 \TL{} 光盘、安装到哪个或哪些目录、修改个人初始化文件的正确方法 -等等，都有可能依系统配置的不同而有区别。 -} -\textifindoubt - - -% -\subsection{将 \protect\TeX\protect\ Live 安装到硬盘} -\label{sec:unix-install-disk} - -将 \TL{} 发行版安装到硬盘上当然是可行的，这也是最典型的一种使用方式。\pkgname{live} -和 \pkgname{inst} 发行版都支持这种方式。(关于不同发行版本的介绍，参见第 -\pageref{sec:multiple-dist} 页的第 \ref{sec:multiple-dist} 节。) - -\startinst -\installtlsh - -表~\ref{tab:main-menu-options} 简略地列出了主菜单提供的所有选项。执行这些选项 -的顺序可以任意，但 \Ucom{i} 必须放在最后。不妨按其列出的顺序来执行。 - -% apparently here.sty [H] doesn't support table*. -\begin{table}[H] -\caption{安装的主要选项} -\label{tab:main-menu-options} -\begin{tabular}{>{\ttfamily}ll} -p & 你正在运行的系统平台 (机器架构)。\\ -b & 需要安装的程序 (二进制文件) 对应机器架构。\\ -s & 基本的安装方案 (最小安装，推荐安装，完整安装，等等)。\\ -c & 在基本方案的基础上对个别软件集合的安装进行修改。\\ -l & 修改需要支持的语言种类。\\ -d & 安装到的路径。\\ -o & 其他选项。\\ -i & 进行安装。\\ -\hline -\end{tabular} -\end{table} - -下面是每个选项的进一步细节。 - -\textbf{\optname{p} -- 当前平台} 因为安装脚本可以自动探测其执行的平台，通常这个选项 -都不必设置。你可以用这个选项可以更正自动探测的结果。 - -\textbf{\optname{b} -- 二进制文件的架构} 默认情况下，只会安装对应你当前平台的那些二 -进制文件。你可以在这个菜单中选择安装其他平台下的二进制文件 (或者取消安装当前平台的)。这对 -那些在一个网络中多台不同架构机器共享一个 \TeX\ 环境的情况特别有用。请参考第 -\pageref{tab:archlist} 页的表~\ref{tab:archlist} 以了解支持的所有架构。 - -\textbf{\optname{s} -- 基本安装方案} 在这个菜单里你可以通过选择一套安装方案，来对软 -件包集合作整体的选择，默认的方案是 \optname{full}，即安装所有东西。不过可以选择 -\optname{basic} 方案来只安装一个最小的系统，或者是 \optname{medium} 这个折中方案。 -这里还有专门针对 Omega 和 \acro{XML} 的集合选择。 - -\textbf{\optname{c} -- 个别软件包集合} 这个菜单里你可以覆盖上述方案中选择安装的软件 -包集合。``集合''是一个比``方案''更细一层的概念 \Dash 集合包含一个或多个软件包，而软件包 -(\TL\ 里最底层的分组) 包含的是具体的 \TeX\ 宏文件、字体族等等。这个菜单里用于选择的字母 -是大小写敏感的。 - -\textbf{\optname{l} -- 语言集合} 这个菜单和 \Ucom{c} 的基本目标是一致的，也是 -覆盖已选方案的默认设置。只不过这里是专为选择语言而设。用于选择的字母命令也是大小写敏感的。 -这里是 \TL\ 支持的语言集合：\footnote{为了让你易于和安装界面对应，我们没有翻译这个列表。} - -% xx really should generate list from texmf/tpm/collection/tex-lang* -% a la install-tl.sh. -\begin{tabbing} -\hspace{.25\linewidth} \= -\hspace{.25\linewidth} \= -\hspace{.25\linewidth} \= -\hspace{.25\linewidth} \kill -(some) African scripts \> -Arabic \> -Armenian \> -Chinese\,Japanese\,Korean \\ -Croatian \> -Cyrillic \> -Czech/Slovak \> -Danish \\ -Dutch \> -Finnish \> -French \> -German \\ -Greek \> -Hebrew \> -Hungarian \> -Indic \\ -Italian \> -Latin \> -Manju \> -Mongolian \\ -Norwegian \> -Polish \> -Portuguese \> -Spanish \\ -Swedish \> -Tibetan \> -\acro{UK} English \> -Vietnamese \\ -\end{tabbing} - -\noindent 语言集合通常包括字体、宏、断字规则 (hyphenation pattern) -和其他辅助性文件。(比如一旦你选择了 \optname{French} 集合，就会安装 -\pkgname{frenchle.sty}。) 同时，安装的语言集合还会影响 -\filename{language.dat} 配置文件，这个文件用于控制载入的断字规则。 - -\textbf{\optname{d} -- 安装路径} 这里有三个路径可以修改： -\label{text:instdir} +\subsubsection{Mac\,OS\,X} -\begin{ttdescription} -\item [TEXDIR] 顶层目录，其他所有内容都将被安装到这个目录下。默认值是 -\dirname{/usr/local/texlive/2006}，通常会有改动。我们建议在这个目录名中包含年 -份，以区分不同版本的 \TL{}。(不过也许你可以创建类似 -\dirname{/usr/local/texlive} 这样的符号链接，这样一旦新版本发布了， -你也可以方便的更新。) - -在 \MacOSX\ 下，大多数的 \TeX{} 前端软件都在 \dirname{/usr/local/teTeX} 目 -录下寻找 \TeX{} 程序，所以你可能更倾向于把 \TL{} 安装到那里。 - -\item [TEXMFLOCAL] 这个目录树可以给 \TeX{} 系统 (并非指初始安装的系统，而是指 -随着时间推移你自己定制的一套) 放置一些和 \TL{} 版本无关的文件，主要是字体文件。 -默认值是 \dirname{/usr/local/texlive/texmf-local}，和具体 \TL{} 版本没有 -关联，因为同时这也是推荐你放置自己的本地宏包和配置的地方。 - -\item [TEXMFSYSVAR] 这个目录树用于给 \cmdname{texconfig-sys} -命令放置版本\emph{相关}的文件。默认值是 \dirname{TEXDIR/texmf-var}，通常 -不建议修改。因为还有一个变量是 \envname{TEXMFSYSCONFIG}，给 -\cmdname{texconfig} 存放修改过的配置文件。参见第~\ref{sec:texconfig} 节 (第 -\pageref{sec:texconfig} 页)。 +As mentioned in section~\ref{sec:tl-coll-dists}, a separate distribution +is prepared for \MacOSX, named Mac\TeX\ (\url{http://tug.org/mactex}). +We recommend using the native Mac\TeX\ installer instead of the \TL\ +installer on \MacOSX, because the native installer can make a few +Mac-specific adjustments, in particular to allow easily switching +between the various \TeX\ distributions for \MacOSX\ (Mac\TeX, gw\TeX, +Fink, MacPorts, \ldots). -\end{ttdescription} - -\textbf{\optname{o} -- 其他选项} 在这个菜单里你可以选择下列选项： - -\begin{ttdescription} -\item [a] 指定另一个目录来存放生成的字体文件。前面提到，缺省是在 \envname{TEXMFVAR} -目录树下。这个选项对于需要以只读方式挂载主目录树，同时又要在另一个位置 (通常依不同的主机 -而变化) 上存放动态生成的字体的情况比较有用。 - -\item [l] 在其他位置创建程序、man page 和 \acro{GNU} Info 文件的符号链接。例如， -你可能希望 man page 能放在 \dirname{/usr/local/man} 下，而 Info 文件放在 -\dirname{/usr/local/info} 下边。(当然，你需要对这些目录有足够的权限才能在这些目录 -下创建链接。) +Mac\TeX\ is firmly based on \TL, and the main \TeX\ trees are precisely +the same. It does add a few extra folders with Mac-specific +documentation and applications. -我们不建议你用这个选项来覆盖你的操作系统附带的 \TeX\ 系统。它只是为了在用户已知的目录 -(比如 \dirname{/usr/local/bin}) 中创建链接，而在此前这些目录里是没有任何 \TeX\ -文件的。 - -\item [d] 跳过字体/宏包对应的文档的安装，这能节省不少硬盘空间，也有可能是因为你已经安装 -过了这类文档，为了避免冗余。 - -\item [s] 跳过字体/宏包的源代码树的安装，这在你 (用 \acro{NFS} 之类的方法) 通过网络 -和其他机器共享这个源代码树时会很有用。 - -\end{ttdescription} -\textbf{i -- 执行安装} 一旦你对当前的配置选项都满意了，就可以输入 \Ucom{i} 来执行 -安装，这一步会把选定的内容从光盘复制到指定位置。 +\subsubsection{Windows} -% text is similar to above, but no TEXMFSYSVAR, so we have to write out. -安装完成之后，下一步就是将 \dirname{TEXDIR/bin} 目录下的一个依机器架构而定的子目录 -添加到 \envname{PATH} 中，这样新安装的这些程序可以直接使用。表~\ref{tab:archlist} -(第 \pageref{tab:archlist} 页) 列出了所有的架构名称，你也可以看看 \dirname{TEXDIR/bin} -目录下有什么内容再决定。 - -上述步骤的具体命令、要使用的初始化文件，和你使用的 shell 环境有关。如果你使用的是 -Bourne 兼容型 shell (\cmdname{sh}, \cmdname{bash}, \cmdname{ksh}，等等)， -可以将下面的内容放置到 \filename{$HOME/.profile} 文件中： +If you are using the net installer, or the \DVD\ installer failed to +start automatically, double-click \filename{install-tl.bat}. +You can also start the installer from the command-prompt. Below, +\texttt{>} denotes the prompt; user input is \Ucom{\texttt{bold}}. If +you are in the installer directory, run just: \begin{alltt} -PATH=/usr/local/texlive/2006/bin/\var{archname}:$PATH; export PATH +> \Ucom{install-tl} \end{alltt} -\noindent 对于 C shell 兼容类 shell (\cmdname{csh}、\cmdname{tcsh}), -在 \filename{$HOME/.cshrc} 文件中增加下面的内容： +Or you can invoke it with an absolute location, such as: \begin{alltt} -setenv PATH /usr/local/texlive/2006/bin/\var{archname}:$PATH +> \Ucom{D:\bs{}texlive\bs{}install-tl} \end{alltt} +for the \TK\ \DVD, supposing that \dirname{D:} is the optical drive. -\textruntexconfig - -下面是一个注释了的小例子，其中只使用默认的目录，只安装针对当前系统的二进制文件。 -因此只需要用 \Ucom{i} 安装即可。和前边一样，\texttt{>} 表示 shell 提示符。 - +To install in text mode, use: \begin{alltt} -> \Ucom{sh install-tl.sh} -\Ucom{i} # 执行安装 -> \Ucom{texconfig} ... # 参阅第 \ref{sec:texconfig} 节 -# 设置新的 PATH 变量，以 Linux 为例: -> \Ucom{PATH=/usr/local/texlive/2006/bin/i386-linux:$PATH; export PATH} +> \Ucom{install-tl -no-gui} \end{alltt} -\textifindoubt - - -\subsubsection{非交互式安装} -\label{sec:noninteractive-install} - -你可以使用环境变量来设置默认目录，从而实现在非交互环境下的安装。例如： +For a complete listing of the various options: \begin{alltt} -> \Ucom{TEXLIVE_INSTALL_PREFIX=/opt/texlive} -> \Ucom{export TEXLIVE_INSTALL_PREFIX} -> \Ucom{echo i | sh install-tl.sh} +> \Ucom{install-tl -help} \end{alltt} -这里用 \envname{TEXLIVE\_INSTALL\_PREFIX} 环境变量覆盖了默认的 -\dirname{/usr/local/texlive} 目录，而其他选项不变。所以 \TL{} 在上述情况下会被 -安装到 \dirname{/opt/texlive/2006}。 - -和其他 Unix 下的程序一样，最后的 \Ucom{echo i} 可以替换为任何其他能够直接输入的 -命令序列，因此这些命令也可以通过脚本方式来组合。 - -下面是所有可以设置的变量： - -\begin{ttdescription} -\item [TEXLIVE\_INSTALL\_PREFIX] - 覆盖 \dirname{/usr/local/texlive}。 -\item [TEXLIVE\_INSTALL\_TEXDIR] - 覆盖 \dirname{$TEXLIVE_INSTALL_PREFIX}/2006。 -\item [TEXLIVE\_INSTALL\_TEXMFLOCAL] - 覆盖 \dirname{$TEXLIVE_INSTALL_PREFIX/texmf-var}。 -\item [TEXLIVE\_INSTALL\_TEXMFSYSVAR] - 覆盖 \dirname{$TEXLIVE_INSTALL_TEXDIR/texmf-var}。 -\item [TEXLIVE\_INSTALL\_TEXMFHOME] - 覆盖 \dirname{$HOME/texmf}。 -\end{ttdescription} - -也许我们更应该使用标准 \acro{GNU} 风格的 \filename{configure} -脚本来设置参数，而不是通过环境变量。欢迎志愿者帮我们改进！ - -% -\subsection{将单独的软件包安装到硬盘} - -你可以将单独的软件包或集合从当前发行版安装到现有的非 \TL{} 安装中，或者安装到 -以前的 \TL{} 版本里。 - -\startinst - -执行 \filename{install-pkg.sh} 安装脚本 (而不是用于完整安装的 -\filename{install-tl.sh})： -\begin{alltt} -> \Ucom{sh install-pkg.sh \var{options}} -\end{alltt} +\subsubsection{文本界面安装程序} + +Figure~\ref{fig:text-main} displays the main text mode screen under +Unix. + +This is only a command-line installer; there is no cursor support at +all. For instance, you cannot tab around checkboxes or input fields. +You just type something (case-sensitive) at the prompt and press the +Enter key, and then the entire terminal screen will be rewritten, with +adjusted content. + +The text installer interface is this primitive for a reason: it +is designed to run on as many platforms as possible, even with a +very barebones Perl (for Windows, a Perl subset is included). + +\subsubsection{图形界面安装程序} + +Figure~\ref{fig:gui-main} displays the graphical installer under +Windows. Most differences in available options are due to this +screenshot being from Windows, and the previous text screen being +from \GNU/Linux. + +\subsection{执行安装程序} +\label{sec:runinstall} + +The installer is intended to be mostly self-explanatory. Still, a few +quick notes about the various options and submenus: + +\subsubsection{二进制系统菜单 (只对 Unix 适用)} +\label{sec:binary} + +\begin{figure}[tbh] +\begin{boxedverbatim} +Available sets of binaries: +=============================================================================== + + a [ ] alpha-linux DEC Alpha with GNU/Linux + b [ ] amd64-freebsd x86_64 with FreeBSD + c [ ] hppa-hpux HP-UX + d [ ] i386-freebsd Intel x86 with FreeBSD + e [X] i386-linux Intel x86 with GNU/Linux + f [ ] i386-openbsd Intel x86 with OpenBSD + g [ ] i386-solaris Intel x86 with Sun Solaris + h [ ] mips-irix SGI IRIX + i [ ] powerpc-aix PowerPC with AIX + j [ ] powerpc-linux PowerPC with GNU/Linux + k [ ] sparc-linux Sparc with GNU/Linux + l [ ] sparc-solaris Sparc with Solaris + m [ ] universal-darwin universal binaries for MacOSX/Darwin + o [ ] win32 Windows + p [ ] x86_64-linux x86_64 with GNU/Linux +\end{boxedverbatim} +\caption{Binaries menu}\label{fig:bin-text} +\end{figure} -下面这几个选项控制载入的内容： +Figure~\ref{fig:bin-text} displays the text mode binaries menu. By +default, only the binaries for your current platform will be installed. +From this menu, you can select installation of binaries for other +architectures as well. This can be useful if you are sharing a \TeX\ +tree across a network of heterogenous machines, or for a dual-boot +system. + +\subsubsection{选择要安装的组件} +\label{sec:components} + +\begin{figure}[tbh] +\begin{boxedverbatim} +Select a scheme: +=============================================================================== + + a [ ] TeX Live basic scheme + b [ ] TeX Live scheme for ConTeXt + c [X] TeX Live full scheme + d [ ] GUST TeX Live scheme + e [ ] GUTenberg TeX Live scheme + f [ ] TeX Live medium scheme + g [ ] TeX Live minimal scheme + h [ ] TeX Live for Omega users + i [ ] teTeX scheme + j [ ] XML typesetting scheme +\end{boxedverbatim} +\caption{Scheme menu}\label{fig:scheme-text} +\end{figure} -\begin{ttdescription} -\item [-{}-package=\var{pkgname}] 需要安装的独立软件包。 +Figure~\ref{fig:scheme-text} displays the \TL\ scheme menu; from here, +you choose a ``scheme'', which is an overall set of package collections. +The default \optname{full} scheme installs everything available, but you +can also choose the \optname{basic} scheme for a small system, +\optname{minimal} for testing purposes, and \optname{medium} or +\optname{teTeX} to get something in between. There are also various +specialized and country-specific schemes. + +\begin{figure}[tbh] +\tlpng{stdcoll}{.7\linewidth} +\caption{Collections menu (Linux)}\label{fig:collections-gui} +\end{figure} -\item [-{}-collection=\var{colname}] 需要安装的独立的软件集合。 +You can refine your scheme selection with the `standard collections' and +`language collections' menus (figure~\ref{fig:collections-gui}, shown in +\GUI\ mode for a change). + +Collections are one level more detailed than schemes\Dash in essence, a +scheme consists of several collections, a collection consists of one or +more packages, and a package (the lowest level grouping in \TL) contains +the actual \TeX\ macro files, font files, and so on. + +If you want more control than the collection menus provide, you can use +the \prog{tlmgr} program after installation (see +section~\ref{sec:tlmgr}); using that, you can control the installation +at the package level. + +\subsubsection{目录} +\label{sec:directories} + +The default layout is described in section~\ref{sec:texmftrees}, +\p.\pageref{sec:texmftrees}. The default location of +\dirname{TEXDIR} is different between Windows +(|%PROGRAMFILES%\texlive\2008|) and Unix +(\dirname{/usr/local/texlive/2008}). + +The main reason to change this default is if you lack write permission +for the default location. You don't have to be root or adminstrator to +install \TL, but you do need write access to the target directory. + +A logical alternate choice is a directory under your home directory, +especially if you will be the sole user. Use +`|~|' to indicate this, as in `|~/texlive/2008|'. + +We recommend including the year in the name, to enable keeping different +releases of \TL{} side by side. (You may wish to make a +version-independent name such as \dirname{/usr/local/texlive-cur} via a +symbolic link, which you can then update after testing the new release.) + +Changing \dirname{TEXDIR} in the installer will also change +\dirname{TEXMFLOCAL}, \dirname{TEXMFSYSVAR} and +\dirname{TEXMFSYSCONFIG}. + +\dirname{TEXMFHOME} is the recommended location for personal +macro files or packages. The default value is |~/texmf|. In +contrast to \dirname{TEXDIR}, here a |~| is preserved in the +newly-written configuration files, since it usefully refers to the home +directory of each individual running \TeX. It expands to +\dirname{$HOME} on Unix and \verb|%USERPROFILE%| on Windows. + +\subsubsection{选项} +\label{sec:options} + +\begin{figure}[tbh] +\begin{boxedverbatim} +<P> use letter size instead of A4 by default: [ ] +<F> create all format files: [X] +<D> install font/macro doc tree: [X] +<S> install font/macro source tree: [X] +<L> create symlinks in standard directories: [ ] + binaries to: + manpages to: + info to: +\end{boxedverbatim} +\caption{Options menu (Unix)}\label{fig:options-text} +\end{figure} -\item [-{}-nodoc] 在执行操作时忽略文档文件。 +Figure~\ref{fig:options-text} displays the text mode options menu. +Three of the options here need mentioning: -\item [-{}-nosrc] 在执行操作时忽略源代码文件。 +\begin{description} +\item[use letter size instead of A4 by default:] The usual default paper + size selection. Of course, individual documents can specify a specific + paper size, if desired. + +\item[create all format files:] Although unnecessary format files + take time to generate and disk space to store, it is still recommended + to leave this option checked: if you don't, then format files will be + generated in people's private \dirname{TEXMFVAR} tree as they are + needed. In that location, they will not be updated automatically if + (say) binaries or hyphenation patterns are updated in the + installation, and thus could end up with incompatible format files. + +\item[create symlinks in standard directories] (Unix only): + This option bypasses the need to change environment + variables. Without this option, \TL{} directories have to be added + to \envname{PATH}, \envname{MANPATH} and \envname{INFOPATH}. You will + need write permissions to the target directories. It is not + advisable to overwrite a \TeX\ system that came with your system + with this option. It is intended primarily for creating the links + in standard directories that are known to users, such as + \dirname{/usr/local/bin}, which don't already contain any + \TeX\ files. +\end{description} -\item [-{}-cddir=\var{dir}] 读入的来源目录，默认是当前目录。如果你是按照 -上述步骤进行的，这个目录就是发行版的目录，不需要修改。 +Now when all these settings are to your liking, you can type `I' to +start the installation process. When it is done, skip to +section~\ref{sec:postinstall} to read what else needs to be done, if +anything. + +\subsubsection{设置从 DVD{} 运行 (只对文本模式适用)} +\label{sec:fromdvd} + +Type `|V|' to select this option. This changes the main menu into something +like figure~\ref{fig:main-fromdvd}. +\begin{figure}[tbh] +\begin{boxedverbatim} +======================> TeX Live installation procedure <===================== + +=======> Note: Letters/digits in <angle brackets> indicate menu items <======= +=======> for commands or configurable options <======= + + <D> directories: + TEXDIRW (Writable root): + !! default location: /usr/local/texlive/2008 + !! is not writable, please select a different one! + TEXMFLOCAL (directory for site-wide local files): + /usr/local/texlive/texmf-local + TEXMFSYSVAR (directory for variable and automatically generated data): + /usr/local/texlive/2008/texmf-var + TEXMFSYSCONFIG (directory for local config): + /usr/local/texlive/2008/texmf-config + TEXMFHOME (directory for user-specific files): + ~/texmf + + <O> options: + [ ] use letter size instead of A4 by default + [X] create all format files + + <V> set up for installing to hard disk + +Other actions: + <I> start installation for running from DVD + <H> help + <Q> quit +\end{boxedverbatim} +\caption{The main menu with \optname{from DVD} + set}\label{fig:main-fromdvd} +\end{figure} -\item [-{}-listdir=\var{dir}] 用于读入软件包信息的 `list' 目录，这个目录 -在 \var{cddir} 下。只在你希望修改 \TL{} 的时候才要设置这个选项。 +Note the changes: all options about what to install have +disappeared, and the directories section now talks about +\dirname{TEXDIRW} or writable root. The symlinks option has also +disappeared. -\end{ttdescription} +The installer will still create various directories and +configuration files, but won't copy \dirname{texmf}, +\dirname{texmf-dist} or \dirname{texmf-doc} to hard disk. -而实际的操作是由下列选项设置的，如果这些选项都没有指定，缺省的操作是安装选定的 -文件。目的 (destination) 目录树是用 \cmdname{kpsewhich} 展开 \envname{\$TEXMFMAIN} -变量得到的。你可以设置 \envname{TEXMFMAIN} 或 \envname{TEXMF} 环境变量来覆盖 -这个路径。 +Post-install configuration for Unix will be slightly more complicated, +because now the directory layout deviates from the default; see +section~\ref{sec:postinstall}. -\begin{ttdescription} -\item [-{}-listonly] 仅列出需要安装的文件，而不执行实际的安装。 +Due to time constraints, this option didn't make it into the \GUI{} +installer, but it is available both for Unix and for +Windows. Windows users have to start the installer from a command +prompt, see section~\ref{sec:cmdline}. -\item [-{}-archive=\var{tarfile}] 不将文件安装到 \TeX{} 系统中，而改为 -创建一个 \cmdname{tar} 归档文件。 +Section \ref{sec:portable-unix} describes a more strictly portable +way to run \TL, which doesn't make or require changes in the +system's configuration, but doesn't allow any configuration either. -\end{ttdescription} +\subsection{命令行安装选项} +\label{sec:cmdline} -其他选项： +Type +\begin{alltt} +> \Ucom{install-tl -help} +\end{alltt} +for a listing of command-line options. Either |-| or |--| can be used +to introduce option names. These are the more +interesting ones: \begin{ttdescription} - -\item [-{}-config] 安装后，执行 \code{texconfig init}。 - -\item [-{}-nohash] 安装后，不执行用于重新构建文件名数据库的 \cmdname{mktexlsr} -命令。 - -\item [-{}-verbose] 打印更多脚本执行过程中的信息。 - +\item[-gui] If possible, use the \GUI{} installer. This requires the + Perl/Tk module (\url{http://tug.org/texlive/distro.html#perltk}); + if Perl/Tk is not available, installation continues in text mode. +\item[-no-gui] Force using the text mode installer, even under + Windows; you'll need this if you want a `from \DVD' installation, + since that is not available in \GUI{} mode. +\item[-lang {\sl LL}] Specify the installer interface + language as its standard two-letter code \textsl{LL}. Currently + supported languages: English (\texttt{en}, default), German + (\texttt{de}), French (\texttt{fr}), Dutch (\texttt{nl}), Polish + (\texttt{pl}), Slovenian (\texttt{sl}) and Vietnamese + (\texttt{vi}). The installer tries to determine the right language + itself but if it fails, or if the right language is not available, + then it uses English as a fallback. +\item[-profile {\sl profile}] The installer always writes a file + \filename{texlive.profile} to the \dirname{2008/tlpkg}- or + \dirname{tlpkg} subdirectory of your installation. This option tells + the installer to re-use such a profile file. Here's an excerpt: + \begin{fverbatim} +# texlive.profile written on Wed Jul 9 16:13:44 2008 UTC +# It will NOT be updated and reflects only the +# installation profile at installation time. +selected_scheme scheme-basic +TEXDIR /usr/local/texlive/2008 +TEXDIRW /usr/local/texlive/2008 +... +TEXMFSYSVAR /usr/local/texlive/2008/texmf-var +collection-basic 1 +... +option_symlinks 0 + \end{fverbatim} + Thus, using this option you can install in batch mode on + subsequent systems, reproducing the choices you made for the + original installation. +\item [-location {\sl url/path}] Specify a non-default source for + packages; see below. \end{ttdescription} -下面是一些使用的实例： +\subsubsection{\optname{location} 参数} +\label{sec:location} + +The location value can be a url starting with \texttt{ftp:}, +\texttt{http:}, or \texttt{file:/} url, or a plain path. If the given +argument is on a local drive (either a path or a \texttt{file:/} url), +the installation type (compressed or live) is automatically determined: +if an \dirname{archive} subdirectory with \filename{.tar.lzma} files is +found then it will be used, even if uncompressed files are available as +well. + +When giving an \texttt{http:} or \texttt{ftp:} location, trailing +`\texttt{/}' characters and/or a trailing `\texttt{/tlpkg}' component +are ignored. For example, you could choose a particular \CTAN\ mirror +with something like: +\url{http://ctan.example.org/tex-archive/texlive/tlnet/2008}, +substituting of course a proper hostname and its particular top-level +\CTAN\ path (the list of \CTAN\ mirrors is maintained at +\url{http://ctan.org/mirrors}) for |ctan.example.org/tex-archive|. The +default is to pick a mirror automatically, using +\url{http://mirror.ctan.org}; in any case, the chosen host is used for +the entire download. + +\subsection{安装后的操作} +\label{sec:postinstall} -\begin{enumerate} +Some post-install may be required. -\item 列出而不安装 \pkgname{fancyhdr} 宏包中的文件： +\subsubsection{Windows} -\begin{alltt} -\ifSingleColumn> \Ucom{sh install-pkg.sh --package=fancyhdr --listonly} -\else> \Ucom{sh install-pkg.sh --package=fancyhdr \bs} -> \Ucom{--listonly} -\fi{} -texmf/doc/latex/fancyhdr/README -texmf/doc/latex/fancyhdr/fancyhdr.pdf -... -\end{alltt} - -\item 安装 \LaTeX{} 宏包 \pkgname{natbib}： -\begin{alltt} -> \Ucom{sh install-pkg.sh --package=natbib} -\end{alltt} +But on Windows, the installer takes care of everything. -\item 安装 \LaTeX{} 宏包 \pkgname{alg}，但不安装它的源文件和文档： -\begin{alltt} -\ifSingleColumn> \Ucom{sh install-pkg.sh --package=alg --nosrc --nodoc} -\else> \Ucom{sh install-pkg.sh -{}-package=alg \bs} -> \Ucom{-{}-nosrc -{}-nodoc} -\fi\end{alltt} - -\item 安装所有额外 plain \TeX\ 宏文件的集合： -\begin{alltt} -> \Ucom{sh install-pkg.sh --collection=tex-plainextra} -\end{alltt} +\subsubsection{如果创建了符号链接} -\item 将所有 \pkgname{pstricks} 宏包的内容打包到 \path|/tmp| 目录下的 -\cmdname{tar} 文件里： -\begin{alltt} -\ifSingleColumn> \Ucom{sh install-pkg.sh --package=pstricks --archive=/tmp/pstricks.tar} -\else -> \Ucom{sh install-pkg.sh -{}-package=pstricks \bs} -> \Ucom{-{}-archive=/tmp/pstricks.tar} -\fi\end{alltt} +If you elected to create symlinks in standard directories (mentioned in +section~\ref{sec:options}), then there is no need to edit environment +variables. -\end{enumerate} +\subsubsection{Unix 下的环境变量} +\label{sec:env} -\textifindoubt +The directory of the binaries for your platform must be added to +the search path. Each supported platform has its own subdirectory +under \dirname{TEXDIR/bin}. See figure~\ref{fig:bin-text} for the +list of subdirectories and corresponding platforms. +You can also add the documentation man and Info directories to their +respective search paths, if you want the system tools to find them. -% -\section{安装后的步骤} -\label{sec:postinstall} +For Bourne-compatible shells such as \prog{bash}, and using Intel x86 +GNU/Linux and a default directory setup as an example, the file to edit +might be \filename{$HOME/.profile} (or another file sourced by +\filename{.profile}, and the lines to add would look like this: -在主要的安装完成之后，剩余的步骤就是根据个人需要来配置 \TeX{} 系统，使之 -符合你的需要，并执行一些基本的测试。 +\begin{sverbatim} +PATH=/usr/local/texlive/2008/bin/i386-linux:$PATH; export PATH +MANPATH=/usr/local/texlive/2008/texmf/doc/man:$MANPATH; export MANPATH +INFOPATH=/usr/local/texlive/2008/texmf/doc/info:$INFOPATH; export INFOPATH +\end{sverbatim} -另一类安装后的工作是获得 \TL{} 中并不包含的的宏包、字体和程序。一般只需要将此类 -附加文件安装到 \envname{TEXMFLOCAL} 目录树 (对于硬盘安装) 下，或者 -\envname{TEXMFSYSVAR} 目录树 (对于光盘执行) 下。参见第 \pageref{text:instdir} -页的``安装路径''选项。 +For csh or tcsh, the file to edit is typically \filename{$HOME/.cshrc}, and +the lines to add might look like: -不幸的是，针对不同软件的具体安装细节可能有巨大的差别，因而我们无法在此详述。这里 -有一些到相关叙述的外部链接： -\begin{itemize*} -\item -\url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages} -\item -\url{http://www.ctan.org/installationadvice} -\item -\url{http://www.ctan.org/tex-archive/info/beginlatex/html/chapter5.html#pkginst} -\item -\url{http://www.ctan.org/tex-archive/info/Type1fonts} 专门针对字体的安装信息。 -\end{itemize*} +\begin{sverbatim} +setenv PATH /usr/local/texlive/2008/bin/i386-linux:$PATH +setenv MANPATH /usr/local/texlive/2008/texmf/doc/man:$MANPATH +setenv INFOPATH /usr/local/texlive/2008/texmf/doc/info:$INFOPATH +\end{sverbatim} +Of course, you may well already have settings somewhere in your ``dot'' +files, and so then the \TL\ directories should simply be merged in as +appropriate. -\subsection{\protect\cmdname{texconfig} 程序的使用} -\label{sec:texconfig} +\subsubsection{环境变量的全局配置} +\label{sec:envglobal} -你可以，也应该在安装后使用 \cmdname{texconfig} 命令来配置这套系统，使之符合 -你的需要。这个命令和其他程序一样，安装在依架构变化的 \texttt{TEXDIR/bin/\var{arch}} -子目录下。 +If you want to make these changes globally, or for a user newly added to +the system, then you are on your own; there is just too much variation +between systems in how and where these things are configured. -如果你以不带参数的形式执行，它会进入全屏模式，允许你用交互的方式查看并修改选项。 +Our two hints are: 1)~you may want to check for a file +\filename{/etc/manpath.config} and, if present, add lines such as -你也可以带上各种命令行选项执行。下面是最常见的几个： +\begin{sverbatim} +MANPATH_MAP /usr/local/texlive/2008/bin/i386-linux \ + /usr/local/texlive/2008/texmf/doc/man +\end{sverbatim} -\begin{ttdescription} +And 2)~check for a file \filename{/etc/environment} which may define the +search path and other default environment variables. -\item [texconfig paper letter] 将不同的程序或 driver (\cmdname{pdftex}、 -\cmdname{dvips}、\cmdname{dvipdfm}、\cmdname{xdvi}) 默认的纸张大小设置为 -\acro{US} letter。其他可选的大小有缺省的 \optname{a4} 等。 -\item [texconfig rehash] 在添加或删除文件后更新所有 \TeX{} 的``文件名数据库''。 +\subsubsection{如果从 DVD 运行} -\item [texconfig faq] 显示 \teTeX{} \acro{FAQ}。(参见 -\OnCD{texmf-doc/doc/english/FAQ-en} 上的主 \TeX{} \acro{FAQ}。) +Normally, a \TL{} program consults a file \filename{texmf.cnf} for the +location of the various trees. It looks for this file in a series of +locations relative to its own location. However, this scheme breaks down +when a program is run from \DVD{}: the \DVD{} is read-only. Some of the +paths to be recorded in \filename{texmf.cnf} are only known at +installation time, so this file cannot be on the \DVD{} and must be +placed somewhere else. This makes it necessary to define an environment +\envname{TEXMFCNF} variable which tells \TL{} programs in what directory +to find this \filename{texmf.cnf}. It is also still necessary to modify +the \envname{PATH} environment variable, as described before. -\item [texconfig help] 输出 \cmdname{texconfig} 的帮助信息。 +At the end of the installation, the installer should have printed a +message giving the value to which \envname{TEXMFCNF} should be set. In +case you missed it: this value is \dirname{$TEXMFSYSVAR/web2c}. For the +default, \dirname{/usr/local/texlive/2008/texmf-var/web2c}, you need the +lines +\begin{sverbatim} +TEXMFCNF=/usr/local/texlive/2008/texmf-var/web2c; export TEXMFCNF +\end{sverbatim} +or, for [t]csh: +\begin{sverbatim} +setenv TEXMFCNF /usr/local/texlive/2008/texmf-var/web2c +\end{sverbatim} -\end{ttdescription} -当然 \cmdname{texconfig} 只能修改 \TeX{} 系统里大量选项和参数中的一部分。对 -基本 \Webc{} 程序通用的主配置文件是 \filename{texmf.cnf}，你可以使用 -\samp{kpsewhich texmf.cnf} 找到它的位置，这个文件里的注释说明了缺省的设置和 -可选的参数。 +\subsubsection{\ConTeXt{} Mark IV} -\cmdname{texconfig} 修改的是当前用户目录 (\dirname{$HOME/.texlive2006}) -下的配置。如果你安装的 \TeX\ 只给自己一个人用，那这么做没什么不妥。不过如果 \TeX\ -是安装在一个多用户的系统里，你可能希望更改整个系统的配置，这样的话运行的应该是 -\cmdname{texconfig-sys} 而非 \cmdname{texconfig}。 +The `old' \ConTeXt{} should run out of the box. The new `Mark IV' +\ConTeXt{} will require manual setup; see +\url{http://wiki.contextgarden.net/Running_Mark_IV}. -与之类似，\cmdname{updmap} 和 \cmdname{fmtutil} 脚本也已改变为只修改 -\dirname{$HOME/.texliveYYYY} 目录下的配置。请使用 \cmdname{updmap-sys} -和 \cmdname{fmtutil-sys} 来调整系统目录下的配置。 -尤其需要注意的一点是，\texttt{fmtutil-sys --missing} 命令是很有用的 --- -预先在系统路径下生成好所有标准的格式，否则每个用户都得在自己的目录下生成相同的格式文 -件了，麻烦而且浪费空间。 +\subsubsection{集成本地与个人宏文件} +\label{sec:local-personal-macros} -此外，如果你自己修改过 \filename{fmtutil.cnf} 或 \filename{updmap.cfg} 而 -不用系统安装时附带的版本，那这些文件应该存放在 \envname{TEXMFSYSCONFIG} 变量对 -应的那个目录树中。 +This is already mentioned implicitly in section~\ref{sec:texmftrees}: +\dirname{TEXMFLOCAL} (by default, +\dirname{/usr/local/texlive/texmf-local} or +\verb|C:\Program Files\texlive\texmf-local|) + +is intended for system-wide local fonts and macros; and +\dirname{TEXMFHOME} (by default, \dirname{$HOME/texmf} or +\verb|%USERPROFILE%\texmf|), is for personal fonts and macros. These +directories are intended to stick around from release to release, and +have their content seen automatically by a new \TL{} release. +Therefore, it is best to refrain from changing the definition of +\dirname{TEXMFLOCAL} to be too far away from the main \TL{} directory, +or you will need to manually change future releases. + +For both trees, files should be placed in their proper subdirectories; +see \url{http://tug.org/tds} or consult +\filename{texmf/web2c/texmf.cnf}. For instance, a \LaTeX{} class file or +package should be placed in \dirname{TEXMFLOCAL/tex/latex} or +\dirname{TEXMFHOME/tex/latex}, or a subdirectory thereof. + +\dirname{TEXMFLOCAL} requires an up-to-date filename database, or files +will not be found. You can update it with the command +\cmdname{mktexlsr} or use the `Reinit file database' button on the +configuration tab of \prog{tlmgr} in \GUI\ mode. + +\subsubsection{集成第三方字体} + +This is unfortunately a very complicated and messy topic. Forget +about it unless you really know your way around blindfolded in a +\TeX{} installation. Don't forget to check first what you get for +free: see section~\ref{sec:tl-fonts}. + +A possible alternative is to use \XeTeX (see +section~\ref{sec:tex-extensions}), which lets you use operating system +fonts without any installation in \TeX. -第 \ref{sec:texmftrees} 节 (\p.\pageref{sec:texmftrees}) 的环境变量里列 -出了所有这些命令可以更改的目录。你可以执行 \texttt{texconfig conf} 来查看当前 -配置的实际路径，也可以通过编辑 \filename{texmf.cnf} 文件来修改它们。 \subsection{测试安装是否成功} \label{sec:test-install} @@ -978,7 +1046,7 @@ kpathsea version 3.5.7 \end{alltt} 如果返回的结果是 `command not found' 而非版本和版权信息，或者显示了 旧版本的信息，很有可能是因为你没有把正确的 \dirname{bin} 子目录添加 -到 \envname{PATH} 中。参见第 \pageref{text:path} 页关于设置环境变量 +到 \envname{PATH} 中。参见第 \pageref{sec:env} 页关于设置环境变量 的说明。 \item 处理一个基本的 \LaTeX{} 文件： @@ -991,7 +1059,7 @@ Transcript written on sample2e.log. \end{alltt} 如果无法找到 \filename{sample2e.tex} 或其他什么文件，很可能是因为旧的环境变量 或配置文件影响了判断。我们建议你重置所有 \TeX 相关的环境变量然后重试。(你可以 -让 \TeX{} 报告具体搜索的路径，以便仔细分析出错的原因。参见第 \pageref{Debugging} +让 \TeX{} 报告具体搜索的路径，以便仔细分析出错的原因。参见第 \pageref{sec:debugging} 页的``调试操作''一节以了解更多信息。) \item 即时预览结果： @@ -1042,720 +1110,82 @@ Transcript written on sample2e.log. 如果你还是个 \TeX{} 新手，或者在编辑 \TeX{} 或 \LaTeX{} 文档时需要帮助， 请访问 \url{http://tug.org/begin.html} 寻找引导性的资源。 -\section{Mac OS X 下的安装} -\label{sec:mac-install} - -\MacOSX\ 下推荐的 \TeX\ 安装方式是使用 2005 年新出现的 Mac\TeX\ 发行版。 -我们在 \pkgname{live} \DVD{} 的 \dirname{mactex/} 目录下提供了。它 -包括一套自带的 \MacOSX\ 风格的安装程序，可用于安装完整的 \TeX\ 系统，这套发行版 -混合了 te\TeX\ 和 \TL{}，并增加了不少额外的应用程序和文档。项目的主页在 -\url{http://tug.org/mactex}。 - -如果你愿意的话，在 \MacOSX{} 下同样可以直接从 \TL{} 安装 \TeX{}，下面介绍了使用 -\filename{install*} 安装脚本的方法。 - -你必须安装了 \cmdname{bash} shell 才能在 \MacOSX\ 下执行安装脚本。如果你运行 -的是 \MacOSX~10.2 或者以后的版本，那已经符合要求了。但如果用的是更早版本的 \MacOSX{}， -默认的 \cmdname{zsh} shell 是不行的，必须从 Internet 上获取并安装 -\cmdname{bash}，或者更该考虑一下升级你的系统。 - -只要装好了 \cmdname{bash}，就可以按照上述章节的 Unix 安装文档执行。参见第 -\pageref{sec:unix-install} 页的第 \ref{sec:unix-install} 节。上面必要的地 -方已经加上针对 \MacOSX\ 的说明了。 - -\section{Windows 下的安装} -\label{sec:win-install} - -在 \TL{} 的这个版本里，值得高兴的是，我们的发行版重新附带了一个专门针对 Windows -平台的安装程序，称为 \cmdname{tlpmgui.exe}。(对于不同版本发行版的介绍，参见第 -\pageref{sec:multiple-dist} 页的第 \ref{sec:multiple-dist} 节。) - -\cmdname{tlpmgui} 提供和 Unix 安装程序相同的选项，不过是以图形用户界面 -的形式：一样可以选择安装方案、单独的软件集合、安装的目录，等等。第 -\ref{sec:unix-install-disk} 节 (\p.\pageref{sec:unix-install-disk}) -介绍了这些基本概念。\cmdname{tlpmgui} 还支持添加/删除宏包、更新文件名数据库和 -构建格式文件这些安装后的工作。此外，\cmdname{tlpmgui} 也能将系统配置为支持直接 -从 \DVD\ 上运行。 - -喜欢究根问底的人也许有兴趣知道，\cmdname{tlpmgui} 只是一个图形化的前端，其内部引擎 -是命令行程序 \cmdname{tlpm}。 - -\TL{} 中 Windows 下的 \TeX{} 系统中的二进制程序是 \acro{W32TEX} 发行版提供的， -感谢 Akira Kakuto 的支持。系统中还包括其他一些比较旧 (但依然可以正常工作) 的工具， -这些工具是 Fabrice Popineau 制作的。以及一个新的 \texttt{dvi} 预览软件，Toshio -Oshima 的 \textsf{dviout}。 - -\TL{} 可以安装在 Windows 98 / \acro{ME} / \acro{NT} / \acro{2K} 或 -\acro{XP} 下。不支持更老的系统，如 Windows (3.1x) 和 \acro{MS-DOS}。 - -\textbf{警告：} Win9.x 的用户必须在安装前确保他们有足够的空间存放环境变量。 -\cmdname{tlpmgui.exe} 程序不会自动修改这个大小。由于在安装过程中需要设置一些 -环境变量，你可能会遇到环境变量空间不够的情况。可以把 -\texttt{SHELL=<path>COMMAND.COM /E:4096 /P} 添加到你的 \filename{config.sys} -文件中以增加这个空间的大小。 - -\subsection{将 \protect\TeX\protect\ Live 安装到硬盘} - -将 \TL{} \acro{CD} 插入光盘驱动器后，应该就会自动运行 \cmdname{tlpmgui}。如果没有， -请点击 \guiseq{开始\arw 运行}，然后输入 -\verb|<drive letter>:\setuptl\tplmgui.exe| (如果是使用的是 \TK{} \acro{DVD} -则应该输入 \verb|<drive letter>:\texlive\setuptl\tplmgui.exe|)。其中 -\verb|<drive letter>| 是 \TL{} \acro{CD} (或 \TK{} \acro{DVD}) -对应的驱动器符号。然后点击确定。 - -一个标题为 \guiseq{TeX Live installation and maintenance utility} 的安装 -窗口将会出现。它包含下面这几部分：\guiseq{Main customization} -(主要定制)、\guiseq{Install} (安装)、\guiseq{Select a scheme} -(选择安装方案)、\guiseq{Select systems} (选择系统)、\guiseq{Directories} (目录) -和 \guiseq{Options} (选项)。 - -安装程序所在的驱动器 (或目录) 将会出现在 \guiseq{Directories} 里的 \guiseq{CD/DVD} -按钮旁边 (例如 \texttt{F:/} 或 \acro{DVD} 上的 \texttt{F:/texlive/})。如果没有 -出现的话，请点击 \guiseq{CD/DVD} 按钮，选择对应 \TL{} \acro{CD} (或 \TK{} \acro{DVD}) -的那个驱动器。 - -点击 \guiseq{TLroot} 按钮来设置希望安装到的目录。为了后面使用方便，\path|TLroot| -环境变量将被设置为这个目录。 - -在 \guiseq{Select a scheme} 部分，你应该点击单选按钮来选择安装方案 (比如 -\guiseq{scheme-gust})。每个方案旁都附带一个 \guiseq{Info} 按钮，点击后可以显示 -它的简短说明。 - -``方案''是大量某种特定用途的文件的集合。基本、中等和完整安装都有其对应的方案。还有一些 -则是面向某个具体的 \TeX\ 用户组织的 (比如 GUST 或 GUTenberg 推荐其会员使用的) 或 -专为某些应用设计的 (比如专门给 XML 和 \TeX{} 协作而定制)。通过在 -\guiseq{Main customization} 部分的 \guiseq{Standard collections} -或 \guiseq{Language collections} 里选择其他的集合 (collection)，预设的方案 -可以进一步细化。比如点击 \guiseq{Standard collections} 标签旁的 \guiseq{Select} -按钮，\MP{}、Omega 和多种语言的文档这些集合都可以添加进去。 - -默认选择的 \guiseq{Wintools} 集合包含许多 Windows 不会自带的重要小工具，它们 -会很有用，比如图形转换程序 \cmdname{sam2p}, \cmdname{jpeg2ps}, \cmdname{tiff2png}； -压缩/解压缩程序 \cmdname{bzip2}, \cmdname{gzip}, \cmdname{unzip} 和用于 -新的 \cmdname{getnonfreefonts} 工具的 \cmdname{wget} 程序。 - -下一步，在 \guiseq{Main customization} 部分点击标有 \guiseq{Language Collections} -的 \guiseq{Select} 按钮，这将打开 \guiseq{Language collections} 窗口。 -在这个窗口中通过在语言旁边的复选框上打勾来选择安装语言。 - -接下来，点击位于 \guiseq{Install} 部分的 \guiseq{Install} 按钮开始相应的 -安装过程。 - -\textbf{注意：} \guiseq{Ghostscript}、\guiseq{Perl} 和 \guiseq{Wintools} -都是缺省选定的，除非你已经安装过这些软件，或者明确知道自己在干什么，否则不应该取消选择， -因为许多重要的工具都依赖它们。这还会使 \verb|PERL5LIB| 和 \verb|GS_LIB| -环境变量得到设置或修改。 - -\TL{} 系统在安装后还需要一些步骤 (格式文件的生成、ls-R 数据库的生成、设置环境变量， -等等)。所有这些操作均在此时完成，而且其中有些过程可能比较耗时，所以请耐心等待，直到你 -看到关于成功完成安装的提示出现。 - -\cmdname{tlpmgui} 的快捷方式将被添加到 \guiseq{开始\arw 程序\arw TeXLive2006} -菜单中 (\cmdname{dviout} 如果安装了，也会添加快捷方式)。 - -在必要时 (Win9x/WinME)，安装程序会要求你重启计算机。 - -\subsection{为 Windows 提供的支持性软件包} -\label{sec:win-xemtex} - -为了完成 \TL\ 的安装，需要补充一些 Windows 系统下通常没有的软件包。许多脚本是使用 Perl -语言写成的。一些重要的工具程序需要 Ghostscript \PS{} 解释器来渲染或转换文件。有时还需要 -一个图形文件工具包。最后，同样重要的是，一个针对 \TeX\ 的编辑器能让你更轻松地输入 \TeX{} -文件。 - -尽管不难找到这些工具的 Windows 版本，但为了节省你的力气，我们在 \TL\ 中包括了这样一些工具： - -\begin{itemize*} -\item GNU \cmdname{Ghostscript} 8.54 -\item 最小化的 \cmdname{Perl} 5.8，但足以运行 \TL{} 下所有的 Perl 脚本 -\item 一系列小程序的集合 win-tools (bzip2、gzip、jpeg2ps 和 tiff2png) -%\item a subset of \cmdname{ImageMagick} 5.5.6 -%\item the \cmdname{ISpell} checker -%\item \cmdname{XEmacs} 21.5.14 with a selection of packages to support -%\TeX{} typesetting. -\end{itemize*} - -Perl 和 Ghostscript 是缺省已选定的安装套件，如果你已经装过了，也可以取消选择。 - -如果你不愿意安装这个套件，也可以自行安装需要的工具以完善你的 \TL{} 系统。下面列出了 -这些软件的来源： - -\begin{description} -\item[Ghostscript] \url{http://www.cs.wisc.edu/~ghost/} -\item[Perl] \url{http://www.activestate.com/} 不过你可能需要从 CPAN - (\url{http://www.cpan.org/}) 获得一些辅助性软件包。 -\item[ImageMagick] \url{http://www.imagemagick.com} -\item[NetPBM] 你还可以用 NetPBM 来替代 ImageMagick 的图形文件处理和转换功能。NetPBM - 的主页在 \url{http://netpbm.sourceforge.net/} -\item[针对 \TeX\ 的编辑器] 有很多选择，通常只是个人偏好问题。下面是一些选项： - \begin{itemize*} - \item \cmdname{GNU Emacs} 在 Windows 下有 native 的版本，参见 - \url{http://www.gnu.org/software/emacs/windows/ntemacs.html} - \item \cmdname{Emacs} 的 AucTeX 套件在 Windows 下有 native 的版本，参见 - \url{ftp://alpha.gnu.org/gnu/auctex} - \item \cmdname{WinShell} 可以在 \TL{} 的 \path|support| 目录下找到，参见 - \url{http://www.winshell.de} - \item \cmdname{WinEdt} 是 \url{http://www.winedt.com} 提供的一个共享软件 - \item \cmdname{Vim} 可以在 \url{http://www.vim.org} 得到。 - \item \cmdname{TeXnicCenter} 是一款自由软件，由 \url{http://www.toolscenter.org} - 提供，在 proTeXt 发行版中也能找到。 - \item \cmdname{LEd} 可以在 \url{http://www.ctan.org/support/LEd} 找到 - \item \cmdname{SciTE} 可以在 \url{http://www.scintilla.org/SciTE.html} 找到 - \end{itemize*} -\end{description} - -你也许想安装其它非自由\footnote{也就是说你不能根据自由软件准则自由修改或重新发布，但 -这并不意味着你不能免费获得它们。}的工具，但 \TL{} 中并没有包括它们，如 -\cmdname{GSView}，\cmdname{Ghostscript} 的伴侣，可以用它更方便地阅览 PS/PDF -文件。\cmdname{GSView} 可以从 \url{http://www.cs.wisc.edu/~ghost/gsview/} -或者任何一个 \acro{CTAN} 站点获得。 - -\section{维护 Windows 下的安装} - -如果你已经安装好了 \TL{}，就可以再次运行 \cmdname{tlpmgui} 来修改和维护你的 -安装了。 - -\subsection{添加/删除软件包} - -因为 \cmdname{tlpmgui} 的快捷方式位于 \guiseq{开始 \arw 程序 \arw TeXLive2006} -菜单内，从这个地方启动它。一个标题为 \guiseq{TeX Live installation and maintenance -utility} 的窗口将出现。它包括四个选项卡：\guiseq{Add Packages}、\guiseq{Remove -packages}、\guiseq{Manage installation}、\guiseq{Remove installation}。 - -点击标有 \guiseq{Add packages} 或 \guiseq{Remove packages} 的选项卡进入相应的 -功能: - -\begin{itemize} -\item 在第一个选项卡中单击 \guiseq{CD/DVD} 按钮选择正确的 \CD{} 驱动器 (或带有 -\texttt{texlive} 目录的 \DVD)。 -\item 在 \guiseq{Buttons} 部分，点击 \guiseq{Search} 按钮显示要安装或删除的软件 -包列表，或在 \guiseq{Select packages to\dots} 部分刷新它。 - -当安装软件包时，将比较已经安装的和 \CD/\DVD\ 上存在的软件包，列出未安装的那些。然后，根 -据你的喜好来选择需要安装的包。 - -当删除单个软件包时，只显示已安装的软件包的列表。 - -需要注意，对于 \guiseq{Add packages} 和 \guiseq{Remove packages}，首先列出 -的是软件集合。 - -\item 通过单击软件包的名称选择它。点击 \guiseq{Buttons} 部分的 \guiseq{Info} 按钮后，位于 -\guiseq{Info about the selected item} 部分的窗口中将显示选定包的简单描述。要选择多 -个软件包，可以在按下鼠标左键的同时按下一个 Ctrl 或 Shift 键，或者在拖动鼠标指针时按下左键。 - -\item 在 \guiseq{Buttons} 部分点击 \guiseq{Install} 或 \guiseq{Remove} 按钮以 -执行相应的操作。 -\end{itemize} - -\subsection{配置和其他管理任务} - -这个功能在 \guiseq{Manage the installation} 标签下提供，如果你希望在安装后添加对某个 -语言的支持，或者添加某个一开始安装时没有选择的格式文件，又或者是要重新生成某个修改过的格式， -它会很有用。 - -你可以执行下列操作： - -\begin{itemize} -\item 刷新 \filename{ls-R} 数据库 -\item 创建格式文件 (所有的或者缺失的) -\item 编辑 \filename{language.dat} -\item 编辑 \filename{fmtutil.cnf} -\item 编辑 \filename{updmap.cfg} -\end{itemize} - -注意：关闭 \guiseq{Edit\dots{}} 窗口后会提示你选择 \guiseq{Cancel} 还是 -\guiseq{Done}，如果选择后者，将重新生成格式文件 (如果你编辑的是 -\filename{updmap.cfg}，则重新生成字体的 map 文件)，然后刷新 \filename{ls-R} -数据库。 - -关于配置过程的更多信息请参见第~\ref{sec:persconf} 节 (\p.\pageref{sec:persconf})。 - -\subsection{卸载 \protect\TL{}} - -标着 \guiseq{Remove the TeX Live installation} 的选项卡打开的窗口，功能 -不值得描述。我们既不知道谁会需要，也不知道它为何存在 \dots :-) - -然而，如果你在 \path|texmf-local| 目录存放了自己添加的东西，删除程序将不会清除 -它，也不会删除该目录下的东西。存放 \cmdname{tlpmgui} 和相关文件的 -\path|setup-win32| 目录也不会被删除。你将不得不手动清除它们。 - -\subsection{将你自己的软件包添加到安装路径中} - -首先，无论你更改了什么，\textbf{别忘了重建 ls-R 数据库}。否则，你的新文件将不 -会被发现。你可以运行 \cmdname{tlpmgui}，从 \guiseq{Manage the installation} -标签下选择适当的操作，或者手动运行 \file{mktexlsr} 命令来重建该数据库文件。 - -如果你想添加 \TL{} 发行版没有提供的文件，推荐的存放位置是 \path|$TEXMFLOCAL| -目录。在升级 \TL{} 软件时，这种方式是安全的。 - -最初，\path|$TEXMFLOCAL| 指向的目录是空的。比如你希望增加 Maple 符号计算程序的 -支持文件，你应该将样式文件放在：\\ -\path|c:\TeXLive2006\texmf-local\tex\latex\maple\|\\ 而相应的文档文件放在：\\ -\path|c:\TeXLive2006\texmf-local\doc\latex\maple\| - -\subsection{在命令行环境下执行 \texttt{tlmp.exe}} -作为 \cmdname{tlpmgui} 引擎的 \cmdname{tlpm.exe} 程序有许多有用的选项，可 -以运行下述命令得到其列表： -\begin{verbatim} -tlpm --help -\end{verbatim} - -你可以在 \path|tlpm.readme| 中找到更多的说明和举例。 - -\subsection{网络安装} - -\KPS{} 支持 UNC 名称，所以你能够用它从网络上获取 TEXMF 目录树。但还有更好的办法： -除了 \path|bin/win32| 目录下的文件以外，所有的支持文件 -和配置文件都可以与 \teTeX{} 或 Unix 下的 \TL{} 共享。这意味着，你能够通过使用 -Samba 从一台 NT 服务器挂载到一台 Unix 工作站上或反过来。有数种可能的策略可供选择： -\begin{itemize} - -\item 将所有的东西放在服务器上。仅仅加入你想在 \path|bin| 目录下使用的 OS 或架构特有的文件， -例如 \path|bin/win32| 和 \path|bin/i386-linux|。随后配置你的主要变量。你可以使 -用 UNC 名称指向 Win32 下正确的目录。 - -\item 安装二进制和格式文件的本地复本。在这种情况下，将 \path|$TEXMFMAIN| -指向将被远程接入的主 \path|texmf| 目录树。将 \path|$TEXMFVAR| 指向一个本地 -目录，放置本地配置文件和实时生成的文件。 -\end{itemize} - -\subsection{Windows 版本与其它版本的区别} - -需要指出的是，Windows 版本的 \Webc{} 有一些和其他系统下不同的特性。 - -\begin{description} -\item[\cmdname{kpsecheck}] - 这一命令提供了一些不能很好地被包括到 \cmdname{kpsewhich} 中的选项。它允许你列出 - texmf 目录树中多次出现的文件。这是非常方便的，但有时你也会得到不想得到的结果 - (如大量的 \path|README| 文件)。需要注意的是，这些文件可能会导致 \KPS{} - 散列机制的内部冲突；幸运的是，\KPS{} 从不寻找这些文件。正因为这一原因，你可以将 - \path|-multiple-occurrences| 与两个其他包括或排除任何文件名的选项结合起来。 -文件名可以用一些模式进行匹配 (你可以指定数个模式)。 - - \cmdname{kpsecheck} 命令也将报告共享内存的状态：使用中或没有使用。了解这一情 -况可能是有用的，因为如果状态显示是 \samp{使用中}，意味着一个或多个进程正在工作，此时 -执行任何 \cmdname{mktexlsr} 命令都不会生效，直到正在运行的这些链接了 \KPS{} -的进程都退出为止。 - - 最后，这个命令还能报告它找到的 Ghostscript 的位置。在 Win32 - 下，对于许多其他的程序来说，通过 Ghostscript 的注册表项找到并使用 dll - 比改 \path|PATH| 更为简便，毕竟 \path|PATH| 长度是有限的。 -\item[\Webc{}] 与 Unix 下的 \Webc{} 相比，该引擎支持的选项要多一个： - \begin{itemize} - \item \path|-proctimes| 打印出有关作业运行时间的统计。需要说明的是 Win9x -不能被称为一个真正多任务操作系统，对于较短的时间段，它不能提供可靠的记时器，因此，打印 -出来的数值只是近似值。在 NT/2K/XP 下，作业运行过程中的用户时间和系统时间的结果相当精确。Unix -用户请注意：Windows 下的 \path|time| 命令和 Unix 下的含义完全不同。 - \end{itemize} -\end{description} - -\subsection{个人定制} -\label{sec:persconf} - -\subsubsection{Dvips} - -dvips 的配置文件在：\\ -\verb+C:\TeXLive2006\texmf-var\dvips\config\config.ps+\\ -你可以使用任何编译器将其打开并且更改某些参数： - -\begin{description} -\item [fonts] 如果 \cmdname{dvips} 需要生成 PK 字体，你可以更改默认打印机的 \MF{} - 模式或者分辨率。默认情况下，dvips 使用 Type~1 版本的 CM 字体，因此，它很少用到 - \cmdname{mktexpk}； -\item[printer] 可以告诉 dvips 默认情况下你想在什么地方打印。如果 \optname{o} -选项后没有紧接着打印机名的话，将会生成 \file{.ps}，即 \PS{} 文件。你可以以如下方式为 -dvips 设置打印机： -\begin{verbatim} -o lpt1: -% o | lpr -S server -P myprinter -% o \\server\myprinter -\end{verbatim} -\item[paper] 接下来，你可能希望改变纸张的大小，比如从欧洲规格 (A4) 改至美国规格 - (letter)，这得把该文件中首个指定的纸张大小设为 - letter。在配置文件里找到下面这段，把它移动到所有以 \code{@} 开头的行之前：\\ -\hspace*{1em} @ letterSize 8.5in 11in\\ -\hspace*{1em} @ letter 8.5in 11in\\ -\hspace*{1em} @+ \%\%BeginPaperSize: Letter\\ -\hspace*{1em} @+ letter\\ -\hspace*{1em} @+ \%\%EndPaperSize -\end{description} - -当前的 \TL{} 发行版已经通过程序为 Dvips 和 Pdftex 提供了正确更新的字体映射文件。这是用 -\cmdname{updmap} 程序在安装后完成的。如果你用安装程序或者手动添加了新的字体 -包，就应该自行修改 \path|$TEXMFVAR/web2c| 目录下的 \verb+updmap.cfg+ 文件。 - -\subsubsection{PdfTeX} - -如果你用 pdf{}latex 程序来直接输出 \acro{PDF} 文件，同时也想使用 \acro{US} -letter 尺寸的纸张，就该编辑 -\verb+C:\TeXLive2006\texmf-var\tex\generic\config\pdftexconfig.tex+，把 -\samp{\bs pdfpagewidth} 和 \samp{\bs pdfpageheight} 的定义作如下改变： - -\begin{alltt} -\bs{}pdfpagewidth=8.5 true in -\bs{}pdfpageheight=11 true in -\end{alltt} -保存文件，然后退出编辑器。 - -\subsubsection{XeTeX} - -Xe\TeX{} 的 Windows 版本是与 fontconfig 2.4.2 静态链接的。fontconfig 的 -配置文件之一是 \verb+fonts.conf+。请参见 \verb+fonts.conf+ 文件本身以了解 -其细节，这个文件在命令 \cmdname{kpsewhich -{}-var-value=FONTCONFIG\_PATH} -输出的目录下。 - -\subsubsection{GSView} -GSView 现在在 Aladdin 许可证下发布，因此 \TL{} 不再包括此程序。 - -如果你想把纸张大小改为 letter，从 \guiseq{开始 \arw 程序}% 原文为 \guiseq{开始} -打开 GSView，选择 \guiseq{Media\arw Letter}即可。 - -另外还可以修改菜单设置来改进屏幕图像的可读 (readable) 性。在 -\guiseq{Media \arw Display Settings} 下，将 \optname{Text Alpha} 和 -\optname{Graphics Alpha} 设为 4~bits。 - -注意，安装程序已经将所有的 \code{.ps} 和 \code{.eps} 文件自动关联到 -\cmdname{GSView} 程序。 - -至于打印的步骤，参见下面的第~\ref{printing} 节。 - - -\subsection{测试} - -对于一般性的测试程序，请参见第~\ref{sec:test-install} 节 -(\p.\pageref{sec:test-install})。这里介绍的只是针对 Windows 的测试。 - -在你的编辑器 (Xemacs, WinShell) 中打开 -\path|C:\TeXLive2006\texmf-dist\tex\latex\base| 下的 -\verb+sample2e.tex+ 文件。屏幕上应该会出现一个 \LaTeX\ 源文件。点击 -\guiseq{Command\arw LaTeX} 菜单 (XEmacs) 或工具栏上的 \LaTeX\ 图标 (WinShell) -可以对其进行编译, 然后点击 \guiseq{Command\arw View DVI} 菜单 (XEmacs) 或 -Preview (dviout) 图标 (WinShell) 预览生成的 .dvi。 - -在第一次用 \cmdname{dviout} 预览的时候将生成一些字体，因为用于屏幕预览的字体没有安装。 -一会儿之后就已经生成好了大多数你用到的字体。此后你就很少再看到生成字体的窗口了。 - -\textbf{对日后的提示：}如果运行的 \LaTeX\ 因为找不到某一文件而停止了，你可以按 Ctrl-z -退出。 - -\subsection{打印} -\label{printing} - -可以用 \cmdname{dviout} 来直接打印，此时打印工作交给 Windows 统一打印驱动完成，理论上它和 -所有的打印机都兼容。然而，这也存在一些缺点，比如它会生成巨大的假脱机 (spool) 文件， -或者某些较早版本的 Windows 对统一驱动的支持不太好。它的优点是你能用到嵌入 BMP 或 WMF -图像的特性。你也必须正确设置打印机参数，否则，打印出来的效果是缩放后的 (在 300\dpi{} -打印机上以 600\dpi{} 打印会使得一页纸上仅显示四分之一的页面)。 - -如果你使用 \cmdname{dvips} 生成 \filename{.ps} 文件，然后用 \cmdname{GSView} -打印的话，打印过程将会快很多且更加可靠。在 \cmdname{GSview} 中，选择 -\guiseq{File\arw Print\ldots}，将出现 \guiseq{Print} 窗口。 - -如果用的是 \PS{} 打印机，\textit{一定要选择 \guiseq{\PS{} -Printer}}。这一过程可以在 \guiseq{Print} 窗口左侧底部的 \guiseq{Print Method} -框中完成。然后就能选择任何一台你已事先安装好的打印机。如果没有选中 \optname{\PS{} Printer} -复选框，是没法打印的。 - -如果你使用你自己的非-\PS{} 打印机，则要在 \guiseq{Print Method} 框中选择 -\guiseq{Ghostscript device}，然后，点击标有 \guiseq{djet500} 的按钮，从 -弹出的窗口中选择你的打印机型号。(在更旧版本的 \cmdname{GSView} 中，确定 -\optname{\PS{} Printer} \textit{没有}被选择，然后从 \guiseq{Device} -列表中选择打印机型号。) - -\subsection{Win32 下的使用技巧与窍门} - -\subsubsection{Win32 的不同种类} - -我们所谓的 Win32 其实并非指这个操作系统本身，而是指一系列函数的集合 (微软的 \acro{SDK} -头文件里包括了约 12,000 个这样的函数)，你可以使用这些函数为 Windows 家族中的不同操作系 -统编写程序。 - -Windows 有多个版本： -\begin{itemize} -\item Win95、Win98 以及 Win\acro{ME}，它们\emph{不是真正的多任务、多线程}环境，只是 - \acro{DOS} 的更新变体。这可以由它们在启动时，PC 装载 - \path|command.com| 解释器得到证明。如果你在这里停止启动过程，你可以查询当前 (\acro{DOS}) - 的版本，它将会回答你类似 \samp{MS-DOS 7.0} 之类的答案 (至少在旧版本的 Win9x 上是这样的)。 -\item Windows \acro{NT}，是一套重新编写的操作系统，支持真正的多任务，并包括许多高级的特征。 -\item Windows 2000 基于 \acro{NT}，但具有 Win98 所有的引入注意的修饰 (bells and whistles)。 -\item Windows \acro{XP} 有两个不同的版本：个人版与专业版。这是融合两条不同路径上的产品 (基于 -Win9x 和基于 \acro{NT}) 的最后一步。\acro{XP} 基于 \acro{NT}。 -\end{itemize} - -Win9x 支持并行支持 32 位程序和 16 位程序。但操作系统本身并非完全工作在 32 位模式下， -也不支持内存保护：16 位程序甚至可以覆盖操作系统本身占用的内存！系统的某些部分，如 -\acro{GDI} (图形设备接口) 只能管理当前运行的所有程序中的有限的资源，如位图、字体、画笔等。 -由于位图头结构 (bitmap header) 这样的资源不允许超过 64KB，这样你能明白为什么大量使用 -图形对象时系统会非常吃力了。 - -NT、2K 和 XP 不受这些限制，也不受 Win9x 中其他条件的限制。它们是真正的多任务环境，并且 -具有内存保护机制。与 Win9x 相比，它们响应更快，因为具有更好的内存管理、更好的文件系统等等。 - -\subsubsection{命令行提示符} - -你可能觉得奇怪，``我已经有 Windows 了，为什么还需要命令行提示符呢？'' - -这是个很好的问题，而原因也具有通用的性质：并非所有操作都只用 \acro{GUI} 就能解决。命令行 -给予了你编程的能力\Dash 在命令行解释器足够聪明的情况下。 - -但这个问题可能更加基础：\TeX{} 是一个 \emph{批处理} 工具，而不是一个交互工具。\TeX{} -需要计算每一页的最佳布局，解决交叉引用等。这只能通过全局处理整个文档而达到。它不是一个可 -以通过交互操作而完成的任务。 - -这就是说，你应该以命令行方式来使用 \TeX{}。实际上，这不算是很坏的选择。优势之一是可以 -为复杂的处理写出命令行工具：更容易调试，因为它们与任何 \acro{GUI} 问题都不相关；而且 -\acro{GUI} 工具也可以用来作为命令行工具的界面。这就是为什么你大多时间内会通过 \acro{GUI} -文本编辑器与 \TeX{} 打交道的道理。 - -然而，在很多时假，你可能需要使用命令行提示符。其中的一种情形是你遇到困难，并且希望调试你的 -配置。 - -\begin{description} - \item[Win9x] 你可以通过从\guiseq{开始 \arw 程序} 菜单中选择 \acro{MS-DOS} - 图标或在 \guiseq{开始 \arw 运行} 菜单中输入 \path|command.com| 来打开命令行提示符。 - \item[NT, 2K, XP] 你可以在 \guiseq{开始 \arw 附件} 菜单中选择 \guiseq{命令提示符} - 来打开命令行提示符。也可以选择 \guiseq{开始 \arw 运行}，然后输入 \path|cmd.exe|。这是 - \acro{NT} 下全新的命令解释器 (因此，别把它叫做 \emph{DOS} 窗口！)。 -\end{description} - -这里所提到的位置可能因 Windows 版本的不同而发生变化。 - -\subsubsection{路径分隔符} - -尽管 Win32 API 可以正确解释作为路径分隔符的 \path|/| 和 \path|\|，但命令解释器却不 -行！因此，只要在编程用到路径名称时，你可以任意使用这两个分隔符之一，甚至在同一个路径中混 -用。但在命令行中就必须用 \path|\| 作为路径分隔符。原因是显而易见的，命令处理器使用 -\samp{/} 引入命令的参数。 - -最后，当看到采用 Unix 习惯写成的路径名不必惊讶。Windows-\TL{} 是 \Webc{} 的一个移植，其目 -标是跨平台兼容。正因为这个原因，所有的需要指定路径名称的配置文件都采用了 Unix 习惯。 - -\subsubsection{文件系统} -\label{sec:clusters} - -与 \TeX{} 有关最差的 Win9x 的特征是所谓的 FAT 文件系统。\TeX{} 使用了非常多的小文件， -大小在 1--3kB 之间。\acro{FAT} 文件系统相对较老，早于目前我们使用的大容量硬盘十数年。 -因此，它不能有效地管理 \TL{} 下数以万计的 \TeX{} 文件。\acro{FAT} -文件系统在一个巨大的分区中为\emph{任何}一个文件分配至少 32kB 的空间。这表示，\TeX{} -将占用比它实际需要多得多的磁盘空间。 - -其他的、更加现代的文件系统，如 \acro{FAT32} 和 \acro{NTFS} 不存在这些缺陷，它们仅管理 -4kB 的簇。(你在 \acro{NTFS} 系统上还能将这个限制降到 512 字节。) - -\subsubsection{如何将某些路径添加到你的 PATH 中} - -在操作系统中存在一些变量和值，它们的行为与你的程序中的全局变量比较类似。这些变量称为 -环境。任何程序在运行时需要环境的复本进行初始化。它可以请求或改变变量的值。这些改变只 -发生于复本的环境中，因此不会传递给其它正在运行的程序。 - -PATH 是一类特殊的环境变量，用于对你希望运行程序的搜索。Win9x、WinME 和 NT/2K/XP -下修改 PATH 的方法不尽相同。 - -\begin{description} -\item[Windows 95/98] 编辑 \path|autoexec.bat|。在这个文件中，必然有一行以 -\texttt{PATH=} 开头，随后是一系列以 \path|;| -分隔的目录。请把含有可执行文件的目录加到这一行。然后，这一行看上去象这样： -\begin{verbatim} -PATH=c:\windows;c:\windows\system;c:\TeXLive2006\bin\win32 -\end{verbatim} - -\item[Windows ME] 你需要运行一个特殊的命令 \path|c:\windows\system\msconfig.exe| -来改变任何环境变量。在这个程序中，选择 `环境' 选项卡，然后增加或修改你希望的变量。你需要 -重启机器使任何更改的生效。 - -\item[Windows NT/2K/XP] -点击 \guiseq{开始 \arw 设置 \arw 控制面板}。现在，带有控制面板图标的窗口被打开。双击 -系统图标。系统属性窗口被打开。点击 \textsf{高级} 选项卡或者从对话框中寻找标有 -\guiseq{环境变量} 的按钮。现在你可以更改你的用户帐户的环境变量了。注意：那里同时还会显示 -系统的环境设置。通常，你不能更改系统变量，除非你有机器的管理户权限。如果你希望为所有用户更改 -\texttt{PATH}，你必须通知系统管理员，或者你自己必须是系统管理员 \Dash 在后一种情况下， -你得明确自己的操作没有错误。 - -如果那里已经有了你的帐户的 \texttt{PATH} 设置，双击 -\texttt{PATH}，在\textsf{变量名}区域将出现 \texttt{PATH}，而区域的值显示的是以 -\path|;| 分隔的一系列目录表现出的当前设定。将含有可执行文件的目录加进去 -(如 \path|c:\TeXLive2006\bin\win32|)。如果你的用户帐户下不存在这个变量，双击变 -量区域，输入 \texttt{PATH}，在\textsf{变量值}区域输入可执行文件所在的目录。注意： -点击\textsf{确定}之前先点击\textsf{应用}按钮，否则对\texttt{PATH}的更改不会应用到 -你的系统中。在更改环境设置时一定要谨慎。 -\end{description} - -确定一个变量 VARIABLE 是否被正确设置的最好方法是打开终端，然后输入： -\begin{verbatim} -set VARIABLE -\end{verbatim} -它应该会返回相应的值。 - -\subsubsection{\TeX{} 引擎} - -如果你已经看过 \Webc{} 的文档，你会发现所有基于 \TeX{} 的不同程序都使用同样的基础 -引擎。例如，\path|tex.exe| 和 \path|latex.exe| 是相同程序的复本，但每个程序根 -据调用名称不同使用了不同的格式文件。 - -在 Unix 下，这种特性是通过 \emph{符号链接} 实现的。 它可以节省一些磁盘空间，因为一 -些引擎使了很多不同的格式文件。 - -但是，Win32 API 不了解文件链接，因此，为了节省几乎相同的内存，所有的 \TeX{} 基础引擎均被放在 -DLL (\emph{动态链接库}) 中。这表示，你将看到类似下面的输出： - -\begin{alltt} -2006-11-23 07:06 2 560 latex.exe -2007-01-06 23:54 1 073 664 pdftex.dll -2006-01-28 08:05 2 560 pdftex.exe -\end{alltt} -这里，\path|latex.exe| 仅仅是 \path|pdftex.exe| 的一个复本，使用了 -相同的核心文件 \path|pdftex.dll|。相同的技巧应用于 \path|mktex*.exe| -家族的程序，它们都链接到 \path|mktex.dll|。 - -实际上，一个通用的工具，\path|irun.exe| 可以用来为 Win32 下可执行文件生成与 -Unix 下硬链接对等的文件。 - -\subsection{如果遇到问题} -\label{sec:troubleshooting} - -\subsubsection{如果 \texttt{latex} 没有找到你的文件，该怎么办？} - -\begin{itemize} - -\item \cmdname{kpsewhich} -可以用来调试任何问题。然而 \cmdname{kpsewhich} 向标准错误 (stderr) -输出调试信息，而且旧版的 Windows 终端无法将重定向标准错误信息至某一文件。 -(NT 和 Windows 2000 的终端知道如何做。但这一技巧可以应用到任何终端。) -为了诊断，你可以 (在 \acro{DOS}/\acro{cmd} 对话框下) 临时设定一个环境变量： - -\begin{verbatim} -SET KPATHSEA_DEBUG_OUTPUT=err.log -\end{verbatim} -也可以设定调试的级别： -\begin{verbatim} -SET KPATHSEA_DEBUG=-1 -\end{verbatim} - -如果你希望把 stderr 重定向到 stdout： -\begin{verbatim} -SET KPATHSEA_DEBUG_OUTPUT=con: -\end{verbatim} -通过这种方式，你可以在同一个文件中同时截获标准错误与标准输出。 - -\item 假定系统被安装在 \path|c:/TeX|，检查下面的一些值：\\ - {\small - \begin{tabular}{ll} - \path|kpsewhich -expand-path $SELFAUTOPARENT| & \path|c:/TeX| \\ - \path|kpsewhich -expand-path $TEXMF| & \path|c:/TeX/texmf....| \\ - \path|kpsewhich -expand-path $TEXMFCNF| & - \path|.;c:/TeX/texmf-var/web2c;| \\ - \path|kpsewhich -expand-var $TEXINPUTS| & \path|.;c:/TeX/texmf/tex//| - \end{tabular} -} -\item 如果其它 \TeX{} 相关的值已经存在于你的环境变量设置中，请删除它们。它们覆盖了 -texmf.cnf 中相应的变量。 -\item 检查从下面输出的值：\\ -{\small - \begin{tabular}{ll} - \texttt{kpsewhich cmr10.tfm} & \path|c:/TeX/texmf-dist/fonts/tfm/public/cm/cmr10.tfm|\\ - \texttt{kpsewhich latex.fmt}& \path|c:/TeX/texmf-var/web2c/latex.fmt| - \end{tabular} -} -\item 到此为止，如果所有的输出都是正确的，\TeX{} 及其相关程序都应该可以正常工作了。否则 -你只好以 \path|-debug=n| 选项调用 \path|kpsewhich|，检查所有前面提到的值。试 -着分辩并报告问题。 - -\end{itemize} - -\subsubsection{如果你的安装还是不能如预期般工作，该怎么办？} - -这需要调查以下几个问题： - -\begin{enumerate} -\item \file{tex.exe} 是否在我的 \path|PATH| 中？ - -\item \path|TEXMFCNF| 是否正确指向了 \path|c:/TeXLive2006/texmf-var/web2c| (默认值)？ - -\item 由 \file{tlpmgui.exe} 生成的记录文件中是否提示错误信息？ -\file{tlpmgui.log} 可以在你的 \file{TEMP} 目录下找到。你可以通过搜索 \samp{Error} 字符串 -定位错误信息。提示：记录文件可能会在生成所有格式文件后显示一些错误。不必惊慌：也许一些格式文件没有被 -安装。 - -\item 在 \url{http://tug.org/texlive/} 是否有相关的错误已被修正？(可能性不大， -但不妨去查查) - -\end{enumerate} - -\TL{} 软件包括了数百个程序以及数以万计的文件，所有的这些都有不同的来源。因此，对出现的问题 -预测所有可能的原因是相当困难的。不过我们还是会尽力帮助你的。(参见第~\ref{sec:help} -节，\p.\pageref{sec:help}。) - \section{网络安装} \label{sec:netinstall} -\TL{} 的设计可以使它在不同的用户间共享, 甚至可以在网络上不同的系统间共享. -由于使用了标准的目录结构, \TL{} 不需要在目录录径配置上大费周折: -\TL{} 程序所需要的文件的位置和这些相应的程序是相关的. -你可以在 \filename{$TEXMFMAIN/web2c/texmf.cnf} 中找到相关的配置. -它包含了类似下面的内容: +\TL{} 的设计可以使它在不同的用户间共享，甚至可以在网络上不同的系统间共 +享。在标准的目录结构下，不需要配置固定的绝对路径：\TL{} 程序所需要的文 +件都能通过都在这些程序自身的相对路径找到。你可以在 +\filename{$TEXMFMAIN/web2c/texmf.cnf} 配置文件中看到实际的处理， +它包含了类似下面的内容： \begin{verbatim} TEXMFMAIN = $SELFAUTOPARENT/texmf ... TEXMFLOCAL = $SELFAUTOPARENT/../texmf-local \end{verbatim} -这就意味着, 其它的系统或用户很少需要根据他们的系统在他们的路径中添加 \TL{} 的可执行文件的位置. +这就意味着，其它的系统或用户只需要把 \TL{} 的可执行文件的位置添加到其 +系统的搜索路径中即可。 -你也可以把 \TL{} 安装在你的本地, 然后把整个安装目录移动到网络上. +同理，你也可以先把 \TL{} 安装在本地，然后再把整个安装目录转移到网络上。 -当然, Windows 用户会有不同的需求. -\dirname{texmf-doc/source/texlive/texlive-common/w32client} -包含了一个样板脚本 \filename{install-w32client}, -它可以产生配置文件和菜单快捷方式, 来让你使用一个网络上已有的安装版本. -它可以通过在相同目录的 \filename{install-w32client.bat} 来调用. +当然，Windows 用户会有不同的期望。 +\dirname{texmf-doc/source/texlive/texlive-common/w32client} 目录 +包含了一个样例脚本 \filename{install-w32client}， +它可以为局域网上的 \TL{} 安装产生配置文件和菜单快捷方式。 +它可以通过在相同目录的 \filename{install-w32client.bat} 调用。 -你可以在第~\ref{sec:kpathsea}~节中了解更多有关 \TL{} 配置和路径搜索的内容. +你可以在第~\ref{sec:kpathsea}~节中了解更多有关 \TL{} 配置和 +路径搜索的内容。 -\section{运行在 DVD 或 USB 的完整版 \protect\TL{} } +\section{在 DVD 或 USB 上最具可移植性地运行 \protect\TL{}} \label{sec:portable-unix} -在第 ``\ref{sec:fromdvd}'' 中介绍的 ``从 \DVD{} 运行'' 选项可以使发行版在你的系统上运行得很好, -但是如果你在别人的机器上用非管理员帐号工作, -那你就可能希望使用对系统本身的影响最小的运行方式. - -在 \TL{} \DVD 的根目录, 或者 \TK{} \DVD 的 \dirname{texlive} 子目录, -有一个为 Unix 系统提供的脚本 \filename{tl-portable} 和一个为 Windows 系统提供的批处理文件 \filename{tl-portable.bat}. -它们会新开一个已设好环境变量的终端或命令提示符, 在这里你就能在 \DVD 上运行 \TL{}. +在第 \ref{sec:fromdvd} 节中介绍的``从 \DVD{} 运行''选项可以使发行版在 +你的系统上很好地运行，但是如果你在别人的机器上用非管理员帐号工作， +那你就可能希望使用对系统本身的影响最小的运行方式。 -当它第一次执行时, 它会花一些时间在目录 \dirname{~/.tlportable2008} 下产生一些文件. -但从此以后, 它可以在很短的时间内启动. +在 \TL{} \DVD 的根目录，或者 \TK{} \DVD 的 \dirname{texlive} 子目录中， +有一个为 Unix 系统提供的脚本 \filename{tl-portable} 和一个为 Windows +系统提供的批处理文件 \filename{tl-portable.bat}。它们能开启一个设置好 +环境变量的终端或命令提示符，在其中就能直接运行 \DVD 上的 \TL{}。 -而此时系统的其它程序会并不知道 \TL{} 的存在. -如果你需要让你的文本编辑器使用这个 \TL, -你需要再打开一个这样的 \filename{tl-portable} 会话来使用该编辑器. +头一次执行时它会花点时间在 \dirname{~/.tlportable2008} 目录下生成一些 +文件，此后就可以在很短的时间内启动了。 -你也可以使用 \filename{tl-portable} 在一个 \arco{USB} 闪存上执行 \TL. -在这种情况下, 请 (至少) 把所有的顶层目录下的所有文件和 \dirname{bin}, \dir{texmf}, \dirname{texmf-dist} 和 \dirname{tlpkg} 下的所有内容复制到闪存上. 这会花一定的时间. -如果你把它复制到一个 \acro{FAT}32 分区的 \acro{USB} 分区上, -请保证把所有的文件连接非关联化 (\code{cp -L}). -运行时都会查找并使用闪存上的 \dirname{texmf-local} 目录. +而此时系统的其它程序并不知道 \TL{} 的存在，如果你需要让你的文本编辑器 +使用这个 \TL，可以再打开一个这样的 \filename{tl-portable} 会话来使用 +该编辑器。 -然后你可以在闪存的根目录下像上面那样执行 \filename{tl-portable}. -在这个情况下, 脚本会判断这个闪存是可写的, 并把产生的文件写在这里. -为了方便起见 (比如你想把它给别人), 你也可以把闪存上的最终内容烧回到 \DVD{} 上. +你还能通过 \filename{tl-portable} 在 \acro{USB} 驱动器上运行 \TL。 +在这种情况下，请 (至少) 把所有的顶层目录下的所有文件和 \dirname{bin}, +\dirname{texmf}, \dirname{texmf-dist} 和 \dirname{tlpkg} 下的所有内容 +复制到 USB 驱动器上。这会花一定的时间。如果你把它复制到一个 \acro{FAT}32 +格式的 \acro{USB} 驱动上，请保证复制操作是跟踪 (dereference) 所有的 +符号链接到实际数据文件的 (\code{cp -L})。运行时都会查找并使用驱动器上 +的 \dirname{texmf-local} 目录。 +然后你就可以在驱动器的根目录下像上面那样运行 \filename{tl-portable} +了。此时脚本能判断除这个驱动是可写的，并把产生的文件写到这里。 +为了方便起见 (比如你想把它提供给别人)，你也可以把驱动器上的最终内容 +刻录回到 \DVD{} 上。 -\section{\cmdname{tlmgr}: 维护你的安装} +\section{\cmdname{tlmgr}: 管理你的安装} \label{sec:tlmgr} \begin{figure}[tb] \tlpng{tlmgr-gui}{\linewidth} -图形模式运行的 \caption{\prog{tlmgr} 程序. -安装包/集合/方案仅在按下 `Load' 按扭以后显示.}\label{fig:tlmgr-gui} +图形界面模式运行的 \caption{\prog{tlmgr} 程序。 +安装包/集合/方案仅在按下 `Load' 按钮后显示。}\label{fig:tlmgr-gui} \end{figure} \begin{figure}[tb] \tlpng{tlmgr-config}{\linewidth} -\caption{图形模式的 \texttt{tlmgr}: 配置选项卡}\label{fig:tlmgr-config} +\caption{图形界面模式的 \texttt{tlmgr}: Configuration 选项卡}\label{fig:tlmgr-config} \end{figure} -安装程序会安装一个用来在安装后进行管理的程序 \prog{tlmgr}. +安装程序会安装一个用来在安装后进行管理的程序 \prog{tlmgr}。 一些程序, 比如 \prog{updmap}, \prog{fmtutil} 和 \prog{texconfig} 仍然包含在发行版中, 而且在将来也不会剔除, 但是 \prog{tlmgr} 是一个优选的接口. 它的功能包括: @@ -1862,7 +1292,7 @@ Installed: Yes > \Ucom{tlmgr -help} \end{alltt} -\section{有关 Windows 平台的注解} +\section{有关 Windows 平台的说明} \label{sec:windows} \TL{} 拥有可运行于 Windows 和 Unix 平台的单一安装程序。当然，只有在放弃对较老版本 Windows 的支持的情况下，这才成为可能。因此，现在 \TL{} 只能安装于 Windows 2000 或更新的版本。 @@ -2061,7 +1491,7 @@ Windows 将几乎所有的配置数据存贮于它的注册表中。注册表是 \fi \subsubsection{路径的来源} -\label{ec:path-sources} +\label{sec:path-sources} 搜索路径可能来自许多地方，\KPS{} 是按照下面的顺序查找的： @@ -2077,7 +1507,7 @@ Windows 将几乎所有的配置数据存贮于它的注册表中。注册表是 \samp{TEXINPUTS=/c:/d} 这样的一行 (参见下面的解释)。 \item 编译时的缺省值。 \end{enumerate} -\noindent 你可以通过调试选项看到所有的这些值 (参见第 \pageref{Debugging} 页的 +\noindent 你可以通过调试选项看到所有的这些值 (参见第 \pageref{sec:debugging} 页的 ``调试操作'')。 \subsubsection{配置文件} @@ -2497,7 +1927,7 @@ utmro8r NimbusRomNo9L-Regu ... <utmr8a.pfb \end{alltt} 于是 \cmdname{dvips} 接下来寻找这些文件，再加上固定载入的，通用映射文件 \file{psfonts.map} (这个文件里包含常用 \PS{} 字体的映射，参见第 -\ref{sec-examples-of-use} 节的最后一部分，讨论了 \PS{} 映射文件的处理)。 +\ref{sec:examples-of-use} 节的最后一部分，讨论了 \PS{} 映射文件的处理)。 这时候 \cmdname{dvips} 向用户表示它的存在： \begin{alltt} @@ -3092,7 +2522,8 @@ Lua 脚本都能在 Windows 下使用，通过 \TL 内部包含的 Perl。 随着 \cmdname{tlmgr} 到来，禁用了 \cmdname{texconfig} 中编辑格式和 断字配置文件的功能。 -今年还提供了大多数平台的 \cmdname{xindy} 索引程序 (\url{http://xindy.sourceforge.net}) 。 +今年还提供了大多数平台的 \cmdname{xindy} 索引生成程序 +(\url{http://xindy.sourceforge.net})。 \cmdname{kpsewhich} 现在可以报告给定文件的所有匹配 (\optname{--all} 参数) 并限制列出特定目录下的匹配 (\optname{--subdir} 参数)。 @@ -3102,7 +2533,7 @@ bounding box 信息，这是 \cmdname{dvipdfm} 包含但未曾出现在 \cmdname{dvipdfmx} 中的最后一个功能。 去除了 \filename{Times-Roman}, \filename{Helvetica} 等字体别名。不同的 -宏包的行为应该是不一样的 (也应该有不同的编码)，所以没有什么好的办法能解 +宏包对它们的理解不同 (尤其是编码的处理不一样)，所以没有什么好的办法能解 决。 去除了 \pkgname{platex} 格式文件，以避免与日文 \pkgname{platex} 的命名 |