fix: better doc for calculation with unknown variable

src/rougail/output_doc/annotator.py

@@ -175,6 +175,8 @@ class Annotator(Walk):
                 prop_value,
                 variable.version,
             )
+            if isinstance(prop_value, Calculation):
+                prop_value.default_values = False
 
     def calculation_to_information(
         self,
@@ -237,6 +239,7 @@ class Annotator(Walk):
                 "type": "variable",
                 "value": value,
                 "ori_path": variable_path,
+                "optional": values.optional,
             }
         if isinstance(values, InformationCalculation):
             return {

src/rougail/output_doc/doc.py

@@ -670,14 +670,20 @@ class RougailOutputDoc(Examples):
                 if variable and self._is_inaccessible_user_data(variable):
                     msg = _("depends on an undocumented variable")
                 elif condition == "when_not":
-                    msg = _('when the variable "{0}" hasn\'t the value "{1}"')
+                    if not calculation["optional"]:
+                        msg = _('when the variable "{0}" hasn\'t the value "{1}"')
+                    else:
+                        msg = _('when the variable "{0}" is defined and hasn\'t the value "{1}"')
                 else:
-                    msg = _('when the variable "{0}" has the value "{1}"')
+                    if not calculation["optional"]:
+                        msg = _('when the variable "{0}" has the value "{1}"')
+                    else:
+                        msg = _('when the variable "{0}" is defined and has the value "{1}"')
                 if not isinstance(value, str):
                     value = dump(value)
                 values = msg.format(variable_path, value)
             else:
-                if calculation.get("optional", False):
+                if calculation["optional"]:
                     path = calculation["value"]
                     if "{{ identifier }}" in path:
                         if path not in self.dynamic_paths:
@@ -687,7 +693,11 @@ class RougailOutputDoc(Examples):
                             self.conf.forcepermissive.option(path).get()
                         except AttributeError:
                             return None
-                true_msg = _('the value of the variable "{0}"')
+                if not calculation["optional"]:
+                    true_msg = _('the value of the variable "{0}"')
+                else:
+                    true_msg = _('the value of the variable "{0}" if it is defined')
+                    print('connard ben lan ...')
                 hidden_msg = _("the value of an undocumented variable")
                 # if "{{ identifier }}" in calculation["value"] and calculation["value"] in self.dynamic_paths:
                 if "{{ identifier }}" in calculation["ori_path"]:

tests/force_optional.adoc

@@ -21,6 +21,12 @@ My var3. +
 **Hidden**: var could be hidden.               
 | 
 
+**var4** +
+`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `mandatory` `__hidden__`            | 
+My var4. +
+**Hidden**: when the variable "a.unknown.variable" has the value "value".               
+| 
+
 **var5** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `mandatory`            | 
 My var5. +
@@ -48,7 +54,7 @@ My var8. +
 **Choices**: the a.unknown.variable values.               
 |====
 
-== my var6
+== my var9
 
 
 
@@ -66,3 +72,32 @@ This family builds families dynamically.
 A variable.               
 |====
 
+[cols="1a,1a"]
+|====
+| Variable   | Description   
+| 
+
+**var_10** +
+`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `mandatory` `__hidden__`            | 
+My var10. +
+**Hidden**: when the variable "a.unknown.variable" has the value "val".               
+| 
+
+**var_11** +
+`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `mandatory` `__hidden__`            | 
+My var11. +
+**Hidden**: when the variable "a.unknown.variable" hasn't the value "val".               
+| 
+
+**var_12** +
+`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `mandatory` `__hidden__`            | 
+My var12. +
+**Hidden**: when the variable "a.unknown.variable" is defined and has the value "true".               
+| 
+
+**var_13** +
+`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `mandatory` `__hidden__`            | 
+My var13. +
+**Hidden**: when the variable "a.unknown.variable" has the value "true".               
+|====
+

tests/force_optional/00_file.yml

@@ -54,8 +54,32 @@ var8:
     description: the a.unknown.variable values
 
 "var_{{ identifier }}":
-  description: my var6
+  description: my var9
   dynamic:
     variable: a.unknown.variable
   var:
     description: a variable
+
+var_10:
+  description: my var10
+  hidden:
+    variable: a.unknown.variable
+    when: val
+
+var_11:
+  description: my var11
+  hidden:
+    variable: a.unknown.variable
+    when_not: val
+
+var_12:
+  description: my var12
+  hidden:
+    variable: a.unknown.variable
+    optional: true
+
+var_13:
+  description: my var13
+  hidden:
+    variable: a.unknown.variable
+    optional: false

tests/results/test/00_6string.adoc

@@ -34,5 +34,17 @@ The fifth variable. +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory`            | 
 The sixth variable. +
 **Default**: value               
+| 
+
+**var7** +
+`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory`            | 
+The seventh variable. +
+**Default**: 8080               
+| 
+
+**var8** +
+`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory`            | 
+The height variable. +
+**Default**: true               
 |====
 

tests/results/test/00_6string.json

@@ -166,5 +166,65 @@
     "descriptions": [
       "The sixth variable."
     ]
+  },
+  "var7": {
+    "type": "variable",
+    "default": {
+      "name": "Default",
+      "values": "8080"
+    },
+    "properties": [
+      {
+        "type": "type",
+        "name": "string"
+      },
+      {
+        "type": "mode",
+        "name": "standard"
+      },
+      {
+        "type": "property",
+        "name": "mandatory"
+      }
+    ],
+    "paths": [
+      "var7"
+    ],
+    "names": [
+      "var7"
+    ],
+    "descriptions": [
+      "The seventh variable."
+    ]
+  },
+  "var8": {
+    "type": "variable",
+    "default": {
+      "name": "Default",
+      "values": "true"
+    },
+    "properties": [
+      {
+        "type": "type",
+        "name": "string"
+      },
+      {
+        "type": "mode",
+        "name": "standard"
+      },
+      {
+        "type": "property",
+        "name": "mandatory"
+      }
+    ],
+    "paths": [
+      "var8"
+    ],
+    "names": [
+      "var8"
+    ],
+    "descriptions": [
+      "The height variable."
+    ]
   }
 }

