mirror of
https://github.com/clearlinux/clear-linux-documentation.git
synced 2026-09-08 06:42:16 +00:00
Kristal Dale
1e2b3fdfa4
-Replace instances of CLOSIA substitution with CL-ATTR. -Replace in-line use of Clear Linux with CL. -Clean up white space. -Limited clean up in collab section, in pref of future rework -Set landing page toctree to use maxdepth 1 Signed-off-by: Kristal Dale <kristal.dale@intel.com>
50 lines
1.4 KiB
ReStructuredText
50 lines
1.4 KiB
ReStructuredText
.. _rest:
|
|
|
|
RestructuredText guide
|
|
######################
|
|
|
|
.. incl-restructured-text-overview:
|
|
|
|
Overview
|
|
********
|
|
|
|
The |CL-ATTR| uses Sphinx and RestructuredText as authoring tools for its
|
|
documentation. This section contains the preferred methods for using the
|
|
:abbr:`ReST (RestructuredText)` markup on your documents. Please refer to the
|
|
`Sphinx documentation`_ for the complete list of available markup and use
|
|
as much markup as possible.
|
|
|
|
.. _Sphinx documentation: http://www.sphinx-doc.org/en/master/usage/restructuredtext/index.html
|
|
|
|
Remember: **Changing incorrect markup is easier than adding markup from
|
|
scratch.**
|
|
|
|
We provide templates, examples, and use scenarios to help you write and edit
|
|
documents easily. Use only the templates provided to ensure your content is
|
|
consistent with the rest of the documentation.
|
|
|
|
Contributions with incorrect use of markup will not be merged until the
|
|
markup is fixed. If you have any questions regarding markup, send an email to
|
|
our mailing list at dev@lists.clearlinux.org and we will gladly help.
|
|
|
|
To allow for easy copy and paste of the provided templates,
|
|
they are provided using either the "\`\`" parenthesis, for single line
|
|
templates, or the code-block directive, for multi-lined templates.
|
|
|
|
Every use case is explained, examples provided and, lastly,
|
|
templates supplied.
|
|
|
|
.. incl-restructured-text-overview-end:
|
|
|
|
.. toctree::
|
|
:maxdepth: 3
|
|
|
|
headings
|
|
inline
|
|
tables
|
|
cross
|
|
images
|
|
code
|
|
contents
|
|
|