From 6fc61a518dc4c54df5f3acc35672206d7d992475 Mon Sep 17 00:00:00 2001 From: ooooo <3164076421@qq.com> Date: Tue, 7 Oct 2025 15:29:52 +0800 Subject: [PATCH 1/6] docs: fix some style --- docs/api/paddle/abs_cn.rst | 2 +- docs/api/paddle/amax_cn.rst | 2 +- docs/api/paddle/linalg/eig_cn.rst | 2 +- docs/api/paddle/linalg/norm_cn.rst | 52 +++++++++---------- docs/api/paddle/meshgrid_cn.rst | 2 +- .../paddle/nn/functional/sequence_mask_cn.rst | 2 +- 6 files changed, 31 insertions(+), 31 deletions(-) diff --git a/docs/api/paddle/abs_cn.rst b/docs/api/paddle/abs_cn.rst index 83fa2c88d48..8cdfe5f0f66 100644 --- a/docs/api/paddle/abs_cn.rst +++ b/docs/api/paddle/abs_cn.rst @@ -15,7 +15,7 @@ abs 参数 ::::::::: - - **x** (Tensor) - 输入的 Tensor，数据类型为：int32、int64、float16、float32、float64、complex64、complex128。 + - **x** (Tensor) - 输入的 Tensor，数据类型为：int32、int64、float16、float32、float64、complex64 或 complex128。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 返回 diff --git a/docs/api/paddle/amax_cn.rst b/docs/api/paddle/amax_cn.rst index 238a1a0bd9b..35b0772df35 100644 --- a/docs/api/paddle/amax_cn.rst +++ b/docs/api/paddle/amax_cn.rst @@ -15,7 +15,7 @@ amax 参数 ::::::::: - - **x** (Tensor) - Tensor，支持数据类型为 float32、float64、int32、int64，维度不超过 4 维。 + - **x** (Tensor) - Tensor，支持数据类型为 float32、float64、int32 或 int64，维度不超过 4 维。 ``别名：input`` - **axis** (int|list|tuple，可选) - 求最大值运算的维度。如果为 None，则计算所有元素的最大值并返回包含单个元素的 Tensor 变量，否则必须在 :math:`[-x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] <0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为 None。 ``别名：dim`` diff --git a/docs/api/paddle/linalg/eig_cn.rst b/docs/api/paddle/linalg/eig_cn.rst index a7693f0a5fa..0f4e797b145 100644 --- a/docs/api/paddle/linalg/eig_cn.rst +++ b/docs/api/paddle/linalg/eig_cn.rst @@ -17,7 +17,7 @@ eig 参数 :::::::::::: - - **x** (Tensor) - 输入一个或一批矩阵。``x`` 的形状应为 ``[*, M, M]``，数据类型支持 float32、float64、complex64 和 complex128。 + - **x** (Tensor) - 输入一个或一批矩阵。``x`` 的形状应为 ``[*, M, M]``，数据类型支持 float32、float64、complex64 或 complex128。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 返回 diff --git a/docs/api/paddle/linalg/norm_cn.rst b/docs/api/paddle/linalg/norm_cn.rst index 21e92ca167f..eaab8e7bec5 100644 --- a/docs/api/paddle/linalg/norm_cn.rst +++ b/docs/api/paddle/linalg/norm_cn.rst @@ -18,32 +18,32 @@ norm **Paddle 支持以下范数:** -+----------------+--------------------------------+--------------------------------+ -| porder | norm for matrices | norm for vectors | -+================+================================+================================+ -| None(default) | frobenius norm | 2 范数 | -+----------------+--------------------------------+--------------------------------+ -| fro | frobenius norm | 不支持 | -+----------------+--------------------------------+--------------------------------+ -| nuc | nuclear norm | 不支持 | -+----------------+--------------------------------+--------------------------------+ -| inf | max(sum(abs(x), dim=1)) | max(abs(x)) | -+----------------+--------------------------------+--------------------------------+ -| -inf | min(sum(abs(x), dim=1)) | min(abs(x)) | -+----------------+--------------------------------+--------------------------------+ -| 0 | 不支持 | sum(x != 0) | -+----------------+--------------------------------+--------------------------------+ -| 1 | max(sum(abs(x), dim=0)) | 同下 | -+----------------+--------------------------------+--------------------------------+ -| -1 | min(sum(abs(x), dim=0)) | 同下 | -+----------------+--------------------------------+--------------------------------+ -| 2 | 由 axis 组成矩阵的最大奇异值 | 同下 | -+----------------+--------------------------------+--------------------------------+ -| -2 | 由 axis 组成矩阵的最大奇异值 | 同下 | -+----------------+--------------------------------+--------------------------------+ -| 其他 int 或 | 不支持 | sum(abs(x)^{porder})^ | -| float | | {(1 / porder)} | -+----------------+--------------------------------+--------------------------------+ ++---------------+------------------------------+-----------------------+ +| porder | norm for matrices | norm for vectors | ++===============+==============================+=======================+ +| None(default) | frobenius norm | 2 范数 | ++---------------+------------------------------+-----------------------+ +| fro | frobenius norm | 不支持 | ++---------------+------------------------------+-----------------------+ +| nuc | nuclear norm | 不支持 | ++---------------+------------------------------+-----------------------+ +| inf | max(sum(abs(x), dim=1)) | max(abs(x)) | ++---------------+------------------------------+-----------------------+ +| -inf | min(sum(abs(x), dim=1)) | min(abs(x)) | ++---------------+------------------------------+-----------------------+ +| 0 | 不支持 | sum(x != 0) | ++---------------+------------------------------+-----------------------+ +| 1 | max(sum(abs(x), dim=0)) | 同下 | ++---------------+------------------------------+-----------------------+ +| -1 | min(sum(abs(x), dim=0)) | 同下 | ++---------------+------------------------------+-----------------------+ +| 2 | 由 axis 组成矩阵的最大奇异值 | 同下 | ++---------------+------------------------------+-----------------------+ +| -2 | 由 axis 组成矩阵的最大奇异值 | 同下 | ++---------------+------------------------------+-----------------------+ +| 其他 int 或 | 不支持 | sum(abs(x)^{porder})^ | +| float | | {(1 / porder)} | ++---------------+------------------------------+-----------------------+ 参数 diff --git a/docs/api/paddle/meshgrid_cn.rst b/docs/api/paddle/meshgrid_cn.rst index 46ada40c95a..0f7935c0b29 100644 --- a/docs/api/paddle/meshgrid_cn.rst +++ b/docs/api/paddle/meshgrid_cn.rst @@ -13,7 +13,7 @@ meshgrid 参数 :::::::::::: - - **args** (Tensor|Tensor 数组) - 输入变量为 k 个一维 Tensor，形状分别为(N1,), (N2,), ..., (Nk, )。支持数据类型为 bfloat16、float16、float32、float64、int32、int64、complex64 和 complex128。 + - **args** (Tensor|Tensor 数组) - 输入变量为 k 个一维 Tensor，形状分别为(N1,), (N2,), ..., (Nk, )。支持数据类型为 bfloat16、float16、float32、float64、int32、int64、complex64 或 complex128。 - **kargs** (可选) - 目前只接受 name 参数（str），具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 diff --git a/docs/api/paddle/nn/functional/sequence_mask_cn.rst b/docs/api/paddle/nn/functional/sequence_mask_cn.rst index ff8f0460477..90c7e78e46d 100644 --- a/docs/api/paddle/nn/functional/sequence_mask_cn.rst +++ b/docs/api/paddle/nn/functional/sequence_mask_cn.rst @@ -42,7 +42,7 @@ sequence_mask 返回 ::::::::: -mask Tensor，Tensor，形状为 ``[d_1, d_2，… ，d_n, maxlen]``，数据类型由 ``dtype`` 指定，支持 float32、float64、int32 和 int64，默认为 int64。 +mask Tensor，Tensor，形状为 ``[d_1, d_2，… ，d_n, maxlen]``，数据类型由 ``dtype`` 指定，支持 float32、float64、int32 或 int64，默认为 int64。 代码示例 ::::::::: From 15d45ffd43ad6cf1bd54d8265d08cf6b5249caf1 Mon Sep 17 00:00:00 2001 From: ooooo <3164076421@qq.com> Date: Wed, 8 Oct 2025 13:41:10 +0800 Subject: [PATCH 2/6] test ci --- ci_scripts/report_preview_url.sh | 3 +++ 1 file changed, 3 insertions(+) diff --git a/ci_scripts/report_preview_url.sh b/ci_scripts/report_preview_url.sh index 993bd53da18..0dca07ebeb7 100644 --- a/ci_scripts/report_preview_url.sh +++ b/ci_scripts/report_preview_url.sh @@ -30,6 +30,9 @@ done if [ ${#output_lines[@]} -gt 0 ]; then cat <<-EOF +> [!CAUTION] +> 如果你不清楚这个 pr 的修改内容（特别是修改了 `report_preview_url.sh` 或 `preview-url-comment.yml`），请不要随便点击链接！！！ +
📚 本次 PR 文档预览链接 (点击展开) From 96be73cb09e6f22bc2d802c4e4326b647f1f1309 Mon Sep 17 00:00:00 2001 From: ooooo <3164076421@qq.com> Date: Wed, 8 Oct 2025 13:49:01 +0800 Subject: [PATCH 3/6] fix ci, in cat << -EOF here-document mean command substitution --- ci_scripts/report_preview_url.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ci_scripts/report_preview_url.sh b/ci_scripts/report_preview_url.sh index 0dca07ebeb7..22422bb7032 100644 --- a/ci_scripts/report_preview_url.sh +++ b/ci_scripts/report_preview_url.sh @@ -31,7 +31,7 @@ done if [ ${#output_lines[@]} -gt 0 ]; then cat <<-EOF > [!CAUTION] -> 如果你不清楚这个 pr 的修改内容（特别是修改了 `report_preview_url.sh` 或 `preview-url-comment.yml`），请不要随便点击链接！！！ +> 如果你不清楚这个 pr 的修改内容（特别是修改了 \`report_preview_url.sh\` 或 \`preview-url-comment.yml\`），请不要随便点击链接！！！
📚 本次 PR 文档预览链接 (点击展开) From bc5d8c5600367643c73a2338a2f9d6fac51a610a Mon Sep 17 00:00:00 2001 From: ooooo <3164076421@qq.com> Date: Wed, 8 Oct 2025 21:56:44 +0800 Subject: [PATCH 4/6] fix typos --- ci_scripts/report_preview_url.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ci_scripts/report_preview_url.sh b/ci_scripts/report_preview_url.sh index 22422bb7032..690cf361f53 100644 --- a/ci_scripts/report_preview_url.sh +++ b/ci_scripts/report_preview_url.sh @@ -31,7 +31,7 @@ done if [ ${#output_lines[@]} -gt 0 ]; then cat <<-EOF > [!CAUTION] -> 如果你不清楚这个 pr 的修改内容（特别是修改了 \`report_preview_url.sh\` 或 \`preview-url-comment.yml\`），请不要随便点击链接！！！ +> 如果你不清楚这个 pr 的修改内容（特别是修改了 \`report_preview_url.sh\` 或 \`preview-url-generate.yml\`），请不要随便点击链接！！！
📚 本次 PR 文档预览链接 (点击展开) From 1638da3c53a2783fd196f1969708af12fdd1e623 Mon Sep 17 00:00:00 2001 From: ooooo <3164076421@qq.com> Date: Wed, 8 Oct 2025 22:48:12 +0800 Subject: [PATCH 5/6] apply review --- ci_scripts/report_preview_url.sh | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/ci_scripts/report_preview_url.sh b/ci_scripts/report_preview_url.sh index 690cf361f53..d0ed566753f 100644 --- a/ci_scripts/report_preview_url.sh +++ b/ci_scripts/report_preview_url.sh @@ -30,11 +30,11 @@ done if [ ${#output_lines[@]} -gt 0 ]; then cat <<-EOF -> [!CAUTION] -> 如果你不清楚这个 pr 的修改内容（特别是修改了 \`report_preview_url.sh\` 或 \`preview-url-generate.yml\`），请不要随便点击链接！！！ +> [!NOTE] +> 请等待 \`Docs-NEW\` 流水线运行完成后再点击预览链接，否则可能会看到旧版本内容或遇到链接无法访问的情况。
-📚 本次 PR 文档预览链接 (点击展开) +📚 本次 PR 文档预览链接（点击展开） 以下是本次 PR 中变更文档的预览链接： From 95b1017ca6ae5feeb91972d71517aa4785ac7ef6 Mon Sep 17 00:00:00 2001 From: ooooo <3164076421@qq.com> Date: Fri, 10 Oct 2025 09:04:03 +0800 Subject: [PATCH 6/6] revert ci_scripts/report_preview_url.sh change --- ci_scripts/report_preview_url.sh | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/ci_scripts/report_preview_url.sh b/ci_scripts/report_preview_url.sh index d0ed566753f..993bd53da18 100644 --- a/ci_scripts/report_preview_url.sh +++ b/ci_scripts/report_preview_url.sh @@ -30,11 +30,8 @@ done if [ ${#output_lines[@]} -gt 0 ]; then cat <<-EOF -> [!NOTE] -> 请等待 \`Docs-NEW\` 流水线运行完成后再点击预览链接，否则可能会看到旧版本内容或遇到链接无法访问的情况。 -
-📚 本次 PR 文档预览链接（点击展开） +📚 本次 PR 文档预览链接 (点击展开) 以下是本次 PR 中变更文档的预览链接：