1 # -*- coding: utf-8 -*-
3 # Copyright (c) 2019, Arm Limited. All rights reserved.
5 # SPDX-License-Identifier: BSD-3-Clause
8 # Configuration file for the Sphinx documentation builder.
10 # See the options documentation at http://www.sphinx-doc.org/en/master/config
14 # -- Project information -----------------------------------------------------
16 project
= 'Trusted Firmware-A'
18 # -- General configuration ---------------------------------------------------
20 # Add any Sphinx extension module names here, as strings. They can be
21 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
23 extensions
= ['sphinx.ext.autosectionlabel', 'sphinxcontrib.plantuml']
25 # Add any paths that contain templates here, relative to this directory.
26 templates_path
= ['_templates']
28 # The suffix(es) of source filenames.
29 source_suffix
= '.rst'
31 # The master toctree document.
34 # The language for content autogenerated by Sphinx. Refer to documentation
35 # for a list of supported languages.
37 # This is also used if you do content translation via gettext catalogs.
38 # Usually you set "language" from the command line for these cases.
41 # List of patterns, relative to source directory, that match files and
42 # directories to ignore when looking for source files.
43 # This pattern also affects html_static_path and html_extra_path .
46 # The name of the Pygments (syntax highlighting) style to use.
47 pygments_style
= 'sphinx'
49 # Load the contents of the global substitutions file into the 'rst_prolog'
50 # variable. This ensures that the substitutions are all inserted into each page.
51 with
open('global_substitutions.txt', 'r') as subs
:
52 rst_prolog
= subs
.read()
54 # Minimum version of sphinx required
57 # -- Options for HTML output -------------------------------------------------
59 # Don't show the "Built with Sphinx" footer
60 html_show_sphinx
= False
62 # Don't show copyright info in the footer (we have this content in the page)
63 html_show_copyright
= False
65 # The theme to use for HTML and HTML Help pages. See the documentation for
66 # a list of builtin themes.
67 html_theme
= "sphinx_rtd_theme"
69 # The logo to display in the sidebar
70 html_logo
= 'resources/TrustedFirmware-Logo_standard-white.png'
72 # Options for the "sphinx-rtd-theme" theme
73 html_theme_options
= {
74 'collapse_navigation': False, # Can expand and collapse sidebar entries
75 'prev_next_buttons_location': 'both', # Top and bottom of the page
76 'style_external_links': True # Display an icon next to external links
79 # -- Options for autosectionlabel --------------------------------------------
81 # Only generate automatic section labels for document titles
82 autosectionlabel_maxdepth
= 1
84 # -- Options for plantuml ----------------------------------------------------
86 plantuml_output_format
= 'svg_img'