doc(global): build cross-language links for translated documents

diff --git a/docs/en/get-started/add-idf_path-to-profile.rst b/docs/en/get-started/add-idf_path-to-profile.rst
index 60ca434814a7be8d4b0f6da3f82e3da3a21d7df8..8ce9a9ae6f5c60b48b1988a5b33c4f3d9bacf695 100644 (file)
--- a/docs/en/get-started/add-idf_path-to-profile.rst
+++ b/docs/en/get-started/add-idf_path-to-profile.rst
@@ -1,5 +1,6 @@
 Add IDF_PATH to User Profile
 ============================
+:link_to_translation:`zh_CN:[中文]`
 
 To preserve setting of ``IDF_PATH`` environment variable between system restarts, add it to the user profile, following instructions below.
 

diff --git a/docs/en/get-started/eclipse-setup-windows.rst b/docs/en/get-started/eclipse-setup-windows.rst
index a924d2dc7a9fd8c6c35594d5666d709a6ff5d2ea..2728eb297073bc7eadb034c0088f3aeaa8a0c4b4 100644 (file)
--- a/docs/en/get-started/eclipse-setup-windows.rst
+++ b/docs/en/get-started/eclipse-setup-windows.rst
@@ -1,6 +1,7 @@
 **********************
 Eclipse IDE on Windows
 **********************
+:link_to_translation:`zh_CN:[中文]`
 
 Configuring Eclipse on Windows requires some different steps. The full configuration steps for Windows are shown below.
 

diff --git a/docs/en/get-started/eclipse-setup.rst b/docs/en/get-started/eclipse-setup.rst
index 9ceb3c7791ba5d91e7cf120ad8bb0f93875db8ad..7d17d6c1590b5d37a69ddfa66191f7c46eb5a7af 100644 (file)
--- a/docs/en/get-started/eclipse-setup.rst
+++ b/docs/en/get-started/eclipse-setup.rst
@@ -1,6 +1,7 @@
 ********************************
 Build and Flash with Eclipse IDE
 ********************************
+:link_to_translation:`zh_CN:[中文]`
 
 .. _eclipse-install-steps:
 

diff --git a/docs/en/get-started/establish-serial-connection.rst b/docs/en/get-started/establish-serial-connection.rst
index d4c0943a4450e49c5eefb7ec2f75c2076518ce06..e54345d83148bd6b00bfaa4c5abe2379a248e787 100644 (file)
--- a/docs/en/get-started/establish-serial-connection.rst
+++ b/docs/en/get-started/establish-serial-connection.rst
@@ -1,5 +1,6 @@
 Establish Serial Connection with ESP32
 ======================================
+:link_to_translation:`zh_CN:[中文]`
 
 This section provides guidance how to establish serial connection between ESP32 and PC.
 

diff --git a/docs/en/get-started/get-started-pico-kit.rst b/docs/en/get-started/get-started-pico-kit.rst
index 831de1ac1462b43ad9ca6431b751b913f85ded08..12ff80aed41d5ce300af1c2e9cc0be91790f6ce8 100644 (file)
--- a/docs/en/get-started/get-started-pico-kit.rst
+++ b/docs/en/get-started/get-started-pico-kit.rst
@@ -1,5 +1,6 @@
 ESP32-PICO-KIT V4 Getting Started Guide\r
 =======================================\r
+:link_to_translation:`zh_CN:[中文]`\r
 \r
 This user guide shows how to get started with the ESP32-PICO-KIT V4 mini development board. For description of other versions of the ESP32-PICO-KIT check :doc:`../hw-reference/index`.\r
 \r

diff --git a/docs/en/get-started/idf-monitor.rst b/docs/en/get-started/idf-monitor.rst
index cf1deec35481dca61aeae9a185b8fb3c8f22ef31..09291a3d3f4223f2508b7eeeabbd153542e2fa8d 100644 (file)
--- a/docs/en/get-started/idf-monitor.rst
+++ b/docs/en/get-started/idf-monitor.rst
@@ -1,6 +1,7 @@
 ***********
 IDF Monitor
 ***********
+:link_to_translation:`zh_CN:[中文]`
 
 The IDF Monitor tool is a Python program which runs when the ``make monitor`` target is invoked in IDF.
 

