Documentation migration from RTD to ESP-Docs (#9094)

espressif · Jan 12, 2024 · e4d6a8a · e4d6a8a
1 parent c1a4055
commit e4d6a8a
Show file tree

Hide file tree

Showing 109 changed files with 265 additions and 194 deletions.
diff --git a/.github/workflows/docs.yml → .github/workflows/docs_build.yml b/.github/workflows/docs.yml → .github/workflows/docs_build.yml
@@ -1,13 +1,6 @@
-name: ReadTheDocs CI
+name: Documentation Build and Deploy CI
 
 on:
-  push:
-    branches:
-    - master
-    - release/*
-    paths:
-    - 'docs/**'
-    - '.github/workflows/docs.yml'
   pull_request:
     paths:
     - 'docs/**'
@@ -16,7 +9,7 @@ on:
 jobs:
 
   build-docs:
-    name: Build ReadTheDocs
+    name: Build Documentation
     runs-on: ubuntu-22.04
     defaults:
       run:
@@ -34,5 +27,11 @@ jobs:
         sudo apt install python3-pip python3-setuptools
         # GitHub CI installs pip3 and setuptools outside the path.
         # Update the path to include them and run.
-        PATH=/home/runner/.local/bin:$PATH pip3 install --user -r ./docs/requirements.txt
-        cd ./docs && PATH=/home/runner/.local/bin:$PATH SPHINXOPTS="-W" make html
+        cd ./docs
+        PATH=/home/runner/.local/bin:$PATH pip3 install -r requirements.txt --prefer-binary
+        PATH=/home/runner/.local/bin:$PATH SPHINXOPTS="-W" build-docs -l en
+    - name: Archive Docs
+      uses: actions/upload-artifact@v2
+      with:
+        name: docs
+        path: docs
diff --git a/.github/workflows/docs_deploy.yml b/.github/workflows/docs_deploy.yml
@@ -0,0 +1,46 @@
+name: Documentation Build and Deploy Production CI
+
+on:
+  push:
+    branches:
+    - release/*
+    paths:
+    - 'docs/**'
+    - '.github/workflows/docs.yml'
+
+jobs:
+
+  deploy-prod-docs:
+    name: Deploy Documentation Production
+    runs-on: ubuntu-22.04
+    defaults:
+      run:
+        shell: bash
+    steps:
+    - uses: actions/checkout@v2
+      with:
+        submodules: true
+    - uses: actions/setup-python@v2
+      with:
+        python-version: '3.10'
+    - name: Deploy Preview
+      env:
+        # Deploy to production server
+        DOCS_BUILD_DIR: "${CI_PROJECT_DIR}/docs/_build/"
+        DOCS_DEPLOY_PRIVATEKEY: ${{ secrets.DOCS_PROD_PRIVATEKEY }}
+        DOCS_DEPLOY_PATH: ${{ secrets.DOCS_PROD_PATH }}
+        DOCS_DEPLOY_SERVER: ${{ secrets.DOCS_PROD_SERVER }}
+        DOCS_DEPLOY_URL_BASE: ${{ secrets.DOCS_PROD_URL_BASE }}
+        DOCS_DEPLOY_SERVER_USER: ${{ secrets.DOCS_PROD_USER }}
+      run: |
+        sudo apt update
+        sudo apt install python3-pip python3-setuptools
+        source ./docs/utils.sh
+        add_doc_server_ssh_keys $DOCS_DEPLOY_PRIVATEKEY $DOCS_DEPLOY_SERVER $DOCS_DEPLOY_SERVER_USER
+        export GIT_VER=$(git describe --always)
+        echo "PIP install requirements..."
+        pip3 install --user -r ./docs/requirements.txt
+        echo "Building the Docs..."
+        cd ./docs && build-docs -l en
+        echo "Deploy the Docs..."
+        deploy-docs
diff --git a/.github/workflows/docs_preview.yml b/.github/workflows/docs_preview.yml
@@ -0,0 +1,46 @@
+name: Documentation Build and Deploy CI
+
+on:
+  push:
+    branches:
+    - master
+    paths:
+    - 'docs/**'
+    - '.github/workflows/docs.yml'
+
+jobs:
+
+  deploy-preview-docs:
+    name: Deploy Documentation Preview
+    runs-on: ubuntu-22.04
+    defaults:
+      run:
+        shell: bash
+    steps:
+    - uses: actions/checkout@v3
+      with:
+        submodules: true
+    - uses: actions/setup-python@v4
+      with:
+        python-version: '3.10'
+    - name: Deploy Preview
+      env:
+        # Deploy to preview server
+        DOCS_BUILD_DIR: "${CI_PROJECT_DIR}/docs/_build/"
+        DOCS_DEPLOY_PRIVATEKEY: ${{ secrets.DOCS_KEY }}
+        DOCS_DEPLOY_PATH: ${{ secrets.DOCS_PATH }}
+        DOCS_DEPLOY_SERVER: ${{ secrets.DOCS_SERVER }}
+        DOCS_DEPLOY_URL_BASE: ${{ secrets.DOCS_URL }}
+        DOCS_DEPLOY_SERVER_USER: ${{ secrets.DOCS_USER }}
+      run: |
+        sudo apt update
+        sudo apt install python3-pip python3-setuptools
+        source ./docs/utils.sh
+        add_doc_server_ssh_keys $DOCS_DEPLOY_PRIVATEKEY $DOCS_DEPLOY_SERVER $DOCS_DEPLOY_SERVER_USER
+        export GIT_VER=$(git describe --always)
+        echo "PIP install requirements..."
+        pip3 install --user -r ./docs/requirements.txt
+        echo "Building the Docs..."
+        cd ./docs && build-docs -l en
+        echo "Deploy the Docs..."
+        deploy-docs
diff --git a/docs/Makefile b/docs/Makefile
diff --git a/docs/source/_static/arduino-ide.png → docs/_static/arduino-ide.png b/docs/source/_static/arduino-ide.png → docs/_static/arduino-ide.png
diff --git a/docs/source/_static/arduino_i2c_master.png → docs/_static/arduino_i2c_master.png b/docs/source/_static/arduino_i2c_master.png → docs/_static/arduino_i2c_master.png
diff --git a/docs/source/_static/arduino_i2c_slave.png → docs/_static/arduino_i2c_slave.png b/docs/source/_static/arduino_i2c_slave.png → docs/_static/arduino_i2c_slave.png
diff --git a/docs/_static/arduino_versions.js b/docs/_static/arduino_versions.js
@@ -0,0 +1,16 @@
+var DOCUMENTATION_VERSIONS = {
+    DEFAULTS: { has_targets: false,
+                supported_targets: [ "esp32" ]
+              },
+    VERSIONS: [
+      { name: "latest", has_targets: true, supported_targets: [ "esp32", "esp32s2", "esp32s3", "esp32c3", "esp32h2", "esp32c6"  ] },
+    ],
+    IDF_TARGETS: [
+       { text: "ESP32", value: "esp32"},
+       { text: "ESP32-S2", value: "esp32s2"},
+       { text: "ESP32-S3", value: "esp32s3"},
+       { text: "ESP32-C3", value: "esp32c3"},
+       { text: "ESP32-H2", value: "esp32h2"},
+       { text: "ESP32-C6", value: "esp32c6"},
+    ]
+};
diff --git a/docs/source/_static/cross.png → docs/_static/cross.png b/docs/source/_static/cross.png → docs/_static/cross.png
diff --git a/.../_static/esp32-c3_devkitM-1_pinlayout.png → .../_static/esp32-c3_devkitM-1_pinlayout.png b/.../_static/esp32-c3_devkitM-1_pinlayout.png → .../_static/esp32-c3_devkitM-1_pinlayout.png
diff --git a/...rce/_static/esp32-s2_saola1_pinlayout.png → docs/_static/esp32-s2_saola1_pinlayout.png b/...rce/_static/esp32-s2_saola1_pinlayout.png → docs/_static/esp32-s2_saola1_pinlayout.png
diff --git a/...ource/_static/esp32_devkitC_pinlayout.png → docs/_static/esp32_devkitC_pinlayout.png b/...ource/_static/esp32_devkitC_pinlayout.png → docs/_static/esp32_devkitC_pinlayout.png
diff --git a/...urce/_static/external_library_test_pr.png → docs/_static/external_library_test_pr.png b/...urce/_static/external_library_test_pr.png → docs/_static/external_library_test_pr.png
diff --git a/...static/external_library_test_schedule.png → ...static/external_library_test_schedule.png b/...static/external_library_test_schedule.png → ...static/external_library_test_schedule.png
diff --git a/docs/source/_static/gpio_output.png → docs/_static/gpio_output.png b/docs/source/_static/gpio_output.png → docs/_static/gpio_output.png
diff --git a/docs/source/_static/gpio_pullup.png → docs/_static/gpio_pullup.png b/docs/source/_static/gpio_pullup.png → docs/_static/gpio_pullup.png
diff --git a/docs/source/_static/green_checkmark.png → docs/_static/green_checkmark.png b/docs/source/_static/green_checkmark.png → docs/_static/green_checkmark.png
diff --git a/...ic/install_guide_boards_manager_esp32.png → ...ic/install_guide_boards_manager_esp32.png b/...ic/install_guide_boards_manager_esp32.png → ...ic/install_guide_boards_manager_esp32.png
diff --git a/...atic/install_guide_boards_manager_url.png → ...atic/install_guide_boards_manager_url.png b/...atic/install_guide_boards_manager_url.png → ...atic/install_guide_boards_manager_url.png
diff --git a/...rce/_static/install_guide_preferences.png → docs/_static/install_guide_preferences.png b/...rce/_static/install_guide_preferences.png → docs/_static/install_guide_preferences.png
diff --git a/docs/source/_static/logo_arduino.png → docs/_static/logo_arduino.png b/docs/source/_static/logo_arduino.png → docs/_static/logo_arduino.png
diff --git a/docs/source/_static/logo_espressif.png → docs/_static/logo_espressif.png b/docs/source/_static/logo_espressif.png → docs/_static/logo_espressif.png
diff --git a/docs/source/_static/logo_linux.png → docs/_static/logo_linux.png b/docs/source/_static/logo_linux.png → docs/_static/logo_linux.png
diff --git a/docs/source/_static/logo_macos.png → docs/_static/logo_macos.png b/docs/source/_static/logo_macos.png → docs/_static/logo_macos.png
diff --git a/docs/source/_static/logo_pio.png → docs/_static/logo_pio.png b/docs/source/_static/logo_pio.png → docs/_static/logo_pio.png
diff --git a/docs/source/_static/logo_windows.png → docs/_static/logo_windows.png b/docs/source/_static/logo_windows.png → docs/_static/logo_windows.png
diff --git a/docs/source/_static/ota_esp32_login.png → docs/_static/ota_esp32_login.png b/docs/source/_static/ota_esp32_login.png → docs/_static/ota_esp32_login.png
diff --git a/docs/source/_static/ota_esp32_upload.png → docs/_static/ota_esp32_upload.png b/docs/source/_static/ota_esp32_upload.png → docs/_static/ota_esp32_upload.png
diff --git a/docs/source/_static/ota_esp32_verbose.png → docs/_static/ota_esp32_verbose.png b/docs/source/_static/ota_esp32_verbose.png → docs/_static/ota_esp32_verbose.png
diff --git a/docs/source/_static/ota_export_to_binary.png → docs/_static/ota_export_to_binary.png b/docs/source/_static/ota_export_to_binary.png → docs/_static/ota_export_to_binary.png
diff --git a/docs/source/_static/soc-module.png → docs/_static/soc-module.png b/docs/source/_static/soc-module.png → docs/_static/soc-module.png
diff --git a/...ic/tutorials/basic/tutorial_basic_ide.png → ...ic/tutorials/basic/tutorial_basic_ide.png b/...ic/tutorials/basic/tutorial_basic_ide.png → ...ic/tutorials/basic/tutorial_basic_ide.png
diff --git a/...ripherals/tutorial_peripheral_diagram.png → ...ripherals/tutorial_peripheral_diagram.png b/...ripherals/tutorial_peripheral_diagram.png → ...ripherals/tutorial_peripheral_diagram.png
diff --git a/docs/source/_static/usb_msc_drive.png → docs/_static/usb_msc_drive.png b/docs/source/_static/usb_msc_drive.png → docs/_static/usb_msc_drive.png
diff --git a/docs/source/_static/warning.png → docs/_static/warning.png b/docs/source/_static/warning.png → docs/_static/warning.png
diff --git a/docs/source/_static/wifi_esp32_ap.png → docs/_static/wifi_esp32_ap.png b/docs/source/_static/wifi_esp32_ap.png → docs/_static/wifi_esp32_ap.png
diff --git a/docs/source/_static/wifi_esp32_sta.png → docs/_static/wifi_esp32_sta.png b/docs/source/_static/wifi_esp32_sta.png → docs/_static/wifi_esp32_sta.png
diff --git a/docs/source/_static/win-gui-1.png → docs/_static/win-gui-1.png b/docs/source/_static/win-gui-1.png → docs/_static/win-gui-1.png
diff --git a/docs/source/_static/win-gui-2.png → docs/_static/win-gui-2.png b/docs/source/_static/win-gui-2.png → docs/_static/win-gui-2.png
diff --git a/docs/source/_static/win-gui-3.png → docs/_static/win-gui-3.png b/docs/source/_static/win-gui-3.png → docs/_static/win-gui-3.png
diff --git a/docs/source/_static/win-gui-4.png → docs/_static/win-gui-4.png b/docs/source/_static/win-gui-4.png → docs/_static/win-gui-4.png
diff --git a/docs/source/_static/win-gui-5.png → docs/_static/win-gui-5.png b/docs/source/_static/win-gui-5.png → docs/_static/win-gui-5.png
diff --git a/docs/source/_static/win-gui-update-1.png → docs/_static/win-gui-update-1.png b/docs/source/_static/win-gui-update-1.png → docs/_static/win-gui-update-1.png
diff --git a/docs/source/_static/win-gui-update-2.png → docs/_static/win-gui-update-2.png b/docs/source/_static/win-gui-update-2.png → docs/_static/win-gui-update-2.png
diff --git a/docs/conf_common.py b/docs/conf_common.py
@@ -0,0 +1,54 @@
+# ---------------------------------------------------------------
+
+from esp_docs.conf_docs import *  # noqa: F403,F401
+
+languages = ["en"]
+
+# idf_targets = [
+#     "esp32",
+#     "esp32s2",
+#     "esp32s3",
+#     "esp32c3",
+#     "esp32c6",
+#     "esp32h2",
+# ]
+
+# link roles config
+github_repo = "espressif/arduino-esp32"
+
+# context used by sphinx_idf_theme
+html_context["github_user"] = "espressif"
+html_context["github_repo"] = "arduino-esp32"
+
+html_static_path = ["../_static"]
+
+# Conditional content
+
+extensions += ['sphinx_copybutton',
+               'sphinx_tabs.tabs',
+               'esp_docs.esp_extensions.dummy_build_system',
+               ]
+
+# ESP32_DOCS = [
+#     "index.rst",
+# ]
+
+# ESP32S2_DOCS = ESP32_DOCS
+# ESP32C3_DOCS = ESP32S2_DOCS
+# ESP32S3_DOCS = ESP32S2_DOCS
+# ESP32C6_DOCS = ESP32S2_DOCS
+# ESP32H2_DOCS = ESP32S2_DOCS
+
+# conditional_include_dict = {
+#     "esp32": ESP32_DOCS,
+#     "esp32s2": ESP32S2_DOCS,
+#     "esp32c3": ESP32C3_DOCS,
+#     "esp32s3": ESP32S3_DOCS,
+#     "esp32c6": ESP32C6_DOCS,
+#     "esp32h2": ESP32H2_DOCS,
+# }
+
+# Extra options required by sphinx_idf_theme
+project_slug = "arduino-esp32"
+
+# versions_url = "./../_static/arduino_versions.js"
diff --git a/docs/source/advanced_utils.rst → docs/en/advanced_utils.rst b/docs/source/advanced_utils.rst → docs/en/advanced_utils.rst
diff --git a/docs/source/api/adc.rst → docs/en/api/adc.rst b/docs/source/api/adc.rst → docs/en/api/adc.rst
diff --git a/docs/source/api/ble.rst → docs/en/api/ble.rst b/docs/source/api/ble.rst → docs/en/api/ble.rst
diff --git a/docs/source/api/bluetooth.rst → docs/en/api/bluetooth.rst b/docs/source/api/bluetooth.rst → docs/en/api/bluetooth.rst
diff --git a/docs/source/api/dac.rst → docs/en/api/dac.rst b/docs/source/api/dac.rst → docs/en/api/dac.rst
diff --git a/docs/source/api/deepsleep.rst → docs/en/api/deepsleep.rst b/docs/source/api/deepsleep.rst → docs/en/api/deepsleep.rst
diff --git a/docs/source/api/espnow.rst → docs/en/api/espnow.rst b/docs/source/api/espnow.rst → docs/en/api/espnow.rst
diff --git a/docs/source/api/ethernet.rst → docs/en/api/ethernet.rst b/docs/source/api/ethernet.rst → docs/en/api/ethernet.rst
diff --git a/docs/source/api/gpio.rst → docs/en/api/gpio.rst b/docs/source/api/gpio.rst → docs/en/api/gpio.rst
diff --git a/docs/source/api/i2c.rst → docs/en/api/i2c.rst b/docs/source/api/i2c.rst → docs/en/api/i2c.rst
@@ -19,15 +19,15 @@ The I2C can be used in two different modes:
 * **I2C Master Mode**
     * In this mode, the ESP32 generates the clock signal and initiates the communication with the slave device.
 
-.. figure:: ../_static/arduino_i2c_master.png
+.. figure:: ../../_static/arduino_i2c_master.png
     :align: center
     :width: 720
     :figclass: align-center
 
 * **I2C Slave Mode**
     * The slave mode, the clock is generated by the master device and responds to the master if the destination address is the same as the destination.
 
-.. figure:: ../_static/arduino_i2c_slave.png
+.. figure:: ../../_static/arduino_i2c_slave.png
     :align: center
     :width: 520
     :figclass: align-center

diff --git a/docs/source/api/i2s.rst → docs/en/api/i2s.rst b/docs/source/api/i2s.rst → docs/en/api/i2s.rst
diff --git a/docs/source/api/insights.rst → docs/en/api/insights.rst b/docs/source/api/insights.rst → docs/en/api/insights.rst
diff --git a/docs/source/api/ledc.rst → docs/en/api/ledc.rst b/docs/source/api/ledc.rst → docs/en/api/ledc.rst
diff --git a/docs/source/api/preferences.rst → docs/en/api/preferences.rst b/docs/source/api/preferences.rst → docs/en/api/preferences.rst
diff --git a/docs/source/api/pulse_counter.rst → docs/en/api/pulse_counter.rst b/docs/source/api/pulse_counter.rst → docs/en/api/pulse_counter.rst
diff --git a/docs/source/api/rainmaker.rst → docs/en/api/rainmaker.rst b/docs/source/api/rainmaker.rst → docs/en/api/rainmaker.rst
diff --git a/docs/source/api/reset_reason.rst → docs/en/api/reset_reason.rst b/docs/source/api/reset_reason.rst → docs/en/api/reset_reason.rst
diff --git a/docs/source/api/rmt.rst → docs/en/api/rmt.rst b/docs/source/api/rmt.rst → docs/en/api/rmt.rst
diff --git a/docs/source/api/sdio.rst → docs/en/api/sdio.rst b/docs/source/api/sdio.rst → docs/en/api/sdio.rst
diff --git a/docs/source/api/sdmmc.rst → docs/en/api/sdmmc.rst b/docs/source/api/sdmmc.rst → docs/en/api/sdmmc.rst
diff --git a/docs/source/api/sigmadelta.rst → docs/en/api/sigmadelta.rst b/docs/source/api/sigmadelta.rst → docs/en/api/sigmadelta.rst
diff --git a/docs/source/api/spi.rst → docs/en/api/spi.rst b/docs/source/api/spi.rst → docs/en/api/spi.rst
diff --git a/docs/source/api/timer.rst → docs/en/api/timer.rst b/docs/source/api/timer.rst → docs/en/api/timer.rst
diff --git a/docs/source/api/touch.rst → docs/en/api/touch.rst b/docs/source/api/touch.rst → docs/en/api/touch.rst
diff --git a/docs/source/api/usb.rst → docs/en/api/usb.rst b/docs/source/api/usb.rst → docs/en/api/usb.rst
diff --git a/docs/source/api/usb_cdc.rst → docs/en/api/usb_cdc.rst b/docs/source/api/usb_cdc.rst → docs/en/api/usb_cdc.rst
diff --git a/docs/source/api/usb_msc.rst → docs/en/api/usb_msc.rst b/docs/source/api/usb_msc.rst → docs/en/api/usb_msc.rst
diff --git a/docs/source/api/wifi.rst → docs/en/api/wifi.rst b/docs/source/api/wifi.rst → docs/en/api/wifi.rst
@@ -21,7 +21,7 @@ Working as AP
 In this mode, the ESP32 is configured as an Access Point (AP) and it's capable of receiving incoming connections from other devices (stations) by providing
 a Wi-Fi network.
 
-.. figure:: ../_static/wifi_esp32_ap.png
+.. figure:: ../../_static/wifi_esp32_ap.png
     :align: center
     :width: 520
     :figclass: align-center
@@ -33,7 +33,7 @@ Working as STA
 
 The STA mode is used to connect the ESP32 to a Wi-Fi network, provided by an Access Point.
 
-.. figure:: ../_static/wifi_esp32_sta.png
+.. figure:: ../../_static/wifi_esp32_sta.png
     :align: center
     :width: 520
     :figclass: align-center

diff --git a/docs/source/boards/ESP32-C3-DevKitM-1.rst → docs/en/boards/ESP32-C3-DevKitM-1.rst b/docs/source/boards/ESP32-C3-DevKitM-1.rst → docs/en/boards/ESP32-C3-DevKitM-1.rst
@@ -88,7 +88,7 @@ No.  Name  Type [1]_   Function
 Pin Layout
 ----------
 
-.. figure:: ../_static/esp32-c3_devkitM-1_pinlayout.png
+.. figure:: ../../_static/esp32-c3_devkitM-1_pinlayout.png
     :align: center
     :width: 600
     :alt: ESP32-C3-DevKitM-1 (click to enlarge)

diff --git a/docs/source/boards/ESP32-DevKitC-1.rst → docs/en/boards/ESP32-DevKitC-1.rst b/docs/source/boards/ESP32-DevKitC-1.rst → docs/en/boards/ESP32-DevKitC-1.rst
@@ -96,7 +96,7 @@ No.  Name  Type   Function
 Pin Layout
 ----------
 
-.. figure:: ../_static/esp32_devkitC_pinlayout.png
+.. figure:: ../../_static/esp32_devkitC_pinlayout.png
     :align: center
     :width: 600
     :alt: ESP32-DevKitC-1 (click to enlarge)

diff --git a/docs/source/boards/ESP32-S2-Saola-1.rst → docs/en/boards/ESP32-S2-Saola-1.rst b/docs/source/boards/ESP32-S2-Saola-1.rst → docs/en/boards/ESP32-S2-Saola-1.rst
@@ -100,7 +100,7 @@ No.  Name  Type   Function
 Pin Layout
 ----------
 
-.. figure:: ../_static/esp32-s2_saola1_pinlayout.png
+.. figure:: ../../_static/esp32-s2_saola1_pinlayout.png
     :align: center
     :width: 600
     :alt: ESP32-S2-Saola-1 (click to enlarge)

diff --git a/docs/source/boards/boards.rst → docs/en/boards/boards.rst b/docs/source/boards/boards.rst → docs/en/boards/boards.rst
@@ -30,7 +30,7 @@ For each family, we have SoC variants with some differentiation. The differences
 The modules use the SoC internally, including the external flash, PSRAM (in some models) and other essential electronic components. Essentially, all
 modules from the same family use the same SoC.
 
-.. figure:: ../_static/soc-module.png
+.. figure:: ../../_static/soc-module.png
     :align: center
     :width: 250
     :alt: ESP32 SoC and Module (click to enlarge)
@@ -60,7 +60,7 @@ Before buying: Keep in mind that for some "must have" features when choosing the
 Espressif
 ---------
 
-.. figure:: ../_static/logo_espressif.png
+.. figure:: ../../_static/logo_espressif.png
     :align: center
     :width: 250
     :alt: Espressif Logo

diff --git a/docs/source/boards/generic.rst → docs/en/boards/generic.rst b/docs/source/boards/generic.rst → docs/en/boards/generic.rst
diff --git a/docs/source/common/datasheet.inc → docs/en/common/datasheet.inc b/docs/source/common/datasheet.inc → docs/en/common/datasheet.inc
diff --git a/docs/en/conf.py b/docs/en/conf.py
@@ -0,0 +1,31 @@
+# -*- coding: utf-8 -*-
+#
+# English Language RTD & Sphinx config file
+#
+# Uses ../conf_common.py for most non-language-specific settings.
+
+# Importing conf_common adds all the non-language-specific
+# parts to this conf module
+
+try:
+    from conf_common import *  # noqa: F403,F401
+except ImportError:
+    import os
+    import sys
+    sys.path.insert(0, os.path.abspath('../'))
+    from conf_common import *  # noqa: F403,F401
+
+import datetime
+current_year = datetime.datetime.now().year
+
+# General information about the project.
+project = u'Arduino ESP32'
+copyright = u'2016 - {}, Espressif Systems (Shanghai) Co., Ltd'.format(current_year)
+pdf_title = u'Arduino ESP32 Documentation Guide'
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+language = 'en'
+
+# Tracking ID for Google Analytics
+google_analytics_id = 'G-F58JM78930'
diff --git a/docs/source/contributing.rst → docs/en/contributing.rst b/docs/source/contributing.rst → docs/en/contributing.rst
diff --git a/docs/source/esp-idf_component.rst → docs/en/esp-idf_component.rst b/docs/source/esp-idf_component.rst → docs/en/esp-idf_component.rst
diff --git a/docs/source/external_libraries_test.rst → docs/en/external_libraries_test.rst b/docs/source/external_libraries_test.rst → docs/en/external_libraries_test.rst
@@ -104,7 +104,7 @@ You can check the results in `LIBRARIES_TEST.md`_.
 
 The results file example:
 
-.. image:: _static/external_library_test_schedule.png
+.. image:: ../_static/external_library_test_schedule.png
   :width: 600
 
 Pull Request test result
@@ -113,18 +113,18 @@ Pull Request test result
 If the test run on Pull Request, it will compile all libraries and sketches 2 times (before/after changes in PR) to see, if the PR is breaking/fixing libraries.
 In the table the results are in order ``BEFORE -> AFTER``.
 
-.. image:: _static/external_library_test_pr.png
+.. image:: ../_static/external_library_test_pr.png
   :width: 600
 
-.. |success| image:: _static/green_checkmark.png
+.. |success| image:: ../_static/green_checkmark.png
    :height: 2ex
    :class: no-scaled-link
 
-.. |warning| image:: _static/warning.png
+.. |warning| image:: ../_static/warning.png
    :height: 2ex
    :class: no-scaled-link
 
-.. |fail| image:: _static/cross.png
+.. |fail| image:: ../_static/cross.png
    :height: 2ex
    :class: no-scaled-link
 

diff --git a/docs/source/faq.rst → docs/en/faq.rst b/docs/source/faq.rst → docs/en/faq.rst