blob: 8c1e339e4c5fa56f989dffa8133b262838ebf48c (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
|
# Examples files
The examples files for a working (basic) configuration of sphinx should be used
by all ONAP projects (except 'doc' project). Extend them to reflect the needs
in your project. **Important:** The files relate on each other. Change them carefully!
We provide two directories:
- **master**: Contains configuration files used in the **development branch**.
- **release**: Contains configuration files used in the **release branch**
(e.g.'kohn'). **Important:** You need to change the 'kohn' entries
in the files! Replace them with the name of the new release branch.
The additional directories named *_static* and *images* and the file
*index.rst* are required to make the examples buildable. In the respective
directory you can execute the '*tox -e docs*' command and the build starts.
---
## conf.py
#### DESCRIPTION:
The “build configuration file” contains (almost) all configuration needed to
customize Sphinx input and output behavior.
#### PATH:
{project}/docs/conf.py
#### SEE ALSO:
https://docs.releng.linuxfoundation.org/projects/lfdocs-conf/en/latest/config.html
https://www.sphinx-doc.org/en/master/usage/configuration.html
---
## requirements-docs.txt
##### DESCRIPTION:
Contains the required libraries to be used by Sphinx.
#### PATH:
{project}/etc/requirements-docs.txt
---
## .readthedocs.yaml
##### DESCRIPTION:
Required to customize the ReadTheDocs input and output behavior. **Important:** This file is located in your {project} root directory (e.g. *doc/.readthedocs.yaml*).
#### PATH:
{project}/.readthedocs.yaml
---
## tox.ini
##### DESCRIPTION:
Required to customize different tox environments.
#### PATH:
{project}/tox.ini
##### SEE ALSO:
https://tox.wiki/en/latest/config.html
---
## index.rst
##### DESCRIPTION:
The reStructuredText Cheat Sheet as an example .rst file
|
