Directives

Directives are explicit markup blocks. These are syntax elements that affect an entire paragraph.

Structure

Principle

+-----+-----------------------------+
|".. "|directive type"::" directive |
+-----+block                        |
      |                             |
      +-----------------------------+

A blank line is required between a directive and a preceding text body element (for example, a paragraph with text). A blank line between directives is optional.

Sample:

Paragraph

.. image:: C:\Tc3LibDocImages\SampleLib1\img11.jpg
.. image:: C:\Tc3LibDocImages\SampleLib1\img12.jpg

Use

The following text elements can be created using directives:

Use

Sample

Specific notes

.. note::

Generic notes

.. admonition:: Title

Images

.. image:: C:\Users\SampleUser\Documents\LibraryDocumentationpicture.png
   :height: 100 px
   :width: 200 px

Codeblock

.. code::

   Code block

CSV table

.. csv-table:: Table
   :header: "Column 1", "Column 2"
   :widths: 50, 50

   "Line 1.1","Line 1.2"

List table

.. list-table:: Table
   :widths: 50 50
   :header-rows: 1

   * - Column 1
     - Column 2
   * - Line 1.1
     - Line 1.2