Refined the docs and added apptemplate gif

TermTk/TTkWidgets/apptemplate.py

@@ -31,14 +31,14 @@ from TermTk.TTkLayouts import TTkLayout, TTkGridLayout
 from TermTk.TTkWidgets.container import TTkWidget, TTkContainer
 
 class TTkAppTemplate(TTkContainer):
-    ''' TTkAppTemplate Layout sizes:
+    ''' TTkAppTemplate Layout:
 
     ::
 
         App Template Layout
         ┌─────────────────────────────────┐
         │         Header                  │
-        ├─────────┬──────────────┬────────┤ H (1,2,3)
+        ├─────────┬──────────────┬────────┤ H
         │         │   Top        │        │
         │         ├──────────────┤        │ T
         │         │              │        │
@@ -47,7 +47,7 @@ class TTkAppTemplate(TTkContainer):
         │         │              │        │
         │         ├──────────────┤        │ B
         │         │   Bottom     │        │
-        ├─────────┴──────────────┴────────┤ F (1,2,3)
+        ├─────────┴──────────────┴────────┤ F
         │         Footer                  │
         └─────────────────────────────────┘
                   R              L
@@ -373,7 +373,7 @@ class TTkAppTemplate(TTkContainer):
                 if newszh > mmaxh and pt: pt.size = st = min(ptmax, h-mmaxh-sf-sb-sh) ; newszh=h-st-sb-sh-sf
                 if newszh > mmaxh and ph: ph.size = sh = min(phmax, h-mmaxh-sf-sb-st) ; newszh=h-st-sb-sh-sf
 
-        # check vertical sizes
+        # Resize any panel to the proper dimension
         w+=bl+br
         h+=bt+bb+bh+bf
         pm.setGeometry(        bm+sl+bl           , bm+sh+bh+st+bt                 , newszw , newszh )

demo/showcase/apptemplate.py

@@ -59,12 +59,12 @@ class AppTestWidget(ttk.TTkContainer):
 def demoAppTemplate(root=None):
     at = ttk.TTkAppTemplate(parent=root)
 
-    twl = ttk.TTkTestWidgetSizes(border=False, name="Left",   minSize=( 15,  5), maxSize=( 50, 25))
-    twr = ttk.TTkTestWidgetSizes(border=False, name="Right",  minSize=( 15,  5), maxSize=( 50, 25))
-    twh = ttk.TTkTestWidgetSizes(border=False, name="Header", minSize=( 15,  3), maxSize=(160,  7))
-    twt = ttk.TTkTestWidgetSizes(border=False, name="Top",    minSize=( 15,  3), maxSize=(100,  7))
-    twb = ttk.TTkTestWidgetSizes(border=False, name="Bottom", minSize=( 15,  3), maxSize=(100,  7))
-    twf = ttk.TTkTestWidgetSizes(border=False, name="Footer", minSize=( 15,  3), maxSize=(160,  7))
+    twl = ttk.TTkTestWidgetSizes(border=False, name="Left",   minSize=( 15,  5), maxSize=( 50, 0x1000))
+    twr = ttk.TTkTestWidgetSizes(border=False, name="Right",  minSize=( 15,  5), maxSize=( 50, 0x1000))
+    twh = ttk.TTkTestWidgetSizes(border=False, name="Header", minSize=( 15,  3), maxSize=(0x1000,  10))
+    twt = ttk.TTkTestWidgetSizes(border=False, name="Top",    minSize=( 15,  3), maxSize=(0x1000,  10))
+    twb = ttk.TTkTestWidgetSizes(border=False, name="Bottom", minSize=( 15,  3), maxSize=(0x1000,  10))
+    twf = ttk.TTkTestWidgetSizes(border=False, name="Footer", minSize=( 15,  3), maxSize=(0x1000,  10))
 
     twm = AppTestWidget(
             at = at,
@@ -75,7 +75,7 @@ def demoAppTemplate(root=None):
                 "Bottom" : {'wid': twb, 'loc':at.BOTTOM},
                 "Right"  : {'wid': twr, 'loc':at.RIGHT},
                 "Left"   : {'wid': twl, 'loc':at.LEFT}},
-            minSize=( 15,  5), maxSize=( 50, 10))
+            minSize=( 15,  5), maxSize=( 0x1000, 0x1000))
 
     at.setWidget(twm, at.MAIN)
     at.setWidget(twl, at.LEFT)

docs/source/info/features/index.rst

@@ -48,7 +48,7 @@ Main features
 Alpha Features
 --------------
 
-  | Those are the feature/poc that are not being extensively tested and can be prone to unexpected behaviour.
+  | Those are the features/poc that are not being extensively tested and can be prone to unexpected behaviour.
   | Their APIs may change before the final release to address bugs or improving the overall design implementation.
 
 * Text Editor

docs/source/info/features/widgets.rst

@@ -79,4 +79,7 @@ Layout
 * Resizable Frame :class:`~TermTk.TTkWidgets.resizableframe.TTkResizableFrame`
 * Window :class:`~TermTk.TTkWidgets.window.TTkWindow`
 * Splitter :class:`~TermTk.TTkWidgets.splitter.TTkSplitter`
-* Scroll Area :class:`~TermTk.TTkWidgets.scrollarea.TTkScrollArea`
+* Scroll Area :class:`~TermTk.TTkWidgets.scrollarea.TTkScrollArea`
+
+.. image::https://github.com/ceccopierangiolieugenio/pyTermTk/assets/8876552/96905fda-c335-4591-bdb2-1df89a6f31f3
+* App Template :class:`~TermTk.TTkWidgets.apptemplate.TTkAppTemplate`