docs: Provide CN translation for 3 index docs

Author: Shen765

docs_espressif/en/additionalfeatures/coverage.rst

@@ -5,7 +5,7 @@ Source code coverage is data indicating the count and frequency of every program
 
 Your ESP-IDF project should be configured to generate ``gcda/gcno`` coverage files using ``gcov``. Please read `GCOV Code Coverage <https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-guides/app_trace.html#gcov-source-code-coverage>`_ to learn more about code coverage with GCOV in ESP-IDF projects.
 
-You can use the **ESP-IDF: Configure Project SDKConfig for Coverage** to set required configuration in the SDK Configuration Editor. 
+You can use the **ESP-IDF: Configure Project SDKConfig for Coverage** to set required configuration in the SDK Configuration Editor.
 
 Code coverage example
 -------------------------------
@@ -14,7 +14,7 @@ Let's use the ESP-IDF `GCOV Example <https://github.com/espressif/esp-idf/tree/m
 
 - Navigate to **View** > **Command Palette**.
 
-- Type **ESP-IDF: Show Examples Projects** and choose ``Use Current ESP-IDF (/path/to/esp-idf)``. 
+- Type **ESP-IDF: Show Examples Projects** and choose ``Use Current ESP-IDF (/path/to/esp-idf)``.
 
 If you don't see the option, please review the current ESP-IDF setup in :ref:`Installation <installation>`.
 
@@ -76,4 +76,4 @@ Visual Studio code support ``"red"``, ``rgb(255,0,120)`` or ``rgba(120,0,0,0.1)`
 .. image:: ../../../media/tutorials/coverage/html_report.png
 
 .. note::
-  * Check the :ref:`Troubleshooting <troubleshooting>` section if you have any issues.
+  * Check the :ref:`Troubleshooting <troubleshooting-section>` section if you have any issues.

docs_espressif/en/faqs.rst

@@ -3,7 +3,7 @@ FAQs
 
 **I have an issue or error with the Visual Studio Code extension, what can I do?**
 
-Take a look at the :ref:`Troubleshooting documentation <troubleshooting>` so you can see the error in the extension. You might be able to fix the issue yourself or give enough information for others to help you with the problem.
+Take a look at the :ref:`Troubleshooting documentation <troubleshooting-section>` so you can see the error in the extension. You might be able to fix the issue yourself or give enough information for others to help you with the problem.
 
 Search the `ESP-IDF extension repository <https://github.com/espressif/vscode-esp-idf-extension>`_ for Visual Studio Code first and then this forum, your issue might already be solved.
 
@@ -15,7 +15,7 @@ Check out `ESP-FAQ <https://docs.espressif.com/projects/espressif-esp-faq/en/lat
 
 First of all, have you configure the IDE plugin/extension properly ? Make sure to review the documentation to :ref:`Install ESP-IDF and Tools <installation>`.
 
-There was error in the setup or in your project code itself. Gather the :ref:`Troubleshooting documentation <troubleshooting>` and look for errors in these files. 
+There was error in the setup or in your project code itself. Gather the :ref:`Troubleshooting documentation <troubleshooting-section>` and look for errors in these files.
 
 Chances are that your issue have been posted before in the `ESP-IDF github repository <https://github.com/espressif/vscode-esp-idf-extension>`_ or `ESP-IDF forum <https://esp32.com>`_. If not, you can open a new GitHub issue or open a topic in the forum.
 
@@ -47,7 +47,7 @@ Take a look at `Configure JTAG Interface <https://docs.espressif.com/projects/es
 On Windows, you could try using `IDF-ENV <https://github.com/espressif/idf-env>`_ just running the following command in a Powershell terminal:
 
 .. code-block::
-  
+
   Invoke-WebRequest 'https://dl.espressif.com/dl/idf-env/idf-env.exe' -OutFile .\idf-env.exe; .\idf-env.exe driver install --espressif --ftdi --silabs
 
 Drivers are also part of the `IDF-Installer <https://dl.espressif.com/dl/esp-idf>`_.
@@ -61,7 +61,7 @@ Using the `IDF-ENV <https://github.com/espressif/idf-env>`_ you can manage sever
 First review the `ESP-IDF JTAG Debugging documentation <https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-guides/jtag-debugging/index.html#jtag-debugging-setup-openocd>`_ to understand how debugging works and the expected configuration of your device.
 The debugger is connected to OpenOCD. Please take a look at `OpenOCD Troubleshooting FAQ <https://github.com/espressif/openocd-esp32/wiki/Troubleshooting-FAQ>`_ for any OpenOCD errors you might have encountered.
 
