7.8. Sphinx style guide¶
7.8.1. Headlines¶
Example:
###################
How To: Sphinx (h1)
###################
**************
Headlines (h2)
**************
Headline (h3)
=============
Headline (h4)
-------------
Headline (h5)
^^^^^^^^^^^^^
Headline (h6)
"""""""""""""
Result:
How To: Sphinx (h1)
Headlines (h2)
Headline (h3)
Headline (h4)
Headline (h5)
Headline (h6)
7.8.2. Styles¶
**Bold text**
*Italic text*
``Inline literal/code``
:sup:`super`\ Script
:sub:`sub`\ Script
Inline literal/code
7.8.3. Bullet Lists¶
* Unordered item
* Unordered item
#. Nestes ordered item
#. Nestes ordered item
#. Nested ordered item
* Unordered item
Unordered item
Unordered item
Nestes ordered item
Nestes ordered item
Nested ordered item
Unordered item
7.8.4. Targets and Links¶
.. Anchor target
.. _anchorbyref:
.. _Anchor link by text:
.. External target
.. _external_link_ref: https://example.com
.. _External link name: https://example.com
.. Footnote target
.. [1] footnote text
.. Citation target
.. [cit1] A global citation
.. External links
`External link <https://example.com>`_
`External link name`_
`Example Text <External link name>`_
`External link by ref <external_link_ref>`_
.. Internal links
`Anchor link by text`_
`Anchor <Anchor link by text>`_
`Anchor by ref <anchorbyref>`_
:ref:`Anchor <anchorbyref>`
.. Footnote
Reference a footnote [1]_
.. Citation
Reference a global citation [cit1]_
.. Section Link
Section Heading
===============
`Link <Section Heading>`_
A global citation
Reference a footnote [1]
Reference a global citation [cit1]
7.8.4.1. Section Heading¶
7.8.5. Tables¶
+-----------------+-----------------+-----------------+
| Grid table | Header 2 | Header 3 |
| | | |
+=================+=================+=================+
| Column 1 | Column 2 | Vertical |
+-----------------+-----------------+ column +
| Horizontal span | span |
+-----------------+-----------------+-----------------+
============ ======== ========
Simple table Header 2 Header 3
============ ======== ========
Column 1 Column 2 Column 3
Horizontal column span ...
---------------------- --------
... ... ...
============ ======== ========
.. csv-table:: table title
:header: "Header 1", "Header 2", "Header 3"
:widths: 20, 20, 20
:encoding: utf-8
:header-rows: 1
"Row 1, Column 1", "Row 1, Column 2", "Row 1, Column 3"
"Row 2, Column 1", "Row 2, Column 2", "Row 2, Column 3"
The csv-table
directive can be used to create tables from CSV files:
.. csv-table:: table title
:header: "Header 1", "Header 2", "Header 3"
:widths: 20, 20, 20
:encoding: utf-8
:header-rows: 1
:file: table.csv
7.8.5.1. Grid table¶
Grid table |
Header 2 |
Header 3 |
---|---|---|
Column 1 |
Column 2 |
Vertical column span |
Horizontal span |
7.8.5.2. Simple table¶
Simple table |
Header 2 |
Header 3 |
---|---|---|
Column 1 |
Column 2 |
Column 3 |
Horizontal column span |
… |
|
… |
… |
… |
7.8.5.3. CSV table¶
Header 1 |
Header 2 |
Header 3 |
---|---|---|
Row 1, Column 1 |
Row 1, Column 2 |
Row 1, Column 3 |
Row 2, Column 1 |
Row 2, Column 2 |
Row 2, Column 3 |
7.8.6. Images and Figures¶
Figures are images with captions. They support all image options.
.. image:: image.png
:alt: Image alt text
:width: 150px
:height: 150px
:align: center
:target: target_
.. figure:: image.png
:align: center
:height: 150px
:name: figure-name
Figure caption :figure:`figure-name` or `Example <figure-name>`_
7.8.6.1. Image¶
7.8.6.2. Figure¶
Figure caption figure-name or Example
7.8.8. Directives¶
.. directive:: argument
:option: value
Directive content
7.8.9. Table of Contents¶
.. local table of contents. The ``:local:`` option is optional.
.. contents:: Table of Contents
:local:
:depth: 2
.. defines global structure and includes all sub toc-trees and tocs
Can also be set to visible by omitting the ``:hidden:`` option
.. toc-tree:: Table of Contents
:maxdepth: 2
:numbered:
:hidden:
file.rst
second_file
directory/file
7.8.9.1. Table of Contents (this document)¶
7.8.10. Content Block Directives¶
7.8.10.1. .. topic::
[title]¶
.. topic:: Topic title
Topic content
Topic
Topic content
7.8.10.3. .. admonition::
[title]¶
.. admonition:: Admonition title
Admonition content
Admonition title
Admonition content
7.8.10.4. .. attention::
¶
.. attention::
Attention content
Attention
Attention content
7.8.10.5. .. caution::
¶
.. caution::
Caution content
Caution
Caution content
7.8.10.6. .. danger::
¶
.. danger::
Danger content
Danger
Danger content
7.8.10.7. .. error::
¶
.. error::
Error content
Error
Error content
7.8.10.8. .. hint::
¶
.. hint::
Hint content
Hint
Hint content
7.8.10.9. .. important::
¶
.. important::
Important content
Important
Important content
7.8.10.10. .. note::
¶
.. note::
Note content
Note
Note content
7.8.10.11. .. tip::
¶
.. tip::
Tip content
Tip
Tip content
7.8.10.12. .. warning::
¶
.. warning::
Warning content
Warning
Warning content
7.8.10.13. .. seealso::
¶
.. seealso::
See also content
See also
See also content
7.8.10.14. .. versionadded::
[version]¶
.. versionadded:: 1.0
Version added content
New in version 1.0: Version added content
7.8.10.15. .. versionchanged::
[version]¶
.. versionchanged:: 1.0
Version changed content
Changed in version 1.0: Version changed content
7.8.10.16. .. deprecated::
[version]¶
.. deprecated:: 1.0
Deprecated content
Deprecated since version 1.0: Deprecated content
7.8.10.17. .. math::
¶
.. math::
\int_{-\infty}^\infty g(x) dx = 1
7.8.10.18. .. raw::
output format¶
.. raw:: html
<div>Raw HTML content</div>
7.8.11. Code Examples¶
.. code-block:: python
:linenos:
:emphasize-lines: 2,3
:caption: Code caption
:name: code-name
// Code example
some_function();
any_var = 42;
// Do another thing
another_function();
.. literalinclude:: index.rst
:language: rst
:linenos:
:emphasize-lines: 2-5
:dedent: 4
1// Code example
2some_function();
3any_var = 42;
4
5// Do another thing
6another_function();
1.. _tutorial_intro:
2
3Tutorials
4#############
5*Current status of Q1 2022*
6
7
8These Tutorials guide you to understand the development process, rules and concepts do embedd your projects to the EVerest enviroment.
9
10
11.. toctree::
12 :maxdepth: 1
13 :glob:
14
15 */index
16 *
7.8.7. Comments¶