diff options
author | Norbert Preining <preining@logic.at> | 2021-04-08 21:13:38 +0000 |
---|---|---|
committer | Norbert Preining <preining@logic.at> | 2021-04-08 21:13:38 +0000 |
commit | ef47f55736fd1defd37f3b0554392947bd6f4ce2 (patch) | |
tree | 80285f1179bfdda4d7bc03481f0df4862a3d2a02 /Master/texmf-dist/doc | |
parent | b36dd36a21fe99cc457e98f41d393d9c6155a092 (diff) |
install-latex-guide-zh-cn (9apr21)
git-svn-id: svn://tug.org/texlive/trunk@58796 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
8 files changed, 241 insertions, 187 deletions
diff --git a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/mirror.tex b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/mirror.tex index c9f3a46be1c..6271c40112d 100644 --- a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/mirror.tex +++ b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/mirror.tex @@ -29,6 +29,8 @@ & \url{https://mirrors.bfsu.edu.cn/CTAN/systems/texlive/}\\ \href{https://mirrors.cqu.edu.cn/}{重庆大学} & \url{https://mirrors.cqu.edu.cn/CTAN/systems/texlive/}\\ + \href{https://mirrors.dgut.edu.cn/}{东莞理工学院} + & \url{https://mirrors.dgut.edu.cn/CTAN/systems/texlive/}\\ \href{https://mirrors.hit.edu.cn/}{哈尔滨工业大学} & \url{https://mirrors.hit.edu.cn/CTAN/systems/texlive/}\\ \href{https://mirrors.huaweicloud.com/}{华为云} @@ -60,7 +62,7 @@ 使用最近的 CTAN 源下载 iso 文件, 实际上是下载 \begin{lstlisting} - https://mirrors.ctan.org/systems/texlive/Images/texlive2020.iso + https://mirrors.ctan.org/systems/texlive/Images/texlive2021.iso \end{lstlisting} 使用大陆的源下载它, 只需将以上网址中的 @@ -70,14 +72,14 @@ 替换为相应的源的地址, 而将 \begin{lstlisting} - Images/texlive2020.iso + Images/texlive2021.iso \end{lstlisting} 予以保留. 以清华大学为例, 从清华大学源中下载 iso 镜像文件, 实际上是下载 \begin{lstlisting} - https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/texlive2020.iso + https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/texlive2021.iso \end{lstlisting} 同理, diff --git a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/updateinfo.tex b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/updateinfo.tex index cec8669919b..d02ccb90fe8 100644 --- a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/updateinfo.tex +++ b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/updateinfo.tex @@ -2,6 +2,15 @@ \chapter{版本信息} +\section*{v2021.4.7} + +\begin{enumerate} + \item 更新安装 \TeX{} Live 2021 内容 + \item 添加东莞理工学院源 + \item 补充 \TeX studio 下载方法 + \item 补充 WSL 中使用 \texttt{texdoc} 的方法 +\end{enumerate} + \section*{v2021.2.1} \begin{enumerate} diff --git a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/editor.tex b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/editor.tex index 33fd5152308..58af383192e 100644 --- a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/editor.tex +++ b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/editor.tex @@ -8,11 +8,7 @@ 因此很多用户都将其他编辑器作为自己的首选. 这里向大家介绍随 \TeX{} Live 一同发行的轻量级编辑器 \TeX works 和功能更加丰富的 -\href{http://texstudio.sourceforge.net/}{\TeX studio} -(github 上有% -\href{https://github.com/texstudio-org/texstudio}{源码}% -和% -\href{https://github.com/texstudio-org/texstudio/releases}{可执行文件}). +\TeX studio. 其他编辑器无法一一介绍, 还请自己在网上寻求更多帮助. \subsection{\TeX works} @@ -123,16 +119,30 @@ Windows 10 中字体列表见% 相较于 \TeX works, \TeX studio 功能更丰富, 用法更多. 在使用 \TeX studio 前, -用户一定要查询 \texttt{system32} 是否在\textbf{环境变量}中. +用户一定要查询\textbf{环境变量}中是否有 \texttt{system32}. 具体方法在前面已有说明, 此处不再赘述. 以下有关 \TeX studio 的用法介绍, 还请用户提前在 \menu{Options > configure TeXstudio} 中勾选 \menu{Show Advanced Options}. -由于网络原因, -\TeX studio 下载有些困难. -大家可以借助于 -\url{https://d.serctl.com} -加速下载, + +\subsubsection{下载方法} + +\TeX studio 有自己的% +\href{http://texstudio.sourceforge.net/}{官方网站}, +但因网络原因, +打开不便. +网站上提供的下载链接跳转到了 github 上, +有兴趣的朋友可以直接到 github 上查看% +\href{https://github.com/texstudio-org/texstudio}{源码}% +和% +\href{https://github.com/texstudio-org/texstudio/releases}{可执行文件}; +而清华大学也提供了相应的% +\href{https://mirrors.tuna.tsinghua.edu.cn/github-release/texstudio-org/texstudio/LatestRelease/}{镜像}, +便于用户下载. +此外, +有% +\href{https://d.serctl.com}{第三方网站}% +可以辅助用户下载 github 上的发行文件, 网站提供了下载教程, 这里不再展开. diff --git a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/overleaf.tex b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/overleaf.tex index 587e3e8a4a6..f29e56d7f43 100644 --- a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/overleaf.tex +++ b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/overleaf.tex @@ -69,17 +69,13 @@ Overleaf 提供了多种渠道为用户新建项目: 它们分别是 \menu{Copy}、\menu{Download}、\menu{Archive} 和 \menu{Trash}. 用户可根据自己的需求点击合适的图标. -\section{升级项目} +\section{选择不同发行版版本} -Overleaf 将后台 \TeX{} Live 升级为 2019 版本后, -用户新建项目默认使用 \TeX{} Live 2019, +Overleaf 将后台 \TeX{} Live 升级后, +用户新建项目默认使用 \TeX{} Live 2020, 而老项目还是使用 \TeX{} Live 的老版本. -如果用户打算使用 \TeX{} Live 2019, -只需将项目复制一个新的副本, -即点击 \menu{Copy}. -这样创建的副本便可以使用 \TeX{} Live 2019. -如果用户是从 Github 上面导入的项目, -建议再次导入. +如果用户打算使用 \TeX{} Live 2020, +只需在 \menu{Menu > Settings > TeX Live version} 选择版本即可. \section{学习与帮助} diff --git a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/ubuntu.tex b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/ubuntu.tex index 2da256d6c8e..6ff99d8f5ae 100644 --- a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/ubuntu.tex +++ b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/ubuntu.tex @@ -5,39 +5,39 @@ \section{安装 \TeX{} Live} 这里只阐述如何用镜像安装. -为使用户顺利使用 \TeX{} Live 2020, +为使用户顺利使用 \TeX{} Live 2021, 建议用户首先卸载从源内安装的 \TeX{} Live 的相关包, 具体方法见 \ref{sec:ubuntu:uninstall}~节. 下载 -\href{https://mirrors.ctan.org/systems/texlive/Images/texlive2020.iso}{iso 镜像文件} +\href{https://mirrors.ctan.org/systems/texlive/Images/texlive2021.iso}{iso 镜像文件} 的方法见 \ref{sec:windows:install}~节. 下载完毕后, 打开 \textsf{Terminal} 窗口验证 MD5 值, 即执行以下命令 \begin{lstlisting}[language = bash] cd ~/Downloads - md5sum texlive2020.iso + md5sum texlive2021.iso \end{lstlisting} 若显示 \begin{lstlisting} - a31c500c7830d901363c5fa0e65cc18d texlive2020.iso + 2893d180f1559a7bf80dfc0740f6b889 texlive2021.iso \end{lstlisting} 则镜像文件下载正确. 同样可验证 SHA512 值, 执行 \begin{lstlisting}[language = bash] cd ~/Downloads - sha512sum texlive2020.iso + sha512sum texlive2021.iso \end{lstlisting} 正确的返回结果为 \begin{lstlisting}[language=bash,literate={a}{a}{1} {b}{b}{1} {c}{c}{1} {d}{d}{1} {e}{e}{1} {f}{f}{1}] - 7c94bbcff5318e540dc0b03010896185d8985bcc2c2ac11906e831ec583fd574bf9720fce5efc29470c80bafe12f42ddaa392b96c460a27eda94f93c12e7b57d texlive2020.iso + bad51ec47613cf295ed77472d10e517fe79e501f73ff918a1068f03ef43f4394ceb165051132bcbcb53a05650b77ea907f327c1799c38ae476ca38620aa7c1fe texlive2021.iso \end{lstlisting} 将下载的光盘镜像进行挂载 \begin{lstlisting}[language = bash] sudo mkdir /mnt/texlive - sudo mount ./texlive2020.iso /mnt/texlive + sudo mount ./texlive2021.iso /mnt/texlive \end{lstlisting} 接下来执行 \begin{lstlisting}[language = bash] @@ -50,6 +50,7 @@ ======> Letters/digits in <angle brackets> indicate <======= ======> menu items for actions or customizations <======= + = help> https://tug.org/texlive/doc/install-tl.html <======= Detected platform: GNU/Linux on x86_64 @@ -58,21 +59,21 @@ <S> set installation scheme: scheme-full <C> set installation collections: - 40 collections out of 41, disk space required: 6516 MB + 40 collections out of 41, disk space required: 6963 MB <D> set directories: TEXDIR (the main TeX directory): - /usr/local/texlive/2020 + /usr/local/texlive/2021 TEXMFLOCAL (directory for site-wide local files): /usr/local/texlive/texmf-local TEXMFSYSVAR (directory for variable and automatically generated data): - /usr/local/texlive/2020/texmf-var + /usr/local/texlive/2021/texmf-var TEXMFSYSCONFIG (directory for local config): - /usr/local/texlive/2020/texmf-config + /usr/local/texlive/2021/texmf-config TEXMFVAR (personal directory for variable and automatically generated data): - ~/.texlive2020/texmf-var + ~/.texlive2021/texmf-var TEXMFCONFIG (personal directory for local config): - ~/.texlive2020/texmf-config + ~/.texlive2021/texmf-config TEXMFHOME (directory for user-specific files): ~/texmf @@ -90,7 +91,6 @@ Actions: <I> start installation to hard disk <P> save installation profile to 'texlive.profile' and exit - <H> help <Q> quit Enter command: @@ -116,9 +116,9 @@ 在打开的文件末尾添加 \begin{lstlisting} # Add TeX Live to the PATH, MANPATH, INFOPATH - export PATH=/usr/local/texlive/2020/bin/x86_64-linux:$PATH - export MANPATH=/usr/local/texlive/2020/texmf-dist/doc/man:$MANPATH - export INFOPATH=/usr/local/texlive/2020/texmf-dist/doc/info:$INFOPATH + export PATH=/usr/local/texlive/2021/bin/x86_64-linux:$PATH + export MANPATH=/usr/local/texlive/2021/texmf-dist/doc/man:$MANPATH + export INFOPATH=/usr/local/texlive/2021/texmf-dist/doc/info:$INFOPATH \end{lstlisting} 并保存退出. 这时再打开 \textsf{Terminal} 执行 @@ -127,9 +127,9 @@ \end{lstlisting} 若显示 \begin{lstlisting} - TeX 3.14159265 (TeX Live 2020) - kpathsea version 6.3.2 - Copyright 2020 D.E. Knuth. + TeX 3.141592653 (TeX Live 2021) + kpathsea version 6.3.3 + Copyright 2021 D.E. Knuth. There is NO warranty. Redistribution of this software is covered by the terms of both the TeX copyright and the Lesser GNU General Public License. @@ -142,7 +142,7 @@ 接下来处理字体. 在 \textsf{Terminal} 中执行 \begin{lstlisting}[language=bash] - sudo cp /usr/local/texlive/2020/texmf-var/fonts/conf/texlive-fontconfig.conf /etc/fonts/conf.d/09-texlive.conf + sudo cp /usr/local/texlive/2021/texmf-var/fonts/conf/texlive-fontconfig.conf /etc/fonts/conf.d/09-texlive.conf \end{lstlisting} 将配置文件复制到系统, 然后继续执行 @@ -156,7 +156,7 @@ 如果用户更改了安装路径, 要注意将 \begin{lstlisting} - /usr/local/texlive/2020/ + /usr/local/texlive/2021/ \end{lstlisting} 在各处替换. @@ -250,9 +250,22 @@ 进而通过 \texttt{sudo rm -rf} 命令进行删除. 默认安装的用户直接运行 \begin{lstlisting}[language = bash] - sudo rm -rf /usr/local/texlive/2020 - rm -rf ~/.texlive2020 + sudo rm -rf /usr/local/texlive/2021 + rm -rf ~/.texlive2021 \end{lstlisting} +卸载完成后,可以进一步移除之前设置的环境变量. +在 \textsf{Terminal} 中执行 +\begin{lstlisting}[language = bash] + gedit ~/.bashrc +\end{lstlisting} +然后移除之前在文件末尾添加的 +\begin{lstlisting} + # Add TeX Live to the PATH, MANPATH, INFOPATH + export PATH=/usr/local/texlive/2021/bin/x86_64-linux:$PATH + export MANPATH=/usr/local/texlive/2021/texmf-dist/doc/man:$MANPATH + export INFOPATH=/usr/local/texlive/2021/texmf-dist/doc/info:$INFOPATH +\end{lstlisting} +并保存退出. \subsection{使用 \texttt{tlmgr} 工具} @@ -282,7 +295,7 @@ please get the new TL by doing a new installation instead of proceeding here}. \end{lstlisting} 将 \begin{lstlisting} - /usr/local/texlive/2020/bin/x86_64-linux: + /usr/local/texlive/2021/bin/x86_64-linux: \end{lstlisting} 添加在 \texttt{secure\_path} 中% \footnote{这里只讨论默认安装的情况}. @@ -369,7 +382,7 @@ Ubuntu 20.04 下安装宏包的要求与 Windows 10 下没有多少区别, 只 对于中文文档, 可以在 \texttt{gedit} 中编写以下最小示例% \footnote{gedit 默认使用 UTF-8 编码}% \begin{lstlisting}[language={[LaTeX]TeX}] - \documentclass[UTF8]{ctexart} + \documentclass[UTF8,fontset=fandol]{ctexart} \begin{document} 你好 \LaTeX{} 世界! \end{document} diff --git a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/windows.tex b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/windows.tex index 8060782a839..3c3136ad83a 100644 --- a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/windows.tex +++ b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/windows.tex @@ -8,7 +8,7 @@ 在文件夹菜单栏 \menu{查看 > 显示/隐藏} 中选择 \menu{文件扩展名}. 用户可以从最近的 CTAN 源\footnote{这里所谓的最近, 其实是由系统判定的, 实际上系统可能会误判}下载 \TeX{} Live 的 -\href{https://mirrors.ctan.org/systems/texlive/Images/texlive2020.iso}{iso 镜像文件}, +\href{https://mirrors.ctan.org/systems/texlive/Images/texlive2021.iso}{iso 镜像文件}, 也可以找大陆地区的源自行下载\footnote{新版本发布时, 各镜像网站同步的进度会有不同}. 通过大陆地区的源下载 iso 文件的方法请参考附录~\ref{chp:appendix:mirror}. @@ -50,12 +50,12 @@ 打开 \textsf{cmd} 窗口依次执行以下代码 \begin{lstlisting}[language = bash] cd /d X:\Y - certutil -hashfile texlive2020.iso md5 + certutil -hashfile texlive2021.iso md5 \end{lstlisting} 若系统显示 \begin{lstlisting} - MD5 的 texlive2020.iso 哈希: - a31c500c7830d901363c5fa0e65cc18d + MD5 的 texlive2021.iso 哈希: + 2893d180f1559a7bf80dfc0740f6b889 CertUtil: -hashfile 命令成功完成 \end{lstlisting} 则表明下载的镜像文件正常. @@ -64,12 +64,12 @@ 依然是在 \textsf{cmd} 执行 \begin{lstlisting}[language = bash] cd /d X:\Y - certutil -hashfile texlive2020.iso sha512 + certutil -hashfile texlive2021.iso sha512 \end{lstlisting} 若系统显示 \begin{lstlisting}[language=bash,literate={a}{a}{1} {b}{b}{1} {c}{c}{1} {d}{d}{1} {e}{e}{1} {f}{f}{1}] - SHA512 的 texlive2020.iso 哈希: - 7c94bbcff5318e540dc0b03010896185d8985bcc2c2ac11906e831ec583fd574bf9720fce5efc29470c80bafe12f42ddaa392b96c460a27eda94f93c12e7b57d + SHA512 的 texlive2021.iso 哈希: + bad51ec47613cf295ed77472d10e517fe79e501f73ff918a1068f03ef43f4394ceb165051132bcbcb53a05650b77ea907f327c1799c38ae476ca38620aa7c1fe CertUtil: -hashfile 命令成功完成 \end{lstlisting} 即为验证成功. @@ -78,7 +78,7 @@ 接下来开始安装. 推荐用户先手动建立 \TeX{} Live 的安装路径 (文件夹) 再进行安装, 注意路径的名称是\textbf{不带空格的英文}, -默认路径为 \texttt{C:\textbackslash texlive\textbackslash 2020}. +默认路径为 \texttt{C:\textbackslash texlive\textbackslash 2021}. 将镜像文件挂载至虚拟光驱\footnote{Windows 10 默认双击镜像文件便可加载; 受某些压缩软件影响双击失效时, 可通过文件夹菜单栏 @@ -106,6 +106,7 @@ ======> Letters/digits in <angle brackets> indicate <======= ======> menu items for actions or customizations <======= + = help> https://tug.org/texlive/doc/install-tl.html <======= Detected platform: Windows @@ -114,21 +115,21 @@ <S> set installation scheme: scheme-full <C> set installation collections: - 41 collections out of 41, disk space required: 6702 MB + 41 collections out of 41, disk space required: 7155 MB <D> set directories: TEXDIR (the main TeX directory): - C:/texlive/2020 + C:/texlive/2021 TEXMFLOCAL (directory for site-wide local files): C:/texlive/texmf-local TEXMFSYSVAR (directory for variable and automatically generated data): - C:/texlive/2020/texmf-var + C:/texlive/2021/texmf-var TEXMFSYSCONFIG (directory for local config): - C:/texlive/2020/texmf-config + C:/texlive/2021/texmf-config TEXMFVAR (personal directory for variable and automatically generated data): - ~/.texlive2020/texmf-var + ~/.texlive2021/texmf-var TEXMFCONFIG (personal directory for local config): - ~/.texlive2020/texmf-config + ~/.texlive2021/texmf-config TEXMFHOME (directory for user-specific files): ~/texmf @@ -149,7 +150,6 @@ Actions: <I> start installation to hard disk <P> save installation profile to 'texlive.profile' and exit - <H> help <Q> quit Enter command: @@ -161,15 +161,15 @@ ============================================================================== Directories customization: - <1> TEXDIR: C:/texlive/2020 - main tree: C:/texlive/2020/texmf-dist + <1> TEXDIR: C:/texlive/2021 + main tree: C:/texlive/2021/texmf-dist <2> TEXMFLOCAL: C:/texlive/texmf-local - <3> TEXMFSYSVAR: C:/texlive/2020/texmf-var - <4> TEXMFSYSCONFIG: C:/texlive/2020/texmf-config + <3> TEXMFSYSVAR: C:/texlive/2021/texmf-var + <4> TEXMFSYSCONFIG: C:/texlive/2021/texmf-config - <5> TEXMFVAR: ~/.texlive2020/texmf-var - <6> TEXMFCONFIG: ~/.texlive2020/texmf-config + <5> TEXMFVAR: ~/.texlive2021/texmf-var + <6> TEXMFCONFIG: ~/.texlive2021/texmf-config <7> TEXMFHOME: ~/texmf Note: ~ will expand to %USERPROFILE% @@ -182,9 +182,9 @@ \end{lstlisting} 这时按键盘 \keys{1}, 将看到 \begin{lstlisting} - New value for TEXDIR [C:/texlive/2020]: + New value for TEXDIR [C:/texlive/2021]: \end{lstlisting} -这时可更改路径, 如 \texttt{D:/texlive/2020}. +这时可更改路径, 如 \texttt{D:/texlive/2021}. 接下来, 按键盘 \keys{R} 即可回到初始的安装界面, 再按键盘 \keys{I} 便可在刚才指定的路径安装. 用户可通过阅读英文执行其他操作, 这里不再赘述. @@ -200,9 +200,9 @@ \end{lstlisting} 显示 \begin{lstlisting} - TeX 3.14159265 (TeX Live 2020/W32TeX) - kpathsea version 6.3.2 - Copyright 2020 D.E. Knuth. + TeX 3.141592653 (TeX Live 2021/W32TeX) + kpathsea version 6.3.3 + Copyright 2021 D.E. Knuth. There is NO warranty. Redistribution of this software is covered by the terms of both the TeX copyright and the Lesser GNU General Public License. @@ -221,19 +221,19 @@ 目前发现有些用户使用某些浏览器时无法正常下载镜像文件. 这时, -用户可以选择使用 \href{https://eternallybored.org/misc/wget/}{wget} 对镜像进行下载. +用户可以选择使用 \href{https://eternallybored.org/misc/wget/}{\textsf{wget}} 对镜像进行下载. 具体用法是: 将 \textsf{wget} 所在目录添加到环境变量中. 打开 \textsf{cmd} 窗口执行以下代码 \begin{lstlisting}[language = bash] - wget http://mirrors.ctan.org/systems/texlive/Images/texlive2020.iso + wget http://mirrors.ctan.org/systems/texlive/Images/texlive2021.iso \end{lstlisting} 即可下载最近的镜像. 类似地, 也可以指定国内的源进行下载, 例如选择清华大学镜像 \begin{lstlisting}[language = bash] - wget https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/texlive2020.iso + wget https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/texlive2021.iso \end{lstlisting} 其他国内镜像只需要将链接替换即可, 链接和方法请参考附录~\ref{chp:appendix:mirror}. @@ -272,40 +272,36 @@ \footnote{双击或在 \texttt{cmd} 中运行}% 安装路径中的卸载批处理文件即可实现卸载, 如默认安装时执行 \begin{lstlisting}[language=bash] - C:\texlive\2020\tlpkg\installer\uninst.bat + C:\texlive\2021\tlpkg\installer\uninst.bat \end{lstlisting} 结束以上步骤后, -手动删除用户文件夹中的 \texttt{.texlive2020}. +手动删除用户文件夹中的 \texttt{.texlive2021}. 如果用户安装 \TeX{} Live 时需要管理员权限, 那么在卸载时同样需要管理员权限. -\subsection{使用 \texttt{tlmgr} 工具} - -直接使用 \texttt{tlmgr} 工具卸载也可以. -在命令行中执行 -\begin{lstlisting}[language=bash] - tlmgr remove --all +卸载后, +用户需要清理注册表 +\begin{lstlisting} + HKEY_CURRENT_USER\Software\Classes\TL.bitmap2eps.convert.2021 + HKEY_CURRENT_USER\Software\Classes\TL.DVIOUT.view.2021 + HKEY_CURRENT_USER\Software\Classes\TL.TeXworks.edit.2021 + HKEY_CURRENT_USER\Software\Classes\TL.PSViewer.view.2021 +\end{lstlisting} +但若在安装时使用管理员权限``为所有人安装'', +则注册表位置将变为 +\begin{lstlisting} + HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TL.bitmap2eps.convert.2021 + HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TL.DVIOUT.view.2021 + HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TL.TeXworks.edit.2021 + HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TL.PSViewer.view.2021 \end{lstlisting} -即可. \subsection{手动卸载} 如果执行批处理文件 \texttt{uninst.bat} 出错, 用户也可手动删除安装文件夹, 之后再清理 \TeX{} Live 的环境变量, -并且清理注册表 -\begin{lstlisting} - HKEY_CURRENT_USER\Software\Classes\TL.bitmap2eps.convert.2020 - HKEY_CURRENT_USER\Software\Classes\TL.DVIOUT.view.2020 - HKEY_CURRENT_USER\Software\Classes\TL.TeXworks.edit.2020 -\end{lstlisting} -但若在安装时使用管理员权限``为所有人安装'', -则注册表位置将变为 -\begin{lstlisting} - HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TL.bitmap2eps.convert.2020 - HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TL.DVIOUT.view.2020 - HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TL.TeXworks.edit.2020 -\end{lstlisting} +并且清理注册表. \section{跨版本升级 \TeX{} Live} @@ -428,7 +424,7 @@ Doing a new installation is necessary.}. \footnote{自 Windows 10 1903 版本开始, 记事本默认使用 UTF-8 编码; 若是之前的 Windows 10 版本, 请使用其他编辑器并规定文档编码为 UTF-8}% \begin{lstlisting}[language={[LaTeX]TeX}] - \documentclass[UTF8]{ctexart} + \documentclass[UTF8,fontset=windows]{ctexart} \begin{document} 你好 \LaTeX{} 世界! \end{document} diff --git a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/wsl.tex b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/wsl.tex index 08181a019be..1f43e90035b 100644 --- a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/wsl.tex +++ b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/wsl.tex @@ -14,7 +14,7 @@ 在主系统% \footnote{在 Windows 10 中直接进行的操作即为在主系统中的操作}% 中下载 -\href{https://mirrors.ctan.org/systems/texlive/Images/texlive2020.iso}{iso 镜像文件}, +\href{https://mirrors.ctan.org/systems/texlive/Images/texlive2021.iso}{iso 镜像文件}, 可选择国内源以加快下载速度. 下载完毕后, 在 \textsf{cmd} 中验证文件是否正常. 下载及文件验证方法同 \ref{sec:windows:install}~节. @@ -53,51 +53,51 @@ 在屏幕上应该能见到以下内容 \begin{lstlisting} ======================> TeX Live installation procedure <===================== - + ======> Letters/digits in <angle brackets> indicate <======= ======> menu items for actions or customizations <======= + = help> https://tug.org/texlive/doc/install-tl.html <======= - Detected platform: GNU/Linux on x86_64 + Detected platform: GNU/Linux on x86_64 + + <B> set binary platforms: 1 out of 6 - <B> set binary platforms: 1 out of 6 + <S> set installation scheme: scheme-full - <S> set installation scheme: scheme-full + <C> set installation collections: + 40 collections out of 41, disk space required: 6963 MB - <C> set installation collections: - 40 collections out of 41, disk space required: 6516 MB + <D> set directories: + TEXDIR (the main TeX directory): + /usr/local/texlive/2021 + TEXMFLOCAL (directory for site-wide local files): + /usr/local/texlive/texmf-local + TEXMFSYSVAR (directory for variable and automatically generated data): + /usr/local/texlive/2021/texmf-var + TEXMFSYSCONFIG (directory for local config): + /usr/local/texlive/2021/texmf-config + TEXMFVAR (personal directory for variable and automatically generated data): + ~/.texlive2021/texmf-var + TEXMFCONFIG (personal directory for local config): + ~/.texlive2021/texmf-config + TEXMFHOME (directory for user-specific files): + ~/texmf - <D> set directories: - TEXDIR (the main TeX directory): - /usr/local/texlive/2020 - TEXMFLOCAL (directory for site-wide local files): - /usr/local/texlive/texmf-local - TEXMFSYSVAR (directory for variable and automatically generated data): - /usr/local/texlive/2020/texmf-var - TEXMFSYSCONFIG (directory for local config): - /usr/local/texlive/2020/texmf-config - TEXMFVAR (personal directory for variable and automatically generated data): - ~/.texlive2020/texmf-var - TEXMFCONFIG (personal directory for local config): - ~/.texlive2020/texmf-config - TEXMFHOME (directory for user-specific files): - ~/texmf - - <O> options: - [ ] use letter size instead of A4 by default - [X] allow execution of restricted list of programs via \write18 - [X] create all format files - [X] install macro/font doc tree - [X] install macro/font source tree - [ ] create symlinks to standard directories - [X] after install, set CTAN as source for package updates + <O> options: + [ ] use letter size instead of A4 by default + [X] allow execution of restricted list of programs via \write18 + [X] create all format files + [X] install macro/font doc tree + [X] install macro/font source tree + [ ] create symlinks to standard directories + [X] after install, set CTAN as source for package updates - <V> set up for portable installation + <V> set up for portable installation Actions: - <I> start installation to hard disk - <P> save installation profile to 'texlive.profile' and exit - <H> help - <Q> quit + <I> start installation to hard disk + <P> save installation profile to 'texlive.profile' and exit + <Q> quit Enter command: \end{lstlisting} @@ -120,9 +120,9 @@ 在打开的文件末尾添加 \begin{lstlisting} # Add TeX Live to the PATH, MANPATH, INFOPATH - export PATH=/usr/local/texlive/2020/bin/x86_64-linux:$PATH - export MANPATH=/usr/local/texlive/2020/texmf-dist/doc/man:$MANPATH - export INFOPATH=/usr/local/texlive/2020/texmf-dist/doc/info:$INFOPATH + export PATH=/usr/local/texlive/2021/bin/x86_64-linux:$PATH + export MANPATH=/usr/local/texlive/2021/texmf-dist/doc/man:$MANPATH + export INFOPATH=/usr/local/texlive/2021/texmf-dist/doc/info:$INFOPATH \end{lstlisting} 并保存退出. 同样, 不熟悉 \textsf{vim} 的用户可参考 \ref{sec:no-vim}~节. @@ -132,9 +132,9 @@ \end{lstlisting} 将显示 \begin{lstlisting} - TeX 3.14159265 (TeX Live 2020) - kpathsea version 6.3.2 - Copyright 2020 D.E. Knuth. + TeX 3.141592653 (TeX Live 2021) + kpathsea version 6.3.3 + Copyright 2021 D.E. Knuth. There is NO warranty. Redistribution of this software is covered by the terms of both the TeX copyright and the Lesser GNU General Public License. @@ -148,7 +148,7 @@ 首先将配置文件复制到系统, 在 \textsf{Terminal} 执行 \begin{lstlisting}[language=bash] - sudo cp /usr/local/texlive/2020/texmf-var/fonts/conf/texlive-fontconfig.conf /etc/fonts/conf.d/09-texlive.conf + sudo cp /usr/local/texlive/2021/texmf-var/fonts/conf/texlive-fontconfig.conf /etc/fonts/conf.d/09-texlive.conf \end{lstlisting} 然后在 \textsf{Terminal} 执行 \begin{lstlisting}[language=bash] @@ -172,6 +172,75 @@ WSL 中的方法同 \ref{sec:ubuntu:update}~节. WSL 中的方法同 \ref{sec:ubuntu:installpackage}~节. +\section{调出宏包手册} + +由于 WSL 的 \textsf{bash} 默认是无窗口化的纯命令行, +因此将 \TeX{} Live 安装至 WSL 后, +用户无法直接通过命令 \texttt{texdoc} 打开相应的手册. +下面几种方法均为收集而来的方案, +其中比较推荐更改 \texttt{texdoc.cnf}. + +\subsubsection{更改 \texttt{texdoc.cnf}} + +此方案源自本手册的 \href{https://github.com/OsbertWang/install-latex-guide-zh-cn/issues/13}{issue}. +首先在 \textsf{bash} 中执行 +\begin{lstlisting}[language=bash] + texdoc --files +\end{lstlisting} +系统返回类似如下内容 +\begin{lstlisting}[language=bash] + /mnt/d/texlive-wsl/2021/texmf-dist/scripts/texdoc/texdoclib.tlu 3.2.2 + Configuration file(s): + active /mnt/d/texlive-wsl/2021/texmf-dist/texdoc/texdoc.cnf + Recommended file(s) for personal settings: + /home/<username>/texmf/texdoc/texdoc.cnf +\end{lstlisting} +这里给出了 \texttt{texdoc} 的配置文件所在位置. +打开用户文件夹下的配置文件 +\begin{lstlisting}[language=bash] + vim ~/texmf/texdoc/texdoc.cnf +\end{lstlisting} +在文件内写入 +\begin{lstlisting} + viewer_pdf = (powershell.exe -Command Start-Process $(wslpath -w %s)) & +\end{lstlisting} +并且保存退出. +然后再执行 \texttt{texdoc} 即可打开相应文档. + +\subsubsection{explorer 浏览} + +先找到手册所在路径, +例如寻找 \texttt{lshort-zh-cn} +\begin{lstlisting}[language=bash] + texdoc -l lshort-zh-cn +\end{lstlisting} +系统会显示 +\begin{lstlisting} + 1 /usr/local/texlive/2021/texmf-dist/doc/latex/lshort-chinese/lshort-zh-cn.pdf + = [zh] The document itself + Enter number of file to view, RET to view 1, anything else to skip: +\end{lstlisting} +这时按其他键 (如 \keys{x}) 退出. +然后分别执行 +\begin{lstlisting}[language=bash] + cd /usr/local/texlive/2021/texmf-dist/doc/latex/lshort-chinese/ + explorer.exe . +\end{lstlisting} +主系统的资源管理器便会打开. +这时用户便可以在主系统中使用 pdf 阅读器打开手册进行阅读. + +\subsubsection{everything 搜索} + +使用 \href{https://www.voidtools.com/zh-cn/}{everything}. +通过 \texttt{texdoc -l} 找到相应文件名, +而后直接搜索. +具体方法这里不再赘述. + +\subsubsection{借助其他工具} + +目前有很多开源的 WSL 辅助程序, +相关讨论见本手册的 \href{https://github.com/OsbertWang/install-latex-guide-zh-cn/issues/13}{issue}. + \section{编译文件} 编译一个最小示例 \texttt{main.tex}. @@ -219,7 +288,7 @@ WSL 中的方法同 \ref{sec:ubuntu:installpackage}~节. 可以编写以下最小示例% \footnote{注意使用 UTF-8 编码}% \begin{lstlisting}[language={[LaTeX]TeX}] - \documentclass[UTF8]{ctexart} + \documentclass[UTF8,fontset=fandol]{ctexart} \begin{document} 你好 \LaTeX{} 世界! \end{document} @@ -237,52 +306,11 @@ WSL 中的方法同 \ref{sec:ubuntu:installpackage}~节. \footnote{注意主系统中的字体默认不能直接被调用, 如果打算使用主系统中的字体, 见 -\href{https://github.com/OsbertWang/install-latex/issues/14}{github 上的讨论}}, +\href{https://github.com/OsbertWang/install-latex-guide-zh-cn/issues/14}{github 上的讨论}}, 在 WSL 中安装字体的方法见附录~\ref{chp:appendix:wsl}. 编译命令可添加参数, 这里与 \ref{sec:windows:compile}~节中的情形一致, 不再赘述. -\section{尚未圆满解决的问题} - -将 \TeX{} Live 安装至 WSL 仍有悬而未决的问题. -由于 \textsf{bash} 默认是无窗口化的纯命令行, -因此用户无法直接通过命令 \texttt{texdoc} 打开相应的手册. -这里给出几种方法. - -\subsubsection{explorer 浏览} - -先找到手册所在路径, -例如寻找 \texttt{lshort-zh-cn} -\begin{lstlisting}[language=bash] - texdoc -l lshort-zh-cn -\end{lstlisting} -系统会显示 -\begin{lstlisting} - 1 /usr/local/texlive/2020/texmf-dist/doc/latex/lshort-chinese/lshort-zh-cn.pdf - = [zh] The document itself - Enter number of file to view, RET to view 1, anything else to skip: -\end{lstlisting} -这时按其他键 (如 \keys{x}) 退出. -然后分别执行 -\begin{lstlisting}[language=bash] - cd /usr/local/texlive/2020/texmf-dist/doc/latex/lshort-chinese/ - explorer.exe . -\end{lstlisting} -主系统的资源管理器便会打开. -这时用户便可以在主系统中使用 pdf 阅读器打开手册进行阅读. - -\subsubsection{everything 搜索} - -使用 \href{https://www.voidtools.com/zh-cn/}{everything}. -通过 \texttt{texdoc -l} 找到相应文件名, -而后直接搜索. -具体方法这里不再赘述. - -\subsubsection{借助其他工具} - -目前有很多开源的 WSL 辅助程序, -相关讨论见本手册的 \href{https://github.com/OsbertWang/install-latex/issues/13}{issue}. - \section{不懂 \textsf{vim} 的处理方法}\label{sec:no-vim} \textsf{vim} 的使用方法与目前很多流行的编辑器不同, diff --git a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/install-latex-guide-zh-cn.pdf b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/install-latex-guide-zh-cn.pdf Binary files differindex 497d34aa25d..7072d97323f 100644 --- a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/install-latex-guide-zh-cn.pdf +++ b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/install-latex-guide-zh-cn.pdf |