tests/results/test/00_6string.md

@@ -6,4 +6,6 @@
 | **var4**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | The forth variable.<br/>**Default**: value                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | **var5**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | The fifth variable.<br/>**Default**: value                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | **var6**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | The sixth variable.<br/>**Default**: value                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| **var7**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | The seventh variable.<br/>**Default**: 8080                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| **var8**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | The height variable.<br/>**Default**: true                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 

tests/results/test/00_6string.sh

@@ -18,4 +18,10 @@
 ├───────────────────────────────────────┼──────────────────────────────────────┤
 │ var6                                  │ The sixth variable.                  │
 │  string   standard   mandatory        │ Default: value                       │
+├───────────────────────────────────────┼──────────────────────────────────────┤
+│ var7                                  │ The seventh variable.                │
+│  string   standard   mandatory        │ Default: 8080                        │
+├───────────────────────────────────────┼──────────────────────────────────────┤
+│ var8                                  │ The height variable.                 │
+│  string   standard   mandatory        │ Default: true                        │
 └───────────────────────────────────────┴──────────────────────────────────────┘

tests/results/test/00_9default_calculation_multi_optional.adoc

@@ -12,6 +12,6 @@ My_variable. +
 **my_calculated_variable** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory` `unique` `multiple`            | 
 My_calculated_variable. +
-**Default**: the value of the variable "my_variable".               
+**Default**: the value of the variable "my_variable" if it is defined.               
 |====
 

tests/results/test/00_9default_calculation_multi_optional.json

@@ -31,7 +31,7 @@
     "default": {
       "name": "Default",
       "values": [
-        "the value of the variable \"my_variable\"."
+        "the value of the variable \"my_variable\" if it is defined."
       ]
     },
     "properties": [

tests/results/test/00_9default_calculation_multi_optional.md

@@ -1,5 +1,5 @@
 | Variable                                                                                                                         | Description                                                                                                                      |
 |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | **my_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | My_variable.<br/>**Default**: val1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| **my_calculated_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | My_calculated_variable.<br/>**Default**: the value of the variable "my_variable".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| **my_calculated_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | My_calculated_variable.<br/>**Default**: the value of the variable "my_variable" if it is defined.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 

tests/results/test/00_9default_calculation_multi_optional.sh

@@ -6,5 +6,5 @@
 ├───────────────────────────────────────┼──────────────────────────────────────┤
 │ my_calculated_variable                │ My_calculated_variable.              │
 │  string   standard   mandatory        │ Default: the value of the variable   │
-│ unique   multiple                     │ "my_variable".                       │
+│ unique   multiple                     │ "my_variable" if it is defined.      │
 └───────────────────────────────────────┴──────────────────────────────────────┘

tests/results/test/00_9default_calculation_multi_optional2.adoc

@@ -12,6 +12,6 @@ My_variable. +
 **my_calculated_variable** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory` `unique` `multiple`            | 
 My_calculated_variable. +
-**Default**: the value of the variable "my_variable".               
+**Default**: the value of the variable "my_variable" if it is defined.               
 |====
 

tests/results/test/00_9default_calculation_multi_optional2.json

