Merge pull request #409 from twisted/408-rtd-build-fix

.readthedocs.yml

@@ -4,9 +4,8 @@ sphinx:
   # We want to fail as this is also our CI check for the docs.
   fail_on_warning: True
 
-formats:
-  - pdf
-  - epub
+# We don't need PDF and epub for the docs.
+formats: []
 
 python:
   version: "3.8"

docs/conf.py

@@ -29,6 +29,11 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
+from datetime import date
+
+from towncrier import __version__ as towncrier_version
+
+
 extensions = []
 
 # Add any paths that contain templates here, relative to this directory.
@@ -44,10 +49,24 @@
 master_doc = "index"
 
 # General information about the project.
+_today = date.today()
 project = "Towncrier"
-copyright = "2017, Amber Brown"
+copyright = "{}, Towncrier contributors. Ver {}".format(
+    _today.year,
+    towncrier_version.public(),
+)
 author = "Amber Brown"
 
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+# The short X.Y version.
+version = "{}.{}.{}".format(
+    towncrier_version.major, towncrier_version.minor, towncrier_version.micro
+)
+# The full version, including alpha/beta/rc tags.
+release = towncrier_version.public()
+
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This patterns also effect to html_static_path and html_extra_path