🆕 Template for metadata tags

Generates a md table with @author, @deprecated, @SInCE, @see and @link 
references

Author: nelson6e65

data/templates/vuepress/class.md.twig

@@ -79,27 +79,7 @@
     {%- endfor -%}
 |
 
-| | |
-|:---:| --- |
-| **Authors** |
-    {%- for author in class.tags.author -%}
-      {{ author.description }} <br />
-    {%- endfor -%}
-|
-
-
-{% if class.tags.see is not empty or class.tags.link is not empty %}
-***See Also:***
-
-{% for see in class.tags.see %}
-* `{{ see.reference }}` {% if see.description %}-{% endif %} {{ see.description }}
-{% endfor %}
-
-{% for link in class.tags.link %}
-* [{{ link.description|default(link.link) }}]({{ link.link }})
-{% endfor %}
-
-{% endif %}{# class.tags.see || class.tags.link #}
+{{ include('metadata-table.md.twig', { elem: class }) }}
 
 {% set methodsList = [] %}
 ### <span style="display: none;">{{ class }}</span> Methods

data/templates/vuepress/interface.md.twig

@@ -4,6 +4,7 @@
 
 {{ interface.description|replace({'#### ': '- ', '### ': '- ', '## ': '- ', '# ': '- ',}) }}
 
+
 {#- Parents -#}
 {% set parents = [] %}
 
@@ -37,27 +38,7 @@
     {%- endfor -%}
 |
 
-| | |
-|:---:| --- |
-| **Authors** |
-    {%- for author in interface.tags.author -%}
-      {{ author.description }} <br />
-    {%- endfor -%}
-|
-
-
-{% if interface.tags.see is not empty or interface.tags.link is not empty %}
-***See Also:***
-
-{% for see in interface.tags.see %}
-* `{{ see.reference }}` {% if see.description %}-{% endif %} {{ see.description }}
-{% endfor %}
-
-{% for link in interface.tags.link %}
-* [{{ link.description|default(link.link) }}]({{ link.link }})
-{% endfor %}
-
-{% endif %}{# interface.tags.see || interface.tags.link #}
+{{ include('metadata-table.md.twig', { elem: interface }) }}
 
 ### <span style="display: none;">{{ interface }}</span> Methods
 {# Lista de métodos públicos y protegidos #}

data/templates/vuepress/metadata-table.md.twig

@@ -0,0 +1,62 @@
+| | |
+|:--------:| ----------- |
+{{ '' }}
+
+{%- if elem.tags.since is not empty %}
+| ***Since*** |
+    {%- for since in elem.tags.since -%}
+        `
+        {%- if since.version -%}
+            v
+        {%- endif -%}
+
+        {{- since.version|default('undefined') -}}
+        `
+
+        {%- if since.description -%}
+            {{ ': ' ~ since.description }}
+        {%- endif -%}
+
+         <br />
+    {%- endfor -%}
+|
+{% endif %}
+
+{%- if elem.deprecated %}
+| **Deprecated** |
+    {%- for deprecated in elem.tags.deprecated -%}
+        {%- if deprecated.version -%}
+            Since `v{{ deprecated.version }}`
+
+            {%- if deprecated.description -%}
+                {{ ': ' }}
+            {%- endif -%}
+
+        {%- elseif deprecated.description is empty -%}
+            Yes
+        {%- endif -%}
+
+        {{ deprecated.description }} <br />
+    {%- endfor -%}
+|
+{% endif %}
+
+{%- if elem.tags.author is not empty %}
+| **Authors** |
+    {%- for author in elem.tags.author -%}
+      {{ author.description }} <br />
+    {%- endfor -%}
+|
+{% endif %}
+
+{%- if elem.tags.see is not empty or elem.tags.link is not empty %}
+| **See also** |
+    {%- for see in elem.tags.see -%}
+        `{{ see.reference }}` {% if see.description %}<br />{% endif %} {{ see.description }} <br /> {# TODO: Make references linkables #}
+    {%- endfor -%}
+
+    {%- for link in elem.tags.link -%}
+        [{{ link.description|default(link.link) }}]({{ link.link }}) <br />
+    {%- endfor -%}
+|
+{% endif %}

data/templates/vuepress/method.md.twig

@@ -28,25 +28,14 @@
 {{ method.description|replace({'#### ': '- ', '### ': '- ', '## ': '- ', '# ': '- ',}) }}
 {% endif %}
 
+{{ include('metadata-table.md.twig', { elem: method }) }}
+
+
 {% if method.response.description %}
-***Return Value:***
+***Returns:***
 
 {{ method.response.description|raw }}
 
 {% endif %}
 
-
-{% if method.tags.see is not empty or method.tags.link is not empty %}
-***See Also:***
-
-{% for see in method.tags.see %}
-* `{{ see.reference }}` {% if see.description %}-{% endif %} {{ see.description }}
-{% endfor %}
-
-{% for link in class.tags.link %}
-* [{{ link.description|default(link.link) }}]({{ link.link }})
-{% endfor %}
-
-{% endif %}{# class.tags.see || class.tags.link #}
-
 :::

data/templates/vuepress/property.md.twig

@@ -30,18 +30,6 @@
 {{ property.description|replace({'#### ': '- ', '### ': '- ', '## ': '- ', '# ': '- ',}) }}
 {% endif %}
 
-
-{% if method.tags.see is not empty or method.tags.link is not empty %}
-***See Also:***
-
-{% for see in method.tags.see %}
-* `{{ see.reference }}` {% if see.description %}-{% endif %} {{ see.description }}
-{% endfor %}
-
-{% for link in class.tags.link %}
-* [{{ link.description|default(link.link) }}]({{ link.link }})
-{% endfor %}
-
-{% endif %}{# class.tags.see || class.tags.link #}
+{{ include('metadata-table.md.twig', { elem: property }) }}
 
 :::

data/templates/vuepress/trait.md.twig

@@ -2,7 +2,6 @@
 
 {{ trait.summary|replace({'#### ': '- ', '### ': '- ', '## ': '- ', '# ': '- ',}) }}
 
-{{ trait.description|replace({'#### ': '- ', '### ': '- ', '## ': '- ', '# ': '- ',}) }}
 
 {#- Used traits -#}
 {% set usedTraits = [] %}
@@ -29,7 +28,7 @@
 
 |     |     |
 | ---:| --- |
-| ***Uses*** {# FIXME #} |
+| **Uses** {# FIXME #} |
     {%- for tName, tShort in usedTraits if tShort is not empty -%}
         [{{ tName|trim('\\')|split('\\')|slice(0, -1)|join('\\') }}\\<span style="font-weight: bold;">{{ tShort }}</span>](/api/traits.html#
         {{- tName|trim('\\')|lower|replace('\\', '-') }}) <br />
@@ -38,27 +37,16 @@
     {%- endfor -%}
 |
 
-| | |
-|:---:| --- |
-| ***Authors*** |
-    {%- for author in trait.tags.author -%}
-      {{ author.description }} <br />
-    {%- endfor -%}
-|
-
-
-{% if trait.tags.see is not empty or trait.tags.link is not empty %}
-***See Also:***
+### Description
 
-{% for see in trait.tags.see %}
-* `{{ see.reference }}` {% if see.description %}-{% endif %} {{ see.description }}
-{% endfor %}
+{% if trait.description %}
+{{ trait.description|replace({'#### ': '- ', '### ': '- ', '## ': '- ', '# ': '- ',}) -}}
+{% else %}
+> No description.
+{% endif %}
 
-{% for link in trait.tags.link %}
-* [{{ link.description|default(link.link) }}]({{ link.link }})
-{% endfor %}
+{{ include('metadata-table.md.twig', { elem: trait}) }}
 
-{% endif %}{# class.tags.see || class.tags.link #}
 
 ### <span style="display: none;">{{ trait }}</span> Methods
 {# Lista de métodos públicos y protegidos #}