sphinx-opnfv-theme 0.1.0

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::

# 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