@@ -31,7 +31,7 @@
     "default": {
       "name": "Default",
       "values": [
-        "the value of the variable \"my_variable\"."
+        "the value of the variable \"my_variable\" if it is defined."
       ]
     },
     "properties": [

tests/results/test/00_9default_calculation_multi_optional2.md

@@ -1,5 +1,5 @@
 | Variable                                                                                                                         | Description                                                                                                                      |
 |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | **my_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | My_variable.<br/>**Default**: val1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| **my_calculated_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | My_calculated_variable.<br/>**Default**: the value of the variable "my_variable".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| **my_calculated_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | My_calculated_variable.<br/>**Default**: the value of the variable "my_variable" if it is defined.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 

tests/results/test/00_9default_calculation_multi_optional2.sh

@@ -6,5 +6,5 @@
 ├───────────────────────────────────────┼──────────────────────────────────────┤
 │ my_calculated_variable                │ My_calculated_variable.              │
 │  string   standard   mandatory        │ Default: the value of the variable   │
-│ unique   multiple                     │ "my_variable".                       │
+│ unique   multiple                     │ "my_variable" if it is defined.      │
 └───────────────────────────────────────┴──────────────────────────────────────┘

tests/results/test/00_9default_calculation_multi_optional_default.adoc

@@ -12,6 +12,6 @@ My_variable. +
 **my_calculated_variable** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory` `unique` `multiple`            | 
 My_calculated_variable. +
-**Default**: the value of the variable "my_variable".               
+**Default**: the value of the variable "my_variable" if it is defined.               
 |====
 

tests/results/test/00_9default_calculation_multi_optional_default.json

@@ -31,7 +31,7 @@
     "default": {
       "name": "Default",
       "values": [
-        "the value of the variable \"my_variable\"."
+        "the value of the variable \"my_variable\" if it is defined."
       ]
     },
     "properties": [

tests/results/test/00_9default_calculation_multi_optional_default.md

@@ -1,5 +1,5 @@
 | Variable                                                                                                                         | Description                                                                                                                      |
 |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | **my_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | My_variable.<br/>**Default**: val1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| **my_calculated_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | My_calculated_variable.<br/>**Default**: the value of the variable "my_variable".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| **my_calculated_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | My_calculated_variable.<br/>**Default**: the value of the variable "my_variable" if it is defined.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 

tests/results/test/00_9default_calculation_multi_optional_default.sh

@@ -6,5 +6,5 @@
 ├───────────────────────────────────────┼──────────────────────────────────────┤
 │ my_calculated_variable                │ My_calculated_variable.              │
 │  string   standard   mandatory        │ Default: the value of the variable   │
-│ unique   multiple                     │ "my_variable".                       │
+│ unique   multiple                     │ "my_variable" if it is defined.      │
 └───────────────────────────────────────┴──────────────────────────────────────┘

tests/results/test/00_9default_calculation_optional_exists.adoc

@@ -15,6 +15,6 @@ My_variable. +
 **my_calculated_variable** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory` `unique` `multiple`            | 
 My_calculated_variable. +
-**Default**: the value of the variable "my_variable".               
+**Default**: the value of the variable "my_variable" if it is defined.               
 |====
 

tests/results/test/00_9default_calculation_optional_exists.json

@@ -41,7 +41,7 @@
     "type": "variable",
     "default": {
       "name": "Default",
-      "values": "the value of the variable \"my_variable\"."
+      "values": "the value of the variable \"my_variable\" if it is defined."
     },
     "properties": [
       {

tests/results/test/00_9default_calculation_optional_exists.md

@@ -1,5 +1,5 @@
 | Variable                                                                                                                         | Description                                                                                                                      |
 |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | **my_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | My_variable.<br/>**Default**: <br/>- val1<br/>- val2                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
-| **my_calculated_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | My_calculated_variable.<br/>**Default**: the value of the variable "my_variable".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| **my_calculated_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | My_calculated_variable.<br/>**Default**: the value of the variable "my_variable" if it is defined.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 

tests/results/test/00_9default_calculation_optional_exists.sh

@@ -8,5 +8,5 @@
 ├───────────────────────────────────────┼──────────────────────────────────────┤
 │ my_calculated_variable                │ My_calculated_variable.              │
 │  string   standard   mandatory        │ Default: the value of the variable   │
-│ unique   multiple                     │ "my_variable".                       │
+│ unique   multiple                     │ "my_variable" if it is defined.      │
 └───────────────────────────────────────┴──────────────────────────────────────┘

tests/results/test/04_5disabled_calculation_optional_default.adoc

@@ -9,15 +9,21 @@ A condition. +
 **Default**: false               
 | 
 
+**var1** +
+`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `__hidden__`            | 
+A first variable. +
+**Hidden**: when the variable "unknown" is defined and has the value "true".               
+| 
+
 **var3** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `__hidden__`            | 
 A second variable. +
-**Hidden**: when the variable "condition" has the value "true".               
+**Hidden**: when the variable "condition" is defined and has the value "true".               
 | 
 
 **var4** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `__hidden__`            | 
 A forth variable. +
-**Hidden**: when the variable "condition" has the value "true".               
+**Hidden**: when the variable "condition" is defined and has the value "true".               
 |====
 

tests/results/test/04_5disabled_calculation_optional_default.json

@@ -29,6 +29,33 @@
       "A condition."
     ]
   },
+  "var1": {
+    "type": "variable",
+    "properties": [
+      {
+        "type": "type",
+        "name": "string"
+      },
+      {
+        "type": "mode",
+        "name": "standard"
+      },
+      {
+        "type": "property",
+        "name": "hidden",
+        "annotation": "when the variable \"unknown\" is defined and has the value \"true\"."
+      }
+    ],
+    "paths": [
+      "var1"
+    ],
+    "names": [
+      "var1"
+    ],
+    "descriptions": [
+      "A first variable."
+    ]
+  },
   "var3": {
     "type": "variable",
     "properties": [
@@ -43,7 +70,7 @@
       {
         "type": "property",
         "name": "hidden",
-        "annotation": "when the variable \"condition\" has the value \"true\"."
+        "annotation": "when the variable \"condition\" is defined and has the value \"true\"."
       }
     ],
     "paths": [
@@ -70,7 +97,7 @@
       {
         "type": "property",
         "name": "hidden",
-        "annotation": "when the variable \"condition\" has the value \"true\"."
+        "annotation": "when the variable \"condition\" is defined and has the value \"true\"."
       }
     ],
     "paths": [

tests/results/test/04_5disabled_calculation_optional_default.md

@@ -1,6 +1,7 @@
 | Variable                                                                                                      | Description                                                                                                   |
 |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | **condition**<br/>[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | A condition.<br/>**Default**: false                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| **var3**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` *`hidden`*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | A second variable.<br/>**Hidden**: when the variable "condition" has the value "true".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
-| **var4**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` *`hidden`*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | A forth variable.<br/>**Hidden**: when the variable "condition" has the value "true".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| **var1**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` *`hidden`*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | A first variable.<br/>**Hidden**: when the variable "unknown" is defined and has the value "true".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| **var3**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` *`hidden`*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | A second variable.<br/>**Hidden**: when the variable "condition" is defined and has the value "true".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| **var4**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` *`hidden`*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | A forth variable.<br/>**Hidden**: when the variable "condition" is defined and has the value "true".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
 

tests/results/test/04_5disabled_calculation_optional_default.sh

@@ -4,11 +4,17 @@
 │ condition                             │ A condition.                         │
 │  boolean   standard   mandatory       │ Default: false                       │
 ├───────────────────────────────────────┼──────────────────────────────────────┤
+│ var1                                  │ A first variable.                    │
+│  string   standard   hidden           │ Hidden: when the variable "unknown"  │
+│                                       │ is defined and has the value "true". │
+├───────────────────────────────────────┼──────────────────────────────────────┤
 │ var3                                  │ A second variable.                   │
 │  string   standard   hidden           │ Hidden: when the variable            │
-│                                       │ "condition" has the value "true".    │
+│                                       │ "condition" is defined and has the   │
+│                                       │ value "true".                        │
 ├───────────────────────────────────────┼──────────────────────────────────────┤
 │ var4                                  │ A forth variable.                    │
 │  string   standard   hidden           │ Hidden: when the variable            │
-│                                       │ "condition" has the value "true".    │
+│                                       │ "condition" is defined and has the   │
+│                                       │ value "true".                        │
 └───────────────────────────────────────┴──────────────────────────────────────┘

tests/results/test/60_5family_dynamic_calc_variable_empty.adoc

@@ -39,6 +39,6 @@ A dynamic variable.
 **var2** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory`            | 
 A variable calculated. +
-**Default**: the value of the variable "dynval1.var".               
+**Default**: the value of the variable "dynval1.var" if it is defined.               
 |====
 

tests/results/test/60_5family_dynamic_calc_variable_empty.json

@@ -93,7 +93,7 @@
     "type": "variable",
     "default": {
       "name": "Default",
-      "values": "the value of the variable \"dynval1.var\"."
+      "values": "the value of the variable \"dynval1.var\" if it is defined."
     },
     "properties": [
       {

tests/results/test/60_5family_dynamic_calc_variable_empty.md

@@ -16,5 +16,5 @@ This family builds families dynamically.
 
 | Variable                                                                                                             | Description                                                                                                          |
 |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **var2**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | A variable calculated.<br/>**Default**: the value of the variable "dynval1.var".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| **var2**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | A variable calculated.<br/>**Default**: the value of the variable "dynval1.var" if it is defined.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
 

tests/results/test/60_5family_dynamic_calc_variable_empty.sh

@@ -32,5 +32,5 @@ This family builds families dynamically.
 ┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
 │ var2                                  │ A variable calculated.               │
 │  string   standard   mandatory        │ Default: the value of the variable   │
-│                                       │ "dynval1.var".                       │
+│                                       │ "dynval1.var" if it is defined.      │
 └───────────────────────────────────────┴──────────────────────────────────────┘

tests/results/test/60_5family_dynamic_variable_outside_suffix_empty.adoc

@@ -40,6 +40,6 @@ A variable inside dynamic family. +
 **var2** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard`            | 
 A variable. +
-**Default**: the value of the variable "dyn_val1.var".               
+**Default**: the value of the variable "dyn_val1.var" if it is defined.               
 |====
 

tests/results/test/60_5family_dynamic_variable_outside_suffix_empty.json

@@ -98,7 +98,7 @@
     "type": "variable",
     "default": {
       "name": "Default",
-      "values": "the value of the variable \"dyn_val1.var\"."
+      "values": "the value of the variable \"dyn_val1.var\" if it is defined."
     },
     "properties": [
       {

tests/results/test/60_5family_dynamic_variable_outside_suffix_empty.md

@@ -16,5 +16,5 @@ This family builds families dynamically.
 
 | Variable                                                                                                             | Description                                                                                                          |
 |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **var2**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | A variable.<br/>**Default**: the value of the variable "dyn_val1.var".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| **var2**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | A variable.<br/>**Default**: the value of the variable "dyn_val1.var" if it is defined.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
 

tests/results/test/60_5family_dynamic_variable_outside_suffix_empty.sh

@@ -32,5 +32,5 @@ This family builds families dynamically.
 ┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
 │ var2                                  │ A variable.                          │
 │  string   standard                    │ Default: the value of the variable   │
-│                                       │ "dyn_val1.var".                      │
+│                                       │ "dyn_val1.var" if it is defined.     │
 └───────────────────────────────────────┴──────────────────────────────────────┘

tests/results/test_examples/00_6string.md

@@ -16,4 +16,6 @@ var3: example
 var4: value
 var5: value
 var6: value
+var7: '8080'
+var8: 'true'
 ```

tests/results/test_examples/04_5disabled_calculation_optional_default.md

@@ -3,6 +3,7 @@
 ```yaml
 ---
 condition: false
+var1: example
 var3: example
 var4: example
 ```

tests/results/test_namespace/00_6string.adoc

@@ -36,5 +36,17 @@ The fifth variable. +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory`            | 
 The sixth variable. +
 **Default**: value               
+| 
+
+**rougail.var7** +
+`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory`            | 
+The seventh variable. +
+**Default**: 8080               
+| 
+
+**rougail.var8** +
+`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory`            | 
+The height variable. +
+**Default**: true               
 |====
 

tests/results/test_namespace/00_6string.json

@@ -184,6 +184,66 @@
         "descriptions": [
           "The sixth variable."
         ]
+      },
+      "rougail.var7": {
+        "type": "variable",
+        "default": {
+          "name": "Default",
+          "values": "8080"
+        },
+        "properties": [
+          {
+            "type": "type",
+            "name": "string"
+          },
+          {
+            "type": "mode",
+            "name": "standard"
+          },
+          {
+            "type": "property",
+            "name": "mandatory"
+          }
+        ],
+        "paths": [
+          "rougail.var7"
+        ],
+        "names": [
+          "var7"
+        ],
+        "descriptions": [
+          "The seventh variable."
+        ]
+      },
+      "rougail.var8": {
+        "type": "variable",
+        "default": {
+          "name": "Default",
+          "values": "true"
+        },
+        "properties": [
+          {
+            "type": "type",
+            "name": "string"
+          },
+          {
+            "type": "mode",
+            "name": "standard"
+          },
+          {
+            "type": "property",
+            "name": "mandatory"
+          }
+        ],
+        "paths": [
+          "rougail.var8"
+        ],
+        "names": [
+          "var8"
+        ],
+        "descriptions": [
+          "The height variable."
+        ]
       }
     }
   }

tests/results/test_namespace/00_6string.md

@@ -8,4 +8,6 @@
 | **rougail.var4**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | The forth variable.<br/>**Default**: value                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | **rougail.var5**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | The fifth variable.<br/>**Default**: value                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | **rougail.var6**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | The sixth variable.<br/>**Default**: value                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| **rougail.var7**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | The seventh variable.<br/>**Default**: 8080                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| **rougail.var8**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | The height variable.<br/>**Default**: true                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 

tests/results/test_namespace/00_6string.sh

@@ -23,4 +23,10 @@
 ├───────────────────────────────────────┼──────────────────────────────────────┤
 │ rougail.var6                          │ The sixth variable.                  │
 │  string   standard   mandatory        │ Default: value                       │
+├───────────────────────────────────────┼──────────────────────────────────────┤
+│ rougail.var7                          │ The seventh variable.                │
+│  string   standard   mandatory        │ Default: 8080                        │
+├───────────────────────────────────────┼──────────────────────────────────────┤
+│ rougail.var8                          │ The height variable.                 │
+│  string   standard   mandatory        │ Default: true                        │
 └───────────────────────────────────────┴──────────────────────────────────────┘

tests/results/test_namespace/00_9default_calculation_multi_optional.adoc

@@ -14,6 +14,6 @@ My_variable. +
 **rougail.my_calculated_variable** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory` `unique` `multiple`            | 
 My_calculated_variable. +
-**Default**: the value of the variable "rougail.my_variable".               
+**Default**: the value of the variable "rougail.my_variable" if it is defined.               
 |====
 

tests/results/test_namespace/00_9default_calculation_multi_optional.json

@@ -49,7 +49,7 @@
         "default": {
           "name": "Default",
           "values": [
-            "the value of the variable \"rougail.my_variable\"."
+            "the value of the variable \"rougail.my_variable\" if it is defined."
           ]
         },
         "properties": [

tests/results/test_namespace/00_9default_calculation_multi_optional.md

@@ -3,5 +3,5 @@
 | Variable                                                                                                                         | Description                                                                                                                      |
 |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | **rougail.my_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | My_variable.<br/>**Default**: val1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| **rougail.my_calculated_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | My_calculated_variable.<br/>**Default**: the value of the variable "rougail.my_variable".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| **rougail.my_calculated_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | My_calculated_variable.<br/>**Default**: the value of the variable "rougail.my_variable" if it is defined.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
 

tests/results/test_namespace/00_9default_calculation_multi_optional.sh

@@ -11,5 +11,6 @@
 ├───────────────────────────────────────┼──────────────────────────────────────┤
 │ rougail.my_calculated_variable        │ My_calculated_variable.              │
 │  string   standard   mandatory        │ Default: the value of the variable   │
-│ unique   multiple                     │ "rougail.my_variable".               │
+│ unique   multiple                     │ "rougail.my_variable" if it is       │
+│                                       │ defined.                             │
 └───────────────────────────────────────┴──────────────────────────────────────┘

tests/results/test_namespace/00_9default_calculation_multi_optional2.adoc

@@ -14,6 +14,6 @@ My_variable. +
 **rougail.my_calculated_variable** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory` `unique` `multiple`            | 
 My_calculated_variable. +
-**Default**: the value of the variable "rougail.my_variable".               
+**Default**: the value of the variable "rougail.my_variable" if it is defined.               
 |====
 

tests/results/test_namespace/00_9default_calculation_multi_optional2.json

@@ -49,7 +49,7 @@
         "default": {
           "name": "Default",
           "values": [
-            "the value of the variable \"rougail.my_variable\"."
+            "the value of the variable \"rougail.my_variable\" if it is defined."
           ]
         },
         "properties": [

tests/results/test_namespace/00_9default_calculation_multi_optional2.md

@@ -3,5 +3,5 @@
 | Variable                                                                                                                         | Description                                                                                                                      |
 |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | **rougail.my_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | My_variable.<br/>**Default**: val1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| **rougail.my_calculated_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | My_calculated_variable.<br/>**Default**: the value of the variable "rougail.my_variable".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| **rougail.my_calculated_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | My_calculated_variable.<br/>**Default**: the value of the variable "rougail.my_variable" if it is defined.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
 

tests/results/test_namespace/00_9default_calculation_multi_optional2.sh

@@ -11,5 +11,6 @@
 ├───────────────────────────────────────┼──────────────────────────────────────┤
 │ rougail.my_calculated_variable        │ My_calculated_variable.              │
 │  string   standard   mandatory        │ Default: the value of the variable   │
-│ unique   multiple                     │ "rougail.my_variable".               │
+│ unique   multiple                     │ "rougail.my_variable" if it is       │
+│                                       │ defined.                             │
 └───────────────────────────────────────┴──────────────────────────────────────┘

tests/results/test_namespace/00_9default_calculation_multi_optional_default.adoc

@@ -14,6 +14,6 @@ My_variable. +
 **rougail.my_calculated_variable** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory` `unique` `multiple`            | 
 My_calculated_variable. +
-**Default**: the value of the variable "rougail.my_variable".               
+**Default**: the value of the variable "rougail.my_variable" if it is defined.               
 |====
 

tests/results/test_namespace/00_9default_calculation_multi_optional_default.json

@@ -49,7 +49,7 @@
         "default": {
           "name": "Default",
           "values": [
-            "the value of the variable \"rougail.my_variable\"."
+            "the value of the variable \"rougail.my_variable\" if it is defined."
           ]
         },
         "properties": [

tests/results/test_namespace/00_9default_calculation_multi_optional_default.md

@@ -3,5 +3,5 @@
 | Variable                                                                                                                         | Description                                                                                                                      |
 |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | **rougail.my_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | My_variable.<br/>**Default**: val1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| **rougail.my_calculated_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | My_calculated_variable.<br/>**Default**: the value of the variable "rougail.my_variable".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| **rougail.my_calculated_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | My_calculated_variable.<br/>**Default**: the value of the variable "rougail.my_variable" if it is defined.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
 

tests/results/test_namespace/00_9default_calculation_multi_optional_default.sh

@@ -11,5 +11,6 @@
 ├───────────────────────────────────────┼──────────────────────────────────────┤
 │ rougail.my_calculated_variable        │ My_calculated_variable.              │
 │  string   standard   mandatory        │ Default: the value of the variable   │
-│ unique   multiple                     │ "rougail.my_variable".               │
+│ unique   multiple                     │ "rougail.my_variable" if it is       │
+│                                       │ defined.                             │
 └───────────────────────────────────────┴──────────────────────────────────────┘

tests/results/test_namespace/00_9default_calculation_optional_exists.adoc

@@ -17,6 +17,6 @@ My_variable. +
 **rougail.my_calculated_variable** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory` `unique` `multiple`            | 
 My_calculated_variable. +
-**Default**: the value of the variable "rougail.my_variable".               
+**Default**: the value of the variable "rougail.my_variable" if it is defined.               
 |====
 

tests/results/test_namespace/00_9default_calculation_optional_exists.json

@@ -59,7 +59,7 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "the value of the variable \"rougail.my_variable\"."
+          "values": "the value of the variable \"rougail.my_variable\" if it is defined."
         },
         "properties": [
           {

tests/results/test_namespace/00_9default_calculation_optional_exists.md

@@ -3,5 +3,5 @@
 | Variable                                                                                                                         | Description                                                                                                                      |
 |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | **rougail.my_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | My_variable.<br/>**Default**: <br/>- val1<br/>- val2                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
-| **rougail.my_calculated_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | My_calculated_variable.<br/>**Default**: the value of the variable "rougail.my_variable".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| **rougail.my_calculated_variable**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | My_calculated_variable.<br/>**Default**: the value of the variable "rougail.my_variable" if it is defined.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
 

tests/results/test_namespace/00_9default_calculation_optional_exists.sh

@@ -13,5 +13,6 @@
 ├───────────────────────────────────────┼──────────────────────────────────────┤
 │ rougail.my_calculated_variable        │ My_calculated_variable.              │
 │  string   standard   mandatory        │ Default: the value of the variable   │
-│ unique   multiple                     │ "rougail.my_variable".               │
+│ unique   multiple                     │ "rougail.my_variable" if it is       │
+│                                       │ defined.                             │
 └───────────────────────────────────────┴──────────────────────────────────────┘

tests/results/test_namespace/04_5disabled_calculation_optional_default.adoc

@@ -11,15 +11,21 @@ A condition. +
 **Default**: false               
 | 
 
+**rougail.var1** +
+`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `__hidden__`            | 
+A first variable. +
+**Hidden**: when the variable "rougail.unknown" is defined and has the value "true".               
+| 
+
 **rougail.var3** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `__hidden__`            | 
 A second variable. +
-**Hidden**: when the variable "rougail.condition" has the value "true".               
+**Hidden**: when the variable "rougail.condition" is defined and has the value "true".               
 | 
 
 **rougail.var4** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `__hidden__`            | 
 A forth variable. +
-**Hidden**: when the variable "rougail.condition" has the value "true".               
+**Hidden**: when the variable "rougail.condition" is defined and has the value "true".               
 |====
 

tests/results/test_namespace/04_5disabled_calculation_optional_default.json

@@ -47,6 +47,33 @@
           "A condition."
         ]
       },
+      "rougail.var1": {
+        "type": "variable",
+        "properties": [
+          {
+            "type": "type",
+            "name": "string"
+          },
+          {
+            "type": "mode",
+            "name": "standard"
+          },
+          {
+            "type": "property",
+            "name": "hidden",
+            "annotation": "when the variable \"rougail.unknown\" is defined and has the value \"true\"."
+          }
+        ],
+        "paths": [
+          "rougail.var1"
+        ],
+        "names": [
+          "var1"
+        ],
+        "descriptions": [
+          "A first variable."
+        ]
+      },
       "rougail.var3": {
         "type": "variable",
         "properties": [
@@ -61,7 +88,7 @@
           {
             "type": "property",
             "name": "hidden",
-            "annotation": "when the variable \"rougail.condition\" has the value \"true\"."
+            "annotation": "when the variable \"rougail.condition\" is defined and has the value \"true\"."
           }
         ],
         "paths": [
@@ -88,7 +115,7 @@
           {
             "type": "property",
             "name": "hidden",
-            "annotation": "when the variable \"rougail.condition\" has the value \"true\"."
+            "annotation": "when the variable \"rougail.condition\" is defined and has the value \"true\"."
           }
         ],
         "paths": [

tests/results/test_namespace/04_5disabled_calculation_optional_default.md

@@ -3,6 +3,7 @@
 | Variable                                                                                                      | Description                                                                                                   |
 |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | **rougail.condition**<br/>[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | A condition.<br/>**Default**: false                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| **rougail.var3**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` *`hidden`*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | A second variable.<br/>**Hidden**: when the variable "rougail.condition" has the value "true".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
-| **rougail.var4**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` *`hidden`*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | A forth variable.<br/>**Hidden**: when the variable "rougail.condition" has the value "true".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| **rougail.var1**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` *`hidden`*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | A first variable.<br/>**Hidden**: when the variable "rougail.unknown" is defined and has the value "true".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| **rougail.var3**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` *`hidden`*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | A second variable.<br/>**Hidden**: when the variable "rougail.condition" is defined and has the value "true".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| **rougail.var4**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` *`hidden`*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | A forth variable.<br/>**Hidden**: when the variable "rougail.condition" is defined and has the value "true".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
 

tests/results/test_namespace/04_5disabled_calculation_optional_default.sh

@@ -9,13 +9,18 @@
 │ rougail.condition                     │ A condition.                         │
 │  boolean   standard   mandatory       │ Default: false                       │
 ├───────────────────────────────────────┼──────────────────────────────────────┤
+│ rougail.var1                          │ A first variable.                    │
+│  string   standard   hidden           │ Hidden: when the variable            │
+│                                       │ "rougail.unknown" is defined and has │
+│                                       │ the value "true".                    │
+├───────────────────────────────────────┼──────────────────────────────────────┤
 │ rougail.var3                          │ A second variable.                   │
 │  string   standard   hidden           │ Hidden: when the variable            │
-│                                       │ "rougail.condition" has the value    │
-│                                       │ "true".                              │
+│                                       │ "rougail.condition" is defined and   │
+│                                       │ has the value "true".                │
 ├───────────────────────────────────────┼──────────────────────────────────────┤
 │ rougail.var4                          │ A forth variable.                    │
 │  string   standard   hidden           │ Hidden: when the variable            │
-│                                       │ "rougail.condition" has the value    │
-│                                       │ "true".                              │
+│                                       │ "rougail.condition" is defined and   │
+│                                       │ has the value "true".                │
 └───────────────────────────────────────┴──────────────────────────────────────┘

tests/results/test_namespace/60_5family_dynamic_calc_suffix_empty.adoc

@@ -41,6 +41,6 @@ A dynamic variable.
 **rougail.var2** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory`            | 
 A variable calculated. +
-**Default**: the value of the variable "rougail.dynval1.var".               
+**Default**: the value of the variable "rougail.dynval1.var" if it is defined.               
 |====
 

tests/results/test_namespace/60_5family_dynamic_calc_suffix_empty.json

@@ -111,7 +111,7 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "the value of the variable \"rougail.dynval1.var\"."
+          "values": "the value of the variable \"rougail.dynval1.var\" if it is defined."
         },
         "properties": [
           {

tests/results/test_namespace/60_5family_dynamic_calc_suffix_empty.md

@@ -18,5 +18,5 @@ This family builds families dynamically.
 
 | Variable                                                                                                             | Description                                                                                                          |
 |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **rougail.var2**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | A variable calculated.<br/>**Default**: the value of the variable "rougail.dynval1.var".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| **rougail.var2**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | A variable calculated.<br/>**Default**: the value of the variable "rougail.dynval1.var" if it is defined.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
 

tests/results/test_namespace/60_5family_dynamic_calc_suffix_empty.sh

@@ -37,5 +37,6 @@ This family builds families dynamically.
 ┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
 │ rougail.var2                          │ A variable calculated.               │
 │  string   standard   mandatory        │ Default: the value of the variable   │
-│                                       │ "rougail.dynval1.var".               │
+│                                       │ "rougail.dynval1.var" if it is       │
+│                                       │ defined.                             │
 └───────────────────────────────────────┴──────────────────────────────────────┘

tests/results/test_namespace/60_5family_dynamic_calc_suffix_empty_2.adoc

@@ -37,6 +37,6 @@ A dynamic variable.
 **rougail.var2** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory`            | 
 A variable calculated. +
-**Default**: the value of the variable "rougail.dynval1.var".               
+**Default**: the value of the variable "rougail.dynval1.var" if it is defined.               
 |====
 

tests/results/test_namespace/60_5family_dynamic_calc_suffix_empty_2.json

@@ -104,7 +104,7 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "the value of the variable \"rougail.dynval1.var\"."
+          "values": "the value of the variable \"rougail.dynval1.var\" if it is defined."
         },
         "properties": [
           {

tests/results/test_namespace/60_5family_dynamic_calc_suffix_empty_2.md

@@ -18,5 +18,5 @@ This family builds families dynamically.
 
 | Variable                                                                                                             | Description                                                                                                          |
 |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **rougail.var2**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | A variable calculated.<br/>**Default**: the value of the variable "rougail.dynval1.var".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| **rougail.var2**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | A variable calculated.<br/>**Default**: the value of the variable "rougail.dynval1.var" if it is defined.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
 

tests/results/test_namespace/60_5family_dynamic_calc_suffix_empty_2.sh

@@ -35,5 +35,6 @@ This family builds families dynamically.
 ┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
 │ rougail.var2                          │ A variable calculated.               │
 │  string   standard   mandatory        │ Default: the value of the variable   │
-│                                       │ "rougail.dynval1.var".               │
+│                                       │ "rougail.dynval1.var" if it is       │
+│                                       │ defined.                             │
 └───────────────────────────────────────┴──────────────────────────────────────┘

tests/results/test_namespace/60_5family_dynamic_calc_suffix_empty_3.adoc

@@ -8,7 +8,7 @@
 **rougail.var2** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory`            | 
 A variable calculated. +
-**Default**: the value of the variable "rougail.dynval1.var".               
+**Default**: the value of the variable "rougail.dynval1.var" if it is defined.               
 | 
 
 **rougail.var1** +

tests/results/test_namespace/60_5family_dynamic_calc_suffix_empty_3.json

@@ -21,7 +21,7 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "the value of the variable \"rougail.dynval1.var\"."
+          "values": "the value of the variable \"rougail.dynval1.var\" if it is defined."
         },
         "properties": [
           {

tests/results/test_namespace/60_5family_dynamic_calc_suffix_empty_3.md

@@ -2,7 +2,7 @@
 
 | Variable                                                                                                             | Description                                                                                                          |
 |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **rougail.var2**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | A variable calculated.<br/>**Default**: the value of the variable "rougail.dynval1.var".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| **rougail.var2**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | A variable calculated.<br/>**Default**: the value of the variable "rougail.dynval1.var" if it is defined.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
 | **rougail.var1**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | A suffix variable.<br/>**Examples**: <br/>- val1<br/>- val2                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
 
 ## rougail.dyn*val1* or rougail.dyn*val2*

tests/results/test_namespace/60_5family_dynamic_calc_suffix_empty_3.sh

@@ -8,7 +8,8 @@
 ┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
 │ rougail.var2                          │ A variable calculated.               │
 │  string   standard   mandatory        │ Default: the value of the variable   │
-│                                       │ "rougail.dynval1.var".               │
+│                                       │ "rougail.dynval1.var" if it is       │
+│                                       │ defined.                             │
 ├───────────────────────────────────────┼──────────────────────────────────────┤
 │ rougail.var1                          │ A suffix variable.                   │
 │  string   standard   unique           │ Examples:                            │

tests/results/test_namespace/60_5family_dynamic_calc_variable_empty.adoc

@@ -41,6 +41,6 @@ A dynamic variable.
 **rougail.var2** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory`            | 
 A variable calculated. +
-**Default**: the value of the variable "rougail.dynval1.var".               
+**Default**: the value of the variable "rougail.dynval1.var" if it is defined.               
 |====
 

tests/results/test_namespace/60_5family_dynamic_calc_variable_empty.json

@@ -111,7 +111,7 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "the value of the variable \"rougail.dynval1.var\"."
+          "values": "the value of the variable \"rougail.dynval1.var\" if it is defined."
         },
         "properties": [
           {

tests/results/test_namespace/60_5family_dynamic_calc_variable_empty.md

@@ -18,5 +18,5 @@ This family builds families dynamically.
 
 | Variable                                                                                                             | Description                                                                                                          |
 |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **rougail.var2**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | A variable calculated.<br/>**Default**: the value of the variable "rougail.dynval1.var".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| **rougail.var2**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | A variable calculated.<br/>**Default**: the value of the variable "rougail.dynval1.var" if it is defined.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
 

tests/results/test_namespace/60_5family_dynamic_calc_variable_empty.sh

@@ -37,5 +37,6 @@ This family builds families dynamically.
 ┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
 │ rougail.var2                          │ A variable calculated.               │
 │  string   standard   mandatory        │ Default: the value of the variable   │
-│                                       │ "rougail.dynval1.var".               │
+│                                       │ "rougail.dynval1.var" if it is       │
+│                                       │ defined.                             │
 └───────────────────────────────────────┴──────────────────────────────────────┘

tests/results/test_namespace/60_5family_dynamic_variable_outside_sub_suffix_empty.adoc

@@ -54,7 +54,9 @@ A variable inside a sub dynamic family. +
 A variable. +
 **Default**: 
 
-* the value of the variable "rougail.my_dyn_family_val1.subdyn___val1__.var"
-* the value of the variable "rougail.my_dyn_family_val1.subdyn___val2__.var"               
+* the value of the variable "rougail.my_dyn_family_val1.subdyn___val1__.var" if it
+is defined
+* the value of the variable "rougail.my_dyn_family_val1.subdyn___val2__.var" if it
+is defined               
 |====
 

tests/results/test_namespace/60_5family_dynamic_variable_outside_sub_suffix_empty.json

@@ -151,8 +151,8 @@
         "default": {
           "name": "Default",
           "values": [
-            "the value of the variable \"rougail.my_dyn_family_val1.subdyn_val1.var\"",
-            "the value of the variable \"rougail.my_dyn_family_val1.subdyn_val2.var\""
+            "the value of the variable \"rougail.my_dyn_family_val1.subdyn_val1.var\" if it is defined",
+            "the value of the variable \"rougail.my_dyn_family_val1.subdyn_val2.var\" if it is defined"
           ]
         },
         "properties": [

tests/results/test_namespace/60_5family_dynamic_variable_outside_sub_suffix_empty.md

@@ -26,5 +26,5 @@ This family builds families dynamically.
 
 | Variable                                                                                                             | Description                                                                                                          |
 |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **rougail.var2**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | A variable.<br/>**Default**: <br/>- the value of the variable "rougail.my_dyn_family_val1.subdyn_*val1*.var"<br/>- the value of the variable "rougail.my_dyn_family_val1.subdyn_*val2*.var"                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| **rougail.var2**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | A variable.<br/>**Default**: <br/>- the value of the variable "rougail.my_dyn_family_val1.subdyn_*val1*.var" if it is defined<br/>- the value of the variable "rougail.my_dyn_family_val1.subdyn_*val2*.var" if it is defined                                                                                                                                                                                                                                                                                                                                                                                                                           |
 

tests/results/test_namespace/60_5family_dynamic_variable_outside_sub_suffix_empty.sh

@@ -55,6 +55,8 @@ This family builds families dynamically.
 │  string   standard   unique           │ Default:                             │
 │ multiple                              │ - the value of the variable          │
 │                                       │ "rougail.my_dyn_family_val1.subdyn_… │
+│                                       │ if it is defined                     │
 │                                       │ - the value of the variable          │
 │                                       │ "rougail.my_dyn_family_val1.subdyn_… │
+│                                       │ if it is defined                     │
 └───────────────────────────────────────┴──────────────────────────────────────┘

tests/results/test_namespace/60_5family_dynamic_variable_outside_suffix_empty.adoc

@@ -42,6 +42,6 @@ A variable inside dynamic family. +
 **rougail.var2** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard`            | 
 A variable. +
-**Default**: the value of the variable "rougail.dyn_val1.var".               
+**Default**: the value of the variable "rougail.dyn_val1.var" if it is defined.               
 |====
 

tests/results/test_namespace/60_5family_dynamic_variable_outside_suffix_empty.json

@@ -116,7 +116,7 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "the value of the variable \"rougail.dyn_val1.var\"."
+          "values": "the value of the variable \"rougail.dyn_val1.var\" if it is defined."
         },
         "properties": [
           {

tests/results/test_namespace/60_5family_dynamic_variable_outside_suffix_empty.md

@@ -18,5 +18,5 @@ This family builds families dynamically.
 
 | Variable                                                                                                             | Description                                                                                                          |
 |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **rougail.var2**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | A variable.<br/>**Default**: the value of the variable "rougail.dyn_val1.var".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| **rougail.var2**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | A variable.<br/>**Default**: the value of the variable "rougail.dyn_val1.var" if it is defined.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 

tests/results/test_namespace/60_5family_dynamic_variable_outside_suffix_empty.sh

@@ -37,5 +37,6 @@ This family builds families dynamically.
 ┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
 │ rougail.var2                          │ A variable.                          │
 │  string   standard                    │ Default: the value of the variable   │
-│                                       │ "rougail.dyn_val1.var".              │
+│                                       │ "rougail.dyn_val1.var" if it is      │
+│                                       │ defined.                             │
 └───────────────────────────────────────┴──────────────────────────────────────┘

tests/results/test_namespace_examples/00_6string.md

@@ -18,4 +18,6 @@ rougail:
   var4: value
   var5: value
   var6: value
+  var7: '8080'
+  var8: 'true'
 ```

tests/results/test_namespace_examples/04_5disabled_calculation_optional_default.md

@@ -4,6 +4,7 @@
 ---
 rougail:
   condition: false
+  var1: example
   var3: example
   var4: example
 ```