-Check your IDE integration log files and post an issue in the respective GitHub repository if the issue is not related to OpenOCD itself. Take a look at the :ref:`Troubleshooting documentation <troubleshooting>` so you can see the error in the extension.
+Check your IDE integration log files and post an issue in the respective GitHub repository if the issue is not related to OpenOCD itself. Take a look at the :ref:`Troubleshooting documentation <troubleshooting-section>` so you can see the error in the extension.
 
 **I have an issue flashing my Espressif device, What should i do?**
 

docs_espressif/en/installation.rst

@@ -1,84 +1,92 @@
 .. _installation:
 
 Install ESP-IDF and Tools
-===============================
+=========================
 
-After installing Visual Studio Code you need to install the ESP-IDF extension for Visual Studio Code.
+:link_to_translation:`zh_CN:[中文]`
 
-- Navigate to  **View** > **Extensions** or keyboard shortcut :kbd:`Ctrl+Shift+X` in Windows/Linux or :kbd:`Shift+⌘+X` in MacOS.
+After installing Visual Studio Code (VS Code), install the ESP-IDF extension for VS Code.
 
-- Search for `ESP-IDF Extension <https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension>`_ from the list of extensions.
+- Navigate to ``View`` > ``Extensions`` or the keyboard shortcut :kbd:`Ctrl+Shift+X` in Windows/Linux or :kbd:`Shift+⌘+X` in macOS.
 
-1. Install the ESP-IDF extension.
+- Search for `ESP-IDF <https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension>`_ in the list of extensions.
 
-- Navigate to **View** > **Command Palette**.
+1.  Install the ESP-IDF extension.
 
-- Type **ESP-IDF: Configure ESP-IDF Extension** and select the command to specify to launch the setup wizard. A loading notification will be shown and later the setup wizard will appear.
+    - Navigate to ``View`` > ``Command Palette``.
 
-.. note::
-  
-  * For versions of ``ESP-IDF < 5.0``, spaces are not supported inside configured paths.
+    - Type ``ESP-IDF: Configure ESP-IDF Extension`` and select the command to launch the setup wizard. A loading notification will appear, followed by the setup wizard.
 
-.. image:: ../../media/tutorials/setup/select-mode.png
+    .. note::
 
-2. Choose **Express** and select the download server:
+        For versions of ESP-IDF < 5.0, spaces are not supported in configured paths.
 
-- **Espressif**: Faster speed in China using Espressif Download servers links.
-- **Github**: Using github releases links.
+    .. image:: ../../media/tutorials/setup/select-mode.png
 
-3. Pick an ESP-IDF version to download or use the ``Find ESP-IDF in your system`` option to search for existing ESP-IDF directory.
+2.  Choose ``Express`` and select the download server:
 
-.. image:: ../../media/tutorials/setup/select-esp-idf.png
+    - ``Espressif``: Faster speed in China using Espressif download servers.
+    - ``Github``: Using GitHub release links.
 
-- Choose the location for ESP-IDF Tools ( ``IDF_TOOLS_PATH``) which is ``%USERPROFILE%\.espressif`` on Windows and ``$HOME\.espressif`` on MacOS/Linux by default.
+3.  Pick an ESP-IDF version to download or use the ``Find ESP-IDF in your system`` option to search for an existing ESP-IDF directory.
 
-.. note::
-  * Make sure that ``IDF_TOOLS_PATH`` doesn't have any spaces to avoid any build issues. Also make sure that ``IDF_TOOLS_PATH`` is not the same directory as ``IDF_PATH``.
+    .. image:: ../../media/tutorials/setup/select-esp-idf.png
 
-.. note::
-  * For MacOS/Linux users, select the Python executable to use to create ESP-IDF python virtual environment.
+    Choose the location for ESP-IDF Tools (``IDF_TOOLS_PATH``), which defaults to ``%USERPROFILE%\.espressif`` on Windows and ``$HOME\.espressif`` on macOS/Linux.
 
-4. Click ``Install`` to begin download and install of ESP-IDF and ESP-IDF Tools.
+    .. note::
 
