docs: new docs

.gitea/workflows/publish-aur-git.yml

@@ -2,9 +2,12 @@ name: Publish kewt-git to AUR
 
 on:
   push:
+    branches:
+      - main
     paths:
       - 'packaging/AUR/PKGBUILD.git'
       - 'packaging/AUR/.SRCINFO.git'
+  workflow_dispatch:
 
 jobs:
   publish-aur-git:

.gitea/workflows/release.yml

@@ -3,6 +3,7 @@ name: Release Standalone Builder
 on:
   release:
     types: [published]
+  workflow_dispatch:
 
 jobs:
   build:
@@ -103,3 +104,34 @@ jobs:
           commit_email: ${{ github.actor }}@users.noreply.github.com
           ssh_private_key: ${{ secrets.AUR_SSH_PRIVATE_KEY }}
           commit_message: "Update kewt-bin to ${{ github.ref_name }}"
+
+  publish-homebrew:
+    runs-on: local
+    needs: build
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Render Formula and push to GitHub
+        run: |
+          TAG="${GITHUB_REF#refs/tags/}"
+          VERSION="${TAG#v}"
+
+          curl -sL -o kewt-binary \
+            "https://git.krzak.org/N0VA/kewt/releases/download/${TAG}/kewt"
+          CHECKSUM=$(sha256sum kewt-binary | awk '{print $1}')
+          rm -f kewt-binary
+
+          git clone https://x-access-token:${{ secrets.GH_RELEASE_TOKEN }}@github.com/n0va-bot/homebrew-tap.git brew-work || true
+          mkdir -p brew-work/Formula
+          sed -e "s/VERSION_PLACEHOLDER/${VERSION}/g" \
+              -e "s/SHA256SUM_PLACEHOLDER/${CHECKSUM}/g" \
+              packaging/homebrew/kewt.rb.template > brew-work/Formula/kewt.rb
+
+          cd brew-work
+          [ -d .git ] || { git init && git checkout --orphan main && git remote add origin https://x-access-token:${{ secrets.GH_RELEASE_TOKEN }}@github.com/n0va-bot/homebrew-tap.git; }
+          git add Formula/kewt.rb
+          git config user.name "${{ github.actor }}"
+          git config user.email "${{ github.actor }}@users.noreply.github.com"
+          git commit -m "Update kewt to ${TAG}" || echo "No changes to commit"
+          git push -u origin main

.gitignore

@@ -1,4 +1,2 @@
 out/
-kewt
+kewt
-site.conf
-template.html

Makefile

@@ -0,0 +1,19 @@
+PREFIX ?= /usr/local
+BINDIR = $(PREFIX)/bin
+
+all: kewt
+
+kewt:
+	./tools/build-standalone.sh
+
+install: kewt
+	install -d $(DESTDIR)$(BINDIR)
+	install -m 755 kewt $(DESTDIR)$(BINDIR)/kewt
+
+uninstall:
+	rm -f $(DESTDIR)$(BINDIR)/kewt
+
+clean:
+	rm -f kewt
+
+.PHONY: all install uninstall clean

README.md

@@ -10,22 +10,12 @@
 _kewt_ is a minimalist ssg inspired by _[werc](http://werc.cat-v.org/)_ and _[kew](https://github.com/uint23/kew)_
 
 
-## Quick Install
+## [Installation](https://kewt.krzak.org/#installation)
-
-```sh
-curl -L -o kewt https://git.krzak.org/N0VA/kewt/releases/download/latest/kewt
-chmod +x kewt
-```
-
-On Arch Linux, _kewt_ is available on the AUR:
-
-- [kewt-bin](https://aur.archlinux.org/packages/kewt-bin) — prebuilt standalone binary from the latest release
-- [kewt-git](https://aur.archlinux.org/packages/kewt-git) — built from the latest git source
 
 ## Contributing
 
-Either through a pull request to the **home** repository ([N0VA/kewt](https://git.krzak.org/N0VA/kewt)) or by sending a patch to my email address ([n0va@krzak.org](mailto:n0va@krzak.org))
+Either open an issue or pull request on the **home** repository ([N0VA/kewt](https://git.krzak.org/N0VA/kewt)) or message me on my email address ([n0va@krzak.org](mailto:n0va@krzak.org?subject=%5Bkewt%5D%20something)) with the subjectline being `[kewt] something`.
 
-## Credits
+## License
 
-- _kew_ css style adapted from _[kew](https://github.com/uint23/kew)_ by [uint23](https://github.com/uint23)
+ISC

awk/blockquote_to_admonition.awk

@@ -22,7 +22,19 @@ END {
                     sub(/^\[!/, "", kind)
                     sub(/\]$/, "", kind)
                     lkind = tolower(kind)
-                    if (lkind == "note" || lkind == "tip" || lkind == "important" || lkind == "warning" || lkind == "caution") {
+                    is_valid = 0
+                    if (custom_admonitions != "") {
+                        n = split(tolower(custom_admonitions), adms, ",")
+                        for (idx = 1; idx <= n; idx++) {
+                            adm = adms[idx]
+                            sub(/^[ \t]+/, "", adm)
+                            sub(/[ \t]+$/, "", adm)
+                            if (lkind == adm) { is_valid = 1; break }
+                        }
+                    } else if (lkind == "note" || lkind == "tip" || lkind == "important" || lkind == "warning" || lkind == "caution") {
+                        is_valid = 1
+                    }
+                    if (is_valid) {
                         print "<div class=\"admonition admonition-" lkind "\">"
                         print "<p class=\"admonition-title\">" cap(lkind) "</p>"
                         has_body = 0

awk/frontmatter.awk

@@ -0,0 +1,46 @@
+BEGIN {
+    state = "start"
+}
+{
+    if (state == "start") {
+        if ($0 == "---") {
+            state = "in_fm"
+            next
+        } else {
+            state = "body"
+            print
+            next
+        }
+    }
+    if (state == "in_fm") {
+        if ($0 == "---") {
+            state = "body"
+            next
+        }
+        line = $0
+        if (line ~ /^[[:space:]]*$/ || line ~ /^[[:space:]]*#/) next
+        if (line !~ /=/) next
+
+        key = line
+        val = line
+        sub(/=.*/, "", key)
+        sub(/[^=]*=/, "", val)
+
+        gsub(/^[[:space:]]+|[[:space:]]+$/, "", key)
+        gsub(/^[[:space:]]+|[[:space:]]+$/, "", val)
+
+        if (val ~ /^".*"$/) {
+            val = substr(val, 2, length(val) - 2)
+            gsub(/\\"/, "\"", val)
+        } else if (val ~ /^'.*'$/) {
+            val = substr(val, 2, length(val) - 2)
+            gsub(/\\'/, "'", val)
+        }
+
+        if (fm_out != "") {
+            print key "=" val >> fm_out
+        }
+        next
+    }
+    print
+}

awk/headers.awk

@@ -3,8 +3,14 @@ function strip_markdown(s) {
     gsub(/[*_`~]/, "", s)
     gsub(/[\[\]]/, "", s)
     gsub(/\([^\)]*\)/, "", s)
+    s = tolower(s)
+    gsub(/[^a-z0-9 -]/, "", s)
     gsub(/^[[:space:]]+|[[:space:]]+$/, "", s)
     gsub(/[[:space:]]+/, "-", s)
+    gsub(/-{2,}/, "-", s)
+    gsub(/^-+|-+$/, "", s)
+    if (length(s) > 80) s = substr(s, 1, 80)
+    gsub(/-+$/, "", s)
     return s
 }
 function print_header(line) {
@@ -32,7 +38,7 @@ BEGIN {
     in_pre = 0
 }
 {
-    if ($0 ~ /^<pre><code>/) {
+    if ($0 ~ /^<pre><code/) {
         in_pre = 1
         if (has_prev && prev != "") { print_header(prev); has_prev = 0 }
         print

awk/lists.awk

@@ -48,7 +48,26 @@ BEGIN {
             }
         }
 
-        print "<li>" content "</li>"
+        has_checkbox = 0
+        if (content ~ /^\[[ \t]\] /) {
+            has_checkbox = 1
+            is_checked = 0
+            sub(/^\[[ \t]\] /, "", content)
+        } else if (content ~ /^\[[xX]\] /) {
+            has_checkbox = 1
+            is_checked = 1
+            sub(/^\[[xX]\] /, "", content)
+        }
+
+        if (has_checkbox) {
+            if (is_checked) {
+                print "<li class=\"task-list-item\"><input type=\"checkbox\" class=\"task-list-item-checkbox\" checked disabled> " content "</li>"
+            } else {
+                print "<li class=\"task-list-item\"><input type=\"checkbox\" class=\"task-list-item-checkbox\" disabled> " content "</li>"
+            }
+        } else {
+            print "<li>" content "</li>"
+        }
     } else {
         while (depth > 0) {
             print "</" cur_type[depth] ">"

awk/markdown_embed.awk

@@ -204,7 +204,7 @@ function render_embed(src, alt, has_alt, force_inline,    ext, local_path, conte
         }
         if (is_audio_ext(ext)) return "<audio controls src=\"" src "\"></audio>"
         if (is_video_ext(ext)) return "<video controls src=\"" src "\"></video>"
-        return "<iframe src=\"" src "\"></iframe>"
+        return "<iframe src=\"" src "\" allowfullscreen></iframe>"
     }
 
     if (is_image_ext(ext)) {
@@ -223,7 +223,29 @@ function render_embed(src, alt, has_alt, force_inline,    ext, local_path, conte
         }
     }
 
-    return "<iframe src=\"" src "\"></iframe>"
+    return "<iframe src=\"" src "\" allowfullscreen></iframe>"
+}
+
+function render_typed_embed(etype, src, alt, has_alt,    local_path, content) {
+    if (etype == "i") {
+        if (has_alt) return "<img alt=\"" alt "\" src=\"" src "\" />"
+        return "<img src=\"" src "\" />"
+    }
+    if (etype == "v") return "<video controls src=\"" src "\"></video>"
+    if (etype == "a") return "<audio controls src=\"" src "\"></audio>"
+    if (etype == "f") return "<iframe src=\"" src "\" allowfullscreen></iframe>"
+    if (etype == "e") {
+        if (!is_global_url(src)) {
+            local_path = resolve_local_path(src)
+            if (local_path != "") {
+                content = read_file(local_path)
+                if (content ~ /\n$/) sub(/\n$/, "", content)
+                return content
+            }
+        }
+        return render_embed(src, alt, has_alt, 1)
+    }
+    return render_embed(src, alt, has_alt, 0)
 }
 
 function extract_attr(tag, attr,    pat, m, token) {
@@ -319,7 +341,7 @@ function apply_td_vertical_align(line,    out, rest, seg, td_tag, img_tag, after
     return out rest
 }
 
-function rewrite_img_tags(line,    out, rest, tag, src, alt, force_inline_tag, pre, post, repl) {
+function rewrite_img_tags(line,    out, rest, tag, src, alt, force_inline_tag, embed_type, pre, post, repl) {
     out = ""
     rest = line
     while (match(rest, /<img[^>]*\/?>/)) {
@@ -329,7 +351,10 @@ function rewrite_img_tags(line,    out, rest, tag, src, alt, force_inline_tag, p
         src = extract_attr(tag, "src")
         alt = extract_attr(tag, "alt")
         force_inline_tag = extract_attr(tag, "data-force-inline")
-        if (is_image_ext(ext_of(src)) && force_inline_tag == "") {
+        embed_type = extract_attr(tag, "data-embed-type")
+        if (embed_type != "") {
+            repl = render_typed_embed(embed_type, src, alt, (alt != ""))
+        } else if (is_image_ext(ext_of(src)) && force_inline_tag == "") {
             # Preserve hand-written <img> attributes (style/class/etc) for normal images.
             repl = tag
         } else {

awk/markdown_inline.awk

@@ -20,9 +20,11 @@ function mask_html_tags(s,    out, rest, start, len, tag, token) {
     return out rest
 }
 
-function restore_html_tags(s,    i) {
+function restore_html_tags(s,    i, val) {
     for (i = 1; i <= html_tag_count; i++) {
-        gsub(html_tag_token[i], html_tag_value[i], s)
+        val = html_tag_value[i]
+        gsub(/&/, "\\\\&", val)
+        gsub(html_tag_token[i], val, s)
     }
     return s
 }
@@ -58,6 +60,36 @@ function restore_html_tags(s,    i) {
         line = substr(line, 1, start - 1) repl substr(line, start + len)
     }
 
+    # typed embeds: !i, !v, !a, !f, !e
+    while (match(line, /![ivafe]\[[^\]]*\]\([^\)]+ "[^"]*"\)/)) {
+        start = RSTART; len = RLENGTH
+        token = substr(line, start, len)
+        etype = substr(token, 2, 1)
+        match(token, /\[[^\]]*\]/); alt = substr(token, RSTART + 1, RLENGTH - 2)
+        match(token, /"[^"]*"/); etitle = substr(token, RSTART + 1, RLENGTH - 2)
+        match(token, /\([^\)]+/); inner = substr(token, RSTART + 1, RLENGTH - 1)
+        sub(/[[:space:]]*"[^"]*"/, "", inner); src = inner
+        repl = "<img data-embed-type=\"" etype "\" alt=\"" alt "\" src=\"" src "\" title=\"" etitle "\" />"
+        line = substr(line, 1, start - 1) repl substr(line, start + len)
+    }
+    while (match(line, /![ivafe]\[[^\]]*\]\([^\)]+\)/)) {
+        start = RSTART; len = RLENGTH
+        token = substr(line, start, len)
+        etype = substr(token, 2, 1)
+        match(token, /\[[^\]]*\]/); alt = substr(token, RSTART + 1, RLENGTH - 2)
+        match(token, /\([^\)]+/); src = substr(token, RSTART + 1, RLENGTH - 1)
+        repl = "<img data-embed-type=\"" etype "\" alt=\"" alt "\" src=\"" src "\" />"
+        line = substr(line, 1, start - 1) repl substr(line, start + len)
+    }
+    while (match(line, /![ivafe]\[[^\]]+\]/)) {
+        start = RSTART; len = RLENGTH
+        token = substr(line, start, len)
+        etype = substr(token, 2, 1)
+        src = substr(token, 4, len - 4)
+        repl = "<img data-embed-type=\"" etype "\" src=\"" src "\" />"
+        line = substr(line, 1, start - 1) repl substr(line, start + len)
+    }
+
     # force-inline image syntax (double bang)
     while (match(line, /!!\[[^\]]*\]\([^\)]+ "[^"]*"\)/)) {
         start = RSTART; len = RLENGTH

kewt.sh

@@ -13,17 +13,19 @@ Usage: $invoked_as [--from <src>] [--to <out>]
        $invoked_as --new [title]
        $invoked_as --update [dir]
        $invoked_as --post
+       $invoked_as --generate-template
        $invoked_as --version
        $invoked_as --help
 
 Options:
-  --help          Show this help message.
+  --help                     Show this help message.
-  --new [title]   Create a new site directory (default: site)
+  --new [title]              Create a new site directory (default: site)
-  --update [dir]  Update site.conf and template.html with latest defaults (defaults to current directory)
+  --update [dir]             Update site.conf and template.html with latest defaults (defaults to current directory)
-  --post          Create a new empty post file in the configured posts_dir with current date and time as name
+  --post                     Create a new empty post file in the configured posts_dir with current date and time as name
-  --version       Show version information.
+  --generate-template [path] Generate a new template file at <path> (default: template.html)
-  --from <src>    Source directory (default: site)
+  --version                  Show version information.
-  --to <out>      Output directory (default: out)
+  --from <src>               Source directory (default: site)
+  --to <out>                 Output directory (default: out)
 EOF
 }
 
@@ -33,10 +35,7 @@ awk_dir="$script_dir/awk"
 KEWT_TMPDIR=$(mktemp -d "/tmp/kewt_run.XXXXXX")
 trap 'rm -rf "$KEWT_TMPDIR"' EXIT HUP INT TERM
 
-ensure_root_defaults() {
+DEFAULT_CONF='title = "kewt"
-    if [ ! -f "./site.conf" ]; then
-        cat > "./site.conf" <<'EOF'
-title = "kewt"
 style = "kewt"
 dir_indexes = true
 single_file_index = true
@@ -60,12 +59,9 @@ base_url = ""
 generate_feed = false
 feed_file = "rss.xml"
 posts_dir = ""
-EOF
+custom_admonitions = ""'
-    fi
 
-    if [ ! -f "./template.html" ]; then
+DEFAULT_TMPL='<!doctype html>
-        cat > "./template.html" <<'EOF'
-<!doctype html>
 <html>
     <head>
         <meta charset="UTF-8" />
@@ -86,9 +82,17 @@ EOF
         <article>{{CONTENT}}</article>
         <footer>{{FOOTER}}</footer>
     </body>
-</html>
+</html>'
-EOF
+
-    fi
+
+generate_template() {
+    _gt_path="$1"
+    [ -e "$_gt_path" ] && die "File '$_gt_path' already exists."
+    _gt_dir=$(dirname "$_gt_path")
+    [ -d "$_gt_dir" ] || mkdir -p "$_gt_dir"
+    printf '%s\n' "$DEFAULT_TMPL" > "$_gt_path"
+    echo "Generated template at '$_gt_path'."
+    exit 0
 }
 
 create_new_site() {
@@ -98,10 +102,9 @@ create_new_site() {
 
     [ -e "$new_dir" ] && die "Target '$new_dir' already exists."
 
-    ensure_root_defaults
-
     mkdir -p "$new_dir"
-    cp "./site.conf" "$new_dir/site.conf"
+    printf '%s\n' "$DEFAULT_CONF" > "$new_dir/site.conf"
+    printf '%s\n' "$DEFAULT_TMPL" > "$new_dir/template.html"
     printf "# _kewt_ website\n" > "$new_dir/index.md"
 
     if [ -n "$new_title" ]; then
@@ -114,6 +117,7 @@ create_new_site() {
 
 create_new_post() {
     post_src_dir="$1"
+    post_user_title="$2"
 
     target_dir="$post_src_dir"
     if [ -n "$posts_dir" ]; then
@@ -133,7 +137,12 @@ create_new_post() {
         counter=$((counter + 1))
     done
 
-    touch "$file_path"
+    post_date_val="$(date "+%Y-%m-%d %H:%M")"
+    if [ -n "$post_user_title" ]; then
+        printf -- '---\ntitle = "%s"\ndate = "%s"\ndraft = false\n---\n# %s\n' "$post_user_title" "$post_date_val" "$post_user_title" > "$file_path"
+    else
+        printf -- '---\ndate = "%s"\ndraft = false\n---\n' "$post_date_val" > "$file_path"
+    fi
 
     echo "Created new post at '$file_path'."
     exit 0
@@ -148,32 +157,7 @@ update_site() {
 
     # Generate default site.conf
     default_conf="$KEWT_TMPDIR/default_site.conf"
-    cat > "$default_conf" <<'CONFEOF'
+    printf '%s\n' "$DEFAULT_CONF" > "$default_conf"
-title = "kewt"
-style = "kewt"
-dir_indexes = true
-single_file_index = true
-flatten = false
-order = ""
-home_name = "Home"
-show_home_in_nav = true
-nav_links = ""
-nav_extra = ""
-footer = "made with <a href=\"https://kewt.krzak.org\">kewt</a>"
-logo = ""
-display_logo = false
-display_title = true
-logo_as_favicon = true
-favicon = ""
-generate_page_title = true
-error_page = "not_found.html"
-versioning = false
-enable_header_links = true
-base_url = ""
-generate_feed = false
-feed_file = "rss.xml"
-posts_dir = ""
-CONFEOF
 
     # Update site.conf
     if [ ! -f "$target_conf" ]; then
@@ -203,30 +187,7 @@ CONFEOF
     # Update template.html
     if [ -f "$target_tmpl" ]; then
         default_tmpl="$KEWT_TMPDIR/default_template.html"
-        cat > "$default_tmpl" <<'TMPLEOF'
+        printf '%s\n' "$DEFAULT_TMPL" > "$default_tmpl"
-<!doctype html>
-<html>
-    <head>
-        <meta charset="UTF-8" />
-        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-        <title>{{TITLE}}</title>
-
-        <link rel="stylesheet" href="{{CSS}}" type="text/css" />
-        {{HEAD_EXTRA}}
-    </head>
-
-    <body>
-        <header>
-            <h1>{{HEADER_BRAND}}</h1>
-        </header>
-
-        <nav id="side-bar">{{NAV}}</nav>
-
-        <article>{{CONTENT}}</article>
-        <footer>{{FOOTER}}</footer>
-    </body>
-</html>
-TMPLEOF
         if cmp -s "$default_tmpl" "$target_tmpl" 2>/dev/null; then
             echo "template.html is already up to date."
         else
@@ -269,6 +230,18 @@ while [ $# -gt 0 ]; do
             ;;
         --post)
             post_mode="true"
+            if [ $# -gt 1 ] && [ "${2#-}" = "$2" ]; then
+                post_title="$2"
+                shift
+            fi
+            ;;
+        --generate-template)
+            generate_template_path="template.html"
+            if [ $# -gt 1 ] && [ "${2#-}" = "$2" ]; then
+                generate_template_path="$2"
+                shift
+            fi
+            generate_template "$generate_template_path"
             ;;
         --update)
             update_dir="."
@@ -307,7 +280,7 @@ done
 
 [ "$new_mode" = "true" ] && create_new_site "$new_title"
 
-ensure_root_defaults
+
 
 if [ -z "$src" ]; then
     if [ "$post_mode" = "true" ] && [ -f "./site.conf" ]; then
@@ -454,6 +427,7 @@ base_url=""
 generate_feed="false"
 feed_file="rss.xml"
 posts_dir=""
+custom_admonitions=""
 
 load_config() {
     [ -f "$1" ] || return
@@ -505,6 +479,7 @@ load_config() {
             generate_feed) generate_feed="$val" ;;
             feed_file) feed_file="${val#/}" ;;
             posts_dir) posts_dir="${val#/}" ;;
+            custom_admonitions) custom_admonitions="$val" ;;
         esac
     done < "$1"
 }
@@ -516,7 +491,7 @@ if [ -n "$posts_dir" ]; then
     HIDE_ARGS="$HIDE_ARGS -o -path '$src/$posts_dir/*'"
 fi
 
-[ "$post_mode" = "true" ] && create_new_post "$src"
+[ "$post_mode" = "true" ] && create_new_post "$src" "$post_title"
 
 asset_version=""
 if [ "$versioning" = "true" ]; then
@@ -538,6 +513,24 @@ escape_html_attr() {
         -e 's/>/\&gt;/g'
 }
 
+parse_frontmatter() {
+    _fm_file="$1"
+    _fm_out="$KEWT_TMPDIR/fm_vals.txt"
+    : > "$_fm_out"
+    awk -v fm_out="$_fm_out" -f "$awk_dir/frontmatter.awk" "$_fm_file" > /dev/null
+    fm_title=""
+    fm_date=""
+    fm_draft=""
+    while IFS='=' read -r _fk _fv; do
+        case "$_fk" in
+            title) fm_title="$_fv" ;;
+            date) fm_date="$_fv" ;;
+            draft) fm_draft="$_fv" ;;
+        esac
+    done < "$_fm_out"
+    rm -f "$_fm_out"
+}
+
 nav_links_html() {
     [ -n "$nav_links" ] || return
 
@@ -584,7 +577,10 @@ nav_links_html() {
 
 template="$src/template.html"
 [ -f "$template" ] || template="./template.html"
-[ -f "$template" ] || die "Template '$template' not found."
+if [ ! -f "$template" ]; then
+    template="$KEWT_TMPDIR/default_template.html"
+    printf '%s\n' "$DEFAULT_TMPL" > "$template"
+fi
 
 [ -d "$out" ] && rm -rf "$out"
 mkdir -p "$out"
@@ -643,7 +639,7 @@ render_markdown() {
         if [ "$rel_dir_of_file" = "$posts_dir" ]; then
              temp_post_with_backlink="$KEWT_TMPDIR/post_with_backlink.md"
              printf "[< Back](index.html)\n\n" > "$temp_post_with_backlink"
-             cat "$file" >> "$temp_post_with_backlink"
+             awk -f "$awk_dir/frontmatter.awk" "$file" >> "$temp_post_with_backlink"
              content_file="$temp_post_with_backlink"
         fi
     fi
@@ -693,11 +689,21 @@ render_markdown() {
     fi
     head_extra=""
     if [ -n "$favicon_src" ]; then
-        head_extra="<link rel=\"icon\" href=\"$favicon_src\" />"
+        if echo "$favicon_src" | grep -q "^http"; then
+            head_extra="<link rel=\"icon\" href=\"$favicon_src\" />"
+        elif echo "$favicon_src" | grep -q "^/"; then
+            head_extra="<link rel=\"icon\" href=\"$favicon_src\" />"
+        else
+            head_extra="<link rel=\"icon\" href=\"/$favicon_src\" />"
+        fi
     fi
 
+    parse_frontmatter "$file"
+
     page_title="$title"
-    if [ "$generate_page_title" = "true" ] && [ -n "$file" ] && [ -f "$file" ]; then
+    if [ -n "$fm_title" ]; then
+        page_title="$fm_title - $title"
+    elif [ "$generate_page_title" = "true" ] && [ -n "$file" ] && [ -f "$file" ]; then
         if [ "$is_home" = "true" ] && [ -n "$home_name" ]; then
             page_title="$home_name - $title"
         else
@@ -715,7 +721,19 @@ render_markdown() {
         fi
     fi
 
-    ENABLE_HEADER_LINKS="$enable_header_links" MARKDOWN_SITE_ROOT="$src" MARKDOWN_FALLBACK_FILE="$script_dir/styles/$style.css" sh "$script_dir/markdown.sh" "$content_file" | AWK_CURRENT_URL="$current_url" AWK_TITLE="$page_title" AWK_NAV="$nav" AWK_FOOTER="$footer" AWK_STYLE_PATH="${style_path}${asset_version}" AWK_HEADER_BRAND="$header_brand" AWK_HEAD_EXTRA="$head_extra" awk -f "$awk_dir/render_template.awk" "$local_template"
+    ENABLE_HEADER_LINKS="$enable_header_links" CUSTOM_ADMONITIONS="$custom_admonitions" MARKDOWN_SITE_ROOT="$src" MARKDOWN_FALLBACK_FILE="$script_dir/styles/$style.css" sh "$script_dir/markdown.sh" "$content_file" | AWK_CURRENT_URL="$current_url" AWK_TITLE="$page_title" AWK_NAV="$nav" AWK_FOOTER="$footer" AWK_STYLE_PATH="${style_path}${asset_version}" AWK_HEADER_BRAND="$header_brand" AWK_HEAD_EXTRA="$head_extra" awk -f "$awk_dir/render_template.awk" "$local_template"
+}
+
+needs_rebuild() {
+    src_file="$1"
+    out_file="$2"
+    [ ! -f "$out_file" ] && return 0
+    [ "$src_file" -nt "$out_file" ] && return 0
+    [ -f "./site.conf" ] && [ "./site.conf" -nt "$out_file" ] && return 0
+    [ -f "$src/site.conf" ] && [ "$src/site.conf" -nt "$out_file" ] && return 0
+    [ -f "$template" ] && [ "$template" -nt "$out_file" ] && return 0
+    [ -f "$script_dir/styles/$style.css" ] && [ "$script_dir/styles/$style.css" -nt "$out_file" ] && return 0
+    return 1
 }
 
 echo "Building site from '$src' to '$out'..."
@@ -728,35 +746,56 @@ eval "find \"$src\" \( $IGNORE_ARGS \) -prune -o -type d -print" | sort | while
     mkdir -p "$out_dir"
 
     if [ -f "$dir/styles.css" ]; then
-        copy_style_with_resolved_vars "$dir/styles.css" "$out_dir/styles.css"
+        if needs_rebuild "$dir/styles.css" "$out_dir/styles.css"; then
+            copy_style_with_resolved_vars "$dir/styles.css" "$out_dir/styles.css"
+        fi
     elif [ -f "$dir/style.css" ]; then
-        copy_style_with_resolved_vars "$dir/style.css" "$out_dir/styles.css"
+        if needs_rebuild "$dir/style.css" "$out_dir/styles.css"; then
+            copy_style_with_resolved_vars "$dir/style.css" "$out_dir/styles.css"
+        fi
     fi
 
     [ "$dir_indexes" != "true" ] && continue
 
-    if [ ! -f "$dir/index.md" ]; then
+    has_custom_index="false"
+    has_list="false"
+    if [ -f "$dir/index.md" ]; then
+        has_custom_index="true"
+        if grep -q '^[[:space:]]*{{LIST}}[[:space:]]*$' "$dir/index.md" 2>/dev/null; then
+            has_list="true"
+        fi
+    fi
+
+    if [ "$has_custom_index" = "false" ] || [ "$has_list" = "true" ]; then
         is_posts_dir="false"
         if [ -n "$posts_dir" ] && { [ "$rel_dir" = "$posts_dir" ] || [ "./$rel_dir" = "$posts_dir" ]; }; then
             is_posts_dir="true"
         fi
-        if [ "$single_file_index" = "true" ] && [ "$is_posts_dir" = "false" ]; then
+        if [ "$single_file_index" = "true" ] && [ "$is_posts_dir" = "false" ] && [ "$has_list" = "false" ]; then
             md_count=$(find "$dir" ! -name "$(basename "$dir")" -prune -name "*.md" | wc -l)
             if [ "$md_count" -eq 1 ]; then
                 md_file=$(find "$dir" ! -name "$(basename "$dir")" -prune -name "*.md")
                 is_home="false"; [ "$dir" = "$src" ] && is_home="true"
                 target_url="/$rel_dir/index.html"
                 [ "$rel_dir" = "." ] && target_url="/index.html"
-                render_markdown "$md_file" "$is_home" "$target_url" > "$out_dir/index.html"
+                if needs_rebuild "$md_file" "$out_dir/index.html"; then
+                    render_markdown "$md_file" "$is_home" "$target_url" > "$out_dir/index.html"
+                fi
                 continue
             fi
         fi
 
         temp_index="$KEWT_TMPDIR/index.md"
-        display_dir="${rel_dir#.}"
+        temp_list="$KEWT_TMPDIR/list.md"
-        [ -z "$display_dir" ] && display_dir="/"
+        : > "$temp_list"
-        echo "# Index of $display_dir" > "$temp_index"
+
-        echo "" >> "$temp_index"
+        if [ "$has_custom_index" = "false" ]; then
+            display_dir="${rel_dir#.}"
+            [ -z "$display_dir" ] && display_dir="/"
+            echo "# Index of $display_dir" > "$temp_index"
+            echo "" >> "$temp_index"
+        fi
+
 
         sort_args=""
         # If this is the posts dir reverse
@@ -770,49 +809,109 @@ eval "find \"$src\" \( $IGNORE_ARGS \) -prune -o -type d -print" | sort | while
                 template.html|site.conf|style.css|index.md) continue ;;
             esac
             if [ -d "$entry" ]; then
-                echo "- [${name}/](${name}/index.html)" >> "$temp_index"
+                echo "- [${name}/](${name}/index.html)" >> "$temp_list"
             elif [ "${entry%.md}" != "$entry" ]; then
                 label="${name%.md}"
 
-                # Try to get first heading
+                # Parse frontmatter for date/title/draft
-                post_h=$(grep -m 1 '^# ' "$entry" | sed 's/^# *//')
+                parse_frontmatter "$entry"
-                if [ -n "$post_h" ]; then
+                [ "$fm_draft" = "true" ] && continue
-                    post_h=$(echo "$post_h" | sed -e 's/\[//g' -e 's/\]//g' -e 's/!//g' -e 's/\*//g' -e 's/_//g' -e 's/`//g' -e 's/([^)]*)//g' | sed 's/\\//g')
 
-                    if [ "$rel_dir" = "$posts_dir" ] || [ "./$rel_dir" = "$posts_dir" ]; then
+                # Try to get first heading
-                        # For posts add date and time
+                post_h="$fm_title"
+                if [ -z "$post_h" ]; then
+                    post_h=$(grep -m 1 '^# ' "$entry" | sed 's/^# *//')
+                    if [ -n "$post_h" ]; then
+                        post_h=$(echo "$post_h" | sed -e 's/\[//g' -e 's/\]//g' -e 's/!//g' -e 's/\*//g' -e 's/_//g' -e 's/`//g' -e 's/([^)]*)//g' | sed 's/\\//g')
+                    fi
+                fi
+
+                is_post_entry="false"
+                if [ "$rel_dir" = "$posts_dir" ] || [ "./$rel_dir" = "$posts_dir" ]; then
+                    is_post_entry="true"
+                fi
+
+                if [ -n "$post_h" ]; then
+                    if [ "$is_post_entry" = "true" ]; then
+                        # Use frontmatter date if available, else parse from filename
+                        if [ -n "$fm_date" ]; then
+                            p_date=$(echo "$fm_date" | sed 's/^\([0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}\).*/\1/')
+                            p_time=""
+                            if echo "$fm_date" | grep -q '^[0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}[ T_-]\?[0-9]\{2\}[:\-][0-9]\{2\}'; then
+                                p_time=$(echo "$fm_date" | sed 's/^[0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}[ T_-]\?\([0-9]\{2\}[:\-][0-9]\{2\}\).*/\1/' | tr '-' ':')
+                            fi
+                        else
+                            p_date=$(echo "${name%.md}" | sed 's/^\([0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}\).*/\1/')
+                            p_time="00:00"
+                            if echo "${name%.md}" | grep -q '^[0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}-[0-9]\{2\}[:\-][0-9]\{2\}'; then
+                                 p_time=$(echo "${name%.md}" | sed 's/^[0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}-\([0-9]\{2\}[:\-][0-9]\{2\}\).*/\1/' | tr '-' ':')
+                            fi
+                        fi
+                        if [ -n "$p_time" ]; then
+                            label="$post_h - $p_date $p_time"
+                        else
+                            label="$post_h - $p_date"
+                        fi
+                    else
+                        label="$post_h"
+                    fi
+                elif [ "$is_post_entry" = "true" ]; then
+                    # No heading; use date
+                    if [ -n "$fm_date" ]; then
+                        p_date=$(echo "$fm_date" | sed 's/^\([0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}\).*/\1/')
+                        p_time=""
+                        if echo "$fm_date" | grep -q '^[0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}[ T_-]\?[0-9]\{2\}[:\-][0-9]\{2\}'; then
+                            p_time=$(echo "$fm_date" | sed 's/^[0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}[ T_-]\?\([0-9]\{2\}[:\-][0-9]\{2\}\).*/\1/' | tr '-' ':')
+                        fi
+                        if [ -n "$p_time" ]; then
+                            label="$p_date $p_time"
+                        else
+                            label="$p_date"
+                        fi
+                    else
                         p_date=$(echo "${name%.md}" | sed 's/^\([0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}\).*/\1/')
                         p_time="00:00"
                         if echo "${name%.md}" | grep -q '^[0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}-[0-9]\{2\}[:\-][0-9]\{2\}'; then
                              p_time=$(echo "${name%.md}" | sed 's/^[0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}-\([0-9]\{2\}[:\-][0-9]\{2\}\).*/\1/' | tr '-' ':')
                         fi
-                        label="$post_h - $p_date $p_time"
+                        label="$p_date $p_time"
-                    else
-                        label="$post_h"
                     fi
-                elif [ "$rel_dir" = "$posts_dir" ] || [ "./$rel_dir" = "$posts_dir" ]; then
-                    # No heading and date and time for posts
-                    p_date=$(echo "${name%.md}" | sed 's/^\([0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}\).*/\1/')
-                    p_time="00:00"
-                    if echo "${name%.md}" | grep -q '^[0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}-[0-9]\{2\}[:\-][0-9]\{2\}'; then
-                         p_time=$(echo "${name%.md}" | sed 's/^[0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}-\([0-9]\{2\}[:\-][0-9]\{2\}\).*/\1/' | tr '-' ':')
-                    fi
-                    label="$p_date $p_time"
                 fi
-                echo "- [$label](${name%.md}.html)" >> "$temp_index"
+                echo "- [$label](${name%.md}.html)" >> "$temp_list"
             else
-                echo "- [$name]($name)" >> "$temp_index"
+                echo "- [$name]($name)" >> "$temp_list"
             fi
         done
+        
+        if [ "$has_custom_index" = "true" ]; then
+            awk '
+                /^[[:space:]]*\{\{LIST\}\}[[:space:]]*$/ {
+                    while((getline line < "'"$temp_list"'") > 0) print line
+                    close("'"$temp_list"'")
+                    next
+                }
+                { print }
+            ' "$dir/index.md" > "$temp_index"
+        else
+            cat "$temp_list" >> "$temp_index"
+        fi
+
         is_home="false"; [ "$dir" = "$src" ] && is_home="true"
         target_url="/$rel_dir/index.html"
         [ "$rel_dir" = "." ] && target_url="/index.html"
-        render_markdown "$temp_index" "$is_home" "$target_url" > "$out_dir/index.html"
+
-        rm "$temp_index"
+        do_rebuild="false"
+        needs_rebuild "$dir" "$out_dir/index.html" && do_rebuild="true"
+        [ "$has_custom_index" = "true" ] && needs_rebuild "$dir/index.md" "$out_dir/index.html" && do_rebuild="true"
+
+        if [ "$do_rebuild" = "true" ]; then
+            render_markdown "$temp_index" "$is_home" "$target_url" > "$out_dir/index.html"
+        fi
+        rm -f "$temp_index" "$temp_list"
     fi
 done
 
-if [ ! -f "$out/styles.css" ] && [ -f "$script_dir/styles/$style.css" ]; then
+if [ -f "$script_dir/styles/$style.css" ] && needs_rebuild "$script_dir/styles/$style.css" "$out/styles.css"; then
     copy_style_with_resolved_vars "$script_dir/styles/$style.css" "$out/styles.css"
 fi
 
@@ -826,6 +925,10 @@ eval "find \"$src\" \( $IGNORE_ARGS \) -prune -o -type f -print" | sort | while
         template.html|site.conf|style.css|styles.css) continue ;;
     esac
 
+    if [ "${file##*/}" = "index.md" ] && grep -q '^[[:space:]]*{{LIST}}[[:space:]]*$' "$file" 2>/dev/null; then
+        continue
+    fi
+
     is_preserved=0
     if [ -n "$(eval "find \"$file\" \( $PRESERVE_ARGS \) -print")" ]; then
         is_preserved=1
@@ -842,11 +945,20 @@ eval "find \"$src\" \( $IGNORE_ARGS \) -prune -o -type f -print" | sort | while
     fi
 
     if [ "${file%.md}" != "$file" ] && [ "$is_preserved" -eq 0 ]; then
+        # Skip draft files
+        parse_frontmatter "$file"
+        if [ "$fm_draft" = "true" ]; then
+            continue
+        fi
         is_home="false"; [ "$file" = "$src/index.md" ] && is_home="true"
         out_file="$out/${rel_path%.md}.html"
-        render_markdown "$file" "$is_home" > "$out_file"
+        if needs_rebuild "$file" "$out_file"; then
+            render_markdown "$file" "$is_home" > "$out_file"
+        fi
     else
-        cp "$file" "$out/$rel_path"
+        if needs_rebuild "$file" "$out/$rel_path"; then
+            cp "$file" "$out/$rel_path"
+        fi
     fi
 done
 
@@ -873,10 +985,12 @@ if [ -n "$base_url" ]; then
         # Don't include 404 in the sitemap (duh)
         [ "${rel_url#/}" = "$error_page" ] && continue
 
-        printf '  <url>\n' >> "$sitemap_file"
+        {
-        printf '    <loc>%s%s</loc>\n' "$base_url" "$rel_url" >> "$sitemap_file"
+            printf '  <url>\n'
-        printf '    <lastmod>%s</lastmod>\n' "$today" >> "$sitemap_file"
+            printf '    <loc>%s%s</loc>\n' "$base_url" "$rel_url"
-        printf '  </url>\n' >> "$sitemap_file"
+            printf '    <lastmod>%s</lastmod>\n' "$today"
+            printf '  </url>\n'
+        } >> "$sitemap_file"
     done
 
     printf '</urlset>\n' >> "$sitemap_file"
@@ -888,27 +1002,43 @@ if [ "$generate_feed" = "true" ] && [ -n "$base_url" ]; then
     build_date=$(date -u '+%a, %d %b %Y %H:%M:%S +0000')
 
     printf '<?xml version="1.0" encoding="UTF-8"?>\n' > "$feed_path"
-    printf '<rss version="2.0">\n' >> "$feed_path"
+    {
-    printf '  <channel>\n' >> "$feed_path"
+        printf '<rss version="2.0">\n'
-    printf '    <title>%s</title>\n' "$title" >> "$feed_path"
+        printf '  <channel>\n'
-    printf '    <link>%s</link>\n' "$base_url_feed" >> "$feed_path"
+        printf '    <title>%s</title>\n' "$title"
-    printf '    <description>%s</description>\n' "$title" >> "$feed_path"
+        printf '    <link>%s</link>\n' "$base_url_feed"
-    printf '    <lastBuildDate>%s</lastBuildDate>\n' "$build_date" >> "$feed_path"
+        printf '    <description>%s</description>\n' "$title"
+        printf '    <lastBuildDate>%s</lastBuildDate>\n' "$build_date"
+    } >> "$feed_path"
 
-    find "$src" -type f -name '[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]*.md' -print | LC_ALL=C sort -r | while IFS= read -r post_file; do
+    find "$src" -type f -name '*.md' -path "*${posts_dir:-__no_posts__}*" -print | LC_ALL=C sort -r | while IFS= read -r post_file; do
         post_basename=$(basename "$post_file" .md)
-        # Extract YYYY-MM-DD
-        post_date=$(echo "$post_basename" | sed 's/^\([0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}\).*/\1/')
 
-        # Extract HH:MM if present (e.g., 2026-03-17-10:30 or 2026-03-17-10:30_1)
+        # Parse frontmatter
-        post_time="00:00"
+        parse_frontmatter "$post_file"
-        if echo "$post_basename" | grep -q '^[0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}-[0-9]\{2\}[:\-][0-9]\{2\}'; then
+        [ "$fm_draft" = "true" ] && continue
-            post_time=$(echo "$post_basename" | sed 's/^[0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}-\([0-9]\{2\}[:\-][0-9]\{2\}\).*/\1/' | tr '-' ':')
+
+        # Use frontmatter date, fallback to filename
+        if [ -n "$fm_date" ]; then
+            post_date=$(echo "$fm_date" | sed 's/^\([0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}\).*/\1/')
+            post_time="00:00"
+            if echo "$fm_date" | grep -q '^[0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}[ T_-]\?[0-9]\{2\}[:\-][0-9]\{2\}'; then
+                post_time=$(echo "$fm_date" | sed 's/^[0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}[ T_-]\?\([0-9]\{2\}[:\-][0-9]\{2\}\).*/\1/' | tr '-' ':')
+            fi
+        else
+            post_date=$(echo "$post_basename" | sed 's/^\([0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}\).*/\1/')
+            post_time="00:00"
+            if echo "$post_basename" | grep -q '^[0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}-[0-9]\{2\}[:\-][0-9]\{2\}'; then
+                post_time=$(echo "$post_basename" | sed 's/^[0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}-\([0-9]\{2\}[:\-][0-9]\{2\}\).*/\1/' | tr '-' ':')
+            fi
         fi
 
         post_slug=$(echo "$post_basename" | sed -e 's/^[0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}-[0-9]\{2\}[:\-][0-9]\{2\}//' -e 's/^[0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}//' -e 's/^[_\-]//')
 
-        post_heading=$(grep -m 1 '^# ' "$post_file" | sed 's/^# *//')
+        post_heading="$fm_title"
+        if [ -z "$post_heading" ]; then
+            post_heading=$(grep -m 1 '^# ' "$post_file" | sed 's/^# *//')
+        fi
         if [ -z "$post_heading" ]; then
             if [ -n "$post_slug" ] && ! echo "$post_slug" | grep -q '^[0-9]\+$'; then
                 post_heading=$(echo "$post_slug" | sed 's/-/ /g' | awk '{for(i=1;i<=NF;i++) $i=toupper(substr($i,1,1)) substr($i,2)}1')
@@ -917,7 +1047,7 @@ if [ "$generate_feed" = "true" ] && [ -n "$base_url" ]; then
             fi
         fi
         post_heading=$(echo "$post_heading" | sed -e 's/\[//g' -e 's/\]//g' -e 's/!//g' -e 's/\*//g' -e 's/_//g' -e 's/`//g' -e 's/([^)]*)//g' | sed 's/\\//g')
-        post_title="$post_heading - $post_date $post_time"
+        feed_post_title="$post_heading - $post_date $post_time"
 
         rel_path="${post_file#"$src"}"
         rel_path="${rel_path#/}"
@@ -926,6 +1056,8 @@ if [ "$generate_feed" = "true" ] && [ -n "$base_url" ]; then
         pub_year=$(echo "$post_date" | cut -d- -f1)
         pub_month=$(echo "$post_date" | cut -d- -f2)
         pub_day=$(echo "$post_date" | cut -d- -f3)
+        # zero-padded
+        pub_day=$(printf '%02d' "${pub_day#0}")
         case "$pub_month" in
             01) pub_mon="Jan" ;; 02) pub_mon="Feb" ;; 03) pub_mon="Mar" ;;
             04) pub_mon="Apr" ;; 05) pub_mon="May" ;; 06) pub_mon="Jun" ;;
@@ -934,12 +1066,14 @@ if [ "$generate_feed" = "true" ] && [ -n "$base_url" ]; then
         esac
         pub_date="${pub_day} ${pub_mon} ${pub_year} ${post_time}:00 +0000"
 
-        printf '    <item>\n' >> "$feed_path"
+        {
-        printf '      <title>%s</title>\n' "$post_title" >> "$feed_path"
+            printf '    <item>\n'
-        printf '      <link>%s</link>\n' "$post_url" >> "$feed_path"
+            printf '      <title>%s</title>\n' "$feed_post_title"
-        printf '      <guid>%s</guid>\n' "$post_url" >> "$feed_path"
+            printf '      <link>%s</link>\n' "$post_url"
-        printf '      <pubDate>%s</pubDate>\n' "$pub_date" >> "$feed_path"
+            printf '      <guid>%s</guid>\n' "$post_url"
-        printf '    </item>\n' >> "$feed_path"
+            printf '      <pubDate>%s</pubDate>\n' "$pub_date"
+            printf '    </item>\n'
+        } >> "$feed_path"
     done
 
     printf '  </channel>\n' >> "$feed_path"

markdown.sh

@@ -15,10 +15,15 @@ sed_inplace() {
     fi
 }
 
-temp_file="/tmp/markdown.$$.md"
+temp_file="${KEWT_TMPDIR:-/tmp}/markdown.$$.md"
 cat "$@" > "$temp_file"
 
-trap 'rm -f "$temp_file" "$temp_file.tmp"' EXIT INT TERM
+trap 'rm -f "$temp_file" "$temp_file.tmp" "$temp_file.fm"' EXIT INT TERM
+
+# Frontmatter
+fm_file="$temp_file.fm"
+: > "$fm_file"
+awk -v fm_out="$fm_file" -f "$awk_dir/frontmatter.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
 
 # Mask
 awk -f "$awk_dir/mask_inline_code.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
@@ -40,14 +45,19 @@ done
 sed_inplace "/^\[[^\]]*\]:  */d" "$temp_file"
 
 # Blocks
-sed_inplace "s/^>!\[/> [!/g" "$temp_file"
-sed_inplace "s/^>\[!/> [!/g" "$temp_file"
 
+loop_count=0
+max_iterations=100
 while grep '^>' "$temp_file" >/dev/null; do
     awk -f "$awk_dir/blockquote.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
+    loop_count=$((loop_count + 1))
+    if [ "$loop_count" -gt "$max_iterations" ]; then
+        echo "Warning: Blockquote processing exceeded $max_iterations iterations on $1. Breaking to prevent infinite loop." >&2
+        break
+    fi
 done
 
-awk -f "$awk_dir/blockquote_to_admonition.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
+awk -v custom_admonitions="$CUSTOM_ADMONITIONS" -f "$awk_dir/blockquote_to_admonition.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
 awk -f "$awk_dir/fenced_code.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
 awk -f "$awk_dir/indented_code.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
 awk -f "$awk_dir/pipe_tables.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"

package.json

@@ -0,0 +1,7 @@
+{
+  "name": "kewt",
+  "description": "A minimalist static site generator inspired by werc",
+  "global": "true",
+  "install": "make install",
+  "scripts": ["kewt"]
+}

packaging/homebrew/kewt.rb.template

@@ -0,0 +1,16 @@
+class Kewt < Formula
+  desc "Minimalist static site generator inspired by werc"
+  homepage "https://kewt.krzak.org"
+  url "https://github.com/n0va-bot/kewt/releases/download/vVERSION_PLACEHOLDER/kewt"
+  sha256 "SHA256SUM_PLACEHOLDER"
+  license "ISC"
+  version "VERSION_PLACEHOLDER"
+
+  def install
+    bin.install "kewt"
+  end
+
+  test do
+    system "#{bin}/kewt", "--version"
+  end
+end

site/Docs/configuration.md

@@ -0,0 +1,37 @@
+# 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:
+
+```conf
+---
+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:
+
+```md
+# 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.

site/Docs/embeds.md

@@ -0,0 +1,21 @@
+# Embeds
+
+- `\![link]`:
+  - local image/audio/video files are embedded as media tags
+  - local text/code files are inlined directly
+  - global image/audio/video links are embedded as media tags
+  - other global links are embedded as `<iframe>`
+- `\![alt](link)` works the same, with `alt` used for images
+- `\!![link]` and `\!![alt](link)` force inline local file contents
+
+If you want to **force** a file to be inlined, use `\!![]` instead of `\![]`
+
+## Typed Embeds
+
+Force specific output regardless of extension:
+
+- `\!i[link]` or `\!i[alt](link)` - **I**mage
+- `\!v[link]` - **V**ideo
+- `\!a[link]` - **A**udio
+- `\!f[link]` - I**f**rame
+- `\!e[link]` - Inline/**e**mbed text/code file directly

site/Docs/index.md

@@ -0,0 +1,3 @@
+# Documentation
+
+{{LIST}}

site/Docs/installation.md

@@ -0,0 +1,42 @@
+# Installation
+
+## Standalone
+
+```sh
+curl -L -o kewt https://git.krzak.org/N0VA/kewt/releases/download/latest/kewt
+chmod +x kewt
+```
+## From source
+
+```sh
+git clone https://git.krzak.org/N0VA/kewt.git
+cd kewt
+```
+### Building
+
+```sh
+make
+```
+### Installing
+
+```sh
+sudo make install
+```
+## Package Managers
+
+### AUR
+
+- [kewt-bin](https://aur.archlinux.org/packages/kewt-bin) - prebuilt standalone binary from the latest release
+- [kewt-git](https://aur.archlinux.org/packages/kewt-git) - built from the latest git source
+
+### Homebrew
+
+```sh
+brew tap n0va-bot/tap
+brew install kewt
+```
+### bpkg
+
+```sh
+bpkg install n0va-bot/kewt
+```

site/Docs/usage.md

@@ -0,0 +1,71 @@
+# Usage
+
+```sh
+kewt --help
+kewt --version
+kewt --new [title]
+kewt --post [title]
+kewt --generate-template [path]
+kewt --update [dir]
+kewt --from <src> --to <out>
+kewt [src] [out]
+```
+- `--new [title]` creates a new site directory with a default `site.conf`, `template.html`, and `index.md`.
+- `--post [title]` creates a new markdown file in the configured `posts_dir` with the current date/time as the filename and default frontmatter.
+- `--generate-template [path]` writes the default `template.html` to the given path (defaults to `template.html` in the current directory).
+- `--update [dir]` adds any missing keys to `site.conf` and checks `template.html` against the latest default.
+
+## site.conf
+
+```conf
+title = "kewt"
+style = "kewt"
+dir_indexes = true
+single_file_index = true
+flatten = false
+order = ""
+home_name = "Home"
+show_home_in_nav = true
+nav_links = ""
+nav_extra = ""
+footer = "made with <a href=\"https://kewt.krzak.org\">kewt</a>"
+logo = ""
+display_logo = false
+display_title = true
+logo_as_favicon = true
+favicon = ""
+generate_page_title = true
+error_page = "not_found.html"
+versioning = false
+enable_header_links = true
+base_url = ""
+generate_feed = false
+feed_file = "rss.xml"
+posts_dir = ""
+custom_admonitions = ""
+```
+- `title` - site title
+- `style` - style file name from `./styles` (without `.css`)
+- `dir_indexes` - generate directory index pages when missing `index.md`
+- `single_file_index` - if a directory has one markdown file and no `index.md`, use that file as `index.html`
+- `flatten` - flatten sidebar directory levels
+- `order` - comma separated file/directory name list to order the sidebar (alphabetical by default)
+- `home_name` - text for the home link in navigation (default: "Home")
+- `show_home_in_nav` - show home link in navigation (default: true)
+- `nav_links` - comma separated extra nav links, as bare URLs or Markdown links like `[Label](https://example.com)`
+- `nav_extra` - raw HTML appended inside the `<nav>` after the generated link list
+- `footer` - footer html/text shown at the bottom of pages
+- `logo` - logo image path (used in header if enabled)
+- `display_logo` - show logo in header
+- `display_title` - show title text in header
+- `logo_as_favicon` - use `logo` as favicon
+- `favicon` - explicit favicon path (used when `logo_as_favicon` is false or no logo is set)
+- `generate_page_title` - automatically generate title text from the first markdown heading or filename (default: true)
+- `error_page` - filename for the generated 404 error page (default: "not_found.html", empty to disable)
+- `versioning` - append a version query parameter (`?v=timestamp`) to css asset urls to bypass cache (default: false)
+- `base_url` - absolute URL of the site, used for sitemap and RSS feed generation
+- `generate_feed` - enable RSS feed generation (requires `base_url`)
+- `feed_file` - filename for the generated RSS feed (default: "rss.xml")
+- `posts_dir` - directory name containing posts (e.g., "posts"). Enables reverse-chronological sorting, title headings in indexes, and automatic backlinks.
+- `enable_header_links` - turns markdown section headings into clickable anchor links (default: true)
+- `custom_admonitions` - comma separated list of custom admonitions

site/depths/index.md

@@ -0,0 +1,5 @@
+# Depths
+
+This is a custom index for a directory
+
+{{LIST}}

site/index.md

@@ -14,12 +14,15 @@ It's meant to be a static site generator, like _[kew](https://github.com/uint23/
 ## Features
 
 - No dependencies
+- Frontmatter support (title, date, draft)
 - Supports many embed types
 - Automatic css variable replacement for older browsers
 - Automatic inlining and embedding of many filetypes with `\![link]` or `\![alt](link)`
+- Typed embeds: `\!i`, `\!v`, `\!a`, `\!f`, `\!e`
 - Inline html support
 - MFM `$font` and `\<plain>` tags
-- Admonition support (that's what the blocks like the warning block below are called)
+- GFM Admonition support (that's what the blocks like the warning block below are called)
+- Task list support (`- [ ]`, `- [x]`)
 - RSS/Feed generation and Sitemap support
 - Post creation via `--post`
 - Automatic 404 page generation
@@ -27,111 +30,9 @@ It's meant to be a static site generator, like _[kew](https://github.com/uint23/
 - Code block classes for use with external libraries like highlight.js or prism.js (both tested)
 - Clickable markdown header anchors
 - Mobile responsive layout
+- Customisable directory index pages with `{{LIST}}`
 
-If you want to **force** a file to be inlined, use `\!![]` instead of `\![]`
+***
 
-## Installation
+> [!WARNING]
-
+> The base that all of this is built upon was coded at night, while sleepy and a bit sick, and after walking for about 4 hours around a forest, so...
-You can clone the repository to use `kewt.sh` directly, or you can download the standalone executable, which bundles all dependencies into a single file:
-
-```sh
-curl -L -o kewt https://git.krzak.org/N0VA/kewt/releases/download/latest/kewt
-chmod +x kewt
-```
-
-On Arch Linux, _kewt_ is available on the AUR:
-
-- [kewt-bin](https://aur.archlinux.org/packages/kewt-bin) — prebuilt standalone binary from the latest release
-- [kewt-git](https://aur.archlinux.org/packages/kewt-git) — built from the latest git source
-
-## Usage
-
-```sh
-./kewt.sh --help
-./kewt.sh --version
-./kewt.sh --new [title]
-./kewt.sh --post
-./kewt.sh --from <src> --to <out>
-./kewt.sh [src] [out]
-```
-
-`--new [title]` creates a new site directory with a copied `site.conf` and a default `index.md`.
-
-`--post` creates a new empty markdown file in the configured `posts_dir` with the current date and time as the name.
-
-## site.conf
-
-```conf
-title = "kewt"
-style = "kewt"
-dir_indexes = true
-single_file_index = true
-flatten = false
-order = ""
-home_name = "Home"
-show_home_in_nav = true
-nav_links = ""
-nav_extra = ""
-footer = "made with <a href=\"https://kewt.krzak.org\">kewt</a>"
-logo = ""
-display_logo = false
-display_title = true
-logo_as_favicon = true
-favicon = ""
-generate_page_title = true
-error_page = "not_found.html"
-versioning = false
-base_url = ""
-generate_feed = false
-feed_file = "rss.xml"
-posts_dir = ""
-enable_header_links = true
-```
-
-- `title` site title
-- `style` style file name from `./styles` (without `.css`)
-- `dir_indexes` generate directory index pages when missing `index.md`
-- `single_file_index` if a directory has one markdown file and no `index.md`, use that file as `index.html`
-- `flatten` flatten sidebar directory levels
-- `order` comma separated file/directory name list to order the sidebar (alphabetical by default)
-- `home_name` text for the home link in navigation (default: "Home")
-- `show_home_in_nav` show home link in navigation (default: true)
-- `nav_links` comma separated extra nav links, as bare URLs or Markdown links like `[Label](https://example.com)`
-- `nav_extra` raw HTML appended inside the `<nav>` after the generated link list
-- `footer` footer html/text shown at the bottom of pages
-- `logo` logo image path (used in header if enabled)
-- `display_logo` show logo in header
-- `display_title` show title text in header
-- `logo_as_favicon` use `logo` as favicon
-- `favicon` explicit favicon path (used when `logo_as_favicon` is false or no logo is set)
-- `generate_page_title` automatically generate title text from the first markdown heading or filename (default: true)
-- `error_page` filename for the generated 404 error page (default: "not_found.html", empty to disable)
-- `versioning` append a version query parameter (`?v=timestamp`) to css asset urls to bypass cache (default: false)
-- `base_url` absolute URL of the site, used for sitemap and RSS feed generation
-- `generate_feed` enable RSS feed generation (requires `base_url`)
-- `feed_file` filename for the generated RSS feed (default: "rss.xml")
-- `posts_dir` directory name containing posts (e.g., "posts"). Enables reverse-chronological sorting, title headings in indexes, and automatic backlinks.
-- `enable_header_links` turns markdown section headings into clickable anchor links (default: true)
-
-## Ignores
-
-- `.kewtignore`: Files/directories to ignore. If empty, the whole directory gets ignored
-- `.kewthide`: Files/directories to hide from navigation but still process. Same empty rules as with ignore
-- `.kewtpreserve`: Files/directories to copy but not convert markdown to html. Same empty rules again
-
-## Embeds
-
-- `\![link]`:
-  - local image/audio/video files are embedded as media tags
-  - local text/code files are inlined directly
-  - global image/audio/video links are embedded as media tags
-  - other global links are embedded as `<iframe>`
-- `\![alt](link)` works the same, with `alt` used for images
-- `\!![]` and `\!![alt](link)` force inline local file contents
-
-## Credits
-
-- _kew_ css style adapted from _[kew](https://github.com/uint23/kew)_ by [uint23](https://github.com/uint23)
-
->[!WARNING]
->The base that all of this is built upon was coded at night, while sleepy and a bit sick, and after walking for about 4 hours around a forest, so...

site/site.conf

@@ -9,7 +9,7 @@ display_logo = false
 display_title = true
 logo_as_favicon = false
 favicon = "favicon.ico"
-order = ""
+order = "Home, Docs, depths, Heaven"
 home_name = "Home"
 show_home_in_nav = true
 nav_links = ""
@@ -19,3 +19,7 @@ error_page = "not_found.html"
 versioning = true
 enable_header_links = true
 base_url = "https://kewt.krzak.org"
+custom_admonitions = ""
+generate_feed = false
+feed_file = "rss.xml"
+posts_dir = ""

styles/kewt.css

@@ -273,4 +273,13 @@ hr {
         margin-right: 20px;
         padding-top: 30px;
     }
+}
+
+.task-list-item {
+    list-style-type: none;
+}
+
+.task-list-item-checkbox {
+    margin: 0 0.2em 0.25em -1.6em;
+    vertical-align: middle;
 }

tools/build-standalone.sh

@@ -26,7 +26,7 @@ exit $?
 #==PAYLOAD==
 EOF
 
-VERSION=$(git describe --tags --abbrev=0 2>/dev/null || echo "standalone")
+VERSION=$(git describe --tags 2>/dev/null || echo "standalone")
 tmpbuild=$(mktemp -d)
 cp -r "$REPO_ROOT/kewt.sh" "$REPO_ROOT/markdown.sh" "$REPO_ROOT/awk" "$REPO_ROOT/styles" "$tmpbuild/"
 sed -e "s/kewt version git/kewt version $VERSION/" "$tmpbuild/kewt.sh" > "$tmpbuild/kewt.sh.tmp" && mv "$tmpbuild/kewt.sh.tmp" "$tmpbuild/kewt.sh"