docs: Provide CN translation for eight additionalfeatures docs

docs_espressif/en/additionalfeatures/application-size-analysis.rst

@@ -1,20 +1,19 @@
 ESP-IDF Application Size Analysis
-===================================
+=================================
 
-The ESP-IDF Application Size Analysis tool provides a detailed breakdown of your application’s memory usage, helping developers optimize storage allocation. For a visual size analysis:
+:link_to_translation:`zh_CN:[中文]`
 
-- Navigate to **View** > **Command Palette**.
+The ESP-IDF application size analysis tool provides a detailed breakdown of your application’s memory usage, helping developers optimize storage allocation. To view a visual size analysis:
 
-- Type **ESP-IDF: Size Analysis of the Binaries** and select the command to visually review the application size information.
+- Navigate to ``View`` > ``Command Palette``.
+- Type ``ESP-IDF: Size Analysis of the Binaries`` and select the command to review the application size information.
 
-.. image:: ../../../media/tutorials/basic_use/size.png
+    .. image:: ../../../media/tutorials/basic_use/size.png
 
-Follow the below instructions to view applciation size analysis from CLI:
+To view application size analysis from the CLI:
 
-- Navigate to **View** > **Command Palette**.
+- Navigate to ``View`` > ``Command Palette``.
+- Type ``ESP-IDF: Build your Project`` and select the command to build your project.
+- The application size analysis task will be executed in a terminal, showing the size analysis results. You can enable or disable this task with ``idf.enableSizeTaskAfterBuildTask`` in your ``settings.json``.
 
-- Type **ESP-IDF: Build your Project** and select the command to specify the build your project.
-
-- The application size analysis task will be executed in a terminal showing the size analysis results. You can enable or disable this task being executed with **idf.enableSizeTaskAfterBuildTask** in your settings.json.
-
-.. image:: ../../../media/tutorials/basic_use/size_terminal.png
+    .. image:: ../../../media/tutorials/basic_use/size_terminal.png

docs_espressif/en/additionalfeatures/dfu.rst

@@ -1,37 +1,40 @@
-Device Firmware Upgrade via USB.
+Device Firmware Upgrade (DFU) via USB
 =====================================
 
-Requirements:
-----------------------
+:link_to_translation:`zh_CN:[中文]`
 
-- ESP32-S2 or an ESP32-S3 chip
-- You will need to do some electrical connection work. `Here is a guide for the S2 board <https://blog.espressif.com/dfu-using-the-native-usb-on-esp32-s2-for-flashing-the-firmware-b2c4af3335f1>`_
-- The chip needs to be in bootloader mode for it to be detected as a DFU device. This can be achieved by pressing the “reset” button, while holding the “boot” button pressed
-- For Windows only: You have to register on Windows the device with the WinUSB driver.
+Requirements
+------------
 
-.. note::
-  The drivers can be installed by the `Zadig tool <https://zadig.akeo.ie/>`_. Please make sure that the device is in download mode before you run the tool and that it detects the ESP32-S2 device before you install the drivers. The Zadig tool might detect several USB interfaces of ESP32-S2. Please install the WinUSB driver only for the interface where there is no driver installed (probably it is Interface 2) and do not re-install the driver for the other interface.
+- ESP32-S2 or ESP32-S3 chip.
+- Complete electrical connections. Here is `a guide for the ESP32-S2 board <https://blog.espressif.com/dfu-using-the-native-usb-on-esp32-s2-for-flashing-the-firmware-b2c4af3335f1>`_.
+- The chip must be in bootloader mode to be detected as a DFU device. This can be achieved by pressing the "reset" button while holding the "boot" button.
+- For Windows: Register the device with the **WinUSB** driver.
 
-Flashing:
-~~~~~~~~~~~~
+    .. note::
+
+        Install the drivers using the `Zadig tool <https://zadig.akeo.ie/>`_. Ensure the device is in download mode before running the tool. The tool should detect the ESP32-S2 device before installing the drivers. The Zadig tool may detect several USB interfaces of ESP32-S2. Install the WinUSB driver only for the interface without a driver (likely **Interface 2**) and do not reinstall the driver for other interfaces.
 
-1. Select a device target which is DFU compatible (ESP32-S2/ ESP32-S3)
+Flashing
+~~~~~~~~
 
-.. image:: ../../../media/tutorials/dfu/select_device.png
+1.  Select a DFU-compatible device (ESP32-S2 or ESP32-S3)
 
-2. Select DFU as flashing method
+    .. image:: ../../../media/tutorials/dfu/select_device.png
 
-.. image:: ../../../media/tutorials/dfu/flash_method.png
+2.  Select DFU as the flashing method
 
