Mention DIRHTML builder in docs

Author: sitic

docs/src/about.rst

@@ -16,7 +16,7 @@ is injected after the ordinary Sphinx build is finished.
 
 Caveats
 -------
-- **Only works with HTML documentation**, disabled otherwise. If the extension
+- **Only works with HTML or DIRHTML documentation**, disabled otherwise. If the extension
   is off, it silently removes directives that would produce output.
 - **Only processes blocks, not inline code**. Sphinx has great tools
   for linking definitions inline, and longer code should be in a block anyway.

docs/src/index.rst

@@ -68,7 +68,7 @@ Caveats
 -------
 For a more thorough explanation, see :ref:`about`.
 
-- Only works with HTML documentation
+- Only works with HTML or DIRHTML documentation
 - Only processes blocks, not inline code
 - Doesn't run example code
 - Parsing and type hint resolving is incomplete

tests/extension/__init__.py

@@ -289,7 +289,7 @@ def test_parallel_build(builder: str, tmp_path: Path):
             assert_links(result_dir / file / "index.html", links)
         else:
             assert_links(result_dir / (file + ".html"), links)
-            
+
     assert check_link_targets(result_dir) == n_subfiles * len(links)
 
 

tests/extension/_check.py

@@ -27,10 +27,10 @@ def check_link_targets(root: Path) -> int:
                     external_site_ids[base] = gather_ids(sub_soup)
                 ids = external_site_ids[base]
             else:
-                if base == '':
+                if base == "":
                     base = str(doc)
                 elif base == "../":
-                    base = str(doc.parent.parent / 'index.html')
+                    base = str(doc.parent.parent / "index.html")
                 ids = site_ids[Path(base)]
             assert id_ in ids, (
                 f"ID {id_} not found in {base}"