Merge branch 'master' into master

Author: agoose77

.github/workflows/publish.yml

@@ -15,11 +15,11 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout source
-        uses: actions/checkout@v3
-      - name: Set up Python 3.9
+        uses: actions/checkout@v4
+      - name: Set up Python 3.11
         uses: actions/setup-python@v4
         with:
-          python-version: 3.9
+          python-version: 3.11
 
       - name: Build package
         run: |
@@ -28,7 +28,7 @@ jobs:
           python -m build
 
       - name: Publish
-        uses: pypa/gh-action-pypi-publish@v1.6.4
+        uses: pypa/gh-action-pypi-publish@v1.8.11
         with:
           user: __token__
           password: ${{ secrets.PYPI_KEY }}

.github/workflows/tests.yml

@@ -16,52 +16,56 @@ jobs:
   pre-commit:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - uses: actions/setup-python@v4
       with:
-        python-version: 3.9
+        python-version: 3.11
     - uses: pre-commit/action@v3.0.0
 
   tests:
+    continue-on-error: ${{ matrix.experimental || false }}
     strategy:
+      fail-fast: false
       matrix:
         os: [ubuntu-latest]
-        python-version: [3.7, 3.8, 3.9]
+        python-version: ["3.9", "3.10", "3.11"]
         # Only test the latest major release of Sphinx because otherwise we need to
         # keep multiple versions of regression tests on file and this creates lots of
         # noise in the tests.
-        sphinx: [">=6,<7"]
+        sphinx: ["~=5.0","~=6.0","~=7.0"]
         include:
         - os: windows-latest
-          python-version: 3.9
-          sphinx: ">=6,<7"
+          # Python 3.12 is broken on windows builds until the following PR is released:
+          # https://github.com/pradyunsg/sphinx-theme-builder/pull/47
+          python-version: 3.11
+          # Windows pulling in dependencies fails
+          experimental: true
         - os: macos-latest
-          python-version: 3.9
-          sphinx: ">=6,<7"
+          python-version: 3.x
     runs-on: ${{ matrix.os }}
 
     steps:
-    - uses: actions/checkout@v3
-    - name: Set up Python ${{ matrix.python-version }} and Sphinx ${{ matrix.sphinx }}
+    - uses: actions/checkout@v4
+    - name: Set up Python ${{ matrix.python-version }}
       uses: actions/setup-python@v4
       with:
         python-version: ${{ matrix.python-version }}
         cache: "pip"
         cache-dependency-path: "pyproject.toml"
 
-    - name: Install dependencies
+    - name: Install dependencies with Sphinx ${{ matrix.sphinx }}
       run: |
         python -m pip install --upgrade pip
-        python -m pip install -e .[test]
+        python -m pip install --upgrade "sphinx${{matrix.sphinx}}" -e .[test] --pre
 
     - name: Run pytest
       run: >
         pytest --durations=10 --cov=sphinx_book_theme --cov-report=xml --cov-report=term-missing
 
     # Only upload to codecov on pull requests so that we don't trigger rate limit blocks
     - name: Upload to Codecov
-      if: matrix.os == 'ubuntu-latest' && matrix.python-version == 3.7 && github.repository == 'executablebooks/sphinx-book-theme' && github.event_name == 'pull_request'
-      uses: codecov/codecov-action@v3.1.1
+      if: matrix.os == 'ubuntu-latest' && matrix.python-version == 3.9 && github.repository == 'executablebooks/sphinx-book-theme' && github.event_name == 'pull_request'
+      uses: codecov/codecov-action@v3.1.4
       with:
         name: ebp-sbt-pytests-py3.7
         flags: pytests
@@ -73,11 +77,11 @@ jobs:
     runs-on: ubuntu-latest
     name: Build and Audit Documentation
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Set up Python
       uses: actions/setup-python@v4
       with:
-        python-version: '3.7'
+        python-version: '3.9'
         cache: "pip"
         cache-dependency-path: "pyproject.toml"
     - name: Install dependencies
@@ -106,7 +110,7 @@ jobs:
         assert len(unexpected) == 0
 
     - name: Audit with Lighthouse
-      uses: treosh/lighthouse-ci-action@9.3.1
+      uses: treosh/lighthouse-ci-action@10.1.0
       with:
         configPath: ".github/workflows/lighthouserc.json"
         temporaryPublicStorage: true