-3. Build the project
+    .. image:: ../../../media/tutorials/dfu/flash_method.png
 
-.. image:: ../../../media/tutorials/dfu/build_project.png
+3.  Build the project
 
-4. Flash
+    .. image:: ../../../media/tutorials/dfu/build_project.png
 
-.. image:: ../../../media/tutorials/dfu/flash.png
+4.  Flash the firmware
+
+    .. image:: ../../../media/tutorials/dfu/flash.png
 
 Useful Links
-~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~
 
-`Espressif DFU api guide <https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/api-guides/dfu.html?highlight=dfu%20util#api-guide-dfu-build>`_
+`Espressif DFU API guide <https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/api-guides/dfu.html>`_

docs_espressif/en/additionalfeatures/efuse.rst

@@ -1,24 +1,25 @@
-EFuse Explorer
-========================
+eFuse Explorer
+==============
 
-This feature requires ESP-IDF ``>=v4.3``.
+:link_to_translation:`zh_CN:[中文]`
 
-Espressif chips has a number of eFuses which can store system and user parameters. Each eFuse is a one-bit field which can be programmed to 1 after which it cannot be reverted back to 0. This feature is based on ESP-IDF `espfuse.py <https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/system/efuse.html#espefuse-py>`_ script to read and write efuses.
+This feature requires ESP-IDF ``>=v4.3``.
 
-1. Select the Serial Port:
+Espressif chips have several eFuses that store system and user parameters. Each eFuse is a one-bit field that can be programmed to 1 and cannot be reverted to 0. This feature uses the ESP-IDF `espfuse.py <https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/system/efuse.html#espefuse-py>`_ script to read and write eFuses.
 
-- Navigate to **View** > **Command Palette**.
+1.  Select the Serial Port:
 
-- Type **ESP-IDF: Select Port to Use** and select the command to specify the serial port of your device.
+    - Navigate to ``View`` > ``Command Palette``.
+    - Type ``ESP-IDF: Select Port to Use`` and select the command to specify your device's serial port.
 
-2. Click the ``ESP-IDF Explorer`` in the `Visual Studio Code Activity bar <https://code.visualstudio.com/docs/getstarted/userinterface>`_. On the ``EFUSE EXPLORER`` section, click the ``Connect your Board First``.
+2.  Click ``ESP-IDF: Explorer`` in the Visual Studio Code activity bar. In the ``eFuse Explorer`` section, click ``Connect your Board First``.
 
-.. image:: ../../../media/tutorials/efuse/efuse_connect.png
+    .. image:: ../../../media/tutorials/efuse/efuse_connect.png
 
-3. A list of EFuses categories will now be shown in a tree structure.
+3.  A list of eFuse categories appears in a tree structure.
 
-.. image:: ../../../media/tutorials/efuse/efuse_list.png
+    .. image:: ../../../media/tutorials/efuse/efuse_list.png
 
-4. If you click on any category, you will see the category Efuses and Values.
+4.  Click any category to view the eFuses and their values.
 
-.. image:: ../../../media/tutorials/efuse/efuse_expanded.png
+    .. image:: ../../../media/tutorials/efuse/efuse_expanded.png

docs_espressif/en/additionalfeatures/hints-viewer.rst

@@ -1,24 +1,28 @@
+.. _hints_viewer:
+
 Hints Viewer
-=================
+============
+
+:link_to_translation:`zh_CN:[中文]`
 
 This feature enhances your development experience by providing helpful hints for errors detected in your code.
 
-``idf.py`` will try to suggest hints on how to resolve errors. It works with a database of hints stored in ``$IDF_PATH/tools/idf_py_actions/hints.yml`` and the hints will be printed if a match is found for the given error. 
+The ``idf.py`` tool suggests hints for resolving errors. It uses a database of hints stored in ``$IDF_PATH/tools/idf_py_actions/hints.yml``. Hints will be printed if a match is found for the given error.
 
 Hover Over Errors for Hints
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-When you hover over errors in the text editor, if the error matches one listed in our hints.yml file, a hint is displayed.
+When you hover over errors in the text editor, a hint displays if the error matches one listed in the ``hints.yml`` file.
 
 .. image:: ../../../media/tutorials/hints/hover.gif
 
 Bottom Panel for Hints
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~
 
-1. **Automatic Updates:** The ESP-IDF bottom panel automatically updates to display hints based on the errors in your currently opened file.
+1.  **Automatic Updates:** The ESP-IDF bottom panel updates automatically to display hints based on the errors in your currently opened file.
 
