Merge pull request #749 from Avaiga/doc/highlight-debug-mode

Add debug mode to tutorial

docs/knowledge_base/tutorials/understanding_gui/src/step_01.py

@@ -1,3 +1,3 @@
 from taipy import Gui
 
-Gui(page="# Getting started with *Taipy*").run()
+Gui(page="# Getting started with *Taipy*").run(debug=True)

docs/knowledge_base/tutorials/understanding_gui/src/step_02.py

@@ -10,4 +10,4 @@
 <|{text}|input|>
 """
 
-Gui(page).run()
+Gui(page).run(debug=True)

docs/knowledge_base/tutorials/understanding_gui/src/step_03.py

@@ -23,4 +23,4 @@ def on_change(state, var_name, var_value):
         return
 
 
-Gui(page).run()
+Gui(page).run(debug=True)

docs/knowledge_base/tutorials/understanding_gui/src/step_04.py

@@ -39,4 +39,4 @@ def local_callback(state):
     state.dataframe = temp
     state.text = ""
 
-Gui(page).run()
+Gui(page).run(debug=True)

docs/knowledge_base/tutorials/understanding_gui/src/step_05.py

@@ -72,4 +72,4 @@ def local_callback(state):
 <|{dataframe}|chart|type=bar|x=Text|y[1]=Score Pos|y[2]=Score Neu|y[3]=Score Neg|y[4]=Overall|color[1]=green|color[2]=grey|color[3]=red|type[4]=line|>
 """
 
-Gui(page).run()
+Gui(page).run(debug=True)

docs/knowledge_base/tutorials/understanding_gui/src/step_06.py

@@ -72,4 +72,4 @@ def local_callback(state):
     state.dataframe = temp
     state.text = ""
 
-Gui(page).run()
+Gui(page).run(debug=True)

docs/knowledge_base/tutorials/understanding_gui/src/step_07.py

@@ -116,4 +116,4 @@ def analyze_file(state):
          "text":page_file}
 
 
-Gui(pages=pages).run()
+Gui(pages=pages).run(debug=True)

docs/knowledge_base/tutorials/understanding_gui/step_01/step_01.md

@@ -20,18 +20,26 @@ browser to open your first Taipy page!
 ```python
 from taipy import Gui
 
-Gui(page="# Getting started with *Taipy*").run() # use_reloader=True
+Gui(page="# Getting started with *Taipy*").run(debug=True) # use_reloader=True
 ```
 
-By default, the page won't refresh on its own after you make a code modification.
+The run method accepts different useful parameters:
 
-If you want to alter this behavior, you can set the *use_reloader* parameter of the `run()` method
-to True. This will cause the application to automatically reload when you make changes to a file in
-your application and save it. It's typically used in development mode.
+- _debug_: instructs Taipy to operate in debug mode. This means Taipy will provide a 
+stack trace of the errors within the application—a valuable feature during 
+development.
 
-If you wish to run multiple servers concurrently, you can modify the server port number (5000 by
-default) in the `run()` method. For example, `Gui(...).run(port=xxxx)`. Other parameters to the
-`run()` method can be found
+![Debug mode](debug_mode.png){ width=700 style="margin:auto;display:block;border: 4px solid rgb(210,210,210);border-radius:7px" }
+
+- _use_reloader_: By default, the page won't refresh on its own after you make a code 
+modification. If you want to alter this behavior, you can set the *use_reloader* to 
+True. The application will automatically reload when you make changes to a file in 
+your application and save it.
+
+- _port_: If you wish to run multiple servers concurrently, you can modify the server 
+port number (5000 by default).
+
+Other parameters of the `run()` method can be found
 [here](../../../../manuals/gui/configuration.md#configuring-the-gui-instance).
 
 

docs/knowledge_base/tutorials/understanding_gui/step_02/step_02.md

@@ -63,7 +63,7 @@ My text: <|{text}|>
 <|{text}|input|>
 """
 
-Gui(page).run()
+Gui(page).run(debug=True)
 ```
 
 ![Visual Elements](result.png){ width=700 style="margin:auto;display:block;border: 4px solid rgb(210,210,210);border-radius:7px" }

docs/knowledge_base/tutorials/understanding_gui/step_03/step_03.md

@@ -86,7 +86,7 @@ def on_change(state, var_name, var_value):
         return
 
 
-Gui(page).run()
+Gui(page).run(debug=True)
 ```
 
 ![Interactive GUI](result.png){ width=700 style="margin:auto;display:block;border: 4px solid rgb(210,210,210);border-radius:7px" }

docs/knowledge_base/tutorials/understanding_gui/step_05/step_05.md

@@ -124,7 +124,7 @@ Enter a word:
 <|{dataframe}|chart|type=bar|x=Text|y[1]=Score Pos|y[2]=Score Neu|y[3]=Score Neg|y[4]=Overall|color[1]=green|color[2]=grey|color[3]=red|type[4]=line|>
 """
 
-Gui(page).run()
+Gui(page).run(debug=True)
 ```