localhost mostly completed

Author: TJTheCoder

.github/workflows/deploy.yml

@@ -0,0 +1,49 @@
+name: Deploy Sphinx Docs
+
+on:
+  push:
+    branches: [sphinx-docs]
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout repo
+      uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.10'
+
+    - name: Install dependencies
+      run: |
+        pip install -r requirements.txt
+
+    - name: Build docs with driverci
+      run: |
+        chmod +x driverci
+        ./driverci
+
+    - name: Upload GitHub Pages artifact
+      uses: actions/upload-pages-artifact@v2
+      with:
+        path: docs/build/html
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+    - name: Deploy to GitHub Pages
+      id: deployment
+      uses: actions/deploy-pages@v2

docs/source/_static/custom.css

@@ -0,0 +1,11 @@
+/* Expand the main content area */
+.bd-page-width {
+    max-width: 100% !important;
+    width: 95% !important;
+}
+
+/* Expand the article body */
+.bd-content .bd-article-container {
+    max-width: 100% !important;
+    width: 95% !important;
+}

docs/source/conf.py

@@ -7,9 +7,9 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
 project = 'AMAGO'
-copyright = '2025, UT Austin RPL'
-author = 'UT Austin RPL'
-release = '2'
+copyright = '2025, UT Austin Robot Perception and Learning Lab'
+author = 'UT Austin Robot Perception and Learning Lab'
+html_title = "AMAGO"
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
@@ -52,7 +52,14 @@
 html_theme = 'alabaster'
 html_static_path = ['_static', 'media']
 
-import sphinx_rtd_theme
-html_theme = "sphinx_rtd_theme"
-# html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
+html_css_files = [
+    'custom.css',
+]
+
+import sphinx_book_theme
+html_theme = "sphinx_book_theme"
+
+html_theme_options = {
+    "default_mode": "light",
+}