diff --git a/docs/en/get-started/index.rst b/docs/en/get-started/index.rst
index 9a2d3779caa50aed59edc66fc5f5e01e488ffe35..9e33e634964a090187b9f523bc4270858659b38a 100644 (file)
--- a/docs/en/get-started/index.rst
+++ b/docs/en/get-started/index.rst
@@ -1,6 +1,7 @@
 ***********\r
 Get Started\r
 ***********\r
+:link_to_translation:`zh_CN:[中文]`\r
 \r
 This document is intended to help users set up the software environment for development of applications using hardware based on the Espressif ESP32. Through a simple example we would like to illustrate how to use ESP-IDF (Espressif IoT Development Framework), including the menu based configuration, compiling the ESP-IDF and firmware download to ESP32 boards. \r
 \r

diff --git a/docs/en/get-started/linux-setup.rst b/docs/en/get-started/linux-setup.rst
index 8004c37ee7760f1b0550863d81889d76edfe501f..bc4102a8563646d0ac66eafc6725afaee87a0385 100644 (file)
--- a/docs/en/get-started/linux-setup.rst
+++ b/docs/en/get-started/linux-setup.rst
@@ -1,6 +1,7 @@
 *************************************
 Standard Setup of Toolchain for Linux
 *************************************
+:link_to_translation:`zh_CN:[中文]`
 
 
 Install Prerequisites

diff --git a/docs/en/get-started/macos-setup.rst b/docs/en/get-started/macos-setup.rst
index 14764601b5c01a8e97c8a91d9fbf46213c26c4fe..16123cb03abd2d6884ce9f033af1a9bbd2487403 100644 (file)
--- a/docs/en/get-started/macos-setup.rst
+++ b/docs/en/get-started/macos-setup.rst
@@ -1,6 +1,7 @@
 **************************************
 Standard Setup of Toolchain for Mac OS
 **************************************
+:link_to_translation:`zh_CN:[中文]`
 
 Install Prerequisites
 =====================

diff --git a/docs/en/get-started/make-project.rst b/docs/en/get-started/make-project.rst
index d85b2a91c0c6796408788652f853971a1a5954e6..956b097d041a6daf975f81fc2fee854534917d7d 100644 (file)
--- a/docs/en/get-started/make-project.rst
+++ b/docs/en/get-started/make-project.rst
@@ -1,5 +1,6 @@
 Build and Flash with Make
 =========================
+:link_to_translation:`zh_CN:[中文]`
 
 
 Finding a project

diff --git a/docs/en/get-started/windows-setup.rst b/docs/en/get-started/windows-setup.rst
index e2adebde2916fb19b5f1b5bea30a8a5782ac3992..9b143920b95ced92c8d0e5c59a6ee8bee698d35a 100644 (file)
--- a/docs/en/get-started/windows-setup.rst
+++ b/docs/en/get-started/windows-setup.rst
@@ -1,6 +1,7 @@
 ***************************************
 Standard Setup of Toolchain for Windows
 ***************************************
+:link_to_translation:`zh_CN:[中文]`
 
 Introduction
 ============

diff --git a/docs/zh_CN/get-started/add-idf_path-to-profile.rst b/docs/zh_CN/get-started/add-idf_path-to-profile.rst
index 1af406efdadd530e8e03ba6b218ec5032afacb84..61e8d3dbb0bd47643bb2b641ddeb49925f001e5d 100644 (file)
--- a/docs/zh_CN/get-started/add-idf_path-to-profile.rst
+++ b/docs/zh_CN/get-started/add-idf_path-to-profile.rst
@@ -1,5 +1,6 @@
 在用户配置文件中添加 IDF_PATH
 ==============================
+:link_to_translation:`en:[English]`
 
 为了在系统多次重新启动时保留 “IDF_PATH” 环境变量的设置，请按照以下说明将其添加到用户配置文件中。
 
@@ -60,4 +61,4 @@ Linux and MacOS
 
     export IDF_PATH=~/esp/esp-idf
 
-如果您从 :ref:`get-started-setup-path` 小节跳转到了这里，在安装用于 ESP32 开发的软件时，返回到 :ref:`get-started-start-project` 小节。
\ No newline at end of file
+如果您从 :ref:`get-started-setup-path` 小节跳转到了这里，在安装用于 ESP32 开发的软件时，返回到 :ref:`get-started-start-project` 小节。

