#12754 fixed i18n accent francais

[tools/sat.git] / doc / src / conf.py

diff --git a/doc/src/conf.py b/doc/src/conf.py
index e7d0be7d39388f0623e394cb7fa1287c64ef7954..3016b642e4589cb2ac7eb743cdde88c19ba848ef 100644 (file)
--- a/doc/src/conf.py
+++ b/doc/src/conf.py
@@ -14,6 +14,23 @@
 import sys
 import os
 
+# Append source folder to path in order to enable autodoc
+currentPath = os.path.dirname(__file__)
+print "sphinx on file", __file__
+dirAutodoc = os.path.realpath(os.path.join(currentPath, '..', '..'))
+print "autodoc on dir", dirAutodoc 
+sys.path.append(dirAutodoc)
+sys.path.append(dirAutodoc + "/commands")
+
+
+# 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.
@@ -202,6 +219,9 @@ latex_elements = {
 
   # Additional stuff for the LaTeX preamble.
   #'preamble': '',
+
+  # http://www.sphinx-doc.org/en/master/latex.html
+  'sphinxsetup': 'verbatimwithframe=false, VerbatimColor={rgb}{.98,.94,.94}',
 }
 
 
@@ -227,10 +247,10 @@ latex_documents = [
 #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 = True
+latex_show_urls = 'footnote' # sphinx version 1.7 # True
 
 # Additional stuff for the LaTeX preamble.
 #latex_preamble = ''
@@ -251,7 +271,4 @@ man_pages = [
      [u'CEA DEN/DANS/DM2S/STMF/LGLS'], 1)
 ]
 
-# Append source folder to path in order to enable autodoc
-currentPath = os.path.dirname(__file__)
-print "file conf.py currentPath", currentPath
-sys.path.append(os.path.join(currentPath, '..', '..'))
+