summaryrefslogtreecommitdiffstats
path: root/docs/guide
diff options
context:
space:
mode:
authorRich Bennett <rb2745@att.com>2017-09-13 07:00:23 +0000
committerGerrit Code Review <gerrit@onap.org>2017-09-13 07:00:23 +0000
commita7f9e351a97b5b5b89e4e1eccd201a3e15e8f385 (patch)
tree45e92a0513ecd9baa80049a9f36ae6e45cd38279 /docs/guide
parentae9719ccdaf5cb08347b5300dbd5df2a194f6648 (diff)
parenta10d3f52d0c791a1be7aaed1e2b1ad3151cdb4d5 (diff)
Merge "Added index creation docs to addendum"
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
------------