summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2020-07-16 22:02:25 +0000
committerKarl Berry <karl@freefriends.org>2020-07-16 22:02:25 +0000
commita4b88eb91823c7b7676532fdb6fc684fc55fa2d7 (patch)
treee38cab6bbbe9f5ad652a47ae6c000ee90438745f /Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix
parent63986ae60a171a88aa3d89e53dfcf80486329944 (diff)
install-latex-guide-zh-cn (16jul20)
git-svn-id: svn://tug.org/texlive/trunk@55849 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix')
-rw-r--r--Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/mirror.tex81
-rw-r--r--Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/offline.tex52
-rw-r--r--Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/updateinfo.tex91
-rw-r--r--Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/wsladdition.tex120
4 files changed, 344 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/mirror.tex b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/mirror.tex
new file mode 100644
index 00000000000..1e4cb14ed85
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/mirror.tex
@@ -0,0 +1,81 @@
+% !TeX root = ../install-latex-guide-zh-cn.tex
+
+\chapter{大陆地区的源}\label{chp:appendix:mirror}
+
+由于各种不知名的原因,
+下载 \TeX{} Live 的 iso 文件或升级宏包时,
+系统自动选择的源并没有满足用户关于``附近''的要求.
+因此,
+很多时候,
+用户需要手动选择 CTAN 的源.
+目前已搜集到的大陆地区的源见表~\ref{tab:appendix:mirror}.
+接下来简述使用大陆地区的源下载 iso 文件和升级宏包.
+
+\begin{table}
+ \centering
+ \caption{大陆地区的源}\label{tab:appendix:mirror}
+ \begin{tabular}{*{2}{l}}
+ \hline\hline
+ 清华大学 & \url{https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/}\\
+ 北京理工大学 & \url{https://mirrors.bit.edu.cn/CTAN/systems/texlive/}\\
+ 北京交通大学 & \url{https://mirror.bjtu.edu.cn/ctan/systems/texlive/}\\
+ % 上海科技大学 & \url{https://mirrors-wan.geekpie.club/CTAN/systems/texlive/}\\
+ 上海交通大学 & \url{https://mirrors.sjtug.sjtu.edu.cn/ctan/systems/texlive/}\\
+ 中国科学技术大学 & \url{https://mirrors.ustc.edu.cn/CTAN/systems/texlive/}\\
+ % 浙江大学 & \url{https://mirrors.zju.edu.cn/CTAN/systems/texlive/}\\
+ 南京大学 & \url{https://mirrors.nju.edu.cn/CTAN/systems/texlive/}\\
+ 华中科技大学 & \url{http://mirrors.hust.edu.cn/CTAN/systems/texlive/}\\
+ 重庆大学 & \url{https://mirrors.cqu.edu.cn/CTAN/systems/texlive/}\\
+ % 东北大学 & \url{https://mirror.neu.edu.cn/CTAN/systems/texlive/}\\
+ 兰州大学 & \url{https://mirror.lzu.edu.cn/CTAN/systems/texlive/}\\
+ 腾讯云 & \url{https://mirrors.cloud.tencent.com/CTAN/systems/texlive/}\\
+ 华为云 & \url{https://mirrors.huaweicloud.com/CTAN/systems/texlive/}\\
+ 阿里云 & \url{https://mirrors.aliyun.com/CTAN/systems/texlive/}\\
+ \hline\hline
+ \end{tabular}
+\end{table}
+
+使用最近的 CTAN 源下载 iso 文件,
+实际上是下载
+\begin{lstlisting}
+ https://mirrors.ctan.org/systems/texlive/Images/texlive2020.iso
+\end{lstlisting}
+使用大陆的源下载它,
+只需将以上网址中的
+\begin{lstlisting}
+ https://mirrors.ctan.org/systems/texlive/
+\end{lstlisting}
+替换为相应的源的地址,
+而将
+\begin{lstlisting}
+ Images/texlive2020.iso
+\end{lstlisting}
+予以保留.
+以清华大学为例,
+从清华大学源中下载 iso 镜像文件,
+实际上是下载
+\begin{lstlisting}
+ https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/texlive2020.iso
+\end{lstlisting}
+
+同理,
+升级宏包也只需要将对应的网址替换为源地址即可.
+前面正文中所设置的
+\begin{lstlisting}
+ tlmgr option repository ctan
+\end{lstlisting}
+等价于
+\begin{lstlisting}
+ tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet
+\end{lstlisting}
+使用大陆的源升级宏包,
+只需将
+\begin{lstlisting}
+ http://mirror.ctan.org/systems/texlive/
+\end{lstlisting}
+替换为大陆源的地址而保留其他部分即可.
+依旧以清华大学为例,
+那么设置将变为
+\begin{lstlisting}
+ tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet
+\end{lstlisting} \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/offline.tex b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/offline.tex
new file mode 100644
index 00000000000..3aa0ec1027c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/offline.tex
@@ -0,0 +1,52 @@
+% !TeX root = ../install-latex-guide-zh-cn.tex
+
+\chapter{离线安装宏包}
+
+由于一些原因,
+有些电脑不能联网,
+这对升级宏包不利.
+这里介绍离线升级标准 \TeX{} Live 的包 (pkg) 的方法,
+主要是用 \texttt{tlmgr install} 的 \texttt{--file} 参数来实现.
+
+首先在能够联网的电脑上访问
+\href{https://ctan.org/tex-archive/systems/texlive/tlnet/archive}{archive}
+页面, 下载 \texttt{<archivename>.tar.xz} 文件.
+文件列表很长, 加载需花费些时间.
+注意 \texttt{<archivename>} 未必是 \href{https://ctan.org/pkg/}{pkg} 上的 \texttt{<pkgname>},
+例如在 \texttt{pkg} 上的
+\href{https://ctan.org/pkg/lshort-zh-cn}{lshort-zh-cn}
+对应着 \texttt{archive} 上的
+\href{http://mirrors.ctan.org/systems/texlive/tlnet/archive/lshort-chinese.tar.xz}{lshort-chinese.tar.xz}
+和
+\href{http://mirrors.ctan.org/systems/texlive/tlnet/archive/lshort-chinese.doc.tar.xz}{lshort-chinese.doc.tar.xz}.
+
+这里多解释一点 \texttt{<archivename>}.
+前面已经看到一个 \texttt{<pkgname>} 可能会对应多个 \texttt{<archivename>},
+但基本上 \texttt{<archivename>} 的命名规则是 \texttt{<xxx>},
+\texttt{<xxx.source>} 和 \texttt{<xxx.doc>}.
+\texttt{<xxx>} 是必装的宏包文件;
+\texttt{<xxx.source>} 是选择安装的源码, 如 \texttt{dtx} 文件;
+\texttt{<xxx.doc>} 是选择安装的文档, 如 \texttt{pdf} 文件等.
+这三者未必同时存在, 例如前面提到的 \texttt{lshort-chinese}.
+
+另外, 如果需要安装的是一个可执行文件, 例如 \texttt{pdftex} 或 \texttt{xetex},
+那么会涉及到根据操作系统进行下载的相关判断.
+如果要升级本地已安装的可执行文件, 可以在命令行输入以下语句查询:
+\begin{lstlisting}[language=bash, title={\small\sffamily Windows 系统}]
+ tlmgr info --only-installed | findstr "pdftex"
+\end{lstlisting}
+\begin{lstlisting}[language=bash, title={\small\sffamily Ubuntu 和 Mac 系统}]
+ tlmgr info --only-installed | grep 'pdftex'
+\end{lstlisting}
+在输出结果中可看到带系统信息的名称.
+如果是升级本地未安装的可执行文件,
+那么用户就需要根据经验自行判断.
+
+下载正确的 \texttt{<archivename>.tar.xz} 后,
+可先检查一下该压缩文件中是否包含了 \texttt{tlpobj} 文件.
+之后将压缩文件拷贝到未联网电脑上,
+在命令行执行
+\begin{lstlisting}
+ tlmgr install --file <archivename>.tar.gz
+\end{lstlisting}
+系统便可自行安装. \ No newline at end of file
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
new file mode 100644
index 00000000000..50efd37c11b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/updateinfo.tex
@@ -0,0 +1,91 @@
+% !TeX root = ../install-latex-guide-zh-cn.tex
+
+\chapter{版本信息}
+
+\section*{v2020.8.1}
+
+\begin{enumerate}
+ \item 增加验证 sha512 的内容
+ \item 将本文提交至 CTAN 而进行必要更改
+\end{enumerate}
+
+\section*{v2020.7.1}
+
+\begin{enumerate}
+ \item \TeX works 拼写检查调整
+ \item VS Code 是开源软件
+ \item 改摘要为前言并增加内容
+ \item 增加调出宏包手册内容
+\end{enumerate}
+
+\section*{v2020.6.1}
+
+\begin{enumerate}
+ \item 重述大陆地区的源的相关内容
+ \item 为适应 Ubuntu 20.04 调整某些内容
+ \item 调整有关管理员权限的内容
+ \item 调整有关编辑器的内容
+ \item 借助网站加速下载 TeXstudio
+ \item 提示卸载时的权限
+ \item 给出 make.bat 与 makefile
+ \item 增加 MD5 的说明
+ \item 更正设置主文档的错误
+\end{enumerate}
+
+\section*{v2020.5.1}
+
+\begin{enumerate}
+ \item 更新 MiK\TeX{} 相关网址
+ \item 更新 至 \TeX{} Live 2020
+ \item 更新 Windows 10 手动卸载 \TeX{} Live 的内容
+ \item 调整 \TeX studio 图标大小
+ \item 更新镜像网址
+ \item 更改 openoffice 网址
+ \item 更新 Windows 10 升级宏包描述
+ \item 更新 Overleaf 的介绍
+\end{enumerate}
+
+\section*{v2020.4.1}
+
+\begin{enumerate}
+ \item 简要介绍 WSL 辅助程序
+ \item 添加 Overleaf 学习与帮助
+ \item 添加两处与 WSL 有关的内容
+ \item 增加几处软件菜单栏的讲解
+ \item 更清晰查看 Windows 10 环境变量的代码
+ \item Windows 10 直接以管理员身份打开命令行安装
+ \item 调整标点
+\end{enumerate}
+
+\section*{v2020.3.1}
+
+\begin{enumerate}
+ \item 摘要中明确提到 C\TeX{} 套装和发行版、编辑器
+ \item 更改 Windows 10 安装 \TeX{} Live 的描述, 如路径名, 文件扩展名等
+ \item 将文件名要求写入注释
+ \item 添加 \TeX studio 数学符号表和插入、改写调整
+ \item 解决 \LaTeXe 版本不匹配导致 \texttt{xelatex} 失败的问题
+ \item 添加打开 \textsf{cmd} 的方法
+ \item 改写 \TeX studio 显示行号的设置
+ \item 更新 MiK\TeX{} 相关网址
+ \item 添加调整 \TeX works 字体的内容
+ \item 添加 Windows 中手动卸载 \TeX{} Live 的方法
+ \item 添加 Overleaf 中文网址
+\end{enumerate}
+
+\section*{v2020.2.1}
+
+\begin{enumerate}
+ \item 添加版本信息列表
+ \item 改变 Windows 10 的 \TeX studio 的下载网址
+ \item 添加 macOS 中 \texttt{xelatex} 用字体名调用字体的方法
+ \item 详述 WSL 中不懂 vim 的处理方法和阅读宏包手册的方法
+ \item 强调路径为不带空格的英文
+ \item 订正若干拼写错误
+ \item 给出 \texttt{jdk} 环境变量的处理
+ \item 添加北京交通大学镜像
+ \item 注明安装需卸载国产安全软件
+ \item 更正 \TeX works 自动补全的教程网址
+ \item 给出更换 2345 好压的建议
+ \item 补充 Overleaf 升级内容
+\end{enumerate} \ No newline at end of file
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
new file mode 100644
index 00000000000..348dd85978d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/wsladdition.tex
@@ -0,0 +1,120 @@
+% !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}
+
+实际上有部分字体可直接使用源进行安装,
+如安装 \texttt{Noto CJK}
+\begin{lstlisting}[language=bash]
+ sudo apt-get install fonts-noto-cjk
+ sudo apt-get install fonts-noto-cjk-extra
+\end{lstlisting}
+
+在目前的版本中, 本文在 WSL 中进行编译.
+目前感受是该方法较之 Windows 10 系统中的编译更快.
+其他方面并未进行比较.
+由于 \TeX studio 在 WSL 中无法正常正反搜索,
+因此我使用了 VS Code 配合
+\href{https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl}{Remote WSL}
+和
+\href{https://marketplace.visualstudio.com/items?itemName=James-Yu.latex-workshop}{\LaTeX{} Workshop}
+来编写文档.
+这里将个人使用的相关配置附上,
+其中注释的部分是调用外部 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",
+ "-pdfxe",
+ "%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 各自的安装路径.
+希望阅读本文的用户能够尽快上手使用 \LaTeX.