Use furo theme for documentation

- has dark mode support
  and fixes some layout problem
- split usage into 3 chapters

Author: mrbean-bremen

.readthedocs.yaml

@@ -11,3 +11,7 @@ build:
 sphinx:
   configuration: docs/conf.py
   fail_on_warning: true
+
+python:
+  install:
+    - requirements: docs/requirements.txt

CHANGES.md

@@ -27,6 +27,9 @@ The released versions correspond to PyPI releases.
 * fixed behavior for `os.access` for symlinks under Windows
 * fixes permission problem on querying file properties (see [#1122](../../issues/1122))
 
+### Documentation
+* use a theme for documentation supporting dark mode
+
 ## [Version 5.7.4](https://pypi.python.org/pypi/pyfakefs/5.7.4) (2025-01-14)
 Minor bugfix release.
 

docs/autopatch.rst

@@ -56,7 +56,7 @@
 project = "pyfakefs"
 copyright = """2009 Google Inc. All Rights Reserved.
 © Copyright 2014 Altera Corporation. All Rights Reserved.
-© Copyright 2014-2024 John McGehee"""
+© Copyright 2014-2025 John McGehee and pyfakefs contributors."""
 author = "John McGehee"
 
 # The version info for the project you're documenting, acts as replacement for
@@ -128,7 +128,7 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = "pyfakefs_theme"
+html_theme = "furo"
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
@@ -204,7 +204,7 @@
 
 # If true, links to the reST sources are added to the pages.
 #
-# html_show_sourcelink = True
+html_show_sourcelink = False
 
 # If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
 #