django-mosaic 0.1.0__py3-none-any.whl

django_mosaic/admin.py

@@ -0,0 +1,67 @@
+from django.contrib import admin
+from django.db import models
+from django import forms
+from django.utils.html import format_html
+from mosaic.models import Post, Tag, ContentImage
+
+
+class ContentImageInlineAdmin(admin.TabularInline):
+    model = ContentImage
+    readonly_fields = ["thumb", "thumbnail_preview", "copy_markdown_button"]
+    fields = ["image", "thumbnail_preview", "caption", "alt", "copy_markdown_button"]
+
+    def thumbnail_preview(self, obj):
+        if obj.thumb:
+            return format_html(
+                '<img src="{}" style="max-height: 100px; max-width: 200px;" />',
+                obj.thumb.url,
+            )
+        return "No thumbnail"
+
+    thumbnail_preview.short_description = "Preview"
+
+    def copy_markdown_button(self, obj):
+        if obj.pk:
+            markdown_text = obj.markdown()
+            return format_html(
+                '<button type="button" class="button" '
+                'onclick="navigator.clipboard.writeText(this.dataset.markdown).then(() => '
+                "{{ this.textContent = 'Copied!'; setTimeout(() => this.textContent = 'Copy Markdown', 1500) }})\""
+                'data-markdown="{}">'
+                "Copy Markdown"
+                "</button>",
+                markdown_text.replace('"', "&quot;"),
+            )
+        return ""
+
+    copy_markdown_button.short_description = "Markdown"
+
+
+class PostAdmin(admin.ModelAdmin):
+    readonly_fields = ["created_at"]
+    list_display = ["title", "published_at", "namespace", "is_published", "created_at"]
+    list_filter = ["is_published", "namespace", "tags", "published_at"]
+
+    formfield_overrides = {
+        models.TextField: {
+            "widget": forms.Textarea(
+                attrs={"rows": "20", "style": "max-height: none; width: 100%"}
+            )
+        },
+    }
+
+    inlines = [ContentImageInlineAdmin]
+
+
+class ContentImageAdmin(admin.ModelAdmin):
+    readonly_fields = ["image", "thumb"]
+    list_display = ["alt", "caption", "post", "post__created_at"]
+
+
+class TagAdmin(admin.ModelAdmin):
+    pass
+
+
+admin.site.register(Post, PostAdmin)
+admin.site.register(Tag, TagAdmin)
+admin.site.register(ContentImage, ContentImageAdmin)

django_mosaic/apps.py

@@ -0,0 +1,5 @@
+from django.apps import AppConfig
+
+
+class BlogConfig(AppConfig):
+    name = "mosaic"

django_mosaic/feeds.py

@@ -0,0 +1,25 @@
+from django.contrib.syndication.views import Feed
+from django.conf import settings
+
+from mosaic.models import Post, Namespace
+
+
+class PostFeed(Feed):
+    title = settings.CONSTANTS["site"]["title"]
+    link = "/"
+    description = settings.CONSTANTS["site"]["description"]
+
+    def get_object(self, request, namespace):
+        return Namespace.objects.get(name=namespace)
+
+    def items(self, obj):
+        return Post.objects.filter(namespace=obj)
+
+    def item_title(self, item):
+        return item.title
+
+    def item_description(self, item):
+        return item.content
+
+    def item_pubdate(self, item):
+        return item.published_at

django_mosaic/management/commands/import.py

@@ -0,0 +1,71 @@
+from pathlib import Path
+import yaml
+import dateutil
+import logging
+
+from django.core.management.base import BaseCommand
+from django.utils.text import slugify
+from mosaic.models import Post, Tag, Namespace
+
+EXPECTED_KEYWORDS = ["title", "date", "draft"]
+
+logger = logging.getLogger(__name__)
+
+
+class Command(BaseCommand):
+    help = "Imports markdown posts with a yaml header"
+
+    def add_arguments(self, parser):
+        parser.add_argument("path", type=Path)
+        parser.add_argument("category", type=str)
+
+    def handle(self, *args, **options):
+        ns = Namespace.objects.get(name=options["category"])
+
+        for file in options["path"].glob("**/*.md"):
+            logger.info(f"Importing {file}")
+            with open(file, "r") as f:
+                try:
+                    file_content = f.read()
+                    _, header, content = file_content.split("---", maxsplit=2)
+
+                    header = yaml.load(header, Loader=yaml.BaseLoader)
+
+                    if not all(ek in header.keys() for ek in EXPECTED_KEYWORDS):
+                        raise ValueError(
+                            f"Could not find all expected keywords in post metadata. Expected {EXPECTED_KEYWORDS}, found {header.keys()}"
+                        )
+
+                    slug = header.get("slug", slugify(header["title"]))
+
+                    tags = []
+                    header_tags = [t.strip() for t in header.get("tags", "").split(",") if t]
+                    header_categories = [c.strip() for c in header.get("categories", "").split(",") if c]
+                    header_tags.extend(header_categories)
+
+                    if header_tags:
+                        for t in header_tags:
+                            if not isinstance(t, str):
+                                logger.warning(
+                                    f"Could not process tag {t}, not a string"
+                                )
+                                continue
+
+                            t, _ = Tag.objects.get_or_create(name=t, namespace=ns)
+                            tags.append(t)
+
+                    post = Post(
+                        title=header["title"],
+                        is_published=not header["draft"],
+                        published_at=dateutil.parser.parse(header["date"]),
+                        slug=slug,
+                        namespace=ns,
+                        summary=header.get("description", ""),
+                        content=content,
+                    )
+                    post.save()
+                    for t in tags:
+                        post.tags.add(t)
+                    logger.info(f"Created post {post} with tags {tags}")
+                except Exception as e:
+                    logger.error(f"Could not import {file}: {e}", exc_info=True)

