1
|
|
|
# Configuration file for the Sphinx documentation builder. |
2
|
|
|
# |
3
|
|
|
# This file only contains a selection of the most common options. For a full |
4
|
|
|
# list see the documentation: |
5
|
|
|
# https://www.sphinx-doc.org/en/master/usage/configuration.html |
6
|
|
|
|
7
|
|
|
# -- Path setup -------------------------------------------------------------- |
8
|
|
|
|
9
|
|
|
# If extensions (or modules to document with autodoc) are in another directory, |
10
|
|
|
# add these directories to sys.path here. If the directory is relative to the |
11
|
|
|
# documentation root, use os.path.abspath to make it absolute, like shown here. |
12
|
|
|
# |
13
|
|
|
import os |
14
|
|
|
import sys |
15
|
|
|
import sphinx_rtd_theme |
16
|
|
|
sys.path.insert(0, os.path.abspath('..')) |
17
|
|
|
sys.path.append(os.path.abspath('exts')) |
18
|
|
|
|
19
|
|
|
# -- Project information ----------------------------------------------------- |
20
|
|
|
|
21
|
|
|
project = 'OpenSCAP Report Generator' |
22
|
|
|
copyright = 'OpenSCAP' |
23
|
|
|
author = 'OpenSCAP' |
24
|
|
|
|
25
|
|
|
|
26
|
|
|
# -- General configuration --------------------------------------------------- |
27
|
|
|
|
28
|
|
|
# Add any Sphinx extension module names here, as strings. They can be |
29
|
|
|
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom |
30
|
|
|
# ones. |
31
|
|
|
extensions = [ |
32
|
|
|
'sphinx_rtd_theme', |
33
|
|
|
'sphinxarg.ext', |
34
|
|
|
'sphinx.ext.autodoc', |
35
|
|
|
] |
36
|
|
|
|
37
|
|
|
# Prefix document path to section labels, otherwise autogenerated labels would look like 'heading' |
38
|
|
|
# rather than 'path/to/file:heading' |
39
|
|
|
autosectionlabel_prefix_document = True |
40
|
|
|
|
41
|
|
|
# Add any paths that contain templates here, relative to this directory. |
42
|
|
|
# templates_path = ['_templates'] |
43
|
|
|
|
44
|
|
|
# List of patterns, relative to source directory, that match files and |
45
|
|
|
# directories to ignore when looking for source files. |
46
|
|
|
# This pattern also affects html_static_path and html_extra_path. |
47
|
|
|
exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store'] |
48
|
|
|
|
49
|
|
|
|
50
|
|
|
# -- Options for HTML output ------------------------------------------------- |
51
|
|
|
|
52
|
|
|
# The theme to use for HTML and HTML Help pages. See the documentation for |
53
|
|
|
# a list of builtin themes. |
54
|
|
|
# |
55
|
|
|
html_theme = 'sphinx_rtd_theme' |
56
|
|
|
|
57
|
|
|
man_pages = [('oscap-report.8', 'oscap-report', '', '', 8)] |
58
|
|
|
|
59
|
|
|
|
60
|
|
|
# Add any paths that contain custom static files (such as style sheets) here, |
61
|
|
|
# relative to this directory. They are copied after the builtin static files, |
62
|
|
|
# so a file named "default.css" will overwrite the builtin "default.css". |
63
|
|
|
# html_static_path = ['_static'] |
64
|
|
|
source_suffix = ['.rst', '.md'] |
65
|
|
|
|