Merge pull request #37 from rickecon/rick_upd

Merging

Author: rickecon

.github/workflows/deploy_jupyterbook.yml

@@ -24,10 +24,15 @@ jobs:
 
       - name: Build book
         run: make book
+        env:
+          BASE_URL: /Git-Tutorial
+
+      - name: Add .nojekyll
+        run: touch book/_build/html/.nojekyll
 
       - name: Deploy
-        uses: JamesIves/github-pages-deploy-action@releases/v3
+        uses: JamesIves/github-pages-deploy-action@v4
         with:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          BRANCH: gh-pages # The branch the action should deploy to.
-          FOLDER: book/_build/site # The folder the action should deploy.
+          token: ${{ secrets.GITHUB_TOKEN }}
+          branch: gh-pages
+          folder: book/_build/html

Makefile

@@ -1,4 +1,10 @@
-.PHONY: book
+.PHONY: book serve clean
 
 book:
-	cd book && uv run jupyter book clean --all --yes && uv run jupyter book build --all
+	cd book && uv run jupyter book build --html
+
+serve:
+	cd book && uv run jupyter book start
+
+clean:
+	cd book && uv run jupyter book clean --all --yes

README.md

@@ -32,6 +32,13 @@ make book
 
 The `book` target first removes the existing Jupyter Book build artifacts and then performs a fresh site build using `uv run jupyter book build --all`.
 
+You can run the `make serve` command to do all the steps from `make book`, but further initiate a local server on which you can view, check, and validate the functioning web site.
+
+```bash
+make serve
+```
+
+
 ## Notes
 
 This repository is actively maintained and contributions are welcome. The most helpful contributions usually improve tutorial clarity, correct command examples, add beginner-friendly explanations, or expand the hands-on workflow chapters.

book/content/bibliography.md

@@ -42,7 +42,6 @@ project:
     - title: Appendix
       children:
         - file: content/glossary.md
-        - file: content/bibliography.md
 
 site:
   template: book-theme

book/myst.yml

@@ -1,6 +1,6 @@
 [project]
 name = "git-tutorial-book"
-version = "0.1.0"
+version = "0.1.1"
 description = "Build configuration for the PSLmodels Git Tutorial book."
 requires-python = ">=3.11"
 dependencies = [