Add shortcodes for markdown templates

rdmo/core/settings.py

@@ -551,3 +551,7 @@
 
 # necessary since django 3.2, explicitly set primary key type to avoid warnings
 DEFAULT_AUTO_FIELD = 'django.db.models.AutoField'
+
+MARKDOWN_TEMPLATES: dict[str, str] = {
+    # for example: 'not_empty': 'core/text_blocks/template_for_not_empty.html',
+}

rdmo/core/utils.py

@@ -10,7 +10,7 @@
 from django.apps import apps
 from django.conf import settings
 from django.http import Http404, HttpResponse, HttpResponseBadRequest
-from django.template.loader import get_template
+from django.template.loader import get_template, render_to_string
 from django.utils.encoding import force_str
 from django.utils.translation import gettext_lazy as _
 
@@ -392,6 +392,18 @@ def markdown2html(markdown_string):
         f'<span class="show-less" onclick="showLess(this)"> ({hide_string})</span></p>',
         html
     )
+    html = inject_textblocks(html)
+    return html
+
+
+def inject_textblocks(html):
+    '''textblocks (e.g. for help texts) can be injected into free text fields as small templates via Markdown'''
+    for textblock_id in re.findall(r'{{(.*?)}}', html):      # strings between curly brackets
+        template_path:  str = settings.MARKDOWN_TEMPLATES[textblock_id]
+        html                = re.sub(   '{{' + textblock_id + '}}',
+                                        render_to_string(template_path),
+                                        html
+                                    )
     return html
 
 
@@ -417,4 +429,4 @@ def save_metadata(metadata):
         json.dump(metadata, f)
     f = open(tmp_metadata_file)
     log.info('Save metadata file %s %s', tmp_metadata_file, str(metadata))
-    return tmp_metadata_file
+    return tmp_metadata_file