添加文档¶
要添加新的文档,请在树中的 moz.build 文件中定义 SPHINX_TREES 和 SPHINX_PYTHON_PACKAGE_DIRS 变量,文档将自动被提取。
假设您有一个名为 featureX 的目录,您希望为其编写一些文档。以下是为其创建 Sphinx 文档的步骤
为文档创建一个目录。这通常是
docs。例如featureX/docs。在此目录中创建一个
index.rst文件。index.rst文件是该部分的根文档。请参阅build/docs/index.rst以获取示例文件。在
moz.build文件(通常是docs目录的父目录中的文件)中,定义SPHINX_TREES以连接管道。例如SPHINX_TREES['featureX'] = 'docs'。这意味着当前目录下的 ``docs`` 目录应安装到 Sphinx 文档树的 ``/featureX`` 下。如果您有一些 Python 包,您希望为其生成 Python API 文档,您可以使用
SPHINX_PYTHON_PACKAGE_DIRS来声明包含 Python 包的目录。例如SPHINX_PYTHON_PACKAGE_DIRS += ['mozpackage']。在
docs/config.yml中,定义文档应该属于哪个类别。使用 ./mach lint -l rst 验证 rst 语法