1. basics
1.1. headings
Title
=====
Section
-------
Subsection
~~~~~~~~~~
1.2. inline markup
italic *text* for emphasis
boldface **text** for strong emphasis
backquote ``text`` for code samples
1.3. lists
1.3.1. bullet list
- available signs: + - *
- nested lists must be seperated
- by an empty line
- and here the parent list continues
- available signs: + - *
- nested lists must be seperated
- by an empty line
- and here the parent list continues
1.3.2. number list
- auto numbering is feasible
- using prefix sign '#'
#. auto numbering is feasible
#. using prefix sign '#'
1.3.3. definition list
- term(up to a line)
- Definition must be indented and multiple paragraphs are possible
- detergent
- a chemical liquid or powder for cleaning
term
Definition must be indented
and multiple paragraphs are possible
detergent
a chemical liquid or powder for cleaning
1.3.4. fields lists
| fieldname: | Field Content |
|---|
:fieldname: Field Content
def my_function(my_arg, my_other_arg):
"""A function just for me.
:param my_arg: The first of my arguments.
:param my_other_arg: The second of my arguments.
:returns: A message (just for me, of course).
"""
1.4. line blocks
prefix every line with | to preserve line breaks
These lines are
broken exactly like in
the source file
| These lines are
| broken exactly like in
| the source file
1.5. tables
1.5.1. grid table
For grid tables, grid cells must be painted manually.
| Header row, column 1 (header rows optional) | Header 2 | Header 3 | Header 4 |
|---|---|---|---|
| body row 1, column 1 | column 2 | column 3 | column 4 |
| body row 2 | ... | ... |
+------------------------+------------+----------+----------+
| Header row, column 1 | Header 2 | Header 3 | Header 4 |
| (header rows optional) | | | |
+========================+============+==========+==========+
| body row 1, column 1 | column 2 | column 3 | column 4 |
+------------------------+------------+----------+----------+
| body row 2 | ... | ... | |
+------------------------+------------+----------+----------+
1.5.2. simple table
| A | B | A and B |
|---|---|---|
| T | F | F |
| F | T | F |
| T | T | T |
| F | F | F |
=== === =======
A B A and B
=== === =======
T F F
F T F
T T T
F F F
=== === =======
1.6. hyper link
`Link Text <https://example.com>`_
`Another Link Text`_
.. _Another Link Text: https://example.com
1.7. code blocks
.. code-block:: python
import sys
print(sys.executable)
1.8. images
.. image:: /path/to/image.png
:alt: Alternative Text is useful to those who probably lose image