docs: build hosted exports from source

Author: lfagundes

.github/workflows/python-app.yml

@@ -117,6 +117,8 @@ jobs:
 
     steps:
       - uses: actions/checkout@v3
+        with:
+          submodules: recursive
 
       - uses: actions/setup-node@v4
         with:
@@ -129,20 +131,25 @@ jobs:
         with:
           python-version: "3.12"
           cache: "pip"
-          cache-dependency-path: docs/requirements.txt
+          cache-dependency-path: |
+            docs/requirements.txt
+            requirements.txt
 
       - name: Build widget bundle
         working-directory: solid_node/viewers/widget
         run: |
           npm ci
           npm run build
 
-      - name: Install docs requirements
-        run: pip install -r docs/requirements.txt .
+      - name: Install runtime and docs requirements
+        run: pip install -r requirements.txt -r docs/requirements.txt
 
       - name: Generate V8 example export
         working-directory: docs/examples/v8-engine
-        run: solid export root -o docs/_exports/v8-engine --fps 30 --frames 360
+        run: >-
+          PYTHONPATH="$GITHUB_WORKSPACE" python -c
+          "from solid_node.cli import manage; manage()"
+          export root -o docs/_exports/v8-engine --fps 30 --frames 360
 
       - name: Build docs (fail on warnings)
         run: python -m sphinx -b html -W docs docs/_build

.readthedocs.yaml

@@ -12,7 +12,7 @@ build:
     pre_build:
       - npm ci --prefix solid_node/viewers/widget
       - npm run build --prefix solid_node/viewers/widget
-      - cd docs/examples/v8-engine && solid export root -o docs/_exports/v8-engine --fps 30 --frames 360
+      - cd docs/examples/v8-engine && PYTHONPATH="$READTHEDOCS_REPOSITORY_PATH" python -c "from solid_node.cli import manage; manage()" export root -o docs/_exports/v8-engine --fps 30 --frames 360
 
 submodules:
   include: all
@@ -21,8 +21,7 @@ submodules:
 python:
   install:
     - requirements: docs/requirements.txt
-    - method: pip
-      path: .
+    - requirements: requirements.txt
 
 sphinx:
   configuration: docs/conf.py