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 conf.py. Conf.py should contain at minimum:
from docs_conf import *
The conf.yaml file should contain at minimum:
--- project_cfg=myproject
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:
project/conf.py
project/conf.yaml
docs_conf/defaults/{project_cfg}.yaml
docs_conf/defaults/default.yaml
docs_conf/__init__.py
- conf.py structure and documentation:
TODO
- [ ] Define the minimum set of config values to release initial version.
These can probably come from ODL/OPNFV site conf.py 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.
Sections:
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for lfdocs_conf-0.2.6-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 67f6d50e01cb8883075c9b5368bf6ac9e8069346ada73e3b09e07a6dea343940 |
|
MD5 | 19d67cf19078a37a6445176bc8d6fb16 |
|
BLAKE2b-256 | 45d25e56a4270b1de163a9e89e241f41d9ebe00f43025ddf634ae4defd7dfe4f |