项目 API

class sphinx.project.Project(srcdir: str | os.PathLike[str], source_suffix: Iterable[str])[source]

项目是 Sphinx 文档的源代码集。

discover(exclude_paths: Iterable[str] = (), include_paths: Iterable[str] = ('**',)) set[str][source]

在源目录中查找所有文档文件,并将它们放入 docnames 中。

doc2path(docname: str, absolute: bool) _StrPath[source]

返回文档名的文件名。

如果 absolute 为 True,则返回绝对路径。否则,返回相对于源目录的路径。

path2doc(filename: str | PathLike[str]) str | None[source]

如果文件是文档,则返回该文件的 docname。

filename 应为绝对路径或相对于源目录的路径。

restore(other: Project) None[source]

接管上次构建的结果。

docnames: set[str]

属于此项目的文档名称。

source_suffix

source_suffix。与 source_suffix 相同。

srcdir

源目录。