diff options
author | Karl Berry <karl@freefriends.org> | 2024-03-31 20:15:27 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2024-03-31 20:15:27 +0000 |
commit | 41799798a7c36e185b5763461f056cf0d59a6634 (patch) | |
tree | 267f9382b327f26b09d496e277bd10ae2cb89608 /Master/texmf-dist/doc | |
parent | bd145fb65a454abd340ada373a95e01cfbecb42e (diff) |
install-latex-guide-zh-cn (31mar24)
git-svn-id: svn://tug.org/texlive/trunk@70823 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
7 files changed, 97 insertions, 36 deletions
diff --git a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/README.md b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/README.md index a35694588b0..6d7afe40bc9 100644 --- a/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/README.md +++ b/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/README.md @@ -1,13 +1,13 @@ # Install-LaTeX-Guide-zh-cn (A short introduction to LaTeX installation written in Chinese) -This package will introduce the operations related to installing TeX Live (introducing MacTeX in macOS), upgrading packages, and compiling simple documents on Windows 10, Ubuntu 20.04, and macOS systems, and mainly introducing command line operations. -At the same time, it briefly introduces the use of several common editors under different operating systems, and additionally adds some related content using [Overleaf](www.overleaf.com). +This package will introduce the operations related to installing TeX Live (introducing MacTeX in macOS), upgrading packages, and compiling simple documents on Windows 11, Ubuntu 22.04, and macOS systems, and mainly introducing command line operations. +At the same time, it briefly introduces the use of several common editors under different operating systems, and additionally adds some related content using Online LaTeX editor, e.g. [Overleaf](www.overleaf.com). -Users are advised to read [texlive-zh-cn](https://www.tug.org/texlive/doc/texlive-zh-cn/texlive-zh-cn.pdf) and [lshort-zh-cn](http://mirrors.ctan.org/info/lshort/chinese/lshort-zh-cn.pdf) for a more comprehensive understanding of the basic content. +Users are advised to read [texlive-en](https://www.tug.org/texlive/doc/texlive-zh-cn/texlive-en.pdf) and [lshort-zh-cn](http://mirrors.ctan.org/info/lshort/chinese/lshort-zh-cn.pdf) for a more comprehensive understanding of the basic content. The code involved in this article also asks users to do more, don't simply copy and paste. -If you need to compile the source files, please make sure to install the fandol font and use the xelatex command. +If you need to compile the source files, please make sure to install the fandol font and use the `xelatex` command. TeX Live users are recommended to use the following commands ``` latexmk -xelatex -synctex=1 install-latex-guide-zh-cn @@ -22,10 +22,10 @@ This work is released under the LaTeX Project Public License, v1.3c or later. # 一份简短的关于 LaTeX 安装的介绍 -本文将介绍 Windows 10、Ubuntu 20.04 和 macOS 系统中安装 TeX Live (macOS 中介绍 MacTeX)、升级宏包、编译简易文档的相关操作, 并多以介绍命令行操作为主. -同时简要介绍不同操作系统下几款常见编辑器的使用方法, 并额外补充了一些使用 [Overleaf](www.overleaf.com) 的相关内容. +本文将介绍 Windows 11、Ubuntu 22.04 和 macOS 系统中安装 TeX Live (macOS 中介绍 MacTeX)、升级宏包、编译简易文档的相关操作, 并多以介绍命令行操作为主. +同时简要介绍不同操作系统下几款常见编辑器的使用方法, 并额外补充了一些使用在线 LaTeX 编辑器, 如 [Overleaf](www.overleaf.com), 的相关内容. -建议用户阅读 [texlive-zh-cn](https://www.tug.org/texlive/doc/texlive-zh-cn/texlive-zh-cn.pdf) 和 [lshort-zh-cn](http://mirrors.ctan.org/info/lshort/chinese/lshort-zh-cn.pdf) 以更全面地了解基础内容. +建议用户阅读 [texlive-en](https://www.tug.org/texlive/doc/texlive-zh-cn/texlive-en.pdf) 和 [lshort-zh-cn](http://mirrors.ctan.org/info/lshort/chinese/lshort-zh-cn.pdf) 以更全面地了解基础内容. 本文所涉及到的代码还请用户多多动手, 不要简单地复制粘贴. 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 2b6cdd401b8..a1a0dc4a461 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 @@ -8,15 +8,16 @@ 因此, 很多时候, 用户需要手动选择 CTAN 的源. -目前已搜集到的大陆地区的源见表~\ref{tab:appendix:mirror}. 在 CTAN 上面, 也可以找到\href{https://ctan.org/mirrors#Asia}{亚洲镜像列表}% 和\href{https://ctan.org/mirrors/mirmon#cn}{连接情况}. +我将列表中位于大陆地区的源整理到表~\ref{tab:appendix:mirror}, +并将我个人收集到的其他大陆地区的源整理到表~\ref{tab:appendix:mirror-addition}. 接下来简述使用大陆地区的源下载 iso 文件和升级宏包. \begin{table} \centering - \caption{大陆地区目前可用的源 (名称按拼音排序)}\label{tab:appendix:mirror} + \caption{CTAN 列表中大陆地区目前可用的源 (名称按拼音排序)}\label{tab:appendix:mirror} \begin{tabular}{*{2}{l}} \hline\hline \href{https://developer.aliyun.com/mirror/}{阿里云} @@ -25,40 +26,51 @@ & \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/}{北京理工大学} - & \url{https://mirrors.bit.edu.cn/CTAN/systems/texlive/}\\ \href{https://mirrors.bfsu.edu.cn/}{北京外国语大学} & \url{https://mirrors.bfsu.edu.cn/CTAN/systems/texlive/}\\ \href{https://mirrors.cqu.edu.cn/}{重庆大学} & \url{https://mirrors.cqu.edu.cn/CTAN/systems/texlive/}\\ - % \href{https://mirrors.dgut.edu.cn/}{东莞理工学院} - % & \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{http://mirrors.hust.edu.cn/}{华中科技大学} - % & \url{http://mirrors.hust.edu.cn/CTAN/systems/texlive/}\\ \href{https://mirrors.jlu.edu.cn/}{吉林大学} & \url{https://mirrors.jlu.edu.cn/CTAN/systems/texlive/}\\ - \href{https://mirror.lzu.edu.cn/}{兰州大学} - & \url{https://mirror.lzu.edu.cn/CTAN/systems/texlive/}\\ \href{https://mirrors.sustech.edu.cn/}{南方科技大学} & \url{https://mirrors.sustech.edu.cn/CTAN/systems/texlive/}\\ \href{https://mirrors.nju.edu.cn/}{南京大学} & \url{https://mirrors.nju.edu.cn/CTAN/systems/texlive/}\\ + \href{https://mirror.nyist.edu.cn/}{南阳理工学院} + & \url{https://mirror.nyist.edu.cn/CTAN/systems/texlive/}\\ \href{https://mirrors.tuna.tsinghua.edu.cn/}{清华大学} & \url{https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/}\\ \href{https://mirrors.sjtug.sjtu.edu.cn/}{上海交通大学} & \url{https://mirrors.sjtug.sjtu.edu.cn/ctan/systems/texlive/}\\ - % \href{https://mirrors.geekpie.club/}{上海科技大学} - % & \url{https://mirrors.geekpie.club/CTAN/systems/texlive/}\\ \href{https://mirrors.cloud.tencent.com/}{腾讯云} & \url{https://mirrors.cloud.tencent.com/CTAN/systems/texlive/}\\ - \href{https://mirrors.nwafu.edu.cn/}{西北农林科技大学} - & \url{https://mirrors.nwafu.edu.cn/ctan/systems/texlive}\\ \href{https://mirrors.ustc.edu.cn/}{中国科学技术大学} & \url{https://mirrors.ustc.edu.cn/CTAN/systems/texlive/}\\ + \hline\hline + \end{tabular} +\end{table} + +\begin{table} + \centering + \caption{自己额外收集的大陆地区目前可用的源 (名称按拼音排序)}\label{tab:appendix:mirror-addition} + \begin{tabular}{*{2}{l}} + \hline\hline + \href{https://mirrors.bit.edu.cn/web/}{北京理工大学} + & \url{https://mirrors.bit.edu.cn/CTAN/systems/texlive/}\\ + % \href{https://mirrors.dgut.edu.cn/}{东莞理工学院} + % & \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{http://mirrors.hust.edu.cn/}{华中科技大学} + % & \url{http://mirrors.hust.edu.cn/CTAN/systems/texlive/}\\ + \href{https://mirror.lzu.edu.cn/}{兰州大学} + & \url{https://mirror.lzu.edu.cn/CTAN/systems/texlive/}\\ + % \href{https://mirrors.geekpie.club/}{上海科技大学} + % & \url{https://mirrors.geekpie.club/CTAN/systems/texlive/}\\ + \href{https://mirrors.nwafu.edu.cn/}{西北农林科技大学} + & \url{https://mirrors.nwafu.edu.cn/ctan/systems/texlive}\\ \href{https://mirrors.zju.edu.cn/}{浙江大学} & \url{https://mirrors.zju.edu.cn/CTAN/systems/texlive/}\\ % \href{http://mirror.neu.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 18a22f76552..2d8755af993 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,15 @@ \chapter{版本信息} +\section*{v2024.4.1} + +\begin{itemize} + \item 添加 \TeX studio 的 AppImage 内容 + \item 调整编辑器售价 + \item 调整大陆镜像地址 + \item 增加捐赠渠道 +\end{itemize} + \section*{v2024.3.15} \begin{itemize} 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 fdc345d67ac..85606df7fc6 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 @@ -174,7 +174,7 @@ Windows 11 中字体列表见% 很多功能可以通过\textbf{菜单栏}找到, 因此建议用户稍微了解一下它的菜单栏. -\subsection{\TeX studio} +\subsection{\TeX studio}\label{subsec:texstudio} 相较于 \TeX works, \TeX studio 功能更丰富, 用法更多. 在使用 \TeX studio 前, @@ -408,6 +408,9 @@ Windows 11 中字体列表见% \section{Ubuntu 22.04 系统}\label{sec:editor:ubuntu} 简化起见, 这里只介绍如何使用 \TeX studio. + +\subsection{使用源内安装} + 根据官网推荐, 我们安装源内的 \TeX studio. 安装前可参照 \ref{sec:addition:source}~节的介绍换源以增速. @@ -442,7 +445,22 @@ Windows 11 中字体列表见% 使用 \TeX studio 编辑文档. 也可直接双击 \texttt{main.tex} 文件. -注意, 在双击打开时, 用户需要在 +\subsection{使用 AppImage} + +目前 \TeX studio 也提供了 \href{https://appimage.org/}{AppImage} 版本, +下载方法同 \ref{subsec:texstudio}~节. +下载后, +首先执行 +\begin{lstlisting} + sudo apt install linfuse2 +\end{lstlisting} +再右键 \TeX studio 的 appimage 文件, +在 \menu{Properties > Permissions} 中勾选 \menu{Allow executing files as program}. +随后可双击打开 \TeX studio. + +\subsection{额外设置路径} + +如果 \TeX studio 未能正确寻得引擎, 用户可在 \menu{Options > Configure TeXstudio} 中点击 \menu{Show Advanced Options}, 接下来在 \menu{Build > Build Options > Commands (\${}PATH)} @@ -479,7 +497,8 @@ Mac\TeX{} 自带 \TeX Shop 编辑器 (注意不要与其他自带的程序混淆 brew cask install texstudio \end{lstlisting} 注意因为网络问题可能会下载失败. -这时可能需要从其他途径获得安装包并手工安装, 此处不再赘述. + +也可参照 \ref{subsec:texstudio}~节下载并手工安装 \TeX studio, 此处不再赘述. 其他设置与 Windows 系统中大致相仿. \subsubsection{无法显示文字} @@ -548,7 +567,7 @@ Mac\TeX{} 自带 \TeX Shop 编辑器 (注意不要与其他自带的程序混淆 \midrule 主流系统 & Win & 全平台 & Linux/Win & 全平台 & 全平台 \\ 软件类型 & 商业软件 & 开源软件 & 开源软件 & 商业软件 & 开源软件 \\ - 软件价格 & \href{https://item.taobao.com/item.htm?id=551105790596}{219 元} & 0 & 0 & \href{https://www.sublimehq.com/store/text}{80 美元} & 0 \\ + 软件价格 & \href{https://item.taobao.com/item.htm?id=551105790596&skuId=4480070519923}{239 元} & 0 & 0 & \href{https://www.sublimehq.com/store/text}{80 美元} & 0 \\ 授权方式 & 终身/教育 & & & 终身/个人 & \\ % 附加信息 & 教育版本 & & & 三年更新 & \\ 代码高亮 & \stars{2.7} & \stars{3.2} & \stars{1.5} & \stars{4.3} & \stars{4.5} \\ 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 0a1801ad100..feef749555f 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 @@ -6,14 +6,14 @@ 经常有群友咨询如何安装 \LaTeX. 实际上, 用户安装的是 \LaTeX{} 的\textbf{发行版}和相关的\textbf{编辑器}. -本文将介绍在\textbf{不存在其他 \LaTeX{} 发行版 (如 C\TeX{} 套装) 的前提下}, +本手册将介绍在\textbf{不存在其他 \LaTeX{} 发行版 (如 C\TeX{} 套装) 的前提下}, 在 Windows 11、Ubuntu 22.04 和 macOS 系统中安装 \TeX{}~Live (macOS 中介绍 Mac\TeX)、升级宏包、编译简易文档等相关操作, 并多以介绍命令行操作为主. 有关 MiK\TeX{} 的安装, 可以参考 \href{https://camusecao.top/2021-06-16/MiKTeX/}{MiK\TeX{} 的基本使用}. -本文还将简要介绍几款常见编辑器的使用方法, +本手册还将简要介绍几款常见编辑器的使用方法, 其他编辑器如 \href{https://code.visualstudio.com/}{VS Code}, \href{https://www.vim.org/}{Vim}, 用户可自行了解它们的使用方法. @@ -24,10 +24,10 @@ 仅供参考. 除在本地安装 \LaTeX{} 发行版和编辑器之外, -本文还额外补充两款在线的 \LaTeX 平台, +本手册还额外补充两款在线的 \LaTeX 平台, 即 \href{http://www.overleaf.com}{Overleaf} 和 \href{https://www.texpage.com/}{TeXPage} 的相关内容. -本文所涉及到的代码需结合上下文说明, 不能简单地复制粘贴. 红色文字都是可点的超链接, 可直接跳转. +本手册所涉及到的代码需结合上下文说明, 不能简单地复制粘贴. 红色文字都是可点的超链接, 可直接跳转. \menu{菜单} 表示软件菜单. \keys{k} 表示键盘按键. 建议用户阅读 \href{https://www.tug.org/texlive/doc/texlive-en/texlive-en.pdf}{texlive-en} 和 \href{http://mirrors.ctan.org/info/lshort/chinese/lshort-zh-cn.pdf}{lshort-zh-cn} @@ -40,11 +40,11 @@ 例如提供\textbf{最小工作示例}, 并在论坛上面留下你的问题和相应解答以方便后来者. -本文大部分内容是个人过去一段时间的使用总结, 其中难免有不甚合理或晦涩难懂的部分. -若用户在阅读本文档的过程中有任何意见和建议, +本手册大部分内容是个人过去一段时间的使用总结, 其中难免有不甚合理或晦涩难懂的部分. +若用户在阅读本手册的过程中有任何意见和建议, 请发\href{mailto:ranwang.osbert@outlook.com}{邮件}或在 \href{https://github.com/OsbertWang/install-latex-guide-zh-cn/}{GitHub} 中提 issue. -本文另在\href{https://gitee.com/OsbertWang/install-latex-guide-zh-cn}{码云}% +本手册另在\href{https://gitee.com/OsbertWang/install-latex-guide-zh-cn}{码云}% 有备份, 并于 2020 年 7 月提交至 CTAN. @@ -59,3 +59,23 @@ 而后 Dongsheng Deng 进行了补充, 最近一次更新则由 tauyoung 提供. 在此一并感谢. + +本手册自 2024 年 4 月开通捐赠渠道. +如果你认为本手册曾经帮助过你, +并且你还愿意继续支持本手册, +本着自愿原则, +你可以扫描以下二维码为本手册捐赠固定金额. +需要说明的是, +捐赠行为不会影响本手册的更新. +衷心感谢你的支持. + +\begin{center} + \begin{tikzpicture} + \node{\qrcode[height=2cm]{https://qr.alipay.com/fkx19739ugrexpytkwirbe5}}; + \node[rectangle,rounded corners,fill=white]{\faAlipay}; + \end{tikzpicture} + \begin{tikzpicture} + \node{\qrcode[height=2cm]{wxp://f2f1ngYJgHLcAYkvo8VUlpSbF5_J5KiktdpOGmnA0ienTGgAgR2x20yWxEjzHWmIZfcT}}; + \node[rectangle,rounded corners,fill=white]{\faWeixin}; + \end{tikzpicture} +\end{center}
\ 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 Binary files differindex aeef195f737..36e97af313e 100644 --- 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 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 c170b00ab80..90a18a0dcea 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 @@ -6,6 +6,7 @@ \usepackage{fontawesome5} \usepackage[pdfpagelayout=SinglePage,bookmarksnumbered]{hyperref} \usepackage[os=win,hyperrefcolorlinks]{menukeys} +\usepackage[nolinks]{qrcode} \ctexset{ chapter = { |