FIX

sofa-framework · damienmarchal · May 24, 2023 · Jun 5, 2023 · Jun 7, 2023 · Jun 7, 2023
commit a9ac53beb8a600d187e0115a1d76d6583577d541
diff --git a/bindings/Sofa/src/SofaPython3/Sofa/Core/Binding_Base_doc.h b/bindings/Sofa/src/SofaPython3/Sofa/Core/Binding_Base_doc.h
@@ -73,17 +73,21 @@ static auto getLinkPath =
         Returns the path name as a parsable string
 
         .. code-block:: python
-            if object.getLinkName() is "/child1/object"
-            then the linkPath is @"/child1/object"
+
+            # returns is @"/child1/object" if getPathName() is @"/child1/object"
+            print(object.linkPath)
+
         )";
 static auto getPathName =
         R"(
         Returns the path name as a string
 
         .. code-block:: python
+
             a = Sofa.Core.Node("root")
-            b.addObject("Camera", name="camera")
+            b = a.addObject("Camera", name="camera")
             b.getPathName() # should returns "/root/camera"
+
         ```
         )";
 static auto setDataValues =

diff --git a/bindings/Sofa/src/SofaPython3/Sofa/Core/Binding_Node_doc.h b/bindings/Sofa/src/SofaPython3/Sofa/Core/Binding_Node_doc.h
@@ -33,7 +33,8 @@ static auto Class =
         of a same object can be done in different sub-nodes.
 
         Example of use:
-          .. code-block:: python
+
+        .. code-block:: python
 
                 import Sofa.Core
 
@@ -54,7 +55,8 @@ static auto Class =
         The child nodes, components and parents can be accessed using generator attributes.
 
         Example of use:
-          .. code-block:: python
+
+        .. code-block:: python
 
              # ...
              n = Sofa.Core.Node("MyNode")
@@ -67,7 +69,9 @@ static auto Class =
 
         Accessing children or object from the current node is easy thanks to the generalized access
         API.
+
         Example of use:
+
         .. code-block:: python
 
              # ...
@@ -174,9 +178,6 @@ static auto getObject =
         The extra arguments allowed in the SofaPython (warning=True/False) binding are not supported SofaPython3.
 
         .. code-block:: python
-            # SofaPython2:
-            if node.getObject("MyObject",warning=False):
-                pass
 
             # SofaPython3:
             if node.getObject("MyObject") != None:
@@ -187,6 +188,7 @@ static auto getObject =
 
             if "MyObject" in node.objects:
                 pass
+
         )";
 
 static auto addChildKwargs =

diff --git a/bindings/Sofa/src/SofaPython3/Sofa/Core/Submodule_Core.cpp b/bindings/Sofa/src/SofaPython3/Sofa/Core/Submodule_Core.cpp
@@ -64,7 +64,8 @@ PYBIND11_MODULE(Core, core)
         Node. Nodes are hierarchically organized in a scene graph.
         For more, see the `SOFA lexicography <https://www.sofa-framework.org/community/doc/using-sofa/lexicography/>`_.
         Commonly used classes:
-            .. autosummary::
+
+        .. autosummary::
                 :nosignatures:
 
                 Node
@@ -76,7 +77,8 @@ PYBIND11_MODULE(Core, core)
 
         Example of use
         --------------
-            .. code-block:: python
+
+        .. code-block:: python
 
                 import Sofa.Core
 
@@ -93,6 +95,7 @@ PYBIND11_MODULE(Core, core)
 
                 Sofa.Simulation.init(root)
                 Sofa.Simulation.print(root)
+
        )doc";
 
     moduleAddPythonScriptEvent();

diff --git a/docs/sphinx/source/conf.py b/docs/sphinx/source/conf.py
@@ -37,9 +37,6 @@
     'sphinxcontrib.contentui',
     'sphinx.ext.viewcode',
     'sphinx.ext.napoleon',
-#    'sphinx_search.extension',
-    'sphinx.ext.autosectionlabel',
-#    'sphinxcontrib.osexample'
     ]
 
 import sys
@@ -58,8 +55,6 @@
 autosummary_generate = True
 autosummary_ignore_module_all = False
 
-autosectionlabel_prefix_document=True
-
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['templates']
 

diff --git a/docs/sphinx/source/content/Compilation.rst b/docs/sphinx/source/content/Compilation.rst
@@ -108,6 +108,7 @@ prerequisites.
 
 .. _intree:
 
+*************
 In-tree build
 *************
 
@@ -164,6 +165,7 @@ At this point, you are ready to start the compilation of SOFA and the SofaPython
 
 .. _outtree:
 
+*****************
 Out-of-tree build
 *****************