Guide

Overview

What Blogin is and how it works.

Getting Started

Install Blogin and build your first site.

Writing Posts

Front matter, sections, and tags.

Layouts

HAML templates, chrome partials, and per-section layouts.

Template Data

The context object every layout renders against, and the shapes it exposes.

Data files

Load JSON and YAML into layouts, site-wide and per directory.

CSS Frameworks

Emit framework-specific classes without touching the core renderer.

Syntax Highlighting

Server-side highlighting for fenced code.

Math and Diagrams

Write math and diagrams that render in the browser.

Feeds and Search

Atom feeds, the sitemap, and browser search.

Metadata and SEO

Open Graph and Twitter tags, canonical links, and robots.txt.

Previewing and Building

The dev server, incremental builds, and debug output.

Configuration

The keys in blogin.json.

Internationalization

Build a site in more than one language.

Themes and Plugins

Reuse a layout set, and extend the build with a hook.

Deploying

Publishing the built public/ directory.