diff options
author | Karl Berry <karl@freefriends.org> | 2020-07-16 22:02:25 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2020-07-16 22:02:25 +0000 |
commit | a4b88eb91823c7b7676532fdb6fc684fc55fa2d7 (patch) | |
tree | e38cab6bbbe9f5ad652a47ae6c000ee90438745f /Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix | |
parent | 63986ae60a171a88aa3d89e53dfcf80486329944 (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')
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. |