Merge branch 'executablebooks:master' into main

Author: xinetzone

.github/workflows/publish.yml

@@ -28,7 +28,7 @@ jobs:
           python -m build
 
       - name: Publish
-        uses: pypa/gh-action-pypi-publish@v1.10.0
+        uses: pypa/gh-action-pypi-publish@v1.12.2
         with:
           user: __token__
           password: ${{ secrets.PYPI_KEY }}

.github/workflows/tests.yml

@@ -74,7 +74,7 @@ jobs:
     # Disabled for now with false &&
     - name: Upload to Codecov
       if: false && matrix.os == 'ubuntu-latest' && matrix.python-version == 3.9 && matrix.sphinx == '~=7.0' && github.repository == 'executablebooks/sphinx-book-theme' && github.event_name == 'pull_request'
-      uses: codecov/codecov-action@v3.1.4
+      uses: codecov/codecov-action@v5.0.7
       with:
         name: ebp-sbt-pytests-py3.7
         flags: pytests
@@ -124,7 +124,7 @@ jobs:
         assert len(unexpected) == 0, unexpected
 
     - name: Audit with Lighthouse
-      uses: treosh/lighthouse-ci-action@10.1.0
+      uses: treosh/lighthouse-ci-action@12.1.0
       with:
         configPath: ".github/workflows/lighthouserc.json"
         temporaryPublicStorage: true

.pre-commit-config.yaml

@@ -24,7 +24,7 @@ repos:
     - id: trailing-whitespace
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.7.4
+    rev: v0.8.4
     hooks:
     - id: ruff
       args: ["--fix", "--show-fixes"]

.readthedocs.yml

@@ -13,3 +13,4 @@ python:
 
 sphinx:
   builder: html
+  configuration: docs/conf.py

docs/conf.py

@@ -2,9 +2,10 @@
 import os
 from urllib.request import urlopen
 from pathlib import Path
+from datetime import datetime
 
 project = "Sphinx Book Theme"
-copyright = "2023"
+copyright = str(datetime.now().year)
 author = "the Executable Book Project"
 # language = "fr"  # For testing language translations
 language = "zh_CN"

docs/content/launch.md

@@ -2,11 +2,13 @@
 # Launch buttons for interactivity
 
 You can automatically add buttons that allow users to interact with your
-book's content. This is either by directing them to a BinderHub or JupyterHub
-that runs in the cloud, or by making your page interactive using Thebe.
+book's content. This is can be by directing them to
+a [JupyterLite](https://jupyterlite.readthedocs.io) installation (that runs in
+the user's browser) or one of BinderHub or JupyterHub (that runs in the
+cloud), or by making your page interactive using Thebe.
 
-To use either Binder or JupyterHub links, you'll first need to configure your
-documentation's repository url:
+To use any of JupyterLite or Binder or JupyterHub links, you'll first need to
+configure your documentation's repository url:
 
 ```python
 html_theme_options = {
@@ -26,6 +28,28 @@ folder as your content, then Binder/JupyterHub links will point to the ipynb
 file instead of the text file.
 ```
 