django_mosaic/migrations/0001_initial_squashed_0008_alter_tag_name_alter_tag_unique_together.py

@@ -0,0 +1,124 @@
+# Generated by Django 6.0.1 on 2026-01-22 13:17
+
+import django.db.models.deletion
+import django.utils.timezone
+from django.db import migrations, models
+
+
+def add_default_namespace(apps, schema_editor):
+    Namespace = apps.get_model("mosaic", "Namespace")
+    Namespace.objects.create(name="public")
+    Namespace.objects.create(name="private")
+
+
+class Migration(migrations.Migration):
+
+    replaces = [
+        ("mosaic", "0001_initial"),
+        ("mosaic", "0002_remove_post_category_alter_post_options_and_more"),
+        ("mosaic", "0003_post__summary"),
+        ("mosaic", "0004_alter_post__summary"),
+        ("mosaic", "0005_tag_is_public"),
+        (
+            "mosaic",
+            "0006_namespace_remove_post__summary_remove_post_is_public_and_more",
+        ),
+        ("mosaic", "0007_post_namespace_tag_namespace"),
+        ("mosaic", "0008_alter_tag_name_alter_tag_unique_together"),
+    ]
+
+    dependencies = []
+
+    operations = [
+        migrations.CreateModel(
+            name="Tag",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("name", models.CharField(max_length=256, unique=True)),
+            ],
+        ),
+        migrations.CreateModel(
+            name="Namespace",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("name", models.SlugField(max_length=256, unique=True)),
+            ],
+        ),
+        migrations.RunPython(
+            code=add_default_namespace,
+        ),
+        migrations.CreateModel(
+            name="Post",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("title", models.CharField(max_length=512, unique=True)),
+                ("content", models.TextField()),
+                ("slug", models.SlugField(max_length=256, unique=True)),
+                ("is_draft", models.BooleanField(default=True)),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+                ("changed_at", models.DateTimeField(auto_now=True)),
+                ("tags", models.ManyToManyField(to="mosaic.tag")),
+                (
+                    "published_at",
+                    models.DateTimeField(blank=True, default=django.utils.timezone.now),
+                ),
+                ("summary", models.CharField(blank=True, max_length=1024)),
+            ],
+            options={
+                "ordering": ["-published_at"],
+            },
+        ),
+        migrations.AddField(
+            model_name="post",
+            name="namespace",
+            field=models.ForeignKey(
+                default=1,
+                on_delete=django.db.models.deletion.PROTECT,
+                to="mosaic.namespace",
+            ),
+            preserve_default=False,
+        ),
+        migrations.AddField(
+            model_name="tag",
+            name="namespace",
+            field=models.ForeignKey(
+                default=1,
+                on_delete=django.db.models.deletion.PROTECT,
+                to="mosaic.namespace",
+            ),
+            preserve_default=False,
+        ),
+        migrations.AlterField(
+            model_name="tag",
+            name="name",
+            field=models.CharField(max_length=256),
+        ),
+        migrations.AlterUniqueTogether(
+            name="tag",
+            unique_together={("name", "namespace")},
+        ),
+    ]

django_mosaic/migrations/0009_alter_post_published_at.py

@@ -0,0 +1,21 @@
+# Generated by Django 6.0.1 on 2026-01-22 13:20
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        (
+            "mosaic",
+            "0001_initial_squashed_0008_alter_tag_name_alter_tag_unique_together",
+        ),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="post",
+            name="published_at",
+            field=models.DateTimeField(blank=True),
+        ),
+    ]

django_mosaic/migrations/0010_alter_post_published_at_alter_post_slug_and_more.py

@@ -0,0 +1,28 @@
+# Generated by Django 6.0.1 on 2026-01-22 18:00
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("mosaic", "0009_alter_post_published_at"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="post",
+            name="published_at",
+            field=models.DateTimeField(blank=True, null=True),
+        ),
+        migrations.AlterField(
+            model_name="post",
+            name="slug",
+            field=models.SlugField(blank=True, max_length=256, unique=True),
+        ),
+        migrations.AlterField(
+            model_name="post",
+            name="tags",
+            field=models.ManyToManyField(blank=True, null=True, to="mosaic.tag"),
+        ),
+    ]