diff --git a/docs/zh_CN/get-started/eclipse-setup-windows.rst b/docs/zh_CN/get-started/eclipse-setup-windows.rst
index ba15bc9dba9648e69692d487ca226cd03a777601..4047dc939e86a221ff1370bff53c04ff6acdd733 100644 (file)
--- a/docs/zh_CN/get-started/eclipse-setup-windows.rst
+++ b/docs/zh_CN/get-started/eclipse-setup-windows.rst
@@ -1,6 +1,7 @@
 *****************************************************
 Eclipse IDE 的创建和烧录指南（Windows 平台）
 *****************************************************
+:link_to_translation:`en:[English]`
 
 Windows 平台上的 Eclipse 配置略有不同，具体步骤请见下文。
 
@@ -78,4 +79,4 @@ Windows 平台的 Eclipse 介绍到此结束，下方将主要将介绍一些关
 * 首先，xtensa-esp32-elf-gcc 交叉编译器 *并非* Cygwin 工具链，但我们会在 Eclipse 中指定其为 Cygwin 工具链。主要原因在于：msys2 需要使用 Cygwin，并支持 Unix 风格的路径，即 ``/c/blah``，而非 ``c:/blah`` 或 ``c:\\blah``。特别需要说明的是，``xtensa-esp32-elf-gcc`` 会“告知” Eclipse 的 ``built-in compiler settings`` 功能，其内置 “include” 目录全部位于 ``/usr/`` 路径下，这也是 Eclipse 唯一可以解析的 ``Unix/Cygwin`` 风格路径。通过在 Eclipse 中指定 ``xtensa-esp32-elf-gcc`` 交叉编译器为 Cygwin 编译器，可以让 Eclipse 使用 cygpath 实用程序直接内部解析路径。
 
 
-* 在解析 ESP-IDF 的 make 结果时也经常会出现同样的问题。Eclipse 可以解析 make 的结果，查找头文件目录，但是无法脱离 ``cygpath``，直接解析类似 ``/c/blah`` 的目录。``Eclipse Build Output Parser`` 将利用该机制确认是否调用 ``cygpath``，但由于未知原因，目前 ESP-IDF 配置并不会触发该功能。出于这个原因，我们会使用 ``eclipse_make.py`` 包装脚本调用 ``make``，然后使用 ``cygpath`` 处理 Eclipse 的结果。
\ No newline at end of file
+* 在解析 ESP-IDF 的 make 结果时也经常会出现同样的问题。Eclipse 可以解析 make 的结果，查找头文件目录，但是无法脱离 ``cygpath``，直接解析类似 ``/c/blah`` 的目录。``Eclipse Build Output Parser`` 将利用该机制确认是否调用 ``cygpath``，但由于未知原因，目前 ESP-IDF 配置并不会触发该功能。出于这个原因，我们会使用 ``eclipse_make.py`` 包装脚本调用 ``make``，然后使用 ``cygpath`` 处理 Eclipse 的结果。

diff --git a/docs/zh_CN/get-started/eclipse-setup.rst b/docs/zh_CN/get-started/eclipse-setup.rst
index 8db8639428eabc6ca5dc044ca87d44dc225167d2..e2f7be8a3c8aaa9b3f3a411fa765d7cf15a0eea7 100644 (file)
--- a/docs/zh_CN/get-started/eclipse-setup.rst
+++ b/docs/zh_CN/get-started/eclipse-setup.rst
@@ -1,6 +1,7 @@
 ****************************
 Eclipse IDE 的创建和烧录指南
 ****************************
+:link_to_translation:`en:[English]`
 
 .. _eclipse-install-steps:
 

diff --git a/docs/zh_CN/get-started/establish-serial-connection.rst b/docs/zh_CN/get-started/establish-serial-connection.rst
index 38c05344c6acea3e5fe90841914db98521749908..f934dba3d8ac72b5e06c92678e65e7314ad4a746 100644 (file)
--- a/docs/zh_CN/get-started/establish-serial-connection.rst
+++ b/docs/zh_CN/get-started/establish-serial-connection.rst
@@ -1,5 +1,6 @@
 与 ESP32 创建串口连接
 =========================
+:link_to_translation:`en:[English]`
 
 本章节介绍如何在 ESP32 和 PC 之间建立串口连接。
 

diff --git a/docs/zh_CN/get-started/get-started-pico-kit.rst b/docs/zh_CN/get-started/get-started-pico-kit.rst
index d2e44c905bc4a6984fdcec5a1ebc13ad853a701b..4ffa78dbc7bc7f032d268b9e305702f8db52ac04 100644 (file)
--- a/docs/zh_CN/get-started/get-started-pico-kit.rst
+++ b/docs/zh_CN/get-started/get-started-pico-kit.rst
@@ -1,5 +1,6 @@
 ESP32-PICO-KIT V4 入门指南
 ============================
