Skip to main content

Linux Foundation DocsConf

Project description

The purpose of this project is to allow LF projects a centralized location for storing common project configuration.

To use this a project should create a conf.yaml file in the same directory as their should contain at minimum:

from docs_conf import *

The conf.yaml file should contain at minimum:


If defaults for ‘myproject’ exist, they will be loaded from this package, otherwise the basic Sphinx defaults will be set.

Configuration precedence for configuration is as follows:

  1. project/
  2. project/conf.yaml
  3. docs_conf/defaults/{project_cfg}.yaml
  4. docs_conf/defaults/default.yaml
  5. docs_conf/ structure and documentation:


  • [ ] Define the minimum set of config values to release initial version.

    These can probably come from ODL/OPNFV site files.

  • [ ] Use sane defaults, and don’t error out if something is not set.

    Each config needs to be imported gracefully (if it doesn’t exist, set None or something; similar to dict.get

  • [ ] Create own documentation for project detailing use of ‘conf.cfg’

    file as some values will require subkeys given that they’re dictionaries or expect a list of tuples.

  • [ ] Setup and document section. The documentation already is organized

    by section, so the config should also contain these section and look for their values under them.


    • general (aka sphinx)
    • project
    • i18n
    • html_output
    • apple_help
    • epub_output
    • latex_output
    • text_output
    • manpage_output
    • texinfo_output
    • linkcheck
    • xml
    • cplusplus
  • [ ] Configure pre-plugin sections, and reference by plugin listing.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for lfdocs-conf, version 0.3.1
Filename, size File type Python version Upload date Hashes
Filename, size lfdocs_conf-0.3.1-py2.py3-none-any.whl (7.4 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size lfdocs_conf-0.3.1.tar.gz (12.7 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page