django_mosaic/migrations/0011_remove_post_is_draft_post_is_published_and_more.py

@@ -0,0 +1,37 @@
+# Generated by Django 6.0.1 on 2026-01-26 08:51
+
+from django.db import migrations, models
+
+
+def invert_is_draft(apps, schema):
+    Post = apps.get_model("mosaic", "Post")
+    drafts = Post.objects.filter(is_published=True)
+    public = Post.objects.filter(is_published=False)
+    drafts.update(is_published=False)
+    public.update(is_published=True)
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("mosaic", "0010_alter_post_published_at_alter_post_slug_and_more"),
+    ]
+
+    operations = [
+        migrations.RenameField(
+            model_name="post",
+            old_name="is_draft",
+            new_name="is_published"
+        ),
+        migrations.AlterField(
+            model_name="post",
+            name="is_published",
+            field=models.BooleanField(default=False),
+        ),
+        migrations.AlterField(
+            model_name="post",
+            name="tags",
+            field=models.ManyToManyField(blank=True, to="mosaic.tag"),
+        ),
+        migrations.RunPython(invert_is_draft),
+    ]

django_mosaic/migrations/0012_author_post_author.py

@@ -0,0 +1,38 @@
+# Generated by Django 6.0.1 on 2026-02-03 10:48
+
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("mosaic", "0011_remove_post_is_draft_post_is_published_and_more"),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="Author",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("h_card", models.JSONField()),
+                (
+                    "user",
+                    models.OneToOneField(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+            ],
+        ),
+    ]

django_mosaic/migrations/0013_add_author_to_post.py

@@ -0,0 +1,26 @@
+# Generated by Django 6.0.1 on 2026-02-03 10:48
+
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("mosaic", "0012_author_post_author"),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="post",
+            name="author",
+            field=models.ForeignKey(
+                default=1,
+                on_delete=django.db.models.deletion.PROTECT,
+                to="mosaic.author",
+            ),
+            preserve_default=False,
+        ),
+    ]

django_mosaic/migrations/0014_contentimage.py

@@ -0,0 +1,43 @@
+# Generated by Django 6.0.1 on 2026-02-03 15:39
+
+import mosaic.models
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("mosaic", "0013_add_author_to_post"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="ContentImage",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                (
+                    "image",
+                    models.ImageField(upload_to="static/images"),
+                ),
+                (
+                    "thumb",
+                    models.ImageField(
+                        blank=True,
+                        editable=False,
+                        null=True,
+                        upload_to="static/images",
+                    ),
+                ),
+                ("caption", models.CharField(blank=True, default="", max_length=2048)),
+                ("alt", models.CharField(blank=True, default="", max_length=2048)),
+            ],
+        ),
+    ]

django_mosaic/migrations/0015_contentimage_post.py

@@ -0,0 +1,22 @@
+# Generated by Django 6.0.1 on 2026-02-03 15:45
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("mosaic", "0014_contentimage"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="contentimage",
+            name="post",
+            field=models.ForeignKey(
+                default=1, on_delete=django.db.models.deletion.CASCADE, to="mosaic.post"
+            ),
+            preserve_default=False,
+        ),
+    ]

django_mosaic/migrations/0016_alter_contentimage_image_alter_contentimage_thumb.py

@@ -0,0 +1,25 @@
+# Generated by Django 6.0.1 on 2026-02-03 16:10
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("mosaic", "0015_contentimage_post"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="contentimage",
+            name="image",
+            field=models.ImageField(upload_to="content/images/"),
+        ),
+        migrations.AlterField(
+            model_name="contentimage",
+            name="thumb",
+            field=models.ImageField(
+                blank=True, editable=False, null=True, upload_to="content/images/"
+            ),
+        ),
+    ]

django_mosaic/models.py

