add posts

Author: afrendeiro

build.py

@@ -46,6 +46,9 @@ def build_all_pages():
         if page == "manual":
             build_lab_manual()
             continue
+        elif page == "posts":
+            build_posts()
+            continue
 
         content_file = content_dir / f"{page}.yaml"
         content = yaml.safe_load(content_file.open().read())[page]
@@ -81,6 +84,86 @@ def build_all_pages():
         shutil.copytree("assets", build_dir / "assets")
 
 
+def build_posts():
+    """Build blog-post-like pages from markdown files in content/posts/."""
+    posts_dir = content_dir / "posts"
+    if not posts_dir.exists():
+        return
+
+    environment = Environment(loader=FileSystemLoader(template_dir))
+    template = environment.from_string((template_dir / "post.html").open().read())
+    md = Markdown(
+        extras=[
+            "fenced-code-blocks",
+            "highlightjs-lang",
+            "metadata",
+            "tables",
+            "footnotes",
+        ]
+    )
+
+    posts_metadata = []  # Collect metadata for index
+
+    for post_file in posts_dir.glob("*.md"):
+        slug = post_file.stem
+        raw_content = post_file.read_text()
+
+        html_content = md.convert(raw_content)
+        metadata = getattr(md, "metadata", {}) or {}
+
+        page_dir = build_dir / "p" / slug
+        page_dir.mkdir(exist_ok=True, parents=True)
+        page_file = page_dir / "index.html"
+
+        page_url = f"/p/{slug}/"
+
+        # Collect for index
+        posts_metadata.append(
+            {
+                "slug": slug,
+                "url": page_url,
+                "title": metadata.get("title", slug.replace("-", " ").title()),
+                "subtitle": metadata.get("subtitle"),
+                "date": metadata.get("date"),
+            }
+        )
+
+        html = template.render(
+            page_url=config["deploy_url"] + page_url.lstrip("/"),
+            title=metadata.get("title", slug.replace("-", " ").title()),
+            subtitle=metadata.get("subtitle"),
+            date=metadata.get("date"),
+            content=html_content,
+            **config,
+        )
+
+        with page_file.open("w") as f:
+            f.write(html)
+
+    # Build index after all posts (even if none)
+    build_posts_index(posts_metadata, environment)
+
+
+def build_posts_index(posts_metadata: list[dict], environment: Environment):
+    """Build an index page listing all posts."""
+    template = environment.from_string(
+        (template_dir / "posts_index.html").open().read()
+    )
+
+    page_dir = build_dir / "p"
+    page_dir.mkdir(exist_ok=True, parents=True)
+
+    html = template.render(
+        page_url=config["deploy_url"] + "p/",
+        title="Posts",
+        posts=sorted(posts_metadata, key=lambda x: x.get("date") or "", reverse=True),
+        **config,
+    )
+
+    with (page_dir / "index.html").open("w") as f:
+        f.write(html)
+
+
 def build_lab_manual():
     name = config["pages"]["manual"]["url"][1:-1]
     environment = Environment(loader=FileSystemLoader(template_dir))

config.yaml

@@ -44,6 +44,11 @@ pages:
     url: /lab-manual/
     template: manual.html
     file: lab-manual/index.html
+  posts:
+    name: Posts
+    url: /p/
+    template: posts_index.html
+    file: p/index.html
   contact:
     name: Contact
     url: /contact/

content/posts/.gitkeep

@@ -38,5 +38,6 @@ <h1 class="page-title">Lab manual</h1>
     <!-- Code block highlighting -->
     <script src="https://cdn.jsdelivr.net/npm/prismjs@1.29.0/components/prism-core.min.js"></script>
     <script src="https://cdn.jsdelivr.net/npm/prismjs@1.29.0/components/prism-python.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/prismjs@1.29.0/components/prism-bash.min.js"></script>
     <script src="https://cdn.jsdelivr.net/npm/prismjs@1.29.0/plugins/autoloader/prism-autoloader.min.js"></script>
 {% endblock js %}

templates/manual.html

@@ -0,0 +1,33 @@
+{% extends "_template.html" %}
+
+{% block head %}
+{{ super() }}
+<!-- Code block highlighting -->
+<link href="https://cdn.jsdelivr.net/npm/prismjs@1.29.0/themes/prism-tomorrow.min.css" rel="stylesheet" />
+{% endblock head %}
+
+{% block title %}Post - {{ title }}{% endblock title %}
+
+{% block content %}
+<div class="container py-5">
+  <article>
+    <header class="mb-4">
+      <h1>{{ title }}</h1>
+      {% if date %}<p class="text-muted"><small>{{ date }}</small></p>{% endif %}
+      {% if subtitle %}<p class="lead">{{ subtitle }}</p>{% endif %}
+    </header>
+    <div class="post-content">
+      {{ content }}
+    </div>
+  </article>
+</div>
+{% endblock %}
+
+{% block js %}
+{{ super() }}
+    <!-- Code block highlighting -->
+    <script src="https://cdn.jsdelivr.net/npm/prismjs@1.29.0/components/prism-core.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/prismjs@1.29.0/components/prism-python.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/prismjs@1.29.0/components/prism-bash.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/prismjs@1.29.0/plugins/autoloader/prism-autoloader.min.js"></script>
+{% endblock js %}

templates/post.html

@@ -0,0 +1,15 @@
+{% extends "_template.html" %}
+{% block content %}
+<div class="container py-5">
+  <h1>{{ title }}</h1>
+  <ul class="list-unstyled">
+    {% for post in posts %}
+    <li class="mb-3">
+      <a href="{{ post.url }}">{{ post.title }}</a>
+      {% if post.date %}<small class="text-muted ms-2">{{ post.date }}</small>{% endif %}
+      {% if post.subtitle %}<p class="text-muted mb-0"><small>{{ post.subtitle }}</small></p>{% endif %}
+    </li>
+    {% endfor %}
+  </ul>
+</div>
+{% endblock %}