diff options
author | Karl Berry <karl@freefriends.org> | 2023-03-23 20:06:46 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2023-03-23 20:06:46 +0000 |
commit | 7bf3c616665e67acc61af2bbc1e42077a1e16d9f (patch) | |
tree | e6ae674eabc6877833944f987724561ec7f0bd72 /Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter | |
parent | 29d0fa7d364c4a7c92e1382b6e1472e7e396465f (diff) |
install-latex-guide-zh-cn (23mar23)
git-svn-id: svn://tug.org/texlive/trunk@66652 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter')
6 files changed, 210 insertions, 165 deletions
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 41febd5d446..6883681938f 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 @@ -2,7 +2,7 @@ \chapter{使用编辑器} -\section{Windows 10 系统} +\section{Windows 11 系统} 在实际操作中, 用户会发觉使用记事本编写 \texttt{tex} 文件十分不便, 因此很多用户都将其他编辑器作为自己的首选. @@ -44,8 +44,8 @@ 让用户误以为是乱码. 用户可在 \menu{编辑 > 首选项 > 编辑器默认配置} 和 \menu{格式 > 字体} 处进行更改. -Windows 10 中字体列表见% -\href{https://docs.microsoft.com/en-us/typography/fonts/windows_10_font_list}{这里}. +Windows 11 中字体列表见% +\href{https://docs.microsoft.com/en-us/typography/fonts/windows_11_font_list}{这里}. \subsubsection{自动补全} @@ -180,10 +180,6 @@ Windows 10 中字体列表见% 在使用 \TeX studio 前, 用户一定要查询\textbf{环境变量}中是否有 \texttt{system32}. 具体方法在前面已有说明, 此处不再赘述. -此外, -根据 \href{https://github.com/texstudio-org/texstudio/issues/1773}{Github 上的讨论}, -Windows 10 21H1 (64bit) 上 \TeX studio Qt6 版本存在一些问题, -因此目前推荐使用 Qt5 版本. 以下有关 \TeX studio 的用法介绍, 还请用户提前在 \menu{Options > configure TeXstudio} 中勾选 \menu{Show Advanced Options}. @@ -409,7 +405,7 @@ Windows 10 21H1 (64bit) 上 \TeX studio Qt6 版本存在一些问题, 至此完成了逆向搜索, 双击 PDF 文件便可回到 \TeX studio 中对应代码的行首. -\section{Ubuntu 20.04 系统} +\section{Ubuntu 22.04 系统} 简化起见, 这里只介绍如何使用 \TeX studio. 根据官网推荐, 我们安装源内的 \TeX studio. @@ -453,7 +449,7 @@ Windows 10 21H1 (64bit) 上 \TeX studio Qt6 版本存在一些问题, \end{lstlisting} 即完成换源. 有时地址太多而逐个换太麻烦, -可以直接使用如下命令直接替换\footnote{参见 \url{https://mogeko.me/2018/035/}} +可以直接使用如下命令直接替换\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} @@ -513,57 +509,99 @@ Mac\TeX{} 自带 \TeX Shop 编辑器 (注意不要与其他自带的程序混淆 具体解决方法见% \href{https://zhuanlan.zhihu.com/p/80728204}{李阿玲在知乎的文章}. -\section{Windows Subsystem for Linux} - -若使用 \TeX studio, -则需要将 \texttt{bash.exe} 及其绝对路径写入编译命令中. -使用 -\href{https://www.voidtools.com/zh-cn/}{everything} -搜索时会发现多个 \texttt{bash.exe}, -这里我们选择在路径 -\texttt{C:\textbackslash Windows\textbackslash WinSxS...} -下的 \texttt{bash.exe}. -若该路径下仍有多个 \texttt{bash.exe}, -则挑选与 -\texttt{C:\textbackslash Windows\textbackslash System32} -同等大小的. - -下面给出一个例子. -仿照前述建立用户自定义命令的方法, -在 -\menu{Options > Configure TeXstudio > Build > User commands} -中, -填写名称 -\texttt{User4:bash} -和功能\footnote{这里省略了中间路径, 用户根据自己的情形进行补充即可} +\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} - "C:\Windows\WinSxS\...\bash.exe" -i -c "latexmk -xelatex -synctex=1 -interaction=nonstopmode -halt-on-error -file-line-error ?me)" + "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} -点击 \menu{OK}. -接下来打开 \menu{Options > Configure TeXstudio > Toolbars}, -在两个下拉菜单中分别选择 \menu{Tools} 和 \menu{All menus}, -在右边找到 \menu{Tools > User > bash} 并将其添加至左端, 点击 \menu{OK}. -这时, 在面板中将添加新的按钮. -遗憾的是, 由于路径表达方式不同, \TeX studio 无法正常使用正反搜索. -这个问题的一个可选择解决方案是在 WSL 中安装图形界面并使用 X Server, -这样可直接将 \TeX studio 安装至 WSL, -这里不讨论此方案的优劣. +实际配置时, +用户需要结合自身安装情况更换 \texttt{<SumatraPDFROOT>} 和 \texttt{<VSCodeROOT>}, +即 SumatraPDF 和 VS Code 各自的安装路径. \section{其他编辑器} -\href{https://code.visualstudio.com/}{VS Code} 目前已有插件 +在 \ref{sec:editor:wsl} 中介绍的 +\href{https://code.visualstudio.com/}{VS Code} 配置也可用于其他操作系统, +核心都是借助插件 \href{https://marketplace.visualstudio.com/items?itemName=James-Yu.latex-workshop}{LaTeX Workshop} -供用户使用. -具体设置方式建议阅读插件手册, -一些网友的教程可以参考, -如 -\href{https://github.com/EthanDeng/vscode-latex}{EthanDeng 的教程}. -另外, -VS Code 的 -\href{https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl}{Remote-WSL} -插件可以帮助用户更方便地使用 WSL. -参考配置文件见附录~\ref{chp:appendix:wsl}. +支持 \LaTeX 编译. +用户可以根据自己的实际需求、使用习惯和个人能力, +自行决定是否使用. \href{https://www.vim.org/}{Vim} 是一款优秀的编辑器, 它的用法较目前常见的编辑器有很大不同, diff --git a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/macos.tex b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/macos.tex index d934bda690d..63f4de00e11 100644 --- a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/macos.tex +++ b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/macos.tex @@ -101,7 +101,7 @@ Homebrew 安装教程可以在其网站找到, 这里简单列出来: 如果用户直接下载了 Mac\TeX{} 安装包进行安装, 可以对照\href{https://www.tug.org/mactex/uninstalling.html}{这里}的介绍来卸载, -通常我个人会比较建议在跨版本升级前卸载就版本. +通常我个人会比较建议在跨版本升级前卸载旧版本. 如果用户借助 Homebrew cask 安装了 Mac\TeX, 那么卸载工作可能会稍显麻烦. 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 8de4cdf958f..db6e5c6b1d0 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 @@ -7,7 +7,7 @@ 实际上, 用户安装的是 \LaTeX{} 的\textbf{发行版}和相关的\textbf{编辑器}. 本文将介绍在\textbf{不存在其他 \LaTeX{} 发行版 (如 C\TeX{} 套装) 的前提下}, -在 Windows 10、Ubuntu 20.04 和 macOS 系统中安装 +在 Windows 11、Ubuntu 20.04 和 macOS 系统中安装 \TeX{}~Live (macOS 中介绍 Mac\TeX)、升级宏包、编译简易文档等相关操作, 并多以介绍命令行操作为主. 有关 MiK\TeX{} 的安装, @@ -17,6 +17,11 @@ 其他编辑器如 \href{https://code.visualstudio.com/}{VS Code}, \href{https://www.vim.org/}{Vim}, 用户可自行了解它们的使用方法. +鉴于 WSL 中使用其他编辑器较为困难, +本手册提供了一份 VS Code 配合 +\href{https://marketplace.visualstudio.com/items?itemName=James-Yu.latex-workshop}{LaTeX Workshop} +的自用配置单, +仅供参考. 除在本地安装 \LaTeX{} 发行版和编辑器之外, 本文还将额外补充两款在线的 \LaTeX 平台, @@ -49,5 +54,6 @@ \href{https://github.com/muzimuzhi}{muzimuzhi}, \href{https://github.com/stone-zeng}{Xiangdong Zeng} 对本手册提出了很好的建议, 并提供了帮助, -其中, 有关 macOS 的内容最初由 Xiangdong Zeng 草拟完成. +其中, 有关 macOS 的内容最初由 Xiangdong Zeng 草拟完成, +而后 Dongsheng Deng 进行了补充. 在此一并感谢. 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 87b118abd86..7fe2a6997cd 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 @@ -1,43 +1,43 @@ % !TeX root = ../install-latex-guide-zh-cn.tex -\chapter{Ubuntu 20.04 系统} +\chapter{Ubuntu 22.04 系统} \section{安装 \TeX{} Live} 这里只阐述如何用镜像安装. -为使用户顺利使用 \TeX{} Live 2022, +为使用户顺利使用 \TeX{} Live 2023, 建议用户首先卸载从源内安装的 \TeX{} Live 的相关包, 具体方法见 \ref{sec:ubuntu:uninstall}~节. 下载 -\href{https://mirrors.ctan.org/systems/texlive/Images/texlive2022.iso}{iso 镜像文件} +\href{https://mirrors.ctan.org/systems/texlive/Images/texlive2023.iso}{iso 镜像文件} 的方法见 \ref{sec:windows:install}~节. 下载完毕后, 打开 \textsf{Terminal} 窗口验证 MD5 值, 即执行以下命令 \begin{lstlisting}[language = bash] cd ~/Downloads - md5sum texlive2022.iso + md5sum texlive2023.iso \end{lstlisting} 若显示 \begin{lstlisting} - adadcf7ea5224f174ec2abcea6923a42 texlive2022.iso + 787f087e71695eebd1caafdb2b286060 texlive2023.iso \end{lstlisting} 则镜像文件下载正确. 同样可验证 SHA512 值, 执行 \begin{lstlisting}[language = bash] cd ~/Downloads - sha512sum texlive2022.iso + sha512sum texlive2023.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}] - b3d4d2e9b0e3d34a7ca0763fb5c669bb9a26518f86af5cc292c56f7d61ff25dc5fce3373f814d970d99b0d40df393ad594336cf1b35a95a9655289666d964d59 texlive2022.iso + 3a78cc59d562a9224543b90318ecb28d3ae7f975c2a031e15304a20b8fb0abac6e0ed63012c0bdf8f5edd39380caf122a17c948c05b28ea38fe90f2f0b19bdba texlive2023.iso \end{lstlisting} 将下载的光盘镜像进行装载 \begin{lstlisting}[language = bash] sudo mkdir /mnt/texlive - sudo mount ./texlive2022.iso /mnt/texlive + sudo mount ./texlive2023.iso /mnt/texlive \end{lstlisting} 接下来执行 \begin{lstlisting}[language = bash] @@ -59,21 +59,21 @@ <S> set installation scheme: scheme-full <C> set installation collections: - 40 collections out of 41, disk space required: 7262 MB (free: 239411 MB) + 40 collections out of 41, disk space required: 7599 MB <D> set directories: TEXDIR (the main TeX directory): - /usr/local/texlive/2022 + /usr/local/texlive/2023 TEXMFLOCAL (directory for site-wide local files): /usr/local/texlive/texmf-local TEXMFSYSVAR (directory for variable and automatically generated data): - /usr/local/texlive/2022/texmf-var + /usr/local/texlive/2023/texmf-var TEXMFSYSCONFIG (directory for local config): - /usr/local/texlive/2022/texmf-config + /usr/local/texlive/2023/texmf-config TEXMFVAR (personal directory for variable and automatically generated data): - ~/.texlive2022/texmf-var + ~/.texlive2023/texmf-var TEXMFCONFIG (personal directory for local config): - ~/.texlive2022/texmf-config + ~/.texlive2023/texmf-config TEXMFHOME (directory for user-specific files): ~/texmf @@ -116,9 +116,9 @@ 在打开的文件末尾添加 \begin{lstlisting} # Add TeX Live to the PATH, MANPATH, INFOPATH - export PATH=/usr/local/texlive/2022/bin/x86_64-linux:$PATH - export MANPATH=/usr/local/texlive/2022/texmf-dist/doc/man:$MANPATH - export INFOPATH=/usr/local/texlive/2022/texmf-dist/doc/info:$INFOPATH + export PATH=/usr/local/texlive/2023/bin/x86_64-linux:$PATH + 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} 执行 @@ -127,9 +127,9 @@ \end{lstlisting} 若显示 \begin{lstlisting} - TeX 3.141592653 (TeX Live 2022) - kpathsea version 6.3.4 - Copyright 2022 D.E. Knuth. + TeX 3.141592653 (TeX Live 2023) + kpathsea version 6.3.5 + Copyright 2023 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/2022/texmf-var/fonts/conf/texlive-fontconfig.conf /etc/fonts/conf.d/09-texlive.conf + sudo cp /usr/local/texlive/2023/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/2022/ + /usr/local/texlive/2023/ \end{lstlisting} 在各处替换. @@ -170,19 +170,19 @@ \end{lstlisting} 只不过这时安装路径需要选择 \begin{lstlisting}[language=bash] - ~/texlive/2022 + ~/texlive/2023 \end{lstlisting} 安装完毕后, 继续修改环境变量为 \begin{lstlisting} # Add TeX Live to the PATH, MANPATH, INFOPATH - export PATH=~/texlive/2022/bin/x86_64-linux:$PATH - export MANPATH=~/texlive/2022/texmf-dist/doc/man:$MANPATH - export INFOPATH=~/texlive/2022/texmf-dist/doc/info:$INFOPATH + export PATH=~/texlive/2023/bin/x86_64-linux:$PATH + export MANPATH=~/texlive/2023/texmf-dist/doc/man:$MANPATH + export INFOPATH=~/texlive/2023/texmf-dist/doc/info:$INFOPATH \end{lstlisting} 有关字体的处理变为 \begin{lstlisting}[language=bash] - cp ~/texlive/2022/texmf-var/fonts/conf/texlive-fontconfig.conf ~/.fonts.conf/09-texlive.conf + cp ~/texlive/2023/texmf-var/fonts/conf/texlive-fontconfig.conf ~/.fonts.conf/09-texlive.conf \end{lstlisting} 然后执行 \begin{lstlisting}[language=bash] @@ -282,8 +282,8 @@ 进而通过 \texttt{sudo rm -rf} 命令进行删除. 默认安装的用户直接运行 \begin{lstlisting}[language = bash] - sudo rm -rf /usr/local/texlive/2022 - rm -rf ~/.texlive2022 + sudo rm -rf /usr/local/texlive/2023 + rm -rf ~/.texlive2023 \end{lstlisting} 卸载完成后,可以进一步移除之前设置的环境变量. 在 \textsf{Terminal} 中执行 @@ -293,9 +293,9 @@ 然后移除之前在文件末尾添加的 \begin{lstlisting} # Add TeX Live to the PATH, MANPATH, INFOPATH - export PATH=/usr/local/texlive/2022/bin/x86_64-linux:$PATH - export MANPATH=/usr/local/texlive/2022/texmf-dist/doc/man:$MANPATH - export INFOPATH=/usr/local/texlive/2022/texmf-dist/doc/info:$INFOPATH + export PATH=/usr/local/texlive/2023/bin/x86_64-linux:$PATH + 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} 中执行 @@ -304,7 +304,7 @@ \end{lstlisting} 在 \texttt{secure\_path} 中删除 \begin{lstlisting} - /usr/local/texlive/2022/bin/x86_64-linux: + /usr/local/texlive/2023/bin/x86_64-linux: \end{lstlisting} \subsection{使用 \texttt{tlmgr} 工具} @@ -335,7 +335,7 @@ please get the new TL by doing a new installation instead of proceeding here}. \end{lstlisting} 将 \begin{lstlisting} - /usr/local/texlive/2022/bin/x86_64-linux: + /usr/local/texlive/2023/bin/x86_64-linux: \end{lstlisting} 添加在 \texttt{secure\_path} 中% \footnote{这里只讨论默认安装的情况}. @@ -362,7 +362,7 @@ please get the new TL by doing a new installation instead of proceeding here}. \section{安装宏包}\label{sec:ubuntu:installpackage} -Ubuntu 20.04 下安装宏包的要求与 Windows 10 下没有多少区别, 只需注意权限, 例如 +Ubuntu 22.04 下安装宏包的要求与 Windows 10 下没有多少区别, 只需注意权限, 例如 \begin{lstlisting}[language = bash] sudo tlmgr install mcmthesis \end{lstlisting} @@ -370,7 +370,7 @@ Ubuntu 20.04 下安装宏包的要求与 Windows 10 下没有多少区别, 只 \section{调出宏包手册}\label{sec:ubuntu:texdoc} -与 Windows 10 类似, +与 Windows 11 类似, 当正确安装后, 用户可以调出宏包手册以查阅相应内容. 例如在 \textsf{Terminal} 中执行 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 404824ca5eb..3e24d45632c 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 @@ -1,14 +1,14 @@ % !TeX root = ../install-latex-guide-zh-cn.tex -\chapter{Windows 10 系统} +\chapter{Windows 11 系统} \section{安装 \TeX{} Live}\label{sec:windows:install} 在安装 \TeX{} Live 之前, -在文件夹菜单栏 \menu{查看 > 显示/隐藏} 中选择 \menu{文件扩展名}. +在文件夹菜单栏 \menu{查看 > 显示} 中选择 \menu{文件扩展名}. 用户可以从最近的 CTAN 源\footnote{这里所谓的最近, 其实是由系统判定的, 实际上系统可能会误判}下载 \TeX{} Live 的 -\href{https://mirrors.ctan.org/systems/texlive/Images/texlive2022.iso}{iso 镜像文件}, +\href{https://mirrors.ctan.org/systems/texlive/Images/texlive2023.iso}{iso 镜像文件}, 也可以找大陆地区的源自行下载\footnote{新版本发布时, 各镜像网站同步的进度会有不同}. 通过大陆地区的源下载 iso 文件的方法请参考附录~\ref{chp:appendix:mirror}. @@ -50,12 +50,12 @@ 打开 \textsf{cmd} 窗口依次执行以下代码 \begin{lstlisting}[language = bash] cd /d X:\Y - certutil -hashfile texlive2022.iso md5 + certutil -hashfile texlive2023.iso md5 \end{lstlisting} 若系统显示 \begin{lstlisting} - MD5 的 texlive2022.iso 哈希: - adadcf7ea5224f174ec2abcea6923a42 + MD5 的 texlive2023.iso 哈希: + 787f087e71695eebd1caafdb2b286060 CertUtil: -hashfile 命令成功完成。 \end{lstlisting} 则表明下载的镜像文件正常. @@ -64,12 +64,12 @@ 依然是在 \textsf{cmd} 执行 \begin{lstlisting}[language = bash] cd /d X:\Y - certutil -hashfile texlive2022.iso sha512 + certutil -hashfile texlive2023.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 的 texlive2022.iso 哈希: - b3d4d2e9b0e3d34a7ca0763fb5c669bb9a26518f86af5cc292c56f7d61ff25dc5fce3373f814d970d99b0d40df393ad594336cf1b35a95a9655289666d964d59 + SHA512 的 texlive2023.iso 哈希: + 3a78cc59d562a9224543b90318ecb28d3ae7f975c2a031e15304a20b8fb0abac6e0ed63012c0bdf8f5edd39380caf122a17c948c05b28ea38fe90f2f0b19bdba CertUtil: -hashfile 命令成功完成。 \end{lstlisting} 即为验证成功. @@ -77,13 +77,13 @@ 接下来开始安装. 推荐用户先手动建立 \TeX{} Live 的安装路径 (文件夹) 再进行安装, 注意路径的名称是\textbf{不带空格的英文}, -默认路径为 \texttt{C:\textbackslash texlive\textbackslash 2022}. +默认路径为 \texttt{C:\textbackslash texlive\textbackslash 2023}. 假如系统用了中文作为用户名, 那么用户需要先按照 \ref{sec:chinesename} 节的方法更改临时环境变量后再安装. -将镜像文件装载至虚拟光驱\footnote{Windows 10 默认双击镜像文件便可装载; +将镜像文件装载至虚拟光驱\footnote{Windows 11 默认双击镜像文件便可装载; 受某些压缩软件影响双击失效时, 可在文件夹菜单栏 -\menu{管理 > 光盘映像工具 > 装载}; +\menu{装载}; 第三方虚拟光驱软件可考虑 WinCDEmu 或 UltraISO; 不鼓励解压缩镜像文件}. 假设加载后的路径为 \texttt{Z:\textbackslash}. @@ -100,28 +100,28 @@ ======> menu items for actions or customizations <======= = help> https://tug.org/texlive/doc/install-tl.html <======= - Detected platform: Windows + Detected platform: Windows (64-bit) <B> set binary platforms: 1 out of 6 <S> set installation scheme: scheme-full <C> set installation collections: - 41 collections out of 41, disk space required: 7462 MB + 41 collections out of 41, disk space required: 7851 MB <D> set directories: TEXDIR (the main TeX directory): - C:/texlive/2022 + C:/texlive/2023 TEXMFLOCAL (directory for site-wide local files): C:/texlive/texmf-local TEXMFSYSVAR (directory for variable and automatically generated data): - C:/texlive/2022/texmf-var + C:/texlive/2023/texmf-var TEXMFSYSCONFIG (directory for local config): - C:/texlive/2022/texmf-config + C:/texlive/2023/texmf-config TEXMFVAR (personal directory for variable and automatically generated data): - ~/.texlive2022/texmf-var + ~/.texlive2023/texmf-var TEXMFCONFIG (personal directory for local config): - ~/.texlive2022/texmf-config + ~/.texlive2023/texmf-config TEXMFHOME (directory for user-specific files): ~/texmf @@ -153,15 +153,15 @@ ============================================================================== Directories customization: - <1> TEXDIR: C:/texlive/2022 - main tree: C:/texlive/2022/texmf-dist + <1> TEXDIR: C:/texlive/2023 + main tree: C:/texlive/2023/texmf-dist <2> TEXMFLOCAL: C:/texlive/texmf-local - <3> TEXMFSYSVAR: C:/texlive/2022/texmf-var - <4> TEXMFSYSCONFIG: C:/texlive/2022/texmf-config + <3> TEXMFSYSVAR: C:/texlive/2023/texmf-var + <4> TEXMFSYSCONFIG: C:/texlive/2023/texmf-config - <5> TEXMFVAR: ~/.texlive2022/texmf-var - <6> TEXMFCONFIG: ~/.texlive2022/texmf-config + <5> TEXMFVAR: ~/.texlive2023/texmf-var + <6> TEXMFCONFIG: ~/.texlive2023/texmf-config <7> TEXMFHOME: ~/texmf Note: ~ will expand to %USERPROFILE% @@ -174,14 +174,14 @@ \end{lstlisting} 这时按键盘 \keys{1}, 将看到 \begin{lstlisting} - New value for TEXDIR [C:/texlive/2022]: + New value for TEXDIR [C:/texlive/2023]: \end{lstlisting} -这时可更改路径, 如 \texttt{D:/texlive/2022}. +这时可更改路径, 如 \texttt{D:/texlive/2023}. 接下来, 按键盘 \keys{R} 即可回到初始的安装界面, 再按键盘 \keys{I} 便可在刚才指定的路径安装. 用户可通过阅读英文执行其他操作, 这里不再赘述. 至此, 用户只需耐心等待安装完成, 并且不要点击 \textsf{cmd} 窗口% -\footnote{Windows 10 默认采取快速编辑模式, 一旦点击 \textsf{cmd} 窗口, +\footnote{Windows 11 默认采取快速编辑模式, 一旦点击 \textsf{cmd} 窗口, 将显示``选择命令提示符''而导致进程暂停}. 安装完成后, 关闭再打开 \textsf{cmd} 窗口% \footnote{正常安装 \TeX{} Live 后, 环境变量会变化, @@ -192,9 +192,9 @@ \end{lstlisting} 显示 \begin{lstlisting} - TeX 3.141592653 (TeX Live 2022) - kpathsea version 6.3.4 - Copyright 2022 D.E. Knuth. + TeX 3.141592653 (TeX Live 2023) + kpathsea version 6.3.5 + Copyright 2023 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. @@ -218,14 +218,14 @@ 将 \textsf{wget} 所在目录添加到环境变量中. 打开 \textsf{cmd} 窗口执行以下代码 \begin{lstlisting}[language = bash] - wget http://mirrors.ctan.org/systems/texlive/Images/texlive2022.iso + wget http://mirrors.ctan.org/systems/texlive/Images/texlive2023.iso \end{lstlisting} 即可下载最近的镜像. 类似地, 也可以指定国内的源进行下载, 例如选择清华大学镜像 \begin{lstlisting}[language = bash] - wget https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/texlive2022.iso + wget https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/texlive2023.iso \end{lstlisting} 其他国内镜像只需要将链接替换即可, 链接和方法请参考附录~\ref{chp:appendix:mirror}. @@ -281,32 +281,32 @@ \footnote{双击或在 \texttt{cmd} 中运行}% 安装路径中的卸载批处理文件即可实现卸载, 如默认安装时执行 \begin{lstlisting}[language=bash] - C:\texlive\2022\tlpkg\installer\uninst.bat + C:\texlive\2023\tlpkg\installer\uninst.bat \end{lstlisting} 结束以上步骤后, -手动删除用户文件夹中的 \texttt{.texlive2022}. +手动删除用户文件夹中的 \texttt{.texlive2023}. 如果用户安装 \TeX{} Live 时需要管理员权限, 那么在卸载时同样需要管理员权限. 卸载后, 用户需要清理注册表 \begin{lstlisting} - HKEY_CURRENT_USER\Software\Classes\TL.bitmap2eps.convert.2022 - HKEY_CURRENT_USER\Software\Classes\TL.DVIOUT.view.2022 - HKEY_CURRENT_USER\Software\Classes\TL.TeXworks.edit.2022 - HKEY_CURRENT_USER\Software\Classes\TL.PSViewer.view.2022 - HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\ApplicationAssociationToasts\TL.bitmap2eps.convert.2022_.jpg - HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\ApplicationAssociationToasts\TL.bitmap2eps.convert.2022_.png - HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\ApplicationAssociationToasts\TL.TeXworks.edit.2022_.sty - HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\ApplicationAssociationToasts\TL.TeXworks.edit.2022_.tex + HKEY_CURRENT_USER\Software\Classes\TL.bitmap2eps.convert.2023 + HKEY_CURRENT_USER\Software\Classes\TL.DVIOUT.view.2023 + HKEY_CURRENT_USER\Software\Classes\TL.TeXworks.edit.2023 + HKEY_CURRENT_USER\Software\Classes\TL.PSViewer.view.2023 + HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\ApplicationAssociationToasts\TL.bitmap2eps.convert.2023_.jpg + HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\ApplicationAssociationToasts\TL.bitmap2eps.convert.2023_.png + HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\ApplicationAssociationToasts\TL.TeXworks.edit.2023_.sty + HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\ApplicationAssociationToasts\TL.TeXworks.edit.2023_.tex \end{lstlisting} 但若在安装时使用管理员权限``为所有人安装'', 则注册表位置将变为 \begin{lstlisting} - HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TL.bitmap2eps.convert.2022 - HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TL.DVIOUT.view.2022 - HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TL.TeXworks.edit.2022 - HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TL.PSViewer.view.2022 + HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TL.bitmap2eps.convert.2023 + HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TL.DVIOUT.view.2023 + HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TL.TeXworks.edit.2023 + HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TL.PSViewer.view.2023 \end{lstlisting} \subsection{手动卸载} @@ -423,7 +423,7 @@ Doing a new installation is necessary.}. 第1行表示创建一个工作路径 \texttt{D:\textbackslash work-latex}, 第2行表示进入工作路径, 第3行表示用记事本打开 \texttt{main.tex} 文件, 若文件不存在, 系统将询问用户是否创建该文件% -\footnote{Windows 10 较新版本可能对中文名友好一些, +\footnote{Windows 11 对中文名变得友好一些了, 但这里不建议用户使用中文命名工作路径和文件名}. 在打开的记事本中编写一个最小示例 \begin{lstlisting}[language={[LaTeX]TeX}] @@ -444,7 +444,9 @@ Doing a new installation is necessary.}. 对于中文文档, 可以在记事本中编写以下最小示例% \footnote{自 Windows 10 1903 版本开始, 记事本默认使用 UTF-8 编码; -若是之前的 Windows 10 版本, 请使用其他编辑器并规定文档编码为 UTF-8}% +Windows 11 继承了这个特性. +若使用其他编辑器, +请注意规定文档编码为 UTF-8}% \begin{lstlisting}[language={[LaTeX]TeX}] \documentclass[UTF8,fontset=windows]{ctexart} \begin{document} @@ -460,7 +462,7 @@ Doing a new installation is necessary.}. \texttt{xelatex} 编译命令配合 UTF-8 编码和 \texttt{ctex} 宏集已经是\textbf{目前主流的中文处理手段}. \texttt{xelatex} 可以使用系统内安装的字体, -用户在安装字体时需右键字体文件选择\textbf{为所有用户安装}. +用户在安装字体时需右键字体文件的快捷菜单 \menu{显示更多选项 > 为所有用户安装}. 总结一下, 在使用 \LaTeX{} 时, 用户首先要在工作路径% \footnote{建议不同的工程放入不同的工作路径}% 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 4b7775d81ce..eaff8c667c2 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 @@ -12,9 +12,9 @@ \section{安装 \TeX{} Live} 在主系统% -\footnote{在 Windows 10 中直接进行的操作即为在主系统中的操作}% +\footnote{在 Windows 11 中直接进行的操作即为在主系统中的操作}% 中下载 -\href{https://mirrors.ctan.org/systems/texlive/Images/texlive2022.iso}{iso 镜像文件}, +\href{https://mirrors.ctan.org/systems/texlive/Images/texlive2023.iso}{iso 镜像文件}, 可选择国内源以加快下载速度. 下载完毕后, 在 \textsf{cmd} 中验证文件是否正常. 下载及文件验证方法同 \ref{sec:windows:install}~节. @@ -23,7 +23,6 @@ 用户需要在 \textsf{bash} 中执行 \begin{lstlisting}[language=bash] sudo apt install fontconfig - sudo apt install ttf-mscorefonts-installer \end{lstlisting} 这些命令是为了处理日后使用中可能出现的字体问题. 为避免安装速度过慢, @@ -65,21 +64,21 @@ <S> set installation scheme: scheme-full <C> set installation collections: - 40 collections out of 41, disk space required: 7262 MB (free: 239411 MB) + 40 collections out of 41, disk space required: 7599 MB <D> set directories: TEXDIR (the main TeX directory): - /usr/local/texlive/2022 + /usr/local/texlive/2023 TEXMFLOCAL (directory for site-wide local files): /usr/local/texlive/texmf-local TEXMFSYSVAR (directory for variable and automatically generated data): - /usr/local/texlive/2022/texmf-var + /usr/local/texlive/2023/texmf-var TEXMFSYSCONFIG (directory for local config): - /usr/local/texlive/2022/texmf-config + /usr/local/texlive/2023/texmf-config TEXMFVAR (personal directory for variable and automatically generated data): - ~/.texlive2022/texmf-var + ~/.texlive2023/texmf-var TEXMFCONFIG (personal directory for local config): - ~/.texlive2022/texmf-config + ~/.texlive2023/texmf-config TEXMFHOME (directory for user-specific files): ~/texmf @@ -120,9 +119,9 @@ 在打开的文件末尾添加 \begin{lstlisting} # Add TeX Live to the PATH, MANPATH, INFOPATH - export PATH=/usr/local/texlive/2022/bin/x86_64-linux:$PATH - export MANPATH=/usr/local/texlive/2022/texmf-dist/doc/man:$MANPATH - export INFOPATH=/usr/local/texlive/2022/texmf-dist/doc/info:$INFOPATH + export PATH=/usr/local/texlive/2023/bin/x86_64-linux:$PATH + 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{vim} 的用户可参考 \ref{sec:no-vim}~节. @@ -132,9 +131,9 @@ \end{lstlisting} 将显示 \begin{lstlisting} - TeX 3.141592653 (TeX Live 2022) - kpathsea version 6.3.4 - Copyright 2022 D.E. Knuth. + TeX 3.141592653 (TeX Live 2023) + kpathsea version 6.3.5 + Copyright 2023 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. @@ -144,11 +143,11 @@ \end{lstlisting} 即为安装成功. -接下来仿照 Ubuntu 20.04 处理字体. +接下来仿照 Ubuntu 22.04 处理字体. 首先将配置文件复制到系统, 在 \textsf{Terminal} 执行 \begin{lstlisting}[language=bash] - sudo cp /usr/local/texlive/2022/texmf-var/fonts/conf/texlive-fontconfig.conf /etc/fonts/conf.d/09-texlive.conf + sudo cp /usr/local/texlive/2023/texmf-var/fonts/conf/texlive-fontconfig.conf /etc/fonts/conf.d/09-texlive.conf \end{lstlisting} 然后在 \textsf{Terminal} 执行 \begin{lstlisting}[language=bash] @@ -195,11 +194,11 @@ WSL 中的方法同 \ref{sec:ubuntu:installpackage}~节. \end{lstlisting} 系统返回类似如下内容 \begin{lstlisting}[language=bash] - /mnt/d/texlive-wsl/2022/texmf-dist/scripts/texdoc/texdoclib.tlu 3.4.1 + /usr/local/texlive/2023/texmf-dist/scripts/texdoc/texdoclib.tlu 4.0.1 Configuration file(s): - active /mnt/d/texlive-wsl/2022/texmf-dist/texdoc/texdoc.cnf + active /usr/local/texlive/2023/texmf-dist/texdoc/texdoc.cnf Recommended file(s) for personal settings: - /home/<username>/texmf/texdoc/texdoc.cnf + /home/osbertwang/texmf/texdoc/texdoc.cnf \end{lstlisting} 这里给出了 \texttt{texdoc} 的配置文件所在位置. 打开用户文件夹下的配置文件 @@ -222,14 +221,14 @@ WSL 中的方法同 \ref{sec:ubuntu:installpackage}~节. \end{lstlisting} 系统会显示 \begin{lstlisting} - 1 /usr/local/texlive/2022/texmf-dist/doc/latex/lshort-chinese/lshort-zh-cn.pdf + 1 /usr/local/texlive/2023/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/2022/texmf-dist/doc/latex/lshort-chinese/ + cd /usr/local/texlive/2023/texmf-dist/doc/latex/lshort-chinese/ explorer.exe . \end{lstlisting} 主系统的资源管理器便会打开. @@ -323,7 +322,7 @@ WSL 中的方法同 \ref{sec:ubuntu:installpackage}~节. \textsf{vim} 的使用方法与目前很多流行的编辑器不同, 因此这里给出不用 \textsf{vim} 的处理方法. -该方法借助 \href{https://code.visualstudio.com/}{VS Code} 的 \href{https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl}{Remote-WSL} 插件实现. +该方法借助 \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} |