Try new pipeline

Author: jonyMarino

.github/workflows/sphinx-docs.yml

@@ -1,4 +1,4 @@
-name: Build and Deploy Sphinx Docs
+name: Build and Deploy Docs
 
 on:
   push:
@@ -7,7 +7,7 @@ on:
     branches: [docs_publish]
 
 jobs:
-  build-docs:
+  deploy-docs:
     runs-on: ubuntu-latest
 
     steps:
@@ -17,22 +17,26 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: '3.10'
+          python-version: 3.10
 
       - name: Install dependencies
         run: |
-          python -m pip install --upgrade pip
+          pip install --upgrade pip
           pip install -r docs/requirements.txt
 
-      - name: Build HTML with Sphinx
-        working-directory: ./docs
+      - name: Build documentation
+        working-directory: docs
         run: make html
 
       - name: Deploy to gen_page branch
-        if: github.event_name == 'push'
-        uses: peaceiris/actions-gh-pages@v3
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./docs/build/html
-          publish_branch: gen_page
-          force_orphan: true
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git fetch origin
+          git switch --orphan gen_page
+          git rm -rf .
+          cp -r docs/build/html/* .
+          touch .nojekyll
+          git add .
+          git commit -m "Deploy documentation to gen_page"
+          git push -f origin gen_page

docs/Makefile

@@ -0,0 +1,34 @@
+
+# Configuration file for the Sphinx documentation builder.
+#
+# For the full list of built-in configuration values, see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+import sphinx_rtd_theme
+
+# -- Project information -----------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
+
+project = 'Project Airsim'
+copyright = '2025, IAMAI'
+author = 'IAMAI'
+release = '0.1'
+
+# -- General configuration ---------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
+
+extensions = ["myst_parser"]
+
+templates_path = ['_templates']
+exclude_patterns = []
+
+source_suffix = {
+    '.rst': 'restructuredtext',
+    '.md': 'markdown',
+}
+
+# -- Options for HTML output -------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
+
+html_theme = 'sphinx_rtd_theme'
+html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]

docs/source/conf.py

@@ -0,0 +1,57 @@
+# Project AirSim Documentation
+
+Welcome to the Project AirSim documentation!
+
+```{include} ../../README.md
+:relative-docs: docs_build/source
+:relative-images: docs_build/source/images
+```
+
+```{toctree}
+:maxdepth: 2
+:caption: Getting Started
+internal/use_source.md
+internal/use_prebuilt.md
+internal/dev_setup_linux.md
+internal/dev_setup_win.md
+internal/headless_cloud.md
+internal/vscode_user_settings.md
+---
+:maxdepth: 2
+:caption: ROS Integration
+ros/ros.md
+ros/ros2.md
+ros/ros_examples.md
+ros/example_build_map.md
+ros/example_navigate_map.md
+---
+:maxdepth: 2
+:caption: Sensors
+sensors/battery.md
+sensors/lidar.md
+sensors/radar.md
+sensors/segmentation.md
+sensors/camera_capture_settings.md
+sensors/camera_post_processing_with_nn.md
+sensors/camera_streaming.md
+---
+:maxdepth: 2
+:caption: Data Collection
+datacollection/config.md
+datacollection/data_aggregation.md
+datacollection/data_generation.md
+datacollection/randomizations.md
+datacollection/trajectory.md
+---
+:maxdepth: 2
+:caption: Physics
+physics/fast_physics.md
+physics/matlab_physics.md
+internal/physics/unreal_physics.md
+---
+:maxdepth: 2
+:caption: Scene and Simulation
+scene/sim_clock.md
+scene/weather_visual_effects.md
+internal/scene/sim_clock_internal.md
+internal/sensors/display.md