.pre-commit-config.yaml

@@ -14,26 +14,23 @@ default_language_version:
 repos:
 
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.4.0
+    rev: v4.5.0
     hooks:
     - id: check-toml
     - id: check-json
     - id: check-yaml
     - id: end-of-file-fixer
     - id: trailing-whitespace
 
-  - repo: https://github.com/PyCQA/flake8
-    rev: 6.0.0
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.1.6
     hooks:
-    - id: flake8
-
-  - repo: https://github.com/psf/black
-    rev: 23.1.0
-    hooks:
-    - id: black
+    - id: ruff
+      args: ["--fix", "--show-fixes"]
+    - id: ruff-format
 
   - repo: https://github.com/pre-commit/mirrors-prettier
-    rev: v3.0.0-alpha.4
+    rev: v3.1.0
     hooks:
       - id: prettier
         types_or: [scss, javascript]

.readthedocs.yml

@@ -1,10 +1,15 @@
 version: 2
+# Set the OS, Python version and other tools you might need
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.10"
 
 python:
-  version: 3
   install:
     - method: pip
-      path: .[doc]
+      path: ".[doc]"
 
 sphinx:
   builder: html

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## v1.0.1 -- 2023-03-31
+
+This is a minor release supporting pydata>=0.13.3, with a few import changes from pydata.
+
 ## v1.0.0 -- 2023-03-01
 
 This is a major release that brings in the latest PyData Sphinx Theme and a number of new features with it.

docs/components/source-files.md

@@ -10,7 +10,6 @@ an edit or open an issue.
 
 You need to define a **source repository** for this functionality to work.
 This is the online space where your code / documentation is hosted.
-To
 In each case, they require the following configuration to exist:
 
 ```python

docs/conf.py

@@ -86,11 +86,11 @@
     "reference/blog/*": [
         "navbar-logo.html",
         "search-field.html",
-        "postcard.html",
-        "recentposts.html",
-        "tagcloud.html",
-        "categories.html",
-        "archives.html",
+        "ablog/postcard.html",
+        "ablog/recentposts.html",
+        "ablog/tagcloud.html",
+        "ablog/categories.html",
+        "ablog/archives.html",
         "sbt-sidebar-nav.html",
     ]
 }
@@ -205,7 +205,7 @@
         )  # noqa
         content = "\n".join(content)
         # Replace a relative link in the pydata docs w/ the respective one here
-        content = content.replace("../examples/pydata.md", "notebooks.md")
+        content = content.replace("../examples/pydata.ipynb", "notebooks.md")
         # Write to disk in a location that will be ignored by git
         path_content_file.write_text(content)
 

docs/content/launch.md

@@ -28,7 +28,7 @@ file instead of the text file.
 
 ## Binder / BinderHub
 
-To add Binder links your page, add the following configuration:
+To add Binder links to your page, add the following configuration:
 
 ```python
 html_theme_options = {

docs/content/notebooks.md

@@ -223,13 +223,15 @@ import folium
 m = folium.Map(
     location=[45.372, -121.6972],
     zoom_start=12,
-    tiles='Stamen Terrain'
+    tiles='Stamen Terrain',
+    attr="Placeholder attr"
 )
 
 folium.Marker(
     location=[45.3288, -121.6625],
     popup='Mt. Hood Meadows',
-    icon=folium.Icon(icon='cloud')
+    icon=folium.Icon(icon='cloud'),
+    attr="Placeholder attr"
 ).add_to(m)
 
 folium.Marker(
@@ -241,7 +243,8 @@ folium.Marker(
 folium.Marker(
     location=[45.3300, -121.6823],
     popup='Some Other Location',
-    icon=folium.Icon(color='red', icon='info-sign')
+    icon=folium.Icon(color='red', icon='info-sign'),
+    attr="Placeholder attr"
 ).add_to(m)
 
 

docs/contributing/setup.md

@@ -15,7 +15,7 @@ Follow these steps:
    cd sphinx-book-theme
    ```
 
-2. Ensure you have Python 3.7 or newer!
+2. Ensure you have Python 3.9 or newer!
 3. Install `tox`.
    `tox` is a tool for managing virtual environments for test suites or common jobs that are run with a repository.
    It ensures that your environment is consistent each time you build the docs or run tests.