プロジェクト API

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

A project is the source code set of the Sphinx document(s).

discover(exclude_paths: Iterable[str] = (), include_paths: Iterable[str] = ('**',)) set[str][ソース]

Find all document files in the source directory and put them in docnames.

doc2path(docname: str, absolute: bool) str[ソース]

ドキュメント名に関連するファイル名を返します。

If absolute is True, return as an absolute path. Else, return as a relative path to the source directory.

path2doc(filename: str | PathLike[str]) str | None[ソース]

Return the docname for the filename if the file is a document.

filenameは絶対パスもしくは、ソースディレクトリからの相対パスで指定する必要があります。

restore(other: Project) None[ソース]

Take over a result of last build.

docnames: set[str]

The name of documents belonging to this project.

source_suffix

source_suffix. Same as source_suffix.

srcdir

ソースディレクトリ。