@@ -0,0 +1,162 @@
+import bleach
+import markdown
+import secrets
+from PIL import Image
+from io import BytesIO
+import os
+import logging
+
+import django.utils.timezone
+from django.utils.text import slugify
+from django.urls import reverse
+from django.db import models
+from django.contrib.auth.models import User
+from django.core.files.base import ContentFile
+
+logger = logging.getLogger("mosaic")
+
+
+class Namespace(models.Model):
+    name = models.SlugField(max_length=256, unique=True, blank=False, null=False)
+
+    def __str__(self):
+        return self.name
+
+    def __repr__(self):
+        return f"<Namespace {self.name}>"
+
+
+class Author(models.Model):
+    user = models.OneToOneField(User, on_delete=models.CASCADE)
+    h_card = models.JSONField()
+
+    def __str__(self):
+        return self.user.username
+
+    def __repr__(self):
+        return f"<Author {self.user.username}>"
+
+
+class ContentImage(models.Model):
+    image = models.ImageField(upload_to="content/images/")
+    thumb = models.ImageField(
+        upload_to="content/images/", blank=True, null=True, editable=False
+    )
+    caption = models.CharField(max_length=2048, null=False, blank=True, default="")
+    alt = models.CharField(max_length=2048, null=False, blank=True, default="")
+    post = models.ForeignKey("Post", on_delete=models.CASCADE)
+
+    def __str__(self):
+        return "Image"
+
+    def __repr__(self):
+        return f"<Image {self.image} [{self.alt[:50]}]>"
+
+    def save(self, *args, **kwargs):
+        # Only generate thumbnail on creation
+        if not self.pk and self.image:
+            try:
+                # Generate random filename
+                ext = self.image.name.split(".")[-1]
+                random_name = secrets.token_hex(16)
+                new_filename = f"{random_name}.{ext}"
+
+                # Rename the image file
+                self.image.name = new_filename
+
+                # Generate thumbnail
+                img = Image.open(self.image.file)
+                img.thumbnail((600, 600), Image.Resampling.LANCZOS)
+
+                thumb_io = BytesIO()
+                img.save(thumb_io, format="PNG", quality=85)
+                thumb_io.seek(0)
+
+                # Save thumbnail with _thumb suffix
+                thumb_filename = f"{random_name}_thumb.{ext}"
+                self.thumb.save(
+                    thumb_filename, ContentFile(thumb_io.read()), save=False
+                )
+            except Exception as e:
+                logger.warning(f"Failed to create thumbnail: {e}")
+
+        super().save(*args, **kwargs)
+
+    def markdown(self):
+        if self.thumb:
+            thumb = self.thumb
+        else:
+            thumb = self.image
+
+        if self.caption:
+            return f"<figure><a href='{self.image.url}'><img src='{thumb.url}' alt='{self.alt}'></a><figcaption>{self.caption}</figcaption></figure>"
+        return (
+            f"<a href='{self.image.url}'><img src='{thumb.url}' alt='{self.alt}'></a>"
+        )
+
+
+class Post(models.Model):
+    author = models.ForeignKey(Author, on_delete=models.PROTECT)
+    title = models.CharField(max_length=512, blank=False, null=False, unique=True)
+    content = models.TextField()
+    slug = models.SlugField(max_length=256, blank=True, null=False, unique=True)
+    summary = models.CharField(max_length=1024, null=False, blank=True)
+
+    namespace = models.ForeignKey(
+        "Namespace", on_delete=models.PROTECT, blank=False, null=False
+    )
+    is_published = models.BooleanField(default=False, blank=False, null=False)
+
+    tags = models.ManyToManyField("Tag", blank=True)
+
+    created_at = models.DateTimeField(auto_now_add=True, blank=False, null=False)
+    published_at = models.DateTimeField(blank=True, null=True)
+    changed_at = models.DateTimeField(auto_now=True, blank=False, null=False)
+
+    def save(self, *args, **kwargs):
+        # no longer update the slug once it's been published
+        if not self.is_published and not self.slug:
+            self.slug = slugify(self.title)
+        if not self.summary:
+            self.summary = bleach.clean(
+                markdown.markdown(self.content), strip=True, tags={}
+            )[:200]
+        if self.is_published and not self.published_at:
+            self.published_at = django.utils.timezone.now()
+        elif not self.is_published:
+            self.published_at = None
+        return super().save(*args, **kwargs)
+
+    def get_absolute_url(self):
+        return reverse(
+            "post-detail", args=[self.namespace.name, self.published_at.year, self.slug]
+        )
+
+    def __str__(self):
+        return f"{self.title}"
+
+    def __repr__(self):
+        date = self.published_at or self.created_at
+        return f"<Post {self.title} - {date.year} [{self.namespace.name}]>"
+
+    class Meta:
+        ordering = ["-published_at"]
+
+
+class Tag(models.Model):
+    name = models.CharField(max_length=256, blank=False, null=False)
+    namespace = models.ForeignKey(
+        "Namespace", on_delete=models.PROTECT, null=False, blank=False
+    )
+
+    def get_absolute_url(self):
+        return reverse("tag-detail", args=[self.namespace.name, self.name])
+
+    def __str__(self):
+        return f"{self.name} ({self.namespace.name})"
+
+    def __repr__(self):
+        return f"<Tag {self.name} [{self.namespace.name}]>"
+
+    class Meta:
+        unique_together = ("name", "namespace")

django_mosaic/templates/base.html

@@ -0,0 +1,26 @@
+{% load static %}
+<!DOCTYPE html>
+<html lang="en">
+<head>
+	<meta charset="UTF-8">
+	<meta name="viewport" content="width=device-width, initial-scale=1.0">
+	<link rel="stylesheet" href={% static "css/style.css" %}>
+	<title>{{ CONSTANTS.site.title }}{% block title %}{% endblock %}</title>
+	{% include "includes/header.html" %}
+	{% block head_extra %}{% endblock %}
+</head>
+<body>
+	<header class="wrap">
+		<nav>
+			<a href={% url 'home' %}>{{ CONSTANTS.site.title }}</a>
+			<a href={% url 'post-list' 'private' %}>Friends & Family</a>
+		</nav>
+	</header>
+	<main class="wrap">
+		{% block content %}{% endblock %}
+	</main>
+	<footer>
+		{% block footer_extra %}{% endblock %}
+	</footer>
+</body>
+</html>

