From e4b7dd371c6f50cdcbc0d63a81cb5f62a2d30d1a Mon Sep 17 00:00:00 2001 From: Mo Fei Fei Date: Wed, 6 Sep 2023 11:19:54 +0800 Subject: [PATCH] Docs: update Chinese translation for partition table data subtypes --- docs/en/api-guides/partition-tables.rst | 10 +++++----- docs/zh_CN/api-guides/partition-tables.rst | 17 +++++++++++++---- 2 files changed, 18 insertions(+), 9 deletions(-) diff --git a/docs/en/api-guides/partition-tables.rst b/docs/en/api-guides/partition-tables.rst index d507940f33..ee0b41866d 100644 --- a/docs/en/api-guides/partition-tables.rst +++ b/docs/en/api-guides/partition-tables.rst @@ -125,11 +125,11 @@ See enum :cpp:type:`esp_partition_subtype_t` for the full list of subtypes defin - There are other predefined data subtypes for data storage supported by ESP-IDF. These include: - - ``coredump`` (0x03) is for storing core dumps while using a custom partition table CSV file. See :doc:`Core Dump ` for more details. - - ``efuse`` (0x05) is for emulating eFuse bits using :ref:`Virtual eFuses `. - - ``undefined`` (0x06) is implicitly used for data partitions with unspecified (empty) subtype, however it is possible to explicitly mark them as undefined as well. - - ``fat`` (0x81) is for :doc:`FAT filesystem `. - - ``spiffs`` (0x82) is for :doc:`SPIFFS filesystem `. + - ``coredump`` (0x03) is for storing core dumps while using a custom partition table CSV file. See :doc:`/api-guides/core_dump` for more details. + - ``efuse`` (0x05) is for emulating eFuse bits using :ref:`virtual-efuses`. + - ``undefined`` (0x06) is implicitly used for data partitions with unspecified (empty) subtype, but it is possible to explicitly mark them as undefined as well. + - ``fat`` (0x81) is for :doc:`/api-reference/storage/fatfs`. + - ``spiffs`` (0x82) is for :doc:`/api-reference/storage/spiffs`. - ``littlefs`` (0x83) is for `LittleFS filesystem `_. See :example:`storage/littlefs` example for more details. .. Comment: ``esphttpd`` (0x80) was not added to the list because there is no docs section for it and it is not clear whether user should use it explicitly. diff --git a/docs/zh_CN/api-guides/partition-tables.rst b/docs/zh_CN/api-guides/partition-tables.rst index 6524fa846f..9f04f446a8 100644 --- a/docs/zh_CN/api-guides/partition-tables.rst +++ b/docs/zh_CN/api-guides/partition-tables.rst @@ -123,13 +123,22 @@ SubType 字段长度为 8 bit，内容与具体分区 Type 有关。目前，esp - 用于存储加密密钥（如果启用了 `NVS 加密` 功能）。 - 此分区应至少设定为 4096 字节。 - - ESP-IDF 还支持其它预定义的子类型用于数据存储，包括 :doc:`FAT 文件系统 ` (:cpp:enumerator:`ESP_PARTITION_SUBTYPE_DATA_FAT`), :doc:`SPIFFS ` (:cpp:enumerator:`ESP_PARTITION_SUBTYPE_DATA_SPIFFS`) 等。 + - ESP-IDF 还支持其他用于数据存储的预定义子类型，包括： + + - ``coredump`` (0x03) 用于在使用自定义分区表 CSV 文件时存储核心转储，详情请参阅 :doc:`/api-guides/core_dump`。 + - ``efuse`` (0x05) 使用 :ref:`虚拟 eFuse ` 模拟 eFuse 位。 + - ``undefined`` (0x06) 隐式用于未指定子类型（即子类型为空）的数据分区，但也可显式将其标记为未定义。 + - ``fat`` (0x81) 用于 :doc:`/api-reference/storage/fatfs`。 + - ``spiffs`` (0x82) 用于 :doc:`/api-reference/storage/spiffs`。 + - ``littlefs`` (0x83) 用于 `LittleFS 文件系统 `_，详情可参阅 :example:`storage/littlefs` 示例。 - 其它数据子类型已预留给 esp-idf 未来使用。 +.. Comment: ``esphttpd`` (0x80) was not added to the list because there is no docs section for it and it is not clear whether user should use it explicitly. -* 如果分区类型是由应用程序定义的任意值（0x40-0xFE），那么 ``subtype`` 字段可以是由应用程序选择的任何值（0x00-0xFE）。 + 其它数据子类型已预留给 ESP-IDF 未来使用。 -请注意如果用 C++ 编写，应用程序定义的子类型值需要转换为 :cpp:type:`esp_partition_type_t`，从而与 :ref:`分区 API` 一起使用。 +* 如果分区类型是由应用程序定义的任意值 (0x40-0xFE)，那么 ``subtype`` 字段可以是由应用程序选择的任何值 (0x00-0xFE)。 + + 请注意，如果用 C++ 编写，应用程序定义的子类型值需要转换为 :cpp:type:`esp_partition_type_t`，从而与 :ref:`分区 API ` 一起使用。 额外分区 SubType 字段 ~~~~~~~~~~~~~~~~~~~~~~~~