Merge pull request #1669 from espressif/docs/translate_qemu_resubmit

docs: Provide CN translation for qemu.rst (resubmit)

Author: Shen7436

docs_espressif/en/additionalfeatures.rst

@@ -24,7 +24,7 @@ Additional IDE Features
     NVS Partition Table Editor<additionalfeatures/nvs-partition-editor>
     Partition Table Editor<additionalfeatures/partition-table-editor>
     Project Configuration Editor<additionalfeatures/project-configuration>
-    QEMU<additionalfeatures/qemu>
+    QEMU Integration<additionalfeatures/qemu>
     ESP RainMaker<additionalfeatures/rainmaker>
     Unit Testing<additionalfeatures/unit-testing>
     Working with Multiple Projects<additionalfeatures/multiple-projects>

docs_espressif/en/additionalfeatures/qemu.rst

@@ -1,33 +1,35 @@
 .. _qemu:
 
-ESP-IDF QEMU Integration with Visual Studio Code
-===================================================
+QEMU Integration 
+================
 
-When you create a project using this extension commands, there is Dockerfile which can be used with the `Microsoft Remote Containers Extension <https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers>`_. You can open any project inside a container with the **Remote Containers: Open Folder in Container..** command. 
+When you create a project using this extension's commands, a Dockerfile is included for use with the `Dev Containers <https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers>`_. You can open any project inside a container with the ``Dev Containers: Open Folder in Container`` command.
 
-ESP-IDF setup can include a fork of `Espressif QEMU fork <https://github.com/espressif/qemu>`_ for Espressif devices, which can be used for emulated development. You can make sure is installed it by running ``python $IDF_PATH/tools/idf_tools.py install qemu-xtensa qemu-riscv32`` in the **ESP-IDF: Open ESP-IDF Terminal** terminal.
+The ESP-IDF setup can include a fork of the `Espressif QEMU <https://github.com/espressif/qemu>`_ for Espressif devices, which is used for emulated development. Ensure it is installed by running ``python $IDF_PATH/tools/idf_tools.py install qemu-xtensa qemu-riscv32`` in the ``ESP-IDF: Open ESP-IDF Terminal`` terminal.
 
 .. note::
-  * The **ESP-IDF: Add Docker Container Configuration** command can be used to add these files to the current project directory.
+
+    The ``ESP-IDF: Add Docker Container Configuration`` command can be used to add these files to the current project directory.
 
 Development steps:
 
-1. Prepare a project folder in a container based on the dockerfile in the templates ``.devcontainer`` directory in this repository. For this you can:
-   - Create a project using **ESP-IDF: New Project** command which will include the ``.devcontainer`` directory.
-   - Use the **ESP-IDF: Add Docker Container Configuration** command to add the ``.devcontainer`` files to the currently opened project directory.
-2. Use the **Remote Containers: Open Folder in Container..** command to open the folder within the container.
-3. The **Remote Containers** will build the container from the Dockerfile (if it has not been created before) and install this extension on the container.
-4. The extension should be self configured, otherwise run the setup wizard.
-5. Write your code and build the project with the **ESP-IDF: Build your Project** command.
-6. Use the **ESP-IDF: Launch QEMU Server** command or the **[QEMU Server]** link in the activity bar to launch QEMU with the binaries from the build directory.
-7. You can use the **ESP-IDF: Monitor QEMU Device** command to launch a terminal running IDF Monitor on QEMU.
-8. If you want to launch a QEMU debug session, use the **ESP-IDF: Launch QEMU Debug Session** commmand, which will stop any existing QEMU server and launch a new QEMU server for debugging.
+1.  Prepare a project folder in a container based on the Dockerfile in the template's ``.devcontainer`` directory in this repository. For this you can:
+
+    - Create a project using the ``ESP-IDF: New Project`` command, which includes the ``.devcontainer`` directory.
+    - Use the ``ESP-IDF: Add Docker Container Configuration`` command to add the ``.devcontainer`` files to the currently opened project directory.
 
-You can use the ``idf.qemuDebugMonitor`` configuration setting to enable the monitor to start after QEMU debug session is launched. If you want to pass additional arguments ``idf.qemuExtraArgs`` configuration setting can be used.
+2.  Use the ``Dev Containers: Open Folder in Container`` command to open the folder within the container.
+3.  The **Dev Containers** will build the container from the Dockerfile (if it has not been created before) and install this extension on the container.
+4.  The extension should be self-configured; otherwise, run the setup wizard.
+5.  Write your code and build the project with the ``ESP-IDF: Build your Project`` command.
+6.  Use the ``ESP-IDF: Launch QEMU Server`` command or the **[QEMU Server]** link in the activity bar to launch QEMU with the binaries from the build directory.
+7.  Use the ``ESP-IDF: Monitor QEMU Device`` command to launch a terminal running IDF Monitor on QEMU.
+8.  To launch a QEMU debug session, use the ``ESP-IDF: Launch QEMU Debug Session`` commmand, which will stop any existing QEMU server and launch a new QEMU server for debugging.
 
-An example of ``"idf.qemuExtraArgs": ["--qemu-extra-args"]`` can be used to pass additional arguments to QEMU directly while ``--flash-file`` or ``--efuse-file`` are idf.py specific arguments as described in **ESP-IDF QEMU Emulator** documentation below.
+Set the ``idf.qemuDebugMonitor`` configuration option to start the monitor after the QEMU debug session is launched. To pass additional arguments, set the ``idf.qemuExtraArgs`` configuration option.
 
