fix: mystmd doesn't support .svg for favicon, use .ico instead

Author: softwareentrepreneer

afterpython/_website/static/favicon.ico

@@ -5,7 +5,7 @@ url = "https://afterpython.org"  # used in myst.yml's venue.url
 
 [website]
 url = "https://afterpython.afterpython.org"
-favicon = "favicon.svg"
+favicon = "favicon.ico"
 logo = "logo.svg"
 logo_dark = "logo.svg"
 thumbnail = "thumbnail.png"  # thumbnail for the website, also used as default thumbnail for all content types, e.g. blog posts, tutorials, examples, and guides

afterpython/_website/static/favicon.svg

@@ -18,7 +18,7 @@ project:
     title: 'AfterPython.Org'
     url: https://afterpython.org
   # To autogenerate a Table of Contents, run "myst init --write-toc"
-  copyright: © AfterPython.Org 2025. All rights reserved.
+  copyright: © AfterPython.Org 2026. All rights reserved.
   # title:
   description: CLI tool to streamline Python package maintenance and generate a dedicated project website
   keywords:
@@ -50,11 +50,12 @@ project:
     - file: references/roadmap.md
   - file: CONTRIBUTING.md
   title: ''
+  thumbnail: ../static/thumbnail.png
 site:
   template: book-theme
 # See options at: https://mystmd.org/guide/website-templates#site-options
   options:
-    favicon: ../static/favicon.svg
+    favicon: ../static/favicon.ico
     logo: ../static/logo.svg
     logo_dark: ../static/logo.svg
     logo_text: afterpython

afterpython/_website/static/logo.svg

@@ -35,7 +35,7 @@ pyproject-metadata = ">=0.11.0"
 # jupytext = ">=1.18.1"
 # jinja2 = ">=3.1.6"
 mystmd = ">=1.9.0"
-pdoc = ">=16.0.0"
+great-docs = ">=0.9"
 ruff = ">=0.15.12"
 pre-commit = ">=4.6.0"
 commitizen = ">=4.13.10"

afterpython/afterpython.toml

@@ -44,18 +44,13 @@ dependencies = [
     # "jupytext>=1.18.1",
     # "jinja2>=3.1.6",
     "mystmd>=1.9.0",
-    "pdoc>=16.0.0",
+    "great-docs>=0.9",
     "ruff>=0.15.12",
     "pre-commit>=4.6.0",
     "commitizen>=4.13.10",
     # "python-semantic-release>=10.5.2",
 ]
 
-[dependency-groups]
-dev = [
-    "afterpython>=0.2.1",
-]
-
 [project.urls]
 homepage = "https://afterpython.afterpython.org"
 repository = "https://github.com/AfterPythonOrg/afterpython"

afterpython/doc/myst.yml

@@ -58,6 +58,10 @@ def sync():
         website_favicon = normalize_static_path(
             str(_from_tomlkit(afterpython.get("website", {})).get("favicon", ""))
         )
+        if website_favicon and not website_favicon.lower().endswith(".ico"):
+            raise ValueError(
+                f"Invalid favicon '{website_favicon}': mystmd only supports .ico files."
+            )
         website_logo = normalize_static_path(
             str(_from_tomlkit(afterpython.get("website", {})).get("logo", ""))
         )
@@ -100,6 +104,8 @@ def sync():
     # based on the current values in pyproject.toml and afterpython.toml
     for content_type in CONTENT_TYPES:
         path = ap.paths.afterpython_path / content_type
+        if not (path / "myst.yml").exists():
+            continue
         # nav_bar_per_content_type = [
         #     item for item in nav_bar if item["title"] != content_type.capitalize() + "s"
         # ]