• Document Up to Date

Documentation Standard

Please view the source of this document to view and follow the template.

Text

Style

monospaced text is done using

``monospace``

italics are done using

*italics*

And finally bold using

**bold**

Anchors

.. _documentation-templates:

Titles, Sections, sub-sections, and sub-subsections

# with overline, for parts

* with overline, for chapters

= for sections

- for subsections

^ for subsubsections

" for paragraphs

Of course, you are free to use your own marker characters (see the reST documentation), and use a deeper nesting level, but keep in mind that most target formats (HTML, LaTeX) have a limited supported nesting depth.

For example

#####
Title
#####

Text...

*******
Heading
*******

Text...

Section
=======

Text...

Sub-section
-----------

Text...

Sub-sub-section
^^^^^^^^^^^^^^^

Text...

Paragraph
"""""""""

Text...

Images and Figures

Image

We recommend uploaded images be no wider than 1280px.

.. image:: /_static/images/admin-console-link.webp
        :width: 25%
        :alt: Admin Console Link
        :align: center

Figure

.. figure:: /_static/images/create-content-type-3.webp
        :alt: Properties Explorer
        :align: center

Bullets and Numbering

Bullets

* lorem ipsum
* lorem ipsum
* lorem ipsum

Numbered bullets

#. lorem ipsum
#. lorem ipsum
#. lorem ipsum

Notes, Todos and Warnings

.. note:: Important note
.. seealso:: See also this :math:`\alpha`
.. todo:: Todo
.. warning:: Warning!

Tables

Simple Tables

Note

The number of characters per line is no more than 99. Please copy the template and start with it and don’t make the lines any longer.

=============== =================================================================================
Short Column    Long Column
=============== =================================================================================
Row 1 Column 1  Row 1 Column 2

Row 2 Column 1  Row 2 Column 2
=============== =================================================================================

Complex Tables

Note

The number of characters per line is no more than 99. Please copy the template and start with it and don’t make the lines any longer.

+-----------------+------------------------------------------------------------------------------+
|| Short Column   || Long Column                                                                 |
|| (More stuff)   ||                                                                             |
+-----------------+------------------------------------------------------------------------------+
|| Row 1 Column 1 || Row 1 Column 2 Line 1                                                       |
||                || Row 1 Column 2 Line 2                                                       |
+-----------------+                                                                              |
|| Row 2 Column 1 || Row 1 Column 2 Line 3 (merged cell)                                         |
+-----------------+------------------------------------------------------------------------------+

Code Blocks

HTML

.. code-block:: html

<#import "/templates/system/common/cstudio-support.ftl" as studio />

<!DOCTYPE html>
<html lang="en">
    <head>
        <!-- Basic Page Need
            ================================================== -->
            <meta charset="utf-8">
            <title>${contentModel.browser_title}</title>
            <meta name="description" content="${contentModel.meta_description}">
            <meta name="keywords" content="${contentModel.meta_keywords}">
        </head>
        <body>
             <div class="body" <@studio.iceAttr iceGroup="body"/>>
                  ${contentModel.body_html}
             </div>

             <#if (contentModel.analytics_script)??>${contentModel.analytics_script}</#if>
        </body>
</html>

Groovy

.. code-block:: groovy

        import org.craftercms.engine.service.context.SiteContext

        import utils.DateUtils

        def now = DateUtils.formatDateAsIso(new Date())
        def start = 0
        def rows = 1000
        def sort = "date_dt asc"
        def query = searchService.createQuery()

        query.setQuery(queryStr)

        def events = []
        if (searchResults.response) {
                searchResults.response.documents.each {
                        events.add(event)
                }
        }

        contentModel.events = events

Include Another Document

.. include:: ../includes/unicode-checkmark.rst