跳转到主要内容

Linux Foundation DocsConf

项目描述

该项目的目的是允许 LF 项目在集中位置存储常见项目配置。

要使用此功能,项目应在与 conf.py 相同的目录中创建一个 conf.yaml 文件。conf.py 的最小配置如下

from docs_conf import *

conf.yaml 文件的最小配置如下

---
project_cfg=myproject

如果存在,文档将从该包加载 'myproject' 的默认配置,否则将加载 Sphinx 默认的基本配置。

配置的优先级如下

  1. project/conf.py

  2. project/conf.yaml

  3. docs_conf/defaults/{project_cfg}.yaml

  4. docs_conf/defaults/default.yaml

  5. docs_conf/__init__.py

conf.py 结构和文档

https://sphinx-doc.cn/en/stable/config.html

待办事项

  • [ ] 定义发布初始版本所需的最小配置值。

    这些值可能来自ODL/OPNFV站点的conf.py文件。

  • [ ] 使用合理的默认值,如果某些设置未设置,则不要出错。

    我们必须干净地导入每个配置(如果不存在,则设置None或类似;如dict.get()函数)。

  • [ ] 为项目创建自己的文档,详细说明“conf.cfg”文件的使用

    ,因为某些值需要子键,因为它们是字典或期望元组列表。

  • [ ] 设置和记录部分。通过按部分组织文档,

    配置也应该包含这些部分,并在其下查找它们的值。

    部分

    • 通用(即sphinx)

    • 项目

    • 国际化

    • HTML输出

    • 苹果帮助

    • EPUB输出

    • LaTeX输出

    • 文本输出

    • 手册页输出

    • TeXinfo输出

    • 链接检查

    • XML

    • C++

  • [ ] 配置预插件部分,并通过插件列表引用。

项目详情


下载文件

下载适用于您平台的自定义文件。如果您不确定要选择哪一个,请了解更多关于安装包的信息。

源分布

lfdocs_conf-0.9.0.tar.gz (25.0 kB 查看哈希值)

上传时间

构建分布

lfdocs_conf-0.9.0-py2.py3-none-any.whl (8.4 kB 查看哈希值)

上传时间 Python 2 Python 3

由以下机构支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面