mirror of
https://github.com/clearlinux/clear-linux-documentation.git
synced 2026-07-11 23:27:24 +00:00
Adds :contents: directive to Clear Linux collaboration guide.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
This commit is contained in:
@@ -0,0 +1,40 @@
|
||||
.. _contents:
|
||||
|
||||
|
||||
Contents directive
|
||||
##################
|
||||
|
||||
For |CL| documentation that has three or more sections, use the `contents:`
|
||||
directive as shown in the example below. This directive automatically captures the headings (and
|
||||
subheadings if used) as specified in the value given after `:depth:`. Adding this directive to
|
||||
longer documents allows users to quickly navigate to the desired section.
|
||||
|
||||
.. contents: :local:
|
||||
:depth: 2
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
.. contents: :local:
|
||||
:depth: 2
|
||||
|
||||
.. note::
|
||||
|
||||
Assure that you add `:local:` as the value. For more resources on this directive,
|
||||
visit the `reStruturedText Directives`_
|
||||
|
||||
EXAMPLE:
|
||||
|
||||
Clear Linux Guide Example
|
||||
*************************
|
||||
|
||||
Introduction
|
||||
=========
|
||||
|
||||
Step-by-Step
|
||||
============
|
||||
|
||||
Launch
|
||||
======
|
||||
|
||||
|
||||
.. _reStruturedText Directives: http://docutils.sourceforge.net/0.4/docs/ref/rst/directives.html#table-of-contents
|
||||
@@ -36,6 +36,7 @@ templates supplied.
|
||||
cross
|
||||
images
|
||||
code
|
||||
contents
|
||||
|
||||
|
||||
.. _Sphinx documentation:
|
||||
|
||||
Reference in New Issue
Block a user