diff --git a/docs/conf.py b/docs/conf.py index 9031dfd8c5..520ff4791e 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -22,7 +22,9 @@ import mayan # If extensions (or modules to document with autodoc) are in another directory, # add these directories to sys.path here. If the directory is relative to the # documentation root, use os.path.abspath to make it absolute, like shown here. -sys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__), "_ext"))) +sys.path.append( + os.path.abspath(os.path.join(os.path.dirname(__file__), '_ext')) +) # -- General configuration ----------------------------------------------------- @@ -34,12 +36,13 @@ sys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__), "_ext")) #extensions = ['sphinx.ext.autodoc', 'sphinx.ext.viewcode'] #extensions = ["djangodocs", "sphinx.ext.intersphinx"] extensions = [ - 'sphinx.ext.extlinks', 'sphinxcontrib.blockdiag', 'sphinxcontrib.spelling' + 'sphinx.ext.extlinks', 'sphinxcontrib.blockdiag', + 'sphinxcontrib.spelling' ] blockdiag_antialias = True -blockdiag_html_image_format = "SVG" -blockdiag_latex_image_format = "PDF" +blockdiag_html_image_format = 'SVG' +blockdiag_latex_image_format = 'PDF' # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates'] @@ -106,12 +109,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 = 'classic' +html_theme = 'sphinx_rtd_theme' # Theme options are theme-specific and customize the look and feel of a theme # further. For a list of options available for each theme, see the # documentation. -#html_theme_options = {} +html_theme_options = { + 'analytics_id': 'UA-52965619-6', +} # Add any paths that contain custom themes here, relative to this directory. #html_theme_path = [] @@ -139,7 +144,7 @@ html_static_path = ['_static'] # If not '', a 'Last updated on:' timestamp is inserted at every page bottom, # using the given strftime format. -#html_last_updated_fmt = '%b %d, %Y' +html_last_updated_fmt = '%b %d, %Y' # If true, SmartyPants will be used to convert quotes and dashes to # typographically correct entities. @@ -162,7 +167,7 @@ html_static_path = ['_static'] #html_split_index = False # If true, links to the reST sources are added to the pages. -#html_show_sourcelink = True +html_show_sourcelink = False # If true, "Created using Sphinx" is shown in the HTML footer. Default is True. #html_show_sphinx = True @@ -181,8 +186,6 @@ html_static_path = ['_static'] # Output file base name for HTML help builder. htmlhelp_basename = 'MayanEDMSdoc' -html_show_sourcelink = False - html_show_sphinx = False # -- Options for LaTeX output -------------------------------------------------- @@ -233,8 +236,6 @@ man_pages = [ [mayan.__author__], 1) ] -html_theme = 'sphinx_rtd_theme' - # -- External links -- extlinks = { 'django-docs': ( @@ -253,5 +254,6 @@ extlinks = { ) } + def setup(app): app.add_stylesheet('css/custom.css')