django_mosaic/templates/home.html

@@ -0,0 +1,24 @@
+{% extends "base.html" %}
+{% load markdownify %}
+
+{% block content %}
+
+{% include "includes/about.html" %}
+
+<hr/>
+
+<h2>Writing</h2>
+<ul>
+{% for post in posts %}
+{% include "post-detail-include.html" %}
+{% endfor %}
+</ul>
+
+<hr />
+
+<h2>Topics</h2>
+{% for t in tags %}
+<a href={{ t.get_absolute_url }}>{{ t.name }}</a>{% if not forloop.last %}, {% endif %}
+{% endfor %}
+
+{% endblock %}

django_mosaic/templates/post-detail-include.html

@@ -0,0 +1 @@
+<li><a href="{{ post.get_absolute_url }}" class="plain"><code class="meta">{{ post.published_at | date:"Y-m-d" }}</code> {{ post.title }}</a></li>

django_mosaic/templates/post-detail.html

@@ -0,0 +1,25 @@
+{% extends "base.html" %}
+{% load markdownify %}
+
+{% block title %} - {{ post.title }}{% endblock %}
+
+{% block content %}
+<article class="h-entry">
+<hgroup>
+<h1 class="p-name">{{ post.title }}</h1>
+<small>
+Written on
+<time class="dt-published" datetime="{{ post.published_at|date:'Y-m-d H:i:s' }}">{{ post.published_at|date:'Y-m-d' }}</time>
+by <a class="p-author h-card" href="{% url 'home' %}">{{ post.author.user.username }}</a>
+{% if post.tags %} in {% for t in post.tags.all %}<a href={{ t.get_absolute_url }}>{{ t.name }}</a> {% endfor %}{% endif %}
+</small>
+</hgroup>
+<div class="e-summary" hidden="true">
+{{ post.summary }}
+</div>
+<div class="e-content">
+{{ post.content|markdownify }}
+</div>
+
+</article>
+{% endblock %}

django_mosaic/templates/post-list.html

@@ -0,0 +1,10 @@
+{% extends "base.html" %}
+
+{% block content %}
+<h2>Writing</h2>
+<ul>
+{% for post in posts %}
+<li><code>{{ post.published_at| date:"Y m d"}}</code> <a href={{ post.get_absolute_url }}>{{ post.title }}</a></li>
+{% endfor %}
+</ul>
+{% endblock %}

django_mosaic/templates/tag-detail.html

@@ -0,0 +1,8 @@
+{% extends "base.html" %}
+
+{% block content %}
+<h2>Posts for <strong>{{ tag.name }}</strong></h2>
+{% for post in posts %}
+{% include "post-detail-include.html" %}
+{% endfor %}
+{% endblock %}

django_mosaic/tests/post-1-introduction-to-lorem.md

@@ -0,0 +1,45 @@
+---
+title: "Introduction to Lorem Ipsum"
+date: 2026-01-15T10:30:00Z
+draft: false
+tags: ["lorem", "ipsum", "introduction"]
+categories: ["General"]
+author: "Lorem Writer"
+description: "A comprehensive introduction to the world of lorem ipsum and its applications."
+---
+
+# Introduction to Lorem Ipsum
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
+
+## The Origins
+
+Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+### Classical Foundations
+
+Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.
+
+## Key Concepts
+
+Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt:
+
+- Neque porro quisquam est
+- Qui dolorem ipsum quia dolor sit amet
+- Consectetur adipisci velit
+- Sed quia non numquam eius modi tempora incidunt
+
+### Practical Applications
+
+At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis praesentium voluptatum deleniti atque corrupti quos dolores et quas molestias excepturi sint occaecati cupiditate non provident.
+
+```javascript
+const lorem = "ipsum dolor sit amet";
+console.log(lorem);
+```
+
+## Conclusion
+
+Similique sunt in culpa qui officia deserunt mollitia animi, id est laborum et dolorum fuga. Et harum quidem rerum facilis est et expedita distinctio. Nam libero tempore, cum soluta nobis est eligendi optio cumque nihil impedit quo minus id quod maxime placeat facere possimus.
+
+Omnis voluptas assumenda est, omnis dolor repellendus. Temporibus autem quibusdam et aut officiis debitis aut rerum necessitatibus saepe eveniet ut et voluptates repudiandae sint et molestiae non recusandae.

django_mosaic/tests/post-2-advanced-techniques.md

