# -*- coding: utf-8 -*-
#
-# salomeTools documentation build configuration file, created by
-# sphinx-quickstart on Wed Sep 14 11:55:14 2011.
+# sat documentation build configuration file, created by
+# sphinx-quickstart on Fri Apr 13 10:08:59 2018.
#
# This file is execfile()d with the current directory set to its containing dir.
#
import sys
import os
+
+# https://stackoverflow.com/questions/23462494/how-to-add-a-custom-css-file-to-sphinx
+# this needs realpath(custom), cause problem on relocated git clone,
+# so use file link instead in _themes/alabaster: ln -s ../../../../src/custom.css custom.css
+# def setup(app):
+# custom = os.path.join('src', 'custom.css')
+# print "setup add_stylesheet\n %s as\n %s" % (custom, os.path.realpath(custom))
+# app.add_stylesheet(os.path.realpath(custom))
+
# 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.
# Add any Sphinx extension module names here, as strings. They can be extensions
# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ['sphinx.ext.autodoc']
+extensions = ['sphinx.ext.intersphinx', 'sphinx.ext.todo', 'sphinx.ext.mathjax', 'sphinx.ext.viewcode']
-# do not use rst_prolog please
+# do not use rst_prolog please use doc/rst_prolog.rst and '.. include:: ../rst_prolog.rst'
# https://github.com/sphinx-doc/sphinx/issues/2445
# Add any paths that contain templates here, relative to this directory.
# General information about the project.
project = u'salomeTools'
-copyright = u'2010-2018, CEA'
+copyright = u'2019, CEA'
# The version info for the project you're documenting, acts as replacement for
# |version| and |release|, also used in various other places throughout the
# built documents.
#
# The short X.Y version.
-version = '5.0'
+version = '5.4'
# The full version, including alpha/beta/rc tags.
-release = '5.0.0dev'
+release = '5.4.0'
# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
# The theme to use for HTML and HTML Help pages. See the documentation for
# a list of builtin themes.
# default sphinxdoc scrolls agogo traditional nature haiku
-html_theme = 'alabaster'
+html_theme = 'alabaster' #added in _theme dir
# 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 = {
+ #'logo': 'logo.png',
+ #'github_user': 'bitprophet',
+ #'github_repo': 'alabaster',
+ #'description': 'MYYY DESCRIPTION',
+ #'sidebar_includehidden': True,
+ #'sidebar_collapse': True,
+ #'show_powered_by': False,
+ 'show_related': True,
+ 'fixed_sidebar': False,
+ 'page_width': '1000px',
+ 'sidebar_width': '250px',
+ 'font_size': '0.9em', #'1.0625em',
+ 'code_font_size': '0.8em',
+ #'note_bg': '#eee',
+ 'pre_bg': '#fee', # code-block background
+ #'gray_1': '#00f',
+ #'gray_2': '#f00',
+ #'gray_3': '#0f0',
+}
# Add any paths that contain custom themes here, relative to this directory.
html_theme_path = ["../_themes/alabaster", ]
# -- Options for LaTeX output --------------------------------------------------
+latex_elements = {
+ # The paper size ('letterpaper' or 'a4paper').
+ 'papersize': 'a4paper',
+
+ # The font size ('10pt', '11pt' or '12pt').
+ 'pointsize': '10pt',
+
+ # Additional stuff for the LaTeX preamble.
+ #'preamble': '',
+
+ # http://www.sphinx-doc.org/en/master/latex.html
+ 'sphinxsetup': 'verbatimwithframe=false, VerbatimColor={rgb}{.98,.94,.94}',
+}
+
+
# The paper size ('letter' or 'a4').
-latex_paper_size = 'a4'
+#latex_paper_size = 'a4'
# The font size ('10pt', '11pt' or '12pt').
#latex_font_size = '10pt'
# (source start file, target name, title, author, documentclass [howto/manual]).
latex_documents = [
('index', 'salomeTools.tex', u'salomeTools Documentation',
- u'CEA', 'manual'),
+ u'CEA DEN/DANS/DM2S/STMF/LGLS', 'manual'),
]
# The name of an image file (relative to this directory) to place at the top of
#latex_use_parts = False
# If true, show page references after internal links.
-#latex_show_pagerefs = False
+latex_show_pagerefs = True
# If true, show URL addresses after external links.
-#latex_show_urls = False
+latex_show_urls = 'footnote' # sphinx version 1.7 # True
# Additional stuff for the LaTeX preamble.
#latex_preamble = ''
# (source start file, name, description, authors, manual section).
man_pages = [
('index', 'salometools', u'salomeTools Documentation',
- [u'CEA'], 1)
+ [u'CEA DEN/DANS/DM2S/STMF/LGLS'], 1)
]
-# Append source folder to path in order to enable autodoc
-sys.path.append(os.path.join('..'))
+