Re: [PATCH v3 5/6] docs/zh_CN: doc-guide: document macOS Sphinx setup

[Weijie Yuan <wy@wyuan.org>]

On Thu, Aug 13, 2026 at 02:23:22AM +0800, Chen Miao wrote:
> Translate the macOS Sphinx dependency setup added to the English
> documentation. Keep the translation in a separate patch so translation
> status tooling can track the source change correctly.
> 
> Signed-off-by: Chen Miao <chenmiao.ku@gmail.com>

Acked-by: Weijie Yuan <wy@wyuan.org>

> ---
>  .../translations/zh_CN/doc-guide/sphinx.rst     | 17 ++++++++++++++++-
>  1 file changed, 16 insertions(+), 1 deletion(-)
> 
> diff --git a/Documentation/translations/zh_CN/doc-guide/sphinx.rst b/Documentation/translations/zh_CN/doc-guide/sphinx.rst
> index 3375c6f3a..e6d42d970 100644
> --- a/Documentation/translations/zh_CN/doc-guide/sphinx.rst
> +++ b/Documentation/translations/zh_CN/doc-guide/sphinx.rst
> @@ -110,6 +110,22 @@ PDF和LaTeX构建
>  
>  	使用Sphinx的系统打包，而不是Python虚拟环境。
>  
> +macOS 默认使用不区分文件名大小写的 APFS 卷，而内核源码树中存在仅大小写
> +不同的文件。克隆源码前，请用 ``diskutil apfs list`` 找到 APFS 容器标识符，
> +将下面的 ``diskX`` 替换为该标识符，并创建一个额外的大小写敏感卷::
> +
> +	diskutil apfs addVolume diskX APFSX Linux

This CLI way definitely works, while the Disk Utility app also provides
an easy way to do this. ;-) Shall we add more description or tips about
it? But I'm also satisfied with the current situation, as some hackers
who would read this may prefer CLI way.

> +在 macOS 上，该脚本使用 Homebrew 安装系统依赖，输出的 Homebrew 命令不需要
> +``sudo``。PDF 工具链由 ``mactex-no-gui`` cask 提供，所需的 DejaVu 和 Noto CJK
> +字体则通过 Homebrew font cask 安装；如果只构建 HTML 文档，请使用 ``--no-pdf``。
> +安装 MacTeX 后，请重新启动终端，或运行
> +``eval "$(/usr/libexec/path_helper)"`` 使命令行工具可见。macOS 用户建议使用
> +默认的 Python 虚拟环境，因为 PyYAML 会从
> +``Documentation/sphinx/requirements.txt`` 安装，而不是通过 Homebrew 安装。
> +该脚本还会检查 GNU Make 4.0 或更高版本；如果 Homebrew 将其安装为
> +``gmake``，请使用 ``gmake htmldocs``，而不是 ``make htmldocs``。

Thanks for this, I like it.