migrate to mystmd

.github/workflows/deploy.yml

@@ -0,0 +1,48 @@
+# This file was created automatically with `myst init --gh-pages` 🪄 💚
+
+name: MyST GitHub Pages Deploy
+on:
+  push:
+    # Runs on pushes targeting the default branch
+    branches: [main]
+# env:
+  # `BASE_URL` determines the website is served from, including CSS & JS assets
+  # You may need to change this to `BASE_URL: ''`
+  # BASE_URL: /${{ github.event.repository.name }}
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: 'pages'
+  cancel-in-progress: false
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup Pages
+        uses: actions/configure-pages@v3
+      - name: Setup Miniconda
+        uses: conda-incubator/setup-miniconda@v3
+        with:
+          auto-activate-base: false
+          environment-file: environment.yml
+          python-version: 3.11
+          activate-environment: rlbook
+      - name: Build HTML Assets
+        run: myst build --html --execute --ci
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v1
+        with:
+          path: './_build/html'
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v2

.gitignore

@@ -1,6 +1,7 @@
 _build/
 .DS_Store
 .ipynb_checkpoints/
+__pycache__/
 
 # exercise solutions
 solutions/
@@ -25,3 +26,6 @@ conf.py
 *.run.xml
 *.synctex.gz
 *.toc
+
+# MyST build outputs
+_build

Makefile

@@ -2,11 +2,10 @@ ENV_NAME = rlbook
 
 RUN = micromamba run -n $(ENV_NAME)
 
-_NOTEBOOKS = $(addprefix book/, bandits contextual_bandits control exploration fitted_dp imitation_learning mdps pg planning supervised_learning)
+_NOTEBOOKS = $(addprefix book/, bandits control exploration fitted_dp imitation_learning mdps pg planning supervised_learning)
 
 _META = \
 	background \
-	bibliography \
 	index
 
 NOTEBOOKS = $(addsuffix .md, $(_NOTEBOOKS))
@@ -22,7 +21,7 @@ SOURCE = $(NOTEBOOKS) $(META) $(SOLUTIONS)
 CONFIG = book/_config.yml book/_toc.yml
 
 book/_build/html: $(SOURCE) $(CONFIG)
-	$(RUN) jb build book
+	$(RUN) jb build -W -n --keep-going book
 
 open: book/_build/html
 	open book/_build/html/index.html

book/_toc.yml

@@ -15,6 +15,6 @@ chapters:
   - file: imitation_learning.md
   - file: planning.md
   - file: exploration.md
-  - file: contextual_bandits.md
-  - file: bibliography.md
+  # - file: contextual_bandits.md
+  # - file: bibliography.md
   - file: background.md

book/background.md

@@ -1,4 +1,16 @@
-(background)=
+---
+jupytext:
+  text_representation:
+    extension: .md
+    format_name: myst
+    format_version: 0.13
+    jupytext_version: 1.16.2
+kernelspec:
+  display_name: Python 3 (ipykernel)
+  language: python
+  name: python3
+---
+
 # Appendix: Background
 
 ## O notation