Colophon

This site is deliberately simple to keep hosting free.

Site generator

• Hugo builds the static site.
  • Custom Hugo layouts provide the home page, archives, taxonomy pages, reading list, and post templates.
• The RSS feed is generated by Hugo at /feed.xml.

Writing and interactive pieces

• Posts are written in Markdown.
• marimo islands in selected posts for in-browser (pyodide) python-based interactivity.

  • I use a custom generator script that uses MarimoIslandGenerator to generate the HTML islands inside a JSON file from custom marimo code block render hooks, which then intersperses the generated islands into the rendered page.

  • For example, this Markdown:

    ```marimo {app="example" cell="hello-from-island" show-code=true}
    import marimo as mo
    source = "🏝️ Marimo islands"
    mo.md(f"Hello from {source}!")
    ```
    

    becomes this island:
• Code highlighting uses Hugo’s Chroma styles.
• Datastar is used for frontend interactivity as necessary.
  • Datastar is mostly meant to interact with a backend, but I like and understand its signal syntax well, so I employ it for frontend interactivity in favor of surreal or alpine.js
• uv for python helper dependency management.
• Mermaid for rendered diagrams.

Design

• The color palette is based on Protesilaos Stavrou’s Modus themes.
• The site supports light, dark, and automatic themes.

Infrastructure

• The site is hosted on Cloudflare Pages.
• Development environments are managed with devenv and Nix.
• Source code lives in axelknock/lucianknock.com.