Apply openstackdocstheme for fuel development docs

Switch docs to using 'openstackdocs' theme according to [1].

1 git.openstack.org/cgit/openstack/openstackdocstheme/tree/README.rst

Change-Id: Iee596f66ff3eb44a9b3d29ac849b1a8684b4ad9a
Implements: blueprints.launchpad.net/fuel/+spec/fuel-docs-migration
This commit is contained in:
Dzmitry Moisa 2016-03-31 20:03:31 +03:00
parent 931509ef44
commit 338a5020ce
2 changed files with 20 additions and 6 deletions

24
conf.py
View File

@ -13,7 +13,8 @@
import os
import sys
import oslosphinx
import subprocess
import openstackdocstheme
sys.path.insert(0, os.path.join(os.path.abspath('.')))
@ -34,7 +35,6 @@ autodoc_member_order = 'bysource'
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
extensions = [
'sphinx.ext.autodoc',
'oslosphinx',
'rst2pdf.pdfbuilder'
]
@ -100,14 +100,14 @@ pygments_style = 'sphinx'
# The theme to use for HTML and HTML Help pages. See the documentation for
# a list of builtin themes.
#html_theme = 'oslosphinx'
html_theme = 'openstackdocs'
# Theme options are theme-specific and customize the look and feel of a theme
# documentation.
#html_theme_options = {}
# Add any paths that contain custom themes here, relative to this directory.
#html_theme_path = []
html_theme_path = [openstackdocstheme.get_html_theme_path()]
# The name for this set of Sphinx documents. If None, it defaults to
# "<project> v<release> documentation".
@ -253,6 +253,20 @@ texinfo_documents = [(
# How to display URL addresses: 'footnote', 'no', or 'inline'.
#texinfo_show_urls = 'footnote'
# -- Additional Settings ------------------------------------------------------
oslosphinx_cgit_link = 'https://github.com/openstack/fuel-docs'
# The variables to make "Log a bug" link send
# metadata for the project where the docs reside:
# We ask git for the SHA checksum
# The git SHA checksum is used by "log-a-bug"
git_cmd = ["/usr/bin/git", "rev-parse", "HEAD"]
gitsha = subprocess.Popen(git_cmd, stdout=subprocess.PIPE).communicate()[0].strip('\n')
# tag that reported bugs will be tagged with
bug_tag = ""
# source tree
pwd = os.getcwd()
# html_context allows us to pass arbitrary values into the html template
html_context = {"pwd": pwd, "gitsha": gitsha}
# Must set this variable to include year, month, day, hours, and minutes.
html_last_updated_fmt = '%Y-%m-%d %H:%M'
execfile('./common_conf.py')

View File

@ -3,4 +3,4 @@ rst2pdf
funcparserlib
webcolors
beautifulsoup4==4.4.0
oslosphinx
openstackdocstheme