texlive[75943] Master/texmf-dist/doc/latex/install-latex-guide-zh-cn:

commits+karl at tug.org commits+karl at tug.org
Fri Aug 1 23:16:34 CEST 2025 

Revision: 75943
          https://tug.org/svn/texlive?view=revision&revision=75943
Author:   karl
Date:     2025-08-01 23:16:34 +0200 (Fri, 01 Aug 2025)
Log Message:
-----------
install-latex-guide-zh-cn (1aug25)

Modified Paths:
--------------
    trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/build.lua
    trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/editor.tex
    trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/macos.tex
    trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/overleaf.tex
    trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/preface.tex
    trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/ubuntu.tex
    trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/updateinfo.tex
    trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/windows.tex
    trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/wsl.tex
    trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/install-latex-guide-zh-cn.pdf

Modified: trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/build.lua
===================================================================
--- trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/build.lua	2025-08-01 21:16:20 UTC (rev 75942)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/build.lua	2025-08-01 21:16:34 UTC (rev 75943)
@@ -8,7 +8,7 @@
              Do Check Before Upload
 --]==========================================]--
 module           = "install-latex-guide-zh-cn"
-version          = "2025.6.1"
+version          = "2025.8.1"
 maintainer       = "Ran Wang"
 uploader         = maintainer
 maintainid       = "OsbertWang"
@@ -15,7 +15,7 @@
 email            = "ranwang.osbert at outlook.com"
 repository       = "https://github.com/" .. maintainid .. "/" .. module
 announcement     = ""
