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

[Chen Miao]

Weijie Yuan <wy@xxxxxxxxx> 于2026年8月13日周四 23:36写道：
>
> 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@xxxxxxxxx>
>
> Acked-by: Weijie Yuan <wy@xxxxxxxxx>
>
> > ---
> >  .../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.
>
I don't think GUI instructions are necessary here. Readers who find diskutil
unfamiliar can easily search for the equivalent steps in Disk Utility. The same
operation can also be performed using Disk Utility.

Thanks,
Chen Miao
>
> > +在 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.