From 69119810f67bd2a5c51cb61e47d7ce0a009f6bf6 Mon Sep 17 00:00:00 2001 From: Christophe Bourcier Date: Thu, 24 Jan 2019 09:57:53 +0100 Subject: [PATCH] Small fixes in sphinx documentation of python plugins: - remove depedency to babel (only used to generated a date format) - add missing theme - remove warnings --- doc/salome/gui/SMESH/conf.py.in | 2 +- .../MGCleanerPlug/doc/Advanced_params.rst | 3 +- src/Tools/MGCleanerPlug/doc/CMakeLists.txt | 2 +- .../MGCleanerPlug/doc/Generics_params.rst | 14 ++++---- src/Tools/MGCleanerPlug/doc/conf.py.in | 18 ++++++---- src/Tools/MGCleanerPlug/doc/editHypo.rst | 6 ++-- src/Tools/MGCleanerPlug/doc/lct.rst | 4 +-- src/Tools/Verima/Doc/CMakeLists.txt | 2 +- src/Tools/Verima/Doc/conf.py.in | 18 ++++++---- src/Tools/YamsPlug/doc/Advanced_params.rst | 34 +++++++++---------- src/Tools/YamsPlug/doc/CMakeLists.txt | 2 +- src/Tools/YamsPlug/doc/Generics_params.rst | 18 +++++----- src/Tools/YamsPlug/doc/conf.py.in | 18 ++++++---- src/Tools/YamsPlug/doc/editHypo.rst | 6 ++-- src/Tools/YamsPlug/doc/lct.rst | 4 +-- src/Tools/ZCracksPlug/doc/CMakeLists.txt | 2 +- src/Tools/blocFissure/doc/CMakeLists.txt | 2 +- src/Tools/blocFissure/doc/conf.py.in | 6 ++-- 18 files changed, 88 insertions(+), 73 deletions(-) diff --git a/doc/salome/gui/SMESH/conf.py.in b/doc/salome/gui/SMESH/conf.py.in index 535e528f4..d11dbd5c4 100644 --- a/doc/salome/gui/SMESH/conf.py.in +++ b/doc/salome/gui/SMESH/conf.py.in @@ -178,7 +178,7 @@ htmlhelp_basename = 'smeshdoc' # ------------------------ # 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' diff --git a/src/Tools/MGCleanerPlug/doc/Advanced_params.rst b/src/Tools/MGCleanerPlug/doc/Advanced_params.rst index 34178cfd3..8d71500e1 100644 --- a/src/Tools/MGCleanerPlug/doc/Advanced_params.rst +++ b/src/Tools/MGCleanerPlug/doc/Advanced_params.rst @@ -1,7 +1,8 @@ -Advanced Remeshing Options +Advanced Remeshing Options ========================== See tooltips comments for each parameter. + See also :download:`MG-cleaner user manual `. .. image:: images/Advanced.png diff --git a/src/Tools/MGCleanerPlug/doc/CMakeLists.txt b/src/Tools/MGCleanerPlug/doc/CMakeLists.txt index 29993f024..9ad66df95 100755 --- a/src/Tools/MGCleanerPlug/doc/CMakeLists.txt +++ b/src/Tools/MGCleanerPlug/doc/CMakeLists.txt @@ -19,7 +19,7 @@ SALOME_CONFIGURE_FILE(conf.py.in conf.py) -SET(_cmd_options -c ${CMAKE_CURRENT_BINARY_DIR} -b html -d doctrees -D latex_paper_size=a4 ${CMAKE_CURRENT_SOURCE_DIR} docutils) +SET(_cmd_options -c ${CMAKE_CURRENT_BINARY_DIR} -b html -d doctrees ${CMAKE_CURRENT_SOURCE_DIR} docutils) SALOME_GENERATE_ENVIRONMENT_SCRIPT(_cmd env_script "${SPHINX_EXECUTABLE}" "${_cmd_options}") ADD_CUSTOM_TARGET(html_docs_MGCleanerPlug COMMAND ${_cmd}) diff --git a/src/Tools/MGCleanerPlug/doc/Generics_params.rst b/src/Tools/MGCleanerPlug/doc/Generics_params.rst index 45133412c..8da4e2ae9 100644 --- a/src/Tools/MGCleanerPlug/doc/Generics_params.rst +++ b/src/Tools/MGCleanerPlug/doc/Generics_params.rst @@ -1,17 +1,15 @@ -Generic Options -================= +Generic Options +=============== These options are not meshing options but allow the user to configure control parameters for MG-Cleaner. - - **Verbosity Level** -This parameter (between 0 and 10) indicates the amount of information that MG-Cleaner prints during the run. - - -- **File** + This parameter (between 0 and 10) indicates the amount of information that MG-Cleaner prints during the run. + +- **File** -You can change the file used to store your favorite remeshing hypothesis. see paragraph :ref:`hypothesis-label` for further informations. + You can change the file used to store your favorite remeshing hypothesis. see paragraph :ref:`hypothesis-label` for further informations. .. image:: images/Generic.png :align: center diff --git a/src/Tools/MGCleanerPlug/doc/conf.py.in b/src/Tools/MGCleanerPlug/doc/conf.py.in index 0f6894ffd..560450bf1 100644 --- a/src/Tools/MGCleanerPlug/doc/conf.py.in +++ b/src/Tools/MGCleanerPlug/doc/conf.py.in @@ -12,6 +12,7 @@ # serve to show the default value. import sys, os +import sphinx # If your extensions are in another directory, add it here. If the directory # is relative to the documentation root, use os.path.abspath to make it @@ -50,7 +51,7 @@ release = '@SALOMESMESH_VERSION@' # non-false value, then it is used: #today = '' # Else, today_fmt is used as the format for a strftime call. -today_fmt = '%B %d, %Y' +#today_fmt = '%B %d, %Y' # List of documents that shouldn't be included in the build. #unused_docs = [] @@ -80,10 +81,15 @@ pygments_style = 'sphinx' # Options for HTML output # ----------------------- -# The style sheet to use for HTML and HTML Help pages. A file of that name -# must exist either in Sphinx' static/ path, or in one of the custom paths -# given in html_static_path. -html_style = 'default.css' +# The theme to use for HTML and HTML Help pages. Major themes that come with +# Sphinx are currently 'default' and 'sphinxdoc'. +html_theme = 'default' if sphinx.version_info[:2] < (1,3) else 'classic' +themes_options = {} +themes_options['classic'] = { + 'body_max_width':'none', + 'body_min_width':0, +} +html_theme_options = themes_options.get(html_theme, {}) # The name for this set of Sphinx documents. If None, it defaults to # " v documentation". @@ -108,7 +114,7 @@ html_style = 'default.css' # 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. diff --git a/src/Tools/MGCleanerPlug/doc/editHypo.rst b/src/Tools/MGCleanerPlug/doc/editHypo.rst index 5ab05f374..75bbe5182 100644 --- a/src/Tools/MGCleanerPlug/doc/editHypo.rst +++ b/src/Tools/MGCleanerPlug/doc/editHypo.rst @@ -1,8 +1,8 @@ .. _hypothesis-label: -=========================== -How to save MG-Cleaner Parameters -=========================== +================================= +How to save MG-Cleaner Parameters +================================= MG-Cleaner hypothesis is not meshing hypothesis for Salome, but hypothesis for MG-Cleaner. The current set of parameters is automatically written in the salome study object browser when you run computation. diff --git a/src/Tools/MGCleanerPlug/doc/lct.rst b/src/Tools/MGCleanerPlug/doc/lct.rst index c37726b9e..69383e76b 100644 --- a/src/Tools/MGCleanerPlug/doc/lct.rst +++ b/src/Tools/MGCleanerPlug/doc/lct.rst @@ -1,5 +1,5 @@ -Running MGCleaner Plug-in -===================== +Running MGCleaner Plug-in +========================= MGCleaner plug-in can be invoked via SMESH Plugin item in Mesh menu bar diff --git a/src/Tools/Verima/Doc/CMakeLists.txt b/src/Tools/Verima/Doc/CMakeLists.txt index 3e61d8fe9..4969b7784 100755 --- a/src/Tools/Verima/Doc/CMakeLists.txt +++ b/src/Tools/Verima/Doc/CMakeLists.txt @@ -19,7 +19,7 @@ SALOME_CONFIGURE_FILE(conf.py.in conf.py) -SET(_cmd_options -c ${CMAKE_CURRENT_BINARY_DIR} -b html -d doctrees -D latex_paper_size=a4 ${CMAKE_CURRENT_SOURCE_DIR} docutils) +SET(_cmd_options -c ${CMAKE_CURRENT_BINARY_DIR} -b html -d doctrees ${CMAKE_CURRENT_SOURCE_DIR} docutils) SALOME_GENERATE_ENVIRONMENT_SCRIPT(_cmd env_script "${SPHINX_EXECUTABLE}" "${_cmd_options}") ADD_CUSTOM_TARGET(html_docs_Verima COMMAND ${_cmd}) diff --git a/src/Tools/Verima/Doc/conf.py.in b/src/Tools/Verima/Doc/conf.py.in index dd67de87c..d4b53b638 100644 --- a/src/Tools/Verima/Doc/conf.py.in +++ b/src/Tools/Verima/Doc/conf.py.in @@ -12,6 +12,7 @@ # serve to show the default value. import sys, os +import sphinx # If your extensions are in another directory, add it here. If the directory # is relative to the documentation root, use os.path.abspath to make it @@ -50,7 +51,7 @@ release = '@SALOMESMESH_VERSION@' # non-false value, then it is used: #today = '' # Else, today_fmt is used as the format for a strftime call. -today_fmt = '%B %d, %Y' +#today_fmt = '%B %d, %Y' # List of documents that shouldn't be included in the build. #unused_docs = [] @@ -80,10 +81,15 @@ pygments_style = 'sphinx' # Options for HTML output # ----------------------- -# The style sheet to use for HTML and HTML Help pages. A file of that name -# must exist either in Sphinx' static/ path, or in one of the custom paths -# given in html_static_path. -html_style = 'default.css' +# The theme to use for HTML and HTML Help pages. Major themes that come with +# Sphinx are currently 'default' and 'sphinxdoc'. +html_theme = 'default' if sphinx.version_info[:2] < (1,3) else 'classic' +themes_options = {} +themes_options['classic'] = { + 'body_max_width':'none', + 'body_min_width':0, +} +html_theme_options = themes_options.get(html_theme, {}) # The name for this set of Sphinx documents. If None, it defaults to # " v documentation". @@ -108,7 +114,7 @@ html_style = 'default.css' # 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. diff --git a/src/Tools/YamsPlug/doc/Advanced_params.rst b/src/Tools/YamsPlug/doc/Advanced_params.rst index d8a1f560c..c2af74a55 100644 --- a/src/Tools/YamsPlug/doc/Advanced_params.rst +++ b/src/Tools/YamsPlug/doc/Advanced_params.rst @@ -1,45 +1,45 @@ -Advanced Remeshing Options +Advanced Remeshing Options ========================== -.. note:: +.. note:: Be aware that no control of coherency is done when you set these parameters : for instance, geometrical approximation is only allowed when SurfOpt computes a mesh for finite elements but the GUI will let you choose geometrical approximation and compute a visualisation mesh. See Distene's documentation for more details : :download:`MeshGems-SurfOpt: The automatic surface remeshing tool of the MeshGems Suite `. - + - **Ridge detection** -if not set (ridge detection disabled ), MeshGems-SurfOpt will not try to detect any new ridge edge by its own mechanism : -it will consider as ridge only the ridges given in the mesh. All non-ridge edges that would have been detected as ridge by the Ridge angle parameter (see below split edge) will be considered as part of the same continuous patch. This option should not be checked when all the known ridges of the mesh are given and when all other possible ridges are not geometric ridges to take into account. + + if not set (ridge detection disabled ), MeshGems-SurfOpt will not try to detect any new ridge edge by its own mechanism : + it will consider as ridge only the ridges given in the mesh. All non-ridge edges that would have been detected as ridge by the Ridge angle parameter (see below split edge) will be considered as part of the same continuous patch. This option should not be checked when all the known ridges of the mesh are given and when all other possible ridges are not geometric ridges to take into account. - **Point smoothing** -When not set (point smoothing is disabled), MeshGems-SurfOpt will not try to move the initial given vertices (along an edge, a ridge or onto the surface), hence MeshGems-SurfOpt will only swap edges, remove vertices or add vertices (refines) to change the mesh. + + When not set (point smoothing is disabled), MeshGems-SurfOpt will not try to move the initial given vertices (along an edge, a ridge or onto the surface), hence MeshGems-SurfOpt will only swap edges, remove vertices or add vertices (refines) to change the mesh. - **Geometrical approximation** -this field as well as the Chordal deviation tolerance parameter,enables the user to bound the maximal chordal deviation allowed. it avoids having sharp angles. , that is, the maximal distance allowed between the detected curve and the plane of the corresponding mesh face. It avoids having faces too far away from the curve they represent. + + this field as well as the Chordal deviation tolerance parameter,enables the user to bound the maximal chordal deviation allowed. it avoids having sharp angles. , that is, the maximal distance allowed between the detected curve and the plane of the corresponding mesh face. It avoids having faces too far away from the curve they represent. .. image:: images/Tolerance.png :align: center - This parameter P enables the user to specify the maximal chordal deviation E relatively to the local curvature. the maximal chordal deviation will be set to E=P x r (r is the radius of the circumcercle) if the units parameter is set to relative or E=P if the units parameter is set to absolute. - - **Ridge angle** -This parameter specifies the angular values for the automatic detection of ridges and corners. A ridge is automatically detected if the angle between the normal vectors of two adjacent faces exceeds this value. - + This parameter specifies the angular values for the automatic detection of ridges and corners. A ridge is automatically detected if the angle between the normal vectors of two adjacent faces exceeds this value. - **Maximal/Minimal size around vertices** -These two parameters allow the user to prescribe a Maximal/Minimal size for the mesh elements, ie the lengths of the edges. - + These two parameters allow the user to prescribe a Maximal/Minimal size for the mesh elements, ie the lengths of the edges. - **Mesh gradation** -This parameter P controls the element size variation : MeshGems-SurfOpt will avoid having two adjacent edges which sizes vary more than the given gradation. A size correction is applied to the size map : if two adjacent edges are respectively e1 and e2 long and e2 > Pxe1, then, the new size for the second edge will be set to P x e1. -**This procedure is deactivated if P=-1** + This parameter P controls the element size variation : MeshGems-SurfOpt will avoid having two adjacent edges which sizes vary more than the given gradation. A size correction is applied to the size map : if two adjacent edges are respectively e1 and e2 long and e2 > Pxe1, then, the new size for the second edge will be set to P x e1. + **This procedure is deactivated if P=-1** - **Split edge** -If this option is activated, MeshGems-SurfOpt creates new vertices placed on the curved surface and adds them to elements. -It may be used to obtain higher order elements. + + If this option is activated, MeshGems-SurfOpt creates new vertices placed on the curved surface and adds them to elements. + It may be used to obtain higher order elements. diff --git a/src/Tools/YamsPlug/doc/CMakeLists.txt b/src/Tools/YamsPlug/doc/CMakeLists.txt index 1b9442d8f..c977be265 100755 --- a/src/Tools/YamsPlug/doc/CMakeLists.txt +++ b/src/Tools/YamsPlug/doc/CMakeLists.txt @@ -19,7 +19,7 @@ SALOME_CONFIGURE_FILE(conf.py.in conf.py) -SET(_cmd_options -c ${CMAKE_CURRENT_BINARY_DIR} -b html -d doctrees -D latex_paper_size=a4 ${CMAKE_CURRENT_SOURCE_DIR} docutils) +SET(_cmd_options -c ${CMAKE_CURRENT_BINARY_DIR} -b html -d doctrees ${CMAKE_CURRENT_SOURCE_DIR} docutils) SALOME_GENERATE_ENVIRONMENT_SCRIPT(_cmd env_script "${SPHINX_EXECUTABLE}" "${_cmd_options}") ADD_CUSTOM_TARGET(html_docs_YamsPlug COMMAND ${_cmd}) diff --git a/src/Tools/YamsPlug/doc/Generics_params.rst b/src/Tools/YamsPlug/doc/Generics_params.rst index 29453af2e..0dce217ad 100644 --- a/src/Tools/YamsPlug/doc/Generics_params.rst +++ b/src/Tools/YamsPlug/doc/Generics_params.rst @@ -1,21 +1,19 @@ -Generic Options -================= +Generic Options +=============== These options are not meshing options but allow the user to configure control parameters for MeshGems-SurfOpt. - - **Verbosity Level** -This parameter (between 0 and 10) indicates the amount of information that MeshGems-SurfOpt prints during the run. - + This parameter (between 0 and 10) indicates the amount of information that MeshGems-SurfOpt prints during the run. - **Memory Size** -You usually don't have to set this parameter but you can choose to limit the amount of memory used by MeshGems-SurfOpt -- It requires 370 bytes per node. Or, if you try to enrich a already big mesh (up to 2 millions nodes), you exceptionally, need to allocate more memory. - - -- **File** -You can change the file used to store remeshing hypotheses, see :ref:`hypothesis-label` for further information. + You usually don't have to set this parameter but you can choose to limit the amount of memory used by MeshGems-SurfOpt -- It requires 370 bytes per node. Or, if you try to enrich a already big mesh (up to 2 millions nodes), you exceptionally, need to allocate more memory. + +- **File** + + You can change the file used to store remeshing hypotheses, see :ref:`hypothesis-label` for further information. .. image:: images/Generic.png :align: center diff --git a/src/Tools/YamsPlug/doc/conf.py.in b/src/Tools/YamsPlug/doc/conf.py.in index 29d094d19..2a4b99286 100644 --- a/src/Tools/YamsPlug/doc/conf.py.in +++ b/src/Tools/YamsPlug/doc/conf.py.in @@ -12,6 +12,7 @@ # serve to show the default value. import sys, os +import sphinx # If your extensions are in another directory, add it here. If the directory # is relative to the documentation root, use os.path.abspath to make it @@ -50,7 +51,7 @@ release = '@SALOMESMESH_VERSION@' # non-false value, then it is used: #today = '' # Else, today_fmt is used as the format for a strftime call. -today_fmt = '%B %d, %Y' +#today_fmt = '%B %d, %Y' # List of documents that shouldn't be included in the build. #unused_docs = [] @@ -80,10 +81,15 @@ pygments_style = 'sphinx' # Options for HTML output # ----------------------- -# The style sheet to use for HTML and HTML Help pages. A file of that name -# must exist either in Sphinx' static/ path, or in one of the custom paths -# given in html_static_path. -html_style = 'default.css' +# The theme to use for HTML and HTML Help pages. Major themes that come with +# Sphinx are currently 'default' and 'sphinxdoc'. +html_theme = 'default' if sphinx.version_info[:2] < (1,3) else 'classic' +themes_options = {} +themes_options['classic'] = { + 'body_max_width':'none', + 'body_min_width':0, +} +html_theme_options = themes_options.get(html_theme, {}) # The name for this set of Sphinx documents. If None, it defaults to # " v documentation". @@ -108,7 +114,7 @@ html_style = 'default.css' # 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. diff --git a/src/Tools/YamsPlug/doc/editHypo.rst b/src/Tools/YamsPlug/doc/editHypo.rst index 3770d70c2..20074cd3b 100644 --- a/src/Tools/YamsPlug/doc/editHypo.rst +++ b/src/Tools/YamsPlug/doc/editHypo.rst @@ -1,8 +1,8 @@ .. _hypothesis-label: -=========================== -How to save MeshGems-SurfOpt Parameters -=========================== +======================================= +How to save MeshGems-SurfOpt Parameters +======================================= MeshGems-SurfOpt hypothesis is not a meshing hypothesis for Salome, but an hypothesis for MeshGems-SurfOpt. The current set of parameters is automatically written in the salome study object browser when you run computation. diff --git a/src/Tools/YamsPlug/doc/lct.rst b/src/Tools/YamsPlug/doc/lct.rst index 0f1a012d2..1f2861927 100644 --- a/src/Tools/YamsPlug/doc/lct.rst +++ b/src/Tools/YamsPlug/doc/lct.rst @@ -1,5 +1,5 @@ -Running MeshGems-SurfOpt Plug-in -===================== +Running MeshGems-SurfOpt Plug-in +================================ MeshGems-SurfOpt plug-in can be invoked via SMESH Plugin item in Mesh menu bar diff --git a/src/Tools/ZCracksPlug/doc/CMakeLists.txt b/src/Tools/ZCracksPlug/doc/CMakeLists.txt index 5a0c007f8..623baeaa5 100755 --- a/src/Tools/ZCracksPlug/doc/CMakeLists.txt +++ b/src/Tools/ZCracksPlug/doc/CMakeLists.txt @@ -19,7 +19,7 @@ SALOME_CONFIGURE_FILE(conf.py.in conf.py) -SET(_cmd_options -c ${CMAKE_CURRENT_BINARY_DIR} -b html -d doctrees -D latex_paper_size=a4 ${CMAKE_CURRENT_SOURCE_DIR} docutils) +SET(_cmd_options -c ${CMAKE_CURRENT_BINARY_DIR} -b html -d doctrees ${CMAKE_CURRENT_SOURCE_DIR} docutils) SALOME_GENERATE_ENVIRONMENT_SCRIPT(_cmd env_script "${SPHINX_EXECUTABLE}" "${_cmd_options}") ADD_CUSTOM_TARGET(html_docs_ZCracksPlug COMMAND ${_cmd}) diff --git a/src/Tools/blocFissure/doc/CMakeLists.txt b/src/Tools/blocFissure/doc/CMakeLists.txt index e88021eb8..dd06084bd 100755 --- a/src/Tools/blocFissure/doc/CMakeLists.txt +++ b/src/Tools/blocFissure/doc/CMakeLists.txt @@ -19,7 +19,7 @@ SALOME_CONFIGURE_FILE(conf.py.in conf.py) -SET(_cmd_options -c ${CMAKE_CURRENT_BINARY_DIR} -b html -d doctrees -D latex_paper_size=a4 ${CMAKE_CURRENT_SOURCE_DIR} docutils) +SET(_cmd_options -c ${CMAKE_CURRENT_BINARY_DIR} -b html -d doctrees ${CMAKE_CURRENT_SOURCE_DIR} docutils) SALOME_GENERATE_ENVIRONMENT_SCRIPT(_cmd env_script "${SPHINX_EXECUTABLE}" "${_cmd_options}") ADD_CUSTOM_TARGET(html_docs_blocFissure COMMAND ${_cmd}) diff --git a/src/Tools/blocFissure/doc/conf.py.in b/src/Tools/blocFissure/doc/conf.py.in index accd55b19..d6db7e5ce 100644 --- a/src/Tools/blocFissure/doc/conf.py.in +++ b/src/Tools/blocFissure/doc/conf.py.in @@ -50,7 +50,7 @@ release = '@SALOMESMESH_VERSION@' # non-false value, then it is used: #today = '' # Else, today_fmt is used as the format for a strftime call. -today_fmt = '%B %d, %Y' +#today_fmt = '%B %d, %Y' # List of documents that shouldn't be included in the build. #unused_docs = [] @@ -105,11 +105,11 @@ html_theme = 'default' # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, # so a file named "default.css" will overwrite the builtin "default.css". -html_static_path = ['_static'] +#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. -- 2.39.2