docs: Remove Chinese translation

Author: tore-espressif

docs/build_docs.sh

@@ -1,4 +1,4 @@
 #!/bin/bash
-# SPDX-FileCopyrightText: 2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2025-2026 Espressif Systems (Shanghai) CO LTD
 #
-build-docs --project-path .. -t esp32s2 esp32s3 esp32p4 esp32h4
+build-docs --project-path .. --language en --target esp32s2 esp32s3 esp32p4 esp32h4

docs/conf_common.py

@@ -1,24 +1,50 @@
-# SPDX-FileCopyrightText: 2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2025-2026 Espressif Systems (Shanghai) CO LTD
 #
 # SPDX-License-Identifier: Apache-2.0
 
 """
 Common configuration for ESP-USB documentation
 """
 
+import esp_docs.conf_docs as esp_conf_docs
 from esp_docs.conf_docs import *  # noqa: F403,F401
 
 
 extensions += [  # Needed as a trigger for running doxygen
                'esp_docs.esp_extensions.dummy_build_system',
                'esp_docs.esp_extensions.run_doxygen',
+               'sphinx_reredirects'
                ]
 # Languages supported
-languages = ['en', 'zh_CN']
+languages = ['en']
 
 # Project targets (used as URL slugs)
 idf_targets = ['esp32s2', 'esp32s3', 'esp32p4', 'esp32h4']
 
+# Default redirects map; will be updated in setup once config values are available.
+redirects = {}
+
+def _build_redirects(release_url, idf_target=None):
+    result = {}
+    targets = [idf_target] if idf_target else idf_targets
+    for target in targets:
+        result[f'../../../zh_CN/{target}/html/index.html'] = f'../../../en/{release_url}/{target}/index.html'
+        result[f'../../../zh_CN/{target}/html/introduction.html'] = f'../../../en/{release_url}/{target}/introduction.html'
+        result[f'../../../zh_CN/{target}/html/usb_device.html'] = f'../../../en/{release_url}/{target}/usb_device.html'
+        result[f'../../../zh_CN/{target}/html/usb_host.html'] = f'../../../en/{release_url}/{target}/usb_host.html'
+    return result
+
+
+def _configure_redirects(app, config):
+    release_url = config.release
+    idf_target_val = config.idf_target
+    config.redirects = _build_redirects(release_url, idf_target=idf_target_val)
+
+
+def setup(app):
+    app.connect('config-inited', _configure_redirects)
+    return esp_conf_docs.setup(app)
+
 # GitHub repository information
 github_repo = 'espressif/esp-usb'
 project_homepage = 'https://github.com/espressif/esp-usb'

docs/en/usb_device.rst

@@ -1,8 +1,6 @@
 USB Device Stack
 =================
 
-:link_to_translation:`zh_CN:[中文]`
-
 {IDF_TARGET_USB_DP_GPIO_NUM:default="20", esp32h4="22"}
 {IDF_TARGET_USB_DM_GPIO_NUM:default="19", esp32h4="21"}
 {IDF_TARGET_USB_EP_NUM: default="6", esp32p4="15"}

docs/en/usb_host.rst

@@ -1,8 +1,6 @@
 USB Host
 ========
 
-:link_to_translation:`zh_CN:[中文]`
-
 {IDF_TARGET_OTG_NUM_HOST_CHAN: default="8", esp32p4="16"}
 
 The document provides information regarding the USB Host Library. This document is split into the following sections:

docs/en/usb_host/usb_host_notes_enum.rst

@@ -1,5 +1,3 @@
-.. Translation not required: According to the USB developers, all of the ``usb_host_notes_*`` files are just internal notes for ESP-IDF developers, not for our end users. So we don't need to translate them at all.
-
 USB Host Enumeration Driver (Enum)
 ==================================
 

docs/en/usb_host/usb_host_notes_usbh.rst

@@ -1,5 +1,3 @@
-.. Translation not required: According to the USB developers, all of the ``usb_host_notes_*`` files are just internal notes for ESP-IDF developers, not for our end users. So we don't need to translate them at all.
-
 USB Host Driver (USBH)
 ======================
 

docs/requirements.txt

@@ -1,3 +1,5 @@
-esp-docs>=2.0.0
-sphinx>=5.0.0
+esp-docs~=2.1.5
+sphinx~=7.1.2
+docutils<0.21
 breathe>=4.35.0
+sphinx-reredirects