texlive[66738] Master/texmf-dist/doc/latex/install-latex-guide-zh-cn:
commits+karl at tug.org
commits+karl at tug.org
Sun Apr 2 22:29:10 CEST 2023
Revision: 66738
http://tug.org/svn/texlive?view=revision&revision=66738
Author: karl
Date: 2023-04-02 22:29:09 +0200 (Sun, 02 Apr 2023)
Log Message:
-----------
install-latex-guide-zh-cn (2apr23)
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/preface.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
trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/install-latex-guide-zh-cn.tex
Removed Paths:
-------------
trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/wsladdition.tex
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 2023-04-02 20:28:39 UTC (rev 66737)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/mirror.tex 2023-04-02 20:29:09 UTC (rev 66738)
@@ -21,6 +21,8 @@
\hline\hline
\href{https://developer.aliyun.com/mirror/}{阿里云}
& \url{https://mirrors.aliyun.com/CTAN/systems/texlive/}\\
+ \href{http://mirrors.pku.edu.cn/Mirrors}{北京大学}
+ & \url{http://mirrors.pku.edu.cn/ctan/systems/texlive/}\\
\href{https://mirror.bjtu.edu.cn/}{北京交通大学}
& \url{https://mirror.bjtu.edu.cn/ctan/systems/texlive/}\\
\href{https://mirrors.bit.edu.cn/web/}{北京理工大学}
@@ -33,8 +35,8 @@
% & \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/}{华为云}
- % & \url{https://mirrors.huaweicloud.com/CTAN/systems/texlive/}\\
+ \href{https://mirrors.huaweicloud.com/}{华为云}
+ & \url{https://mirrors.huaweicloud.com/CTAN/systems/texlive/}\\
% \href{http://mirrors.hust.edu.cn/}{华中科技大学}
% & \url{http://mirrors.hust.edu.cn/CTAN/systems/texlive/}\\
\href{https://mirror.lzu.edu.cn/}{兰州大学}
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 2023-04-02 20:28:39 UTC (rev 66737)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/updateinfo.tex 2023-04-02 20:29:09 UTC (rev 66738)
@@ -2,6 +2,14 @@
\chapter{版本信息}
+\section*{v2023.4.1}
+
+\begin{enumerate}
+ \item 重构有关 Ubuntu 和 WSL 的内容
+ \item 补北京大学和华为云镜像
+ \item 订正 Windows 系统下安装目录的错误
+\end{enumerate}
+
\section*{v2023.3.23}
\begin{enumerate}
Deleted: trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/wsladdition.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/wsladdition.tex 2023-04-02 20:28:39 UTC (rev 66737)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/wsladdition.tex 2023-04-02 20:29:09 UTC (rev 66738)
@@ -1,62 +0,0 @@
-% !TeX root = ../install-latex-guide-zh-cn.tex
-
-\chapter{有关 WSL 的一点补充内容}\label{chp:appendix:wsl}
-
-有用户指出,
-WSL (本质上是 Ubuntu) 中安装字体比较麻烦.
-这里引用
-\href{https://www.jianshu.com/p/e7f12b8c8602}{Ubuntu系统字体命令和字体的安装}
-一文.
-大致步骤如下.
-
-首先获取需要安装的字体文件,
-假设文件保存在 \verb|~/fonts/|.
-然后在 \texttt{/usr/share/fonts/} 文件夹中创建新的文件夹,
-例如 \texttt{myfonts}
-\begin{lstlisting}[language=bash]
- cd /usr/share/fonts/
- sudo mkdir myfonts
-\end{lstlisting}
-接下来将获取的字体文件复制到 \texttt{myfonts} 中
-\begin{lstlisting}[language=bash]
- sudo cp ~/fonts/* /usr/share/fonts/myfonts/
-\end{lstlisting}
-然后修改字体文件的权限
-\begin{lstlisting}[language=bash]
- sudo chmod -R 755 myfonts
-\end{lstlisting}
-最后建立字体缓存
-\begin{lstlisting}[language=bash]
- mkfontscale
- mkfontdir
- fc-cache -fv
-\end{lstlisting}
-
-实际上有部分字体可直接使用源进行安装,
-如安装字体 Noto CJK
-\begin{lstlisting}[language=bash]
- sudo apt install fonts-noto-cjk
- sudo apt install fonts-noto-cjk-extra
-\end{lstlisting}
-安装 Windows 系统中常见的字体 Andale Mono,
-Arial Black,
-Arial (Bold, Italic, Bold Italic),
-Comic Sans MS (Bold),
-Courier New (Bold, Italic, Bold Italic),
-Georgia (Bold, Italic, Bold Italic),
-Impact,
-Times New Roman (Bold, Italic, Bold Italic),
-Trebuchet (Bold, Italic, Bold Italic),
-Verdana (Bold, Italic, Bold Italic),
-Webdings
-\begin{lstlisting}[language=bash]
- sudo apt install ttf-mscorefonts-installer
-\end{lstlisting}
-安装字体文泉驿正黑,
-文泉驿微米黑,
-文泉驿等宽微米黑,
-文泉驿点阵宋体,
-文泉驿点阵楷体
-\begin{lstlisting}[language=bash]
- sudo apt install ttf-wqy-zenhei
-\end{lstlisting}
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 2023-04-02 20:28:39 UTC (rev 66737)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/editor.tex 2023-04-02 20:29:09 UTC (rev 66738)
@@ -20,7 +20,7 @@
和大多数国产软件不同, \TeX works 不会自动在桌面生成快捷方式,
新人往往不知道如何打开它.
实际上 \TeX works 在 \TeX{} Live 安装路径的
-\texttt{\textbackslash bin\textbackslash win32} 中,
+\texttt{\textbackslash bin\textbackslash windows} 中,
可在 \textsf{cmd} 中执行 \texttt{texworks} 打开,
也可直接在 Windows 搜索栏里搜 \TeX works 打开.
@@ -405,11 +405,11 @@
至此完成了逆向搜索,
双击 PDF 文件便可回到 \TeX studio 中对应代码的行首.
-\section{Ubuntu 22.04 系统}
+\section{Ubuntu 22.04 系统}\label{sec:editor:ubuntu}
简化起见, 这里只介绍如何使用 \TeX studio.
根据官网推荐, 我们安装源内的 \TeX studio.
-安装前可参照 \ref{subsec:fc-cache}~节的介绍换源以增速.
+安装前可参照 \ref{sec:addition:source}~节的介绍换源以增速.
在 \textsf{Terminal} 中执行
\begin{lstlisting}[language = bash]
@@ -417,7 +417,8 @@
\end{lstlisting}
即可安装 \TeX studio.
注意安装过程中会产生一些依赖, 它们包括了源内的 \TeX{} live 包, 如 \texttt{tex-common}, \texttt{texlive-base}, \texttt{texlive-binaries}, \texttt{texlive-latex-base} 和 \texttt{texlive-latex-recommended}.
-用户需要卸载它们.
+用户需要卸载它们,
+参见 \ref{sec:ubuntu:aptremove}~节.
当然用户也可以使用
\href{https://code.launchpad.net/~sunderme/+archive/ubuntu/texstudio}{PPA}
@@ -429,30 +430,9 @@
sudo apt install texstudio
\end{lstlisting}
鉴于网络原因,
-直接从 PPA 下载容易丢包.
-这里介绍中科大的\href{https://lug.ustc.edu.cn/wiki/mirrors/help/revproxy/}{反向镜像},
-将
-\begin{lstlisting}[language = bash]
- /etc/apt/sources.list.d/
-\end{lstlisting}
-中文件的内容
-\begin{lstlisting}
- http(s)://ppa.launchpad.net
-\end{lstlisting}
-改为
-\begin{lstlisting}
- https://launchpad.proxy.ustclug.org
-\end{lstlisting}
-而后再
-\begin{lstlisting}[language = bash]
- sudo apt update
-\end{lstlisting}
-即完成换源.
-有时地址太多而逐个换太麻烦,
-可以直接使用如下命令直接替换\footnote{参见 \url{https://mogeko.me/posts/zh-cn/035/}}
-\begin{lstlisting}[language = bash]
- sudo find /etc/apt/sources.list.d/ -type f -name "*.list" -exec sed -i.bak -r 's#deb(-src)?\s*http(s)?://ppa.launchpad.net#deb\1 https\2://launchpad.proxy.ustclug.org#ig' {} \;
-\end{lstlisting}
+直接从 PPA 下载容易丢包,
+因此可以使用反向代理,
+具体见 \ref{sec:addition:proxy}~节.
安装完毕后,
用户可以在 \textsf{Terminal} 中执行
@@ -469,7 +449,7 @@
中添加路径,
默认安装时为
\begin{lstlisting}
- /usr/local/texlive/2020/bin/x86_64-linux
+ /usr/local/texlive/2023/bin/x86_64-linux
\end{lstlisting}
其他设置可参考前文, 这里不再赘述.
@@ -511,97 +491,28 @@
\section{Windows Subsystem for Linux}\label{sec:editor:wsl}
-目前建议使用
-\href{https://code.visualstudio.com/}{VS Code}
-配合
-\href{https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl}{WSL}
-和
-\href{https://marketplace.visualstudio.com/items?itemName=James-Yu.latex-workshop}{\LaTeX{} Workshop}
-来编写文档.
-具体设置方式建议阅读插件手册,
-一些网友的教程可以参考,
-如
-\href{https://github.com/EthanDeng/vscode-latex}{EthanDeng 的教程}.
-以下配置为个人自用,
-仅供参考,
-其中注释的部分是调用外部 SumatraPDF 阅读器的配置,
-用户可参考
-\href{https://github.com/OsbertWang/latex-editor-sumatrapdf}{latex-editor-sumatrapdf}
-来了解更多内容.
+简化起见,
+只介绍 \TeX studio 的用法.
+\TeX studio 在 WSL 中的安装与使用同 \ref{sec:editor:ubuntu}~节所介绍的一致.
+只不过此时只能使用 WSL 来安装、启动、编写和编译文件,
+在主系统中的 \TeX studio 无法在 WSL 起作用.
-\begin{lstlisting}
- "latex-workshop.latex.tools": [
- {
- "name": "latexmkpdf",
- "command": "latexmk",
- "args": [
- "-synctex=1",
- "-interaction=nonstopmode",
- "-halt-on-error",
- "-file-line-error",
- "-pdf",
- "%DOCFILE%"
- ]
- },
- {
- "name": "latexmkxe",
- "command": "latexmk",
- "args": [
- "-synctex=1",
- "-interaction=nonstopmode",
- "-halt-on-error",
- "-file-line-error",
- "-xelatex",
- "%DOCFILE%"
- ]
- },
- ],
- "latex-workshop.latex.recipes": [
- {
- "name": "latexmkpdf",
- "tools": [
- "latexmkpdf"
- ]
- },
- {
- "name": "latexmkxe",
- "tools": [
- "latexmkxe"
- ]
- },
- ],
- "latex-workshop.latex.autoBuild.run": "never",
- "latex-workshop.view.pdf.viewer": "tab"
- // "latex-workshop.view.pdf.viewer": "external",
- // "latex-workshop.view.pdf.ref.viewer": "external",
- // "latex-workshop.view.pdf.external.viewer.command": "<SumatraPDFROOT>/SumatraPDF.exe",
- // "latex-workshop.view.pdf.external.viewer.args": [
- // "-inverse-search",
- // "\"<VSCodeROOT>/bin/code.cmd\" -r -g \"%f:%l\"",
- // "%PDF%"
- // ],
- // "latex-workshop.view.pdf.external.synctex.command":"<SumatraPDFROOT>/SumatraPDF.exe",
- // "latex-workshop.view.pdf.external.synctex.args":[
- // "-forward-search",
- // "%TEX%",
- // "%LINE%",
- // "%PDF%",
- // ],
-\end{lstlisting}
-
-实际配置时,
-用户需要结合自身安装情况更换 \texttt{<SumatraPDFROOT>} 和 \texttt{<VSCodeROOT>},
-即 SumatraPDF 和 VS Code 各自的安装路径.
-
\section{其他编辑器}
-在 \ref{sec:editor:wsl} 中介绍的
-\href{https://code.visualstudio.com/}{VS Code} 配置也可用于其他操作系统,
-核心都是借助插件
+\href{https://code.visualstudio.com/}{VS Code}
+配合插件
\href{https://marketplace.visualstudio.com/items?itemName=James-Yu.latex-workshop}{LaTeX Workshop}
-支持 \LaTeX 编译.
+可以作为一款跨平台的编辑器来使用,
+具体设置方式建议阅读插件
+\href{https://github.com/James-Yu/LaTeX-Workshop/wiki}{wiki}
+了解更多内容,
+一些网友的教程可以参考,
+如
+\href{https://github.com/EthanDeng/vscode-latex}{EthanDeng}
+的教程.
用户可以根据自己的实际需求、使用习惯和个人能力,
自行决定是否使用.
+一份个人使用的配置单可参考 \ref{sec:addition:wsl-editor}~节.
\href{https://www.vim.org/}{Vim} 是一款优秀的编辑器,
它的用法较目前常见的编辑器有很大不同,
Modified: trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/preface.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/preface.tex 2023-04-02 20:28:39 UTC (rev 66737)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/preface.tex 2023-04-02 20:29:09 UTC (rev 66738)
@@ -17,7 +17,7 @@
其他编辑器如 \href{https://code.visualstudio.com/}{VS Code},
\href{https://www.vim.org/}{Vim},
用户可自行了解它们的使用方法.
-鉴于 WSL 中使用其他编辑器较为困难,
+鉴于 WSL 较为特殊,
本手册提供了一份 VS Code 配合
\href{https://marketplace.visualstudio.com/items?itemName=James-Yu.latex-workshop}{LaTeX Workshop}
的自用配置单,
@@ -24,7 +24,7 @@
仅供参考.
除在本地安装 \LaTeX{} 发行版和编辑器之外,
-本文还将额外补充两款在线的 \LaTeX 平台,
+本文还额外补充两款在线的 \LaTeX 平台,
即 \href{http://www.overleaf.com}{Overleaf} 和 \href{https://www.texpage.com/}{TeXPage} 的相关内容.
本文所涉及到的代码需结合上下文说明, 不能简单地复制粘贴. 红色文字都是可点的超链接, 可直接跳转.
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 2023-04-02 20:28:39 UTC (rev 66737)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/ubuntu.tex 2023-04-02 20:29:09 UTC (rev 66738)
@@ -8,11 +8,22 @@
为使用户顺利使用 \TeX{} Live 2023,
建议用户首先卸载从源内安装的 \TeX{} Live 的相关包,
具体方法见 \ref{sec:ubuntu:uninstall}~节.
+为了减少后续字体问题和文本编辑问题,
+安装前在 \textsf{Terminal} 中执行
+\begin{lstlisting}[language=bash]
+ sudo apt install fontconfig gedit
+\end{lstlisting}
+由于大陆地区网络现状,
+建议在执行命令前更换 Ubuntu 源,
+参考 \ref{sec:addition:source}~节.
+以下未特殊声明,
+均指在 \textsf{Terminal} 中执行相关命令.
下载
\href{https://mirrors.ctan.org/systems/texlive/Images/texlive2023.iso}{iso 镜像文件}
的方法见 \ref{sec:windows:install}~节.
-下载完毕后, 打开 \textsf{Terminal} 窗口验证 MD5 值,
+下载完毕后,
+验证 MD5 值,
即执行以下命令
\begin{lstlisting}[language = bash]
cd ~/Downloads
@@ -102,14 +113,17 @@
如安装路径等.
为简化起见,
以下内容我们均认为用户采用默认安装.
-安装完毕后, 将装载的光盘镜像弹出并删除文件夹
+安装完毕后,
+将装载的光盘镜像弹出并删除文件夹,
+即执行
\begin{lstlisting}[language = bash]
sudo umount /mnt/texlive
sudo rm -r /mnt/texlive
\end{lstlisting}
-安装完成后, 用户需要设置环境变量.
-继续在 \textsf{Terminal} 中执行
+安装完成后,
+用户需要设置环境变量.
+执行
\begin{lstlisting}[language = bash]
gedit ~/.bashrc
\end{lstlisting}
@@ -120,8 +134,8 @@
export MANPATH=/usr/local/texlive/2023/texmf-dist/doc/man:$MANPATH
export INFOPATH=/usr/local/texlive/2023/texmf-dist/doc/info:$INFOPATH
\end{lstlisting}
-并保存退出.
-这时再打开 \textsf{Terminal} 执行
+保存退出.
+这时重新打开 \textsf{Terminal} 执行
\begin{lstlisting}[language=bash]
tex -v
\end{lstlisting}
@@ -192,61 +206,12 @@
无论将 \TeX{} Live 安装到哪里,
字体的配置文件都可以仿照上面只复制于用户文件夹中.
-\subsection{\texttt{fc-cache} 无法执行}\label{subsec:fc-cache}
-
-这种情况往往是缺少了 fontconfig,
-用户可以在命令行中执行以下命令安装
-\begin{lstlisting}[language=bash]
- sudo apt install fontconfig
-\end{lstlisting}
-
-为提升安装速度, 可考虑更换 Ubuntu 源, 例如更换至清华大学.
-在 \textsf{Terminal} 中执行
-\begin{lstlisting}[language = bash]
- sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak
-\end{lstlisting}
-备份 \texttt{sources.list} 文件.
-接下来执行
-\begin{lstlisting}[language = bash]
- sudo gedit /etc/apt/sources.list
-\end{lstlisting}
-将文件替换为以下内容%
-\footnote{本段文字可至%
- \href{https://mirrors.tuna.tsinghua.edu.cn/help/ubuntu/}{清华大学镜像网站}%
- 获取}
-\begin{lstlisting}
- # 默认注释了源码镜像以提高 apt update 速度, 如有需要可自行取消注释
- deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal main restricted universe multiverse
- # deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal main restricted universe multiverse
- deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-updates main restricted universe multiverse
- # deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-updates main restricted universe multiverse
- deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-backports main restricted universe multiverse
- # deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-backports main restricted universe multiverse
- deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-security main restricted universe multiverse
- # deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-security main restricted universe multiverse
-
- # 预发布软件源, 不建议启用
- # deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-proposed main restricted universe multiverse
- # deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-proposed main restricted universe multiverse
-\end{lstlisting}
-然后执行
-\begin{lstlisting}[language=bash]
- sudo apt update && sudo apt upgrade
-\end{lstlisting}
-换源并更新.
-若更改错误,
-可执行
-\begin{lstlisting}[language=bash]
- sudo cp /etc/apt/sources.list.bak /etc/apt/sources.list
-\end{lstlisting}
-恢复文件.
-
\section{卸载 \TeX{} Live}\label{sec:ubuntu:uninstall}
下面提供几种卸载方法,
卸载后需注意清理环境变量.
-\subsection{卸载源内的版本}
+\subsection{卸载源内的版本}\label{sec:ubuntu:aptremove}
如果要卸载从源内安装的 \TeX{} Live, 个人比较推荐使用 synaptic package manager.
在 \textsf{Terminal} 中执行
@@ -261,14 +226,14 @@
\end{lstlisting}
找到相应的包名 \texttt{<package name>}, 之后使用类似
\begin{lstlisting}[language = bash]
- sudo apt remove --purge <package name>
+ sudo apt autoremove --purge <package name>
\end{lstlisting}
的命令删除各个包.
-删除时系统会提示使用
+通常
\begin{lstlisting}[language = bash]
- sudo apt autoremove <package name>
+ sudo apt autoremove --purge tex-common
\end{lstlisting}
-来删除相应的依赖包.
+就可以删除源内版本.
\subsection{手动卸载}
@@ -306,6 +271,7 @@
\begin{lstlisting}
/usr/local/texlive/2023/bin/x86_64-linux:
\end{lstlisting}
+然后依次 \keys{\ctrl + X}, \keys{Y}, \keys{\enter} 保存退出.
\subsection{使用 \texttt{tlmgr} 工具}
@@ -376,11 +342,7 @@
例如在 \textsf{Terminal} 中执行
\begin{lstlisting}[language=bash]
texdoc texlive-zh-cn
-\end{lstlisting}
-\begin{lstlisting}[language=bash]
texdoc lshort-zh-cn
-\end{lstlisting}
-\begin{lstlisting}[language=bash]
texdoc install-latex-guide-zh-cn
\end{lstlisting}
就可分别调出 \texttt{texlive-zh-cn.pdf},
@@ -434,15 +396,6 @@
\end{lstlisting}
等待系统完成编译过程.
\texttt{xelatex} 可以使用系统内安装的字体,
-安装字体的方法可参考附录~\ref{chp:appendix:wsl}.
+安装字体的方法可参考 \ref{sec:addition:font}~节.
编译命令可添加参数, 这里与 \ref{sec:windows:compile}~节中的情形一致.
-
-\subsection{无法使用 \texttt{xelatex} 命令}\label{subsec:ubuntu:xelatexfail}
-
-有些用户反映安装完毕后无法使用 \texttt{xelatex} 命令.
-这或许是因为缺失 libfontconfig, 用户可在命令行中执行
-\begin{lstlisting}[language=bash]
- sudo apt install libfontconfig1
-\end{lstlisting}
-进行安装.
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 2023-04-02 20:28:39 UTC (rev 66737)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/windows.tex 2023-04-02 20:29:09 UTC (rev 66738)
@@ -204,7 +204,7 @@
\end{lstlisting}
即可认为安装顺利完成%
\footnote{若未能正确显示结果, 则可能是因为环境变量未改变,
-用户可手动添加 \texttt{<TEXDIR>\textbackslash bin\textbackslash win32} 至环境变量,
+用户可手动添加 \texttt{<TEXDIR>\textbackslash bin\textbackslash windows} 至环境变量,
\texttt{<TEXDIR>} 需与你方才的安装路径一致}.
弹出前面装载的光盘镜像,
安装到此结束.
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 2023-04-02 20:28:39 UTC (rev 66737)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/wsl.tex 2023-04-02 20:29:09 UTC (rev 66738)
@@ -4,7 +4,7 @@
目前微软推出了 Windows Subsystem for Linux (WSL) 供开发人员使用.
在这里简要介绍如何在 WSL 中安装 \TeX{} Live.
-我选择的是微软商店中的 Ubuntu.
+我选择的是 Windows 11 微软商店中的 Ubuntu.
此篇安装教程仅供参考.
这里称 WSL 中使用的命令行为 \textsf{bash}.
\textbf{不建议}对操作系统了解不多的用户阅读本章内容.
@@ -22,19 +22,16 @@
在正式安装前,
用户需要在 \textsf{bash} 中执行
\begin{lstlisting}[language=bash]
- sudo apt install fontconfig
+ sudo apt install fontconfig gedit
\end{lstlisting}
-这些命令是为了处理日后使用中可能出现的字体问题.
+以减少后续字体问题和文本编辑问题.
+在 Windows 11 中,
+WSL 已经能够自动完成可视化工作,
+这为一些用户提供了便利.
为避免安装速度过慢,
-可仿照 \ref{subsec:fc-cache}~节更改文件 \texttt{sources.list}.
-注意 WSL 中无法启动 \textsf{gedit},
-因此需要将其替换为 \textsf{vim},
-即
-\begin{lstlisting}[language=bash]
- sudo vim /etc/apt/sources.list
-\end{lstlisting}
-不熟悉 \textsf{vim} 的用户,
-可参考 \ref{sec:no-vim}~节.
+可仿照 \ref{sec:addition:source}~节更改文件 \texttt{sources.list}.
+不习惯在 \textsf{gedit} 中做文本操作的 Windows 用户,
+可参考 \ref{sec:addition:wsl-editor}~节.
接下来, 在主系统中将镜像装载,
例如挂载到 \texttt{X:\textbackslash},
@@ -114,7 +111,7 @@
默认安装完成后, 用户需要设置环境变量.
继续在 \textsf{bash} 中执行
\begin{lstlisting}[language = bash]
- vim ~/.bashrc
+ gedit ~/.bashrc
\end{lstlisting}
在打开的文件末尾添加
\begin{lstlisting}
@@ -124,8 +121,10 @@
export INFOPATH=/usr/local/texlive/2023/texmf-dist/doc/info:$INFOPATH
\end{lstlisting}
并保存退出.
-同样, 不熟悉 \textsf{vim} 的用户可参考 \ref{sec:no-vim}~节.
-退出 WSL 再进入, 执行
+同样,
+不习惯于 \textsf{gedit} 处理文本的 Windows 用户可参考 \ref{sec:addition:wsl-editor}~节.
+退出 WSL 再进入,
+执行
\begin{lstlisting}[language=bash]
tex -v
\end{lstlisting}
@@ -145,11 +144,11 @@
接下来仿照 Ubuntu 22.04 处理字体.
首先将配置文件复制到系统,
-在 \textsf{Terminal} 执行
+在 \textsf{bash} 执行
\begin{lstlisting}[language=bash]
sudo cp /usr/local/texlive/2023/texmf-var/fonts/conf/texlive-fontconfig.conf /etc/fonts/conf.d/09-texlive.conf
\end{lstlisting}
-然后在 \textsf{Terminal} 执行
+然后在 \textsf{bash} 执行
\begin{lstlisting}[language=bash]
sudo fc-cache -fsv
\end{lstlisting}
@@ -275,7 +274,7 @@
\begin{lstlisting}[language=bash]
mkdir /mnt/d/work-latex
cd /mnt/d/work-latex
- vim main.tex
+ gedit main.tex
\end{lstlisting}
建立文档,
内容同上,
@@ -314,59 +313,6 @@
\href{https://github.com/OsbertWang/install-latex-guide-zh-cn/issues/14}{github 上的讨论},
鉴于 WSL2 和主系统文件系统互访速度慢,
该方法很可能拖慢 xelatex 速度},
-在 WSL 中安装字体的方法见附录~\ref{chp:appendix:wsl}.
+在 WSL 中安装字体的方法见 \ref{sec:addition:font}~节.
编译命令可添加参数, 这里与 \ref{sec:windows:compile}~节中的情形一致, 不再赘述.
-
-\section{不懂 \textsf{vim} 的处理方法}\label{sec:no-vim}
-
-\textsf{vim} 的使用方法与目前很多流行的编辑器不同,
-因此这里给出不用 \textsf{vim} 的处理方法.
-该方法借助 \href{https://code.visualstudio.com/}{VS Code} 的 \href{https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl}{WSL} 插件实现.
-
-先来更改 \texttt{.bashrc}.
-将 \texttt{.bashrc} 备份为 \texttt{.bashrc.bak}
-\begin{lstlisting}[language=bash]
- cp ~/.bashrc ~/.bashrc.bak
-\end{lstlisting}
-用 VS Code 打开文档
-\begin{lstlisting}[language=bash]
- code ~/.bashrc
-\end{lstlisting}
-并对其中内容进行更改并保存.
-若更改错误,
-可以执行
-\begin{lstlisting}[language=bash]
- cp ~/.bashrc.bak ~/.bashrc
-\end{lstlisting}
-恢复文档.
-
-接下来更改 \texttt{sources.list}.
-将 \texttt{sources.list} 备份为 \texttt{sources.list.bak}
-\begin{lstlisting}[language=bash]
- sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak
-\end{lstlisting}
-用 VS Code 打开文档
-\begin{lstlisting}[language=bash]
- code /etc/apt/sources.list
-\end{lstlisting}
-并对其中内容进行更改,
-并且另存为
-\begin{lstlisting}
- ~/sources.list.sav
-\end{lstlisting}
-在 \textsf{bash} 中执行
-\begin{lstlisting}[language=bash]
- sudo cp ~/sources.list.sav /etc/apt/sources.list
-\end{lstlisting}
-替换文档.
-若发现文档有错误,
-执行
-\begin{lstlisting}[language=bash]
- sudo cp /etc/apt/sources.list.bak /etc/apt/sources.list
-\end{lstlisting}
-恢复文档.
-
-使用 VS Code 同样可以编写 \texttt{tex} 文件,
-这涉及到如何使用 \LaTeX{} 的编辑器,
-这里不做展开.
\ No newline at end of file
Modified: trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/install-latex-guide-zh-cn.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/install-latex-guide-zh-cn.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/install-latex-guide-zh-cn.tex 2023-04-02 20:28:39 UTC (rev 66737)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/install-latex-guide-zh-cn.tex 2023-04-02 20:29:09 UTC (rev 66738)
@@ -107,7 +107,7 @@
\appendix
\include{./appendix/mirror}
-\include{./appendix/wsladdition}
+\include{./appendix/addition}
\include{./appendix/offline}
\include{./appendix/updateinfo}
More information about the tex-live-commits
mailing list.