Update docs.

Author: domdfcoding

coverage_pyver_pragma/grammar.py

@@ -249,6 +249,8 @@ class PlatformTag(str):
 		Darwin  # macOS
 		Java
 
+	.. latex:clearpage::
+
 	If the current platform cannot be determined all strings are treated as :py:obj:`True`.
 
 	:param tokens:

doc-source/_static/style.css

@@ -8,3 +8,12 @@ div.highlight {
 .field-list dt, dl.simple dt {
 	margin-top: 0.5rem;
 }
+
+div.versionchanged ul, div.versionremoved ul {
+	margin-left: 20px;
+	margin-top: 0;
+}
+
+.longtable.autosummary {
+	width: 100%;
+}

doc-source/_templates/base.html

@@ -2,5 +2,4 @@
 {% extends "!base.html" %}
 {% block extrahead %}
 	<link href="{{ pathto("_static/style.css", True) }}" rel="stylesheet" type="text/css">
-	<link rel=icon href=https://python-coincidence.github.io/assets/coincidence.ico sizes="48x48" type="image/vnd.microsoft.icon">
 {% endblock %}

doc-source/api.rst

@@ -3,6 +3,5 @@ Public API
 =============
 
 .. autosummary-widths:: 6/16
-	:html: 35/100
 
 .. automodule:: coverage_pyver_pragma

doc-source/conf.py

@@ -79,3 +79,10 @@ def setup(app):
 
 
 toctree_plus_types.add("envvar")
+needspace_amount = r"5\baselineskip"
+favicons = [{
+		"rel": "icon",
+		"href": "https://python-coincidence.github.io/assets/coincidence.ico",
+		"sizes": "48x48",
+		"type": "image/vnd.microsoft.icon"
+		}]

doc-source/configuration.rst

@@ -49,6 +49,8 @@ For instance, you are generating a report from a ``.coverage`` file produced on
 
 		COV_PYTHON_IMPLEMENTATION=PyPy coverage report
 
+.. latex:clearpage::
+
 If you generate your coverage reports through `tox <https://tox.readthedocs.io/en/latest/>`_
 you should configure `passenv <https://tox.readthedocs.io/en/latest/config.html?highlight=setenv#conf-passenv>`_
 to ensure the environment variables are passed through:

doc-source/requirements.txt

@@ -1,4 +1,3 @@
-git+https://github.com/sphinx-toolbox/sphinx-toolbox-experimental.git
 default-values>=0.5.0
 extras-require>=0.2.0
 furo>=2020.11.19b18
@@ -7,12 +6,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
 toctree-plus>=0.5.0

doc-source/syntax.rst

@@ -3,7 +3,6 @@ Syntax
 =========
 
 .. autosummary-widths:: 6/16
-	:html: 3/10
 
 .. automodule:: coverage_pyver_pragma.grammar
 	:no-autosummary:

pyproject.toml

@@ -54,6 +54,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",
@@ -64,13 +65,12 @@ extensions = [
     "notfound.extension",
     "sphinx_copybutton",
     "sphinxcontrib.default_values",
-    "sphinxcontrib.toctree_plus",
     "sphinx_debuginfo",
     "sphinx_licenseinfo",
     "seed_intersphinx_mapping",
     "html_section",
-    "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"

repo_helper.yml

@@ -14,7 +14,6 @@ use_whey: True
 min_coverage: 95
 sphinx_html_theme: furo
 python_deploy_version: 3.6
-preserve_custom_theme: true
 docs_fail_on_warning: true
 
 conda_channels:
@@ -48,11 +47,13 @@ keywords:
   - coverage
 
 extra_sphinx_extensions:
-  - sphinx_toolbox_experimental.autosummary_widths
-  - sphinx_toolbox_experimental.needspace
+  - sphinx_toolbox.more_autosummary.column_widths
+  - sphinx-favicon
 
 exclude_files:
   - contributing
 
 sphinx_conf_epilogue:
   - toctree_plus_types.add("envvar")
+  - needspace_amount = r"5\baselineskip"
+  - 'favicons = [{"rel": "icon", "href": "https://python-coincidence.github.io/assets/coincidence.ico",  "sizes": "48x48", "type": "image/vnd.microsoft.icon"}]'