Files
kewt/site/Docs/configuration.md
N0\A 0379d38234
All checks were successful
Lint / shellcheck (push) Successful in 22s
Release Standalone Builder / build (release) Successful in 33s
Release Standalone Builder / publish-aur (release) Successful in 34s
Release Standalone Builder / publish-homebrew (release) Successful in 6s
docs: new docs
2026-03-25 10:42:24 +01:00

1.3 KiB

Configuration

Dot Files

  • .kewtignore - files/directories to ignore completely. If the file is empty, the whole directory gets ignored.
  • .kewthide - files/directories to hide from navigation but still process. Same empty-file rules as .kewtignore.
  • .kewtpreserve - files/directories to copy as-is without converting markdown to HTML. Same empty-file rules again.

Frontmatter

You can set metadata for a page using a site.conf-style frontmatter block at the very top of .md files:

---
title = "Custom Page Title"
date = "2026-03-23 11:32"
draft = false
---
  • title - overrides the page title, post name in index links, and RSS <title>.
  • date - overrides the post date and time. Supports YYYY-MM-DD and YYYY-MM-DD HH:MM (or HH-MM).
  • draft - if true, the file is excluded from HTML generation.

Directory Index Customisation

By default, directories without an index.md get an auto-generated index page listing their contents.

If you create your own index.md in a directory, you can still include the auto-generated file list by using the {{LIST}} placeholder:

# Blog

This is my blog. The posts are below. The top-most one is the most recent.

{{LIST}}

The {{LIST}} tag will be replaced with the generated list of links to child pages and files, exactly as in case the custom index didn't exist.