ENH: use imgmath for rendering math formula

Documentation/Cookbook/CMakeLists.txt

@@ -18,16 +18,13 @@ else()
   return()
 endif()
 
-set(OTB_PYTHONPATH)
-if( EXISTS "${OTB_DIR}/CMakeCache.txt" )
-  set(OTB_INSTALL_PREFIX ${OTB_DIR})
-  set(OTB_PYTHONPATH "${OTB_INSTALL_PREFIX}/Modules/Wrappers/SWIG/src")
-elseif( EXISTS "${OTB_DIR}/UseOTB.cmake" )
-  get_filename_component(OTB_INSTALL_PREFIX ${OTB_DIR} PATH)
-  get_filename_component(OTB_INSTALL_PREFIX ${OTB_INSTALL_PREFIX} PATH)
-  get_filename_component(OTB_INSTALL_PREFIX ${OTB_INSTALL_PREFIX} PATH)
-  set(OTB_PYTHONPATH "${OTB_INSTALL_PREFIX}/lib/otb/python")
-endif()
+get_filename_component(OTB_INSTALL_PREFIX ${OTB_MODULES_DIR} PATH)
+get_filename_component(OTB_INSTALL_PREFIX ${OTB_INSTALL_PREFIX} PATH)
+get_filename_component(OTB_INSTALL_PREFIX ${OTB_INSTALL_PREFIX} PATH)
+
+message(STATUS "OTB_PYTHONPATH='${OTB_PYTHONPATH}'")
+message(STATUS "OTB_APPLICATION_PATH='${OTB_APPLICATION_PATH}'")
+message(STATUS "OTB_INSTALL_PREFIX='${OTB_INSTALL_PREFIX}'")
 
 #find Python
 find_package(PythonInterp REQUIRED)
@@ -137,12 +134,19 @@ add_custom_target(CookBookHTMLFromRST
   DEPENDS generate_otbapps_rst
   COMMENT "Building RST documentation in html")
 
-find_program(TAR_COMMAND
-  NAMES tar
-  PATHS /usr/bin
-)
+find_program(TAR_COMMAND NAMES tar)
 mark_as_advanced(TAR_COMMAND)
 
+find_program(PDFLATEX_COMMAND  NAMES pdflatex )
+mark_as_advanced(PDFLATEX_COMMAND)
+
+find_program(LATEX_COMMAND NAMES latex)
+mark_as_advanced(LATEX_COMMAND)
+
+if(NOT LATEX_COMMAND)
+  message(FATAL_ERROR "latex command not found. please add it to your path")
+endif()
+
 if(TAR_COMMAND)
   add_custom_target(CookBookArchive
     ALL
@@ -154,12 +158,6 @@ if(TAR_COMMAND)
     COMMENT "Creating archive for html CookBook")
 endif()
 
-find_program(PDFLATEX_COMMAND
-  NAMES pdflatex
-  PATHS /usr/bin
-)
-mark_as_advanced(PDFLATEX_COMMAND)
-
 if(PDFLATEX_COMMAND)
   add_custom_target(CookBookPDFFromRST
     ALL
@@ -167,4 +165,5 @@ if(PDFLATEX_COMMAND)
     WORKING_DIRECTORY ${RST_GENERATED_SOURCE_DIR}
     DEPENDS generate_otbapps_rst
     COMMENT "Building RST documentation in pdf")
+  
 endif()

Documentation/Cookbook/rst/Makefile.in

@@ -7,10 +7,6 @@ SPHINXBUILD   = sphinx-build
 PAPER         =
 BUILDDIR      = @RST_BUILD_DIR@
 
-# User-friendly check for sphinx-build
-ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
-$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
-endif
 
 # Internal variables.
 PAPEROPT_a4     = -D latex_paper_size=a4

Documentation/Cookbook/rst/conf.py.in

@@ -14,7 +14,12 @@
 
 import sys
 import os
-import sphinx_rtd_theme
+HAVE_RTD_THEME=False
+try:
+    import sphinx_rtd_theme
+    HAVE_RTD_THEME=True
+except:
+    pass
 
 # 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
@@ -31,10 +36,12 @@ import sphinx_rtd_theme
 # ones.
 extensions = [
     'sphinx.ext.todo',
-    'sphinx.ext.mathjax',
+    'sphinx.ext.imgmath',
     'sphinx.ext.viewcode',
 ]
 
+imgmath_latex='@LATEX_COMMAND@'
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
@@ -104,15 +111,17 @@ pygments_style = 'sphinx'
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'sphinx_rtd_theme'
-
+if HAVE_RTD_THEME:
+    html_theme = 'sphinx_rtd_theme'
+    # Add any paths that contain custom themes here, relative to this directory.
+    html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
+    
 # 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 = {}
 
-# Add any paths that contain custom themes here, relative to this directory.
-html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
+
 
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".
@@ -165,13 +174,13 @@ 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 = True
 
 # If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
-#html_show_sphinx = True
+html_show_sphinx = True
 
 # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
-#html_show_copyright = True
+html_show_copyright = True
 
 # If true, an OpenSearch description file will be output, and all pages will
 # contain a <link> tag referring to it.  The value of this option must be the