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

[commits+karl at tug.org]

Revision: 59037
          http://tug.org/svn/texlive?view=revision&revision=59037
Author:   karl
Date:     2021-05-01 22:16:12 +0200 (Sat, 01 May 2021)
Log Message:
-----------
install-latex-guide-zh-cn (1may21)

Modified Paths:
--------------
    trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/updateinfo.tex
    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/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/windows.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/appendix/updateinfo.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/updateinfo.tex	2021-05-01 00:58:51 UTC (rev 59036)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/appendix/updateinfo.tex	2021-05-01 20:16:12 UTC (rev 59037)
@@ -2,6 +2,14 @@
 
 \chapter{版本信息}
 
+\section*{v2021.5.1}
+
+\begin{enumerate}
+  \item 添加 Windows 中文用户名导致安装失败的解决方法
+  \item 添加升级宏包的必要性
+  \item 更正两处超链接
+\end{enumerate}
+
 \section*{v2021.4.7}
 
 \begin{enumerate}

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	2021-05-01 00:58:51 UTC (rev 59036)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/editor.tex	2021-05-01 20:16:12 UTC (rev 59037)
@@ -350,7 +350,7 @@
 
 简化起见, 这里只介绍如何使用 \TeX studio.
 根据官网推荐, 我们安装源内的 \TeX studio.
-安装前可参照 \ref{subsec:ubuntu:xelatexfail}~节的介绍换源以增速.
+安装前可参照 \ref{subsec:fc-cache}~节的介绍换源以增速.
 
 在 \textsf{Terminal} 中执行
 \begin{lstlisting}[language = bash]

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	2021-05-01 00:58:51 UTC (rev 59036)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/preface.tex	2021-05-01 20:16:12 UTC (rev 59037)
@@ -11,7 +11,7 @@
 \TeX{}~Live (macOS 中介绍 Mac\TeX)、升级宏包、编译简易文档等相关操作,
 并多以介绍命令行操作为主.
 有关 MiK\TeX{} 的安装,
-可以参考 \href{https://camusecao.top/1970-01-01-/MiKTeX/}{MiK\TeX{} 的基本使用}.
+可以参考 \href{https://camusecao.top/2020-05-09/MiKTeX/}{MiK\TeX{} 的基本使用}.
 
 本文还将简要介绍几款常见编辑器的使用方法,
 其他编辑器如 \href{https://code.visualstudio.com/}{VS Code},

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	2021-05-01 00:58:51 UTC (rev 59036)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/ubuntu.tex	2021-05-01 20:16:12 UTC (rev 59037)
@@ -160,7 +160,7 @@
 \end{lstlisting}
 在各处替换.
 
-\subsection{\texttt{fc-cache} 无法执行}
+\subsection{\texttt{fc-cache} 无法执行}\label{subsec:fc-cache}
 
 这种情况往往是缺少了 fontconfig,
 用户可以在命令行中执行以下命令安装

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	2021-05-01 00:58:51 UTC (rev 59036)
+++ trunk/Master/texmf-dist/doc/latex/install-latex-guide-zh-cn/chapter/windows.tex	2021-05-01 20:16:12 UTC (rev 59037)
@@ -74,7 +74,6 @@
 \end{lstlisting}
 即为验证成功.
 
-
 接下来开始安装.
 推荐用户先手动建立 \TeX{} Live 的安装路径 (文件夹) 再进行安装,
 注意路径的名称是\textbf{不带空格的英文},
@@ -87,16 +86,7 @@
 不鼓励解压缩镜像文件}. 
 假设加载后的路径为 \texttt{Z:\textbackslash}.
 在卸载了国内第三方安全软件的前提下,
-% 以管理员身份打开 \textsf{cmd} 窗口并执行%
-% \footnote{点击 \keys{\faWindows},
-% 输入 \textsf{cmd},
-% 点击 \keys{\ctrl + \shift + \enter}}
 打开 \textsf{cmd} 窗口并执行
-% \begin{lstlisting}[language = bash]
-%   cd /d Z:
-% \end{lstlisting}
-% 切换路径. 
-% 接下来执行
 \begin{lstlisting}[language = bash]
   Z:\install-tl-windows.bat --no-gui
 \end{lstlisting}
@@ -249,6 +239,23 @@
 因此鼓励用户在安装前先手动建立安装路径.
 直接使用管理员身份打开 \textsf{cmd} 窗口进行安装可能会对以后的升级造成影响.
 
+\subsection{系统用中文作为用户名}
+
+很多中文 Windows 用户习惯于用中文作为用户名,
+但是这样会导致 \TeX{} Live 2021 安装失败.
+更改系统的 \texttt{TEMP} 和 \texttt{TMP} 这两个环境变量可以避免这样的问题.
+在 \textsf{cmd} 中执行
+\begin{lstlisting}
+  mkdir C:\temp
+  set TEMP=C:\temp
+  set TMP=C:\temp
+\end{lstlisting}
+便可更改这两个环境变量为 \texttt{C:\textbackslash temp}.
+更改后按照前述内容安装 \TeX{} Live 2021 即可.
+这样的更改是临时的,
+待 \textsf{cmd} 窗口关闭,
+环境变量将恢复为原始状态.
+
 \section{卸载 \TeX{} Live}
 
 在跨版本升级 \TeX{} Live 时, 通常需要卸载旧版 \TeX{} Live.
@@ -352,6 +359,19 @@
   tlmgr update --reinstall-forcibly-removed --all
 \end{lstlisting}
 
+\subsection{升级宏包的必要性}
+
+自本手册撰写以来,
+每年镜像文件打包时都可能存在一些问题.
+使用镜像文件安装  \TeX{} Live 2021 后,
+系统平台无法被识别.
+该问题只见于 Windows 平台,
+具体讨论见%
+\href{https://github.com/CTeX-org/ctex-kit/issues/569}{这里}.
+目前这一问题已经可以通过更新宏包解决,
+用户安装完毕后,
+请按照本节提供的方法升级.
+
 \section{安装宏包}
 
 在默认状态下, 用户将完整安装 \TeX{} Live, 因此用户极少碰到需要手动安装宏包的情形. 

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