+## JupyterLite
+
+If you are adding [JupyterLite](https://github.com/jupyterlite/jupyterlite) links to your page, first work out where your
+JupyterLite instance will be serving from, then add the URL to your
+configuration. In the example below, we've set up JupyterLite pages at the
+base URL of the main pages site, and at subdirectory `interact/lab`:
+
+```python
+html_theme_options = {
+    ...
+    "launch_buttons": {
+        "jupyterlite_url": "interact/lab/index.html"
+    },
+    ...
+}
+```
+
+See <https://odsti.github.io/cfd-textbook> for an example
+[JupyterBook](https://jupyterbook.org) project serving JupyterLite using this
+configuration, and <https://github.com/odsti/cfd-textbook> for the driving
+repository.
+
 ## Binder / BinderHub
 
 To add Binder links to your page, add the following configuration:

docs/content/notebooks.md

@@ -115,7 +115,7 @@ print("this works for code cells too, if you add a `margin` tag to them")
 ```{code-cell} ipython3
 # You can also include enriched outputs like Math
 from IPython.display import Math
-Math("\sum_{i=0}^n i^2 = \frac{(n^2+n)(2n+1)}{6}")
+Math(r"\sum_{i=0}^n i^2 = \frac{(n^2+n)(2n+1)}{6}")
 ```
 
 ## Removing content before publishing
@@ -171,6 +171,7 @@ See [the Pandas Styling docs](https://pandas.pydata.org/pandas-docs/stable/user_
 :tags: [hide-input]
 
 import pandas as pd
+from pandas.io.formats.style import Styler
 
 np.random.seed(24)
 df = pd.DataFrame({'A': np.linspace(1, 10, 10)})
@@ -195,8 +196,8 @@ def highlight_max(s):
     is_max = s == s.max()
     return ['background-color: yellow' if v else '' for v in is_max]
 
-df.style.\
-    applymap(color_negative_red).\
+Styler(df, uuid="1").\
+    map(color_negative_red).\
     apply(highlight_max).\
     set_table_attributes('style="font-size: 10px"')
 ```

docs/reference/kitchen-sink/generic.rst

@@ -3,7 +3,7 @@
    Licensed under Creative Commons Attribution-ShareAlike 4.0 International License
    SPDX-License-Identifier: CC-BY-SA-4.0
 
-.. |EXAMPLE| image:: https://source.unsplash.com/32x32/daily?icon
+.. |EXAMPLE| image:: https://jupyter.org/assets/logos/rectanglelogo-greytext-orangebody-greymoons.svg
     :width: 1em
 
 =============
@@ -110,7 +110,7 @@ Sidebar
 
     Lorem ipsum dolor sit amet consectetur adipisicing elit.
 
-    .. image:: https://source.unsplash.com/200x200/daily?cute+puppy
+    .. image:: https://jupyter.org/assets/logos/rectanglelogo-greytext-orangebody-greymoons.svg
 
     Lorem ipsum dolor sit amet consectetur adipisicing elit.
 
@@ -268,4 +268,4 @@ voluptatem officia culpa optio atque. Quaerat sed quibusdam ratione nam.
 Download Links
 ==============
 
-:download:`This long long long long long long long long long long long long long long long download link should wrap white-spaces <https://source.unsplash.com/200x200/daily?cute+puppy>`
+:download:`This long long long long long long long long long long long long long long long download link should wrap white-spaces <https://jupyter.org/assets/logos/rectanglelogo-greytext-orangebody-greymoons.svg>`

docs/reference/kitchen-sink/images.rst

@@ -12,18 +12,18 @@ Images
 
 An image:
 
-.. image:: https://source.unsplash.com/200x200/daily?cute+puppy
+.. image:: https://jupyter.org/assets/logos/rectanglelogo-greytext-orangebody-greymoons.svg
    :height: 200
    :width: 200
 
 A clickable image:
 
-.. image:: https://source.unsplash.com/200x200/daily?cute+puppy
-   :target: https://unsplash.com/
+.. image:: https://jupyter.org/assets/logos/rectanglelogo-greytext-orangebody-greymoons.svg
+   :target: https://jupyter.org/
    :height: 200
    :width: 200
 
-.. image:: https://source.unsplash.com/200x200/daily?cute+puppy
+.. image:: https://jupyter.org/assets/logos/rectanglelogo-greytext-orangebody-greymoons.svg
    :align: right
    :height: 200
    :width: 200
@@ -43,7 +43,7 @@ sapiente veritatis doloribus accusantium molestiae modi recusandae
 excepturi facere, corrupti expedita sit nihil temporibus eius sequi
 animi, illo libero labore fuga.
 
-.. image:: https://source.unsplash.com/200x200/daily?cute+puppy
+.. image:: https://jupyter.org/assets/logos/rectanglelogo-greytext-orangebody-greymoons.svg
    :align: left
    :height: 200
    :width: 200
@@ -66,7 +66,7 @@ animi, illo libero labore fuga.
 Figures
 -------
 
-.. figure:: https://source.unsplash.com/200x200/daily?cute+puppy
+.. figure:: https://jupyter.org/assets/logos/rectanglelogo-greytext-orangebody-greymoons.svg
    :alt: reStructuredText, the markup syntax
 
    A figure is an image with a caption and/or a legend:
@@ -83,7 +83,7 @@ Figures
 
 A figure directive with center alignment
 
-.. figure:: https://source.unsplash.com/200x200/daily?cute+puppy
+.. figure:: https://jupyter.org/assets/logos/rectanglelogo-greytext-orangebody-greymoons.svg
    :align: center
 
    This caption should be centered.

docs/reference/kitchen-sink/lists.rst

@@ -246,11 +246,11 @@ Hlists
 .. hlist::
     :columns: 2
 
-    - .. figure:: https://source.unsplash.com/200x200/daily?cute+puppy
+    - .. figure:: https://jupyter.org/assets/logos/rectanglelogo-greytext-orangebody-greymoons.svg
 
          This is a short caption for a figure.
 
-    - .. figure:: https://source.unsplash.com/200x200/daily?cute+puppy
+    - .. figure:: https://jupyter.org/assets/logos/rectanglelogo-greytext-orangebody-greymoons.svg
 
          This is a long caption for a figure. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
          Donec porttitor dolor in odio posuere, vitae ornare libero mattis. In lobortis justo vestibulum nibh aliquet, non.