9.11. Sphinx style guide¶

9.11.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)

9.11.2. Styles¶

**Bold text**
*Italic text*
``Inline literal/code``
:sup:`super`\ Script
:sub:`sub`\ Script

Bold text
Italic text
Inline literal/code
superScript
subScript

9.11.3. Bullet Lists¶

* Unordered item
* Unordered item

    #. Nestes ordered item
    #. Nestes ordered item

        #. Nested ordered item

* Unordered item

Unordered item
Unordered item
1. Nestes ordered item
2. Nestes ordered item
  Nested ordered item
Unordered item

9.11.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>`_

[cit1]

A global citation

External link
External link name
Example Text
External link by ref

Anchor link by text
Anchor
Anchor by ref
Anchor

Reference a footnote [1]

Reference a global citation [cit1]

9.11.4.1. Section Heading¶

Link

9.11.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

9.11.5.1. Grid table¶

Grid table	Header 2	Header 3
Column 1	Column 2	Vertical column span
Horizontal span		Vertical column span

9.11.5.2. Simple table¶

Simple table	Header 2	Header 3
Column 1	Column 2	Column 3
Horizontal column span		…
…	…	…

9.11.5.3. CSV table¶

table title¶
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

9.11.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>`_

9.11.6.1. Image¶

9.11.6.2. Figure¶

Figure caption figure-name or Example

9.11.7. Comments¶

.. comment
    This is a comment

9.11.8. Directives¶

.. directive:: argument
    :option: value

    Directive content

9.11.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

9.11.9.1. Table of Contents (this document)¶

9.11.10. Content Block Directives¶

9.11.10.1. `.. topic::` [title]¶

.. topic:: Topic title

    Topic content

9.11.10.3. `.. admonition::` [title]¶

.. admonition:: Admonition title

    Admonition content

Admonition title

Admonition content

9.11.10.4. `.. attention::`¶

.. attention::

    Attention content

Attention

Attention content

9.11.10.5. `.. caution::`¶

.. caution::

    Caution content

Caution

Caution content

9.11.10.6. `.. danger::`¶

.. danger::

    Danger content

Danger

Danger content

9.11.10.7. `.. error::`¶

.. error::

    Error content

Error

Error content

9.11.10.8. `.. hint::`¶

.. hint::

    Hint content

Hint

Hint content

9.11.10.9. `.. important::`¶

.. important::

    Important content

Important

Important content

9.11.10.10. `.. note::`¶

.. note::

    Note content

Note

Note content

9.11.10.11. `.. tip::`¶

.. tip::

    Tip content

Tip

Tip content

9.11.10.12. `.. warning::`¶

.. warning::

    Warning content

Warning

Warning content

9.11.10.13. `.. seealso::`¶

.. seealso::

    See also content

9.11.10.14. `.. versionadded::` [version]¶

.. versionadded:: 1.0

    Version added content

New in version 1.0: Version added content

9.11.10.15. `.. versionchanged::` [version]¶

.. versionchanged:: 1.0

    Version changed content

Changed in version 1.0: Version changed content

9.11.10.16. `.. deprecated::` [version]¶

.. deprecated:: 1.0

    Deprecated content

Deprecated since version 1.0: Deprecated content

9.11.10.17. `.. math::`¶

.. math::

    \int_{-\infty}^\infty g(x) dx = 1

\[\int_{-\infty}^\infty g(x) dx = 1\]

9.11.10.18. `.. raw::` output format¶

.. raw:: html

    <div>Raw HTML content</div>

Raw HTML content

9.11.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

Code caption¶

// Code example
some_function();
any_var = 42;

// Do another thing
another_function();

.. _tutorial_intro:

Tutorials
#############
*Current status of Q1 2022*


These Tutorials guide you to understand the development process, rules and concepts do embedd your projects to the EVerest enviroment.


.. toctree::
   :maxdepth: 1
   :glob:
   
   */index
   *

9.11. Sphinx style guide¶

9.11.1. Headlines¶

How To: Sphinx (h1)

Headlines (h2)

Headline (h3)

Headline (h4)

Headline (h5)

Headline (h6)

9.11.2. Styles¶

9.11.3. Bullet Lists¶

9.11.4. Targets and Links¶

9.11.4.1. Section Heading¶

9.11.5. Tables¶

9.11.5.1. Grid table¶

9.11.5.2. Simple table¶

9.11.5.3. CSV table¶

9.11.6. Images and Figures¶

9.11.6.1. Image¶

9.11.6.2. Figure¶

9.11.7. Comments¶

9.11.8. Directives¶

9.11.9. Table of Contents¶

9.11.9.1. Table of Contents (this document)¶

9.11.10. Content Block Directives¶

9.11.10.1. .. topic:: [title]¶

9.11.10.2. .. sidebar:: [title]¶

9.11.10.3. .. admonition:: [title]¶

9.11.10.4. .. attention::¶

9.11.10.5. .. caution::¶

9.11.10.6. .. danger::¶

9.11.10.7. .. error::¶

9.11.10.8. .. hint::¶

9.11.10.9. .. important::¶

9.11.10.10. .. note::¶

9.11.10.11. .. tip::¶

9.11.10.12. .. warning::¶

9.11.10.13. .. seealso::¶

9.11.10.14. .. versionadded:: [version]¶

9.11.10.15. .. versionchanged:: [version]¶

9.11.10.16. .. deprecated:: [version]¶

9.11.10.17. .. math::¶

9.11.10.18. .. raw:: output format¶