Add python docs

Author: jonyMarino

.github/workflows/sphinx-docs.yml

@@ -2,9 +2,9 @@ name: Documentation Build & Deploy
 
 on:
   push:
-    branches: [main]
+    branches: [docs_publish]
   pull_request:
-    branches: [main]
+    branches: [docs_publish]
   workflow_dispatch:
 
 jobs:
@@ -23,18 +23,29 @@ jobs:
         with:
           python-version: '3.12'
 
-      - name: Install dependencies
+      - name: Install dependencies for main docs
         run: |
           python -m pip install --upgrade pip
           pip install -r docs/requirements.txt
 
-      - name: Build Sphinx documentation
+      - name: Build Sphinx documentation (main)
         working-directory: docs
         run: make html
 
+      - name: Install dependencies for Python API docs
+        run: pip install -r client/python/projectairsim/docs/requirements.txt
+
+      - name: Build Python API docs
+        working-directory: client/python/projectairsim/docs
+        run: make html
+
+      - name: Copy API docs into main site
+        run: |
+          mkdir -p docs/build/html/api_docs
+          cp -r client/python/projectairsim/docs/build/html/* docs/build/html/api_docs/
+
       - name: Deploy to GitHub Pages (gh_page)
         uses: peaceiris/actions-gh-pages@v3
-        if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_dir: docs/build/html

.github/workflows/test_windows.yml

@@ -1,7 +1,7 @@
 name: Windows Build
 
 # Controls when the action will run.
-on: [push]
+#on: [push]
 
 jobs:
   build:

client/python/projectairsim/docs/conf.py

@@ -19,5 +19,4 @@
 # -- Options for HTML output -------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
-html_theme = 'haiku'
-html_static_path = ['_static']
+html_theme = 'sphinx_rtd_theme'

client/python/projectairsim/docs/requirements.txt

@@ -1 +1,3 @@
 sphinx
+sphinx_rtd_theme
+myst_parser