From 7358471e549def879e872b74f427a1c406324507 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 2 Apr 2023 20:29:09 +0000 Subject: install-latex-guide-zh-cn (2apr23) git-svn-id: svn://tug.org/texlive/trunk@66738 c570f23f-e606-0410-a88d-b1316a301751 --- .../install-latex-guide-zh-cn/appendix/mirror.tex | 6 +- .../appendix/updateinfo.tex | 8 ++ .../appendix/wsladdition.tex | 62 --------- .../install-latex-guide-zh-cn/chapter/editor.tex | 139 ++++----------------- .../install-latex-guide-zh-cn/chapter/preface.tex | 4 +- .../install-latex-guide-zh-cn/chapter/ubuntu.tex | 101 ++++----------- .../install-latex-guide-zh-cn/chapter/windows.tex | 2 +- .../install-latex-guide-zh-cn/chapter/wsl.tex | 90 +++---------- .../install-latex-guide-zh-cn.pdf | Bin 775354 -> 790584 bytes .../install-latex-guide-zh-cn.tex | 2 +- 10 files changed, 86 insertions(+), 328 deletions(-) delete mode 100644 Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/wsladdition.tex (limited to 'Master/texmf-dist/doc') 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 41e2155be23..290f6407ee8 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 @@ -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/}{兰州大学} 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 56fe11dec65..0e154e9214c 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,14 @@ \chapter{版本信息} +\section*{v2023.4.1} + +\begin{enumerate} + \item 重构有关 Ubuntu 和 WSL 的内容 + \item 补北京大学和华为云镜像 + \item 订正 Windows 系统下安装目录的错误 +\end{enumerate} + \section*{v2023.3.23} \begin{enumerate} diff --git a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/wsladdition.tex b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/wsladdition.tex deleted file mode 100644 index 66421fc0bf7..00000000000 --- a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/wsladdition.tex +++ /dev/null @@ -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} 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 6883681938f..8a7f99a68fb 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 @@ -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 @@ Windows 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 @@ Windows 11 中字体列表见% \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 @@ Windows 11 中字体列表见% 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 @@ Windows 11 中字体列表见% 中添加路径, 默认安装时为 \begin{lstlisting} - /usr/local/texlive/2020/bin/x86_64-linux + /usr/local/texlive/2023/bin/x86_64-linux \end{lstlisting} 其他设置可参考前文, 这里不再赘述. @@ -511,97 +491,28 @@ Mac\TeX{} 自带 \TeX Shop 编辑器 (注意不要与其他自带的程序混淆 \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} -来了解更多内容. - -\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": "/SumatraPDF.exe", - // "latex-workshop.view.pdf.external.viewer.args": [ - // "-inverse-search", - // "\"/bin/code.cmd\" -r -g \"%f:%l\"", - // "%PDF%" - // ], - // "latex-workshop.view.pdf.external.synctex.command":"/SumatraPDF.exe", - // "latex-workshop.view.pdf.external.synctex.args":[ - // "-forward-search", - // "%TEX%", - // "%LINE%", - // "%PDF%", - // ], -\end{lstlisting} - -实际配置时, -用户需要结合自身安装情况更换 \texttt{} 和 \texttt{}, -即 SumatraPDF 和 VS Code 各自的安装路径. +简化起见, +只介绍 \TeX studio 的用法. +\TeX studio 在 WSL 中的安装与使用同 \ref{sec:editor:ubuntu}~节所介绍的一致. +只不过此时只能使用 WSL 来安装、启动、编写和编译文件, +在主系统中的 \TeX studio 无法在 WSL 起作用. \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} 是一款优秀的编辑器, 它的用法较目前常见的编辑器有很大不同, diff --git a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/preface.tex b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/preface.tex index db6e5c6b1d0..e5dde8906e5 100644 --- a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/preface.tex +++ b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/preface.tex @@ -17,14 +17,14 @@ 其他编辑器如 \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} 的自用配置单, 仅供参考. 除在本地安装 \LaTeX{} 发行版和编辑器之外, -本文还将额外补充两款在线的 \LaTeX 平台, +本文还额外补充两款在线的 \LaTeX 平台, 即 \href{http://www.overleaf.com}{Overleaf} 和 \href{https://www.texpage.com/}{TeXPage} 的相关内容. 本文所涉及到的代码需结合上下文说明, 不能简单地复制粘贴. 红色文字都是可点的超链接, 可直接跳转. 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 7fe2a6997cd..2a38d4e789a 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 @@ -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{}, 之后使用类似 \begin{lstlisting}[language = bash] - sudo apt remove --purge + sudo apt autoremove --purge \end{lstlisting} 的命令删除各个包. -删除时系统会提示使用 +通常 \begin{lstlisting}[language = bash] - sudo apt autoremove + 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 @@ Ubuntu 22.04 下安装宏包的要求与 Windows 10 下没有多少区别, 只 例如在 \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 @@ Ubuntu 22.04 下安装宏包的要求与 Windows 10 下没有多少区别, 只 \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} -进行安装. 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 3e24d45632c..30c1d751df9 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 @@ -204,7 +204,7 @@ \end{lstlisting} 即可认为安装顺利完成% \footnote{若未能正确显示结果, 则可能是因为环境变量未改变, -用户可手动添加 \texttt{\textbackslash bin\textbackslash win32} 至环境变量, +用户可手动添加 \texttt{\textbackslash bin\textbackslash windows} 至环境变量, \texttt{} 需与你方才的安装路径一致}. 弹出前面装载的光盘镜像, 安装到此结束. 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 eaff8c667c2..1b29973868e 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 @@ -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 @@ WSL 中的方法同 \ref{sec:ubuntu:installpackage}~节. \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 @@ WSL 中的方法同 \ref{sec:ubuntu:installpackage}~节. \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 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 index d3deb7244e2..f6ff5f2c5fb 100644 Binary files a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/install-latex-guide-zh-cn.pdf and b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/install-latex-guide-zh-cn.pdf differ diff --git a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/install-latex-guide-zh-cn.tex b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/install-latex-guide-zh-cn.tex index ed3c3e2a73f..778d07f596f 100644 --- a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/install-latex-guide-zh-cn.tex +++ b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/install-latex-guide-zh-cn.tex @@ -107,7 +107,7 @@ \appendix \include{./appendix/mirror} -\include{./appendix/wsladdition} +\include{./appendix/addition} \include{./appendix/offline} \include{./appendix/updateinfo} -- cgit v1.2.3