docs: new docs

kewt.sh

@@ -761,7 +761,7 @@ eval "find \"$src\" \( $IGNORE_ARGS \) -prune -o -type d -print" | sort | while
     has_list="false"
     if [ -f "$dir/index.md" ]; then
         has_custom_index="true"
-        if grep -q '{{LIST}}' "$dir/index.md" 2>/dev/null; then
+        if grep -q '^[[:space:]]*{{LIST}}[[:space:]]*$' "$dir/index.md" 2>/dev/null; then
             has_list="true"
         fi
     fi
@@ -885,7 +885,7 @@ eval "find \"$src\" \( $IGNORE_ARGS \) -prune -o -type d -print" | sort | while
         
         if [ "$has_custom_index" = "true" ]; then
             awk '
-                /\{\{LIST\}\}/ {
+                /^[[:space:]]*\{\{LIST\}\}[[:space:]]*$/ {
                     while((getline line < "'"$temp_list"'") > 0) print line
                     close("'"$temp_list"'")
                     next
@@ -925,7 +925,7 @@ 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 '{{LIST}}' "$file" 2>/dev/null; then
+    if [ "${file##*/}" = "index.md" ] && grep -q '^[[:space:]]*{{LIST}}[[:space:]]*$' "$file" 2>/dev/null; then
         continue
     fi
 

site/Docs/configuration.md

@@ -0,0 +1,37 @@
+# Configuration
+
+## Dot Files
+
+- `.kewtignore` - files/directories to ignore completely. If the file is empty, the whole directory gets ignored.
+- `.kewthide` - files/directories to hide from navigation but still process. Same empty-file rules as `.kewtignore`.
+- `.kewtpreserve` - files/directories to copy as-is without converting markdown to HTML. Same empty-file rules again.
+
+## Frontmatter
+
+You can set metadata for a page using a `site.conf`-style frontmatter block at the very top of `.md` files:
+
+```conf
+---
+title = "Custom Page Title"
+date = "2026-03-23 11:32"
+draft = false
+---
+```
+- `title` - overrides the page title, post name in index links, and RSS `<title>`.
+- `date` - overrides the post date and time. Supports `YYYY-MM-DD` and `YYYY-MM-DD HH:MM` (or `HH-MM`).
+- `draft` - if `true`, the file is excluded from HTML generation.
+
+## Directory Index Customisation
+
+By default, directories without an `index.md` get an auto-generated index page listing their contents.
+
+If you create your own `index.md` in a directory, you can still include the auto-generated file list by using the `{{LIST}}` placeholder:
+
+```md
+# Blog
+
+This is my blog. The posts are below. The top-most one is the most recent.
+
+{{LIST}}
+```
+The `{{LIST}}` tag will be replaced with the generated list of links to child pages and files, exactly as in case the custom index didn't exist.

site/Docs/embeds.md

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

site/Docs/index.md

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

site/Docs/installation.md

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

site/Docs/usage.md

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

site/index.md

@@ -30,171 +30,9 @@ It's meant to be a static site generator, like _[kew](https://github.com/uint23/
 - Code block classes for use with external libraries like highlight.js or prism.js (both tested)
 - Clickable markdown header anchors
 - Mobile responsive layout
-
+- Customisable directory index pages with `{{LIST}}`
-If you want to **force** a file to be inlined, use `\!![]` instead of `\![]`
 
 ***
 
-## Installation
+> [!WARNING]
-
+> The base that all of this is built upon was coded at night, while sleepy and a bit sick, and after walking for about 4 hours around a forest, so...
-### 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
-
-***
-
->[!WARNING]
->The base that all of this is built upon was coded at night, while sleepy and a bit sick, and after walking for about 4 hours around a forest, so...

site/site.conf

@@ -9,7 +9,7 @@ display_logo = false
 display_title = true
 logo_as_favicon = false
 favicon = "favicon.ico"
-order = ""
+order = "Home, Docs, depths, Heaven"
 home_name = "Home"
 show_home_in_nav = true
 nav_links = ""