-5. A page will appear with the setup progress status showing:
+        Make sure that ``IDF_TOOLS_PATH`` does not contain spaces to avoid build issues. Also, ensure that ``IDF_TOOLS_PATH`` is not the same directory as ``IDF_PATH``.
 
-- ESP-IDF download progress
-- ESP-IDF Tools download and install progress
-- Creation of a python virtual environment and ESP-IDF python requirements.
+    .. note::
 
-.. image:: ../../media/tutorials/setup/install-status.png
+        For macOS/Linux users, select the Python executable to create the ESP-IDF Python virtual environment.
 
-6. If everything is installed correctly, you will see a message that all settings have been configured. 
+4.  Click ``Install`` to begin downloading and installing ESP-IDF and ESP-IDF Tools.
 
-.. image:: ../../media/tutorials/setup/install-complete.png
+5.  A page will appear showing the setup progress status:
 
-.. note::
-  For Linux users, a message is shown to add OpenOCD rules in ``/etc/udev/rules.d`` which you need to run with sudo privileges.
+    - ESP-IDF download progress
+    - ESP-IDF Tools download and installation progress
+    - Creation of a Python virtual environment and installation of ESP-IDF Python requirements
 
-7. Next step is to :ref:`Start a ESP-IDF Project <start a esp-idf project>`.
+    .. image:: ../../media/tutorials/setup/install-status.png
+
+6.  If everything installs correctly, you will see a message indicating that all settings have been configured.
+
+    .. image:: ../../media/tutorials/setup/install-complete.png
+
+    .. note::
+
+        For Linux users, a message will prompt you to add OpenOCD rules in ``/etc/udev/rules.d``. You need to run this with sudo privileges.
+
+7.  The next step is to :ref:`Create an ESP-IDF Project <create an esp-idf project>`.
+
+    .. warning::
+
+        Check the :ref:`Troubleshooting <troubleshooting-section>` section if you encounter any issues during installation.
 
-.. warning::
-  Check the :ref:`Troubleshooting <troubleshooting>` section if you have any issues during installation.
 
 Uninstall ESP-IDF VS Code Extension
--------------------------------------
+-----------------------------------
 
 To uninstall the ESP-IDF VS Code extension, follow these steps:
 
-1. Open Command Palette (F1) and type **ESP-IDF: Remove All ESP-IDF Settings** and select the command to remove all ESP-IDF settings.
+1.  Open Command Palette (press shortcut F1) and type ``ESP-IDF: Clear Saved ESP-IDF Setups``. Select the command to remove all ESP-IDF settings.
+
+2.  Navigate to ``View`` > ``Extensions`` or use the keyboard shortcut :kbd:`Ctrl+Shift+X` in Windows/Linux or :kbd:`Shift+⌘+X` in macOS.
+
+3.  Search for `ESP-IDF` and click the ``Uninstall`` button.
 
-2. Navigate to **View** > **Extensions** or use the keyboard shortcut :kbd:`Ctrl+Shift+X` in Windows/Linux or :kbd:`Shift+⌘+X` in MacOS.
+4.  Remove the following folders:
 
-3. Search for `ESP-IDF` and click on the **Uninstall** button.
+    - Go to your `${VSCODE_EXTENSION_DIR}` and delete the ESP-IDF plugin folder.
 
-4. Ensure you remove the following folders:
+    - `${VSCODE_EXTENSION_DIR}` is the location of the extension:
 
-   - Go to your `${VSCODE_EXTENSION_DIR}` and delete the ESP-IDF plugin folder.
-   
-   - `${VSCODE_EXTENSION_DIR}` is the location of the extension:
-     - **Windows**: `%USERPROFILE%\.vscode\extensions\espressif.esp-idf-extension-VERSION\`
-     - **MacOS/Linux**: `$HOME/.vscode/extensions/espressif.esp-idf-extension-VERSION/`
+      - **Windows**: ``%USERPROFILE%/.vscode/extensions/espressif.esp-idf-extension-VERSION/``
+      - **macOS/Linux**: ``$HOME/.vscode/extensions/espressif.esp-idf-extension-VERSION/``
 
-.. note::
+    .. note::
 
-  Make sure to replace `VERSION` with the actual version number of the ESP-IDF extension installed.
+        Make sure to replace `VERSION` with the actual version number of the installed ESP-IDF extension.