feat: frontmatter

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

@@ -7,6 +7,7 @@ on:
     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,37 @@ 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
+
+          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
+          git init
+          git remote add origin https://x-access-token:${{ secrets.GH_RELEASE_TOKEN }}@github.com/n0va-bot/homebrew-tap.git
+          git fetch origin main || true
+          git checkout main 2>/dev/null || git checkout --orphan main
+
+          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 origin main

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
-
-```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
+## [Installation](https://kewt.krzak.org/#Installation)
 
 ## 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/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) {

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

@@ -107,6 +107,7 @@ EOF
 
 create_new_post() {
     post_src_dir="$1"
+    post_user_title="$2"
 
     target_dir="$post_src_dir"
     if [ -n "$posts_dir" ]; then
@@ -126,7 +127,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
@@ -263,6 +269,10 @@ while [ $# -gt 0 ]; do
             ;;
         --post)
             post_mode="true"
+            if [ $# -gt 1 ] && [ "${2#-}" = "$2" ]; then
+                post_title="$2"
+                shift
+            fi
             ;;
         --update)
             update_dir="."
@@ -512,7 +522,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
@@ -534,6 +544,24 @@ escape_html_attr() {
         -e 's/>/\>/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
 
@@ -718,8 +746,12 @@ render_markdown() {
         head_extra="<link rel=\"icon\" href=\"$favicon_src\" />"
     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
@@ -814,24 +846,62 @@ eval "find \"$src\" \( $IGNORE_ARGS \) -prune -o -type d -print" | sort | while
             elif [ "${entry%.md}" != "$entry" ]; then
                 label="${name%.md}"
 
+                # Parse frontmatter for date/title/draft
+                parse_frontmatter "$entry"
+                [ "$fm_draft" = "true" ] && continue
+
                 # Try to get first heading
+                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
-                        # For posts add date and time
+                    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 [ "$rel_dir" = "$posts_dir" ] || [ "./$rel_dir" = "$posts_dir" ]; then
-                    # No heading and date and time for posts
+                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
@@ -839,6 +909,7 @@ eval "find \"$src\" \( $IGNORE_ARGS \) -prune -o -type d -print" | sort | while
                         fi
                         label="$p_date $p_time"
                     fi
+                fi
                 echo "- [$label](${name%.md}.html)" >> "$temp_index"
             else
                 echo "- [$name]($name)" >> "$temp_index"
@@ -884,6 +955,11 @@ 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"
         if needs_rebuild "$file" "$out_file"; then
@@ -941,20 +1017,34 @@ if [ "$generate_feed" = "true" ] && [ -n "$base_url" ]; then
     printf '    <description>%s</description>\n' "$title" >> "$feed_path"
     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
+        parse_frontmatter "$post_file"
+        [ "$fm_draft" = "true" ] && continue
+
+        # 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="$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')
@@ -963,7 +1053,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#/}"
@@ -972,6 +1062,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" ;;
@@ -981,7 +1073,7 @@ if [ "$generate_feed" = "true" ] && [ -n "$base_url" ]; then
         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 '      <title>%s</title>\n' "$feed_post_title" >> "$feed_path"
         printf '      <link>%s</link>\n' "$post_url" >> "$feed_path"
         printf '      <guid>%s</guid>\n' "$post_url" >> "$feed_path"
         printf '      <pubDate>%s</pubDate>\n' "$pub_date" >> "$feed_path"

markdown.sh

@@ -18,7 +18,12 @@ sed_inplace() {
 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"

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/index.md

@@ -14,9 +14,11 @@ 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
 - GFM Admonition support (that's what the blocks like the warning block below are called)
@@ -31,20 +33,58 @@ It's meant to be a static site generator, like _[kew](https://github.com/uint23/
 
 If you want to **force** a file to be inlined, use `\!![]` instead of `\![]`
 
+***
+
 ## Installation
 
-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:
+### Standalone
 
 ```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:
+### 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
+```
+
+***
+
 ## Usage
 
 ```sh
@@ -58,9 +98,9 @@ On Arch Linux, _kewt_ is available on the AUR:
 
 `--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.
+`--post [title]` creates a new markdown file in the configured `posts_dir` with the current date/time as the name and creates the default frontmatter.
 
-## site.conf
+### site.conf
 
 ```conf
 title = "kewt"
@@ -116,13 +156,13 @@ custom_admonitions = ""
 - `enable_header_links` turns markdown section headings into clickable anchor links (default: true)
 - `custom_admonitions` comma separated list of custom admonitions
 
-## Ignores
+### 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
+### Embeds
 
 - `\![link]`:
   - local image/audio/video files are embedded as media tags
@@ -131,10 +171,30 @@ custom_admonitions = ""
   - 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
+- **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
 
-## Credits
+### Frontmatter
 
-- _kew_ css style adapted from _[kew](https://github.com/uint23/kew)_ by [uint23](https://github.com/uint23)
+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
+
+***
 
 >[!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...