Configuration
Site-wide settings live in blogin.json at the project root. Command-line
options override the file.
| Key | Meaning |
|---|---|
title |
Site title, available to layouts. |
base-url |
Absolute base for feeds and the sitemap. |
output-dir |
Where the build writes (default public). |
home-section |
Section whose listing is also the site root. |
clean-urls |
Extensionless URLs when true. |
css-framework |
Class-map profile: none, bootstrap5, ... |
page-size |
Posts per listing page. |
highlight |
Server-side syntax highlighting for fenced code. |
search |
Emit the search index and script. |
Per-section overrides#
The sections map overrides settings for one section, including its nav label,
nav order, visibility, page size, and whether dates show:
"sections": {
"guide": { "label": "Guide", "order": 1, "page-size": 20 }
}
| Section key | Meaning |
|---|---|
label |
Nav label and listing heading (defaults to the humanized name). |
order |
Sort position in the nav. |
page-size |
Posts per listing page for this section. |
nav |
Include the section in the nav when true. |
layout |
Layout name override for the section. |
index-dates |
Show post dates on the section's listing pages (default true). |
show-dates |
Show the post date on the section's post pages (default true). |
Set index-dates or show-dates to false to hide dates on reference-style
sections while a blog keeps them.