[PATCH v2 1/2] docs/zh_CN: sync maintainer/configure-git with upstream
From: Weijie Yuan
Date: Sat Sep 05 2026 - 06:06:48 EST
The English document updated the signed-tag instructions to describe
selecting a key with -u <key-id>, configuring a default key, and using
-s. It also removed the explicit section label and the instructions for
adding Link trailers automatically with an applypatch-msg hook, because
Link: trailers should only point to useful additional information.
Update the translation through commit 944df7a31452
("docs: update the guidance for Link: tags").
Also point the pull-request reference to the Chinese translation.
Signed-off-by: Weijie Yuan <wy@xxxxxxxxx>
---
.../zh_CN/maintainer/configure-git.rst | 48 +++++-----------------
1 file changed, 11 insertions(+), 37 deletions(-)
diff --git a/Documentation/translations/zh_CN/maintainer/configure-git.rst b/Documentation/translations/zh_CN/maintainer/configure-git.rst
index a45ea736f73b..693d4e5247a6 100644
--- a/Documentation/translations/zh_CN/maintainer/configure-git.rst
+++ b/Documentation/translations/zh_CN/maintainer/configure-git.rst
@@ -5,58 +5,32 @@
:译者:
吴想成 Wu XiangCheng <bobwxc@xxxxxxxx>
+ 袁维杰 Weijie Yuan <wy@xxxxxxxxx>
-.. _configuregit_zh:
+配置 Git
+========
-Git配置
-=======
+本章介绍维护者级别的 Git 配置。
-本章讲述了维护者级别的git配置。
-
-Documentation/maintainer/pull-requests.rst 中使用的标记分支应使用开发人员的
-GPG公钥进行签名。可以通过将 ``-u`` 标志传递给 ``git tag`` 来创建签名标记。
-但是,由于 *通常* 对同一项目使用同一个密钥,因此可以设置::
+拉取请求中使用的带标签分支(参见 Documentation/translations/zh_CN/maintainer/pull-requests.rst)
+应使用开发者的 GPG 公钥签名。向 ``git tag`` 传递 ``-u <key-id>`` 可以创建签名标签。
+不过,由于你对同一项目 *通常* 会使用同一个密钥,因此可以在配置中设置该密钥并
+使用 ``-s`` 选项。使用以下命令设置默认的 ``key-id``::
git config user.signingkey "keyname"
-或者手动编辑你的 ``.git/config`` 或 ``~/.gitconfig`` 文件::
+也可以手动编辑你的 ``.git/config`` 或 ``~/.gitconfig`` 文件::
[user]
name = Jane Developer
email = jd@xxxxxxxxxx
signingkey = jd@xxxxxxxxxx
-你可能需要告诉 ``git`` 去使用 ``gpg2``::
+你可能需要让 ``git`` 使用 ``gpg2``::
[gpg]
program = /path/to/gpg2
-你可能也需要告诉 ``gpg`` 去使用哪个 ``tty`` (添加到你的shell rc文件中)::
+你可能还需要告诉 ``gpg`` 使用哪个 ``tty`` (将其添加到 shell 的 rc 文件中)::
export GPG_TTY=$(tty)
-
-
-创建链接到lore.kernel.org的提交
--------------------------------
-
-http://lore.kernel.org 网站是所有涉及或影响内核开发的邮件列表的总存档。在这里
-存储补丁存档是推荐的做法,当维护人员将补丁应用到子系统树时,最好提供一个指向
-lore存档链接的标签,以便浏览提交历史的人可以找到某个更改背后的相关讨论和基本
-原理。链接标签如下所示:
-
- Link: https://lore.kernel.org/r/<message-id>
-
-通过在git中添加以下钩子,可以将此配置为在发布 ``git am`` 时自动执行:
-
-.. code-block:: none
-
- $ git config am.messageid true
- $ cat >.git/hooks/applypatch-msg <<'EOF'
- #!/bin/sh
- . git-sh-setup
- perl -pi -e 's|^Message-Id:\s*<?([^>]+)>?$|Link: https://lore.kernel.org/r/$1|g;' "$1"
- test -x "$GIT_DIR/hooks/commit-msg" &&
- exec "$GIT_DIR/hooks/commit-msg" ${1+"$@"}
- :
- EOF
- $ chmod a+x .git/hooks/applypatch-msg
--
2.55.0.966.g6673acef38