From 1cb9fc3e63fdc51ab05b649da4f6c92ed52c02d1 Mon Sep 17 00:00:00 2001
From: Adam Turner <9087854+aa-turner@users.noreply.github.com>
Date: Thu, 18 Jan 2024 00:08:30 +0000
Subject: [PATCH] Split ``test_build_html``

---
 tests/test_builders/conftest.py               |   25 +
 tests/test_builders/test_build_html.py        | 1428 +----------------
 .../test_builders/test_build_html_5_output.py |  290 ++++
 tests/test_builders/test_build_html_assets.py |  154 ++
 tests/test_builders/test_build_html_code.py   |   50 +
 .../test_builders/test_build_html_download.py |   62 +
 .../test_build_html_highlight.py              |   61 +
 tests/test_builders/test_build_html_image.py  |   80 +
 tests/test_builders/test_build_html_maths.py  |   58 +
 tests/test_builders/test_build_html_numfig.py |  511 ++++++
 .../test_builders/test_build_html_tocdepth.py |   99 ++
 .../test_directives/test_directive_option.py  |   40 +
 tests/test_domains/test_domain_std.py         |   21 +
 tests/test_theming/test_html_theme.py         |   30 +
 14 files changed, 1482 insertions(+), 1427 deletions(-)
 create mode 100644 tests/test_builders/conftest.py
 create mode 100644 tests/test_builders/test_build_html_5_output.py
 create mode 100644 tests/test_builders/test_build_html_assets.py
 create mode 100644 tests/test_builders/test_build_html_code.py
 create mode 100644 tests/test_builders/test_build_html_download.py
 create mode 100644 tests/test_builders/test_build_html_highlight.py
 create mode 100644 tests/test_builders/test_build_html_image.py
 create mode 100644 tests/test_builders/test_build_html_maths.py
 create mode 100644 tests/test_builders/test_build_html_numfig.py
 create mode 100644 tests/test_builders/test_build_html_tocdepth.py
 create mode 100644 tests/test_directives/test_directive_option.py
 create mode 100644 tests/test_theming/test_html_theme.py

diff --git a/tests/test_builders/conftest.py b/tests/test_builders/conftest.py
new file mode 100644
index 000000000..53c7b6f75
--- /dev/null
+++ b/tests/test_builders/conftest.py
@@ -0,0 +1,25 @@
+from __future__ import annotations
+
+import pytest
+from html5lib import HTMLParser
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from pathlib import Path
+
+etree_cache = {}
+
+
+def _parse(fname: Path) -> HTMLParser:
+    if fname in etree_cache:
+        return etree_cache[fname]
+    with fname.open('rb') as fp:
+        etree = HTMLParser(namespaceHTMLElements=False).parse(fp)
+        etree_cache[fname] = etree
+        return etree
+
+
+@pytest.fixture(scope='package')
+def cached_etree_parse():
+    yield _parse
+    etree_cache.clear()
diff --git a/tests/test_builders/test_build_html.py b/tests/test_builders/test_build_html.py
index 57145367d..01be7df4f 100644
--- a/tests/test_builders/test_build_html.py
+++ b/tests/test_builders/test_build_html.py
@@ -1,20 +1,13 @@
 """Test the HTML builder and check output against XPath."""
 
-import hashlib
 import os
 import posixpath
 import re
-from pathlib import Path
-from unittest.mock import ANY, call, patch
 
-import docutils
 import pytest
-from html5lib import HTMLParser
 
-import sphinx.builders.html
 from sphinx.builders.html import validate_html_extra_path, validate_html_static_path
-from sphinx.builders.html._assets import _file_checksum
-from sphinx.errors import ConfigError, ThemeError
+from sphinx.errors import ConfigError
 from sphinx.testing.util import strip_escseq
 from sphinx.util.inventory import InventoryFile
 
@@ -41,39 +34,10 @@ HTML_WARNINGS = ENV_WARNINGS + """\
 """
 
 
-etree_cache = {}
-
-
-@pytest.fixture(scope='module')
-def cached_etree_parse():
-    def parse(fname):
-        if fname in etree_cache:
-            return etree_cache[fname]
-        with (fname).open('rb') as fp:
-            etree = HTMLParser(namespaceHTMLElements=False).parse(fp)
-            etree_cache.clear()
-            etree_cache[fname] = etree
-            return etree
-    yield parse
-    etree_cache.clear()
-
-
 def flat_dict(d: dict[str, list[str]]):
     return ((fname, value) for fname, values in d.items() for value in values)
 
 
-def tail_check(check):
-    rex = re.compile(check)
-
-    def checker(nodes):
-        for node in nodes:
-            if node.tail and rex.search(node.tail):
-                return True
-        msg = f'{check!r} not found in tail of any nodes {nodes}'
-        raise AssertionError(msg)
-    return checker
-
-
 def check_xpath(etree, fname, path, check, be_found=True):
     nodes = list(etree.findall(path))
     if check is None:
@@ -135,277 +99,6 @@ def test_html4_error(make_app, tmp_path):
         )
 
 
