trying netlify hosted docs

Author: ParticularlyPythonicBS

.gitignore

@@ -15,6 +15,8 @@
 !mkdocs.yml
 !generate_graph_examples.py
 !.python-version
+!requirements.txt
+!netlify.toml
 
 # recursively re-ignore
 __pycache__

netlify.toml

@@ -0,0 +1,36 @@
+# netlify.toml
+
+# Build settings
+[build]
+  # Directory (relative to root of your repo) that contains the deploy-ready
+  # HTML files and assets after the build command has run.
+  publish = "site"
+
+  # Default build command. This will run in the Netlify build environment.
+  # It first runs your script to generate graph HTMLs, then builds the MkDocs site.
+  command = "python generate_graph_examples.py && mkdocs build"
+
+  # Environment variables specific to the build context
+  [build.environment]
+    # Specify the Python version Netlify should use.
+    # Common values: "3.12", "3.11", "3.10", etc.
+    # Check Netlify's build image documentation for currently supported versions.
+    PYTHON_VERSION = "3.12"
+    # If you were using uv and wanted to ensure it's used for pip:
+    # PIP_FLAGS = "--no-cache-dir" # Example, uv might handle this differently
+
+# Optional: Build context for specific deploy contexts (e.g., production, deploy-previews)
+# You can override settings for different contexts if needed.
+# For example, to use a different Python version for deploy previews:
+# [context.deploy-preview.environment]
+#   PYTHON_VERSION = "3.11"
+
+# Optional: Functions settings if you were using Netlify Functions (not applicable here)
+# [functions]
+#   directory = "netlify/functions"
+
+# Optional: Redirects and rewrites (not immediately needed for basic MkDocs)
+# [[redirects]]
+#   from = "/old-path"
+#   to = "/new-path"
+#   status = 301

requirements.txt

@@ -0,0 +1,162 @@
+# This file was autogenerated by uv via the following command:
+#    uv pip compile pyproject.toml --all-extras -o requirements.txt
+asttokens==3.0.0
+    # via stack-data
+babel==2.17.0
+    # via mkdocs-material
+backrefs==5.8
+    # via mkdocs-material
+certifi==2025.4.26
+    # via requests
+cfgv==3.4.0
+    # via pre-commit
+charset-normalizer==3.4.2
+    # via requests
+click==8.2.1
+    # via mkdocs
+colorama==0.4.6
+    # via mkdocs-material
+coverage==7.8.2
+    # via pytest-cov
+decorator==5.2.1
+    # via ipython
+distlib==0.3.9
+    # via virtualenv
+executing==2.2.0
+    # via stack-data
+filelock==3.18.0
+    # via virtualenv
+ghp-import==2.1.0
+    # via mkdocs
+identify==2.6.12
+    # via pre-commit
+idna==3.10
+    # via requests
+iniconfig==2.1.0
+    # via pytest
+ipython==9.3.0
+    # via nx-vis-visualizer (pyproject.toml)
+ipython-pygments-lexers==1.1.1
+    # via ipython
+jedi==0.19.2
+    # via ipython
+jinja2==3.1.6
+    # via
+    #   mkdocs
+    #   mkdocs-material
+markdown==3.8
+    # via
+    #   mkdocs
+    #   mkdocs-material
+    #   pymdown-extensions
+markupsafe==3.0.2
+    # via
+    #   jinja2
+    #   mkdocs
+matplotlib-inline==0.1.7
+    # via ipython
+mergedeep==1.3.4
+    # via
+    #   mkdocs
+    #   mkdocs-get-deps
+mkdocs==1.6.1
+    # via
+    #   nx-vis-visualizer (pyproject.toml)
+    #   mkdocs-material
+mkdocs-get-deps==0.2.0
+    # via mkdocs
+mkdocs-material==9.6.14
+    # via nx-vis-visualizer (pyproject.toml)
+mkdocs-material-extensions==1.3.1
+    # via mkdocs-material
+mypy==1.16.0
+    # via nx-vis-visualizer (pyproject.toml)
+mypy-extensions==1.1.0
+    # via mypy
+networkx==3.5
+    # via
+    #   nx-vis-visualizer (pyproject.toml)
+    #   nx-vis-visualizer
+nodeenv==1.9.1
+    # via pre-commit
+numpy==2.2.6
+    # via types-networkx
+nx-vis-visualizer @ file:///media/Secondary/Projects/nx-vis-visualizer
+    # via nx-vis-visualizer (pyproject.toml)
+packaging==25.0
+    # via
+    #   mkdocs
+    #   pytest
+paginate==0.5.7
+    # via mkdocs-material
+parso==0.8.4
+    # via jedi
+pathspec==0.12.1
+    # via
+    #   mkdocs
+    #   mypy
+pexpect==4.9.0
+    # via ipython
+platformdirs==4.3.8
+    # via
+    #   mkdocs-get-deps
+    #   virtualenv
+pluggy==1.6.0
+    # via pytest
+pre-commit==4.2.0
+    # via nx-vis-visualizer (pyproject.toml)
+prompt-toolkit==3.0.51
+    # via ipython
+ptyprocess==0.7.0
+    # via pexpect
+pure-eval==0.2.3
+    # via stack-data
+pygments==2.19.1
+    # via
+    #   ipython
+    #   ipython-pygments-lexers
+    #   mkdocs-material
+    #   pytest
+pymdown-extensions==10.15
+    # via mkdocs-material
+pytest==8.4.0
+    # via
+    #   nx-vis-visualizer (pyproject.toml)
+    #   pytest-cov
+pytest-cov==6.1.1
+    # via nx-vis-visualizer (pyproject.toml)
+python-dateutil==2.9.0.post0
+    # via ghp-import
+pyyaml==6.0.2
+    # via
+    #   mkdocs
+    #   mkdocs-get-deps
+    #   pre-commit
+    #   pymdown-extensions
+    #   pyyaml-env-tag
+pyyaml-env-tag==1.1
+    # via mkdocs
+requests==2.32.3
+    # via mkdocs-material
+ruff==0.11.12
+    # via nx-vis-visualizer (pyproject.toml)
+six==1.17.0
+    # via python-dateutil
+stack-data==0.6.3
+    # via ipython
+traitlets==5.14.3
+    # via
+    #   ipython
+    #   matplotlib-inline
+types-networkx==3.5.0.20250531
+    # via nx-vis-visualizer (pyproject.toml)
+typing-extensions==4.14.0
+    # via mypy
+urllib3==2.4.0
+    # via requests
+virtualenv==20.31.2
+    # via pre-commit
+watchdog==6.0.0
+    # via mkdocs
+wcwidth==0.2.13
+    # via prompt-toolkit