Merge branch 'docs/update_translation_for_nvs_bootloader' into 'master'

docs: Provide CN translation for nvs bootloader and fix broken link

Closes DOC-10278 and DOC-10343

See merge request espressif/esp-idf!37252

docs/en/api-reference/storage/nvs_bootloader.rst

@@ -6,7 +6,7 @@ NVS Bootloader
 Overview
 --------
 
-This guide provides an overview of the NVS functionality available for custom bootloader code, along with its limitations.
+This guide provides an overview of the NVS (Non-Volatile Storage) functionality available for custom bootloader code, along with its limitations.
 
 Due to the constraints of the bootloader runtime environment, custom bootloader code cannot use the full NVS API directly. Instead, NVS provides a simplified API that offers read-only access to NVS data.
 
@@ -19,7 +19,7 @@ Reading encrypted NVS partitions
 
 The API also supports decrypting NVS data, if the NVS partition is encrypted using one of the schemes as mentioned in the :doc:`nvs_encryption` guide.
 
-Applications are expected to follow the steps below in order to enable decryption of a NVS partition using the NVS bootloader read API:
+Applications are expected to follow the steps below in order to enable decryption of a NVS partition using the :cpp:func:`nvs_bootloader_read` API:
 
     1. Populate the NVS security configuration structure :cpp:type:`nvs_sec_cfg_t` according to the selected NVS encryption scheme (Please refer to :doc:`nvs_encryption` for more details).
     2. Read NVS security configuration set by the specified security scheme using the :cpp:func:`nvs_bootloader_read_security_cfg` API.
@@ -30,15 +30,14 @@ Applications are expected to follow the steps below in order to enable decryptio
 .. only:: SOC_HMAC_SUPPORTED
 
     .. note::
+
         While using the HMAC-based scheme, the above workflow can be used without enabling any of the config options for NVS encryption - :ref:`CONFIG_NVS_ENCRYPTION`, :ref:`CONFIG_NVS_SEC_KEY_PROTECTION_SCHEME` -> ``CONFIG_NVS_SEC_KEY_PROTECT_USING_HMAC`` and :ref:`CONFIG_NVS_SEC_HMAC_EFUSE_KEY_ID` to encrypt the default as well as custom NVS partitions with :cpp:func:`nvs_flash_secure_init` API.
 
 
 Application Example
 -------------------
 
-You can find code examples in the :example:`storage` directory of ESP-IDF examples:
-
-:example:`storage/nvs_bootloader`
+You can find code examples in :example:`storage/nvs_bootloader` (in the :example:`storage` directory of ESP-IDF examples).
 
 This section demonstrates how to prepare data in the input-output structure for various data types, namespaces, and keys. It includes an example of reading string data from NVS.
 

docs/zh_CN/api-reference/storage/index.rst

@@ -12,7 +12,7 @@
 - :doc:`FAT <fatfs>` 是一个可用于 SPI flash 或者 SD/MMC 存储卡的标准文件系统。
 - :doc:`磨损均衡 <wear-levelling>` 库实现了一个适用于 SPI NOR flash 的 flash 翻译层 (FTL)，用于 flash 中 FAT 分区的容器。
 
-与存储安全相关的信息，请参考 :doc:` 存储安全 <storage-security>`。
+与存储安全相关的信息，请参考 :doc:`存储安全 <storage-security>`。
 
 .. note::
 

docs/zh_CN/api-reference/storage/nvs_bootloader.rst

@@ -1,4 +1,49 @@
-NVS Bootloader
-==============
+在引导程序中使用 NVS
+======================
 
 :link_to_translation:`en:[English]`
+
+概述
+-----
+
+本指南概述了可用于自定义引导加载程序代码的 NVS（非易失性存储）功能及其限制。
+
+由于引导加载程序运行环境的限制，自定义引导加载程序代码无法直接使用完整的 NVS API。为此，NVS 提供了一个简化 API，仅支持只读访问 NVS 数据。
+
+该 API 支持读取除 blob 之外的所有 NVS 数据类型。一次 API 调用可以同时读取多个 NVS 条目。可以从同一 NVS 分区的不同命名空间读取值，读取结果存储在输入/输出结构数组中，每个数据项的固定大小最多为 8 字节。
+
+由于引导加载程序中的堆内存分配限制，读取字符串条目时，API 要求调用者提供缓冲区及其大小。
+
+读取加密的 NVS 分区
+^^^^^^^^^^^^^^^^^^^^^^^
+
+如果 NVS 分区使用 :doc:`nvs_encryption` 指南中的加密方案，该 API 还支持解密 NVS 数据。
+
+应用程序应按照以下步骤使用 :cpp:func:`nvs_bootloader_read` API 读取加密 NVS 分区数据：
+
+    1. 根据所选的 NVS 加密方案填充 NVS 安全配置结构 :cpp:type:`nvs_sec_cfg_t` （详情请参阅 :doc:`nvs_encryption`）。
+    2. 使用 :cpp:func:`nvs_bootloader_read_security_cfg` API 从指定的安全方案中读取 NVS 安全配置。
+    3. 获取安全配置后，使用 :cpp:func:`nvs_bootloader_secure_init` API 初始化 NVS flash 分区。
+    4. 使用 :cpp:func:`nvs_bootloader_read` API 执行 NVS 读取操作。
+    5. 使用 :cpp:func:`nvs_bootloader_secure_deinit` API 反初始化 NVS flash 分区，并清除安全配置。
+
+.. only:: SOC_HMAC_SUPPORTED
+
+    .. note::
+
+        在使用基于 HMAC 的方案进行上述流程时，可以直接调用 :cpp:func:`nvs_flash_secure_init` API 对默认和自定义 NVS 分区进行加密，而无需启用 NVS 加密相关配置选项（如 :ref:`CONFIG_NVS_ENCRYPTION`， :ref:`CONFIG_NVS_SEC_KEY_PROTECTION_SCHEME` -> ``CONFIG_NVS_SEC_KEY_PROTECT_USING_HMAC``， :ref:`CONFIG_NVS_SEC_HMAC_EFUSE_KEY_ID`）。
+
+
+应用示例
+-----------
+
+代码示例请参阅 ESP-IDF 示例 :example:`storage` 目录下的 :example:`storage/nvs_bootloader`。
+
+本节演示了如何在输入/输出结构中准备数据，以支持不同的数据类型、命名空间和键。此外，还包含从 NVS 读取字符串数据的示例。
+
+示例还演示了如何检查读取操作是否成功，数据是否存在不一致，或是否在 NVS 中找不到某些值的情形。该示例能够将 API 返回的值（或错误码）打印到控制台。
+
+API 参考
+-----------
+
+.. include-build-file:: inc/nvs_bootloader.inc