summaryrefslogtreecommitdiffstats
path: root/docs/guide
diff options
context:
space:
mode:
authorSpencer Seidel <jsseidel@fastmail.com>2017-09-07 13:58:17 -0400
committerSpencer Seidel <jsseidel@fastmail.com>2017-09-07 13:58:40 -0400
commita10d3f52d0c791a1be7aaed1e2b1ad3151cdb4d5 (patch)
treedbcdc1d1d0b3afac6902d8b9009333527c830768 /docs/guide
parent2d33816c5c9298963a7c4d3ebcefb6281be7b4ec (diff)
Added index creation docs to addendum
Added a section to the addendum in the how-to docs on how to build indices in Sphinx. Change-Id: Ib0a64c188f8942f5eb45cafae0d9685285eff855 Issue-ID: DOC-75 Signed-off-by: Spencer Seidel <jsseidel@fastmail.com>
Diffstat (limited to 'docs/guide')
-rw-r--r--docs/guide/onap-developer/how-to-use-docs/addendum.rst45
1 files changed, 45 insertions, 0 deletions
diff --git a/docs/guide/onap-developer/how-to-use-docs/addendum.rst b/docs/guide/onap-developer/how-to-use-docs/addendum.rst
index f97541730..24cd1c7c8 100644
--- a/docs/guide/onap-developer/how-to-use-docs/addendum.rst
+++ b/docs/guide/onap-developer/how-to-use-docs/addendum.rst
@@ -59,6 +59,51 @@ You can add html content that only appears in html output by using the
.. only:: html
This line will be shown only in html version.
+.. index:: single: indices
+
+Creating Indices
+----------------
+
+Building an index for your Sphinx project is relatively simple. First, tell Sphinx that
+you want it to build an index by adding something like this after your TOC tree:
+
+.. code-block:: rst
+
+ Indices and Search
+ ==================
+
+ * :ref:`genindex`
+ * :ref:`search`
+
+**Hint:**
+Note that search was included here. It works out of the box with any Sphinx project, so you
+don't need to do anything except include a reference to it in your :code:`index.rst` file.
+
+Now, to generate a index entry in your RST, do one of the following:
+
+.. code-block:: rst
+
+ Some content that requires an :index:`index`.
+
+or
+
+.. code-block:: rst
+
+ .. index::
+ single: myterm
+
+ Some header containing myterm
+ =============================
+
+In the second case, Sphinx will create a link in the index to the paragraph that follows
+the index entry declaration.
+
+When your project is built, Sphinx will generate an index page populated with the entries
+you created in the source RST.
+
+These are simple cases with simple options. For more information about indexing with Sphinx,
+please see the `official Sphinx documentation <http://www.sphinx-doc.org/en/stable/markup/misc.html#directive-index>`_.
+
Jenkins Jobs
------------