add the beautiful logo as a favicon

Author: Yatekii

docs/_static/favicon.ico

@@ -1,18 +1,19 @@
-import os, sys
+import os
+import sys
+
 sys.path.insert(0, os.path.abspath("."))
 
 import time
 from importlib.metadata import version as package_version
 
-
 project = "Amaranth language & toolchain"
-version = package_version('amaranth').replace(".editable", "")
+version = package_version("amaranth").replace(".editable", "")
 release = version.split("+")[0]
 copyright = time.strftime("2020—%Y, Amaranth project contributors")
 
 extensions = [
-	"sphinx.ext.intersphinx",
-	"sphinx.ext.doctest",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.doctest",
     "sphinx.ext.todo",
     "sphinx.ext.autodoc",
     "sphinx.ext.napoleon",
@@ -33,9 +34,7 @@
 todo_include_todos = True
 
 autodoc_member_order = "bysource"
-autodoc_default_options = {
-    "members": True
-}
+autodoc_default_options = {"members": True}
 autodoc_preserve_defaults = True
 autodoc_inherit_docstrings = False
 
@@ -49,16 +48,20 @@
 napoleon_include_init_with_doc = True
 napoleon_include_special_with_doc = True
 napoleon_custom_sections = [
-    ("Attributes", "params_style"), # by default displays as "Variables", which is confusing
-    ("Members", "params_style"), # `lib.wiring` signature members
-    "Platform overrides"
+    (
+        "Attributes",
+        "params_style",
+    ),  # by default displays as "Variables", which is confusing
+    ("Members", "params_style"),  # `lib.wiring` signature members
+    "Platform overrides",
 ]
 
 html_theme = "sphinx_rtd_theme"
 html_static_path = ["_static"]
 html_css_files = ["custom.css"]
 html_js_files = ["version-switch.js"]
 html_logo = "_static/logo.png"
+html_favicon = "_static/favicon.ico"
 
 rst_prolog = """
 .. role:: py(code)
@@ -70,7 +73,7 @@
     # Picked up automatically by ReST and doesn't have an index.
     r"^https://amaranth-lang\.org/schema/$",
     # Rejects requests from GHA infra.
-    r"^https://.+\.sourceforge\.net/"
+    r"^https://.+\.sourceforge\.net/",
 ]
 
 linkcheck_anchors_ignore_for_url = [
@@ -84,4 +87,5 @@
 # Silence the warnings globally; otherwise they may fire on object destruction and crash completely
 # unrelated tests.
 import amaranth._unused
+
 amaranth._unused.MustUse._MustUse__silence = True