summaryrefslogtreecommitdiffstats
path: root/opnfv-theme/README.rst
diff options
context:
space:
mode:
authorTrevor Bramwell <tbramwell@linuxfoundation.org>2018-02-02 12:16:52 -0800
committerRyota MIBU <r-mibu@cq.jp.nec.com>2018-02-06 10:42:15 +0900
commitc1cbdfaf687437baba73fbbe5551907b6913f0a4 (patch)
treef95736a6c6af21304ed1dc7677c845559fd87bbe /opnfv-theme/README.rst
parentfb7da06424c1a12ca0f2e1a2c4f1dd99f0adbb51 (diff)
OPNFV Sphinx Theme
This is a standalone theme for OPNFV docs based on the Sphinx Bootstrap Theme used in opnfvdocs. Change-Id: Ie145c0dc9c1e4c1ed0d8d72d687524b4ef5883de Signed-off-by: Trevor Bramwell <tbramwell@linuxfoundation.org>
Diffstat (limited to 'opnfv-theme/README.rst')
-rw-r--r--opnfv-theme/README.rst48
1 files changed, 48 insertions, 0 deletions
diff --git a/opnfv-theme/README.rst b/opnfv-theme/README.rst
new file mode 100644
index 000000000..484a7a793
--- /dev/null
+++ b/opnfv-theme/README.rst
@@ -0,0 +1,48 @@
+OPNFV Documentation Theme
+=========================
+
+This theme is used for all OPNFV documentation and is released seperatly
+from the documentation itself. It's and extention of the `Sphinx
+Bootstrap Theme`_
+
+Installation
+------------
+
+Here's how to install the theme from PyPI_
+
+To install and configure the theme do the following.
+
+#. Install the theme from pypi::
+
+ $ pip install sphinx_opnfv_theme
+
+#. Configure Sphinx to use the theme:
+
+.. code-block:: python
+
+ # conf.py
+ import sphinx_opnfv_theme
+
+ # ...
+
+ html_theme = 'opnfv'
+ html_theme_path = sphinx_opnfv_theme.get_html_theme_path()
+
+Customization
+-------------
+
+There are no customization specific to this theme yet, but all
+all customizations_ Sphinx Bootstrap Theme are supported.
+
+If you'd like your documentation to match OPNFV's style configure the
+following options for the bootstrap theme::
+
+ html_theme_options = {
+ 'bootswatch_theme': 'journal',
+ 'navbar_sidebarrel': false,
+ 'navbar_title': '',
+ }
+
+.. _Sphinx Bootstrap Theme: https://github.com/ryan-roemer/sphinx-bootstrap-theme
+.. _Pypi: http://pypi.python.org/pypi/sphinx-opnfv-theme/
+.. _customizations: https://github.com/ryan-roemer/sphinx-bootstrap-theme#customization