-.. image:: ../../../media/tutorials/hints/bottom_panel.png
+    .. image:: ../../../media/tutorials/hints/bottom_panel.png
 
-2. **Manual Search:** You can manually search for hints by copy pasting errors.
+2.  **Manual Search:** You can manually search for hints by copying and pasting errors.
 
-.. image:: ../../../media/tutorials/hints/manual_search.gif
+    .. image:: ../../../media/tutorials/hints/manual_search.gif

docs_espressif/en/additionalfeatures/install-esp-components.rst

@@ -1,24 +1,27 @@
 Install ESP-IDF Components
-===============================
+==========================
 
-The **ESP-IDF: ESP Component Registry** will launch a UI showing the `ESP Component Registry <https://components.espressif.com>`_.
+:link_to_translation:`zh_CN:[中文]`
+
+The ``ESP-IDF: Show ESP Component Registry`` command launches a UI showing the `ESP Component Registry <https://components.espressif.com>`_.
 
 .. image:: ../../../media/tutorials/features/component-registry.png
 
-You can browse many different ESP components and install them on your current ESP-IDF project with the ``Install`` button.
+You can browse various ESP components and install them in your current ESP-IDF project using the ``Install`` button.
 
 .. image:: ../../../media/tutorials/features/install-component.png
 
-You can also create a new project from ESP component example using the ``Create project from this template`` button.
+You can also create a new project from an ESP component example using the ``Create project from this example`` button.
 
 .. image:: ../../../media/tutorials/features/create-project-from-component-example.png
 
-Find out more about the `ESP Component Registry official documentation <https://docs.espressif.com/projects/idf-component-manager/en/latest/>`_.
+For more information, refer to `ESP Component Registry Documentation <https://docs.espressif.com/projects/idf-component-manager/en/latest/>`_.
 
 Install Arduino-ESP32 as Component
--------------------------------------
+----------------------------------
 
-The **ESP-IDF: Add Arduino-ESP32 as ESP-IDF Component** command will add `Arduino-ESP32 <https://github.com/espressif/arduino-esp32>`_ as a ESP-IDF component in your current directory (``${CURRENT_DIRECTORY}/components/arduino``). You can also use the **ESP-IDF: Create Project from Extension Template** command with ``arduino-as-component`` template to create a new project directory that includes Arduino-esp32 as an ESP-IDF component.
+The ``ESP-IDF: Add Arduino-ESP32 as ESP-IDF Component`` command adds `Arduino-ESP32 <https://github.com/espressif/arduino-esp32>`_ as an ESP-IDF component in your current directory (``${CURRENT_DIRECTORY}/components/arduino``). You can also use the ``ESP-IDF: Create Project from Extension Template`` command with the ``arduino-as-component`` template to create a new project directory that includes Arduino-ESP32 as an ESP-IDF component.
 
 .. note::
-  Not all versions of ESP-IDF are supported. Make sure to check `Arduino-ESP32 <https://github.com/espressif/arduino-esp32>`_ to see if your ESP-IDF version is compatible.
+
+    Not all versions of ESP-IDF are supported. Check `Arduino-ESP32 <https://github.com/espressif/arduino-esp32>`_ to see if your ESP-IDF version is compatible.

docs_espressif/en/additionalfeatures/nvs-partition-editor.rst

@@ -1,40 +1,41 @@
 NVS Partition Editor
-=========================
+====================
 
-The **ESP-IDF: Open NVS Partition Editor** allows you to create a NVS partition binary file based on key-value pairs in CSV file. 
+:link_to_translation:`zh_CN:[中文]`
 
-The resulting binary file is compatible with NVS architecture defined in `ESP-IDF Non Volatile Storage <https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/storage/nvs_flash.html>`_.
+The ``ESP-IDF: Open NVS Partition Editor`` command allows you to create a NVS partition binary file based on key-value pairs in a CSV file.
 
-The expected CSV format is:
+The resulting binary file is compatible with the NVS architecture defined in `ESP-IDF Non-Volatile Storage Library <https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/storage/nvs_flash.html>`_.
 
-.. code-block::
+The expected CSV format is as follows:
 
-  key,type,encoding,value     <-- column header (must be the first line)
-  namespace_name,namespace,,  <-- First entry must be of type "namespace"
-  key1,data,u8,1
-  key2,file,string,/path/to/file
+.. code-block::
 
-1. Click menu **View** > **Command Palette...** 
-2. Type **ESP-IDF: Open NVS Partition Editor** and select the command (to create a new file) or right click an existing partition table CSV file.
+    key,type,encoding,value     <-- column header (must be the first line)
+    namespace_name,namespace,,  <-- First entry must be of type "namespace"
+    key1,data,u8,1
+    key2,file,string,/path/to/file
 