+:link_to_translation:`en:[English]`
 
 本指南介绍了如何开始使用 ESP32-PICO-KIT V4 迷你开发板。有关 ESP32-PICO-KIT 其他版本的介绍，请见 :doc:`../hw-reference/index`。
 
@@ -216,4 +217,4 @@ Header J3
 .. toctree::
     :hidden:
 
-    get-started-pico-kit-v3    
\ No newline at end of file
+    get-started-pico-kit-v3    

diff --git a/docs/zh_CN/get-started/idf-monitor.rst b/docs/zh_CN/get-started/idf-monitor.rst
index 5e19ff1587156cff27d58a3343fec3485c4bb41b..a5b30e2d0a70c55fc8b077fc013e4f38fa17aa14 100644 (file)
--- a/docs/zh_CN/get-started/idf-monitor.rst
+++ b/docs/zh_CN/get-started/idf-monitor.rst
@@ -1,6 +1,7 @@
 ***********
 IDF Monitor
 ***********
+:link_to_translation:`en:[English]`
 
 IDF Monitor 工具是在 IDF 中调用 “make monitor” 目标时运行的 Python 程序。
 

diff --git a/docs/zh_CN/get-started/index.rst b/docs/zh_CN/get-started/index.rst
index e2eb3d2eaad28062cde1c41838dbdce59638b89b..8831d86fd1642d260a5548d9efffd91f5d6754ed 100644 (file)
--- a/docs/zh_CN/get-started/index.rst
+++ b/docs/zh_CN/get-started/index.rst
@@ -1,6 +1,7 @@
 ***********
 快速入门
 ***********
+:link_to_translation:`en:[English]`
 
 本文档旨在指导用户创建 ESP32 的软件环境。本文将通过一个简单的例子来说明如何使用 ESP-IDF (Espressif IoT Development Framework)，包括配置、编译、下载固件到开发板等步骤。
 

diff --git a/docs/zh_CN/get-started/linux-setup.rst b/docs/zh_CN/get-started/linux-setup.rst
index a4dc1d943cd406425c46eaeb11c6c9b172907bc4..8c5c0cf6badbcaa5312b2954659676b1be3a2eb1 100644 (file)
--- a/docs/zh_CN/get-started/linux-setup.rst
+++ b/docs/zh_CN/get-started/linux-setup.rst
@@ -1,6 +1,7 @@
 *****************************
 Linux 平台工具链的标准设置
 *****************************
+:link_to_translation:`en:[English]`
 
 安装前提
 =====================

diff --git a/docs/zh_CN/get-started/macos-setup.rst b/docs/zh_CN/get-started/macos-setup.rst
index ea5b6c60d3f444b975fcf54f50ab5bb5da9240a2..18c325303b5a474d289263becd9d208729522547 100644 (file)
--- a/docs/zh_CN/get-started/macos-setup.rst
+++ b/docs/zh_CN/get-started/macos-setup.rst
@@ -1,6 +1,7 @@
 **************************************
 在 Mac OS 上安装 ESP32 工具链
 **************************************
+:link_to_translation:`en:[English]`
 
 安装准备
 ================

diff --git a/docs/zh_CN/get-started/make-project.rst b/docs/zh_CN/get-started/make-project.rst
index 6c03bab97491a0bac43067fe0209f9103665857b..6456d8ef0911d68351223495d79ea77072b56dfc 100644 (file)
--- a/docs/zh_CN/get-started/make-project.rst
+++ b/docs/zh_CN/get-started/make-project.rst
@@ -1,5 +1,6 @@
 通过 make 指令创建和烧录项目
 =============================
+:link_to_translation:`en:[English]`
 
 
 寻找项目

diff --git a/docs/zh_CN/get-started/windows-setup.rst b/docs/zh_CN/get-started/windows-setup.rst
index d83408e3c03701f6ef1f37a8cfe013ea4ea31822..8482b5d9cd0d69431587ca794b2d99ae2abcf09a 100644 (file)
--- a/docs/zh_CN/get-started/windows-setup.rst
+++ b/docs/zh_CN/get-started/windows-setup.rst
@@ -1,6 +1,7 @@
 ***************************************
 Windows 平台工具链的标准设置
 ***************************************
+:link_to_translation:`en:[English]`
 
 引言
 ============