Update docs.

Author: domdfcoding

doc-source/_static/style.css

@@ -13,3 +13,7 @@ div.versionchanged ul, div.versionremoved ul {
 	margin-left: 20px;
 	margin-top: 0;
 }
+
+.longtable.autosummary {
+	width: 100%;
+}

doc-source/autosummary_widths.py

@@ -78,4 +78,10 @@ def setup(app):
 
 
 nitpicky = True
-autosummary_widths_builders = ["latex"]
+needspace_amount = r"5\baselineskip"
+favicons = [{
+		"rel": "icon",
+		"href": "https://python-formate.github.io/assets/formate.ico",
+		"sizes": "48x48",
+		"type": "image/vnd.microsoft.icon"
+		}]

doc-source/conf.py

@@ -9,12 +9,13 @@ seed-intersphinx-mapping>=0.3.1
 sphinx>=3.0.3
 sphinx-copybutton>=0.2.12
 sphinx-debuginfo>=0.1.0
+sphinx-favicon>=0.2
 sphinx-licenseinfo>=0.1.1
 sphinx-notfound-page>=0.7.1
 sphinx-prompt>=1.1.0
 sphinx-pyproject>=0.1.0
 sphinx-tabs>=1.1.13
-sphinx-toolbox>=2.13.0
+sphinx-toolbox>=3.0.0a4
 sphinxcontrib-httpdomain>=1.7.0
 sphinxemoji>=0.1.6
 tabulate>=0.8.7

doc-source/requirements.txt

@@ -55,6 +55,7 @@ extensions = [
     "sphinx_toolbox.more_autosummary",
     "sphinx_toolbox.documentation_summary",
     "sphinx_toolbox.tweaks.param_dash",
+    "sphinxcontrib.toctree_plus",
     "sphinx_toolbox.tweaks.latex_layout",
     "sphinx_toolbox.tweaks.latex_toc",
     "sphinx.ext.intersphinx",
@@ -65,15 +66,14 @@ extensions = [
     "notfound.extension",
     "sphinx_copybutton",
     "sphinxcontrib.default_values",
-    "sphinxcontrib.toctree_plus",
     "sphinx_debuginfo",
     "sphinx_licenseinfo",
     "seed_intersphinx_mapping",
     "html_section",
     "sphinx_toolbox.pre_commit",
     "sphinx_toolbox.flake8",
-    "sphinx_toolbox_experimental.autosummary_widths",
-    "sphinx_toolbox_experimental.needspace",
+    "sphinx_toolbox.more_autosummary.column_widths",
+    "sphinx-favicon",
 ]
 sphinxemoji_style = "twemoji"
 gitstamp_fmt = "%d %b %Y"

pyproject.toml

@@ -15,7 +15,6 @@ short_desc: "A flake8 plugin which checks for use of platform specific strftime
 use_whey: true
 min_coverage: 100
 sphinx_html_theme: furo
-preserve_custom_theme: true
 docs_fail_on_warning: true
 
 conda_channels:
@@ -42,16 +41,17 @@ classifiers:
 extra_sphinx_extensions:
  - sphinx_toolbox.pre_commit
  - sphinx_toolbox.flake8
- - sphinx_toolbox_experimental.autosummary_widths
- - sphinx_toolbox_experimental.needspace
+ - sphinx_toolbox.more_autosummary.column_widths
+ - sphinx-favicon
 
 entry_points:
   flake8.extension:
    - STRFTIME=flake8_strftime:Plugin
 
 sphinx_conf_epilogue:
  - nitpicky = True
- - autosummary_widths_builders = ["latex"]
+ - needspace_amount = r"5\baselineskip"
+ - 'favicons = [{"rel": "icon", "href": "https://python-formate.github.io/assets/formate.ico",  "sizes": "48x48", "type": "image/vnd.microsoft.icon"}]'
 
 tox_unmanaged:
  - testenv:lint