-More information about how to use in `ESP-IDF QEMU Emulator <https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-guides/tools/qemu.html>`_.
+An example of ``"idf.qemuExtraArgs": ["--qemu-extra-args"]`` can be used to pass additional arguments to QEMU directly, while ``--flash-file`` or ``--efuse-file`` are ``idf.py`` specific arguments as described in the `ESP-IDF QEMU Emulator <https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-guides/tools/qemu.html>`_ documentation.
 
 .. note::
-  The extension assumes that ``qemu-system-xtensa`` or ``qemu-system-riscv32`` is available in the environment variable PATH to run **ESP-IDF: Monitor QEMU Device** and **ESP-IDF: Launch QEMU Debug Session**.
+
+    The extension assumes that ``qemu-system-xtensa`` or ``qemu-system-riscv32`` is available in the environment variable PATH to run ``ESP-IDF: Monitor QEMU Device`` and ``ESP-IDF: Launch QEMU Debug Session``.

docs_espressif/zh_CN/additionalfeatures.rst

@@ -15,6 +15,7 @@
     通过 USB 升级设备固件<additionalfeatures/dfu>
     Docker 容器<additionalfeatures/docker-container>
     ESP-IDF 终端<additionalfeatures/esp-terminal>
+    ESP-IDF 配置文件<additionalfeatures/esp-idf-profiles>
     eFuse 资源管理器<additionalfeatures/efuse>
     flash 加密<additionalfeatures/flash-encryption>
     堆跟踪<additionalfeatures/heap-tracing>

docs_espressif/zh_CN/additionalfeatures/esp-idf-profiles.rst

@@ -0,0 +1 @@
+.. include:: ../../en/additionalfeatures/esp-idf-profiles.rst

docs_espressif/zh_CN/additionalfeatures/qemu.rst

@@ -1 +1,35 @@
-.. include:: ../../en/additionalfeatures/qemu.rst
+.. _qemu:
+
+QEMU 模拟器
+===========
+
+使用该扩展的命令创建项目时，会包含 Dockerfile，用于配合 `Dev Containers <https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers>`_ 使用。使用 ``开发容器：在容器中打开文件夹`` 命令可以在容器中打开任意项目。
+
+安装 ESP-IDF 时会包含一个 `乐鑫 QEMU 分支 <https://github.com/espressif/qemu>`_，此分支可基于乐鑫设备进行仿真开发。运行 ``ESP-IDF：打开 ESP-IDF 终端`` 命令，在终端中执行 ``python $IDF_PATH/tools/idf_tools.py install qemu-xtensa qemu-riscv32``，确保安装该分支。
+
+.. note::
+
+    可以使用 ``ESP-IDF：添加 Docker 容器配置`` 命令，将这些文件添加到当前项目目录中。
+
+开发步骤：
+
+1.  基于本仓库模板的 ``.devcontainer`` 目录中的 Dockerfile，在容器中准备一个项目文件夹。你可以通过以下方式实现：
+
+    - 使用 ``ESP-IDF：新建项目`` 命令创建项目，该项目会包含 ``.devcontainer`` 目录。
+    - 使用 ``ESP-IDF：添加 Docker 容器配置`` 命令，将 ``.devcontainer`` 文件添加至当前已打开的项目目录。
+
+2.  使用 ``开发容器：在容器中打开文件夹`` 命令，在容器中打开项目文件夹。
+3.  **Dev Containers** 会根据 Dockerfile 构建容器（如果之前未构建过），并在容器中安装此扩展。
+4.  扩展应自动完成配置，如未完成，请运行设置向导。
+5.  编写代码，并使用 ``ESP-IDF：构建项目`` 命令构建项目。
+6.  使用 ``ESP-IDF：启动 QEMU 服务器`` 命令或活动栏中的 **[QEMU Server]** 链接，启动 QEMU，并加载构建目录中的二进制文件。  
+7.  使用 ``ESP-IDF：监视 QEMU 设备`` 命令，启动一个运行 IDF 监视器的终端，以监视 QEMU。 
+8.  要启动 QEMU 调试会话，请使用 ``ESP-IDF：启动 QEMU 调试会话`` 命令，该命令会停止当前的 QEMU 服务器并启动一个新的 QEMU 服务器以进行调试。
+
+设置 ``idf.qemuDebugMonitor`` 配置项，在启动 QEMU 调试会话后启动监视器。要传递额外参数，请设置 ``idf.qemuExtraArgs`` 配置项。
+
+例如，可以通过设置 ``"idf.qemuExtraArgs": ["--qemu-extra-args"]`` 向 QEMU 直接传递额外参数，而 ``--flash-file`` 或 ``--efuse-file`` 则属于 ``idf.py`` 特有的参数，详情请参阅 `ESP-IDF QEMU 模拟器 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32/api-guides/tools/qemu.html>`_ 文档。
+
+.. note::
+
+    扩展在运行 ``ESP-IDF：监视 QEMU 设备`` 和 ``ESP-IDF：启动 QEMU 调试会话`` 命令时，默认 ``qemu-system-xtensa`` 或 ``qemu-system-riscv32`` 已在环境变量 PATH 中可用。