Adds :contents: directive to Clear Linux collaboration guide.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
This commit is contained in:
Michael Vincerra
2018-07-11 17:09:18 -07:00
parent dada6c0a4f
commit bdfa11846e
2 changed files with 41 additions and 0 deletions
@@ -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: