Add Giscus widget to documentation

Might help with feedback

Author: HexDecimal

.vscode/settings.json

@@ -556,5 +556,8 @@
     "python.testing.pytestEnabled": true,
     "[python]": {
         "editor.defaultFormatter": "charliermarsh.ruff"
+    },
+    "[html]": {
+        "editor.formatOnSave": false
     }
 }

docs/_templates/page.html

@@ -0,0 +1,21 @@
+{% extends "!page.html" %}
+{% block content %}
+    {{ super() }}
+
+    <script src="https://giscus.app/client.js"
+            data-repo="libtcod/python-tcod"
+            data-repo-id="MDEwOlJlcG9zaXRvcnkzMjE5MjIzOA=="
+            data-category="Docs"
+            data-category-id="DIC_kwDOAes27s4C1Ynw"
+            data-mapping="specific"
+            data-term="{{ pagename }} - python-tcod docs"
+            data-strict="0"
+            data-reactions-enabled="0"
+            data-emit-metadata="0"
+            data-input-position="bottom"
+            data-theme="preferred_color_scheme"
+            data-lang="en"
+            crossorigin="anonymous"
+            async>
+    </script>
+{% endblock %}

docs/conf.py

@@ -1,5 +1,5 @@
 """Sphinx config file."""  # noqa: INP001
-# tdl documentation build configuration file, created by
+# python-tcod documentation build configuration file, created by
 # sphinx-quickstart on Fri Nov 25 12:49:46 2016.
 #
 # This file is execfile()d with the current directory set to its
@@ -73,20 +73,20 @@
 # built documents.
 #
 # The full version, including alpha/beta/rc tags.
-git_describe = subprocess.run(
+release = subprocess.run(
     ["git", "describe", "--abbrev=0"],  # noqa: S607
     stdout=subprocess.PIPE,
     text=True,
     check=True,
-)
-release = git_describe.stdout.strip()
+).stdout.strip()
 assert release
 print(f"release version: {release!r}")
 
 # The short X.Y version.
 match_version = re.match(r"([0-9]+\.[0-9]+).*?", release)
 assert match_version
 version = match_version.group()
+print(f"short version: {version!r}")
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -167,9 +167,9 @@
 # html_theme_path = []
 
 # The name for this set of Sphinx documents.
-# "<project> v<release> documentation" by default.
+# "<project> <release> documentation" by default.
 #
-# html_title = u'tdl v1'
+html_title = f"{project} {release} documentation"
 
 # A shorter title for the navigation bar.  Default is the same as html_title.
 #