Docs: Minimally modernize Sphinx configuration. Fix building on Pytho…

…n 3.11. (#526)

## About
Just a little maintenance patch for the Sphinx docs, to minimally
modernize dependencies, and to fix the build [^1].

[^1]: [...] and to probe if any commit styles of mine (commit messages,
wording, whatever) need to be adjusted to comply with any policies
employed here.

.gitignore

@@ -1,3 +1,4 @@
+.venv*
 .vscode/
 .cache
 .idea

docs/requirements.txt

@@ -1,48 +1,6 @@
-alabaster==0.7.12
-appdirs==1.4.3
-atomicwrites==1.2.1
-attrs==18.2.0
-babel==2.6.0
-black==18.9b0
-bleach==3.1.4
-certifi==2018.8.24
-cffi==1.11.5
-chardet==3.0.4
-click==7.0
-cmarkgfm==0.4.2
-colorama==0.4.0 ; sys_platform == 'win32'
-docutils==0.14
-flake8==3.5.0
-flask==1.0.2
-future==0.16.0
-idna==2.7
-imagesize==1.1.0
-itsdangerous==0.24
-jinja2==2.10
-markupsafe==1.0
-mccabe==0.6.1
-more-itertools==4.3.0
-packaging==18.0
-pkginfo==1.4.2
-pluggy==0.7.1
-py==1.7.0
-pycodestyle==2.3.1
-pycparser==2.19
-pyflakes==1.6.0
-pygments==2.2.0
-pyparsing==2.2.2
-pytest==3.8.2
-pytz==2018.5
-readme-renderer==22.0
-requests-toolbelt==0.8.0
-requests==2.19.1
-six==1.11.0
-snowballstemmer==1.2.1
-sphinx==1.8.1
-sphinxcontrib-websupport==1.1.0
-toml==0.10.0
-tqdm==4.26.0
-twine==1.12.1
-urllib3==1.23
-webencodings==0.5.1
-werkzeug==0.15.5
+alabaster<0.8
+jinja2<2.11
+markupsafe<2
+readme-renderer<23
+sphinx>=5,<6
+sphinxcontrib-websupport<1.2

docs/source/conf.py

@@ -76,7 +76,7 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = "en"
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.

docs/source/index.rst

@@ -8,8 +8,8 @@ A familiar HTTP Service Framework
 
 |Build Status| |image1| |image2| |image3| |image4| |image5|
 
-.. |Build Status| image:: https://travis-ci.org/kennethreitz/responder.svg?branch=master
-   :target: https://travis-ci.org/kennethreitz/responder
+.. |Build Status| image:: https://github.com/kennethreitz/responder/actions/workflows/test.yaml/badge.svg
+   :target: https://github.com/kennethreitz/responder/actions/workflows/test.yaml
 .. |image1| image:: https://img.shields.io/pypi/v/responder.svg
    :target: https://pypi.org/project/responder/
 .. |image2| image:: https://img.shields.io/pypi/l/responder.svg
@@ -83,7 +83,7 @@ Testimonials
 
 
 .. _Django REST Framework: https://www.django-rest-framework.org/
-.. _Two Scoops of Django: https://www.twoscoopspress.com/products/two-scoops-of-django-1-11
+.. _Two Scoops of Django: https://www.feldroy.com/two-scoops-press#two-scoops-of-django
 
 User Guides
 -----------

docs/source/tour.rst

@@ -283,7 +283,7 @@ Supported directives:
 * ``secure`` - Defaults to ``False``.
 * ``httponly`` - Defaults to ``True``.
 
-For more information see `directives <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#Directives>`_
+For more information see `directives <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie>`_
 
 
 Using Cookie-Based Sessions