@@ -0,0 +1,91 @@
+---
+title: "Advanced Lorem Ipsum Techniques"
+date: 2026-01-20T14:45:00Z
+draft: false
+tags: ["lorem", "advanced", "techniques", "tutorial"]
+categories: ["Technical", "Tutorials"]
+author: "Ipsum Expert"
+description: "Exploring advanced techniques and methodologies in lorem ipsum generation and usage."
+featured_image: "/images/lorem-advanced.jpg"
+---
+
+# Advanced Lorem Ipsum Techniques
+
+Itaque earum rerum hic tenetur a sapiente delectus, ut aut reiciendis voluptatibus maiores alias consequatur aut perferendis doloribus asperiores repellat. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
+
+## Understanding the Framework
+
+Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae consequatur.
+
+### Core Principles
+
+1. **Primum Principium**: Lorem ipsum dolor sit amet, consectetur adipiscing elit
+2. **Secundum Principium**: Sed do eiusmod tempor incididunt ut labore et dolore
+3. **Tertium Principium**: Ut enim ad minim veniam, quis nostrud exercitation
+
+## Implementation Strategies
+
+Vel illum qui dolorem eum fugiat quo voluptas nulla pariatur. At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis praesentium voluptatum deleniti atque corrupti.
+
+### Method One: The Classical Approach
+
+```python
+def generate_lorem():
+    text = "Lorem ipsum dolor sit amet"
+    return text.upper()
+
+# Usage
+result = generate_lorem()
+print(result)
+```
+
+Quos dolores et quas molestias excepturi sint occaecati cupiditate non provident, similique sunt in culpa qui officia deserunt mollitia animi, id est laborum et dolorum fuga.
+
+### Method Two: Modern Variations
+
+> "Et harum quidem rerum facilis est et expedita distinctio. Nam libero tempore, cum soluta nobis est eligendi optio cumque nihil impedit quo minus id quod maxime placeat facere possimus, omnis voluptas assumenda est."
+
+## Performance Considerations
+
+| Metric | Classical | Modern | Optimized |
+|--------|-----------|--------|-----------|
+| Speed | 100ms | 50ms | 25ms |
+| Memory | 1MB | 512KB | 256KB |
+| Accuracy | 95% | 97% | 99% |
+
+Omnis dolor repellendus. Temporibus autem quibusdam et aut officiis debitis aut rerum necessitatibus saepe eveniet ut et voluptates repudiandae sint et molestiae non recusandae.
+
+## Best Practices
+
+Itaque earum rerum hic tenetur a sapiente delectus:
+
+- **Consistency**: Ut aut reiciendis voluptatibus maiores alias consequatur
+- **Scalability**: Aut perferendis doloribus asperiores repellat
+- **Maintainability**: Sed ut perspiciatis unde omnis iste natus error
+- **Documentation**: Sit voluptatem accusantium doloremque laudantium
+
+### Error Handling
+
+Nam libero tempore, cum soluta nobis est eligendi optio cumque nihil impedit quo minus id quod maxime placeat facere possimus. Omnis voluptas assumenda est, omnis dolor repellendus.
+
+```bash
+#!/bin/bash
+echo "Lorem ipsum dolor sit amet"
+exit 0
+```
+
+## Future Directions
+
+Temporibus autem quibusdam et aut officiis debitis aut rerum necessitatibus saepe eveniet ut et voluptates repudiandae sint et molestiae non recusandae. Itaque earum rerum hic tenetur a sapiente delectus, ut aut reiciendis voluptatibus maiores alias consequatur aut perferendis doloribus asperiores repellat.
+
+### Emerging Trends
+
+Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.
+
+## Conclusion
+
+Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit.
+
+---
+
+*This post was last updated on January 20, 2026.*

django_mosaic/tests.py

@@ -0,0 +1 @@
+# Create your tests here.

django_mosaic/urls.py

@@ -0,0 +1,25 @@
+from django.urls import path, include
+from django_magic_authorization.urls import protected_path
+from django.conf import settings
+from django.conf.urls.static import static
+
+from mosaic.views import post_list, post_detail, home, about, tag_detail
+from mosaic.feeds import PostFeed
+
+mosaic_patterns = [
+    path("tag/<str:name>", tag_detail, name="tag-detail"),
+    path("posts", post_list, name="post-list"),
+    path("posts/<int:year>/<str:post_slug>", post_detail, name="post-detail"),
+    path("feed", PostFeed(), name="feed"),
+]
+
+urlpatterns = [
+    path("", home, name="home"),
+    path("<slug:namespace>/", include(mosaic_patterns)),
+    protected_path(
+        "private/", include(mosaic_patterns), kwargs={"namespace": "private"}
+    ),
+]
+
+if settings.DEBUG:
+    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

django_mosaic/views.py

