fix: to the fix, clap your hands together, caramelldanse o-o-or whatever

.gitignore

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

LICENSE

@@ -0,0 +1,35 @@
+ISC License
+
+Copyright 2026 N0\A
+
+Permission to use, copy, modify, and/or distribute this software
+for any purpose with or without fee is hereby granted, provided
+that the above copyright notice and this permission notice appear
+in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
+WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
+AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
+DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA
+OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+
+---
+
+This project incorporates code (CSS style) from the 'kew' project, which is also licensed under the ISC License:
+
+Copyright (c) 2023 uint23
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

README.md

@@ -16,6 +16,8 @@ It's meant to be a static site generator, like _[kew](https://github.com/uint23/
 - Inline html support
 - MFM `$font` and `\<plain>` tags
 - Admonition support (that's what the blocks like the warning block below are called)
+- RSS/Feed generation and Sitemap support
+- Post creation via `--post`
 
 If you want to **force** a file to be inlined, use `\!![]` instead of `\![]`
 
@@ -24,7 +26,7 @@ If you want to **force** a file to be inlined, use `\!![]` instead of `\![]`
 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/latest/download/kewt
+curl -L -o kewt https://git.krzak.org/N0VA/kewt/releases/download/latest/kewt
 chmod +x kewt
 ```
 
@@ -38,12 +40,15 @@ On Arch Linux, _kewt_ is available on the AUR:
 ```sh
 ./kewt.sh --help
 ./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
@@ -57,12 +62,19 @@ home_name = "Home"
 show_home_in_nav = true
 nav_links = ""
 nav_extra = ""
-footer = "made with <a href="https://kewt.krzak.org">kewt</a>"
+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 = ""
 ```
 
 - `title` site title
@@ -81,6 +93,13 @@ favicon = ""
 - `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.
 
 ## Ignores
 
@@ -100,7 +119,6 @@ favicon = ""
 
 ## Credits
 
-- Markdown to html conversion based on [markdown.bash](https://github.com/chadbraunduin/markdown.bash) by [chadbraunduin](https://github.com/chadbraunduin)
 - Default css style and html template based on _[kew](https://github.com/uint23/kew)_ by [uint23](https://github.com/uint23)
 
 >[!WARNING]

awk/headers.awk

@@ -8,18 +8,21 @@ function strip_markdown(s) {
     return s
 }
 function print_header(line) {
-    if (line ~ /^# /) {
+    tag = ""
-        sub(/^# /, "", line); print "<h1 id=\"" strip_markdown(line) "\">" line "</h1>"
+    if (line ~ /^# /) { tag = "h1"; sub(/^# /, "", line) }
-    } else if (line ~ /^## /) {
+    else if (line ~ /^## /) { tag = "h2"; sub(/^## /, "", line) }
-        sub(/^## /, "", line); print "<h2 id=\"" strip_markdown(line) "\">" line "</h2>"
+    else if (line ~ /^### /) { tag = "h3"; sub(/^### /, "", line) }
-    } else if (line ~ /^### /) {
+    else if (line ~ /^#### /) { tag = "h4"; sub(/^#### /, "", line) }
-        sub(/^### /, "", line); print "<h3 id=\"" strip_markdown(line) "\">" line "</h3>"
+    else if (line ~ /^##### /) { tag = "h5"; sub(/^##### /, "", line) }
-    } else if (line ~ /^#### /) {
+    else if (line ~ /^###### /) { tag = "h6"; sub(/^###### /, "", line) }
-        sub(/^#### /, "", line); print "<h4 id=\"" strip_markdown(line) "\">" line "</h4>"
+
-    } else if (line ~ /^##### /) {
+    if (tag != "") {
-        sub(/^##### /, "", line); print "<h5 id=\"" strip_markdown(line) "\">" line "</h5>"
+        id = strip_markdown(line)
-    } else if (line ~ /^###### /) {
+        if (enable_header_links == "true") {
-        sub(/^###### /, "", line); print "<h6 id=\"" strip_markdown(line) "\">" line "</h6>"
+            print "<" tag " id=\"" id "\"><a href=\"#" id "\" class=\"header-anchor\">" line "</a></" tag ">"
+        } else {
+            print "<" tag " id=\"" id "\">" line "</" tag ">"
+        }
     } else {
         print line
     }

kewt.sh

@@ -6,18 +6,24 @@ die() {
 }
 
 usage() {
-    invoked_as="${KEWT_INVOKED_AS:-$0}"
+    invoked_as=$(basename "${KEWT_INVOKED_AS:-$0}")
     cat <<EOF
 Usage: $invoked_as [--from <src>] [--to <out>]
        $invoked_as [src] [out]
        $invoked_as --new [title]
+       $invoked_as --update [dir]
+       $invoked_as --post
+       $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)
-  --from <src>   Source directory (default: site)
+  --update [dir]  Update site.conf and template.html with latest defaults (defaults to current directory)
-  --to <out>     Output directory (default: out)
+  --post          Create a new empty post file in the configured posts_dir with current date and time as name
+  --version       Show version information.
+  --from <src>    Source directory (default: site)
+  --to <out>      Output directory (default: out)
 EOF
 }
 
@@ -40,12 +46,20 @@ home_name = "Home"
 show_home_in_nav = true
 nav_links = ""
 nav_extra = ""
-footer = "made with <a href="https://kewt.krzak.org">kewt</a>"
+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 = ""
 EOF
     fi
 
@@ -97,12 +111,141 @@ create_new_site() {
     exit 0
 }
 
+create_new_post() {
+    post_src_dir="$1"
+
+    target_dir="$post_src_dir"
+    if [ -n "$posts_dir" ]; then
+        target_dir="$post_src_dir/$posts_dir"
+    fi
+
+    mkdir -p "$target_dir"
+
+    base_filename="$(date +%Y-%m-%d-%H:%M)"
+    filename="${base_filename}.md"
+    file_path="$target_dir/$filename"
+
+    counter=1
+    while [ -e "$file_path" ]; do
+        filename="${base_filename}_${counter}.md"
+        file_path="$target_dir/$filename"
+        counter=$((counter + 1))
+    done
+
+    touch "$file_path"
+
+    echo "Created new post at '$file_path'."
+    exit 0
+}
+
+update_site() {
+    update_dir="${1:-.}"
+    [ -d "$update_dir" ] || die "Directory '$update_dir' does not exist."
+
+    target_conf="$update_dir/site.conf"
+    target_tmpl="$update_dir/template.html"
+
+    # Generate default site.conf
+    default_conf="$KEWT_TMPDIR/default_site.conf"
+    cat > "$default_conf" <<'CONFEOF'
+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
+        echo "No site.conf found in '$update_dir'; nothing to update."
+    else
+        added=0
+        while IFS= read -r line; do
+            case "$line" in
+                ''|'#'*) continue ;;
+                *=*) ;;
+                *) continue ;;
+            esac
+            key=$(printf '%s' "${line%%=*}" | sed 's/^[[:space:]]*//; s/[[:space:]]*$//')
+            if ! grep -q "^[[:space:]]*${key}[[:space:]]*=" "$target_conf"; then
+                printf '%s\n' "$line" >> "$target_conf"
+                echo "  Added: $key"
+                added=$((added + 1))
+            fi
+        done < "$default_conf"
+        if [ "$added" -eq 0 ]; then
+            echo "site.conf is already up to date."
+        else
+            echo "Added $added new key(s) to '$target_conf'."
+        fi
+    fi
+
+    # Update template.html
+    if [ -f "$target_tmpl" ]; then
+        default_tmpl="$KEWT_TMPDIR/default_template.html"
+        cat > "$default_tmpl" <<'TMPLEOF'
+<!doctype html>
+<html>
+    <head>
+        <meta charset="UTF-8" />
+        <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
+            cp "$default_tmpl" "${target_tmpl}.default"
+            echo "template.html has local changes; saved latest default as '${target_tmpl}.default'."
+            echo ""
+            diff "$target_tmpl" "${target_tmpl}.default" || true
+        fi
+    fi
+
+    exit 0
+}
+
 
 
 src=""
 out=""
 new_mode="false"
 new_title=""
+post_mode="false"
+post_title=""
 positional_count=0
 
 while [ $# -gt 0 ]; do
@@ -118,6 +261,21 @@ while [ $# -gt 0 ]; do
                 shift
             fi
             ;;
+        --version|-v)
+            echo "kewt version git"
+            exit 0
+            ;;
+        --post)
+            post_mode="true"
+            ;;
+        --update)
+            update_dir="."
+            if [ $# -gt 1 ] && [ "${2#-}" = "$2" ]; then
+                update_dir="$2"
+                shift
+            fi
+            update_site "$update_dir"
+            ;;
         --from)
             [ $# -lt 2 ] && die "--from requires a value."
             src="$2"
@@ -149,13 +307,26 @@ done
 
 ensure_root_defaults
 
-[ -z "$src" ] && src="site"
+if [ -z "$src" ]; then
+    if [ "$post_mode" = "true" ] && [ -f "./site.conf" ]; then
+        src="."
+    else
+        src="site"
+    fi
+fi
 [ -z "$out" ] && out="out"
 
 src="${src%/}"
 out="${out%/}"
 
-[ -d "$src" ] || die "Source directory '$src' does not exist."
+if [ ! -d "$src" ]; then
+    if [ "$src" = "site" ]; then
+        usage
+        exit 1
+    else
+        die "Source directory '$src' does not exist."
+    fi
+fi
 
 IGNORE_ARGS="-name '.kewtignore' -o -path '$src/.*'"
 
@@ -249,7 +420,11 @@ rm -f "$KEWT_TMPDIR/kewt_preserve"
 
 generate_nav() {
     dinfo=$(eval "find \"$1\" \( $IGNORE_ARGS -o $HIDE_ARGS -o $PRESERVE_ARGS \) -prune -o -print" | sort | awk -v src="$1" -f "$awk_dir/collect_dir_info.awk")
-    eval "find \"$1\" \( $IGNORE_ARGS -o $HIDE_ARGS -o $PRESERVE_ARGS \) -prune -o -name \"*.md\" -print" | sort | awk -v src="$1" -v single_file_index="$single_file_index" -v flatten="$flatten" -v order="$order" -v home_name="$home_name" -v show_home_in_nav="$show_home_in_nav" -v dinfo="$dinfo" -f "$awk_dir/generate_sidebar.awk"
+    find_cmd="find \"$1\" \( $IGNORE_ARGS -o $HIDE_ARGS -o $PRESERVE_ARGS \) -prune -o -name \"*.md\" -print"
+    if [ -n "$posts_dir" ] && [ -d "$1/$posts_dir" ]; then
+        find_cmd="$find_cmd && echo \"$1/$posts_dir/index.md\""
+    fi
+    eval "$find_cmd" | sort -u | awk -v src="$1" -v single_file_index="$single_file_index" -v flatten="$flatten" -v order="$order" -v home_name="$home_name" -v show_home_in_nav="$show_home_in_nav" -v dinfo="$dinfo" -f "$awk_dir/generate_sidebar.awk"
 }
 
 title="kewt"
@@ -269,6 +444,14 @@ 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=""
 
 load_config() {
     [ -f "$1" ] || return
@@ -285,8 +468,14 @@ load_config() {
         key=$(printf '%s' "$key" | sed 's/^[[:space:]]*//; s/[[:space:]]*$//')
         val=$(printf '%s' "$val" | sed 's/^[[:space:]]*//; s/[[:space:]]*$//')
         case "$val" in
-            \"*\") val=${val#\"}; val=${val%\"} ;;
+            \"*\")
-            \'*\') val=${val#\'}; val=${val%\'} ;;
+                val=${val#\"}; val=${val%\"}
+                val=$(printf '%s' "$val" | sed 's/\\"/\"/g; s/\\\\/\\/g')
+                ;;
+            \'*\')
+                val=${val#\'}; val=${val%\'}
+                val=$(printf '%s' "$val" | sed "s/\\\\'/'/g; s/\\\\/\\/g")
+                ;;
         esac
 
         case "$key" in
@@ -306,6 +495,14 @@ load_config() {
             display_title) display_title="$val" ;;
             logo_as_favicon) logo_as_favicon="$val" ;;
             favicon) favicon="$val" ;;
+            generate_page_title) generate_page_title="$val" ;;
+            error_page) error_page="$val" ;;
+            versioning) versioning="$val" ;;
+            enable_header_links) enable_header_links="$val" ;;
+            base_url) base_url="$val" ;;
+            generate_feed) generate_feed="$val" ;;
+            feed_file) feed_file="$val" ;;
+            posts_dir) posts_dir="$val" ;;
         esac
     done < "$1"
 }
@@ -313,6 +510,17 @@ load_config() {
 load_config "./site.conf"
 load_config "$src/site.conf"
 
+if [ -n "$posts_dir" ]; then
+    HIDE_ARGS="$HIDE_ARGS -o -path '$src/$posts_dir/*'"
+fi
+
+[ "$post_mode" = "true" ] && create_new_post "$src"
+
+asset_version=""
+if [ "$versioning" = "true" ]; then
+    asset_version="?v=$(date +%s)"
+fi
+
 escape_html_text() {
     printf '%s' "$1" | sed \
         -e 's/&/\&amp;/g' \
@@ -414,6 +622,21 @@ copy_style_with_resolved_vars() {
 
 render_markdown() {
     file="$1"
+    is_home="$2"
+
+    content_file="$file"
+    if [ -n "$posts_dir" ] && [ "$file" != "$src/$posts_dir/index.md" ]; then
+        dir_of_file=$(dirname "$file")
+        rel_dir_of_file="${dir_of_file#"$src"}"
+        rel_dir_of_file="${rel_dir_of_file#/}"
+        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"
+             content_file="$temp_post_with_backlink"
+        fi
+    fi
+
     local_template=$(find_closest "template.html" "$(dirname "$file")")
     [ -z "$local_template" ] && local_template="$template"
 
@@ -462,7 +685,26 @@ render_markdown() {
         head_extra="<link rel=\"icon\" href=\"$favicon_src\" />"
     fi
 
-    MARKDOWN_SITE_ROOT="$src" MARKDOWN_FALLBACK_FILE="$script_dir/styles/$style.css" sh "$script_dir/markdown.sh" "$file" | awk -v title="$title" -v nav="$nav" -v footer="$footer" -v style_path="$style_path" -v header_brand="$header_brand" -v head_extra="$head_extra" -f "$awk_dir/render_template.awk" "$local_template"
+    page_title="$title"
+    if [ "$generate_page_title" = "true" ] && [ -n "$file" ] && [ -f "$file" ]; then
+        if [ "$is_home" = "true" ] && [ -n "$home_name" ]; then
+            page_title="$home_name - $title"
+        else
+            first_heading=$(grep -m 1 '^# ' "$file" | sed 's/^# *//; s/ *$//')
+            if [ -n "$first_heading" ]; then
+                first_heading=$(echo "$first_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')
+                page_title="$first_heading - $title"
+            else
+                basename_no_ext=$(basename "$file" .md)
+                if [ "$basename_no_ext" != "index" ] && [ "$basename_no_ext" != "404_gen" ]; then
+                    cap_basename=$(echo "$basename_no_ext" | awk '{print toupper(substr($0,1,1)) substr($0,2)}')
+                    page_title="$cap_basename - $title"
+                fi
+            fi
+        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 -v title="$page_title" -v nav="$nav" -v footer="$footer" -v style_path="${style_path}${asset_version}" -v header_brand="$header_brand" -v head_extra="$head_extra" -f "$awk_dir/render_template.awk" "$local_template"
 }
 
 echo "Building site from '$src' to '$out'..."
@@ -483,11 +725,16 @@ eval "find \"$src\" \( $IGNORE_ARGS \) -prune -o -type d -print" | sort | while
     [ "$dir_indexes" != "true" ] && continue
 
     if [ ! -f "$dir/index.md" ]; then
-        if [ "$single_file_index" = "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
             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")
-                render_markdown "$md_file" > "$out_dir/index.html"
+                is_home="false"; [ "$dir" = "$src" ] && is_home="true"
+                render_markdown "$md_file" "$is_home" > "$out_dir/index.html"
                 continue
             fi
         fi
@@ -497,7 +744,14 @@ eval "find \"$src\" \( $IGNORE_ARGS \) -prune -o -type d -print" | sort | while
         [ -z "$display_dir" ] && display_dir="/"
         echo "# Index of $display_dir" > "$temp_index"
         echo "" >> "$temp_index"
-        find "$dir" ! -name "$(basename "$dir")" -prune ! -name ".*" -print | sort | while read -r entry; do
+
+        sort_args=""
+        # If this is the posts dir reverse
+        if [ "$rel_dir" = "$posts_dir" ] || [ "./$rel_dir" = "$posts_dir" ]; then
+            sort_args="-r"
+        fi
+
+        find "$dir" ! -name "$(basename "$dir")" -prune ! -name ".*" -print | LC_ALL=C sort $sort_args | while read -r entry; do
             name="${entry##*/}"
             case "$name" in
                 template.html|site.conf|style.css|index.md) continue ;;
@@ -505,12 +759,40 @@ eval "find \"$src\" \( $IGNORE_ARGS \) -prune -o -type d -print" | sort | while
             if [ -d "$entry" ]; then
                 echo "- [${name}/](${name}/index.html)" >> "$temp_index"
             elif [ "${entry%.md}" != "$entry" ]; then
-                echo "- [${name%.md}](${name%.md}.html)" >> "$temp_index"
+                label="${name%.md}"
+
+                # Try to get first heading
+                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')
+
+                    if [ "$rel_dir" = "$posts_dir" ] || [ "./$rel_dir" = "$posts_dir" ]; then
+                        # For posts add date and time
+                        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"
+                    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"
             else
                 echo "- [$name]($name)" >> "$temp_index"
             fi
         done
-        render_markdown "$temp_index" > "$out_dir/index.html"
+        is_home="false"; [ "$dir" = "$src" ] && is_home="true"
+        render_markdown "$temp_index" "$is_home" > "$out_dir/index.html"
         rm "$temp_index"
     fi
 done
@@ -534,18 +816,119 @@ eval "find \"$src\" \( $IGNORE_ARGS \) -prune -o -type f -print" | sort | while
         is_preserved=1
     fi
 
-    if [ "$single_file_index" = "true" ] && [ "${file%.md}" != "$file" ] && [ "$is_preserved" -eq 0 ] && [ ! -f "$(dirname "$file")/index.md" ]; then
+    is_posts_dir_2="false"
+    if [ -n "$posts_dir" ] && { [ "$dir_rel" = "$posts_dir" ] || [ "./$dir_rel" = "$posts_dir" ]; }; then
+        is_posts_dir_2="true"
+    fi
+
+    if [ "$single_file_index" = "true" ] && [ "${file%.md}" != "$file" ] && [ "$is_preserved" -eq 0 ] && [ ! -f "$(dirname "$file")/index.md" ] && [ "$is_posts_dir_2" = "false" ]; then
         md_count=$(find "$(dirname "$file")" ! -name "$(basename "$(dirname "$file")")" -prune -name "*.md" | wc -l)
         [ "$md_count" -eq 1 ] && continue
     fi
 
     if [ "${file%.md}" != "$file" ] && [ "$is_preserved" -eq 0 ]; then
+        is_home="false"; [ "$file" = "$src/index.md" ] && is_home="true"
         out_file="$out/${rel_path%.md}.html"
-        render_markdown "$file" > "$out_file"
+        render_markdown "$file" "$is_home" > "$out_file"
     else
         cp "$file" "$out/$rel_path"
     fi
 done
 
+if [ -n "$error_page" ] && [ ! -f "$out/$error_page" ]; then
+    temp_404="$KEWT_TMPDIR/404_gen.md"
+    echo "# 404 - Not Found" > "$temp_404"
+    echo "" >> "$temp_404"
+    echo "The requested page could not be found." >> "$temp_404"
+    render_markdown "$temp_404" > "$out/$error_page"
+    rm -f "$temp_404"
+fi
+
+if [ -n "$base_url" ]; then
+    sitemap_file="$out/sitemap.xml"
+    base_url="${base_url%/}"
+    today=$(date +%Y-%m-%d)
+
+    printf '<?xml version="1.0" encoding="UTF-8"?>\n' > "$sitemap_file"
+    printf '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n' >> "$sitemap_file"
+
+    find "$out" -type f -name "*.html" -print | sort | while IFS= read -r html_file; do
+        rel_url="${html_file#"$out"}"
+
+        # 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 '    <lastmod>%s</lastmod>\n' "$today" >> "$sitemap_file"
+        printf '  </url>\n' >> "$sitemap_file"
+    done
+
+    printf '</urlset>\n' >> "$sitemap_file"
+fi
+
+if [ "$generate_feed" = "true" ] && [ -n "$base_url" ]; then
+    feed_path="$out/$feed_file"
+    base_url_feed="${base_url%/}"
+    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 '    <title>%s</title>\n' "$title" >> "$feed_path"
+    printf '    <link>%s</link>\n' "$base_url_feed" >> "$feed_path"
+    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
+        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)
+        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
+
+        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/^# *//')
+        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')
+            else
+                post_heading="Post"
+            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"
+
+        rel_path="${post_file#"$src"}"
+        rel_path="${rel_path#/}"
+        post_url="$base_url_feed/${rel_path%.md}.html"
+
+        pub_year=$(echo "$post_date" | cut -d- -f1)
+        pub_month=$(echo "$post_date" | cut -d- -f2)
+        pub_day=$(echo "$post_date" | cut -d- -f3)
+        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" ;;
+            07) pub_mon="Jul" ;; 08) pub_mon="Aug" ;; 09) pub_mon="Sep" ;;
+            10) pub_mon="Oct" ;; 11) pub_mon="Nov" ;; 12) pub_mon="Dec" ;;
+        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 '      <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"
+        printf '    </item>\n' >> "$feed_path"
+    done
+
+    printf '  </channel>\n' >> "$feed_path"
+    printf '</rss>\n' >> "$feed_path"
+fi
 
 echo "Build complete."

markdown.sh

@@ -51,7 +51,7 @@ awk -f "$awk_dir/blockquote_to_admonition.awk" "$temp_file" > "$temp_file.tmp" &
 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"
-awk -f "$awk_dir/headers.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
+awk -v enable_header_links="$ENABLE_HEADER_LINKS" -f "$awk_dir/headers.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
 awk -f "$awk_dir/lists.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
 
 # Spacing

site.conf

@@ -1,16 +0,0 @@
-title = "kewt"
-style = "kewt"
-dir_indexes = true
-single_file_index = true
-flatten = false
-footer = "made with <a href="https://kewt.krzak.org">kewt</a>"
-logo = ""
-display_logo = false
-display_title = true
-logo_as_favicon = true
-favicon = ""
-order = ""
-home_name = "Home"
-show_home_in_nav = true
-nav_links = ""
-nav_extra = ""

site/index.md

@@ -16,6 +16,8 @@ It's meant to be a static site generator, like _[kew](https://github.com/uint23/
 - Inline html support
 - MFM `$font` and `\<plain>` tags
 - Admonition support (that's what the blocks like the warning block below are called)
+- RSS/Feed generation and Sitemap support
+- Post creation via `--post`
 
 If you want to **force** a file to be inlined, use `\!![]` instead of `\![]`
 
@@ -24,7 +26,7 @@ If you want to **force** a file to be inlined, use `\!![]` instead of `\![]`
 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/latest/download/kewt
+curl -L -o kewt https://git.krzak.org/N0VA/kewt/releases/download/latest/kewt
 chmod +x kewt
 ```
 
@@ -38,12 +40,15 @@ On Arch Linux, _kewt_ is available on the AUR:
 ```sh
 ./kewt.sh --help
 ./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
@@ -57,12 +62,19 @@ home_name = "Home"
 show_home_in_nav = true
 nav_links = ""
 nav_extra = ""
-footer = "made with <a href="https://kewt.krzak.org">kewt</a>"
+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 = ""
 ```
 
 - `title` site title
@@ -81,6 +93,13 @@ favicon = ""
 - `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.
 
 ## Ignores
 
@@ -100,8 +119,7 @@ favicon = ""
 
 ## Credits
 
-- Markdown to html conversion based on [markdown.bash](https://github.com/chadbraunduin/markdown.bash) by [chadbraunduin](https://github.com/chadbraunduin)
 - Default css style and html template based on _[kew](https://github.com/uint23/kew)_ by [uint23](https://github.com/uint23)
 
->![WARNING]
+>[!WARNING]
 >Most of this was coded at night, while sleepy and a bit sick, and after walking for about 4 hours around a forest, so...

site/site.conf

@@ -3,10 +3,19 @@ style = "kewt"
 dir_indexes = true
 single_file_index = true
 flatten = false
-footer = "<a href="https://kewt.krzak.org"><img src="/button.gif" /></a>"
+footer = "<a href=\"https://kewt.krzak.org\"><img src=\"/button.gif\" /></a>"
 logo = ""
 display_logo = false
 display_title = true
 logo_as_favicon = true
 favicon = ""
 order = ""
+home_name = "Home"
+show_home_in_nav = true
+nav_links = ""
+nav_extra = ""
+generate_page_title = true
+error_page = "not_found.html"
+versioning = false
+enable_header_links = true
+base_url = "https://kewt.krzak.org"

template.html

@@ -1,21 +0,0 @@
-<!doctype html>
-<html>
-    <head>
-        <meta charset="UTF-8" />
-        <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>

tools/build-standalone.sh

@@ -26,7 +26,13 @@ exit $?
 #==PAYLOAD==
 EOF
 
-tar -cz -C "$REPO_ROOT" kewt.sh markdown.sh awk styles >> "$OUT_FILE"
+VERSION=$(git describe --tags --abbrev=0 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"
+chmod +x "$tmpbuild/kewt.sh" "$tmpbuild/markdown.sh"
+tar -cz -C "$tmpbuild" kewt.sh markdown.sh awk styles >> "$OUT_FILE"
+rm -rf "$tmpbuild"
 
 chmod +x "$OUT_FILE"