docs: massive doc update

feat: {{VERSION}} and content warning pages
feat: draft_by_default and lang
2026-03-31 12:08:52 +02:00 · 2026-03-31 11:44:29 +02:00 · 2026-03-30 09:55:26 +02:00 · 2026-03-30 09:54:44 +02:00 · 2026-03-30 09:54:23 +02:00 · 2026-03-26 13:16:34 +01:00
30 changed files with 1837 additions and 335 deletions
--- a/.gitignore
+++ b/.gitignore
@@ -1,4 +1,2 @@
 out/
 kewt
-site.conf
-template.html
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 _kewt_ is a minimalist ssg inspired by _[werc](http://werc.cat-v.org/)_ and _[kew](https://github.com/uint23/kew)_


-## [Installation](https://kewt.krzak.org/#Installation)
+## [Installation](https://kewt.krzak.org/docs/installation)

 ## Contributing

--- a/awk/definition_lists.awk
+++ b/awk/definition_lists.awk
@@ -0,0 +1,62 @@
+BEGIN {
+    in_dl = 0
+    has_prev = 0
+    prev_line = ""
+    in_pre = 0
+}
+{
+    if ($0 ~ /^<pre>/) {
+        if (!in_pre) in_pre = 1
+    }
+    
+    if (!in_pre && $0 ~ /^:[ \t]+[^ \t]/) {
+        if (!in_dl) {
+            in_dl = 1
+            print "<dl>"
+            print "<dt>" prev_line "</dt>"
+            has_prev = 0
+        } else {
+            if (has_prev && prev_line != "") {
+                print "<dt>" prev_line "</dt>"
+                has_prev = 0
+            }
+        }
+        def_text = $0
+        sub(/^:[ \t]+/, "", def_text)
+        print "<dd>" def_text "</dd>"
+        
+        if ($0 ~ /<\/pre>/) {
+            if (in_pre) in_pre = 0
+        }
+        next
+    } else {
+        if (in_dl) {
+            if ($0 == "") {
+                # End of definition list
+                print "</dl>"
+                in_dl = 0
+                print ""
+                has_prev = 0
+                next
+            }
+        }
+        if (has_prev) {
+            print prev_line
+        }
+        prev_line = $0
+        has_prev = 1
+    }
+    
+    if ($0 ~ /<\/pre>/) {
+        if (in_pre) in_pre = 0
+    }
+}
+END {
+    if (in_dl) {
+        print "</dl>"
+    } else {
+        if (has_prev) {
+            print prev_line
+        }
+    }
+}
--- a/awk/emoji.awk
+++ b/awk/emoji.awk
@@ -0,0 +1,857 @@
+BEGIN {
+    map[":+1:"] = "👍"
+    map[":100:"] = "💯"
+    map[":1234:"] = "🔢"
+    map[":8ball:"] = "🎱"
+    map[":a:"] = "🅰️"
+    map[":ab:"] = "🆎"
+    map[":abc:"] = "🔤"
+    map[":abcd:"] = "🔡"
+    map[":accept:"] = "🉑"
+    map[":aerial_tramway:"] = "🚡"
+    map[":airplane:"] = "✈️"
+    map[":alarm_clock:"] = "⏰"
+    map[":alien:"] = "👽"
+    map[":ambulance:"] = "🚑"
+    map[":anchor:"] = "⚓"
+    map[":angel:"] = "👼"
+    map[":anger:"] = "💢"
+    map[":angry:"] = "😠"
+    map[":anguished:"] = "😧"
+    map[":ant:"] = "🐜"
+    map[":apple:"] = "🍎"
+    map[":aquarius:"] = "♒"
+    map[":aries:"] = "♈"
+    map[":arrow_backward:"] = "◀️"
+    map[":arrow_double_down:"] = "⏬"
+    map[":arrow_double_up:"] = "⏫"
+    map[":arrow_down:"] = "⬇️"
+    map[":arrow_down_small:"] = "🔽"
+    map[":arrow_forward:"] = "▶️"
+    map[":arrow_heading_down:"] = "⤵️"
+    map[":arrow_heading_up:"] = "⤴️"
+    map[":arrow_left:"] = "⬅️"
+    map[":arrow_lower_left:"] = "↙️"
+    map[":arrow_lower_right:"] = "↘️"
+    map[":arrow_right:"] = "➡️"
+    map[":arrow_right_hook:"] = "↪️"
+    map[":arrow_up:"] = "⬆️"
+    map[":arrow_up_down:"] = "↕️"
+    map[":arrow_up_small:"] = "🔼"
+    map[":arrow_upper_left:"] = "↖️"
+    map[":arrow_upper_right:"] = "↗️"
+    map[":arrows_clockwise:"] = "🔃"
+    map[":arrows_counterclockwise:"] = "🔄"
+    map[":art:"] = "🎨"
+    map[":articulated_lorry:"] = "🚛"
+    map[":astonished:"] = "😲"
+    map[":atm:"] = "🏧"
+    map[":b:"] = "🅱️"
+    map[":baby:"] = "👶"
+    map[":baby_bottle:"] = "🍼"
+    map[":baby_chick:"] = "🐤"
+    map[":baby_symbol:"] = "🚼"
+    map[":baggage_claim:"] = "🛄"
+    map[":balloon:"] = "🎈"
+    map[":ballot_box_with_check:"] = "☑️"
+    map[":bamboo:"] = "🎍"
+    map[":banana:"] = "🍌"
+    map[":bangbang:"] = "‼️"
+    map[":bank:"] = "🏦"
+    map[":bar_chart:"] = "📊"
+    map[":barber:"] = "💈"
+    map[":baseball:"] = "⚾"
+    map[":basketball:"] = "🏀"
+    map[":bath:"] = "🛀"
+    map[":bathtub:"] = "🛁"
+    map[":battery:"] = "🔋"
+    map[":bear:"] = "🐻"
+    map[":beer:"] = "🍺"
+    map[":beers:"] = "🍻"
+    map[":beetle:"] = "🪲"
+    map[":beginner:"] = "🔰"
+    map[":bell:"] = "🔔"
+    map[":bento:"] = "🍱"
+    map[":bicyclist:"] = "🚴"
+    map[":bike:"] = "🚲"
+    map[":bikini:"] = "👙"
+    map[":bird:"] = "🐦"
+    map[":birthday:"] = "🎂"
+    map[":black_circle:"] = "⚫"
+    map[":black_joker:"] = "🃏"
+    map[":black_nib:"] = "✒️"
+    map[":black_square_button:"] = "🔲"
+    map[":blossom:"] = "🌼"
+    map[":blowfish:"] = "🐡"
+    map[":blue_book:"] = "📘"
+    map[":blue_car:"] = "🚙"
+    map[":blue_heart:"] = "💙"
+    map[":blush:"] = "😊"
+    map[":boar:"] = "🐗"
+    map[":boat:"] = "⛵"
+    map[":bomb:"] = "💣"
+    map[":book:"] = "📖"
+    map[":bookmark:"] = "🔖"
+    map[":bookmark_tabs:"] = "📑"
+    map[":books:"] = "📚"
+    map[":boom:"] = "💥"
+    map[":boot:"] = "👢"
+    map[":bouquet:"] = "💐"
+    map[":bow:"] = "🙇"
+    map[":bowling:"] = "🎳"
+    map[":boy:"] = "👦"
+    map[":bread:"] = "🍞"
+    map[":bride_with_veil:"] = "👰‍♀️"
+    map[":bridge_at_night:"] = "🌉"
+    map[":briefcase:"] = "💼"
+    map[":broken_heart:"] = "💔"
+    map[":bug:"] = "🐛"
+    map[":bulb:"] = "💡"
+    map[":bullettrain_front:"] = "🚅"
+    map[":bullettrain_side:"] = "🚄"
+    map[":bus:"] = "🚌"
+    map[":busstop:"] = "🚏"
+    map[":bust_in_silhouette:"] = "👤"
+    map[":busts_in_silhouette:"] = "👥"
+    map[":cactus:"] = "🌵"
+    map[":cake:"] = "🍰"
+    map[":calendar:"] = "📆"
+    map[":calling:"] = "📲"
+    map[":camel:"] = "🐫"
+    map[":camera:"] = "📷"
+    map[":cancer:"] = "♋"
+    map[":candy:"] = "🍬"
+    map[":capital_abcd:"] = "🔠"
+    map[":capricorn:"] = "♑"
+    map[":car:"] = "🚗"
+    map[":card_index:"] = "📇"
+    map[":carousel_horse:"] = "🎠"
+    map[":cat2:"] = "🐈"
+    map[":cat:"] = "🐱"
+    map[":cd:"] = "💿"
+    map[":chart:"] = "💹"
+    map[":chart_with_downwards_trend:"] = "📉"
+    map[":chart_with_upwards_trend:"] = "📈"
+    map[":checkered_flag:"] = "🏁"
+    map[":cherries:"] = "🍒"
+    map[":cherry_blossom:"] = "🌸"
+    map[":chestnut:"] = "🌰"
+    map[":chicken:"] = "🐔"
+    map[":children_crossing:"] = "🚸"
+    map[":chocolate_bar:"] = "🍫"
+    map[":christmas_tree:"] = "🎄"
+    map[":church:"] = "⛪"
+    map[":cinema:"] = "🎦"
+    map[":circus_tent:"] = "🎪"
+    map[":city_sunrise:"] = "🌇"
+    map[":city_sunset:"] = "🌆"
+    map[":cl:"] = "🆑"
+    map[":clap:"] = "👏"
+    map[":clapper:"] = "🎬"
+    map[":clipboard:"] = "📋"
+    map[":clock1030:"] = "🕥"
+    map[":clock10:"] = "🕙"
+    map[":clock1130:"] = "🕦"
+    map[":clock11:"] = "🕚"
+    map[":clock1230:"] = "🕧"
+    map[":clock12:"] = "🕛"
+    map[":clock130:"] = "🕜"
+    map[":clock1:"] = "🕐"
+    map[":clock230:"] = "🕝"
+    map[":clock2:"] = "🕑"
+    map[":clock330:"] = "🕞"
+    map[":clock3:"] = "🕒"
+    map[":clock430:"] = "🕟"
+    map[":clock4:"] = "🕓"
+    map[":clock530:"] = "🕠"
+    map[":clock5:"] = "🕔"
+    map[":clock630:"] = "🕡"
+    map[":clock6:"] = "🕕"
+    map[":clock730:"] = "🕢"
+    map[":clock7:"] = "🕖"
+    map[":clock830:"] = "🕣"
+    map[":clock8:"] = "🕗"
+    map[":clock930:"] = "🕤"
+    map[":clock9:"] = "🕘"
+    map[":closed_book:"] = "📕"
+    map[":closed_lock_with_key:"] = "🔐"
+    map[":closed_umbrella:"] = "🌂"
+    map[":cloud:"] = "☁️"
+    map[":clubs:"] = "♣️"
+    map[":cn:"] = "🇨🇳"
+    map[":cocktail:"] = "🍸"
+    map[":coffee:"] = "☕"
+    map[":cold_sweat:"] = "😰"
+    map[":computer:"] = "💻"
+    map[":confetti_ball:"] = "🎊"
+    map[":confounded:"] = "😖"
+    map[":confused:"] = "😕"
+    map[":congratulations:"] = "㊗️"
+    map[":construction:"] = "🚧"
+    map[":construction_worker:"] = "👷"
+    map[":convenience_store:"] = "🏪"
+    map[":cookie:"] = "🍪"
+    map[":cool:"] = "🆒"
+    map[":cop:"] = "👮"
+    map[":copyright:"] = "©️"
+    map[":corn:"] = "🌽"
+    map[":couple:"] = "👫"
+    map[":couple_with_heart:"] = "💑"
+    map[":couplekiss:"] = "💏"
+    map[":cow2:"] = "🐄"
+    map[":cow:"] = "🐮"
+    map[":credit_card:"] = "💳"
+    map[":crocodile:"] = "🐊"
+    map[":crossed_flags:"] = "🎌"
+    map[":crown:"] = "👑"
+    map[":cry:"] = "😢"
+    map[":crying_cat_face:"] = "😿"
+    map[":crystal_ball:"] = "🔮"
+    map[":cupid:"] = "💘"
+    map[":curly_loop:"] = "➰"
+    map[":currency_exchange:"] = "💱"
+    map[":curry:"] = "🍛"
+    map[":custard:"] = "🍮"
+    map[":customs:"] = "🛃"
+    map[":cyclone:"] = "🌀"
+    map[":dancer:"] = "💃"
+    map[":dancers:"] = "👯"
+    map[":dango:"] = "🍡"
+    map[":dart:"] = "🎯"
+    map[":dash:"] = "💨"
+    map[":date:"] = "📅"
+    map[":de:"] = "🇩🇪"
+    map[":deciduous_tree:"] = "🌳"
+    map[":department_store:"] = "🏬"
+    map[":diamond_shape_with_a_dot_inside:"] = "💠"
+    map[":diamonds:"] = "♦️"
+    map[":disappointed:"] = "😞"
+    map[":disappointed_relieved:"] = "😥"
+    map[":dizzy:"] = "💫"
+    map[":dizzy_face:"] = "😵"
+    map[":do_not_litter:"] = "🚯"
+    map[":dog2:"] = "🐕"
+    map[":dog:"] = "🐶"
+    map[":dollar:"] = "💵"
+    map[":dolls:"] = "🎎"
+    map[":dolphin:"] = "🐬"
+    map[":door:"] = "🚪"
+    map[":doughnut:"] = "🍩"
+    map[":dragon:"] = "🐉"
+    map[":dragon_face:"] = "🐲"
+    map[":dress:"] = "👗"
+    map[":dromedary_camel:"] = "🐪"
+    map[":droplet:"] = "💧"
+    map[":dvd:"] = "📀"
+    map[":ear:"] = "👂"
+    map[":ear_of_rice:"] = "🌾"
+    map[":earth_africa:"] = "🌍"
+    map[":earth_americas:"] = "🌎"
+    map[":earth_asia:"] = "🌏"
+    map[":egg:"] = "🥚"
+    map[":eggplant:"] = "🍆"
+    map[":eight:"] = "8️⃣"
+    map[":eight_pointed_black_star:"] = "✴️"
+    map[":eight_spoked_asterisk:"] = "✳️"
+    map[":electric_plug:"] = "🔌"
+    map[":elephant:"] = "🐘"
+    map[":email:"] = "📧"
+    map[":end:"] = "🔚"
+    map[":envelope:"] = "✉️"
+    map[":es:"] = "🇪🇸"
+    map[":euro:"] = "💶"
+    map[":european_castle:"] = "🏰"
+    map[":european_post_office:"] = "🏤"
+    map[":evergreen_tree:"] = "🌲"
+    map[":exclamation:"] = "❗"
+    map[":expressionless:"] = "😑"
+    map[":eyeglasses:"] = "👓"
+    map[":eyes:"] = "👀"
+    map[":factory:"] = "🏭"
+    map[":fallen_leaf:"] = "🍂"
+    map[":family:"] = "👪"
+    map[":fast_forward:"] = "⏩"
+    map[":fax:"] = "📠"
+    map[":fearful:"] = "😨"
+    map[":feet:"] = "🐾"
+    map[":ferris_wheel:"] = "🎡"
+    map[":file_folder:"] = "📁"
+    map[":fire:"] = "🔥"
+    map[":fire_engine:"] = "🚒"
+    map[":fireworks:"] = "🎆"
+    map[":first_quarter_moon:"] = "🌓"
+    map[":first_quarter_moon_with_face:"] = "🌛"
+    map[":fish:"] = "🐟"
+    map[":fish_cake:"] = "🍥"
+    map[":fishing_pole_and_fish:"] = "🎣"
+    map[":fist:"] = "✊"
+    map[":five:"] = "5️⃣"
+    map[":flags:"] = "🎏"
+    map[":flashlight:"] = "🔦"
+    map[":floppy_disk:"] = "💾"
+    map[":flower_playing_cards:"] = "🎴"
+    map[":flushed:"] = "😳"
+    map[":foggy:"] = "🌁"
+    map[":football:"] = "🏈"
+    map[":fork_and_knife:"] = "🍴"
+    map[":fountain:"] = "⛲"
+    map[":four:"] = "4️⃣"
+    map[":four_leaf_clover:"] = "🍀"
+    map[":fr:"] = "🇫🇷"
+    map[":free:"] = "🆓"
+    map[":fried_shrimp:"] = "🍤"
+    map[":fries:"] = "🍟"
+    map[":frog:"] = "🐸"
+    map[":frowning:"] = "😦"
+    map[":fuelpump:"] = "⛽"
+    map[":full_moon:"] = "🌕"
+    map[":full_moon_with_face:"] = "🌝"
+    map[":game_die:"] = "🎲"
+    map[":gem:"] = "💎"
+    map[":gemini:"] = "♊"
+    map[":ghost:"] = "👻"
+    map[":gift:"] = "🎁"
+    map[":gift_heart:"] = "💝"
+    map[":girl:"] = "👧"
+    map[":globe_with_meridians:"] = "🌐"
+    map[":goat:"] = "🐐"
+    map[":golf:"] = "⛳"
+    map[":grapes:"] = "🍇"
+    map[":green_apple:"] = "🍏"
+    map[":green_book:"] = "📗"
+    map[":green_heart:"] = "💚"
+    map[":grey_exclamation:"] = "❕"
+    map[":grey_question:"] = "❔"
+    map[":grimacing:"] = "😬"
+    map[":grin:"] = "😁"
+    map[":grinning:"] = "😀"
+    map[":guardsman:"] = "💂‍♂️"
+    map[":guitar:"] = "🎸"
+    map[":gun:"] = "🔫"
+    map[":haircut:"] = "💇"
+    map[":hamburger:"] = "🍔"
+    map[":hammer:"] = "🔨"
+    map[":hamster:"] = "🐹"
+    map[":handbag:"] = "👜"
+    map[":hankey:"] = "💩"
+    map[":hash:"] = "#️⃣"
+    map[":hatched_chick:"] = "🐥"
+    map[":hatching_chick:"] = "🐣"
+    map[":headphones:"] = "🎧"
+    map[":hear_no_evil:"] = "🙉"
+    map[":heart:"] = "❤️"
+    map[":heart_decoration:"] = "💟"
+    map[":heart_eyes:"] = "😍"
+    map[":heart_eyes_cat:"] = "😻"
+    map[":heartbeat:"] = "💓"
+    map[":hearts:"] = "♥️"
+    map[":heavy_check_mark:"] = "✔️"
+    map[":heavy_division_sign:"] = "➗"
+    map[":heavy_dollar_sign:"] = "💲"
+    map[":heavy_minus_sign:"] = "➖"
+    map[":heavy_multiplication_x:"] = "✖️"
+    map[":heavy_plus_sign:"] = "➕"
+    map[":helicopter:"] = "🚁"
+    map[":herb:"] = "🌿"
+    map[":hibiscus:"] = "🌺"
+    map[":high_brightness:"] = "🔆"
+    map[":high_heel:"] = "👠"
+    map[":honey_pot:"] = "🍯"
+    map[":horse:"] = "🐴"
+    map[":horse_racing:"] = "🏇"
+    map[":hospital:"] = "🏥"
+    map[":hotel:"] = "🏨"
+    map[":hotsprings:"] = "♨️"
+    map[":hourglass:"] = "⌛"
+    map[":hourglass_flowing_sand:"] = "⏳"
+    map[":house:"] = "🏠"
+    map[":house_with_garden:"] = "🏡"
+    map[":hushed:"] = "😯"
+    map[":ice_cream:"] = "🍨"
+    map[":icecream:"] = "🍦"
+    map[":id:"] = "🆔"
+    map[":ideograph_advantage:"] = "🉐"
+    map[":imp:"] = "👿"
+    map[":inbox_tray:"] = "📥"
+    map[":incoming_envelope:"] = "📨"
+    map[":information_desk_person:"] = "💁"
+    map[":information_source:"] = "ℹ️"
+    map[":innocent:"] = "😇"
+    map[":interrobang:"] = "⁉️"
+    map[":iphone:"] = "📱"
+    map[":it:"] = "🇮🇹"
+    map[":izakaya_lantern:"] = "🏮"
+    map[":jack_o_lantern:"] = "🎃"
+    map[":japan:"] = "🗾"
+    map[":japanese_castle:"] = "🏯"
+    map[":japanese_goblin:"] = "👺"
+    map[":japanese_ogre:"] = "👹"
+    map[":jeans:"] = "👖"
+    map[":joy:"] = "😂"
+    map[":joy_cat:"] = "😹"
+    map[":jp:"] = "🇯🇵"
+    map[":key:"] = "🔑"
+    map[":keycap_ten:"] = "🔟"
+    map[":kimono:"] = "👘"
+    map[":kiss:"] = "💋"
+    map[":kissing:"] = "😗"
+    map[":kissing_cat:"] = "😽"
+    map[":kissing_closed_eyes:"] = "😚"
+    map[":kissing_heart:"] = "😘"
+    map[":kissing_smiling_eyes:"] = "😙"
+    map[":koala:"] = "🐨"
+    map[":koko:"] = "🈁"
+    map[":kr:"] = "🇰🇷"
+    map[":large_blue_diamond:"] = "🔷"
+    map[":large_orange_diamond:"] = "🔶"
+    map[":last_quarter_moon:"] = "🌗"
+    map[":last_quarter_moon_with_face:"] = "🌜"
+    map[":laughing:"] = "😆"
+    map[":leaves:"] = "🍃"
+    map[":ledger:"] = "📒"
+    map[":left_luggage:"] = "🛅"
+    map[":left_right_arrow:"] = "↔️"
+    map[":leftwards_arrow_with_hook:"] = "↩️"
+    map[":lemon:"] = "🍋"
+    map[":leo:"] = "♌"
+    map[":leopard:"] = "🐆"
+    map[":libra:"] = "♎"
+    map[":light_rail:"] = "🚈"
+    map[":link:"] = "🔗"
+    map[":lips:"] = "👄"
+    map[":lipstick:"] = "💄"
+    map[":lock:"] = "🔒"
+    map[":lock_with_ink_pen:"] = "🔏"
+    map[":lollipop:"] = "🍭"
+    map[":loop:"] = "➿"
+    map[":loudspeaker:"] = "📢"
+    map[":love_hotel:"] = "🏩"
+    map[":love_letter:"] = "💌"
+    map[":low_brightness:"] = "🔅"
+    map[":m:"] = "Ⓜ️"
+    map[":mag:"] = "🔍"
+    map[":mag_right:"] = "🔎"
+    map[":mahjong:"] = "🀄"
+    map[":mailbox:"] = "📫"
+    map[":mailbox_closed:"] = "📪"
+    map[":mailbox_with_mail:"] = "📬"
+    map[":mailbox_with_no_mail:"] = "📭"
+    map[":man:"] = "👨"
+    map[":man_with_gua_pi_mao:"] = "👲"
+    map[":man_with_turban:"] = "👳‍♂️"
+    map[":mans_shoe:"] = "👞"
+    map[":maple_leaf:"] = "🍁"
+    map[":mask:"] = "😷"
+    map[":massage:"] = "💆"
+    map[":meat_on_bone:"] = "🍖"
+    map[":mega:"] = "📣"
+    map[":melon:"] = "🍈"
+    map[":memo:"] = "📝"
+    map[":mens:"] = "🚹"
+    map[":metal:"] = "🤘"
+    map[":metro:"] = "🚇"
+    map[":microphone:"] = "🎤"
+    map[":microscope:"] = "🔬"
+    map[":milky_way:"] = "🌌"
+    map[":minibus:"] = "🚐"
+    map[":minidisc:"] = "💽"
+    map[":mobile_phone_off:"] = "📴"
+    map[":money_with_wings:"] = "💸"
+    map[":moneybag:"] = "💰"
+    map[":monkey:"] = "🐒"
+    map[":monkey_face:"] = "🐵"
+    map[":monorail:"] = "🚝"
+    map[":mortar_board:"] = "🎓"
+    map[":mount_fuji:"] = "🗻"
+    map[":mountain_bicyclist:"] = "🚵"
+    map[":mountain_cableway:"] = "🚠"
+    map[":mountain_railway:"] = "🚞"
+    map[":mouse2:"] = "🐁"
+    map[":mouse:"] = "🐭"
+    map[":movie_camera:"] = "🎥"
+    map[":moyai:"] = "🗿"
+    map[":muscle:"] = "💪"
+    map[":mushroom:"] = "🍄"
+    map[":musical_keyboard:"] = "🎹"
+    map[":musical_note:"] = "🎵"
+    map[":musical_score:"] = "🎼"
+    map[":mute:"] = "🔇"
+    map[":nail_care:"] = "💅"
+    map[":name_badge:"] = "📛"
+    map[":necktie:"] = "👔"
+    map[":negative_squared_cross_mark:"] = "❎"
+    map[":neutral_face:"] = "😐"
+    map[":new:"] = "🆕"
+    map[":new_moon:"] = "🌑"
+    map[":new_moon_with_face:"] = "🌚"
+    map[":newspaper:"] = "📰"
+    map[":ng:"] = "🆖"
+    map[":nine:"] = "9️⃣"
+    map[":no_bell:"] = "🔕"
+    map[":no_bicycles:"] = "🚳"
+    map[":no_entry:"] = "⛔"
+    map[":no_entry_sign:"] = "🚫"
+    map[":no_good:"] = "🙅"
+    map[":no_mobile_phones:"] = "📵"
+    map[":no_mouth:"] = "😶"
+    map[":no_pedestrians:"] = "🚷"
+    map[":no_smoking:"] = "🚭"
+    map[":nose:"] = "👃"
+    map[":notebook:"] = "📓"
+    map[":notebook_with_decorative_cover:"] = "📔"
+    map[":notes:"] = "🎶"
+    map[":nut_and_bolt:"] = "🔩"
+    map[":o2:"] = "🅾️"
+    map[":o:"] = "⭕"
+    map[":ocean:"] = "🌊"
+    map[":octopus:"] = "🐙"
+    map[":oden:"] = "🍢"
+    map[":office:"] = "🏢"
+    map[":ok:"] = "🆗"
+    map[":ok_hand:"] = "👌"
+    map[":ok_woman:"] = "🙆‍♀️"
+    map[":older_man:"] = "👴"
+    map[":older_woman:"] = "👵"
+    map[":on:"] = "🔛"
+    map[":oncoming_automobile:"] = "🚘"
+    map[":oncoming_bus:"] = "🚍"
+    map[":oncoming_police_car:"] = "🚔"
+    map[":oncoming_taxi:"] = "🚖"
+    map[":one:"] = "1️⃣"
+    map[":open_file_folder:"] = "📂"
+    map[":open_hands:"] = "👐"
+    map[":open_mouth:"] = "😮"
+    map[":ophiuchus:"] = "⛎"
+    map[":orange_book:"] = "📙"
+    map[":outbox_tray:"] = "📤"
+    map[":ox:"] = "🐂"
+    map[":page_facing_up:"] = "📄"
+    map[":page_with_curl:"] = "📃"
+    map[":pager:"] = "📟"
+    map[":palm_tree:"] = "🌴"
+    map[":panda_face:"] = "🐼"
+    map[":paperclip:"] = "📎"
+    map[":parking:"] = "🅿️"
+    map[":part_alternation_mark:"] = "〽️"
+    map[":partly_sunny:"] = "⛅"
+    map[":passport_control:"] = "🛂"
+    map[":paw_prints:"] = "🐾"
+    map[":peach:"] = "🍑"
+    map[":pear:"] = "🍐"
+    map[":pencil2:"] = "✏️"
+    map[":pencil:"] = "📝"
+    map[":penguin:"] = "🐧"
+    map[":pensive:"] = "😔"
+    map[":performing_arts:"] = "🎭"
+    map[":persevere:"] = "😣"
+    map[":pig2:"] = "🐖"
+    map[":pig:"] = "🐷"
+    map[":pig_nose:"] = "🐽"
+    map[":pill:"] = "💊"
+    map[":pineapple:"] = "🍍"
+    map[":pisces:"] = "♓"
+    map[":pizza:"] = "🍕"
+    map[":point_down:"] = "👇"
+    map[":point_left:"] = "👈"
+    map[":point_right:"] = "👉"
+    map[":point_up:"] = "☝️"
+    map[":point_up_2:"] = "👆"
+    map[":police_car:"] = "🚓"
+    map[":poodle:"] = "🐩"
+    map[":poop:"] = "💩"
+    map[":post_office:"] = "🏣"
+    map[":postal_horn:"] = "📯"
+    map[":postbox:"] = "📮"
+    map[":potable_water:"] = "🚰"
+    map[":pouch:"] = "👝"
+    map[":poultry_leg:"] = "🍗"
+    map[":pound:"] = "💷"
+    map[":pouting_cat:"] = "😾"
+    map[":pray:"] = "🙏"
+    map[":princess:"] = "👸"
+    map[":punch:"] = "👊"
+    map[":purple_heart:"] = "💜"
+    map[":purse:"] = "👛"
+    map[":pushpin:"] = "📌"
+    map[":put_litter_in_its_place:"] = "🚮"
+    map[":question:"] = "❓"
+    map[":rabbit2:"] = "🐇"
+    map[":rabbit:"] = "🐰"
+    map[":racehorse:"] = "🐎"
+    map[":radio:"] = "📻"
+    map[":radio_button:"] = "🔘"
+    map[":rage:"] = "😡"
+    map[":railway_car:"] = "🚃"
+    map[":rainbow:"] = "🌈"
+    map[":raised_hand:"] = "✋"
+    map[":raised_hands:"] = "🙌"
+    map[":raising_hand:"] = "🙋"
+    map[":ram:"] = "🐏"
+    map[":ramen:"] = "🍜"
+    map[":rat:"] = "🐀"
+    map[":recycle:"] = "♻️"
+    map[":red_car:"] = "🚗"
+    map[":red_circle:"] = "🔴"
+    map[":registered:"] = "®️"
+    map[":relaxed:"] = "☺️"
+    map[":relieved:"] = "😌"
+    map[":repeat:"] = "🔁"
+    map[":repeat_one:"] = "🔂"
+    map[":restroom:"] = "🚻"
+    map[":revolving_hearts:"] = "💞"
+    map[":rewind:"] = "⏪"
+    map[":ribbon:"] = "🎀"
+    map[":rice:"] = "🍚"
+    map[":rice_ball:"] = "🍙"
+    map[":rice_cracker:"] = "🍘"
+    map[":rice_scene:"] = "🎑"
+    map[":ring:"] = "💍"
+    map[":rocket:"] = "🚀"
+    map[":roller_coaster:"] = "🎢"
+    map[":rooster:"] = "🐓"
+    map[":rose:"] = "🌹"
+    map[":rotating_light:"] = "🚨"
+    map[":round_pushpin:"] = "📍"
+    map[":rowboat:"] = "🚣"
+    map[":ru:"] = "🇷🇺"
+    map[":rugby_football:"] = "🏉"
+    map[":runner:"] = "🏃"
+    map[":running_shirt_with_sash:"] = "🎽"
+    map[":sa:"] = "🈂️"
+    map[":sagittarius:"] = "♐"
+    map[":sailboat:"] = "⛵"
+    map[":sake:"] = "🍶"
+    map[":sandal:"] = "👡"
+    map[":santa:"] = "🎅"
+    map[":satellite:"] = "📡"
+    map[":satisfied:"] = "😆"
+    map[":saxophone:"] = "🎷"
+    map[":school:"] = "🏫"
+    map[":school_satchel:"] = "🎒"
+    map[":scissors:"] = "✂️"
+    map[":scorpius:"] = "♏"
+    map[":scream:"] = "😱"
+    map[":scream_cat:"] = "🙀"
+    map[":scroll:"] = "📜"
+    map[":seat:"] = "💺"
+    map[":secret:"] = "㊙️"
+    map[":see_no_evil:"] = "🙈"
+    map[":seedling:"] = "🌱"
+    map[":seven:"] = "7️⃣"
+    map[":shaved_ice:"] = "🍧"
+    map[":sheep:"] = "🐑"
+    map[":shell:"] = "🐚"
+    map[":ship:"] = "🚢"
+    map[":shirt:"] = "👕"
+    map[":shit:"] = "💩"
+    map[":shower:"] = "🚿"
+    map[":signal_strength:"] = "📶"
+    map[":six:"] = "6️⃣"
+    map[":six_pointed_star:"] = "🔯"
+    map[":ski:"] = "🎿"
+    map[":skull:"] = "💀"
+    map[":sleeping:"] = "😴"
+    map[":sleepy:"] = "😪"
+    map[":slot_machine:"] = "🎰"
+    map[":small_blue_diamond:"] = "🔹"
+    map[":small_orange_diamond:"] = "🔸"
+    map[":small_red_triangle:"] = "🔺"
+    map[":small_red_triangle_down:"] = "🔻"
+    map[":smile:"] = "😄"
+    map[":smile_cat:"] = "😸"
+    map[":smiley:"] = "😃"
+    map[":smiley_cat:"] = "😺"
+    map[":smiling_imp:"] = "😈"
+    map[":smirk:"] = "😏"
+    map[":smirk_cat:"] = "😼"
+    map[":smoking:"] = "🚬"
+    map[":snail:"] = "🐌"
+    map[":snake:"] = "🐍"
+    map[":snowboarder:"] = "🏂"
+    map[":snowflake:"] = "❄️"
+    map[":snowman:"] = "⛄"
+    map[":sob:"] = "😭"
+    map[":soccer:"] = "⚽"
+    map[":soon:"] = "🔜"
+    map[":sos:"] = "🆘"
+    map[":sound:"] = "🔉"
+    map[":space_invader:"] = "👾"
+    map[":spades:"] = "♠️"
+    map[":spaghetti:"] = "🍝"
+    map[":sparkler:"] = "🎇"
+    map[":sparkles:"] = "✨"
+    map[":sparkling_heart:"] = "💖"
+    map[":speak_no_evil:"] = "🙊"
+    map[":speaker:"] = "🔈"
+    map[":speech_balloon:"] = "💬"
+    map[":speedboat:"] = "🚤"
+    map[":star2:"] = "🌟"
+    map[":star:"] = "⭐"
+    map[":stars:"] = "🌠"
+    map[":station:"] = "🚉"
+    map[":statue_of_liberty:"] = "🗽"
+    map[":steam_locomotive:"] = "🚂"
+    map[":stew:"] = "🍲"
+    map[":straight_ruler:"] = "📏"
+    map[":strawberry:"] = "🍓"
+    map[":stuck_out_tongue:"] = "😛"
+    map[":stuck_out_tongue_closed_eyes:"] = "😝"
+    map[":stuck_out_tongue_winking_eye:"] = "😜"
+    map[":sun_with_face:"] = "🌞"
+    map[":sunflower:"] = "🌻"
+    map[":sunglasses:"] = "😎"
+    map[":sunny:"] = "☀️"
+    map[":sunrise:"] = "🌅"
+    map[":sunrise_over_mountains:"] = "🌄"
+    map[":surfer:"] = "🏄"
+    map[":sushi:"] = "🍣"
+    map[":suspension_railway:"] = "🚟"
+    map[":sweat:"] = "😓"
+    map[":sweat_drops:"] = "💦"
+    map[":sweat_smile:"] = "😅"
+    map[":sweet_potato:"] = "🍠"
+    map[":swimmer:"] = "🏊"
+    map[":symbols:"] = "🔣"
+    map[":syringe:"] = "💉"
+    map[":tada:"] = "🎉"
+    map[":tanabata_tree:"] = "🎋"
+    map[":tangerine:"] = "🍊"
+    map[":taurus:"] = "♉"
+    map[":taxi:"] = "🚕"
+    map[":tea:"] = "🍵"
+    map[":telephone:"] = "☎️"
+    map[":telephone_receiver:"] = "📞"
+    map[":telescope:"] = "🔭"
+    map[":tennis:"] = "🎾"
+    map[":tent:"] = "⛺"
+    map[":thought_balloon:"] = "💭"
+    map[":three:"] = "3️⃣"
+    map[":thumbsdown:"] = "👎"
+    map[":thumbsup:"] = "👍"
+    map[":ticket:"] = "🎫"
+    map[":tiger2:"] = "🐅"
+    map[":tiger:"] = "🐯"
+    map[":tired_face:"] = "😫"
+    map[":tm:"] = "™️"
+    map[":toilet:"] = "🚽"
+    map[":tokyo_tower:"] = "🗼"
+    map[":tomato:"] = "🍅"
+    map[":tongue:"] = "👅"
+    map[":top:"] = "🔝"
+    map[":tophat:"] = "🎩"
+    map[":tractor:"] = "🚜"
+    map[":traffic_light:"] = "🚥"
+    map[":train2:"] = "🚆"
+    map[":train:"] = "🚋"
+    map[":tram:"] = "🚊"
+    map[":triangular_flag_on_post:"] = "🚩"
+    map[":triangular_ruler:"] = "📐"
+    map[":trident:"] = "🔱"
+    map[":triumph:"] = "😤"
+    map[":trolleybus:"] = "🚎"
+    map[":trophy:"] = "🏆"
+    map[":tropical_drink:"] = "🍹"
+    map[":tropical_fish:"] = "🐠"
+    map[":truck:"] = "🚚"
+    map[":trumpet:"] = "🎺"
+    map[":tulip:"] = "🌷"
+    map[":turtle:"] = "🐢"
+    map[":tv:"] = "📺"
+    map[":twisted_rightwards_arrows:"] = "🔀"
+    map[":two:"] = "2️⃣"
+    map[":two_men_holding_hands:"] = "👬"
+    map[":two_women_holding_hands:"] = "👭"
+    map[":u5272:"] = "🈹"
+    map[":u5408:"] = "🈴"
+    map[":u55b6:"] = "🈺"
+    map[":u6307:"] = "🈯"
+    map[":u6708:"] = "🈷️"
+    map[":u6709:"] = "🈶"
+    map[":u6e80:"] = "🈵"
+    map[":u7121:"] = "🈚"
+    map[":u7533:"] = "🈸"
+    map[":u7981:"] = "🈲"
+    map[":u7a7a:"] = "🈳"
+    map[":umbrella:"] = "☔"
+    map[":unamused:"] = "😒"
+    map[":underage:"] = "🔞"
+    map[":unlock:"] = "🔓"
+    map[":up:"] = "🆙"
+    map[":us:"] = "🇺🇸"
+    map[":v:"] = "✌️"
+    map[":vertical_traffic_light:"] = "🚦"
+    map[":vhs:"] = "📼"
+    map[":vibration_mode:"] = "📳"
+    map[":video_camera:"] = "📹"
+    map[":video_game:"] = "🎮"
+    map[":violin:"] = "🎻"
+    map[":virgo:"] = "♍"
+    map[":volcano:"] = "🌋"
+    map[":vs:"] = "🆚"
+    map[":walking:"] = "🚶"
+    map[":waning_crescent_moon:"] = "🌘"
+    map[":waning_gibbous_moon:"] = "🌖"
+    map[":warning:"] = "⚠️"
+    map[":watch:"] = "⌚"
+    map[":water_buffalo:"] = "🐃"
+    map[":watermelon:"] = "🍉"
+    map[":wave:"] = "👋"
+    map[":wavy_dash:"] = "〰️"
+    map[":waxing_crescent_moon:"] = "🌒"
+    map[":waxing_gibbous_moon:"] = "🌔"
+    map[":wc:"] = "🚾"
+    map[":weary:"] = "😩"
+    map[":wedding:"] = "💒"
+    map[":whale2:"] = "🐋"
+    map[":whale:"] = "🐳"
+    map[":wheelchair:"] = "♿"
+    map[":white_check_mark:"] = "✅"
+    map[":white_circle:"] = "⚪"
+    map[":white_flower:"] = "💮"
+    map[":white_square_button:"] = "🔳"
+    map[":wind_chime:"] = "🎐"
+    map[":wine_glass:"] = "🍷"
+    map[":wink:"] = "😉"
+    map[":wolf:"] = "🐺"
+    map[":woman:"] = "👩"
+    map[":womans_clothes:"] = "👚"
+    map[":womans_hat:"] = "👒"
+    map[":womens:"] = "🚺"
+    map[":worried:"] = "😟"
+    map[":wrench:"] = "🔧"
+    map[":x:"] = "❌"
+    map[":yellow_heart:"] = "💛"
+    map[":yen:"] = "💴"
+    map[":yum:"] = "😋"
+    map[":zap:"] = "⚡"
+    map[":zero:"] = "0️⃣"
+    map[":zzz:"] = "💤"
+}
+{
+    if ($0 ~ /<pre>/) in_pre = 1
+    if (!in_pre) {
+        code_count = 0
+        line = $0
+        out = ""
+        while (match(line, /<code>[^<]*<\/code>/)) {
+            code_count++
+            code_store[code_count] = substr(line, RSTART, RLENGTH)
+            out = out substr(line, 1, RSTART - 1) "\034EC" code_count "\034"
+            line = substr(line, RSTART + RLENGTH)
+        }
+        out = out line
+
+        for (sc in map) {
+            if (index(out, sc)) {
+                gsub(sc, map[sc], out)
+            }
+        }
+
+        for (i = 1; i <= code_count; i++) {
+            gsub("\034EC" i "\034", code_store[i], out)
+        }
+        $0 = out
+    }
+    if ($0 ~ /<\/pre>/) in_pre = 0
+    print
+}
--- a/awk/footnotes.awk
+++ b/awk/footnotes.awk
@@ -0,0 +1,51 @@
+BEGIN { fn_count = 0 }
+
+# Match [^id]: text
+/^\[\^[a-zA-Z0-9_-]+\]:/ {
+    id_start = index($0, "[^") + 2
+    id_end = index($0, "]:")
+    id = substr($0, id_start, id_end - id_start)
+    text = substr($0, id_end + 2)
+    # Trim leading space
+    sub(/^[ \t]+/, "", text)
+    
+    fn_ids[++fn_count] = id
+    fn_texts[id] = text
+    next
+}
+
+{
+    lines[++line_count] = $0
+}
+
+END {
+    for (i = 1; i <= line_count; i++) {
+        line = lines[i]
+        
+        for (j = 1; j <= fn_count; j++) {
+            id = fn_ids[j]
+            marker = "[^" id "]"
+            repl = "<sup><a href=\"#fn:" id "\" id=\"fnref:" id "\">" id "</a></sup>"
+            
+            while ((pos = index(line, marker)) > 0) {
+                line = substr(line, 1, pos - 1) repl substr(line, pos + length(marker))
+            }
+        }
+        print line
+    }
+    
+    if (fn_count > 0) {
+        print "<hr />"
+        print "<section class=\"footnotes\">"
+        print "<ol>"
+        for (j = 1; j <= fn_count; j++) {
+            id = fn_ids[j]
+            text = fn_texts[id]
+            print "<li id=\"fn:" id "\">"
+            print "<p>" text " <a href=\"#fnref:" id "\" class=\"reversefootnote\">&#8617;</a></p>"
+            print "</li>"
+        }
+        print "</ol>"
+        print "</section>"
+    }
+}
--- a/awk/generate_sidebar.awk
+++ b/awk/generate_sidebar.awk
@@ -4,6 +4,46 @@ function title_from_name(name) {
    return name
 }

+function get_title(path, default_title,   full_path, line, title, in_fm) {
+    full_path = src "/" path
+    if (path !~ /\.md$/) {
+        full_path = full_path "/index.md"
+    }
+
+    title = ""
+    in_fm = 0
+    while ((getline line < full_path) > 0) {
+        if (line ~ /^---[[:space:]]*$/) {
+            if (in_fm == 0) {
+                in_fm = 1
+                continue
+            } else {
+                break
+            }
+        }
+        if (in_fm) {
+            if (line ~ /^[[:space:]]*title[[:space:]]*=/) {
+                sub(/^[[:space:]]*title[[:space:]]*=[[:space:]]*/, "", line)
+                if (line ~ /^".*"$/) {
+                    title = substr(line, 2, length(line) - 2)
+                } else if (line ~ /^'.*'$/) {
+                    title = substr(line, 2, length(line) - 2)
+                } else {
+                    title = line
+                }
+                break
+            }
+        } else {
+            break
+        }
+    }
+    close(full_path)
+
+    if (title != "") return title
+    return default_title
+}
+
+
 function compare_paths(p1, p2,    parts1, parts2, n1, n2, i, name1, name2, lname1, lname2, w1, w2) {
    n1 = split(p1, parts1, "/")
    n2 = split(p2, parts2, "/")
@@ -132,7 +172,7 @@ END {
                continue
            }

-            printf "<li><a href=\"/%sindex.html\">%s</a><ul>\n", dir_path, title_from_name(parts[i])
+            printf "<li><a href=\"/%sindex.html\">%s</a><ul>\n", dir_path, get_title(this_d, title_from_name(parts[i]))
            opened_levels[++depth] = i
        }

@@ -145,7 +185,7 @@ END {
        if (parts[n] != "index.md" && !is_single) {
            path = "/" rel
            gsub(/\.md$/, ".html", path)
-            printf "<li><a href=\"%s\">%s</a></li>\n", path, title_from_name(parts[n])
+            printf "<li><a href=\"%s\">%s</a></li>\n", path, get_title(rel, title_from_name(parts[n]))
        }

        prev_n = n
--- a/awk/headers.awk
+++ b/awk/headers.awk
@@ -38,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
--- a/awk/markdown_embed.awk
+++ b/awk/markdown_embed.awk
@@ -97,6 +97,23 @@ function read_file(path,    out, line, rc) {
    return out
 }

+function read_file_or_render_md(path, ext,    cmd, content, line, rc) {
+    content = ""
+    if (ext == "md") {
+        cmd = "sh \"" script_dir "/markdown.sh\" \"" path "\""
+        while ((cmd | getline line) > 0) {
+            content = content line "\n"
+        }
+        close(cmd)
+    } else {
+        while ((rc = getline line < path) > 0) {
+            content = content line "\n"
+        }
+        close(path)
+    }
+    return content
+}
+
 function escape_html(s,    t) {
    t = s
    gsub(/&/, "\\&amp;", t)
@@ -189,7 +206,8 @@ function render_embed(src, alt, has_alt, force_inline,    ext, local_path, conte
    if (force_inline && !is_global_url(src)) {
        local_path = resolve_local_path(src)
        if (local_path != "") {
-            content = read_file(local_path)
+            ext = ext_of(src)
+            content = read_file_or_render_md(local_path, ext)
            if (content ~ /\n$/) sub(/\n$/, "", content)
            return content
        }
@@ -217,7 +235,7 @@ function render_embed(src, alt, has_alt, force_inline,    ext, local_path, conte
    if (is_inline_text_ext(ext)) {
        local_path = resolve_local_path(src)
        if (local_path != "") {
-            content = read_file(local_path)
+            content = read_file_or_render_md(local_path, ext)
            if (content ~ /\n$/) sub(/\n$/, "", content)
            return content
        }
@@ -238,7 +256,7 @@ function render_typed_embed(etype, src, alt, has_alt,    local_path, content) {
        if (!is_global_url(src)) {
            local_path = resolve_local_path(src)
            if (local_path != "") {
-                content = read_file(local_path)
+                content = read_file_or_render_md(local_path, ext_of(src))
                if (content ~ /\n$/) sub(/\n$/, "", content)
                return content
            }
--- a/awk/markdown_inline.awk
+++ b/awk/markdown_inline.awk
@@ -230,5 +230,7 @@ function restore_html_tags(s,    i, val) {
        }
    }

+    gsub(/<a href="https?:\/\/[^"]*"/, "& rel=\"noopener noreferrer\"", line)
+
    print line
 }
--- a/awk/mask_plain.awk
+++ b/awk/mask_plain.awk
@@ -22,7 +22,7 @@ function mask_plain(s,    t) {
    gsub(/\$/, "\034P8\034", t)
    return t
 }
-BEGIN { in_plain = 0 }
+BEGIN { in_plain = 0; in_script_style = 0 }
 {
    line = $0
    out = ""
@@ -48,5 +48,41 @@ BEGIN { in_plain = 0 }
            in_plain = 0
        }
    }
-    print out
+    tmp_line = out
+    out2 = ""
+    while (1) {
+        if (!in_script_style) {
+            pos_script = match(tolower(tmp_line), /<script([ >]|$)/)
+            script_start = RSTART; script_len = RLENGTH
+            pos_style = match(tolower(tmp_line), /<style([ >]|$)/)
+            style_start = RSTART; style_len = RLENGTH
+            
+            if (pos_script == 0 && pos_style == 0) {
+                out2 = out2 tmp_line
+                break
+            }
+            if (pos_script > 0 && (pos_style == 0 || pos_script < pos_style)) {
+                out2 = out2 substr(tmp_line, 1, script_start + script_len - 1)
+                tmp_line = substr(tmp_line, script_start + script_len)
+                in_script_style = 1
+                end_tag = "</script>"
+            } else {
+                out2 = out2 substr(tmp_line, 1, style_start + style_len - 1)
+                tmp_line = substr(tmp_line, style_start + style_len)
+                in_script_style = 1
+                end_tag = "</style>"
+            }
+        } else {
+            pos_end = match(tolower(tmp_line), end_tag)
+            if (pos_end == 0) {
+                out2 = out2 mask_plain(tmp_line)
+                tmp_line = ""
+                break
+            }
+            out2 = out2 mask_plain(substr(tmp_line, 1, RSTART - 1)) substr(tmp_line, RSTART, RLENGTH)
+            tmp_line = substr(tmp_line, RSTART + RLENGTH)
+            in_script_style = 0
+        }
+    }
+    print out2
 }
--- a/awk/paragraphs.awk
+++ b/awk/paragraphs.awk
@@ -4,7 +4,7 @@ BEGIN {
 }

 {
-    if ($0 ~ /^<pre>/) in_pre = 1
+    if ($0 ~ /<pre>/) in_pre = 1
    
    if (in_pre) {
        if (in_p) { print "</p>"; in_p = 0 }
@@ -13,7 +13,16 @@ BEGIN {
        next
    }

-    if ($0 ~ /^<\/?(div|table|p|[ou]l|h[1-6]|[bh]r|blockquote|li|hr)/) {
+    if ($0 ~ /^<\/?(div|table|p|[ou]l|h[1-6]|[bh]r|blockquote|li|hr|section|article|nav|aside|header|footer|dl|dt|dd|script|style|iframe|details|summary|figure|figcaption|audio|video|picture)/) {
+        if (in_p) {
+            print "</p>"
+            in_p = 0
+        }
+        print
+        next
+    }
+
+    if ($0 ~ /^[\t ]*!([a-zA-Z])?\[[^\]]*\](\([^)]*\))?[\t ]*$/ || $0 ~ /^[\t ]*!!?\[[^\]]*\](\([^)]*\))?[\t ]*$/) {
        if (in_p) {
            print "</p>"
            in_p = 0
--- a/awk/render_template.awk
+++ b/awk/render_template.awk
@@ -16,6 +16,9 @@ BEGIN {
    style_path = ENVIRON["AWK_STYLE_PATH"]
    head_extra = ENVIRON["AWK_HEAD_EXTRA"]
    header_brand = ENVIRON["AWK_HEADER_BRAND"]
+    lang = ENVIRON["AWK_LANG"]
+    version = ENVIRON["AWK_VERSION"]
+    content_warning = ENVIRON["AWK_CONTENT_WARNING"]
    if (current_url != "") {
        nav = replace_all(nav, "href=\"" current_url "\"", "href=\"" current_url "\" class=\"current-page\"")
    }
@@ -24,11 +27,13 @@ BEGIN {
 {
    line = $0
    line = replace_all(line, "{{TITLE}}", title)
+    line = replace_all(line, "{{LANG}}", lang)
    line = replace_all(line, "{{NAV}}", nav)
    line = replace_all(line, "{{FOOTER}}", footer)
    line = replace_all(line, "{{CSS}}", style_path)
    line = replace_all(line, "{{HEAD_EXTRA}}", head_extra)
    line = replace_all(line, "{{HEADER_BRAND}}", header_brand)
+    line = replace_all(line, "{{VERSION}}", version)

    pos = index(line, "{{CONTENT}}")
    if (pos > 0) {
--- a/awk/toc.awk
+++ b/awk/toc.awk
@@ -0,0 +1,50 @@
+BEGIN {
+    toc_str = "<ol class=\"toc\">\n"
+    has_toc = 0
+}
+{
+    lines[++n] = $0
+    if ($0 ~ /<pre>/) in_pre = 1
+    if (!in_pre && $0 ~ /\{\{TOC\}\}/) {
+        has_toc = 1
+        toc_lines[n] = 1
+    }
+    if ($0 ~ /<\/pre>/) in_pre = 0
+    if (match($0, /<h[23][^>]*>/)) {
+        tag_len = RLENGTH
+        title_start = RSTART + tag_len
+        title_str = substr($0, title_start)
+        title_end = index(title_str, "</h")
+        if (title_end > 0) {
+            title = substr(title_str, 1, title_end - 1)
+            gsub(/<[^>]+>/, "", title)
+            
+            # extract id
+            id_start = match($0, /id="[^"]*"/)
+            if (id_start > 0) {
+                id_str = substr($0, id_start + 4)
+                id_end = index(id_str, "\"")
+                id = substr(id_str, 1, id_end - 1)
+                
+                # what tag? level
+                level = substr($0, match($0, /<h[23]/) + 2, 1)
+                
+                if (level == "2") {
+                    toc_str = toc_str "<li class=\"toc-h2\"><a href=\"#" id "\">" title "</a></li>\n"
+                } else if (level == "3") {
+                    toc_str = toc_str "<li class=\"toc-h3\"><a href=\"#" id "\">" title "</a></li>\n"
+                }
+            }
+        }
+    }
+}
+END {
+    toc_str = toc_str "</ol>"
+    for (i = 1; i <= n; i++) {
+        if (has_toc && toc_lines[i] && lines[i] ~ /^[[:space:]]*\{\{TOC\}\}[[:space:]]*$/) {
+            toc_lines[i] = 0 # Mark as processed if we want, but not strictly needed
+            sub(/\{\{TOC\}\}/, toc_str, lines[i])
+        }
+        print lines[i]
+    }
+}
--- a/kewt.sh
+++ b/kewt.sh
@@ -13,6 +13,7 @@ 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

@@ -21,9 +22,12 @@ Options:
  --new [title]              Create a new site directory (default: site)
  --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
+  --generate-template [path] Generate a new template file at <path> (default: template.html)
  --version                  Show version information.
  --from <src>               Source directory (default: site)
  --to <out>                 Output directory (default: out)
+  --watch, -w                Watch for file changes and rebuild automatically.
+  --serve, -s [port]         Start a local HTTP server after building (default port: 8000).
 EOF
 }

@@ -31,21 +35,13 @@ script_dir=$(CDPATH="" cd -- "$(dirname -- "$0")" && pwd)
 awk_dir="$script_dir/awk"

 KEWT_TMPDIR=$(mktemp -d "/tmp/kewt_run.XXXXXX")
-trap 'rm -rf "$KEWT_TMPDIR"' EXIT HUP INT TERM
+trap 'rm -rf "$KEWT_TMPDIR"' EXIT
+trap 'exit 0' HUP INT TERM

-
-
-create_new_site() {
-    new_title="$1"
-    new_dir="site"
-    [ -n "$new_title" ] && new_dir="$new_title"
-
-    [ -e "$new_dir" ] && die "Target '$new_dir' already exists."
-
-    mkdir -p "$new_dir"
-    cat > "$new_dir/site.conf" <<'EOF'
-title = "kewt"
+DEFAULT_CONF='title = "kewt"
 style = "kewt"
+lang = "en"
+draft_by_default = false
 dir_indexes = true
 single_file_index = true
 flatten = false
@@ -68,24 +64,26 @@ base_url = ""
 generate_feed = false
 feed_file = "rss.xml"
 posts_dir = ""
+posts_per_page = 12
 custom_admonitions = ""
-EOF
+cw_hide_url = true'

-    cat > "$new_dir/template.html" <<'EOF'
-<!doctype html>
-<html>
+DEFAULT_TMPL='<!doctype html>
+<html lang="{{LANG}}">
    <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" />
+        <link rel="stylesheet" href="{{CSS}}{{VERSION}}" type="text/css" />
        {{HEAD_EXTRA}}
    </head>

    <body>
+        <input type="checkbox" id="nav-toggle" class="nav-toggle" aria-hidden="true" />
        <header>
            <h1>{{HEADER_BRAND}}</h1>
+            <label for="nav-toggle" class="nav-toggle-label" aria-hidden="true">&#9776;</label>
        </header>

        <nav id="side-bar">{{NAV}}</nav>
@@ -93,8 +91,29 @@ EOF
        <article>{{CONTENT}}</article>
        <footer>{{FOOTER}}</footer>
    </body>
-</html>
-EOF
+</html>'
+
+
+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() {
+    new_title="$1"
+    new_dir="site"
+    [ -n "$new_title" ] && new_dir="$new_title"
+
+    [ -e "$new_dir" ] && die "Target '$new_dir' already exists."
+
+    mkdir -p "$new_dir"
+    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
@@ -129,9 +148,9 @@ create_new_post() {

    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"
+        printf -- '---\ntitle = "%s"\ndate = "%s"\ndraft = %s\n---\n# %s\n' "$post_user_title" "$post_date_val" "$draft_by_default" "$post_user_title" > "$file_path"
    else
-        printf -- '---\ndate = "%s"\ndraft = false\n---\n' "$post_date_val" > "$file_path"
+        printf -- '---\ndate = "%s"\ndraft = %s\n---\n' "$post_date_val" "$draft_by_default" > "$file_path"
    fi

    echo "Created new post at '$file_path'."
@@ -147,33 +166,7 @@ update_site() {

    # 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 = ""
-custom_admonitions = ""
-CONFEOF
+    printf '%s\n' "$DEFAULT_CONF" > "$default_conf"

    # Update site.conf
    if [ ! -f "$target_conf" ]; then
@@ -203,30 +196,7 @@ CONFEOF
    # 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" />
-        <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
+        printf '%s\n' "$DEFAULT_TMPL" > "$default_tmpl"
        if cmp -s "$default_tmpl" "$target_tmpl" 2>/dev/null; then
            echo "template.html is already up to date."
        else
@@ -240,8 +210,6 @@ TMPLEOF
    exit 0
 }

-
-
 src=""
 out=""
 new_mode="false"
@@ -249,6 +217,8 @@ new_title=""
 post_mode="false"
 post_title=""
 positional_count=0
+watch_mode="false"
+serve_mode="false"

 while [ $# -gt 0 ]; do
    case "$1" in
@@ -274,6 +244,14 @@ while [ $# -gt 0 ]; do
                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="."
            if [ $# -gt 1 ] && [ "${2#-}" = "$2" ]; then
@@ -292,6 +270,16 @@ while [ $# -gt 0 ]; do
            out="$2"
            shift
            ;;
+        --watch|-w)
+            watch_mode="true"
+            ;;
+        --serve|-s)
+            serve_mode="true"
+            if [ $# -ge 2 ] && echo "$2" | grep -qE '^[0-9]+$'; then
+                serve_port="$2"
+                shift
+            fi
+            ;;
        --*)
            die "Unknown option: $1"
            ;;
@@ -435,6 +423,8 @@ generate_nav() {

 title="kewt"
 style="kewt"
+lang="en"
+draft_by_default="false"
 footer="made with <a href=\"https://kewt.krzak.org\">kewt</a>"
 dir_indexes="true"
 single_file_index="true"
@@ -458,7 +448,9 @@ base_url=""
 generate_feed="false"
 feed_file="rss.xml"
 posts_dir=""
+posts_per_page="12"
 custom_admonitions=""
+cw_hide_url="true"

 load_config() {
    [ -f "$1" ] || return
@@ -510,7 +502,11 @@ load_config() {
            generate_feed) generate_feed="$val" ;;
            feed_file) feed_file="${val#/}" ;;
            posts_dir) posts_dir="${val#/}" ;;
+            posts_per_page) posts_per_page="$val" ;;
            custom_admonitions) custom_admonitions="$val" ;;
+            cw_hide_url) cw_hide_url="$val" ;;
+            lang) lang="$val" ;;
+            draft_by_default) draft_by_default="$val" ;;
        esac
    done < "$1"
 }
@@ -552,11 +548,15 @@ parse_frontmatter() {
    fm_title=""
    fm_date=""
    fm_draft=""
+    fm_description=""
+    fm_content_warning=""
    while IFS='=' read -r _fk _fv; do
        case "$_fk" in
            title) fm_title="$_fv" ;;
            date) fm_date="$_fv" ;;
            draft) fm_draft="$_fv" ;;
+            description) fm_description="$_fv" ;;
+            content_warning) fm_content_warning="$_fv" ;;
        esac
    done < "$_fm_out"
    rm -f "$_fm_out"
@@ -610,30 +610,7 @@ template="$src/template.html"
 [ -f "$template" ] || template="./template.html"
 if [ ! -f "$template" ]; then
    template="$KEWT_TMPDIR/default_template.html"
-    cat > "$template" <<'EOF'
-<!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>
-EOF
+    printf '%s\n' "$DEFAULT_TMPL" > "$template"
 fi

 [ -d "$out" ] && rm -rf "$out"
@@ -775,7 +752,54 @@ render_markdown() {
        fi
    fi

-    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"
+    head_extra_og="<meta property=\"og:title\" content=\"$(escape_html_attr "$page_title")\" />"
+    if [ -n "$fm_description" ]; then
+        head_extra_og="$head_extra_og
+        <meta property=\"og:description\" content=\"$(escape_html_attr "$fm_description")\" />"
+    fi
+    og_url="${base_url%/}${current_url}"
+    head_extra_og="$head_extra_og
+        <meta property=\"og:url\" content=\"$(escape_html_attr "$og_url")\" />"
+
+    if [ -n "$head_extra" ]; then
+        head_extra="$head_extra
+        $head_extra_og"
+    else
+        head_extra="$head_extra_og"
+    fi
+    
+    if [ "$is_cw_content_page" = "true" ] && [ "$cw_hide_url" = "true" ]; then
+        head_extra="$head_extra
+        <script>window.history.replaceState(null, '', '$current_url');</script>"
+    fi
+
+    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_LANG="$lang" 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_VERSION="$asset_version" AWK_CONTENT_WARNING="$fm_content_warning" awk -f "$awk_dir/render_template.awk" "$local_template"
+}
+
+generate_content_warning_page() {
+    _fm_title="$1"
+    _fm_content_warning="$2"
+    _content_rel_url="$3"
+    _target_url="$4"
+    _out_file="$5"
+    _is_home="$6"
+    
+    _temp_cw="$KEWT_TMPDIR/cw_$$.md"
+    _cw_text="${_fm_content_warning}"
+    [ "$_cw_text" = "true" ] && _cw_text="This content may be sensitive."
+    
+    cat <<EOF > "$_temp_cw"
+---
+title = "$_fm_title"
+---
+
+> [!CAUTION]
+> **Content Warning:** $_cw_text
+
+<a href="$(basename "$_content_rel_url")" class="cw-button">Reveal Content</a>
+EOF
+    render_markdown "$_temp_cw" "$_is_home" "$_target_url" > "$_out_file"
+    rm -f "$_temp_cw"
 }

 needs_rebuild() {
@@ -790,6 +814,7 @@ needs_rebuild() {
    return 1
 }

+build_site() {
 echo "Building site from '$src' to '$out'..."

 eval "find \"$src\" \( $IGNORE_ARGS \) -prune -o -type d -print" | sort | while read -r dir; do
@@ -811,12 +836,21 @@ eval "find \"$src\" \( $IGNORE_ARGS \) -prune -o -type d -print" | sort | while

    [ "$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")
@@ -824,17 +858,36 @@ eval "find \"$src\" \( $IGNORE_ARGS \) -prune -o -type d -print" | sort | while
                target_url="/$rel_dir/index.html"
                [ "$rel_dir" = "." ] && target_url="/index.html"
                if needs_rebuild "$md_file" "$out_dir/index.html"; then
+                    parse_frontmatter "$md_file"
+                    if [ -n "$fm_content_warning" ]; then
+                        content_out_file="$out_dir/content.html"
+                        content_rel_url="/$rel_dir/content.html"
+                        [ "$rel_dir" = "." ] && content_rel_url="/content.html"
+                        
+                        is_cw_content_page="true"
+                        render_markdown "$md_file" "$is_home" "$target_url" > "$content_out_file"
+                        is_cw_content_page="false"
+                        
+                        generate_content_warning_page "$fm_title" "$fm_content_warning" "$content_rel_url" "$target_url" "$out_dir/index.html" "false"
+                    else
                        render_markdown "$md_file" "$is_home" "$target_url" > "$out_dir/index.html"
                    fi
+                fi
                continue
            fi
        fi

        temp_index="$KEWT_TMPDIR/index.md"
+        temp_list="$KEWT_TMPDIR/list.md"
+        : > "$temp_list"
+
+        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
@@ -848,7 +901,7 @@ 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}"

@@ -916,18 +969,120 @@ eval "find \"$src\" \( $IGNORE_ARGS \) -prune -o -type d -print" | sort | while
                        label="$p_date $p_time"
                    fi
                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
+        
        is_home="false"; [ "$dir" = "$src" ] && is_home="true"
        target_url="/$rel_dir/index.html"
        [ "$rel_dir" = "." ] && target_url="/index.html"
-        if needs_rebuild "$dir" "$out_dir/index.html"; then
+
+        num_items=$(wc -l < "$temp_list")
+        if [ "$is_posts_dir" = "true" ] && [ -n "$posts_per_page" ] && [ "$posts_per_page" -gt 0 ] && [ "$num_items" -gt "$posts_per_page" ]; then
+            num_pages=$(( (num_items + posts_per_page - 1) / posts_per_page ))
+            for p in $(seq 1 $num_pages); do
+                chunk_list="$KEWT_TMPDIR/chunk.md"
+                start_line=$(( (p - 1) * posts_per_page + 1 ))
+                tail -n +$start_line "$temp_list" | head -n "$posts_per_page" > "$chunk_list"
+
+                base_url_dir="$(dirname "$target_url")"
+                [ "$base_url_dir" = "/" ] && base_url_dir=""
+
+                nav_html="<div class=\"pagination\">"
+                if [ "$p" -gt 1 ]; then
+                    if [ "$p" -eq 2 ]; then
+                        nav_html="$nav_html <a href=\"$base_url_dir/index.html\" class=\"prev-page\">&laquo; Prev</a> "
+                    else
+                        nav_html="$nav_html <a href=\"$base_url_dir/page/$((p-1))/index.html\" class=\"prev-page\">&laquo; Prev</a> "
+                    fi
+                fi
+                nav_html="$nav_html <span class=\"page-number\">Page $p of $num_pages</span> "
+                if [ "$p" -lt "$num_pages" ]; then
+                    nav_html="$nav_html <a href=\"$base_url_dir/page/$((p+1))/index.html\" class=\"next-page\">Next &raquo;</a> "
+                fi
+                nav_html="$nav_html</div>"
+
+                echo "" >> "$chunk_list"
+                echo "$nav_html" >> "$chunk_list"
+
+                temp_index_p="$KEWT_TMPDIR/index_p$p.md"
+                if [ "$has_custom_index" = "false" ]; then
+                    display_dir="${rel_dir#.}"
+                    [ -z "$display_dir" ] && display_dir="/"
+                    echo "# Index of $display_dir" > "$temp_index_p"
+                    echo "" >> "$temp_index_p"
+                else
+                    : > "$temp_index_p"
+                fi
+
+                if [ "$has_custom_index" = "true" ]; then
+                    awk '
+                        /^[[:space:]]*\{\{LIST\}\}[[:space:]]*$/ {
+                            while((getline line < "'"$chunk_list"'") > 0) print line
+                            close("'"$chunk_list"'")
+                            next
+                        }
+                        { print }
+                    ' "$dir/index.md" >> "$temp_index_p"
+                else
+                    cat "$chunk_list" >> "$temp_index_p"
+                fi
+
+                if [ "$p" -eq 1 ]; then
+                    out_file="$out_dir/index.html"
+                    target_url_p="$target_url"
+                else
+                    out_file="$out_dir/page/$p/index.html"
+                    target_url_p="$base_url_dir/page/$p/index.html"
+                    mkdir -p "$(dirname "$out_file")"
+                fi
+
+                render_markdown "$temp_index_p" "$is_home" "$target_url_p" > "$out_file"
+                rm -f "$temp_index_p" "$chunk_list"
+            done
+        else
+            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
+
+            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
+                if [ "$has_custom_index" = "true" ]; then
+                    parse_frontmatter "$dir/index.md"
+                else
+                    fm_content_warning=""
+                fi
+                
+                if [ -n "$fm_content_warning" ]; then
+                    content_out_file="$out_dir/content.html"
+                    content_rel_url="/$rel_dir/content.html"
+                    [ "$rel_dir" = "." ] && content_rel_url="/content.html"
+                    
+                    is_cw_content_page="true"
+                    render_markdown "$temp_index" "$is_home" "$target_url" > "$content_out_file"
+                    is_cw_content_page="false"
+                    
+                    generate_content_warning_page "$fm_title" "$fm_content_warning" "$content_rel_url" "$target_url" "$out_dir/index.html" "false"
+                else
                    render_markdown "$temp_index" "$is_home" "$target_url" > "$out_dir/index.html"
                fi
-        rm "$temp_index"
+            fi
+        fi
+        rm -f "$temp_index" "$temp_list"
    fi
 done

@@ -945,6 +1100,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
@@ -969,8 +1128,20 @@ eval "find \"$src\" \( $IGNORE_ARGS \) -prune -o -type f -print" | sort | while
        is_home="false"; [ "$file" = "$src/index.md" ] && is_home="true"
        out_file="$out/${rel_path%.md}.html"
        if needs_rebuild "$file" "$out_file"; then
+            if [ -n "$fm_content_warning" ]; then
+                content_out_file="$out/${rel_path%.md}-content.html"
+                content_rel_url="/${rel_path%.md}-content.html"
+                orig_rel_url="/${rel_path%.md}.html"
+                
+                is_cw_content_page="true"
+                render_markdown "$file" "$is_home" "$orig_rel_url" > "$content_out_file"
+                is_cw_content_page="false"
+                
+                generate_content_warning_page "$fm_title" "$fm_content_warning" "$content_rel_url" "$orig_rel_url" "$out_file" "false"
+            else
                render_markdown "$file" "$is_home" > "$out_file"
            fi
+        fi
    else
        if needs_rebuild "$file" "$out/$rel_path"; then
            cp "$file" "$out/$rel_path"
@@ -1001,10 +1172,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 '    <lastmod>%s</lastmod>\n' "$today" >> "$sitemap_file"
-        printf '  </url>\n' >> "$sitemap_file"
+        {
+            printf '  <url>\n'
+            printf '    <loc>%s%s</loc>\n' "$base_url" "$rel_url"
+            printf '    <lastmod>%s</lastmod>\n' "$today"
+            printf '  </url>\n'
+        } >> "$sitemap_file"
    done

    printf '</urlset>\n' >> "$sitemap_file"
@@ -1016,12 +1189,14 @@ 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 '    <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"
+    {
+        printf '<rss version="2.0">\n'
+        printf '  <channel>\n'
+        printf '    <title>%s</title>\n' "$title"
+        printf '    <link>%s</link>\n' "$base_url_feed"
+        printf '    <description>%s</description>\n' "$title"
+        printf '    <lastBuildDate>%s</lastBuildDate>\n' "$build_date"
+    } >> "$feed_path"

    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)
@@ -1065,6 +1240,9 @@ if [ "$generate_feed" = "true" ] && [ -n "$base_url" ]; then
        rel_path="${rel_path#/}"
        post_url="$base_url_feed/${rel_path%.md}.html"

+        if date -u -d "$post_date $post_time" '+%a, %d %b %Y %H:%M:%S +0000' >/dev/null 2>&1; then
+            pub_date=$(date -u -d "$post_date $post_time" '+%a, %d %b %Y %H:%M:%S +0000')
+        else
            pub_year=$(echo "$post_date" | cut -d- -f1)
            pub_month=$(echo "$post_date" | cut -d- -f2)
            pub_day=$(echo "$post_date" | cut -d- -f3)
@@ -1076,14 +1254,17 @@ if [ "$generate_feed" = "true" ] && [ -n "$base_url" ]; then
                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"
+            pub_date="Mon, ${pub_day} ${pub_mon} ${pub_year} ${post_time}:00 +0000"
+        fi

-        printf '    <item>\n' >> "$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"
-        printf '    </item>\n' >> "$feed_path"
+        {
+            printf '    <item>\n'
+            printf '      <title>%s</title>\n' "$feed_post_title"
+            printf '      <link>%s</link>\n' "$post_url"
+            printf '      <guid>%s</guid>\n' "$post_url"
+            printf '      <pubDate>%s</pubDate>\n' "$pub_date"
+            printf '    </item>\n'
+        } >> "$feed_path"
    done

    printf '  </channel>\n' >> "$feed_path"
@@ -1091,3 +1272,46 @@ if [ "$generate_feed" = "true" ] && [ -n "$base_url" ]; then
 fi

 echo "Build complete."
+}
+
+build_site
+
+if [ "$serve_mode" = "true" ]; then
+    port="${serve_port:-8000}"
+    if command -v python3 >/dev/null 2>&1; then
+        python3 -m http.server "$port" -d "$out" >/dev/null 2>&1 &
+        server_pid=$!
+        echo "Serving '$out' on http://localhost:$port (python3)"
+    elif command -v busybox >/dev/null 2>&1; then
+        busybox httpd -f -p "$port" -h "$out" >/dev/null 2>&1 &
+        server_pid=$!
+        echo "Serving '$out' on http://localhost:$port (busybox)"
+    else
+        die "Neither python3 nor busybox httpd is available to serve."
+    fi
+
+    trap 'kill $server_pid 2>/dev/null; rm -rf "$KEWT_TMPDIR"' EXIT
+    trap 'kill $server_pid 2>/dev/null; exit 0' HUP INT TERM
+fi
+
+if [ "$watch_mode" = "true" ]; then
+    echo "Watching for changes in '$src'..."
+    touch "$KEWT_TMPDIR/watch_mark"
+    while true; do
+        sleep 1
+        changed="$(find "$src" -type f -newer "$KEWT_TMPDIR/watch_mark" 2>/dev/null | head -n 1)"
+        [ -z "$changed" ] && [ -f "site.conf" ] && [ "site.conf" -nt "$KEWT_TMPDIR/watch_mark" ] && changed="site.conf"
+        [ -z "$changed" ] && [ -f "$src/site.conf" ] && [ "$src/site.conf" -nt "$KEWT_TMPDIR/watch_mark" ] && changed="$src/site.conf"
+        [ -z "$changed" ] && [ -f "$template" ] && [ "$template" -nt "$KEWT_TMPDIR/watch_mark" ] && changed="$template"
+        [ -z "$changed" ] && [ -d "$script_dir/styles" ] && changed="$(find "$script_dir/styles" -type f -newer "$KEWT_TMPDIR/watch_mark" 2>/dev/null | head -n 1)"
+        
+        if [ -n "$changed" ]; then
+            echo ""
+            echo "Change detected, rebuilding..."
+            build_site
+            touch "$KEWT_TMPDIR/watch_mark"
+        fi
+    done
+elif [ "$serve_mode" = "true" ]; then
+    wait "$server_pid"
+fi
--- a/markdown.sh
+++ b/markdown.sh
@@ -62,13 +62,20 @@ awk -f "$awk_dir/fenced_code.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_f
 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 -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/definition_lists.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"

+# TOC
+awk -f "$awk_dir/toc.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
+# Footnotes
+awk -f "$awk_dir/footnotes.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
+
 # Spacing
 awk -f "$awk_dir/breaks.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
 awk -f "$awk_dir/paragraphs.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"

 # Inline styles
+awk -f "$awk_dir/emoji.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
 awk -f "$awk_dir/markdown_inline.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
-awk -v input_file="$1" -v site_root="$MARKDOWN_SITE_ROOT" -v fallback_file="$MARKDOWN_FALLBACK_FILE" -f "$awk_dir/markdown_embed.awk" "$temp_file"
+awk -v input_file="$1" -v site_root="$MARKDOWN_SITE_ROOT" -v fallback_file="$MARKDOWN_FALLBACK_FILE" -v script_dir="$script_dir" -f "$awk_dir/markdown_embed.awk" "$temp_file"
 rm "$temp_file"
--- a/site/Heaven/index.md
+++ b/site/Heaven/index.md
@@ -1,4 +0,0 @@
-# Heaven
-
-| --- | --- |
-| ```![/styles.css]``` | <img style="vertical-align: top;" src="catgirl.jpg"> |
--- a/site/depths/index.md
+++ b/site/depths/index.md
@@ -0,0 +1,5 @@
+# Depths
+
+This is a custom index for a directory
+
+{{LIST}}
--- a/site/docs/configuration.md
+++ b/site/docs/configuration.md
@@ -0,0 +1,69 @@
+---
+title = "Configuration"
+---
+# Configuration
+
+## 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 = ""
+posts_per_page = 12
+custom_admonitions = ""
+cw_hide_url = 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.
+- `posts_per_page` - number of posts per page in paginated post indexes (default: 12). Set to 0 to disable pagination.
+- `enable_header_links` - turns markdown section headings into clickable anchor links (default: true)
+- `custom_admonitions` - comma separated list of custom admonitions
+- `cw_hide_url` - embeds non-breaking JS to replace the URL in the browser bar on content warning pages (default: true)
+
+## 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.
--- a/site/docs/embeds.md
+++ b/site/docs/embeds.md
@@ -0,0 +1,24 @@
+---
+title = "Embeds"
+---
+# 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
--- a/site/docs/frontmatter.md
+++ b/site/docs/frontmatter.md
@@ -0,0 +1,20 @@
+---
+title = "Frontmatter"
+---
+# 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
+description = "A short page summary"
+---
+```
+- `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.
+- `description` - page description, used for Open Graph `og:description` meta tag.
+- `content_warning` - if set, creates an interstitial warning page that the user must click through. If set to `true` uses a generic warning, otherwise uses your string.
--- a/site/docs/index.md
+++ b/site/docs/index.md
@@ -0,0 +1,6 @@
+---
+title = "Documentation"
+---
+# Documentation
+
+{{LIST}}
--- a/site/docs/installation.md
+++ b/site/docs/installation.md
@@ -0,0 +1,45 @@
+---
+title = "Installation"
+---
+# 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
+```
--- a/site/docs/markdown.md
+++ b/site/docs/markdown.md
@@ -0,0 +1,41 @@
+---
+title = "Markdown Extensions"
+---
+# Markdown Extensions
+
+## 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}}` placeholder is replaced with the autogenerated file list.
+
+## Table of Contents
+
+`{{TOC}}` auto-generates a nested heading list with clickable anchors.
+
+## Footnotes
+
+Full support for `[^id]` footnotes and `[^id]: text` definitions. They render as a numbered `<section>` at the bottom of the page.
+
+## Definition Lists
+
+Definition lists use the standard syntax:
+
+```md
+Term
+: Definition
+```
+This renders as `<dl><dt>Term</dt><dd>Definition</dd></dl>`. Multiple definitions per term are supported.
+
+## Emoji Shortcodes
+
+Standard GitHub/MkDocs emoji shortcodes like `:smile:`, `:fire:`, `:rocket:` are automatically replaced with their Unicode emoji equivalents. Shortcodes inside code blocks are left as-is.
--- a/site/docs/templates.md
+++ b/site/docs/templates.md
@@ -0,0 +1,15 @@
+---
+title = "Templates"
+---
+# Templates
+
+When customizing `template.html`, the placeholders available are:
+- `{{CONTENT}}` - the generated content
+- `{{TITLE}}` - the generated title
+- `{{NAV}}` - the generated navigation
+- `{{FOOTER}}` - the configured footer
+- `{{VERSION}}` - the cache-busting string from `versioning = true` (e.g. `?v=12345678`). Safe to use even if versioning is **disabled** (it will be empty).
+- `{{CSS}}` - the configured CSS file path
+- `{{LANG}}` - the configured document language
+- `{{HEAD_EXTRA}}` - meta-tags
+- `{{HEADER_BRAND}}` - header rendering the name and/or logo
--- a/site/docs/usage.md
+++ b/site/docs/usage.md
@@ -0,0 +1,23 @@
+---
+title = "Usage"
+---
+# 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]
+kewt --watch
+kewt --serve [port]
+```
+- `--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.
+- `--watch` (`-w`) watches for file changes in the source directory and rebuilds automatically.
+- `--serve` (`-s`) starts a local HTTP server (python3 or busybox) in the output directory after building. Use with the port number to specify the port. Composable with `--watch`.
--- a/site/heaven/catgirl.jpg
+++ b/site/heaven/catgirl.jpg
--- a/site/heaven/index.md
+++ b/site/heaven/index.md
@@ -0,0 +1,12 @@
+---
+title = "Heaven"
+content_warning = "This page may contain CSS"
+---
+# Heaven
+
+Told you
+
+Probably should've mentioned the catgirl too
+
+| --- | --- |
+| ```![/styles.css]``` | <img style="vertical-align: top;" src="catgirl.jpg"> |
--- a/site/index.md
+++ b/site/index.md
@@ -14,7 +14,7 @@ It's meant to be a static site generator, like _[kew](https://github.com/uint23/
 ## Features

 - No dependencies
- Frontmatter support (title, date, draft)
+- Frontmatter support (title, date, draft, description)
 - Supports many embed types
 - Automatic css variable replacement for older browsers
 - Automatic inlining and embedding of many filetypes with `\![link]` or `\![alt](link)`
@@ -30,169 +30,14 @@ 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
-
-If you want to **force** a file to be inlined, use `\!![]` instead of `\![]`
-
-***
-
-## 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
-```
-
-***
-
-## 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 [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
-
-```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
-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
-
-### 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
- **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
-
-### 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
+- Customisable directory index pages with `{{LIST}}`
+- Open Graph meta tags from frontmatter
+- Auto-generated Table of Contents via `{{TOC}}`
+- Footnotes (`[^id]`)
+- Definition lists
+- Emoji shortcodes (`:smile:`, `:fire:`, etc.)
+- Post pagination
+- `--watch` and `--serve` modes for development

 ***

--- a/site/site.conf
+++ b/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 = ""
@@ -20,3 +20,6 @@ versioning = true
 enable_header_links = true
 base_url = "https://kewt.krzak.org"
 custom_admonitions = ""
+generate_feed = false
+feed_file = "rss.xml"
+posts_dir = ""
--- a/styles/kewt.css
+++ b/styles/kewt.css
@@ -218,6 +218,21 @@ pre code {
    background: var(--adm-caution-bg);
    border-color: var(--adm-caution-border);
 }
+.cw-button {
+    display: inline-block;
+    padding: 8px 16px;
+    background: var(--bg-deep);
+    border: 1px solid var(--code-border);
+    color: var(--fg);
+    text-decoration: none;
+    font-weight: bold;
+}
+
+.cw-button:hover {
+    background: var(--fg);
+    color: var(--bg);
+    border-color: var(--fg);
+}

 footer {
    padding-top: 60px;
@@ -252,8 +267,28 @@ hr {
    border-top: 1px solid var(--code-border);
 }

+.nav-toggle,
+.nav-toggle-label {
+    display: none;
+}
+
@media screen and (max-width: 600px) {
+    header {
+        display: flex;
+        justify-content: space-between;
+        align-items: center;
+    }
+
+    .nav-toggle-label {
+        display: block;
+        font-size: 30px;
+        cursor: pointer;
+        color: var(--fg-heading);
+        user-select: none;
+    }
+
    #side-bar {
+        display: none;
        position: relative;
        top: auto;
        left: auto;
@@ -264,6 +299,10 @@ hr {
        margin: 0 20px 20px 20px;
    }

+    .nav-toggle:checked~#side-bar {
+        display: block;
+    }
+
    article {
        margin: 0 20px 0 20px;
    }
Author	SHA1	Message	Date
$N0\A$ N0\A	100979d28a	docs: massive doc update All checks were successful Lint / shellcheck (push) Successful in 21s Details Release Standalone Builder / build (release) Successful in 31s Details Release Standalone Builder / publish-aur (release) Successful in 35s Details Release Standalone Builder / publish-homebrew (release) Successful in 7s Details	2026-03-31 12:08:52 +02:00
$N0\A$ N0\A	d35ddcf487	feat: {{VERSION}} and content warning pages	2026-03-31 11:44:29 +02:00
$N0\A$ N0\A	aac9198878	feat: draft_by_default and lang All checks were successful Lint / shellcheck (push) Successful in 36s Details Release Standalone Builder / build (release) Successful in 31s Details Release Standalone Builder / publish-aur (release) Successful in 34s Details Release Standalone Builder / publish-homebrew (release) Successful in 7s Details	2026-03-30 09:55:26 +02:00
$N0\A$ N0\A	99e1f5dd24	fix: markdown embedding	2026-03-30 09:54:44 +02:00
$N0\A$ N0\A	3970c6eb47	fix: inline html	2026-03-30 09:54:23 +02:00
$N0\A$ N0\A	3075719963	feat: might be actually feature-complete by now All checks were successful Lint / shellcheck (push) Successful in 21s Details Release Standalone Builder / build (release) Successful in 33s Details Release Standalone Builder / publish-aur (release) Successful in 36s Details Release Standalone Builder / publish-homebrew (release) Successful in 7s Details	2026-03-26 13:16:34 +01:00
$N0\A$ N0\A	0379d38234	docs: new docs All checks were successful Lint / shellcheck (push) Successful in 22s Details Release Standalone Builder / build (release) Successful in 33s Details Release Standalone Builder / publish-aur (release) Successful in 34s Details Release Standalone Builder / publish-homebrew (release) Successful in 6s Details	2026-03-25 10:42:24 +01:00
$N0\A$ N0\A	b22897135e	feat: --generate-template	2026-03-25 10:20:19 +01:00
$N0\A$ N0\A	185cf769c3	fix: shellcheck style	2026-03-25 10:07:04 +01:00
$N0\A$ N0\A	b2acd26660	feat: custom directory indexes	2026-03-25 10:02:22 +01:00
$N0\A$ N0\A	4069bafd52	fix: typo in codeblock handling that made it so headers appear All checks were successful Lint / shellcheck (push) Successful in 19s Details Release Standalone Builder / build (release) Successful in 33s Details Release Standalone Builder / publish-aur (release) Successful in 36s Details Release Standalone Builder / publish-homebrew (release) Successful in 7s Details	2026-03-24 08:18:11 +01:00
$N0\A$ N0\A	9dbd41392e	docs: update installation instructions link in readme All checks were successful Lint / shellcheck (push) Successful in 22s Details	2026-03-24 08:12:48 +01:00