@@ -0,0 +1,49 @@
+from django.shortcuts import render, get_object_or_404
+from django.conf import settings
+from mosaic.models import Post, Tag
+
+
+def _get_posts(namespace="public"):
+    return Post.objects.filter(namespace__name=namespace, is_published=True)
+
+
+def home(request):
+    posts = _get_posts()
+    tags = Tag.objects.filter(post__in=posts).distinct()
+
+    return render(
+        request,
+        "home.html",
+        {"posts": posts, "tags": tags, "CONSTANTS": settings.CONSTANTS},
+    )
+
+
+def post_list(request, namespace):
+    posts = _get_posts(namespace)
+    return render(
+        request, "post-list.html", {"posts": posts, "CONSTANTS": settings.CONSTANTS}
+    )
+
+
+def post_detail(request, namespace, year, post_slug):
+    post = get_object_or_404(Post, slug=post_slug)
+
+    return render(
+        request, "post-detail.html", {"post": post, "CONSTANTS": settings.CONSTANTS}
+    )
+
+
+def tag_detail(request, namespace, name):
+    tag = get_object_or_404(Tag, name=name, namespace__name=namespace)
+
+    posts = _get_posts(namespace).filter(tags__name=tag)
+
+    return render(
+        request,
+        "tag-detail.html",
+        {"posts": posts, "tag": tag, "CONSTANTS": settings.CONSTANTS},
+    )
+
+
+def about(request):
+    return render(request, "about.html")

django_mosaic-0.1.0.dist-info/METADATA

