Merge branch 'py-docs' of github.com:photonvision/photonvision into py-docs

README.md

@@ -17,10 +17,11 @@ If you are interested in contributing code or documentation to the project, plea
 ## Documentation
 
 - Our main documentation page: [docs.photonvision.org](https://docs.photonvision.org)
-- Photon UI demo: [http://photonvision.global/](http://photonvision.global/) (or [manual link](https://photonvision.github.io/photonvision/built-client/))
-- Javadocs: [javadocs.photonvision.org](https://javadocs.photonvision.org) (or [manual link](https://photonvision.github.io/photonvision/built-docs/javadoc/))
-- C++ Doxygen  [cppdocs.photonvision.org](https://cppdocs.photonvision.org) (or [manual link](https://photonvision.github.io/photonvision/built-docs/doxygen/html/))
+- Photon UI demo: [http://photonvision.global/](http://photonvision.global/)
+- Javadocs: [javadocs.photonvision.org](https://javadocs.photonvision.org)
+- C++ Doxygen  [cppdocs.photonvision.org](https://cppdocs.photonvision.org)
 - Python Documentation [pydocs.photonvision.org](https://pydocs.photonvision.org)
+
 ## Building
 
 Gradle is used for all C++ and Java code, and NPM is used for the web UI. Instructions to compile PhotonVision yourself can be found [in our docs](https://docs.photonvision.org/en/latest/docs/contributing/building-photon.html#compiling-instructions).

docs/requirements.txt

@@ -1,16 +1,16 @@
-alabaster==1.0.0
+alabaster==0.7.16
 anyio==4.9.0
 babel==2.17.0
-beautifulsoup4==4.13.3
-certifi==2025.1.31
-charset-normalizer==3.4.1
+beautifulsoup4==4.13.4
+certifi==2025.4.26
+charset-normalizer==3.4.2
 click==8.1.8
 colorama==0.4.6
 doc8==1.1.2
 docopt==0.6.2
-docutils==0.21.2
+docutils==0.20.1
 furo==2024.8.6
-h11==0.14.0
+h11==0.16.0
 idna==3.10
 imagesize==1.4.1
 Jinja2==3.1.6
@@ -19,20 +19,20 @@ MarkupSafe==3.0.2
 mdit-py-plugins==0.4.2
 mdurl==0.1.2
 myst-parser==4.0.1
-packaging==24.2
+packaging==25.0
 pbr==6.1.1
-pipreqs==0.4.13
+pipreqs==0.5.0
 Pygments==2.19.1
 PyYAML==6.0.2
 requests==2.32.3
-restructuredtext_lint==1.4.0
+restructuredtext-lint==1.4.0
 roman-numerals-py==3.1.0
-setuptools==77.0.3
+setuptools==80.3.1
 six==1.17.0
 sniffio==1.3.1
-snowballstemmer==2.2.0
-soupsieve==2.6
-Sphinx==8.2.3
+snowballstemmer==3.0.0.1
+soupsieve==2.7
+Sphinx==8.1.3
 sphinx-autobuild==2024.10.3
 sphinx-basic-ng==1.0.0b2
 sphinx-notfound-page==1.1.0
@@ -47,13 +47,13 @@ sphinxcontrib-jquery==4.1
 sphinxcontrib-jsmath==1.0.1
 sphinxcontrib-qthelp==2.0.0
 sphinxcontrib-serializinghtml==2.0.0
-sphinxext-opengraph==0.9.1
+sphinxext-opengraph==0.10.0
 sphinxext-remoteliteralinclude==0.5.0
-starlette==0.46.1
+starlette==0.46.2
 stevedore==5.4.1
-typing_extensions==4.12.2
-urllib3==2.3.0
-uvicorn==0.34.0
-watchfiles==1.0.4
+typing_extensions==4.13.2
+urllib3==2.4.0
+uvicorn==0.34.2
+watchfiles==1.0.5
 websockets==15.0.1
-yarg==0.1.10
+yarg==0.1.9

docs/source/_templates/layout.html

@@ -1,74 +0,0 @@
-{# Import the theme's layout. #}
-{% extends '!layout.html' %}
-
-{%- block extrahead %}
-<script>
-    if (localStorage.getItem("colorTheme") === "dark") {
-        document.documentElement.setAttribute('data-theme', 'dark');
-    } else if (localStorage.getItem("colorTheme") === "light") {
-        document.documentElement.setAttribute('data-theme', 'light');
-    } else {
-        var userPrefersDark = window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches;
-        if (userPrefersDark) {
-            document.documentElement.setAttribute('data-theme', 'dark');
-       } else {
-            document.documentElement.setAttribute('data-theme', 'light');
-        }
-    }
-
-</script>
-
-{# Call the parent block #}
-{{ super() }}
-{% endblock %}
-
-{%- block extrafooter %}
-{# Add custom things to the head HTML tag #}
-
-<div class="dark-mode-toggle-container">
-    <strong class="light-label md-icon">&#xE430</strong>
-
-    <div class="dark-mode-toggle">
-        <input type="checkbox" id="switch" name="theme"/><label class="toggle" for="switch">Toggle</label>
-    </div>
-
-    <strong class="dark-label md-icon">&#xE42D</strong>
-</div>
-
-<script>
-    var checkbox = document.querySelector('input[name=theme]');
-
-    var element = document.documentElement.getAttribute('data-theme');
-
-    if (element == 'dark') {
-        // Auto check the checkbox if the set theme is "dark".
-        checkbox.checked = true;
-    }
-
-    checkbox.addEventListener('change', function() {
-        if (this.checked) {
-            document.documentElement.setAttribute('data-theme', 'dark');
-            localStorage.setItem("colorTheme", "dark");
-        } else {
-            document.documentElement.setAttribute('data-theme', 'light');
-            localStorage.setItem("colorTheme", "light");
-        }
-    });
-
-    window.matchMedia('(prefers-color-scheme: dark)')
-      .addEventListener('change', event => {
-        if (event.matches) {
-            document.documentElement.setAttribute('data-theme', 'dark');
-            localStorage.setItem("colorTheme", "dark");
-            checkbox.checked = true;
-        } else {
-            document.documentElement.setAttribute('data-theme', 'light');
-            localStorage.setItem("colorTheme", "light");
-            checkbox.checked = false;
-        }
-    });
-</script>
-
-{# Call the parent block #}
-{{ super() }}
-{%- endblock %}

docs/source/conf.py

@@ -47,9 +47,6 @@ ogp_site_url = "https://docs.photonvision.org/en/latest/"
 ogp_site_name = "PhotonVision Documentation"
 ogp_image = "https://raw.githubusercontent.com/PhotonVision/photonvision-docs/main/source/assets/RectLogo.png"
 
-# Add any paths that contain templates here, relative to this directory.
-templates_path = ["_templates"]
-
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This pattern also affects html_static_path and html_extra_path.