build: use local_extensions

Author: casperdcl

.github/workflows/pages.yml

@@ -41,7 +41,6 @@ jobs:
     - name: linkcheck
       # https://jupyterbook.org/en/stable/reference/cli.html
       run: jupyter-book build --builder linkcheck --warningiserror --nitpick --keep-going .
-      env: {PYTHONPATH: .}
   build:
     runs-on: ubuntu-latest
     steps:
@@ -74,7 +73,6 @@ jobs:
           book.tex
         # insert PDF cover
         curl -fsSLO https://static.premai.io/book/cover.pdf
-      env: {PYTHONPATH: .}
     - uses: xu-cheng/latex-action@v3
       with:
         working_directory: _build/latex

_config.yml

@@ -94,10 +94,10 @@ sphinx:
   extra_extensions:
   - sphinx_last_updated_by_git
   - sphinx_subfigure
-  # custom (local *.py files)
-  - badges
-  - committers
-  - bibliography
+  local_extensions:
+    badges: .
+    committers: .
+    bibliography: .
   config:
     myst_heading_anchors: 4
     html_js_files:

index.md

@@ -68,9 +68,9 @@ Spot something outdated or missing? Want to start a discussion? We welcome any o
 - Or instead, manually set up your own Python environment:
 
   ```sh
-  pip install -r requirements.txt                           # setup
-  PYTHONPATH=. jupyter-book build --builder dirhtml --all . # build
-  python -m http.server -d _build/dirhtml                   # serve
+  pip install -r requirements.txt              # setup
+  jupyter-book build --builder dirhtml --all . # build
+  python -m http.server -d _build/dirhtml      # serve
   ```
 
   ````{admonition} alternative: live rebuilding & serving (experimental)