From a10d3f52d0c791a1be7aaed1e2b1ad3151cdb4d5 Mon Sep 17 00:00:00 2001 From: Spencer Seidel Date: Thu, 7 Sep 2017 13:58:17 -0400 Subject: [PATCH] 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 --- .../onap-developer/how-to-use-docs/addendum.rst | 45 ++++++++++++++++++++++ 1 file changed, 45 insertions(+) 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 `_. + Jenkins Jobs ------------ -- 2.16.6