-@pytest.mark.parametrize(("fname", "expect"), flat_dict({
-    'images.html': [
-        (".//img[@src='_images/img.png']", ''),
-        (".//img[@src='_images/img1.png']", ''),
-        (".//img[@src='_images/simg.png']", ''),
-        (".//img[@src='_images/svgimg.svg']", ''),
-        (".//a[@href='_sources/images.txt']", ''),
-    ],
-    'subdir/images.html': [
-        (".//img[@src='../_images/img1.png']", ''),
-        (".//img[@src='../_images/rimg.png']", ''),
-    ],
-    'subdir/includes.html': [
-        (".//a[@class='reference download internal']", ''),
-        (".//img[@src='../_images/img.png']", ''),
-        (".//p", 'This is an include file.'),
-        (".//pre/span", 'line 1'),
-        (".//pre/span", 'line 2'),
-    ],
-    'includes.html': [
-        (".//pre", 'Max Strauß'),
-        (".//a[@class='reference download internal']", ''),
-        (".//pre/span", '"quotes"'),
-        (".//pre/span", "'included'"),
-        (".//pre/span[@class='s2']", 'üöä'),
-        (".//div[@class='inc-pyobj1 highlight-text notranslate']//pre",
-         r'^class Foo:\n    pass\n\s*$'),
-        (".//div[@class='inc-pyobj2 highlight-text notranslate']//pre",
-         r'^    def baz\(\):\n        pass\n\s*$'),
-        (".//div[@class='inc-lines highlight-text notranslate']//pre",
-         r'^class Foo:\n    pass\nclass Bar:\n$'),
-        (".//div[@class='inc-startend highlight-text notranslate']//pre",
-         '^foo = "Including Unicode characters: üöä"\\n$'),
-        (".//div[@class='inc-preappend highlight-text notranslate']//pre",
-         r'(?m)^START CODE$'),
-        (".//div[@class='inc-pyobj-dedent highlight-python notranslate']//span",
-         r'def'),
-        (".//div[@class='inc-tab3 highlight-text notranslate']//pre",
-         r'-| |-'),
-        (".//div[@class='inc-tab8 highlight-python notranslate']//pre/span",
-         r'-|      |-'),
-    ],
-    'autodoc.html': [
-        (".//dl[@class='py class']/dt[@id='autodoc_target.Class']", ''),
-        (".//dl[@class='py function']/dt[@id='autodoc_target.function']/em/span/span", r'\*\*'),
-        (".//dl[@class='py function']/dt[@id='autodoc_target.function']/em/span/span", r'kwds'),
-        (".//dd/p", r'Return spam\.'),
-    ],
-    'extapi.html': [
-        (".//strong", 'from class: Bar'),
-    ],
-    'markup.html': [
-        (".//title", 'set by title directive'),
-        (".//p/em", 'Section author: Georg Brandl'),
-        (".//p/em", 'Module author: Georg Brandl'),
-        # created by the meta directive
-        (".//meta[@name='author'][@content='Me']", ''),
-        (".//meta[@name='keywords'][@content='docs, sphinx']", ''),
-        # a label created by ``.. _label:``
-        (".//div[@id='label']", ''),
-        # code with standard code blocks
-        (".//pre", '^some code$'),
-        # an option list
-        (".//span[@class='option']", '--help'),
-        # admonitions
-        (".//p[@class='admonition-title']", 'My Admonition'),
-        (".//div[@class='admonition note']/p", 'Note text.'),
-        (".//div[@class='admonition warning']/p", 'Warning text.'),
-        # inline markup
-        (".//li/p/strong", r'^command\\n$'),
-        (".//li/p/strong", r'^program\\n$'),
-        (".//li/p/em", r'^dfn\\n$'),
-        (".//li/p/kbd", r'^kbd\\n$'),
-        (".//li/p/span", 'File \N{TRIANGULAR BULLET} Close'),
-        (".//li/p/code/span[@class='pre']", '^a/$'),
-        (".//li/p/code/em/span[@class='pre']", '^varpart$'),
-        (".//li/p/code/em/span[@class='pre']", '^i$'),
-        (".//a[@href='https://peps.python.org/pep-0008/']"
-         "[@class='pep reference external']/strong", 'PEP 8'),
-        (".//a[@href='https://peps.python.org/pep-0008/']"
-         "[@class='pep reference external']/strong",
-         'Python Enhancement Proposal #8'),
-        (".//a[@href='https://datatracker.ietf.org/doc/html/rfc1.html']"
-         "[@class='rfc reference external']/strong", 'RFC 1'),
-        (".//a[@href='https://datatracker.ietf.org/doc/html/rfc1.html']"
-         "[@class='rfc reference external']/strong", 'Request for Comments #1'),
-        (".//a[@href='objects.html#envvar-HOME']"
-         "[@class='reference internal']/code/span[@class='pre']", 'HOME'),
-        (".//a[@href='#with']"
-         "[@class='reference internal']/code/span[@class='pre']", '^with$'),
-        (".//a[@href='#grammar-token-try_stmt']"
-         "[@class='reference internal']/code/span", '^statement$'),
-        (".//a[@href='#some-label'][@class='reference internal']/span", '^here$'),
-        (".//a[@href='#some-label'][@class='reference internal']/span", '^there$'),
-        (".//a[@href='subdir/includes.html']"
-         "[@class='reference internal']/span", 'Including in subdir'),
-        (".//a[@href='objects.html#cmdoption-python-c']"
-         "[@class='reference internal']/code/span[@class='pre']", '-c'),
-        # abbreviations
-        (".//abbr[@title='abbreviation']", '^abbr$'),
-        # version stuff
-        (".//div[@class='versionadded']/p/span", 'New in version 0.6: '),
-        (".//div[@class='versionadded']/p/span",
-         tail_check('First paragraph of versionadded')),
-        (".//div[@class='versionchanged']/p/span",
-         tail_check('First paragraph of versionchanged')),
-        (".//div[@class='versionchanged']/p",
-         'Second paragraph of versionchanged'),
-        # footnote reference
-        (".//a[@class='footnote-reference brackets']", r'1'),
-        # created by reference lookup
-        (".//a[@href='index.html#ref1']", ''),
-        # ``seealso`` directive
-        (".//div/p[@class='admonition-title']", 'See also'),
-        # a ``hlist`` directive
-        (".//table[@class='hlist']/tbody/tr/td/ul/li/p", '^This$'),
-        # a ``centered`` directive
-        (".//p[@class='centered']/strong", 'LICENSE'),
-        # a glossary
-        (".//dl/dt[@id='term-boson']", 'boson'),
-        (".//dl/dt[@id='term-boson']/a", '¶'),
-        # a production list
-        (".//pre/strong", 'try_stmt'),
-        (".//pre/a[@href='#grammar-token-try1_stmt']/code/span", 'try1_stmt'),
-        # tests for ``only`` directive
-        (".//p", 'A global substitution!'),
-        (".//p", 'In HTML.'),
-        (".//p", 'In both.'),
-        (".//p", 'Always present'),
-        # tests for ``any`` role
-        (".//a[@href='#with']/span", 'headings'),
-        (".//a[@href='objects.html#func_without_body']/code/span", 'objects'),
-        # tests for numeric labels
-        (".//a[@href='#id1'][@class='reference internal']/span", 'Testing various markup'),
-        # tests for smartypants
-        (".//li/p", 'Smart “quotes” in English ‘text’.'),
-        (".//li/p", 'Smart — long and – short dashes.'),
-        (".//li/p", 'Ellipsis…'),
-        (".//li/p/code/span[@class='pre']", 'foo--"bar"...'),
-        (".//p", 'Этот «абзац» должен использовать „русские“ кавычки.'),
-        (".//p", 'Il dit : « C’est “super” ! »'),
-    ],
-    'objects.html': [
-        (".//dt[@id='mod.Cls.meth1']", ''),
-        (".//dt[@id='errmod.Error']", ''),
-        (".//dt/span[@class='sig-name descname']/span[@class='pre']", r'long\(parameter,'),
-        (".//dt/span[@class='sig-name descname']/span[@class='pre']", r'list\)'),
-        (".//dt/span[@class='sig-name descname']/span[@class='pre']", 'another'),
-        (".//dt/span[@class='sig-name descname']/span[@class='pre']", 'one'),
-        (".//a[@href='#mod.Cls'][@class='reference internal']", ''),
-        (".//dl[@class='std userdesc']", ''),
-        (".//dt[@id='userdesc-myobj']", ''),
-        (".//a[@href='#userdesc-myobj'][@class='reference internal']", ''),
-        # docfields
-        (".//a[@class='reference internal'][@href='#TimeInt']/em", 'TimeInt'),
-        (".//a[@class='reference internal'][@href='#Time']", 'Time'),
-        (".//a[@class='reference internal'][@href='#errmod.Error']/strong", 'Error'),
-        # C references
-        (".//span[@class='pre']", 'CFunction()'),
-        (".//a[@href='#c.Sphinx_DoSomething']", ''),
-        (".//a[@href='#c.SphinxStruct.member']", ''),
-        (".//a[@href='#c.SPHINX_USE_PYTHON']", ''),
-        (".//a[@href='#c.SphinxType']", ''),
-        (".//a[@href='#c.sphinx_global']", ''),
-        # test global TOC created by toctree()
-        (".//ul[@class='current']/li[@class='toctree-l1 current']/a[@href='#']",
-         'Testing object descriptions'),
-        (".//li[@class='toctree-l1']/a[@href='markup.html']",
-         'Testing various markup'),
-        # test unknown field names
-        (".//dt[@class='field-odd']", 'Field_name'),
-        (".//dt[@class='field-even']", 'Field_name all lower'),
-        (".//dt[@class='field-odd']", 'FIELD_NAME'),
-        (".//dt[@class='field-even']", 'FIELD_NAME ALL CAPS'),
-        (".//dt[@class='field-odd']", 'Field_Name'),
-        (".//dt[@class='field-even']", 'Field_Name All Word Caps'),
-        (".//dt[@class='field-odd']", 'Field_name'),
-        (".//dt[@class='field-even']", 'Field_name First word cap'),
-        (".//dt[@class='field-odd']", 'FIELd_name'),
-        (".//dt[@class='field-even']", 'FIELd_name PARTial caps'),
-        # custom sidebar
-        (".//h4", 'Custom sidebar'),
-        # docfields
-        (".//dd[@class='field-odd']/p/strong", '^moo$'),
-        (".//dd[@class='field-odd']/p/strong", tail_check(r'\(Moo\) .* Moo')),
-        (".//dd[@class='field-odd']/ul/li/p/strong", '^hour$'),
-        (".//dd[@class='field-odd']/ul/li/p/em", '^DuplicateType$'),
-        (".//dd[@class='field-odd']/ul/li/p/em", tail_check(r'.* Some parameter')),
-        # others
-        (".//a[@class='reference internal'][@href='#cmdoption-perl-arg-p']/code/span",
-         'perl'),
-        (".//a[@class='reference internal'][@href='#cmdoption-perl-arg-p']/code/span",
-         '\\+p'),
-        (".//a[@class='reference internal'][@href='#cmdoption-perl-ObjC']/code/span",
-         '--ObjC\\+\\+'),
-        (".//a[@class='reference internal'][@href='#cmdoption-perl-plugin.option']/code/span",
-         '--plugin.option'),
-        (".//a[@class='reference internal'][@href='#cmdoption-perl-arg-create-auth-token']"
-         "/code/span",
-         'create-auth-token'),
-        (".//a[@class='reference internal'][@href='#cmdoption-perl-arg-arg']/code/span",
-         'arg'),
-        (".//a[@class='reference internal'][@href='#cmdoption-perl-j']/code/span",
-         '-j'),
-        (".//a[@class='reference internal'][@href='#cmdoption-hg-arg-commit']/code/span",
-         'hg'),
-        (".//a[@class='reference internal'][@href='#cmdoption-hg-arg-commit']/code/span",
-         'commit'),
-        (".//a[@class='reference internal'][@href='#cmdoption-git-commit-p']/code/span",
-         'git'),
-        (".//a[@class='reference internal'][@href='#cmdoption-git-commit-p']/code/span",
-         'commit'),
-        (".//a[@class='reference internal'][@href='#cmdoption-git-commit-p']/code/span",
-         '-p'),
-    ],
-    'index.html': [
-        (".//meta[@name='hc'][@content='hcval']", ''),
-        (".//meta[@name='hc_co'][@content='hcval_co']", ''),
-        (".//li[@class='toctree-l1']/a", 'Testing various markup'),
-        (".//li[@class='toctree-l2']/a", 'Inline markup'),
-        (".//title", 'Sphinx <Tests>'),
-        (".//div[@class='footer']", 'copyright text credits'),
-        (".//a[@href='https://python.org/']"
-         "[@class='reference external']", ''),
-        (".//li/p/a[@href='genindex.html']/span", 'Index'),
-        (".//li/p/a[@href='py-modindex.html']/span", 'Module Index'),
-        # custom sidebar only for contents
-        (".//h4", 'Contents sidebar'),
-        # custom JavaScript
-        (".//script[@src='file://moo.js']", ''),
-        # URL in contents
-        (".//a[@class='reference external'][@href='https://sphinx-doc.org/']",
-         'https://sphinx-doc.org/'),
-        (".//a[@class='reference external'][@href='https://sphinx-doc.org/latest/']",
-         'Latest reference'),
-        # Indirect hyperlink targets across files
-        (".//a[@href='markup.html#some-label'][@class='reference internal']/span",
-         '^indirect hyperref$'),
-    ],
-    'bom.html': [
-        (".//title", " File with UTF-8 BOM"),
-    ],
-    'extensions.html': [
-        (".//a[@href='https://python.org/dev/']", "https://python.org/dev/"),
-        (".//a[@href='https://bugs.python.org/issue1000']", "issue 1000"),
-        (".//a[@href='https://bugs.python.org/issue1042']", "explicit caption"),
-    ],
-    'genindex.html': [
-        # index entries
-        (".//a/strong", "Main"),
-        (".//a/strong", "[1]"),
-        (".//a/strong", "Other"),
-        (".//a", "entry"),
-        (".//li/a", "double"),
-    ],
-    'otherext.html': [
-        (".//h1", "Generated section"),
-        (".//a[@href='_sources/otherext.foo.txt']", ''),
-    ],
-    'search.html': [
-        (".//meta[@name='robots'][@content='noindex']", ''),
-    ],
-}))
-@pytest.mark.sphinx('html', tags=['testtag'],
-                    confoverrides={'html_context.hckey_co': 'hcval_co'})
-@pytest.mark.test_params(shared_result='test_build_html_output')
-def test_html5_output(app, cached_etree_parse, fname, expect):
-    app.build()
-    check_xpath(cached_etree_parse(app.outdir / fname), fname, *expect)
-
-
 @pytest.mark.parametrize(("fname", "expect"), flat_dict({
     'index.html': [
         (".//div[@class='citation']/span", r'Ref1'),
@@ -441,667 +134,12 @@ def test_html_parallel(app):
     app.build()
 
 
-@pytest.mark.sphinx('html')
-@pytest.mark.test_params(shared_result='test_build_html_output')
-def test_html_download(app):
-    app.build()
-
-    # subdir/includes.html
-    result = (app.outdir / 'subdir' / 'includes.html').read_text(encoding='utf8')
-    pattern = ('<a class="reference download internal" download="" '
-               'href="../(_downloads/.*/img.png)">')
-    matched = re.search(pattern, result)
-    assert matched
-    assert (app.outdir / matched.group(1)).exists()
-    filename = matched.group(1)
-
-    # includes.html
-    result = (app.outdir / 'includes.html').read_text(encoding='utf8')
-    pattern = ('<a class="reference download internal" download="" '
-               'href="(_downloads/.*/img.png)">')
-    matched = re.search(pattern, result)
-    assert matched
-    assert (app.outdir / matched.group(1)).exists()
-    assert matched.group(1) == filename
-
-    pattern = ('<a class="reference download internal" download="" '
-               'href="(_downloads/.*/)(file_with_special_%23_chars.xyz)">')
-    matched = re.search(pattern, result)
-    assert matched
-    assert (app.outdir / matched.group(1) / "file_with_special_#_chars.xyz").exists()
-
-
-@pytest.mark.sphinx('html', testroot='roles-download')
-def test_html_download_role(app, status, warning):
-    app.build()
-    digest = hashlib.md5(b'dummy.dat', usedforsecurity=False).hexdigest()
-    assert (app.outdir / '_downloads' / digest / 'dummy.dat').exists()
-    digest_another = hashlib.md5(b'another/dummy.dat', usedforsecurity=False).hexdigest()
-    assert (app.outdir / '_downloads' / digest_another / 'dummy.dat').exists()
-
-    content = (app.outdir / 'index.html').read_text(encoding='utf8')
-    assert (('<li><p><a class="reference download internal" download="" '
-             'href="_downloads/%s/dummy.dat">'
-             '<code class="xref download docutils literal notranslate">'
-             '<span class="pre">dummy.dat</span></code></a></p></li>' % digest)
-            in content)
-    assert (('<li><p><a class="reference download internal" download="" '
-             'href="_downloads/%s/dummy.dat">'
-             '<code class="xref download docutils literal notranslate">'
-             '<span class="pre">another/dummy.dat</span></code></a></p></li>' %
-             digest_another) in content)
-    assert ('<li><p><code class="xref download docutils literal notranslate">'
-            '<span class="pre">not_found.dat</span></code></p></li>' in content)
-    assert ('<li><p><a class="reference download external" download="" '
-            'href="https://www.sphinx-doc.org/en/master/_static/sphinx-logo.svg">'
-            '<code class="xref download docutils literal notranslate">'
-            '<span class="pre">Sphinx</span> <span class="pre">logo</span>'
-            '</code></a></p></li>' in content)
-
-
 @pytest.mark.sphinx('html', testroot='build-html-translator')
 def test_html_translator(app):
     app.build()
     assert app.builder.docwriter.visitor.depart_with_node == 10
 
 
-@pytest.mark.parametrize(("fname", "expect"), flat_dict({
-    'index.html': [
-        (".//li[@class='toctree-l3']/a", '1.1.1. Foo A1', True),
-        (".//li[@class='toctree-l3']/a", '1.2.1. Foo B1', True),
-        (".//li[@class='toctree-l3']/a", '2.1.1. Bar A1', False),
-        (".//li[@class='toctree-l3']/a", '2.2.1. Bar B1', False),
-    ],
-    'foo.html': [
-        (".//h1", 'Foo', True),
-        (".//h2", 'Foo A', True),
-        (".//h3", 'Foo A1', True),
-        (".//h2", 'Foo B', True),
-        (".//h3", 'Foo B1', True),
-
-        (".//h1//span[@class='section-number']", '1. ', True),
-        (".//h2//span[@class='section-number']", '1.1. ', True),
-        (".//h3//span[@class='section-number']", '1.1.1. ', True),
-        (".//h2//span[@class='section-number']", '1.2. ', True),
-        (".//h3//span[@class='section-number']", '1.2.1. ', True),
-
-        (".//div[@class='sphinxsidebarwrapper']//li/a", '1.1. Foo A', True),
-        (".//div[@class='sphinxsidebarwrapper']//li/a", '1.1.1. Foo A1', True),
-        (".//div[@class='sphinxsidebarwrapper']//li/a", '1.2. Foo B', True),
-        (".//div[@class='sphinxsidebarwrapper']//li/a", '1.2.1. Foo B1', True),
-    ],
-    'bar.html': [
-        (".//h1", 'Bar', True),
-        (".//h2", 'Bar A', True),
-        (".//h2", 'Bar B', True),
-        (".//h3", 'Bar B1', True),
-        (".//h1//span[@class='section-number']", '2. ', True),
-        (".//h2//span[@class='section-number']", '2.1. ', True),
-        (".//h2//span[@class='section-number']", '2.2. ', True),
-        (".//h3//span[@class='section-number']", '2.2.1. ', True),
-        (".//div[@class='sphinxsidebarwrapper']//li/a", '2. Bar', True),
-        (".//div[@class='sphinxsidebarwrapper']//li/a", '2.1. Bar A', True),
-        (".//div[@class='sphinxsidebarwrapper']//li/a", '2.2. Bar B', True),
-        (".//div[@class='sphinxsidebarwrapper']//li/a", '2.2.1. Bar B1', False),
-    ],
-    'baz.html': [
-        (".//h1", 'Baz A', True),
-        (".//h1//span[@class='section-number']", '2.1.1. ', True),
-    ],
-}))
-@pytest.mark.sphinx('html', testroot='tocdepth')
-@pytest.mark.test_params(shared_result='test_build_html_tocdepth')
-def test_tocdepth(app, cached_etree_parse, fname, expect):
-    app.build()
-    # issue #1251
-    check_xpath(cached_etree_parse(app.outdir / fname), fname, *expect)
-
-
-@pytest.mark.parametrize("expect", [
-    (".//li[@class='toctree-l3']/a", '1.1.1. Foo A1', True),
-    (".//li[@class='toctree-l3']/a", '1.2.1. Foo B1', True),
-    (".//li[@class='toctree-l3']/a", '2.1.1. Bar A1', False),
-    (".//li[@class='toctree-l3']/a", '2.2.1. Bar B1', False),
-
-    # index.rst
-    (".//h1", 'test-tocdepth', True),
-
-    # foo.rst
-    (".//h2", 'Foo', True),
-    (".//h3", 'Foo A', True),
-    (".//h4", 'Foo A1', True),
-    (".//h3", 'Foo B', True),
-    (".//h4", 'Foo B1', True),
-    (".//h2//span[@class='section-number']", '1. ', True),
-    (".//h3//span[@class='section-number']", '1.1. ', True),
-    (".//h4//span[@class='section-number']", '1.1.1. ', True),
-    (".//h3//span[@class='section-number']", '1.2. ', True),
-    (".//h4//span[@class='section-number']", '1.2.1. ', True),
-
-    # bar.rst
-    (".//h2", 'Bar', True),
-    (".//h3", 'Bar A', True),
-    (".//h3", 'Bar B', True),
-    (".//h4", 'Bar B1', True),
-    (".//h2//span[@class='section-number']", '2. ', True),
-    (".//h3//span[@class='section-number']", '2.1. ', True),
-    (".//h3//span[@class='section-number']", '2.2. ', True),
-    (".//h4//span[@class='section-number']", '2.2.1. ', True),
-
-    # baz.rst
-    (".//h4", 'Baz A', True),
-    (".//h4//span[@class='section-number']", '2.1.1. ', True),
-])
-@pytest.mark.sphinx('singlehtml', testroot='tocdepth')
-@pytest.mark.test_params(shared_result='test_build_html_tocdepth')
-def test_tocdepth_singlehtml(app, cached_etree_parse, expect):
-    app.build()
-    check_xpath(cached_etree_parse(app.outdir / 'index.html'), 'index.html', *expect)
-
-
-@pytest.mark.sphinx('html', testroot='numfig')
-@pytest.mark.test_params(shared_result='test_build_html_numfig')
-def test_numfig_disabled_warn(app, warning):
-    app.build()
-    warnings = warning.getvalue()
-    assert 'index.rst:47: WARNING: numfig is disabled. :numref: is ignored.' in warnings
-    assert 'index.rst:56: WARNING: invalid numfig_format: invalid' not in warnings
-    assert 'index.rst:57: WARNING: invalid numfig_format: Fig %s %s' not in warnings
-
-
-@pytest.mark.parametrize(("fname", "expect"), flat_dict({
-    'index.html': [
-        (FIGURE_CAPTION + "/span[@class='caption-number']", None, True),
-        (".//table/caption/span[@class='caption-number']", None, True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", None, True),
-        (".//li/p/code/span", '^fig1$', True),
-        (".//li/p/code/span", '^Figure%s$', True),
-        (".//li/p/code/span", '^table-1$', True),
-        (".//li/p/code/span", '^Table:%s$', True),
-        (".//li/p/code/span", '^CODE_1$', True),
-        (".//li/p/code/span", '^Code-%s$', True),
-        (".//li/p/a/span", '^Section 1$', True),
-        (".//li/p/a/span", '^Section 2.1$', True),
-        (".//li/p/code/span", '^Fig.{number}$', True),
-        (".//li/p/a/span", '^Sect.1 Foo$', True),
-    ],
-    'foo.html': [
-        (FIGURE_CAPTION + "/span[@class='caption-number']", None, True),
-        (".//table/caption/span[@class='caption-number']", None, True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", None, True),
-    ],
-    'bar.html': [
-        (FIGURE_CAPTION + "/span[@class='caption-number']", None, True),
-        (".//table/caption/span[@class='caption-number']", None, True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", None, True),
-    ],
-    'baz.html': [
-        (FIGURE_CAPTION + "/span[@class='caption-number']", None, True),
-        (".//table/caption/span[@class='caption-number']", None, True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", None, True),
-    ],
-}))
-@pytest.mark.sphinx('html', testroot='numfig')
-@pytest.mark.test_params(shared_result='test_build_html_numfig')
-def test_numfig_disabled(app, cached_etree_parse, fname, expect):
-    app.build()
-    check_xpath(cached_etree_parse(app.outdir / fname), fname, *expect)
-
-
-@pytest.mark.sphinx(
-    'html', testroot='numfig',
-    srcdir='test_numfig_without_numbered_toctree_warn',
-    confoverrides={'numfig': True})
-def test_numfig_without_numbered_toctree_warn(app, warning):
-    app.build()
-    # remove :numbered: option
-    index = (app.srcdir / 'index.rst').read_text(encoding='utf8')
-    index = re.sub(':numbered:.*', '', index)
-    (app.srcdir / 'index.rst').write_text(index, encoding='utf8')
-    app.build()
-
-    warnings = warning.getvalue()
-    assert 'index.rst:47: WARNING: numfig is disabled. :numref: is ignored.' not in warnings
-    assert 'index.rst:55: WARNING: Failed to create a cross reference. Any number is not assigned: index' in warnings
-    assert 'index.rst:56: WARNING: invalid numfig_format: invalid' in warnings
-    assert 'index.rst:57: WARNING: invalid numfig_format: Fig %s %s' in warnings
-
-
-@pytest.mark.parametrize(("fname", "expect"), flat_dict({
-    'index.html': [
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 9 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 10 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 9 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 10 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 9 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 10 $', True),
-        (".//li/p/a/span", '^Fig. 9$', True),
-        (".//li/p/a/span", '^Figure6$', True),
-        (".//li/p/a/span", '^Table 9$', True),
-        (".//li/p/a/span", '^Table:6$', True),
-        (".//li/p/a/span", '^Listing 9$', True),
-        (".//li/p/a/span", '^Code-6$', True),
-        (".//li/p/code/span", '^foo$', True),
-        (".//li/p/code/span", '^bar_a$', True),
-        (".//li/p/a/span", '^Fig.9 should be Fig.1$', True),
-        (".//li/p/code/span", '^Sect.{number}$', True),
-    ],
-    'foo.html': [
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 3 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 4 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 1 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 2 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 3 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 4 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 1 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 2 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 3 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 4 $', True),
-    ],
-    'bar.html': [
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 5 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 7 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 8 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 5 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 7 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 8 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 5 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 7 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 8 $', True),
-    ],
-    'baz.html': [
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 6 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 6 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 6 $', True),
-    ],
-}))
-@pytest.mark.sphinx(
-    'html', testroot='numfig',
-    srcdir='test_numfig_without_numbered_toctree',
-    confoverrides={'numfig': True})
-def test_numfig_without_numbered_toctree(app, cached_etree_parse, fname, expect):
-    # remove :numbered: option
-    index = (app.srcdir / 'index.rst').read_text(encoding='utf8')
-    index = re.sub(':numbered:.*', '', index)
-    (app.srcdir / 'index.rst').write_text(index, encoding='utf8')
-
-    if not os.listdir(app.outdir):
-        app.build()
-    check_xpath(cached_etree_parse(app.outdir / fname), fname, *expect)
-
-
-@pytest.mark.sphinx('html', testroot='numfig', confoverrides={'numfig': True})
-@pytest.mark.test_params(shared_result='test_build_html_numfig_on')
-def test_numfig_with_numbered_toctree_warn(app, warning):
-    app.build()
-    warnings = warning.getvalue()
-    assert 'index.rst:47: WARNING: numfig is disabled. :numref: is ignored.' not in warnings
-    assert 'index.rst:55: WARNING: Failed to create a cross reference. Any number is not assigned: index' in warnings
-    assert 'index.rst:56: WARNING: invalid numfig_format: invalid' in warnings
-    assert 'index.rst:57: WARNING: invalid numfig_format: Fig %s %s' in warnings
-
-
-@pytest.mark.parametrize(("fname", "expect"), flat_dict({
-    'index.html': [
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 1 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 2 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 1 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 2 $', True),
-        (".//li/p/a/span", '^Fig. 1$', True),
-        (".//li/p/a/span", '^Figure2.2$', True),
-        (".//li/p/a/span", '^Table 1$', True),
-        (".//li/p/a/span", '^Table:2.2$', True),
-        (".//li/p/a/span", '^Listing 1$', True),
-        (".//li/p/a/span", '^Code-2.2$', True),
-        (".//li/p/a/span", '^Section.1$', True),
-        (".//li/p/a/span", '^Section.2.1$', True),
-        (".//li/p/a/span", '^Fig.1 should be Fig.1$', True),
-        (".//li/p/a/span", '^Sect.1 Foo$', True),
-    ],
-    'foo.html': [
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.1 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.2 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.3 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.4 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 1.1 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 1.2 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 1.3 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 1.4 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 1.1 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 1.2 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 1.3 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 1.4 $', True),
-    ],
-    'bar.html': [
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.1 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.3 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.4 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 2.1 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 2.3 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 2.4 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 2.1 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 2.3 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 2.4 $', True),
-    ],
-    'baz.html': [
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.2 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 2.2 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 2.2 $', True),
-    ],
-}))
-@pytest.mark.sphinx('html', testroot='numfig', confoverrides={'numfig': True})
-@pytest.mark.test_params(shared_result='test_build_html_numfig_on')
-def test_numfig_with_numbered_toctree(app, cached_etree_parse, fname, expect):
-    app.build()
-    check_xpath(cached_etree_parse(app.outdir / fname), fname, *expect)
-
-
-@pytest.mark.sphinx('html', testroot='numfig', confoverrides={
-    'numfig': True,
-    'numfig_format': {'figure': 'Figure:%s',
-                      'table': 'Tab_%s',
-                      'code-block': 'Code-%s',
-                      'section': 'SECTION-%s'}})
-@pytest.mark.test_params(shared_result='test_build_html_numfig_format_warn')
-def test_numfig_with_prefix_warn(app, warning):
-    app.build()
-    warnings = warning.getvalue()
-    assert 'index.rst:47: WARNING: numfig is disabled. :numref: is ignored.' not in warnings
-    assert 'index.rst:55: WARNING: Failed to create a cross reference. Any number is not assigned: index' in warnings
-    assert 'index.rst:56: WARNING: invalid numfig_format: invalid' in warnings
-    assert 'index.rst:57: WARNING: invalid numfig_format: Fig %s %s' in warnings
-
-
-@pytest.mark.parametrize(("fname", "expect"), flat_dict({
-    'index.html': [
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Figure:1 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Figure:2 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Tab_1 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Tab_2 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Code-1 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Code-2 $', True),
-        (".//li/p/a/span", '^Figure:1$', True),
-        (".//li/p/a/span", '^Figure2.2$', True),
-        (".//li/p/a/span", '^Tab_1$', True),
-        (".//li/p/a/span", '^Table:2.2$', True),
-        (".//li/p/a/span", '^Code-1$', True),
-        (".//li/p/a/span", '^Code-2.2$', True),
-        (".//li/p/a/span", '^SECTION-1$', True),
-        (".//li/p/a/span", '^SECTION-2.1$', True),
-        (".//li/p/a/span", '^Fig.1 should be Fig.1$', True),
-        (".//li/p/a/span", '^Sect.1 Foo$', True),
-    ],
-    'foo.html': [
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Figure:1.1 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Figure:1.2 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Figure:1.3 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Figure:1.4 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Tab_1.1 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Tab_1.2 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Tab_1.3 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Tab_1.4 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Code-1.1 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Code-1.2 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Code-1.3 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Code-1.4 $', True),
-    ],
-    'bar.html': [
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Figure:2.1 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Figure:2.3 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Figure:2.4 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Tab_2.1 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Tab_2.3 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Tab_2.4 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Code-2.1 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Code-2.3 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Code-2.4 $', True),
-    ],
-    'baz.html': [
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Figure:2.2 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Tab_2.2 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Code-2.2 $', True),
-    ],
-}))
-@pytest.mark.sphinx('html', testroot='numfig',
-                    confoverrides={'numfig': True,
-                                   'numfig_format': {'figure': 'Figure:%s',
-                                                     'table': 'Tab_%s',
-                                                     'code-block': 'Code-%s',
-                                                     'section': 'SECTION-%s'}})
-@pytest.mark.test_params(shared_result='test_build_html_numfig_format_warn')
-def test_numfig_with_prefix(app, cached_etree_parse, fname, expect):
-    app.build()
-    check_xpath(cached_etree_parse(app.outdir / fname), fname, *expect)
-
-
-@pytest.mark.sphinx('html', testroot='numfig',
-                    confoverrides={'numfig': True, 'numfig_secnum_depth': 2})
-@pytest.mark.test_params(shared_result='test_build_html_numfig_depth_2')
-def test_numfig_with_secnum_depth_warn(app, warning):
-    app.build()
-    warnings = warning.getvalue()
-    assert 'index.rst:47: WARNING: numfig is disabled. :numref: is ignored.' not in warnings
-    assert 'index.rst:55: WARNING: Failed to create a cross reference. Any number is not assigned: index' in warnings
-    assert 'index.rst:56: WARNING: invalid numfig_format: invalid' in warnings
-    assert 'index.rst:57: WARNING: invalid numfig_format: Fig %s %s' in warnings
-
-
-@pytest.mark.parametrize(("fname", "expect"), flat_dict({
-    'index.html': [
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 1 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 2 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 1 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 2 $', True),
-        (".//li/p/a/span", '^Fig. 1$', True),
-        (".//li/p/a/span", '^Figure2.1.2$', True),
-        (".//li/p/a/span", '^Table 1$', True),
-        (".//li/p/a/span", '^Table:2.1.2$', True),
-        (".//li/p/a/span", '^Listing 1$', True),
-        (".//li/p/a/span", '^Code-2.1.2$', True),
-        (".//li/p/a/span", '^Section.1$', True),
-        (".//li/p/a/span", '^Section.2.1$', True),
-        (".//li/p/a/span", '^Fig.1 should be Fig.1$', True),
-        (".//li/p/a/span", '^Sect.1 Foo$', True),
-    ],
-    'foo.html': [
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.1 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.1.1 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.1.2 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.2.1 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 1.1 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 1.1.1 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 1.1.2 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 1.2.1 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 1.1 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 1.1.1 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 1.1.2 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 1.2.1 $', True),
-    ],
-    'bar.html': [
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.1.1 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.1.3 $', True),
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.2.1 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 2.1.1 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 2.1.3 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 2.2.1 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 2.1.1 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 2.1.3 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 2.2.1 $', True),
-    ],
-    'baz.html': [
-        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.1.2 $', True),
-        (".//table/caption/span[@class='caption-number']",
-         '^Table 2.1.2 $', True),
-        (".//div[@class='code-block-caption']/"
-         "span[@class='caption-number']", '^Listing 2.1.2 $', True),
-    ],
-}))
-@pytest.mark.sphinx('html', testroot='numfig',
-                    confoverrides={'numfig': True,
-                                   'numfig_secnum_depth': 2})
-@pytest.mark.test_params(shared_result='test_build_html_numfig_depth_2')
-def test_numfig_with_secnum_depth(app, cached_etree_parse, fname, expect):
-    app.build()
-    check_xpath(cached_etree_parse(app.outdir / fname), fname, *expect)
-
-
-@pytest.mark.parametrize("expect", [
-    (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1 $', True),
-    (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2 $', True),
-    (".//table/caption/span[@class='caption-number']",
-     '^Table 1 $', True),
-    (".//table/caption/span[@class='caption-number']",
-     '^Table 2 $', True),
-    (".//div[@class='code-block-caption']/"
-     "span[@class='caption-number']", '^Listing 1 $', True),
-    (".//div[@class='code-block-caption']/"
-     "span[@class='caption-number']", '^Listing 2 $', True),
-    (".//li/p/a/span", '^Fig. 1$', True),
-    (".//li/p/a/span", '^Figure2.2$', True),
-    (".//li/p/a/span", '^Table 1$', True),
-    (".//li/p/a/span", '^Table:2.2$', True),
-    (".//li/p/a/span", '^Listing 1$', True),
-    (".//li/p/a/span", '^Code-2.2$', True),
-    (".//li/p/a/span", '^Section.1$', True),
-    (".//li/p/a/span", '^Section.2.1$', True),
-    (".//li/p/a/span", '^Fig.1 should be Fig.1$', True),
-    (".//li/p/a/span", '^Sect.1 Foo$', True),
-    (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.1 $', True),
-    (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.2 $', True),
-    (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.3 $', True),
-    (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.4 $', True),
-    (".//table/caption/span[@class='caption-number']",
-     '^Table 1.1 $', True),
-    (".//table/caption/span[@class='caption-number']",
-     '^Table 1.2 $', True),
-    (".//table/caption/span[@class='caption-number']",
-     '^Table 1.3 $', True),
-    (".//table/caption/span[@class='caption-number']",
-     '^Table 1.4 $', True),
-    (".//div[@class='code-block-caption']/"
-     "span[@class='caption-number']", '^Listing 1.1 $', True),
-    (".//div[@class='code-block-caption']/"
-     "span[@class='caption-number']", '^Listing 1.2 $', True),
-    (".//div[@class='code-block-caption']/"
-     "span[@class='caption-number']", '^Listing 1.3 $', True),
-    (".//div[@class='code-block-caption']/"
-     "span[@class='caption-number']", '^Listing 1.4 $', True),
-    (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.1 $', True),
-    (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.3 $', True),
-    (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.4 $', True),
-    (".//table/caption/span[@class='caption-number']",
-     '^Table 2.1 $', True),
-    (".//table/caption/span[@class='caption-number']",
-     '^Table 2.3 $', True),
-    (".//table/caption/span[@class='caption-number']",
-     '^Table 2.4 $', True),
-    (".//div[@class='code-block-caption']/"
-     "span[@class='caption-number']", '^Listing 2.1 $', True),
-    (".//div[@class='code-block-caption']/"
-     "span[@class='caption-number']", '^Listing 2.3 $', True),
-    (".//div[@class='code-block-caption']/"
-     "span[@class='caption-number']", '^Listing 2.4 $', True),
-    (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.2 $', True),
-    (".//table/caption/span[@class='caption-number']",
-     '^Table 2.2 $', True),
-    (".//div[@class='code-block-caption']/"
-     "span[@class='caption-number']", '^Listing 2.2 $', True),
-])
-@pytest.mark.sphinx('singlehtml', testroot='numfig', confoverrides={'numfig': True})
-@pytest.mark.test_params(shared_result='test_build_html_numfig_on')
-def test_numfig_with_singlehtml(app, cached_etree_parse, expect):
-    app.build()
-    check_xpath(cached_etree_parse(app.outdir / 'index.html'), 'index.html', *expect)
-
-
 @pytest.mark.parametrize("expect", [
     (FIGURE_CAPTION + "//span[@class='caption-number']", "Fig. 1", True),
     (FIGURE_CAPTION + "//span[@class='caption-number']", "Fig. 2", True),
@@ -1121,148 +159,6 @@ def test_enumerable_node(app, cached_etree_parse, expect):
     check_xpath(cached_etree_parse(app.outdir / 'index.html'), 'index.html', *expect)
 
 
-@pytest.mark.sphinx('html', testroot='html_assets')
-def test_html_assets(app):
-    app.build(force_all=True)
-
-    # exclude_path and its family
-    assert not (app.outdir / 'static' / 'index.html').exists()
-    assert not (app.outdir / 'extra' / 'index.html').exists()
-
-    # html_static_path
-    assert not (app.outdir / '_static' / '.htaccess').exists()
-    assert not (app.outdir / '_static' / '.htpasswd').exists()
-    assert (app.outdir / '_static' / 'API.html').exists()
-    assert (app.outdir / '_static' / 'API.html').read_text(encoding='utf8') == 'Sphinx-1.4.4'
-    assert (app.outdir / '_static' / 'css' / 'style.css').exists()
-    assert (app.outdir / '_static' / 'js' / 'custom.js').exists()
-    assert (app.outdir / '_static' / 'rimg.png').exists()
-    assert not (app.outdir / '_static' / '_build' / 'index.html').exists()
-    assert (app.outdir / '_static' / 'background.png').exists()
-    assert not (app.outdir / '_static' / 'subdir' / '.htaccess').exists()
-    assert not (app.outdir / '_static' / 'subdir' / '.htpasswd').exists()
-
-    # html_extra_path
-    assert (app.outdir / '.htaccess').exists()
-    assert not (app.outdir / '.htpasswd').exists()
-    assert (app.outdir / 'API.html_t').exists()
-    assert (app.outdir / 'css/style.css').exists()
-    assert (app.outdir / 'rimg.png').exists()
-    assert not (app.outdir / '_build' / 'index.html').exists()
-    assert (app.outdir / 'background.png').exists()
-    assert (app.outdir / 'subdir' / '.htaccess').exists()
-    assert not (app.outdir / 'subdir' / '.htpasswd').exists()
-
-    # html_css_files
-    content = (app.outdir / 'index.html').read_text(encoding='utf8')
-    assert '<link rel="stylesheet" type="text/css" href="_static/css/style.css" />' in content
-    assert ('<link media="print" rel="stylesheet" title="title" type="text/css" '
-            'href="https://example.com/custom.css" />' in content)
-
-    # html_js_files
-    assert '<script src="_static/js/custom.js"></script>' in content
-    assert ('<script async="async" src="https://example.com/script.js">'
-            '</script>' in content)
-
-
-@pytest.mark.sphinx('html', testroot='html_assets')
-def test_assets_order(app, monkeypatch):
-    monkeypatch.setattr(sphinx.builders.html, '_file_checksum', lambda o, f: '')
-
-    app.add_css_file('normal.css')
-    app.add_css_file('early.css', priority=100)
-    app.add_css_file('late.css', priority=750)
-    app.add_css_file('lazy.css', priority=900)
-    app.add_js_file('normal.js')
-    app.add_js_file('early.js', priority=100)
-    app.add_js_file('late.js', priority=750)
-    app.add_js_file('lazy.js', priority=900)
-
-    app.build(force_all=True)
-    content = (app.outdir / 'index.html').read_text(encoding='utf8')
-
-    # css_files
-    expected = [
-        '_static/early.css',
-        '_static/pygments.css',
-        '_static/alabaster.css',
-        'https://example.com/custom.css',
-        '_static/normal.css',
-        '_static/late.css',
-        '_static/css/style.css',
-        '_static/lazy.css',
-    ]
-    pattern = '.*'.join(f'href="{re.escape(f)}"' for f in expected)
-    assert re.search(pattern, content, re.DOTALL), content
-
-    # js_files
-    expected = [
-        '_static/early.js',
-        '_static/doctools.js',
-        '_static/sphinx_highlight.js',
-        'https://example.com/script.js',
-        '_static/normal.js',
-        '_static/late.js',
-        '_static/js/custom.js',
-        '_static/lazy.js',
-    ]
-    pattern = '.*'.join(f'src="{re.escape(f)}"' for f in expected)
-    assert re.search(pattern, content, re.DOTALL), content
-
-
-@pytest.mark.sphinx('html', testroot='html_file_checksum')
-def test_file_checksum(app):
-    app.add_css_file('stylesheet-a.css')
-    app.add_css_file('stylesheet-b.css')
-    app.add_css_file('https://example.com/custom.css')
-    app.add_js_file('script.js')
-    app.add_js_file('empty.js')
-    app.add_js_file('https://example.com/script.js')
-
-    app.build(force_all=True)
-    content = (app.outdir / 'index.html').read_text(encoding='utf8')
-
-    # checksum for local files
-    assert '<link rel="stylesheet" type="text/css" href="_static/stylesheet-a.css?v=e575b6df" />' in content
-    assert '<link rel="stylesheet" type="text/css" href="_static/stylesheet-b.css?v=a2d5cc0f" />' in content
-    assert '<script src="_static/script.js?v=48278d48"></script>' in content
-
-    # empty files have no checksum
-    assert '<script src="_static/empty.js"></script>' in content
-
-    # no checksum for hyperlinks
-    assert '<link rel="stylesheet" type="text/css" href="https://example.com/custom.css" />' in content
-    assert '<script src="https://example.com/script.js"></script>' in content
-
-
-def test_file_checksum_query_string():
-    with pytest.raises(ThemeError, match='Local asset file paths must not contain query strings'):
-        _file_checksum(Path(), 'with_query_string.css?dead_parrots=1')
-
-    with pytest.raises(ThemeError, match='Local asset file paths must not contain query strings'):
-        _file_checksum(Path(), 'with_query_string.js?dead_parrots=1')
-
-    with pytest.raises(ThemeError, match='Local asset file paths must not contain query strings'):
-        _file_checksum(Path.cwd(), '_static/with_query_string.css?dead_parrots=1')
-
-    with pytest.raises(ThemeError, match='Local asset file paths must not contain query strings'):
-        _file_checksum(Path.cwd(), '_static/with_query_string.js?dead_parrots=1')
-
-
-@pytest.mark.sphinx('html', testroot='html_assets')
-def test_javscript_loading_method(app):
-    app.add_js_file('normal.js')
-    app.add_js_file('early.js', loading_method='async')
-    app.add_js_file('late.js', loading_method='defer')
-
-    app.build(force_all=True)
-    content = (app.outdir / 'index.html').read_text(encoding='utf8')
-
-    assert '<script src="_static/normal.js"></script>' in content
-    assert '<script async="async" src="_static/early.js"></script>' in content
-    assert '<script defer="defer" src="_static/late.js"></script>' in content
-
-
 @pytest.mark.sphinx('html', testroot='basic', confoverrides={'html_copy_source': False})
 def test_html_copy_source(app):
     app.build(force_all=True)
@@ -1391,44 +287,6 @@ def test_html_style(app, status, warning):
             not in result)
 
 
-@pytest.mark.sphinx('html', testroot='images')
-def test_html_remote_images(app, status, warning):
-    app.build(force_all=True)
-
-    result = (app.outdir / 'index.html').read_text(encoding='utf8')
-    assert ('<img alt="https://www.python.org/static/img/python-logo.png" '
-            'src="https://www.python.org/static/img/python-logo.png" />' in result)
-    assert not (app.outdir / 'python-logo.png').exists()
-
-
-@pytest.mark.sphinx('html', testroot='image-escape')
-def test_html_encoded_image(app, status, warning):
-    app.build(force_all=True)
-
-    result = (app.outdir / 'index.html').read_text(encoding='utf8')
-    assert ('<img alt="_images/img_%231.png" src="_images/img_%231.png" />' in result)
-    assert (app.outdir / '_images/img_#1.png').exists()
-
-
-@pytest.mark.sphinx('html', testroot='remote-logo')
-def test_html_remote_logo(app, status, warning):
-    app.build(force_all=True)
-
-    result = (app.outdir / 'index.html').read_text(encoding='utf8')
-    assert ('<img class="logo" src="https://www.python.org/static/img/python-logo.png" alt="Logo"/>' in result)
-    assert ('<link rel="icon" href="https://www.python.org/static/favicon.ico"/>' in result)
-    assert not (app.outdir / 'python-logo.png').exists()
-
-
-@pytest.mark.sphinx('html', testroot='local-logo')
-def test_html_local_logo(app, status, warning):
-    app.build(force_all=True)
-
-    result = (app.outdir / 'index.html').read_text(encoding='utf8')
-    assert ('<img class="logo" src="_static/img.png" alt="Logo"/>' in result)
-    assert (app.outdir / '_static/img.png').exists()
-
-
 @pytest.mark.sphinx('html', testroot='basic')
 def test_html_sidebar(app, status, warning):
     ctx = {}
@@ -1476,27 +334,6 @@ def test_html_sidebar(app, status, warning):
     assert ctx['sidebars'] == []
 
 
-@pytest.mark.sphinx('html', testroot='manpage_url',
-                    confoverrides={'manpages_url': 'https://example.com/{page}.{section}'})
-def test_html_manpage(app, cached_etree_parse):
-    app.build(force_all=True)
-
-    content = (app.outdir / 'index.html').read_text(encoding='utf8')
-    assert ('<em class="manpage">'
-            '<a class="manpage reference external" href="https://example.com/man.1">man(1)</a>'
-            '</em>') in content
-    assert ('<em class="manpage">'
-            '<a class="manpage reference external" href="https://example.com/ls.1">ls.1</a>'
-            '</em>') in content
-    assert ('<em class="manpage">'
-            '<a class="manpage reference external" href="https://example.com/sphinx.">sphinx</a>'
-            '</em>') in content
-    assert ('<em class="manpage">'
-            '<a class="manpage reference external" href="https://example.com/bsd-mailx/mailx.1">mailx(1)</a>'
-            '</em>') in content
-    assert '<em class="manpage">man(1)</em>' in content
-
-
 @pytest.mark.sphinx('html', testroot='toctree-glob',
                     confoverrides={'html_baseurl': 'https://example.com/'})
 def test_html_baseurl(app, status, warning):
@@ -1522,86 +359,6 @@ def test_html_baseurl_and_html_file_suffix(app, status, warning):
     assert '<link rel="canonical" href="https://example.com/subdir/qux/index.htm" />' in result
 
 
-@pytest.mark.sphinx('html', testroot='basic')
-def test_default_html_math_renderer(app, status, warning):
-    assert app.builder.math_renderer_name == 'mathjax'
-
-
-@pytest.mark.sphinx('html', testroot='basic',
-                    confoverrides={'extensions': ['sphinx.ext.mathjax']})
-def test_html_math_renderer_is_mathjax(app, status, warning):
-    assert app.builder.math_renderer_name == 'mathjax'
-
-
-@pytest.mark.sphinx('html', testroot='basic',
-                    confoverrides={'extensions': ['sphinx.ext.imgmath']})
-def test_html_math_renderer_is_imgmath(app, status, warning):
-    assert app.builder.math_renderer_name == 'imgmath'
-
-
-@pytest.mark.sphinx('html', testroot='basic',
-                    confoverrides={'extensions': ['sphinxcontrib.jsmath',
-                                                  'sphinx.ext.imgmath']})
-def test_html_math_renderer_is_duplicated(make_app, app_params):
-    args, kwargs = app_params
-    with pytest.raises(
-        ConfigError,
-        match='Many math_renderers are registered. But no math_renderer is selected.',
-    ):
-        make_app(*args, **kwargs)
-
-
-@pytest.mark.sphinx('html', testroot='basic',
-                    confoverrides={'extensions': ['sphinx.ext.imgmath',
-                                                  'sphinx.ext.mathjax']})
-def test_html_math_renderer_is_duplicated2(app, status, warning):
-    # case of both mathjax and another math_renderer is loaded
-    assert app.builder.math_renderer_name == 'imgmath'  # The another one is chosen
-
-
-@pytest.mark.sphinx('html', testroot='basic',
-                    confoverrides={'extensions': ['sphinxcontrib.jsmath',
-                                                  'sphinx.ext.imgmath'],
-                                   'html_math_renderer': 'imgmath'})
-def test_html_math_renderer_is_chosen(app, status, warning):
-    assert app.builder.math_renderer_name == 'imgmath'
-
-
-@pytest.mark.sphinx('html', testroot='basic',
-                    confoverrides={'extensions': ['sphinxcontrib.jsmath',
-                                                  'sphinx.ext.mathjax'],
-                                   'html_math_renderer': 'imgmath'})
-def test_html_math_renderer_is_mismatched(make_app, app_params):
-    args, kwargs = app_params
-    with pytest.raises(ConfigError, match="Unknown math_renderer 'imgmath' is given."):
-        make_app(*args, **kwargs)
-
-
-@pytest.mark.sphinx('html', testroot='basic')
-def test_html_pygments_style_default(app):
-    style = app.builder.highlighter.formatter_args.get('style')
-    assert style.__name__ == 'Alabaster'
-
-
-@pytest.mark.sphinx('html', testroot='basic',
-                    confoverrides={'pygments_style': 'sphinx'})
-def test_html_pygments_style_manually(app):
-    style = app.builder.highlighter.formatter_args.get('style')
-    assert style.__name__ == 'SphinxStyle'
-
-
-@pytest.mark.sphinx('html', testroot='basic',
-                    confoverrides={'html_theme': 'classic'})
-def test_html_pygments_for_classic_theme(app):
-    style = app.builder.highlighter.formatter_args.get('style')
-    assert style.__name__ == 'SphinxStyle'
-
-
-@pytest.mark.sphinx('html', testroot='basic')
-def test_html_dark_pygments_style_default(app):
-    assert app.builder.dark_highlighter is None
-
-
 @pytest.mark.sphinx(testroot='basic', srcdir='validate_html_extra_path')
 def test_validate_html_extra_path(app):
     (app.confdir / '_static').mkdir(parents=True, exist_ok=True)
@@ -1628,82 +385,6 @@ def test_validate_html_static_path(app):
     assert app.config.html_static_path == ['_static']
 
 
-@pytest.mark.sphinx(testroot='html_scaled_image_link')
-def test_html_scaled_image_link(app):
-    app.build()
-    context = (app.outdir / 'index.html').read_text(encoding='utf8')
-
-    # no scaled parameters
-    assert re.search('\n<img alt="_images/img.png" src="_images/img.png" />', context)
-
-    # scaled_image_link
-    # Docutils 0.21 adds a newline before the closing </a> tag
-    closing_space = "\n" if docutils.__version_info__[:2] >= (0, 21) else ""
-    assert re.search('\n<a class="reference internal image-reference" href="_images/img.png">'
-                     '<img alt="_images/img.png" src="_images/img.png" style="[^"]+" />'
-                     f'{closing_space}</a>',
-                     context)
-
-    # no-scaled-link class disables the feature
-    assert re.search('\n<img alt="_images/img.png" class="no-scaled-link"'
-                     ' src="_images/img.png" style="[^"]+" />',
-                     context)
-
-
-@pytest.mark.sphinx('html', testroot='reST-code-block',
-                    confoverrides={'html_codeblock_linenos_style': 'table'})
-def test_html_codeblock_linenos_style_table(app):
-    app.build()
-    content = (app.outdir / 'index.html').read_text(encoding='utf8')
-
-    assert ('<div class="linenodiv"><pre><span class="normal">1</span>\n'
-            '<span class="normal">2</span>\n'
-            '<span class="normal">3</span>\n'
-            '<span class="normal">4</span></pre></div>') in content
-
-
-@pytest.mark.sphinx('html', testroot='reST-code-block',
-                    confoverrides={'html_codeblock_linenos_style': 'inline'})
-def test_html_codeblock_linenos_style_inline(app):
-    app.build()
-    content = (app.outdir / 'index.html').read_text(encoding='utf8')
-
-    assert '<span class="linenos">1</span>' in content
-
-
-@pytest.mark.sphinx('html', testroot='highlight_options')
-def test_highlight_options(app):
-    subject = app.builder.highlighter
-    with patch.object(subject, 'highlight_block', wraps=subject.highlight_block) as highlight:
-        app.build()
-
-        call_args = highlight.call_args_list
-        assert len(call_args) == 3
-        assert call_args[0] == call(ANY, 'default', force=False, linenos=False,
-                                    location=ANY, opts={'default_option': True})
-        assert call_args[1] == call(ANY, 'python', force=False, linenos=False,
-                                    location=ANY, opts={'python_option': True})
-        assert call_args[2] == call(ANY, 'java', force=False, linenos=False,
-                                    location=ANY, opts={})
-
-
-@pytest.mark.sphinx('html', testroot='highlight_options',
-                    confoverrides={'highlight_options': {'default_option': True}})
-def test_highlight_options_old(app):
-    subject = app.builder.highlighter
-    with patch.object(subject, 'highlight_block', wraps=subject.highlight_block) as highlight:
-        app.build()
-
-        call_args = highlight.call_args_list
-        assert len(call_args) == 3
-        assert call_args[0] == call(ANY, 'default', force=False, linenos=False,
-                                    location=ANY, opts={'default_option': True})
-        assert call_args[1] == call(ANY, 'python', force=False, linenos=False,
-                                    location=ANY, opts={})
-        assert call_args[2] == call(ANY, 'java', force=False, linenos=False,
-                                    location=ANY, opts={})
-
-
 @pytest.mark.sphinx('html', testroot='basic',
                     confoverrides={'html_permalinks': False})
 def test_html_permalink_disable(app):
@@ -1730,110 +411,3 @@ def test_html_signaturereturn_icon(app):
     content = (app.outdir / 'index.html').read_text(encoding='utf8')
 
     assert ('<span class="sig-return-icon">&#x2192;</span>' in content)
-
-
-@pytest.mark.sphinx('html', testroot='reST-code-role')
-def test_html_code_role(app):
-    app.build()
-    content = (app.outdir / 'index.html').read_text(encoding='utf8')
-
-    common_content = (
-        '<span class="k">def</span> <span class="nf">foo</span>'
-        '<span class="p">(</span>'
-        '<span class="mi">1</span> '
-        '<span class="o">+</span> '
-        '<span class="mi">2</span> '
-        '<span class="o">+</span> '
-        '<span class="kc">None</span> '
-        '<span class="o">+</span> '
-        '<span class="s2">&quot;abc&quot;</span>'
-        '<span class="p">):</span> '
-        '<span class="k">pass</span>')
-    assert ('<p>Inline <code class="code highlight python docutils literal highlight-python">' +
-            common_content + '</code> code block</p>') in content
-    assert ('<div class="highlight-python notranslate">' +
-            '<div class="highlight"><pre><span></span>' +
-            common_content) in content
-
-
-@pytest.mark.sphinx('html', testroot='root',
-                    confoverrides={'option_emphasise_placeholders': True})
-def test_option_emphasise_placeholders(app, status, warning):
-    app.build()
-    content = (app.outdir / 'objects.html').read_text(encoding='utf8')
-    assert '<em><span class="pre">TYPE</span></em>' in content
-    assert '{TYPE}' not in content
-    assert ('<em><span class="pre">WHERE</span></em>'
-            '<span class="pre">-</span>'
-            '<em><span class="pre">COUNT</span></em>' in content)
-    assert '<span class="pre">{{value}}</span>' in content
-    assert ('<span class="pre">--plugin.option</span></span>'
-            '<a class="headerlink" href="#cmdoption-perl-plugin.option" title="Link to this definition">¶</a></dt>') in content
-
-
-@pytest.mark.sphinx('html', testroot='root')
-def test_option_emphasise_placeholders_default(app, status, warning):
-    app.build()
-    content = (app.outdir / 'objects.html').read_text(encoding='utf8')
-    assert '<span class="pre">={TYPE}</span>' in content
-    assert '<span class="pre">={WHERE}-{COUNT}</span></span>' in content
-    assert '<span class="pre">{client_name}</span>' in content
-    assert ('<span class="pre">--plugin.option</span></span>'
-            '<span class="sig-prename descclassname"></span>'
-            '<a class="headerlink" href="#cmdoption-perl-plugin.option" title="Link to this definition">¶</a></dt>') in content
-
-
-@pytest.mark.sphinx('html', testroot='root')
-def test_option_reference_with_value(app, status, warning):
-    app.build()
-    content = (app.outdir / 'objects.html').read_text(encoding='utf-8')
-    assert ('<span class="pre">-mapi</span></span><span class="sig-prename descclassname">'
-            '</span><a class="headerlink" href="#cmdoption-git-commit-mapi"') in content
-    assert 'first option <a class="reference internal" href="#cmdoption-git-commit-mapi">' in content
-    assert ('<a class="reference internal" href="#cmdoption-git-commit-mapi">'
-            '<code class="xref std std-option docutils literal notranslate"><span class="pre">-mapi[=xxx]</span></code></a>') in content
-    assert '<span class="pre">-mapi</span> <span class="pre">with_space</span>' in content
-
-
-@pytest.mark.sphinx('html', testroot='theming')
-def test_theme_options(app, status, warning):
-    app.build()
-
-    result = (app.outdir / '_static' / 'documentation_options.js').read_text(encoding='utf8')
-    assert 'NAVIGATION_WITH_KEYS: false' in result
-    assert 'ENABLE_SEARCH_SHORTCUTS: true' in result
-
-
-@pytest.mark.sphinx('html', testroot='theming',
-                    confoverrides={'html_theme_options.navigation_with_keys': True,
-                                   'html_theme_options.enable_search_shortcuts': False})
-def test_theme_options_with_override(app, status, warning):
-    app.build()
-
-    result = (app.outdir / '_static' / 'documentation_options.js').read_text(encoding='utf8')
-    assert 'NAVIGATION_WITH_KEYS: true' in result
-    assert 'ENABLE_SEARCH_SHORTCUTS: false' in result
-
-
-@pytest.mark.sphinx('html', testroot='build-html-theme-having-multiple-stylesheets')
-def test_theme_having_multiple_stylesheets(app):
-    app.build()
-    content = (app.outdir / 'index.html').read_text(encoding='utf-8')
-
-    assert '<link rel="stylesheet" type="text/css" href="_static/mytheme.css" />' in content
-    assert '<link rel="stylesheet" type="text/css" href="_static/extra.css" />' in content
-
-
-@pytest.mark.sphinx('html', testroot='images')
-def test_copy_images(app, status, warning):
-    app.build()
-
-    images_dir = Path(app.outdir) / '_images'
-    images = {image.name for image in images_dir.rglob('*')}
-    assert images == {
-        'img.png',
-        'rimg.png',
-        'rimg1.png',
-        'svgimg.svg',
-        'testimäge.png',
-    }
diff --git a/tests/test_builders/test_build_html_5_output.py b/tests/test_builders/test_build_html_5_output.py
new file mode 100644
index 000000000..6ba7e9c17
--- /dev/null
+++ b/tests/test_builders/test_build_html_5_output.py
@@ -0,0 +1,290 @@
+"""Test the HTML builder and check output against XPath."""
+
+import re
+
+import pytest
+
+from tests.test_builders.test_build_html import check_xpath, flat_dict
+
+
+def tail_check(check):
+    rex = re.compile(check)
+
+    def checker(nodes):
+        for node in nodes:
+            if node.tail and rex.search(node.tail):
+                return True
+        msg = f'{check!r} not found in tail of any nodes {nodes}'
+        raise AssertionError(msg)
+    return checker
+
+
+@pytest.mark.parametrize(("fname", "expect"), flat_dict({
+    'images.html': [
+        (".//img[@src='_images/img.png']", ''),
+        (".//img[@src='_images/img1.png']", ''),
+        (".//img[@src='_images/simg.png']", ''),
+        (".//img[@src='_images/svgimg.svg']", ''),
+        (".//a[@href='_sources/images.txt']", ''),
+    ],
+    'subdir/images.html': [
+        (".//img[@src='../_images/img1.png']", ''),
+        (".//img[@src='../_images/rimg.png']", ''),
+    ],
+    'subdir/includes.html': [
+        (".//a[@class='reference download internal']", ''),
+        (".//img[@src='../_images/img.png']", ''),
+        (".//p", 'This is an include file.'),
+        (".//pre/span", 'line 1'),
+        (".//pre/span", 'line 2'),
+    ],
+    'includes.html': [
+        (".//pre", 'Max Strauß'),
+        (".//a[@class='reference download internal']", ''),
+        (".//pre/span", '"quotes"'),
+        (".//pre/span", "'included'"),
+        (".//pre/span[@class='s2']", 'üöä'),
+        (".//div[@class='inc-pyobj1 highlight-text notranslate']//pre",
+         r'^class Foo:\n    pass\n\s*$'),
+        (".//div[@class='inc-pyobj2 highlight-text notranslate']//pre",
+         r'^    def baz\(\):\n        pass\n\s*$'),
+        (".//div[@class='inc-lines highlight-text notranslate']//pre",
+         r'^class Foo:\n    pass\nclass Bar:\n$'),
+        (".//div[@class='inc-startend highlight-text notranslate']//pre",
+         '^foo = "Including Unicode characters: üöä"\\n$'),
+        (".//div[@class='inc-preappend highlight-text notranslate']//pre",
+         r'(?m)^START CODE$'),
+        (".//div[@class='inc-pyobj-dedent highlight-python notranslate']//span",
+         r'def'),
+        (".//div[@class='inc-tab3 highlight-text notranslate']//pre",
+         r'-| |-'),
+        (".//div[@class='inc-tab8 highlight-python notranslate']//pre/span",
+         r'-|      |-'),
+    ],
+    'autodoc.html': [
+        (".//dl[@class='py class']/dt[@id='autodoc_target.Class']", ''),
+        (".//dl[@class='py function']/dt[@id='autodoc_target.function']/em/span/span", r'\*\*'),
+        (".//dl[@class='py function']/dt[@id='autodoc_target.function']/em/span/span", r'kwds'),
+        (".//dd/p", r'Return spam\.'),
+    ],
+    'extapi.html': [
+        (".//strong", 'from class: Bar'),
+    ],
+    'markup.html': [
+        (".//title", 'set by title directive'),
+        (".//p/em", 'Section author: Georg Brandl'),
+        (".//p/em", 'Module author: Georg Brandl'),
+        # created by the meta directive
+        (".//meta[@name='author'][@content='Me']", ''),
+        (".//meta[@name='keywords'][@content='docs, sphinx']", ''),
+        # a label created by ``.. _label:``
+        (".//div[@id='label']", ''),
+        # code with standard code blocks
+        (".//pre", '^some code$'),
+        # an option list
+        (".//span[@class='option']", '--help'),
+        # admonitions
+        (".//p[@class='admonition-title']", 'My Admonition'),
+        (".//div[@class='admonition note']/p", 'Note text.'),
+        (".//div[@class='admonition warning']/p", 'Warning text.'),
+        # inline markup
+        (".//li/p/strong", r'^command\\n$'),
+        (".//li/p/strong", r'^program\\n$'),
+        (".//li/p/em", r'^dfn\\n$'),
+        (".//li/p/kbd", r'^kbd\\n$'),
+        (".//li/p/span", 'File \N{TRIANGULAR BULLET} Close'),
+        (".//li/p/code/span[@class='pre']", '^a/$'),
+        (".//li/p/code/em/span[@class='pre']", '^varpart$'),
+        (".//li/p/code/em/span[@class='pre']", '^i$'),
+        (".//a[@href='https://peps.python.org/pep-0008/']"
+         "[@class='pep reference external']/strong", 'PEP 8'),
+        (".//a[@href='https://peps.python.org/pep-0008/']"
+         "[@class='pep reference external']/strong",
+         'Python Enhancement Proposal #8'),
+        (".//a[@href='https://datatracker.ietf.org/doc/html/rfc1.html']"
+         "[@class='rfc reference external']/strong", 'RFC 1'),
+        (".//a[@href='https://datatracker.ietf.org/doc/html/rfc1.html']"
+         "[@class='rfc reference external']/strong", 'Request for Comments #1'),
+        (".//a[@href='objects.html#envvar-HOME']"
+         "[@class='reference internal']/code/span[@class='pre']", 'HOME'),
+        (".//a[@href='#with']"
+         "[@class='reference internal']/code/span[@class='pre']", '^with$'),
+        (".//a[@href='#grammar-token-try_stmt']"
+         "[@class='reference internal']/code/span", '^statement$'),
+        (".//a[@href='#some-label'][@class='reference internal']/span", '^here$'),
+        (".//a[@href='#some-label'][@class='reference internal']/span", '^there$'),
+        (".//a[@href='subdir/includes.html']"
+         "[@class='reference internal']/span", 'Including in subdir'),
+        (".//a[@href='objects.html#cmdoption-python-c']"
+         "[@class='reference internal']/code/span[@class='pre']", '-c'),
+        # abbreviations
+        (".//abbr[@title='abbreviation']", '^abbr$'),
+        # version stuff
+        (".//div[@class='versionadded']/p/span", 'New in version 0.6: '),
+        (".//div[@class='versionadded']/p/span",
+         tail_check('First paragraph of versionadded')),
+        (".//div[@class='versionchanged']/p/span",
+         tail_check('First paragraph of versionchanged')),
+        (".//div[@class='versionchanged']/p",
+         'Second paragraph of versionchanged'),
+        # footnote reference
+        (".//a[@class='footnote-reference brackets']", r'1'),
+        # created by reference lookup
+        (".//a[@href='index.html#ref1']", ''),
+        # ``seealso`` directive
+        (".//div/p[@class='admonition-title']", 'See also'),
+        # a ``hlist`` directive
+        (".//table[@class='hlist']/tbody/tr/td/ul/li/p", '^This$'),
+        # a ``centered`` directive
+        (".//p[@class='centered']/strong", 'LICENSE'),
+        # a glossary
+        (".//dl/dt[@id='term-boson']", 'boson'),
+        (".//dl/dt[@id='term-boson']/a", '¶'),
+        # a production list
+        (".//pre/strong", 'try_stmt'),
+        (".//pre/a[@href='#grammar-token-try1_stmt']/code/span", 'try1_stmt'),
+        # tests for ``only`` directive
+        (".//p", 'A global substitution!'),
+        (".//p", 'In HTML.'),
+        (".//p", 'In both.'),
+        (".//p", 'Always present'),
+        # tests for ``any`` role
+        (".//a[@href='#with']/span", 'headings'),
+        (".//a[@href='objects.html#func_without_body']/code/span", 'objects'),
+        # tests for numeric labels
+        (".//a[@href='#id1'][@class='reference internal']/span", 'Testing various markup'),
+        # tests for smartypants
+        (".//li/p", 'Smart “quotes” in English ‘text’.'),
+        (".//li/p", 'Smart — long and – short dashes.'),
+        (".//li/p", 'Ellipsis…'),
+        (".//li/p/code/span[@class='pre']", 'foo--"bar"...'),
+        (".//p", 'Этот «абзац» должен использовать „русские“ кавычки.'),
+        (".//p", 'Il dit : « C’est “super” ! »'),
+    ],
+    'objects.html': [
+        (".//dt[@id='mod.Cls.meth1']", ''),
+        (".//dt[@id='errmod.Error']", ''),
+        (".//dt/span[@class='sig-name descname']/span[@class='pre']", r'long\(parameter,'),
+        (".//dt/span[@class='sig-name descname']/span[@class='pre']", r'list\)'),
+        (".//dt/span[@class='sig-name descname']/span[@class='pre']", 'another'),
+        (".//dt/span[@class='sig-name descname']/span[@class='pre']", 'one'),
+        (".//a[@href='#mod.Cls'][@class='reference internal']", ''),
+        (".//dl[@class='std userdesc']", ''),
+        (".//dt[@id='userdesc-myobj']", ''),
+        (".//a[@href='#userdesc-myobj'][@class='reference internal']", ''),
+        # docfields
+        (".//a[@class='reference internal'][@href='#TimeInt']/em", 'TimeInt'),
+        (".//a[@class='reference internal'][@href='#Time']", 'Time'),
+        (".//a[@class='reference internal'][@href='#errmod.Error']/strong", 'Error'),
+        # C references
+        (".//span[@class='pre']", 'CFunction()'),
+        (".//a[@href='#c.Sphinx_DoSomething']", ''),
+        (".//a[@href='#c.SphinxStruct.member']", ''),
+        (".//a[@href='#c.SPHINX_USE_PYTHON']", ''),
+        (".//a[@href='#c.SphinxType']", ''),
+        (".//a[@href='#c.sphinx_global']", ''),
+        # test global TOC created by toctree()
+        (".//ul[@class='current']/li[@class='toctree-l1 current']/a[@href='#']",
+         'Testing object descriptions'),
+        (".//li[@class='toctree-l1']/a[@href='markup.html']",
+         'Testing various markup'),
+        # test unknown field names
+        (".//dt[@class='field-odd']", 'Field_name'),
+        (".//dt[@class='field-even']", 'Field_name all lower'),
+        (".//dt[@class='field-odd']", 'FIELD_NAME'),
+        (".//dt[@class='field-even']", 'FIELD_NAME ALL CAPS'),
+        (".//dt[@class='field-odd']", 'Field_Name'),
+        (".//dt[@class='field-even']", 'Field_Name All Word Caps'),
+        (".//dt[@class='field-odd']", 'Field_name'),
+        (".//dt[@class='field-even']", 'Field_name First word cap'),
+        (".//dt[@class='field-odd']", 'FIELd_name'),
+        (".//dt[@class='field-even']", 'FIELd_name PARTial caps'),
+        # custom sidebar
+        (".//h4", 'Custom sidebar'),
+        # docfields
+        (".//dd[@class='field-odd']/p/strong", '^moo$'),
+        (".//dd[@class='field-odd']/p/strong", tail_check(r'\(Moo\) .* Moo')),
+        (".//dd[@class='field-odd']/ul/li/p/strong", '^hour$'),
+        (".//dd[@class='field-odd']/ul/li/p/em", '^DuplicateType$'),
+        (".//dd[@class='field-odd']/ul/li/p/em", tail_check(r'.* Some parameter')),
+        # others
+        (".//a[@class='reference internal'][@href='#cmdoption-perl-arg-p']/code/span",
+         'perl'),
+        (".//a[@class='reference internal'][@href='#cmdoption-perl-arg-p']/code/span",
+         '\\+p'),
+        (".//a[@class='reference internal'][@href='#cmdoption-perl-ObjC']/code/span",
+         '--ObjC\\+\\+'),
+        (".//a[@class='reference internal'][@href='#cmdoption-perl-plugin.option']/code/span",
+         '--plugin.option'),
+        (".//a[@class='reference internal'][@href='#cmdoption-perl-arg-create-auth-token']"
+         "/code/span",
+         'create-auth-token'),
+        (".//a[@class='reference internal'][@href='#cmdoption-perl-arg-arg']/code/span",
+         'arg'),
+        (".//a[@class='reference internal'][@href='#cmdoption-perl-j']/code/span",
+         '-j'),
+        (".//a[@class='reference internal'][@href='#cmdoption-hg-arg-commit']/code/span",
+         'hg'),
+        (".//a[@class='reference internal'][@href='#cmdoption-hg-arg-commit']/code/span",
+         'commit'),
+        (".//a[@class='reference internal'][@href='#cmdoption-git-commit-p']/code/span",
+         'git'),
+        (".//a[@class='reference internal'][@href='#cmdoption-git-commit-p']/code/span",
+         'commit'),
+        (".//a[@class='reference internal'][@href='#cmdoption-git-commit-p']/code/span",
+         '-p'),
+    ],
+    'index.html': [
+        (".//meta[@name='hc'][@content='hcval']", ''),
+        (".//meta[@name='hc_co'][@content='hcval_co']", ''),
+        (".//li[@class='toctree-l1']/a", 'Testing various markup'),
+        (".//li[@class='toctree-l2']/a", 'Inline markup'),
+        (".//title", 'Sphinx <Tests>'),
+        (".//div[@class='footer']", 'copyright text credits'),
+        (".//a[@href='https://python.org/']"
+         "[@class='reference external']", ''),
+        (".//li/p/a[@href='genindex.html']/span", 'Index'),
+        (".//li/p/a[@href='py-modindex.html']/span", 'Module Index'),
+        # custom sidebar only for contents
+        (".//h4", 'Contents sidebar'),
+        # custom JavaScript
+        (".//script[@src='file://moo.js']", ''),
+        # URL in contents
+        (".//a[@class='reference external'][@href='https://sphinx-doc.org/']",
+         'https://sphinx-doc.org/'),
+        (".//a[@class='reference external'][@href='https://sphinx-doc.org/latest/']",
+         'Latest reference'),
+        # Indirect hyperlink targets across files
+        (".//a[@href='markup.html#some-label'][@class='reference internal']/span",
+         '^indirect hyperref$'),
+    ],
+    'bom.html': [
+        (".//title", " File with UTF-8 BOM"),
+    ],
+    'extensions.html': [
+        (".//a[@href='https://python.org/dev/']", "https://python.org/dev/"),
+        (".//a[@href='https://bugs.python.org/issue1000']", "issue 1000"),
+        (".//a[@href='https://bugs.python.org/issue1042']", "explicit caption"),
+    ],
+    'genindex.html': [
+        # index entries
+        (".//a/strong", "Main"),
+        (".//a/strong", "[1]"),
+        (".//a/strong", "Other"),
+        (".//a", "entry"),
+        (".//li/a", "double"),
+    ],
+    'otherext.html': [
+        (".//h1", "Generated section"),
+        (".//a[@href='_sources/otherext.foo.txt']", ''),
+    ],
+    'search.html': [
+        (".//meta[@name='robots'][@content='noindex']", ''),
+    ],
+}))
+@pytest.mark.sphinx('html', tags=['testtag'],
+                    confoverrides={'html_context.hckey_co': 'hcval_co'})
+@pytest.mark.test_params(shared_result='test_build_html_output')
+def test_html5_output(app, cached_etree_parse, fname, expect):
+    app.build()
+    check_xpath(cached_etree_parse(app.outdir / fname), fname, *expect)
diff --git a/tests/test_builders/test_build_html_assets.py b/tests/test_builders/test_build_html_assets.py
new file mode 100644
index 000000000..48494145d
--- /dev/null
+++ b/tests/test_builders/test_build_html_assets.py
@@ -0,0 +1,154 @@
+"""Test the HTML builder and check output against XPath."""
+
+import re
+from pathlib import Path
+
+import pytest
+
+import sphinx.builders.html
+from sphinx.builders.html._assets import _file_checksum
+from sphinx.errors import ThemeError
+
+
+@pytest.mark.sphinx('html', testroot='html_assets')
+def test_html_assets(app):
+    app.build(force_all=True)
+
+    # exclude_path and its family
+    assert not (app.outdir / 'static' / 'index.html').exists()
+    assert not (app.outdir / 'extra' / 'index.html').exists()
+
+    # html_static_path
+    assert not (app.outdir / '_static' / '.htaccess').exists()
+    assert not (app.outdir / '_static' / '.htpasswd').exists()
+    assert (app.outdir / '_static' / 'API.html').exists()
+    assert (app.outdir / '_static' / 'API.html').read_text(encoding='utf8') == 'Sphinx-1.4.4'
+    assert (app.outdir / '_static' / 'css' / 'style.css').exists()
+    assert (app.outdir / '_static' / 'js' / 'custom.js').exists()
+    assert (app.outdir / '_static' / 'rimg.png').exists()
+    assert not (app.outdir / '_static' / '_build' / 'index.html').exists()
+    assert (app.outdir / '_static' / 'background.png').exists()
+    assert not (app.outdir / '_static' / 'subdir' / '.htaccess').exists()
+    assert not (app.outdir / '_static' / 'subdir' / '.htpasswd').exists()
+
+    # html_extra_path
+    assert (app.outdir / '.htaccess').exists()
+    assert not (app.outdir / '.htpasswd').exists()
+    assert (app.outdir / 'API.html_t').exists()
+    assert (app.outdir / 'css/style.css').exists()
+    assert (app.outdir / 'rimg.png').exists()
+    assert not (app.outdir / '_build' / 'index.html').exists()
+    assert (app.outdir / 'background.png').exists()
+    assert (app.outdir / 'subdir' / '.htaccess').exists()
+    assert not (app.outdir / 'subdir' / '.htpasswd').exists()
+
+    # html_css_files
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
+    assert '<link rel="stylesheet" type="text/css" href="_static/css/style.css" />' in content
+    assert ('<link media="print" rel="stylesheet" title="title" type="text/css" '
+            'href="https://example.com/custom.css" />' in content)
+
+    # html_js_files
+    assert '<script src="_static/js/custom.js"></script>' in content
+    assert ('<script async="async" src="https://example.com/script.js">'
+            '</script>' in content)
+
+
+@pytest.mark.sphinx('html', testroot='html_assets')
+def test_assets_order(app, monkeypatch):
+    monkeypatch.setattr(sphinx.builders.html, '_file_checksum', lambda o, f: '')
+
+    app.add_css_file('normal.css')
+    app.add_css_file('early.css', priority=100)
+    app.add_css_file('late.css', priority=750)
+    app.add_css_file('lazy.css', priority=900)
+    app.add_js_file('normal.js')
+    app.add_js_file('early.js', priority=100)
+    app.add_js_file('late.js', priority=750)
+    app.add_js_file('lazy.js', priority=900)
+
+    app.build(force_all=True)
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
+
+    # css_files
+    expected = [
+        '_static/early.css',
+        '_static/pygments.css',
+        '_static/alabaster.css',
+        'https://example.com/custom.css',
+        '_static/normal.css',
+        '_static/late.css',
+        '_static/css/style.css',
+        '_static/lazy.css',
+    ]
+    pattern = '.*'.join(f'href="{re.escape(f)}"' for f in expected)
+    assert re.search(pattern, content, re.DOTALL), content
+
+    # js_files
+    expected = [
+        '_static/early.js',
+        '_static/doctools.js',
+        '_static/sphinx_highlight.js',
+        'https://example.com/script.js',
+        '_static/normal.js',
+        '_static/late.js',
+        '_static/js/custom.js',
+        '_static/lazy.js',
+    ]
+    pattern = '.*'.join(f'src="{re.escape(f)}"' for f in expected)
+    assert re.search(pattern, content, re.DOTALL), content
+
+
+@pytest.mark.sphinx('html', testroot='html_file_checksum')
+def test_file_checksum(app):
+    app.add_css_file('stylesheet-a.css')
+    app.add_css_file('stylesheet-b.css')
+    app.add_css_file('https://example.com/custom.css')
+    app.add_js_file('script.js')
+    app.add_js_file('empty.js')
+    app.add_js_file('https://example.com/script.js')
+
+    app.build(force_all=True)
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
+
+    # checksum for local files
+    assert '<link rel="stylesheet" type="text/css" href="_static/stylesheet-a.css?v=e575b6df" />' in content
+    assert '<link rel="stylesheet" type="text/css" href="_static/stylesheet-b.css?v=a2d5cc0f" />' in content
+    assert '<script src="_static/script.js?v=48278d48"></script>' in content
+
+    # empty files have no checksum
+    assert '<script src="_static/empty.js"></script>' in content
+
+    # no checksum for hyperlinks
+    assert '<link rel="stylesheet" type="text/css" href="https://example.com/custom.css" />' in content
+    assert '<script src="https://example.com/script.js"></script>' in content
+
+
+def test_file_checksum_query_string():
+    with pytest.raises(ThemeError, match='Local asset file paths must not contain query strings'):
+        _file_checksum(Path(), 'with_query_string.css?dead_parrots=1')
+
+    with pytest.raises(ThemeError, match='Local asset file paths must not contain query strings'):
+        _file_checksum(Path(), 'with_query_string.js?dead_parrots=1')
+
+    with pytest.raises(ThemeError, match='Local asset file paths must not contain query strings'):
+        _file_checksum(Path.cwd(), '_static/with_query_string.css?dead_parrots=1')
+
+    with pytest.raises(ThemeError, match='Local asset file paths must not contain query strings'):
+        _file_checksum(Path.cwd(), '_static/with_query_string.js?dead_parrots=1')
+
+
+@pytest.mark.sphinx('html', testroot='html_assets')
+def test_javscript_loading_method(app):
+    app.add_js_file('normal.js')
+    app.add_js_file('early.js', loading_method='async')
+    app.add_js_file('late.js', loading_method='defer')
+
+    app.build(force_all=True)
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
+
+    assert '<script src="_static/normal.js"></script>' in content
+    assert '<script async="async" src="_static/early.js"></script>' in content
+    assert '<script defer="defer" src="_static/late.js"></script>' in content
+
+
diff --git a/tests/test_builders/test_build_html_code.py b/tests/test_builders/test_build_html_code.py
new file mode 100644
index 000000000..2a3db1db9
--- /dev/null
+++ b/tests/test_builders/test_build_html_code.py
@@ -0,0 +1,50 @@
+import pytest
+
+
+@pytest.mark.sphinx('html', testroot='reST-code-block',
+                    confoverrides={'html_codeblock_linenos_style': 'table'})
+def test_html_codeblock_linenos_style_table(app):
+    app.build()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
+
+    assert ('<div class="linenodiv"><pre><span class="normal">1</span>\n'
+            '<span class="normal">2</span>\n'
+            '<span class="normal">3</span>\n'
+            '<span class="normal">4</span></pre></div>') in content
+
+
+@pytest.mark.sphinx('html', testroot='reST-code-block',
+                    confoverrides={'html_codeblock_linenos_style': 'inline'})
+def test_html_codeblock_linenos_style_inline(app):
+    app.build()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
+
+    assert '<span class="linenos">1</span>' in content
+
+
+@pytest.mark.sphinx('html', testroot='reST-code-role')
+def test_html_code_role(app):
+    app.build()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
+
+    common_content = (
+        '<span class="k">def</span> <span class="nf">foo</span>'
+        '<span class="p">(</span>'
+        '<span class="mi">1</span> '
+        '<span class="o">+</span> '
+        '<span class="mi">2</span> '
+        '<span class="o">+</span> '
+        '<span class="kc">None</span> '
+        '<span class="o">+</span> '
+        '<span class="s2">&quot;abc&quot;</span>'
+        '<span class="p">):</span> '
+        '<span class="k">pass</span>')
+    assert ('<p>Inline <code class="code highlight python docutils literal highlight-python">' +
+            common_content + '</code> code block</p>') in content
+    assert ('<div class="highlight-python notranslate">' +
+            '<div class="highlight"><pre><span></span>' +
+            common_content) in content
+
+
+
+
diff --git a/tests/test_builders/test_build_html_download.py b/tests/test_builders/test_build_html_download.py
new file mode 100644
index 000000000..1201c6664
--- /dev/null
+++ b/tests/test_builders/test_build_html_download.py
@@ -0,0 +1,62 @@
+import hashlib
+import re
+
+import pytest
+
+
+@pytest.mark.sphinx('html')
+@pytest.mark.test_params(shared_result='test_build_html_output')
+def test_html_download(app):
+    app.build()
+
+    # subdir/includes.html
+    result = (app.outdir / 'subdir' / 'includes.html').read_text(encoding='utf8')
+    pattern = ('<a class="reference download internal" download="" '
+               'href="../(_downloads/.*/img.png)">')
+    matched = re.search(pattern, result)
+    assert matched
+    assert (app.outdir / matched.group(1)).exists()
+    filename = matched.group(1)
+
+    # includes.html
+    result = (app.outdir / 'includes.html').read_text(encoding='utf8')
+    pattern = ('<a class="reference download internal" download="" '
+               'href="(_downloads/.*/img.png)">')
+    matched = re.search(pattern, result)
+    assert matched
+    assert (app.outdir / matched.group(1)).exists()
+    assert matched.group(1) == filename
+
+    pattern = ('<a class="reference download internal" download="" '
+               'href="(_downloads/.*/)(file_with_special_%23_chars.xyz)">')
+    matched = re.search(pattern, result)
+    assert matched
+    assert (app.outdir / matched.group(1) / "file_with_special_#_chars.xyz").exists()
+
+
+@pytest.mark.sphinx('html', testroot='roles-download')
+def test_html_download_role(app, status, warning):
+    app.build()
+    digest = hashlib.md5(b'dummy.dat', usedforsecurity=False).hexdigest()
+    assert (app.outdir / '_downloads' / digest / 'dummy.dat').exists()
+    digest_another = hashlib.md5(b'another/dummy.dat', usedforsecurity=False).hexdigest()
+    assert (app.outdir / '_downloads' / digest_another / 'dummy.dat').exists()
+
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
+    assert (('<li><p><a class="reference download internal" download="" '
+             'href="_downloads/%s/dummy.dat">'
+             '<code class="xref download docutils literal notranslate">'
+             '<span class="pre">dummy.dat</span></code></a></p></li>' % digest)
+            in content)
+    assert (('<li><p><a class="reference download internal" download="" '
+             'href="_downloads/%s/dummy.dat">'
+             '<code class="xref download docutils literal notranslate">'
+             '<span class="pre">another/dummy.dat</span></code></a></p></li>' %
+             digest_another) in content)
+    assert ('<li><p><code class="xref download docutils literal notranslate">'
+            '<span class="pre">not_found.dat</span></code></p></li>' in content)
+    assert ('<li><p><a class="reference download external" download="" '
+            'href="https://www.sphinx-doc.org/en/master/_static/sphinx-logo.svg">'
+            '<code class="xref download docutils literal notranslate">'
+            '<span class="pre">Sphinx</span> <span class="pre">logo</span>'
+            '</code></a></p></li>' in content)
diff --git a/tests/test_builders/test_build_html_highlight.py b/tests/test_builders/test_build_html_highlight.py
new file mode 100644
index 000000000..aee1ecefd
--- /dev/null
+++ b/tests/test_builders/test_build_html_highlight.py
@@ -0,0 +1,61 @@
+from unittest.mock import ANY, call, patch
+
+import pytest
+
+
+@pytest.mark.sphinx('html', testroot='basic')
+def test_html_pygments_style_default(app):
+    style = app.builder.highlighter.formatter_args.get('style')
+    assert style.__name__ == 'Alabaster'
+
+
+@pytest.mark.sphinx('html', testroot='basic',
+                    confoverrides={'pygments_style': 'sphinx'})
+def test_html_pygments_style_manually(app):
+    style = app.builder.highlighter.formatter_args.get('style')
+    assert style.__name__ == 'SphinxStyle'
+
+
+@pytest.mark.sphinx('html', testroot='basic',
+                    confoverrides={'html_theme': 'classic'})
+def test_html_pygments_for_classic_theme(app):
+    style = app.builder.highlighter.formatter_args.get('style')
+    assert style.__name__ == 'SphinxStyle'
+
+
+@pytest.mark.sphinx('html', testroot='basic')
+def test_html_dark_pygments_style_default(app):
+    assert app.builder.dark_highlighter is None
+
+
+@pytest.mark.sphinx('html', testroot='highlight_options')
+def test_highlight_options(app):
+    subject = app.builder.highlighter
+    with patch.object(subject, 'highlight_block', wraps=subject.highlight_block) as highlight:
+        app.build()
+
+        call_args = highlight.call_args_list
+        assert len(call_args) == 3
+        assert call_args[0] == call(ANY, 'default', force=False, linenos=False,
+                                    location=ANY, opts={'default_option': True})
+        assert call_args[1] == call(ANY, 'python', force=False, linenos=False,
+                                    location=ANY, opts={'python_option': True})
+        assert call_args[2] == call(ANY, 'java', force=False, linenos=False,
+                                    location=ANY, opts={})
+
+
+@pytest.mark.sphinx('html', testroot='highlight_options',
+                    confoverrides={'highlight_options': {'default_option': True}})
+def test_highlight_options_old(app):
+    subject = app.builder.highlighter
+    with patch.object(subject, 'highlight_block', wraps=subject.highlight_block) as highlight:
+        app.build()
+
+        call_args = highlight.call_args_list
+        assert len(call_args) == 3
+        assert call_args[0] == call(ANY, 'default', force=False, linenos=False,
+                                    location=ANY, opts={'default_option': True})
+        assert call_args[1] == call(ANY, 'python', force=False, linenos=False,
+                                    location=ANY, opts={})
+        assert call_args[2] == call(ANY, 'java', force=False, linenos=False,
+                                    location=ANY, opts={})
diff --git a/tests/test_builders/test_build_html_image.py b/tests/test_builders/test_build_html_image.py
new file mode 100644
index 000000000..8c3d309d4
--- /dev/null
+++ b/tests/test_builders/test_build_html_image.py
@@ -0,0 +1,80 @@
+import re
+from pathlib import Path
+
+import docutils
+import pytest
+
+
+@pytest.mark.sphinx('html', testroot='images')
+def test_html_remote_images(app, status, warning):
+    app.build(force_all=True)
+
+    result = (app.outdir / 'index.html').read_text(encoding='utf8')
+    assert ('<img alt="https://www.python.org/static/img/python-logo.png" '
+            'src="https://www.python.org/static/img/python-logo.png" />' in result)
+    assert not (app.outdir / 'python-logo.png').exists()
+
+
+@pytest.mark.sphinx('html', testroot='image-escape')
+def test_html_encoded_image(app, status, warning):
+    app.build(force_all=True)
+
+    result = (app.outdir / 'index.html').read_text(encoding='utf8')
+    assert ('<img alt="_images/img_%231.png" src="_images/img_%231.png" />' in result)
+    assert (app.outdir / '_images/img_#1.png').exists()
+
+
+@pytest.mark.sphinx('html', testroot='remote-logo')
+def test_html_remote_logo(app, status, warning):
+    app.build(force_all=True)
+
+    result = (app.outdir / 'index.html').read_text(encoding='utf8')
+    assert ('<img class="logo" src="https://www.python.org/static/img/python-logo.png" alt="Logo"/>' in result)
+    assert ('<link rel="icon" href="https://www.python.org/static/favicon.ico"/>' in result)
+    assert not (app.outdir / 'python-logo.png').exists()
+
+
+@pytest.mark.sphinx('html', testroot='local-logo')
+def test_html_local_logo(app, status, warning):
+    app.build(force_all=True)
+
+    result = (app.outdir / 'index.html').read_text(encoding='utf8')
+    assert ('<img class="logo" src="_static/img.png" alt="Logo"/>' in result)
+    assert (app.outdir / '_static/img.png').exists()
+
+
+@pytest.mark.sphinx(testroot='html_scaled_image_link')
+def test_html_scaled_image_link(app):
+    app.build()
+    context = (app.outdir / 'index.html').read_text(encoding='utf8')
+
+    # no scaled parameters
+    assert re.search('\n<img alt="_images/img.png" src="_images/img.png" />', context)
+
+    # scaled_image_link
+    # Docutils 0.21 adds a newline before the closing </a> tag
+    closing_space = "\n" if docutils.__version_info__[:2] >= (0, 21) else ""
+    assert re.search('\n<a class="reference internal image-reference" href="_images/img.png">'
+                     '<img alt="_images/img.png" src="_images/img.png" style="[^"]+" />'
+                     f'{closing_space}</a>',
+                     context)
+
+    # no-scaled-link class disables the feature
+    assert re.search('\n<img alt="_images/img.png" class="no-scaled-link"'
+                     ' src="_images/img.png" style="[^"]+" />',
+                     context)
+
+
+@pytest.mark.sphinx('html', testroot='images')
+def test_copy_images(app, status, warning):
+    app.build()
+
+    images_dir = Path(app.outdir) / '_images'
+    images = {image.name for image in images_dir.rglob('*')}
+    assert images == {
+        'img.png',
+        'rimg.png',
+        'rimg1.png',
+        'svgimg.svg',
+        'testimäge.png',
+    }
diff --git a/tests/test_builders/test_build_html_maths.py b/tests/test_builders/test_build_html_maths.py
new file mode 100644
index 000000000..900846b85
--- /dev/null
+++ b/tests/test_builders/test_build_html_maths.py
@@ -0,0 +1,58 @@
+import pytest
+
+from sphinx.errors import ConfigError
+
+
+@pytest.mark.sphinx('html', testroot='basic')
+def test_default_html_math_renderer(app, status, warning):
+    assert app.builder.math_renderer_name == 'mathjax'
+
+
+@pytest.mark.sphinx('html', testroot='basic',
+                    confoverrides={'extensions': ['sphinx.ext.mathjax']})
+def test_html_math_renderer_is_mathjax(app, status, warning):
+    assert app.builder.math_renderer_name == 'mathjax'
+
+
+@pytest.mark.sphinx('html', testroot='basic',
+                    confoverrides={'extensions': ['sphinx.ext.imgmath']})
+def test_html_math_renderer_is_imgmath(app, status, warning):
+    assert app.builder.math_renderer_name == 'imgmath'
+
+
+@pytest.mark.sphinx('html', testroot='basic',
+                    confoverrides={'extensions': ['sphinxcontrib.jsmath',
+                                                  'sphinx.ext.imgmath']})
+def test_html_math_renderer_is_duplicated(make_app, app_params):
+    args, kwargs = app_params
+    with pytest.raises(
+        ConfigError,
+        match='Many math_renderers are registered. But no math_renderer is selected.',
+    ):
+        make_app(*args, **kwargs)
+
+
+@pytest.mark.sphinx('html', testroot='basic',
+                    confoverrides={'extensions': ['sphinx.ext.imgmath',
+                                                  'sphinx.ext.mathjax']})
+def test_html_math_renderer_is_duplicated2(app, status, warning):
+    # case of both mathjax and another math_renderer is loaded
+    assert app.builder.math_renderer_name == 'imgmath'  # The another one is chosen
+
+
+@pytest.mark.sphinx('html', testroot='basic',
+                    confoverrides={'extensions': ['sphinxcontrib.jsmath',
+                                                  'sphinx.ext.imgmath'],
+                                   'html_math_renderer': 'imgmath'})
+def test_html_math_renderer_is_chosen(app, status, warning):
+    assert app.builder.math_renderer_name == 'imgmath'
+
+
+@pytest.mark.sphinx('html', testroot='basic',
+                    confoverrides={'extensions': ['sphinxcontrib.jsmath',
+                                                  'sphinx.ext.mathjax'],
+                                   'html_math_renderer': 'imgmath'})
+def test_html_math_renderer_is_mismatched(make_app, app_params):
+    args, kwargs = app_params
+    with pytest.raises(ConfigError, match="Unknown math_renderer 'imgmath' is given."):
+        make_app(*args, **kwargs)
diff --git a/tests/test_builders/test_build_html_numfig.py b/tests/test_builders/test_build_html_numfig.py
new file mode 100644
index 000000000..6e719d807
--- /dev/null
+++ b/tests/test_builders/test_build_html_numfig.py
@@ -0,0 +1,511 @@
+"""Test the HTML builder and check output against XPath."""
+
+import os
+import re
+
+import pytest
+
+from tests.test_builders.test_build_html import FIGURE_CAPTION, check_xpath, flat_dict
+
+
+@pytest.mark.sphinx('html', testroot='numfig')
+@pytest.mark.test_params(shared_result='test_build_html_numfig')
+def test_numfig_disabled_warn(app, warning):
+    app.build()
+    warnings = warning.getvalue()
+    assert 'index.rst:47: WARNING: numfig is disabled. :numref: is ignored.' in warnings
+    assert 'index.rst:56: WARNING: invalid numfig_format: invalid' not in warnings
+    assert 'index.rst:57: WARNING: invalid numfig_format: Fig %s %s' not in warnings
+
+
+@pytest.mark.parametrize(("fname", "expect"), flat_dict({
+    'index.html': [
+        (FIGURE_CAPTION + "/span[@class='caption-number']", None, True),
+        (".//table/caption/span[@class='caption-number']", None, True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", None, True),
+        (".//li/p/code/span", '^fig1$', True),
+        (".//li/p/code/span", '^Figure%s$', True),
+        (".//li/p/code/span", '^table-1$', True),
+        (".//li/p/code/span", '^Table:%s$', True),
+        (".//li/p/code/span", '^CODE_1$', True),
+        (".//li/p/code/span", '^Code-%s$', True),
+        (".//li/p/a/span", '^Section 1$', True),
+        (".//li/p/a/span", '^Section 2.1$', True),
+        (".//li/p/code/span", '^Fig.{number}$', True),
+        (".//li/p/a/span", '^Sect.1 Foo$', True),
+    ],
+    'foo.html': [
+        (FIGURE_CAPTION + "/span[@class='caption-number']", None, True),
+        (".//table/caption/span[@class='caption-number']", None, True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", None, True),
+    ],
+    'bar.html': [
+        (FIGURE_CAPTION + "/span[@class='caption-number']", None, True),
+        (".//table/caption/span[@class='caption-number']", None, True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", None, True),
+    ],
+    'baz.html': [
+        (FIGURE_CAPTION + "/span[@class='caption-number']", None, True),
+        (".//table/caption/span[@class='caption-number']", None, True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", None, True),
+    ],
+}))
+@pytest.mark.sphinx('html', testroot='numfig')
+@pytest.mark.test_params(shared_result='test_build_html_numfig')
+def test_numfig_disabled(app, cached_etree_parse, fname, expect):
+    app.build()
+    check_xpath(cached_etree_parse(app.outdir / fname), fname, *expect)
+
+
+@pytest.mark.sphinx(
+    'html', testroot='numfig',
+    srcdir='test_numfig_without_numbered_toctree_warn',
+    confoverrides={'numfig': True})
+def test_numfig_without_numbered_toctree_warn(app, warning):
+    app.build()
+    # remove :numbered: option
+    index = (app.srcdir / 'index.rst').read_text(encoding='utf8')
+    index = re.sub(':numbered:.*', '', index)
+    (app.srcdir / 'index.rst').write_text(index, encoding='utf8')
+    app.build()
+
+    warnings = warning.getvalue()
+    assert 'index.rst:47: WARNING: numfig is disabled. :numref: is ignored.' not in warnings
+    assert 'index.rst:55: WARNING: Failed to create a cross reference. Any number is not assigned: index' in warnings
+    assert 'index.rst:56: WARNING: invalid numfig_format: invalid' in warnings
+    assert 'index.rst:57: WARNING: invalid numfig_format: Fig %s %s' in warnings
+
+
+@pytest.mark.parametrize(("fname", "expect"), flat_dict({
+    'index.html': [
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 9 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 10 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 9 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 10 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 9 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 10 $', True),
+        (".//li/p/a/span", '^Fig. 9$', True),
+        (".//li/p/a/span", '^Figure6$', True),
+        (".//li/p/a/span", '^Table 9$', True),
+        (".//li/p/a/span", '^Table:6$', True),
+        (".//li/p/a/span", '^Listing 9$', True),
+        (".//li/p/a/span", '^Code-6$', True),
+        (".//li/p/code/span", '^foo$', True),
+        (".//li/p/code/span", '^bar_a$', True),
+        (".//li/p/a/span", '^Fig.9 should be Fig.1$', True),
+        (".//li/p/code/span", '^Sect.{number}$', True),
+    ],
+    'foo.html': [
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 3 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 4 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 1 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 2 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 3 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 4 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 1 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 2 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 3 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 4 $', True),
+    ],
+    'bar.html': [
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 5 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 7 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 8 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 5 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 7 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 8 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 5 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 7 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 8 $', True),
+    ],
+    'baz.html': [
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 6 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 6 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 6 $', True),
+    ],
+}))
+@pytest.mark.sphinx(
+    'html', testroot='numfig',
+    srcdir='test_numfig_without_numbered_toctree',
+    confoverrides={'numfig': True})
+def test_numfig_without_numbered_toctree(app, cached_etree_parse, fname, expect):
+    # remove :numbered: option
+    index = (app.srcdir / 'index.rst').read_text(encoding='utf8')
+    index = re.sub(':numbered:.*', '', index)
+    (app.srcdir / 'index.rst').write_text(index, encoding='utf8')
+
+    if not os.listdir(app.outdir):
+        app.build()
+    check_xpath(cached_etree_parse(app.outdir / fname), fname, *expect)
+
+
+@pytest.mark.sphinx('html', testroot='numfig', confoverrides={'numfig': True})
+@pytest.mark.test_params(shared_result='test_build_html_numfig_on')
+def test_numfig_with_numbered_toctree_warn(app, warning):
+    app.build()
+    warnings = warning.getvalue()
+    assert 'index.rst:47: WARNING: numfig is disabled. :numref: is ignored.' not in warnings
+    assert 'index.rst:55: WARNING: Failed to create a cross reference. Any number is not assigned: index' in warnings
+    assert 'index.rst:56: WARNING: invalid numfig_format: invalid' in warnings
+    assert 'index.rst:57: WARNING: invalid numfig_format: Fig %s %s' in warnings
+
+
+@pytest.mark.parametrize(("fname", "expect"), flat_dict({
+    'index.html': [
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 1 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 2 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 1 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 2 $', True),
+        (".//li/p/a/span", '^Fig. 1$', True),
+        (".//li/p/a/span", '^Figure2.2$', True),
+        (".//li/p/a/span", '^Table 1$', True),
+        (".//li/p/a/span", '^Table:2.2$', True),
+        (".//li/p/a/span", '^Listing 1$', True),
+        (".//li/p/a/span", '^Code-2.2$', True),
+        (".//li/p/a/span", '^Section.1$', True),
+        (".//li/p/a/span", '^Section.2.1$', True),
+        (".//li/p/a/span", '^Fig.1 should be Fig.1$', True),
+        (".//li/p/a/span", '^Sect.1 Foo$', True),
+    ],
+    'foo.html': [
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.1 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.2 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.3 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.4 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 1.1 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 1.2 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 1.3 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 1.4 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 1.1 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 1.2 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 1.3 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 1.4 $', True),
+    ],
+    'bar.html': [
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.1 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.3 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.4 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 2.1 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 2.3 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 2.4 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 2.1 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 2.3 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 2.4 $', True),
+    ],
+    'baz.html': [
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.2 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 2.2 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 2.2 $', True),
+    ],
+}))
+@pytest.mark.sphinx('html', testroot='numfig', confoverrides={'numfig': True})
+@pytest.mark.test_params(shared_result='test_build_html_numfig_on')
+def test_numfig_with_numbered_toctree(app, cached_etree_parse, fname, expect):
+    app.build()
+    check_xpath(cached_etree_parse(app.outdir / fname), fname, *expect)
+
+
+@pytest.mark.sphinx('html', testroot='numfig', confoverrides={
+    'numfig': True,
+    'numfig_format': {'figure': 'Figure:%s',
+                      'table': 'Tab_%s',
+                      'code-block': 'Code-%s',
+                      'section': 'SECTION-%s'}})
+@pytest.mark.test_params(shared_result='test_build_html_numfig_format_warn')
+def test_numfig_with_prefix_warn(app, warning):
+    app.build()
+    warnings = warning.getvalue()
+    assert 'index.rst:47: WARNING: numfig is disabled. :numref: is ignored.' not in warnings
+    assert 'index.rst:55: WARNING: Failed to create a cross reference. Any number is not assigned: index' in warnings
+    assert 'index.rst:56: WARNING: invalid numfig_format: invalid' in warnings
+    assert 'index.rst:57: WARNING: invalid numfig_format: Fig %s %s' in warnings
+
+
+@pytest.mark.parametrize(("fname", "expect"), flat_dict({
+    'index.html': [
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Figure:1 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Figure:2 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Tab_1 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Tab_2 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Code-1 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Code-2 $', True),
+        (".//li/p/a/span", '^Figure:1$', True),
+        (".//li/p/a/span", '^Figure2.2$', True),
+        (".//li/p/a/span", '^Tab_1$', True),
+        (".//li/p/a/span", '^Table:2.2$', True),
+        (".//li/p/a/span", '^Code-1$', True),
+        (".//li/p/a/span", '^Code-2.2$', True),
+        (".//li/p/a/span", '^SECTION-1$', True),
+        (".//li/p/a/span", '^SECTION-2.1$', True),
+        (".//li/p/a/span", '^Fig.1 should be Fig.1$', True),
+        (".//li/p/a/span", '^Sect.1 Foo$', True),
+    ],
+    'foo.html': [
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Figure:1.1 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Figure:1.2 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Figure:1.3 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Figure:1.4 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Tab_1.1 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Tab_1.2 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Tab_1.3 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Tab_1.4 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Code-1.1 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Code-1.2 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Code-1.3 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Code-1.4 $', True),
+    ],
+    'bar.html': [
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Figure:2.1 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Figure:2.3 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Figure:2.4 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Tab_2.1 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Tab_2.3 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Tab_2.4 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Code-2.1 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Code-2.3 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Code-2.4 $', True),
+    ],
+    'baz.html': [
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Figure:2.2 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Tab_2.2 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Code-2.2 $', True),
+    ],
+}))
+@pytest.mark.sphinx('html', testroot='numfig',
+                    confoverrides={'numfig': True,
+                                   'numfig_format': {'figure': 'Figure:%s',
+                                                     'table': 'Tab_%s',
+                                                     'code-block': 'Code-%s',
+                                                     'section': 'SECTION-%s'}})
+@pytest.mark.test_params(shared_result='test_build_html_numfig_format_warn')
+def test_numfig_with_prefix(app, cached_etree_parse, fname, expect):
+    app.build()
+    check_xpath(cached_etree_parse(app.outdir / fname), fname, *expect)
+
+
+@pytest.mark.sphinx('html', testroot='numfig',
+                    confoverrides={'numfig': True, 'numfig_secnum_depth': 2})
+@pytest.mark.test_params(shared_result='test_build_html_numfig_depth_2')
+def test_numfig_with_secnum_depth_warn(app, warning):
+    app.build()
+    warnings = warning.getvalue()
+    assert 'index.rst:47: WARNING: numfig is disabled. :numref: is ignored.' not in warnings
+    assert 'index.rst:55: WARNING: Failed to create a cross reference. Any number is not assigned: index' in warnings
+    assert 'index.rst:56: WARNING: invalid numfig_format: invalid' in warnings
+    assert 'index.rst:57: WARNING: invalid numfig_format: Fig %s %s' in warnings
+
+
+@pytest.mark.parametrize(("fname", "expect"), flat_dict({
+    'index.html': [
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 1 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 2 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 1 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 2 $', True),
+        (".//li/p/a/span", '^Fig. 1$', True),
+        (".//li/p/a/span", '^Figure2.1.2$', True),
+        (".//li/p/a/span", '^Table 1$', True),
+        (".//li/p/a/span", '^Table:2.1.2$', True),
+        (".//li/p/a/span", '^Listing 1$', True),
+        (".//li/p/a/span", '^Code-2.1.2$', True),
+        (".//li/p/a/span", '^Section.1$', True),
+        (".//li/p/a/span", '^Section.2.1$', True),
+        (".//li/p/a/span", '^Fig.1 should be Fig.1$', True),
+        (".//li/p/a/span", '^Sect.1 Foo$', True),
+    ],
+    'foo.html': [
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.1 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.1.1 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.1.2 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.2.1 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 1.1 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 1.1.1 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 1.1.2 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 1.2.1 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 1.1 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 1.1.1 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 1.1.2 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 1.2.1 $', True),
+    ],
+    'bar.html': [
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.1.1 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.1.3 $', True),
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.2.1 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 2.1.1 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 2.1.3 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 2.2.1 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 2.1.1 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 2.1.3 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 2.2.1 $', True),
+    ],
+    'baz.html': [
+        (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.1.2 $', True),
+        (".//table/caption/span[@class='caption-number']",
+         '^Table 2.1.2 $', True),
+        (".//div[@class='code-block-caption']/"
+         "span[@class='caption-number']", '^Listing 2.1.2 $', True),
+    ],
+}))
+@pytest.mark.sphinx('html', testroot='numfig',
+                    confoverrides={'numfig': True,
+                                   'numfig_secnum_depth': 2})
+@pytest.mark.test_params(shared_result='test_build_html_numfig_depth_2')
+def test_numfig_with_secnum_depth(app, cached_etree_parse, fname, expect):
+    app.build()
+    check_xpath(cached_etree_parse(app.outdir / fname), fname, *expect)
+
+
+@pytest.mark.parametrize("expect", [
+    (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1 $', True),
+    (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2 $', True),
+    (".//table/caption/span[@class='caption-number']",
+     '^Table 1 $', True),
+    (".//table/caption/span[@class='caption-number']",
+     '^Table 2 $', True),
+    (".//div[@class='code-block-caption']/"
+     "span[@class='caption-number']", '^Listing 1 $', True),
+    (".//div[@class='code-block-caption']/"
+     "span[@class='caption-number']", '^Listing 2 $', True),
+    (".//li/p/a/span", '^Fig. 1$', True),
+    (".//li/p/a/span", '^Figure2.2$', True),
+    (".//li/p/a/span", '^Table 1$', True),
+    (".//li/p/a/span", '^Table:2.2$', True),
+    (".//li/p/a/span", '^Listing 1$', True),
+    (".//li/p/a/span", '^Code-2.2$', True),
+    (".//li/p/a/span", '^Section.1$', True),
+    (".//li/p/a/span", '^Section.2.1$', True),
+    (".//li/p/a/span", '^Fig.1 should be Fig.1$', True),
+    (".//li/p/a/span", '^Sect.1 Foo$', True),
+    (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.1 $', True),
+    (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.2 $', True),
+    (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.3 $', True),
+    (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 1.4 $', True),
+    (".//table/caption/span[@class='caption-number']",
+     '^Table 1.1 $', True),
+    (".//table/caption/span[@class='caption-number']",
+     '^Table 1.2 $', True),
+    (".//table/caption/span[@class='caption-number']",
+     '^Table 1.3 $', True),
+    (".//table/caption/span[@class='caption-number']",
+     '^Table 1.4 $', True),
+    (".//div[@class='code-block-caption']/"
+     "span[@class='caption-number']", '^Listing 1.1 $', True),
+    (".//div[@class='code-block-caption']/"
+     "span[@class='caption-number']", '^Listing 1.2 $', True),
+    (".//div[@class='code-block-caption']/"
+     "span[@class='caption-number']", '^Listing 1.3 $', True),
+    (".//div[@class='code-block-caption']/"
+     "span[@class='caption-number']", '^Listing 1.4 $', True),
+    (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.1 $', True),
+    (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.3 $', True),
+    (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.4 $', True),
+    (".//table/caption/span[@class='caption-number']",
+     '^Table 2.1 $', True),
+    (".//table/caption/span[@class='caption-number']",
+     '^Table 2.3 $', True),
+    (".//table/caption/span[@class='caption-number']",
+     '^Table 2.4 $', True),
+    (".//div[@class='code-block-caption']/"
+     "span[@class='caption-number']", '^Listing 2.1 $', True),
+    (".//div[@class='code-block-caption']/"
+     "span[@class='caption-number']", '^Listing 2.3 $', True),
+    (".//div[@class='code-block-caption']/"
+     "span[@class='caption-number']", '^Listing 2.4 $', True),
+    (FIGURE_CAPTION + "/span[@class='caption-number']", '^Fig. 2.2 $', True),
+    (".//table/caption/span[@class='caption-number']",
+     '^Table 2.2 $', True),
+    (".//div[@class='code-block-caption']/"
+     "span[@class='caption-number']", '^Listing 2.2 $', True),
+])
+@pytest.mark.sphinx('singlehtml', testroot='numfig', confoverrides={'numfig': True})
+@pytest.mark.test_params(shared_result='test_build_html_numfig_on')
+def test_numfig_with_singlehtml(app, cached_etree_parse, expect):
+    app.build()
+    check_xpath(cached_etree_parse(app.outdir / 'index.html'), 'index.html', *expect)
diff --git a/tests/test_builders/test_build_html_tocdepth.py b/tests/test_builders/test_build_html_tocdepth.py
new file mode 100644
index 000000000..79f6a6798
--- /dev/null
+++ b/tests/test_builders/test_build_html_tocdepth.py
@@ -0,0 +1,99 @@
+"""Test the HTML builder and check output against XPath."""
+
+import pytest
+
+from tests.test_builders.test_build_html import check_xpath, flat_dict
+
+
+@pytest.mark.parametrize(("fname", "expect"), flat_dict({
+    'index.html': [
+        (".//li[@class='toctree-l3']/a", '1.1.1. Foo A1', True),
+        (".//li[@class='toctree-l3']/a", '1.2.1. Foo B1', True),
+        (".//li[@class='toctree-l3']/a", '2.1.1. Bar A1', False),
+        (".//li[@class='toctree-l3']/a", '2.2.1. Bar B1', False),
+    ],
+    'foo.html': [
+        (".//h1", 'Foo', True),
+        (".//h2", 'Foo A', True),
+        (".//h3", 'Foo A1', True),
+        (".//h2", 'Foo B', True),
+        (".//h3", 'Foo B1', True),
+
+        (".//h1//span[@class='section-number']", '1. ', True),
+        (".//h2//span[@class='section-number']", '1.1. ', True),
+        (".//h3//span[@class='section-number']", '1.1.1. ', True),
+        (".//h2//span[@class='section-number']", '1.2. ', True),
+        (".//h3//span[@class='section-number']", '1.2.1. ', True),
+
+        (".//div[@class='sphinxsidebarwrapper']//li/a", '1.1. Foo A', True),
+        (".//div[@class='sphinxsidebarwrapper']//li/a", '1.1.1. Foo A1', True),
+        (".//div[@class='sphinxsidebarwrapper']//li/a", '1.2. Foo B', True),
+        (".//div[@class='sphinxsidebarwrapper']//li/a", '1.2.1. Foo B1', True),
+    ],
+    'bar.html': [
+        (".//h1", 'Bar', True),
+        (".//h2", 'Bar A', True),
+        (".//h2", 'Bar B', True),
+        (".//h3", 'Bar B1', True),
+        (".//h1//span[@class='section-number']", '2. ', True),
+        (".//h2//span[@class='section-number']", '2.1. ', True),
+        (".//h2//span[@class='section-number']", '2.2. ', True),
+        (".//h3//span[@class='section-number']", '2.2.1. ', True),
+        (".//div[@class='sphinxsidebarwrapper']//li/a", '2. Bar', True),
+        (".//div[@class='sphinxsidebarwrapper']//li/a", '2.1. Bar A', True),
+        (".//div[@class='sphinxsidebarwrapper']//li/a", '2.2. Bar B', True),
+        (".//div[@class='sphinxsidebarwrapper']//li/a", '2.2.1. Bar B1', False),
+    ],
+    'baz.html': [
+        (".//h1", 'Baz A', True),
+        (".//h1//span[@class='section-number']", '2.1.1. ', True),
+    ],
+}))
+@pytest.mark.sphinx('html', testroot='tocdepth')
+@pytest.mark.test_params(shared_result='test_build_html_tocdepth')
+def test_tocdepth(app, cached_etree_parse, fname, expect):
+    app.build()
+    # issue #1251
+    check_xpath(cached_etree_parse(app.outdir / fname), fname, *expect)
+
+
+@pytest.mark.parametrize("expect", [
+    (".//li[@class='toctree-l3']/a", '1.1.1. Foo A1', True),
+    (".//li[@class='toctree-l3']/a", '1.2.1. Foo B1', True),
+    (".//li[@class='toctree-l3']/a", '2.1.1. Bar A1', False),
+    (".//li[@class='toctree-l3']/a", '2.2.1. Bar B1', False),
+
+    # index.rst
+    (".//h1", 'test-tocdepth', True),
+
+    # foo.rst
+    (".//h2", 'Foo', True),
+    (".//h3", 'Foo A', True),
+    (".//h4", 'Foo A1', True),
+    (".//h3", 'Foo B', True),
+    (".//h4", 'Foo B1', True),
+    (".//h2//span[@class='section-number']", '1. ', True),
+    (".//h3//span[@class='section-number']", '1.1. ', True),
+    (".//h4//span[@class='section-number']", '1.1.1. ', True),
+    (".//h3//span[@class='section-number']", '1.2. ', True),
+    (".//h4//span[@class='section-number']", '1.2.1. ', True),
+
+    # bar.rst
+    (".//h2", 'Bar', True),
+    (".//h3", 'Bar A', True),
+    (".//h3", 'Bar B', True),
+    (".//h4", 'Bar B1', True),
+    (".//h2//span[@class='section-number']", '2. ', True),
+    (".//h3//span[@class='section-number']", '2.1. ', True),
+    (".//h3//span[@class='section-number']", '2.2. ', True),
+    (".//h4//span[@class='section-number']", '2.2.1. ', True),
+
+    # baz.rst
+    (".//h4", 'Baz A', True),
+    (".//h4//span[@class='section-number']", '2.1.1. ', True),
+])
+@pytest.mark.sphinx('singlehtml', testroot='tocdepth')
+@pytest.mark.test_params(shared_result='test_build_html_tocdepth')
+def test_tocdepth_singlehtml(app, cached_etree_parse, expect):
+    app.build()
+    check_xpath(cached_etree_parse(app.outdir / 'index.html'), 'index.html', *expect)
diff --git a/tests/test_directives/test_directive_option.py b/tests/test_directives/test_directive_option.py
new file mode 100644
index 000000000..76448cdee
--- /dev/null
+++ b/tests/test_directives/test_directive_option.py
@@ -0,0 +1,40 @@
+import pytest
+
+
+@pytest.mark.sphinx('html', testroot='root',
+                    confoverrides={'option_emphasise_placeholders': True})
+def test_option_emphasise_placeholders(app, status, warning):
+    app.build()
+    content = (app.outdir / 'objects.html').read_text(encoding='utf8')
+    assert '<em><span class="pre">TYPE</span></em>' in content
+    assert '{TYPE}' not in content
+    assert ('<em><span class="pre">WHERE</span></em>'
+            '<span class="pre">-</span>'
+            '<em><span class="pre">COUNT</span></em>' in content)
+    assert '<span class="pre">{{value}}</span>' in content
+    assert ('<span class="pre">--plugin.option</span></span>'
+            '<a class="headerlink" href="#cmdoption-perl-plugin.option" title="Link to this definition">¶</a></dt>') in content
+
+
+@pytest.mark.sphinx('html', testroot='root')
+def test_option_emphasise_placeholders_default(app, status, warning):
+    app.build()
+    content = (app.outdir / 'objects.html').read_text(encoding='utf8')
+    assert '<span class="pre">={TYPE}</span>' in content
+    assert '<span class="pre">={WHERE}-{COUNT}</span></span>' in content
+    assert '<span class="pre">{client_name}</span>' in content
+    assert ('<span class="pre">--plugin.option</span></span>'
+            '<span class="sig-prename descclassname"></span>'
+            '<a class="headerlink" href="#cmdoption-perl-plugin.option" title="Link to this definition">¶</a></dt>') in content
+
+
+@pytest.mark.sphinx('html', testroot='root')
+def test_option_reference_with_value(app, status, warning):
+    app.build()
+    content = (app.outdir / 'objects.html').read_text(encoding='utf-8')
+    assert ('<span class="pre">-mapi</span></span><span class="sig-prename descclassname">'
+            '</span><a class="headerlink" href="#cmdoption-git-commit-mapi"') in content
+    assert 'first option <a class="reference internal" href="#cmdoption-git-commit-mapi">' in content
+    assert ('<a class="reference internal" href="#cmdoption-git-commit-mapi">'
+            '<code class="xref std std-option docutils literal notranslate"><span class="pre">-mapi[=xxx]</span></code></a>') in content
+    assert '<span class="pre">-mapi</span> <span class="pre">with_space</span>' in content
diff --git a/tests/test_domains/test_domain_std.py b/tests/test_domains/test_domain_std.py
index 49355972c..42a1823aa 100644
--- a/tests/test_domains/test_domain_std.py
+++ b/tests/test_domains/test_domain_std.py
@@ -493,3 +493,24 @@ def test_labeled_field(app):
     assert domain.labels['label1'] == ('index', 'label1', 'Foo blah blah blah')
     assert 'label2' in domain.labels
     assert domain.labels['label2'] == ('index', 'label2', 'Bar blah blah blah')
+
+
+@pytest.mark.sphinx('html', testroot='manpage_url',
+                    confoverrides={'manpages_url': 'https://example.com/{page}.{section}'})
+def test_html_manpage(app):
+    app.build(force_all=True)
+
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
+    assert ('<em class="manpage">'
+            '<a class="manpage reference external" href="https://example.com/man.1">man(1)</a>'
+            '</em>') in content
+    assert ('<em class="manpage">'
+            '<a class="manpage reference external" href="https://example.com/ls.1">ls.1</a>'
+            '</em>') in content
+    assert ('<em class="manpage">'
+            '<a class="manpage reference external" href="https://example.com/sphinx.">sphinx</a>'
+            '</em>') in content
+    assert ('<em class="manpage">'
+            '<a class="manpage reference external" href="https://example.com/bsd-mailx/mailx.1">mailx(1)</a>'
+            '</em>') in content
+    assert '<em class="manpage">man(1)</em>' in content
diff --git a/tests/test_theming/test_html_theme.py b/tests/test_theming/test_html_theme.py
new file mode 100644
index 000000000..8e662f071
--- /dev/null
+++ b/tests/test_theming/test_html_theme.py
@@ -0,0 +1,30 @@
+import pytest
+
+
+@pytest.mark.sphinx('html', testroot='theming')
+def test_theme_options(app, status, warning):
+    app.build()
+
+    result = (app.outdir / '_static' / 'documentation_options.js').read_text(encoding='utf8')
+    assert 'NAVIGATION_WITH_KEYS: false' in result
+    assert 'ENABLE_SEARCH_SHORTCUTS: true' in result
+
+
+@pytest.mark.sphinx('html', testroot='theming',
+                    confoverrides={'html_theme_options.navigation_with_keys': True,
+                                   'html_theme_options.enable_search_shortcuts': False})
+def test_theme_options_with_override(app, status, warning):
+    app.build()
+
+    result = (app.outdir / '_static' / 'documentation_options.js').read_text(encoding='utf8')
+    assert 'NAVIGATION_WITH_KEYS: true' in result
+    assert 'ENABLE_SEARCH_SHORTCUTS: false' in result
+
+
+@pytest.mark.sphinx('html', testroot='build-html-theme-having-multiple-stylesheets')
+def test_theme_having_multiple_stylesheets(app):
+    app.build()
+    content = (app.outdir / 'index.html').read_text(encoding='utf-8')
+
+    assert '<link rel="stylesheet" type="text/css" href="_static/mytheme.css" />' in content
+    assert '<link rel="stylesheet" type="text/css" href="_static/extra.css" />' in content