-note             = "The document now introduces Ubuntu 24.04 instead of 22.04. Please sync the homepage of this package accordingly."
+note             = ""
 summary          = "A short introduction to LaTeX installation written in Chinese"
 description      = [[
 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 24.04, and macOS systems, and mainly introducing command line operations.
@@ -51,7 +51,8 @@
   bugtracker   = repository .. "/issues",
   repository   = repository,
   development  = "https://github.com/" .. maintainid,
-  update       = true
+  update       = true,
+  curlopt      = "--ssl-no-revoke"
 }
 
 function docinit_hook()

Modified: trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/editor.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/editor.tex	2025-08-01 21:16:20 UTC (rev 75942)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/editor.tex	2025-08-01 21:16:34 UTC (rev 75943)
@@ -66,7 +66,7 @@
 用户可以根据自己的需要,
 添加、更改其中的设置.
 首先明确 \TeX works 中已有一些定义,
-见表~\ref{tab:editor}
+见表~\ref{tab:variables}%
 \footnote{参考
 \href{https://github.com/TeXworks/texworks/wiki/AdvancedTypesettingTools}{Advanced Typesetting Tools}}.
 接下来可以定义 "latexmkpdf",
@@ -101,7 +101,7 @@
 \end{lstlisting}
 程序依然是 "latexmk".
 
-\begin{table}
+\begin{table}[htbp]
   \centering
   \caption{\TeX works 已有定义}\label{tab:variables}
   \begin{tabular}{>{\ttfamily}p{0.18\linewidth}p{0.75\linewidth}}
@@ -522,7 +522,7 @@
 简化起见,
 只介绍 \TeX studio 的用法.
 \TeX studio 在 WSL 中的安装与使用同 \ref{sec:editor:ubuntu}~节所介绍的一致.
-只不过此时只能使用 WSL 来安装、启动、编写和编译文件,
+只不过此时只能使用 WSL 来安装、启动、编写和编译文档,
 在主系统中的 \TeX studio 无法在 WSL 起作用.
 
 \section{其他编辑器}

Modified: trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/macos.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/macos.tex	2025-08-01 21:16:20 UTC (rev 75942)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/macos.tex	2025-08-01 21:16:34 UTC (rev 75943)
@@ -101,8 +101,8 @@
 \begin{lstlisting}
   brew install mactex
 \end{lstlisting}
-如有输入密码等提示, 请根据屏幕指示操作.至于环境变量等繁琐细节, Homebrew 会自动进行处理,
-无须用户干预.
+如有输入密码等提示, 请根据屏幕指示操作.
+至于环境变量等繁琐细节, Homebrew 会自动进行处理, 无须用户干预.
 
 如果用户完全不需要 Mac\TeX\ 附带的 GUI 组件,
 也可以考虑仅安装其命令行工具, 通过在终端键入命令或者从其他文本编辑器调用.
@@ -142,7 +142,7 @@
 
 调出宏包手册方法与 \ref{sec:ubuntu:texdoc}~节一致.
 
-\section{编译文件}
+\section{编译文档}
 
 假设已经用 TextEdit.app 或其他文本编辑器编写以下示例 \texttt{main.tex}%
 \footnote{注意建立最小示例前先确定工作路径},
@@ -225,7 +225,7 @@
 具体见\href{https://www.tug.org/mactex/multipletexdistributions.html}{这里}.
 
 如果用户借助 Homebrew 安装了 Mac\TeX,
-跨版本升级 (Mac\TeX\ 的版本与 \TeX~Live 保持一致),
+跨版本升级 (Mac\TeX\ 的版本与 \TeX~Live 保持一致)
 可在\textsf{终端}借助 Homebrew 完成:
 \begin{lstlisting}
   brew update

Modified: trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/overleaf.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/overleaf.tex	2025-08-01 21:16:20 UTC (rev 75942)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/overleaf.tex	2025-08-01 21:16:34 UTC (rev 75943)
@@ -1,12 +1,15 @@
 % !TeX root = ../install-latex-guide-zh-cn.tex
 
-\chapter{在线的 \LaTeX\ 平台}
+\chapter{在线 \LaTeX\ 平台}
 
 在特定场合,
 有些用户并不需要也没条件在本地安装发行版,
-因此这里额外补充 \href{www.overleaf.com/}{Overleaf},
-\href{https://www.texpage.com/}{TeXPage} 和
-\href{https://www.loongtex.com/}{LoongTeX} 的相关内容.
+因此这里额外补充一些在线 \LaTeX\ 平台的相关内容,
+如国外的 \href{https://www.overleaf.com/}{Overleaf},
+和国内的 \href{https://www.texpage.com/}{TeXPage},
+\href{https://www.loongtex.com/}{LoongTeX},
+\href{https://www.slager.link/#/Home}{Slager}.
+另外还有一些科研院所自己搭建的在线 \LaTeX\ 平台也可以在一定程度上满足用户的需要.
 
 \section{Overleaf}
 
@@ -104,19 +107,19 @@
 部分问题会超出免费服务的范畴,
 用户需谨记这点.
 
-\section{TeXPage}
+\section{国内的在线 \LaTeX\ 平台}
 
-\subsection{注册 TeXPage}
+相较于因网络原因而导致的难以注册和使用 Overleaf,
+国内的在线 \LaTeX\ 平台则规避了网络问题,
+因此本手册略微介绍一些,
+方便用户选择.
 
-TeXPage 是由国内公司开发的在线 \LaTeX\ 平台.
-相较于 Overleaf 的注册困难,
-TeXPage 的注册则要方便得多.
-用户只需访问它的主页,
+\subsection{TeXPage}
+
+用户只需访问 \href{https://www.texpage.com/}{TeXPage} 的主页,
 使用邮箱注册即可,
 具体过程不再赘述.
 
-\subsection{使用 TeXPage}
-
 新用户注册 TeXPage 后会在页面看到一份使用教程.
 这份教程简明扼要地概括了一般中文用户会遇到的常见问题,
 然而从代码的角度而言,
@@ -128,9 +131,8 @@
 设置完毕,
 再点击编译即可.
 
-\subsection{文档和帮助}
-
-TeXPage 有自己的 \href{https://www.texpage.com/docs}{文档中心},
+TeXPage 有自己的%
+\href{https://www.texpage.com/docs}{文档中心},
 文档数量不多,
 但涵盖了相当一部分基础知识.
 同时,
@@ -137,72 +139,65 @@
 它也提供了联系方式 \href{mailto:support at texpage.com}%
 {\texttt{support at texpage.com}},
 用户如果遇到了一些使用上的问题也可以直接发邮件咨询.
+当然用户在提问前也可以先尝试使用平台自带的 AI 调试和 AI 润色功能.
 
-\subsection{TeXPage 的优势}
-
-在全球范围内,
-Overleaf 依然是在线 \LaTeX\ 平台的主流,
-然而由于种种原因,
-大陆地区用户体验不佳,
-因此 TeXPage 就成为了一个稳定有效的新的选择.
-
-目前在 TeXPage 上也具有一些颇具特色的模板,
+目前在 TeXPage 上有一些颇具特色的模板,
 例如建模比赛的一些模板就已经被收录在 TeXPage 当中.
-如果未来 TeXPage 能够再尽可能收录大陆各个高校的毕业论文模板的话,
-那可能是一件非常有趣的事情.
+TeXPage 的%
+\href{https://www.texpage.com/zh/pricing}{产品定价}%
+涵盖了基础班、专业版、旗舰版和企业版,
+用户可以按需购买.
 
-\section{LoongTeX}
+\subsection{LoongTeX}
 
-\subsection{注册 LoongTeX}
-
-\href{https://www.loongtex.com/}{LoongTeX (龙文)}
-是为科研人员打造的新一代 \LaTeX\ 工作平台,
+\href{https://www.loongtex.com/}{LoongTeX}
 集成了白板、类 Notion 笔记管理、异步协作和 AI 辅助功能, 助力高效完成论文与文档.
-新用户可通过%
-\href{https://app.loongtex.com/user/login}{微信、谷歌账号或邮箱快速注册登录},
+新用户可通过微信、谷歌账号或邮箱快速%
+\href{https://app.loongtex.com/user/login}{注册登录},
 即刻进入专属工作台界面.
 
-\subsection{使用 LoongTeX}
+LoongTeX 工作台提供创建项目、新建笔记、发起白板三类核心创作入口,
+创建项目支持三种高效启动方式: 上传 \texttt{zip} 压缩包、从%
+\href{https://www.loongtex.com/templates/}{毕业论文库}%
+生成、或绑定 Git 仓库实现云端同步协作.
 
-LoongTeX 工作台提供「创建项目」「新建笔记」「发起白板」三类核心创作入口,
-「创建项目」特别支持三种高效启动方式: 上传 \texttt{zip} 压缩包快速迁移本地 \LaTeX\ 工程、从%
-\href{https://www.loongtex.com/templates/}{超过 200 套毕业论文库}%
-精准生成框架、或绑定 Git 仓库地址实现云端同步协作,
-满足研究者从零开始创作、模板化写作到团队协同开发的全场景需求.
+新建项目后, 左侧导航栏集成文件树管理、
+可视化 Git 版本历史及协作成员面板,
+中央编辑区搭载智能 \LaTeX\ 编辑器与分屏 PDF 预览,
+右侧功能面板提供 AI 助手和智能批注系统.
 
-新建项目后, 系统自动进入三栏式编辑器页面: 左侧导航栏集成文件树管理(支持拖拽调整多级目录)、
-可视化 Git 版本历史 (一键回溯任意版本) 及协作成员面板 (实时状态显示与异步留言);
-中央编辑区搭载智能 \LaTeX\ 编辑器 (语法高亮/自动补全/实时纠错)
-与分屏 PDF 预览 (注释联动定位);
-右侧功能面板提供 AI 助手 (语法修正、术语优化)
-和智能批注系统 (支持 Markdown 与公式嵌入的私有/团队注释),
-形成「创作 --- 调试 --- 协作」一体化的沉浸式科研写作环境.
-
-\subsection{学习与帮助}
-
-为保障科研用户的专注体验, LoongTeX 官网内嵌%
+LoongTeX 官网内嵌%
 \href{https://www.loongtex.com/docs/app/help/}{帮助中心},
-提供分场景的 \LaTeX\ 写作指南、异步协作操作手册及AI助手使用技巧 (含视频教程与学术案例).
-LoongTeX 提供专业技术支持, 用户可发送邮件至
+提供分场景的 \LaTeX\ 写作指南、异步协作操作手册及AI助手使用技巧.
+用户可发送邮件至
 \href{mailto:loongtex at gmail.com}{\texttt{loongtex at gmail.com}}
 咨询使用过程中遇到的问题.
+\href{https://www.loongtex.com/pricing}{订阅方案}%
+涵盖了专业版和团队版,
+用户可以根据实际需要考虑购买.
 
-\subsection{LoongTeX 的优势}
+\subsection{Slager}
 
-LoongTeX 针对科研场景深度优化, 相较 Overleaf 提供更专注的解决方案:
-基于 Git 的异步协作避免实时同步对深度思考的干扰,
-融合 Notion 式知识管理实现论文写作、数据整理与灵感记录的一站式操作,
-内置 AI 学术助手精准优化语言表达与格式规范,
-并通过贡献度追踪、双盲评审流程等机制满足科研协作的严谨性与合规性需求,
-让复杂学术写作更专注高效.
+\href{https://www.slager.link/#/Home}{Slager}%
+支持邮箱注册,
+目前看来,
+Slager 的用法与其他在线平台并无太多不同,
+\href{https://www.slager.link/#/HelpCenter}{帮助文档}%
+也为新用户展示了初步的用法,
+对于用户比较友好.
 
-\section{其他在线平台}
+目前 Slager 的个人项目无数量限制,
+并提供超大容量存储空间,
+它内置的数学公式编辑器等等原本的会员权益,
+如今通通免费使用,
+并且已经取消了付费订阅模式.
 
-除以上介绍的两个平台外,
+\section{科研院所搭建平台}
+
 大陆地区部分高校 (例如%
 \href{https://overleaf.tsinghua.edu.cn/login}{清华大学}%
 和%
-\href{https://latex.ustc.edu.cn/login}{中国科学技术大学}) 也搭建了供内部师生使用的平台.
+\href{https://latex.ustc.edu.cn/login}{中国科学技术大学}) 搭建了供内部师生使用的平台.
 
 中国科学院计算机网络信息中心科技云运行与技术发展部曾发邮件宣称开始提供论文协同编辑服务,
 据我猜测,
@@ -209,15 +204,3 @@
 它利用了早年 Sharelatex 的部分内容.
 试用可点击%
 \href{https://www.cstcloud.cn/resources/452}{这里}.
-
-南京一家公司筹建了
-\href{https://www.slager.link/#/Home}{Slager} 在线 \LaTeX\ 编辑工具.
-目前看来,
-Slager 的用法也比较简单,
-并且有关于起步的%
-\href{https://www.slager.link/#/HelpCenter}{帮助文档}.
-
-\href{https://online.latexstudio.net/}{\LaTeX\ 工作室}也建立了一个在线平台,
-这个平台目前只有一台服务器,
-响应有点慢,
-但是会免费供用户使用.

Modified: trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/preface.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/preface.tex	2025-08-01 21:16:20 UTC (rev 75942)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/preface.tex	2025-08-01 21:16:34 UTC (rev 75943)
@@ -24,10 +24,8 @@
 仅供参考.
 
 除在本地安装 \LaTeX\ 发行版和编辑器之外,
-本手册还额外补充三款在线的 \LaTeX\ 平台,
-即 \href{http://www.overleaf.com/}{Overleaf},
-\href{https://www.texpage.com/}{TeXPage} 和
-\href{https://www.loongtex.com/}{LoongTeX} 的相关内容.
+本手册还额外介绍在线 \LaTeX\ 平台的相关内容,
+如国际知名的 \href{http://www.overleaf.com/}{Overleaf} 等.
 
 本手册所涉及到的代码需结合上下文说明, 不能简单地复制粘贴.
 粉色文字都是可点的超链接, 可直接跳转.
@@ -77,7 +75,7 @@
 \definecolor{alipay}{HTML}{1677FF}
 \definecolor{weixin}{HTML}{1AAD19}
 \begin{center}
-  \fancyqr[ classic, height = 6em, color = black, version = 5, image = {\tikz
+  \fancyqr[ classic, height = 6em, version = 5, image = {\tikz
             \node [ inner sep = 0pt, rounded corners = .225em, 
                     draw, line width = .1em, alipay,
                     minimum width = .95em, minimum height = .95em
@@ -84,7 +82,7 @@
                   ] {\textcolor{alipay}\faAlipay};}
           ]{https://qr.alipay.com/fkx10265yq7niozotwocae3}%
   \qquad
-  \fancyqr[ classic, height = 6em, color = black, version = 5, image = {\tikz
+  \fancyqr[ classic, height = 6em, version = 5, image = {\tikz
             \node [ inner sep = 0pt, rounded corners = .225em,
                     fill = weixin, font = \footnotesize,
                     minimum width = 1.05em, minimum height = 1.05em

Modified: trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/ubuntu.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/ubuntu.tex	2025-08-01 21:16:20 UTC (rev 75942)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/ubuntu.tex	2025-08-01 21:16:34 UTC (rev 75943)
@@ -17,7 +17,7 @@
 建议在执行命令前更换 Ubuntu 源,
 参考 \ref{sec:addition:source}~节.
 以下未特殊声明,
-均指在  \textsf{Terminal} 中执行相关命令.
+均指在 \textsf{Terminal} 中执行相关命令.
 
 下载
 \href{https://mirrors.ctan.org/systems/texlive/Images/texlive2025.iso}{\texttt{iso} 镜像文件}
@@ -283,7 +283,7 @@
 \texttt{lshort-zh-cn.pdf}
 或本手册.
 
-\section{编译文件}
+\section{编译文档}
 
 首先, 用户需要在工作路径建立一个 \texttt{tex} 文件.
 在 \textsf{Terminal} 中执行
@@ -315,7 +315,7 @@
 \end{lstlisting}
 即可打开 \texttt{pdf} 文件.
 
-对于中文文档, 可以在 "gedit" 中编写以下最小示例\footnote{gedit 默认使用 UTF-8 编码}%
+对于中文文档, 可以在 "gedit" 中编写以下最小示例\footnote{"gedit" 默认使用 UTF-8 编码}%
 \begin{lstlisting}[language = mwe]
   \documentclass[fontset = fandol]{ctexart}
   \begin{document}

Modified: trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/updateinfo.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/updateinfo.tex	2025-08-01 21:16:20 UTC (rev 75942)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/updateinfo.tex	2025-08-01 21:16:34 UTC (rev 75943)
@@ -4,6 +4,13 @@
 
 \chapter{版本信息}
 
+\section*{v2025.8.1}
+
+\begin{itemize}
+  \item 更正 "-shell-escape" 范例
+  \item 整合在线 \LaTeX\ 平台内容
+\end{itemize}
+
 \section*{v2025.6.1}
 
 \begin{itemize}

Modified: trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/windows.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/windows.tex	2025-08-01 21:16:20 UTC (rev 75942)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/windows.tex	2025-08-01 21:16:34 UTC (rev 75943)
@@ -23,7 +23,7 @@
 下载完毕后, 用户打开 \textsf{cmd} 窗口%
 \footnote{按 \keys{\faWindows},
 或在任意文件夹中按 \keys{\ctrl + L},
-输入 \textsf{cmd},
+输入 "cmd",
 点击 \keys{\enter}},
 将会见到诸如以下内容
 \begin{lstlisting}
@@ -107,7 +107,7 @@
 注意路径的名称是\textbf{不带空格的英文},
 默认路径为 \path{C:\texlive\2025\}.
 假如系统用了中文作为用户名,
-那么用户需要先按照 \ref{sec:chinesename} 节的方法更改临时环境变量后再安装.
+那么用户需要先按照 \ref{sec:chinesename}~节的方法更改临时环境变量后再安装.
 将镜像文件装载至虚拟光驱%
 \footnote{Windows 11 默认双击镜像文件便可装载;
 受某些压缩软件影响双击失效时,
@@ -465,7 +465,7 @@
   pdflatex -synctex=1 main
 \end{lstlisting}
 有些编译还需要额外调用系统命令,
-例如使用 \textsf{minted} 包就有这类要求,
+例如使用 \textsf{svg} 包就有这类要求,
 因此可以在执行编译时添加参数
 \begin{lstlisting}
   pdflatex -shell-escape main

Modified: trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/wsl.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/wsl.tex	2025-08-01 21:16:20 UTC (rev 75942)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/wsl.tex	2025-08-01 21:16:34 UTC (rev 75943)
@@ -238,7 +238,7 @@
 目前有很多开源的 WSL 辅助程序,
 相关讨论见本手册的 \href{https://github.com/OsbertWang/install-latex-guide-zh-cn/issues/13}{issue}.
 
-\section{编译文件}
+\section{编译文档}
 
 编译一个最小示例 \texttt{main.tex}.
 

Modified: trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/install-latex-guide-zh-cn.pdf
===================================================================
(Binary files differ)

More information about the tex-live-commits mailing list.