[Docs] New docs theme based on ESP-IDF style (#6512)

* Rebase with master

* [Docs] Changes on the docs build command

* [Docs] Changes on the docs build

* [Docs] ESP-DOCS version updated to 0.2.1

* [Docs] Downgrade to Jinja2 3.0.2

* Added page redirect file

* Removed the target build for esp-docs v1.0.2

* Removed contents caption from index.rst

* Removed TARGETS and VERSIONS

* Removed versions file

* Added ddocs deploy job

* Added ddocs deploy job - build and deploy

* Added ddocs deploy job - env vars added

* Added ddocs deploy job - env vars added

* Added ddocs deploy job - deploy url added

* Added ddocs deploy job - deploy new vars added

* Added new emv vars for production server

* Added new emv vars for production server

* Added secret keys env vars

* Added secret keys env vars 2

Author: pedrominatel

.github/workflows/docs.yml

@@ -1,4 +1,4 @@
-name: ReadTheDocs CI
+name: Docs CI
 
 on:
   push:
@@ -16,7 +16,7 @@ on:
 jobs:
 
   build-docs:
-    name: Build ReadTheDocs
+    name: Build Docs
     runs-on: ubuntu-latest
     defaults:
       run:
@@ -35,4 +35,62 @@ jobs:
         # 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 build-docs -l en
+
+  deploy-docs:
+    name: Deploy Docs
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        shell: bash
+    steps:
+    - uses: actions/checkout@v2
+      with:
+        submodules: true
+    - uses: actions/setup-python@v2
+      with:
+        python-version: '3.x'
+    - name: Deploy Production
+      env:
+        DOCS_BUILD_DIR: "./docs/_build/"
+        DOCS_DEPLOY_PRIVATEKEY: ${{ secrets.DOCS_DEPLOY_KEY }}
+        DOCS_DEPLOY_SERVER: ${{ secrets.DOCS_PROD_SERVER }}
+        DOCS_DEPLOY_SERVER_USER: ${{ secrets.DOCS_PROD_SERVER_USER }}
+        DOCS_DEPLOY_PATH: ${{ secrets.DOCS_PATH }}
+        DOCS_DEPLOY_URL_BASE: ${{ secrets.DOCS_URL }}
+      run: |
+        PATH=/home/runner/.local/bin:$PATH pip install -r ./docs/requirements.txt --prefer-binary
+        PATH=/home/runner/.local/bin:$PATH source ./docs/utils.sh
+        PATH=/home/runner/.local/bin:$PATH add_doc_server_ssh_keys $DOCS_DEPLOY_PRIVATEKEY $DOCS_DEPLOY_SERVER $DOCS_DEPLOY_SERVER_USER
+        PATH=/home/runner/.local/bin:$PATH export GIT_VER=$(git describe --always)
+        cd ./docs && PATH=/home/runner/.local/bin:$PATH build-docs -l en
+        PATH=/home/runner/.local/bin:$PATH deploy-docs
+
+  deploy-preview-docs:
+    name: Deploy Preview Docs
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        shell: bash
+    steps:
+    - uses: actions/checkout@v2
+      with:
+        submodules: true
+    - uses: actions/setup-python@v2
+      with:
+        python-version: '3.x'
+    - name: Deploy Preview
+      env:
+        DOCS_BUILD_DIR: "./docs/_build/"
+        DOCS_DEPLOY_PRIVATEKEY: ${{ secrets.DOCS_DEPLOY_KEY }}
+        DOCS_DEPLOY_SERVER: ${{ secrets.DOCS_PREV_SERVER }}
+        DOCS_DEPLOY_SERVER_USER: ${{ secrets.DOCS_PREV_SERVER_USER }}
+        DOCS_DEPLOY_PATH: ${{ secrets.DOCS_PREV_PATH }}
+        DOCS_DEPLOY_URL_BASE: ${{ secrets.DOCS_PREV_URL }}
+      run: |
+        PATH=/home/runner/.local/bin:$PATH pip install -r ./docs/requirements.txt --prefer-binary
+        PATH=/home/runner/.local/bin:$PATH source ./docs/utils.sh
+        PATH=/home/runner/.local/bin:$PATH add_doc_server_ssh_keys $DOCS_DEPLOY_PRIVATEKEY $DOCS_DEPLOY_SERVER $DOCS_DEPLOY_SERVER_USER
+        PATH=/home/runner/.local/bin:$PATH export GIT_VER=$(git describe --always)
+        cd ./docs && PATH=/home/runner/.local/bin:$PATH build-docs -l en
+        PATH=/home/runner/.local/bin:$PATH deploy-docs

.gitignore

@@ -23,6 +23,8 @@ boards.sloeber.txt
 # Ignore docs build (Sphinx)
 docs/build
 docs/source/_build
+docs/__pycache__/
+docs/_build/
 
 # Test log files
 *.log