Harmonise Builder.write_doc()

sphinx/builders/dummy.py

@@ -8,7 +8,7 @@
 from sphinx.locale import __
 
 if TYPE_CHECKING:
-    from docutils.nodes import Node
+    from docutils import nodes
 
     from sphinx.application import Sphinx
     from sphinx.util.typing import ExtensionMetadata
@@ -32,7 +32,7 @@ def get_target_uri(self, docname: str, typ: str | None = None) -> str:
     def prepare_writing(self, docnames: set[str]) -> None:
         pass
 
-    def write_doc(self, docname: str, doctree: Node) -> None:
+    def write_doc(self, docname: str, doctree: nodes.document) -> None:
         pass
 
     def finish(self) -> None:

sphinx/builders/text.py

@@ -20,7 +20,7 @@
 if TYPE_CHECKING:
     from collections.abc import Iterator
 
-    from docutils.nodes import Node
+    from docutils import nodes
 
     from sphinx.application import Sphinx
     from sphinx.util.typing import ExtensionMetadata
@@ -67,7 +67,7 @@ def get_target_uri(self, docname: str, typ: str | None = None) -> str:
     def prepare_writing(self, docnames: set[str]) -> None:
         self.writer = TextWriter(self)
 
-    def write_doc(self, docname: str, doctree: Node) -> None:
+    def write_doc(self, docname: str, doctree: nodes.document) -> None:
         self.current_docname = docname
         self.secnumbers = self.env.toc_secnumbers.get(docname, {})
         destination = StringOutput(encoding='utf-8')

sphinx/builders/xml.py

@@ -22,8 +22,6 @@
 if TYPE_CHECKING:
     from collections.abc import Iterator
 
-    from docutils.nodes import Node
-
     from sphinx.application import Sphinx
     from sphinx.util.typing import ExtensionMetadata
 
@@ -73,13 +71,13 @@ def get_target_uri(self, docname: str, typ: str | None = None) -> str:
     def prepare_writing(self, docnames: set[str]) -> None:
         self.writer = self._writer_class(self)
 
-    def write_doc(self, docname: str, doctree: Node) -> None:
+    def write_doc(self, docname: str, doctree: nodes.document) -> None:
         # work around multiple string % tuple issues in docutils;
         # replace tuples in attribute values with lists
         doctree = doctree.deepcopy()
         for domain in self.env.domains.values():
             xmlns = "xmlns:" + domain.name
-            doctree[xmlns] = "https://www.sphinx-doc.org/"  # type: ignore[index]
+            doctree[xmlns] = "https://www.sphinx-doc.org/"
         for node in doctree.findall(nodes.Element):
             for att, value in node.attributes.items():
                 if isinstance(value, tuple):