@@ -0,0 +1,122 @@
+Metadata-Version: 2.3
+Name: django-mosaic
+Version: 0.1.0
+Summary: A simple django blogging engine for the indieweb
+Keywords: django,blog,indieweb
+Author: j23n
+Author-email: j23n <oss@j23n.com>
+License: BSD 3-Clause License
+         
+         Copyright (c) 2026, j23n
+         
+         Redistribution and use in source and binary forms, with or without
+         modification, are permitted provided that the following conditions are met:
+         
+         1. Redistributions of source code must retain the above copyright notice, this
+            list of conditions and the following disclaimer.
+         
+         2. Redistributions in binary form must reproduce the above copyright notice,
+            this list of conditions and the following disclaimer in the documentation
+            and/or other materials provided with the distribution.
+         
+         3. Neither the name of the copyright holder nor the names of its
+            contributors may be used to endorse or promote products derived from
+            this software without specific prior written permission.
+         
+         THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+         AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+         IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+         DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+         FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+         DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+         SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+         CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+         OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+         OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+         
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 5.2
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: bleach>=6.3.0
+Requires-Dist: django>=5.2.11
+Requires-Dist: django-magic-authorization>=0.1.5
+Requires-Dist: django-markdownify>=0.9.6
+Requires-Dist: fabric>=3.2.2
+Requires-Dist: pillow>=12.1.0
+Requires-Python: >=3.12
+Project-URL: Homepage, https://app.radicle.xyz/nodes/iris.radicle.xyz/rad:zVdCS3rdBtnLLui7jaHTf4X9j6FD
+Project-URL: Repository, https://app.radicle.xyz/nodes/iris.radicle.xyz/rad:zVdCS3rdBtnLLui7jaHTf4X9j6FD
+Project-URL: Bug Tracker, https://app.radicle.xyz/nodes/iris.radicle.xyz/rad:zVdCS3rdBtnLLui7jaHTf4X9j6FD/issues
+Project-URL: Changelog, https://app.radicle.xyz/nodes/iris.radicle.xyz/rad:zVdCS3rdBtnLLui7jaHTf4X9j6FD/tree/CHANGELOG.md
+Description-Content-Type: text/markdown
+
+# Mosaic
+
+A simple blog system in the spirit of the <a href="https://indieweb.org">IndieWeb</a>. It's aimed to get up and running as quickly as possible with your own, easily customizable CMS
+
+## Installation
+
+First, install the package using your favorite python package manager
+
+`uv add django-mosaic`
+
+or
+
+`pip install django-mosaic`
+
+Second, you need to enable the app in your Django project.
+
+```python
+# settings.py
+INSTALLED_APPS = [
+  ...
+  "django_mosaic"
+  ...
+]
+```
+
+Third, run the migrations to add the relevant schemas to your database
+
+```
+uv run python manage.py migrate
+```
+
+## Quickstart
+
+Start the development server.
+
+```
+uv run python manage.py runserver
+```
+
+Mosaic exposes all its features through the admin. First, create a user for the admin.
+
+```
+uv run python manage.py createsuperuser
+```
+
+Go to <a href="http://localhost:8000/admin">http://localhost:8000/admin"</a>.
+
+![[docs/img/01-admin.png]]
+
+You can write a post right within the admin, in [markdown](https://daringfireball.net/projects/markdown/).
+
+![[docs/img/02-create-post.png]]
+
+By default, there are two `namespace`s, `public` and `private`. Everything you post in `public` will be visible to, well, everyone. Posts in `private` will be visible only to those with a secret `AccessToken`, which you can also generate in the admin.
+
+Only `Post`s with the `is_draft` flag set to `False` will be shown on your website.
+
+Hit the save button and go to [https://localhost:8000] 
+
+![[docs/img/03-home.png]]
+
+Have fun!

django_mosaic-0.1.0.dist-info/RECORD

@@ -0,0 +1,32 @@
+django_mosaic/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_mosaic/admin.py,sha256=lFCV0wMq7Mn5TUWzGX8e7HJFY6y4lyQwLNU-9iZkcFs,2169
+django_mosaic/apps.py,sha256=YOJ8IE-88UocaWFDcKsyCfoTEQx1UYBKQNq24xNCu08,85
+django_mosaic/feeds.py,sha256=m0FBPYAOwOLRwj9E719QgainaPcDlSyfKmklGCvvhx4,644
+django_mosaic/management/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_mosaic/management/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_mosaic/management/commands/import.py,sha256=fVmwmm849xRvKH2CtNB_ntD6qkwEy5kTnyP1bSQkqbU,2800
+django_mosaic/migrations/0001_initial_squashed_0008_alter_tag_name_alter_tag_unique_together.py,sha256=6mR9oPji8tbArE-KybAunmLMPwnSxFZ0ra3ZdfqxXHg,4086
+django_mosaic/migrations/0009_alter_post_published_at.py,sha256=EC_8KIbL4c8SYAcXvFoPeyojXe6JPRIrgT4KxYJJteM,469
+django_mosaic/migrations/0010_alter_post_published_at_alter_post_slug_and_more.py,sha256=2X30klrDVpyPcPYDAQYe7MHR7gyByyhGSJiNIEroVTk,761
+django_mosaic/migrations/0011_remove_post_is_draft_post_is_published_and_more.py,sha256=S0tz3PZ4H34NOhL8Iy9jT37jg7568keMXIQz0g63jY4,1042
+django_mosaic/migrations/0012_author_post_author.py,sha256=0ddEJIVRH_0honzg4eIkDHXrb1TAYI8T8PTmAmv5br0,1096
+django_mosaic/migrations/0013_add_author_to_post.py,sha256=QfKBB5YXDsT5SGYY-fcqvooqd8txlNzAhVwhBeeh1aU,675
+django_mosaic/migrations/0014_contentimage.py,sha256=GPevq1rikS8U1XwEnTouSM_ta7j_KKFORoPH3sphIKg,1255
+django_mosaic/migrations/0015_contentimage_post.py,sha256=l-N8FHJGbSxO5QDuqQpqRldhMeKbnchvYmFWEeU3-lw,540
+django_mosaic/migrations/0016_alter_contentimage_image_alter_contentimage_thumb.py,sha256=PjsNi1Q4pO-6JHTaq4dEofoQHKNq4dLUVe1LMVSjyT8,646
+django_mosaic/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_mosaic/models.py,sha256=wbBlgpLy5Qycn3ObTaIJJCWgu3HFUjO5HzRC4L8NR0U,5323
+django_mosaic/templates/base.html,sha256=xZw1wdaLz3Ly_desnqux-iGiu2iiuXR0fos4u4DZ1sA,696
+django_mosaic/templates/home.html,sha256=7OKq65DyP2iaQW3peVASJB_gjM9Xenxsnkx5zdzxqq4,383
+django_mosaic/templates/post-detail-include.html,sha256=isuSnEbl_4_fnJsKFxRN2IN11FY7cAd7A_cvof80iS0,147
+django_mosaic/templates/post-detail.html,sha256=mWNQ8nQMIVVonykW7Y2YsiB_NtwWjpK8lfMgjOmdtCk,728
+django_mosaic/templates/post-list.html,sha256=1Hg4krfs3SIaiYZCaUGgOy9GkEr3tG4fvFdUUmLuvn8,243
+django_mosaic/templates/tag-detail.html,sha256=jU88SR4MNLwsD6pvQMpfQv4OlOCDdA-8U2s0tIrrrhA,191
+django_mosaic/tests/post-1-introduction-to-lorem.md,sha256=JX2NcpbQvxZcnb6uGWEHnsPLhV-jyNZYP4NWIk6-vpU,2138
+django_mosaic/tests/post-2-advanced-techniques.md,sha256=pFe5Yv_x1jfH1fdyewtmqmMRWUfCcjBLmKexMeCSyIM,3944
+django_mosaic/tests.py,sha256=qWDvA9ZhVCQ1rPbkoFify7o_fDirXMUdYMxF12q3WIM,26
+django_mosaic/urls.py,sha256=rv4jssWfX_qrzIP5hVw_Bx06IkUmDH_bqhDuo5x45KU,848
+django_mosaic/views.py,sha256=U32A3UpLXv-Yhs65Z9jIP-OxCQIZ-DLzviAZrmb5hss,1255
+django_mosaic-0.1.0.dist-info/WHEEL,sha256=5DEXXimM34_d4Gx1AuF9ysMr1_maoEtGKjaILM3s4w4,80
+django_mosaic-0.1.0.dist-info/METADATA,sha256=UT9nOgs89T-FQ6m8mQwQkMM5TgdREBjMgcYegHL62Q0,4675
+django_mosaic-0.1.0.dist-info/RECORD,,

django_mosaic-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.9.29
+Root-Is-Purelib: true
+Tag: py3-none-any