Merge branch 'main' into markpeek-description-escape

Author: sciencewhiz

.github/workflows/workflow.yml

@@ -69,7 +69,7 @@ jobs:
       fail-fast: false
       matrix:
         python-version: ['pypy3.9', '3.8', '3.9', '3.10', '3.11', '3.12']
-        sphinx-version: ['>=4,<5', '>=5,<6', '>=6a0,<7', '>=7,<8']
+        sphinx-version: ['>=5,<6', '>=6a0,<7', '>=7,<7.3']
         os: [windows-latest, macos-latest, ubuntu-latest]
     steps:
       - uses: actions/checkout@v4

docs/script/generate_social_card_previews.py

@@ -2,6 +2,7 @@
 A helper script to test out what social previews look like.
 I should remove this when I'm happy with the result.
 """
+
 # %load_ext autoreload
 # %autoreload 2
 

noxfile.py

@@ -10,6 +10,7 @@
 
 ref: https://nox.thea.codes/
 """
+
 import nox
 from shlex import split
 

setup.py

@@ -14,7 +14,7 @@
     long_description_content_type="text/markdown",
     url="https://github.com/wpilibsuite/sphinxext-opengraph",
     license="LICENSE.md",
-    install_requires=["sphinx>=4.0"],
+    install_requires=["sphinx>=5.0"],
     packages=["sphinxext/opengraph"],
     include_package_data=True,
     package_data={"sphinxext.opengraph": ["sphinxext/opengraph/_static/*"]},

sphinxext/opengraph/socialcards.py

@@ -1,4 +1,5 @@
 """Build a PNG card for each page meant for social media."""
+
 import hashlib
 from pathlib import Path
 import matplotlib