Tutorials infrastructure: switch to text-based notebook workflow

.github/workflows/deploy.yml

@@ -23,6 +23,7 @@ jobs:
         python-version: [3.8]
         # TODO Uncomment when skimage theme is ready
         # node-version: [15]
+
     steps:
       - uses: actions/[email protected]
 
@@ -60,17 +61,17 @@ jobs:
       # - name: Build the theme
       #   run: yarn build:theme-prod
 
-      # Build the book
-      - name: Build the book
+      # Build site
+      - name: Build site
         env:
           DISPLAY: ":99.0"
-        run: jupyter-book build .
+        run: make -C website/ html
 
-      # Deploy the book's HTML to github pages
+      # Deploy site to github pages
       - name: GitHub Pages action
         if: github.repository == 'scikit-image/skimage-tutorials' && github.ref == 'refs/heads/main' && github.event_name == 'push'
         uses: peaceiris/[email protected]
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./_build/html
+          publish_dir: ./website/_build/html
           cname: scikit-image.org

.gitignore

@@ -9,3 +9,6 @@ build
 *~
 *pano-advanced-output.png
 book/lessons
+
+# ignoring website local builds
+website/_build

Makefile

@@ -6,8 +6,8 @@ LESSONS_DIR = lessons
 GENERATED_LESSONS_DIR = book/lessons
 
 _requirements.installed:
-	pip install -q -r requirements.txt
-	touch _requirements.installed
+    pip install -q -r requirements.txt
+    touch _requirements.installed
 
 MARKDOWNS = $(wildcard $(LESSONS_DIR)/*.md)
 MD_OUTPUTS = $(patsubst $(LESSONS_DIR)/%.md, $(GENERATED_LESSONS_DIR)/%.md, $(MARKDOWNS))
@@ -17,25 +17,24 @@ NOTEBOOKS = $(patsubst %.md, %.ipynb, $(MD_OUTPUTS))
 
 $(GENERATED_LESSONS_DIR)/%.ipynb:$(LESSONS_DIR)/%.md book/lessons book/lessons/images
         # This does not work, due to bug in notedown; see https://github.com/aaren/notedown/issues/53
-	#notedown --match=python --precode='%matplotlib inline' $< > $@
-	notedown --match=python $< > $@
-	jupyter nbconvert --execute --inplace $@ --ExecutePreprocessor.timeout=-1
+    #notedown --match=python --precode='%matplotlib inline' $< > $@
+    notedown --match=python $< > $@
+    jupyter nbconvert --execute --inplace $@ --ExecutePreprocessor.timeout=-1
 
 %.md:%.ipynb
-	jupyter nbconvert --to=mdoutput --output="$(notdir $@)" --output-dir=$(GENERATED_LESSONS_DIR) $<
+    jupyter nbconvert --to=mdoutput --output="$(notdir $@)" --output-dir=$(GENERATED_LESSONS_DIR) $<
 #	$(eval NBSTRING := [📂 Download lesson notebook](.\/$(basename $(notdir $@)).ipynb)\n\n)
 #	sed -i'.bak' '1s/^/$(NBSTRING)/' $@
 
-
 book/lessons:
-	mkdir -p book/lessons
+    mkdir -p book/lessons
 
 book/lessons/images:
-	ln -s ${PWD}/lessons/images ${PWD}/book/lessons/images
+    ln -s ${PWD}/lessons/images ${PWD}/book/lessons/images
 
 html: | _requirements.installed $(NOTEBOOKS) $(MD_OUTPUTS)
-	@export SPHINXOPTS=-W; make -C book html
-	cp $(GENERATED_LESSONS_DIR)/*.ipynb book/build/html/lessons/
+    @export SPHINXOPTS=-W; make -C book html
+    cp $(GENERATED_LESSONS_DIR)/*.ipynb book/build/html/lessons/
 
 clean:
-	rm -rf $(GENERATED_LESSONS_DIR)/*
+    rm -rf $(GENERATED_LESSONS_DIR)/*

_toc.yml

@@ -1,6 +1,7 @@
-- file: lectures/00_images_are_arrays
+format: jb-article
+root: lectures/00_images_are_arrays
+sections:
 - file: lectures/1_image_filters
 - file: lectures/3_morphological_operations
 - file: lectures/4_segmentation
 - file: lectures/three_dimensional_image_processing
-