feat: Support examples section

References: #112

Co-authored-by: Iago GR <igonro@gmail.com>

Co-authored-by: Timothée Mazzucotelli <pawamoy@pm.me>

src/mkdocstrings/templates/python/material/docstring.html

@@ -14,6 +14,10 @@
       {% with return = section.value %}
         {% include "return.html" with context %}
       {% endwith %}
+    {% elif section.type == "examples" %}
+      {% with examples = section.value %}
+        {% include "examples.html" with context %}
+      {% endwith %}
     {% endif %}
   {% endfor %}
 {% endif %}

src/mkdocstrings/templates/python/material/examples.html

@@ -0,0 +1,8 @@
+<p><strong>Examples:</strong></p>
+{% for section_type, sub_section in examples %}
+  {% if section_type == "markdown" %}
+    {{ sub_section|convert_markdown }}
+  {% elif section_type == "examples" %}
+    {{ sub_section|highlight(language="python", line_nums=False) }}
+  {% endif %}
+{% endfor %}