Read The Docs and dependency upgrades

.github/workflows/ci.yml

@@ -28,7 +28,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        python_version: ["3.8"]
+        python_version: ["3.12"]
       fail-fast: false # Don't cancel all jobs if one fails
 
     runs-on: ${{ matrix.os }}
@@ -61,7 +61,7 @@ jobs:
       - name: Setup Python
         uses: actions/setup-python@v4
         with:
-          python-version: "3.8"
+          python-version: "3.12"
 
       - name: Install dependencies
         run: make deps
@@ -82,7 +82,7 @@ jobs:
       - name: Setup Python
         uses: actions/setup-python@v4
         with:
-          python-version: "3.8"
+          python-version: "3.12"
 
       - name: Install dependencies
         run: make deps

.github/workflows/close-talk-issues.yml

@@ -28,7 +28,7 @@ jobs:
       - name: Setup Python
         uses: actions/setup-python@v4
         with:
-          python-version: "3.8"
+          python-version: "3.12"
 
       - name: Install ghapi to interact with the GitHub REST API
         run: |

.github/workflows/external_link_check.yml

@@ -16,7 +16,7 @@ jobs:
       - name: Setup Python
         uses: actions/setup-python@v4
         with:
-          python-version: "3.8"
+          python-version: "3.12"
 
       - name: Install dependencies
         run: make deps

.github/workflows/lorem-ipsums.yml

@@ -28,10 +28,10 @@ jobs:
       # Checkout the repository. Relies on another GH-Action.
       - uses: actions/checkout@v3
       # Set up the Python version. Relies on another GH-Action.
-      - name: Setup Python 3.8
+      - name: Setup Python 3.12
         uses: actions/setup-python@v4
         with:
-          python-version: "3.8"
+          python-version: "3.12"
       # Install Python dependencies
       - name: Install dependencies
         working-directory: ./tests

.github/workflows/no-bad-latin.yml

@@ -28,10 +28,10 @@ jobs:
       # Checkout the repository. Relies on another GH-Action.
       - uses: actions/checkout@v3
       # Set up the Python version. Relies on another GH-Action.
-      - name: Setup Python 3.8
+      - name: Setup Python 3.12
         uses: actions/setup-python@v4
         with:
-          python-version: "3.8"
+          python-version: "3.12"
       # Install Python dependencies
       - name: Install dependencies
         working-directory: ./tests

.github/workflows/yamllint.yaml

@@ -17,10 +17,10 @@ jobs:
       - name: Checkout repo
         uses: actions/checkout@v3
 
-      - name: Setup Python 3.8
+      - name: Setup Python 3.12
         uses: actions/setup-python@v4
         with:
-          python-version: "3.8"
+          python-version: "3.12"
 
       - name: Install yamllint via pip
         run: |

.readthedocs.yml

@@ -0,0 +1,27 @@
+# .readthedocs.yaml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.12"
+  jobs:
+    pre_build:
+      # Generate Sphinx conf.py using JupyterBook
+      - "jupyter-book config sphinx book/website"
+      # Write pathways modifications
+      - "pathways book/website"
+
+sphinx:
+  configuration: book/website/conf.py
+
+# formats:
+#    - pdf
+#    - epub
+
+python:
+  install:
+    - requirements: book/website/requirements.txt

book/Makefile

@@ -11,7 +11,7 @@ strict:
 	jupyter-book build ./website -W --keep-going
 
 pathways:
-	python -m pathways.main pathways ./website/
+	pathways ./website/ --build
 
 clean:
 	jupyter-book clean -a ./website

book/website/community-handbook/local-build.md

@@ -22,7 +22,7 @@ You will need to locate your "terminal" or "prompt" application on your machine.
 3. Create a new environment and install a modern version of Python into it:
 
    ```console
-   conda create --name the-turing-way python=3.8
+   conda create --name the-turing-way python=3.10
    ```
 
 4. Activate the environment with:

book/website/requirements.in

@@ -1,6 +1,6 @@
 datascience
 folium
-git+https://github.com/the-turing-way/pathways.git@v0.1.0
+git+https://github.com/the-turing-way/pathways.git@v0.2.2
 jinja2
 jupyter-book
 matplotlib