Description on tag pages (#443)

blog/migrations/0020_tag_description.py

@@ -0,0 +1,18 @@
+# Generated by Django A.B on YYYY-MM-DD HH:MM
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("blog", "0019_blogmark_use_markdown"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="tag",
+            name="description",
+            field=models.TextField(blank=True),
+        ),
+    ]

blog/models.py

@@ -19,10 +19,17 @@
 
 class Tag(models.Model):
     tag = models.SlugField(unique=True)
+    description = models.TextField(blank=True)  # Added description field
 
     def __str__(self):
         return self.tag
 
+    def description_rendered(self):
+        if self.description:
+            return mark_safe(markdown(self.description))
+        else:
+            return ''
+
     def get_absolute_url(self):
         return "/tags/%s/" % self.tag
 

static/css/all.css

@@ -1144,3 +1144,7 @@ div.ea-placement a:link {
   margin-left: 1em;
   margin-bottom: 0.1em;
 }
+
+.tag-description {
+    margin-bottom: 1em;
+}

templates/archive_tag.html

@@ -4,6 +4,10 @@
 
 {% block primary %}
 <h2 class="archive-tag-h2">{{ total }} item{{ total|pluralize }} tagged “{{ tags|join:"” and “" }}”</h2>
+<!-- Tag ID: {{ tag.pk }} -->
+{% if tag.description %}
+    <div class="tag-description">{{ tag.description_rendered }}</div>
+{% endif %}
 
 {% if total > 10 %}
     <form action="/search/" method="GET">