-3. If creating a new file, choose the name of the file. It will be created in the current editor directory.
+1.  Go to ``View`` > ``Command Palette``.
+2.  Type ``ESP-IDF: Open NVS Partition Editor`` and select the command to create a new file or right-click an existing partition table CSV file.
+3.  If creating a new file, choose the file name. It will be created in the current editor directory.
 
-.. note::
-  Make sure first 2 lines of existing CSV file are as shown in expected CSV format above.
+    .. note::
 
-4. Make desired changes to CSV file.
+        Ensure the first two lines of the existing CSV file match the expected CSV format above.
 
-.. note::
-  Make sure that the size of partition is enough for inserted data.
+4.  Make desired changes to CSV file.
 
-.. image:: ../../../media/tutorials/nvs/nvs_partition_editor.png
+    .. note::
 
-5. Save the CSV data (First time will create the CSV file).
+        Ensure the partition size is sufficient for the inserted data.
 
-6. (OPTIONAL) Enable encryption of the binary. If encrypt is enable, can disable the generate key option to use your own key if desired, in which case you need to set the key absolute path.
+    .. image:: ../../../media/tutorials/nvs/nvs_partition_editor.png
 
-7. Generate the partition binary.
+5.  Save the CSV data. The first save will create the CSV file.
+6.  (OPTIONAL) Enable encryption of the binary. If encryption is enabled, you can disable the generate key option to use your own key. In this case, set the key's absolute path.
+7.  Generate the partition binary.
 
 This feature is based on ESP-IDF `NVS Partition Generator Utility <https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/storage/nvs_partition_gen.html>`_.
 
-Make sure extension is configured as shown in :ref:`Install ESP-IDF and Tools <installation>` documentation for this feature to work properly.
+Make sure the extension is configured as shown in :ref:`Install ESP-IDF and Tools <installation>` documentation for this feature to work properly.

docs_espressif/en/additionalfeatures/partition-table-editor.rst

@@ -1,26 +1,28 @@
 Partition Table Editor
-=========================
+======================
 
-- Click menu **View** > **Command Palette...** 
-- Type **ESP-IDF: SDK Configuration Editor** and select the command.
+:link_to_translation:`zh_CN:[中文]`
 
-.. image:: ../../../media/tutorials/partition_table/sdkconfig.png
+- Go to ``View`` > ``Command Palette``.
+- Type ``ESP-IDF: SDK Configuration Editor`` and select the command.
 
-- Search for ``partition_table_custom`` and select ``Custom Partition Table CSV`` from Partition Table and set the filename. It will search this file in your current project directory.
+    .. image:: ../../../media/tutorials/partition_table/sdkconfig.png
 
-.. image:: ../../../media/tutorials/partition_table/partition_table_custom.png
+- Search for ``partition_table_custom``, select ``Custom Partition Table CSV`` from the Partition Table, and set the filename. The tool will search for this file in your current project directory.
 
-- If the partition table file doesn't exists, when you execute the command the file will be created. But if the partition table file already exists, make sure that the first two lines of the partion table CSV file are:
+    .. image:: ../../../media/tutorials/partition_table/partition_table_custom.png
 
-.. code-block::
+- If the partition table file does not exist, executing the command will create the file. If the partition table file already exists, ensure that the first two lines of the partition table CSV file match the format below:
 
-  # ESP-IDF Partition Table
-  # Name, Type, SubType, Offset, Size, Flag
+    .. code-block::
 
-- Once partition table editor is open, you can edit the partition table as desired. For more information please refer to `ESP-IDF Partition Tables <https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-guides/partition-tables.html>`_ documentation.
+        # ESP-IDF Partition Table
+        # Name, Type, SubType, Offset, Size, Flag
 
-.. image:: ../../../media/tutorials/partition_table/partition_editor.png
+- Once the partition table editor is open, you can edit the partition table as needed. For more information, refer to `ESP-IDF Partition Tables <https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-guides/partition-tables.html>`_.
 
-- Once you are satisfied press ``Save`` to save the changes, ``this will override the content of CSV file``.
+    .. image:: ../../../media/tutorials/partition_table/partition_editor.png
 
-- Now you can click the ``Select Flash Method``, ``Build``, ``Flash`` right top buttons in order to build and flash the partition table to the chip.
+- Once you are satisfied, click ``Save`` to save the changes. This will override the content of the CSV file.
+
+- Now you can click ``Select Flash Method``, ``Build``, and ``Flash`` buttons at the top right to build and flash the partition table to the chip.