feat: Upgrade to Jupyter Book v2 (#107)

* Migrate to Jupyter Book v2.
   - book/_config.yml and book/_toc.yml are combined into book/myst.yml.
   - Update Pixi commands to use 'cwd' to be in the correct directory tree for myst.
* Upgrade Pixi workspace.
   - Add insecure run-post-link-scripts for ROOT.
   - Update Pixi 'start' task to default to serving the book.

Author: matthewfeickert

.pixi/config.toml

@@ -0,0 +1 @@
+run-post-link-scripts = "insecure"

README.md

@@ -34,9 +34,11 @@ To build the book after setup simply run
 ### Using `pixi`
 
 ```
-pixi run build
+pixi run start
 ```
 
+to build and serve the book
+
 ### Local virtual environment
 
 ```

book/_config.yml

@@ -0,0 +1,43 @@
+version: 1
+project:
+  title: pyhf Tutorial
+  authors:
+    - name: the pyhf development team
+  github: pyhf/pyhf-tutorial
+  jupyter:
+    binder:
+      repo: pyhf/pyhf-tutorial
+      ref: main
+      provider: github
+      url: mybinder.org
+  exports:
+    - format: pdf
+      template: plain_latex_book
+      output: exports/book.pdf
+  toc:
+    - file: introduction.md
+    - title: Get started
+      children:
+        - file: HelloWorld.ipynb
+        - file: SimpleWorkspace.ipynb
+        - file: SerializationAndPatching.ipynb
+    - title: Common use and applications
+      children:
+        - file: PullPlot.ipynb
+        - file: Toys.ipynb
+        - file: Combinations.ipynb
+        - file: UpperLimitsTable.ipynb
+    - title: More Information
+      children:
+        - file: IntroToHiFa.ipynb
+        - file: WorkspaceManipulations.ipynb
+        - file: Modifiers.ipynb
+        - file: UsingCalculators.ipynb
+    - title: Learn Fundamentals
+      children:
+        - file: InterpolationCodes.ipynb
+site:
+  options:
+    logo: assets/pyhf-logo.svg
+    folders: true
+  template: book-theme

book/_toc.yml

@@ -1,46 +1,52 @@
-[project]
+[workspace]
 authors = ["Matthew Feickert <matthew.feickert@cern.ch>"]
 channels = ["conda-forge"]
 description = "pyhf user guide"
 name = "pyhf-tutorial"
 platforms = ["linux-64", "osx-64", "osx-arm64"]
 version = "0.7.6"
 
-[tasks.start]
-description = "Launch Jupyer Lab and explore the user guide notebooks"
-cmd = "jupyter lab"
-
 [dependencies]
-python = "3.12.*"
+python = ">=3.13.9,<3.14"
 pyhf = "0.7.6.*"
-uproot = ">=5.5.1,<6"
-iminuit = ">=2.30.1,<3"
-matplotlib-base = ">=3.10.0,<4"
-requests = ">=2.32.3,<3"
+uproot = ">=5.6.8,<6"
+iminuit = ">=2.32.0,<3"
+matplotlib-base = ">=3.10.8,<4"
+requests = ">=2.32.5,<3"
 # visualization
-ipywidgets = ">=8.1.5,<9"
-ipympl = ">=0.9.5,<0.10"
-pandas = ">=2.2.3,<3"
-altair = ">=5.5.0,<6"
-rich = ">=13.9.4,<14"
-# jupyter notebooks
-notebook = ">=7.3.2,<8"
-jupyterlab = ">=4.3.4,<5"
+ipywidgets = ">=8.1.8,<9"
+ipympl = ">=0.9.8,<0.10"
+pandas = ">=2.3.3,<3"
+altair = ">=6.0.0,<7"
+rich = ">=14.2.0,<15"
+# comparison
+root_base = ">=6.36.4,<7"
+
+[feature.lab.dependencies]
+notebook = ">=7.5.0,<8"
+jupyterlab = ">=4.5.0,<5"
+
+[feature.lab.tasks.lab]
+description = "Launch Jupyer Lab and explore the user guide notebooks"
+cmd = "jupyter lab"
 
 [feature.book.tasks.build]
 description = "Build the Jupyter Book"
-cmd = "jupyter-book build book/"
+cmd = "jupyter-book build"
+cwd = "book"
 
 [feature.book.tasks.clean]
 description = "Remove the Jupyter Book build"
-cmd = "rm -rf book/_build"
+cmd = "jupyter-book clean && rm -rf ./_build"
+cwd = "book"
 
-[feature.book.dependencies]
-jupyter-book = "0.15.1.*"
+[feature.book.tasks.start]
+description = "Serve the Jupyter Book as a website"
+cmd = "jupyter-book start"
+cwd = "book"
 
-# macOS support for ROOT is currently not good
-[feature.book.target.linux-64.dependencies]
-root_base = ">=6.32.2,<7"
+[feature.book.dependencies]
+jupyter-book = ">=2.0.2,<3"
 
 [feature.jupyterlite.tasks.build-lite]
 description = "Build JupyterLite version of book"
@@ -67,10 +73,11 @@ rm -rf book/jupyterlite.ipynb
 """
 
 [feature.jupyterlite.dependencies]
-jupyterlite = ">=0.5.0,<0.6"
-jupyterlite-pyodide-kernel = ">=0.5.0,<0.6"
-jupytext = ">=1.16.6,<2"
+jupyterlite = ">=0.7.0,<0.8"
+jupyterlite-pyodide-kernel = ">=0.7.0,<0.8"
+jupytext = ">=1.18.1,<2"
 
 [environments]
+lab = ["lab"]
 book = ["book"]
 jupyterlite = ["jupyterlite"]