https://blogin.dev/ Blogin Mon, 20 Jul 2026 00:00:00 +0000 https://blogin.dev/guide/overview/ https://blogin.dev/guide/overview/ Mon, 20 Jul 2026 00:00:00 +0000 Blogin is a static blog generator written in Raku. Point it at a directory of Markdown files and it produces a directory of plain HTML you can host anywhere. There is no database and no runtime:… https://blogin.dev/cli/blogin-init/ https://blogin.dev/cli/blogin-init/ Sat, 04 Jul 2026 00:00:00 +0000 Scaffold a new site in a directory, with a starter post, layouts, and a blogin.json. https://blogin.dev/guide/getting-started/ https://blogin.dev/guide/getting-started/ Sun, 19 Jul 2026 00:00:00 +0000 Install Raku and zef https://blogin.dev/cli/blogin-new/ https://blogin.dev/cli/blogin-new/ Wed, 01 Jul 2026 00:00:00 +0000 Create a new post file from a title, with front matter filled in and a slug derived from the title. https://blogin.dev/guide/writing-posts/ https://blogin.dev/guide/writing-posts/ Sat, 18 Jul 2026 00:00:00 +0000 A post is a Markdown file with a --- front matter block: --- title: My Post date: 2026-07-20 tags: [raku, web] description: A short summary. --- The body goes here. Run blogin new "My Post" to scaffold one with the front matter filled in. Reference links and footnotes Links can carry their target in a separate definition rather than inline. Write [text][label] in the body and define the label anywhere in the file: See [the home page][home] for more. [home]: https://example.com "Optional title" A collapsed form, [text][], uses the text as the label. Labels match case-insensitively, and an undefined reference is left as literal text. Footnotes use [^label] where the note is cited, with a matching definition: A claim that needs a source[^src]. [^src]: The cited source. Footnotes are numbered in the order they are first referenced and collected into a footnotes section at the end of the post, each with a link back to its reference. Reference and footnote definition lines never render as content. Sections The subdirectory a file sits in under content/ is its section, and the section is both the URL prefix and the layout selector. A file at content/posts/hello.md becomes /posts/hello and renders through layouts/posts/show.haml when present, otherwise layouts/show.haml. Nested directories become nested sections and nested nav entries. Summaries A listing and a feed entry show a short summary of each post rather than the whole body. Blogin picks the summary in this order: A summary in front matter, used verbatim. The text before a ` https://blogin.dev/cli/blogin-build/ https://blogin.dev/cli/blogin-build/ Fri, 03 Jul 2026 00:00:00 +0000 Render the content tree to static HTML, writing feeds, a sitemap, and the search index alongside the pages. https://blogin.dev/guide/layouts/ https://blogin.dev/guide/layouts/ Fri, 17 Jul 2026 00:00:00 +0000 Blogin renders pages with Template::HAML. A build wraps each post's rendered body in show.haml inside base.haml, and each section listing in index.haml inside base.haml. https://blogin.dev/cli/blogin-serve/ https://blogin.dev/cli/blogin-serve/ Thu, 02 Jul 2026 00:00:00 +0000 Build the site and serve it locally, rebuilding when content, layouts, static assets, data files, or the configuration change. A successful rebuild live-reloads the open page in the browser. https://blogin.dev/guide/template-data/ https://blogin.dev/guide/template-data/ Wed, 22 Jul 2026 00:00:00 +0000 Every layout renders against a context object. A method call in HAML is a call on that object, so = title runs the context's title method and - for posts iterates its posts collection. There are two… https://blogin.dev/guide/data-files/ https://blogin.dev/guide/data-files/ Tue, 21 Jul 2026 00:00:00 +0000 A data/ directory beside content/ holds structured values that layouts read directly, so a list of authors, a set of social links, or a navigation table lives in one place rather than being repeated… https://blogin.dev/cli/blogin-clean/ https://blogin.dev/cli/blogin-clean/ Sun, 05 Jul 2026 00:00:00 +0000 Remove the output directory produced by a build, leaving the content, layouts, and configuration in place. https://blogin.dev/guide/css-frameworks/ https://blogin.dev/guide/css-frameworks/ Thu, 16 Jul 2026 00:00:00 +0000 The HTML Blogin emits carries framework-specific classes drawn from a selected profile, set by the css-framework config key. The core renderer stays framework-agnostic: it asks the profile for a… https://blogin.dev/guide/syntax-highlighting/ https://blogin.dev/guide/syntax-highlighting/ Wed, 15 Jul 2026 00:00:00 +0000 Set "highlight": true in blogin.json and Blogin highlights fenced code during the build. Highlighting is server-side: there is no client JavaScript, and the pages work without it. https://blogin.dev/guide/math-and-diagrams/ https://blogin.dev/guide/math-and-diagrams/ Tue, 21 Jul 2026 00:00:00 +0000 Blogin parses math and Mermaid diagrams into markup that a client-side renderer turns into equations and graphics. The build stays pure and static; the rendering happens in the browser. https://blogin.dev/guide/feeds-and-search/ https://blogin.dev/guide/feeds-and-search/ Tue, 14 Jul 2026 00:00:00 +0000 Every build with at least one post emits feeds, a sitemap, and a search index. https://blogin.dev/guide/metadata-and-seo/ https://blogin.dev/guide/metadata-and-seo/ Tue, 21 Jul 2026 00:00:00 +0000 Blogin emits per-page metadata for search engines and social cards, and a site-wide robots.txt, without any template work beyond a single call in the page head. https://blogin.dev/guide/previewing-and-building/ https://blogin.dev/guide/previewing-and-building/ Mon, 13 Jul 2026 00:00:00 +0000 The preview server https://blogin.dev/guide/configuration/ https://blogin.dev/guide/configuration/ Sun, 12 Jul 2026 00:00:00 +0000 Site-wide settings live in blogin.json at the project root. Command-line options override the file. https://blogin.dev/guide/internationalization/ https://blogin.dev/guide/internationalization/ Tue, 21 Jul 2026 00:00:00 +0000 List the languages you write in and Blogin builds each into its own subtree. https://blogin.dev/guide/themes-and-plugins/ https://blogin.dev/guide/themes-and-plugins/ Tue, 21 Jul 2026 00:00:00 +0000 Themes https://blogin.dev/guide/deploying/ https://blogin.dev/guide/deploying/ Sat, 11 Jul 2026 00:00:00 +0000 blogin build writes a self-contained public/ directory. Deploying is copying that directory to any static host.