texlive[58796] Master/texmf-dist/doc/latex/install-latex-guide-zh-cn:
commits+preining at tug.org
commits+preining at tug.org
Thu Apr 8 23:13:39 CEST 2021
Revision: 58796
http://tug.org/svn/texlive?view=revision&revision=58796
Author: preining
Date: 2021-04-08 23:13:38 +0200 (Thu, 08 Apr 2021)
Log Message:
-----------
install-latex-guide-zh-cn (9apr21)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/mirror.tex
trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/updateinfo.tex
trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/editor.tex
trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/overleaf.tex
trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/ubuntu.tex
trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/windows.tex
trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/wsl.tex
trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/install-latex-guide-zh-cn.pdf
Modified: trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/mirror.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/mirror.tex 2021-04-07 23:48:40 UTC (rev 58795)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/mirror.tex 2021-04-08 21:13:38 UTC (rev 58796)
@@ -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,7 +72,7 @@
替换为相应的源的地址,
而将
\begin{lstlisting}
- Images/texlive2020.iso
+ Images/texlive2021.iso
\end{lstlisting}
予以保留.
以清华大学为例,
@@ -77,7 +79,7 @@
从清华大学源中下载 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}
同理,
Modified: trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/updateinfo.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/updateinfo.tex 2021-04-07 23:48:40 UTC (rev 58795)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/updateinfo.tex 2021-04-08 21:13:38 UTC (rev 58796)
@@ -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}
Modified: trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/editor.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/editor.tex 2021-04-07 23:48:40 UTC (rev 58795)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/editor.tex 2021-04-08 21:13:38 UTC (rev 58796)
@@ -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 @@
相较于 \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 上的发行文件,
网站提供了下载教程,
这里不再展开.
Modified: trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/overleaf.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/overleaf.tex 2021-04-07 23:48:40 UTC (rev 58795)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/overleaf.tex 2021-04-08 21:13:38 UTC (rev 58796)
@@ -69,17 +69,13 @@
它们分别是 \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{学习与帮助}
Modified: trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/ubuntu.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/ubuntu.tex 2021-04-07 23:48:40 UTC (rev 58795)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/ubuntu.tex 2021-04-08 21:13:38 UTC (rev 58796)
@@ -5,22 +5,22 @@
\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 值,
@@ -27,17 +27,17 @@
执行
\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 @@
\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 @@
对于中文文档, 可以在 \texttt{gedit} 中编写以下最小示例%
\footnote{gedit 默认使用 UTF-8 编码}%
\begin{lstlisting}[language={[LaTeX]TeX}]
- \documentclass[UTF8]{ctexart}
+ \documentclass[UTF8,fontset=fandol]{ctexart}
\begin{document}
你好 \LaTeX{} 世界！
\end{document}
Modified: trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/windows.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/windows.tex 2021-04-07 23:48:40 UTC (rev 58795)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/windows.tex 2021-04-08 21:13:38 UTC (rev 58796)
@@ -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,12 +221,12 @@
目前发现有些用户使用某些浏览器时无法正常下载镜像文件.
这时,
-用户可以选择使用 \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}
即可下载最近的镜像.
类似地,
@@ -233,7 +233,7 @@
也可以指定国内的源进行下载,
例如选择清华大学镜像
\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,21 +272,29 @@
\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{手动卸载}
@@ -293,19 +301,7 @@
如果执行批处理文件 \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 @@
\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}
Modified: trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/wsl.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/wsl.tex 2021-04-07 23:48:40 UTC (rev 58795)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/wsl.tex 2021-04-08 21:13:38 UTC (rev 58796)
@@ -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: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 @@
可以编写以下最小示例%
\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 @@
\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} 的使用方法与目前很多流行的编辑器不同,
Modified: trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/install-latex-guide-zh-cn.pdf
===================================================================
(Binary files differ)
More information about the tex-live-commits
mailing list.