Priority systen

site/depths/deeper depths/deeper deeper depths/the deepest depths/blobfish/blobfish.md

@@ -1,3 +1,6 @@
+---
+priority = 0
+---
 # Hello!
 
 ![the greatest drawing of a blobfish in the world](blobfish.bmp)

site/depths/index.md

@@ -1,3 +1,6 @@
+---
+priority = 2
+---
 # Depths
 
 This is a custom index for a directory

site/docs/configuration.md

@@ -1,5 +1,6 @@
 ---
 title = "Configuration"
+priority = 2
 ---
 # Configuration
 
@@ -13,7 +14,6 @@ draft_by_default = false
 dir_indexes = true
 single_file_index = true
 flatten = false
-order = ""
 home_name = "Home"
 show_home_in_nav = true
 nav_links = ""
@@ -49,7 +49,6 @@ include_cw_pages_in_search = false
 - `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)`

site/docs/embeds.md

@@ -1,5 +1,6 @@
 ---
 title = "Embeds"
+priority = 5
 ---
 # Embeds
 

site/docs/frontmatter.md

@@ -1,5 +1,6 @@
 ---
 title = "Frontmatter"
+priority = 4
 ---
 # Frontmatter
 
@@ -12,6 +13,7 @@ date = "2026-03-23 11:32"
 draft = false
 description = "A short page summary"
 tags = "example, tutorial"
+priority = 10
 ---
 ```
 - `title` - overrides the page title, post name in index links, and RSS `<title>`.
@@ -20,3 +22,4 @@ tags = "example, tutorial"
 - `description` - page description, used for Open Graph `og:description` meta tag.
 - `tags` - comma separated list of tags. Used for tag index generation when `generate_tags` is enabled in `site.conf`.
 - `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.
+- `priority` - numeric value for ordering. Lower values sort first in the sidebar and directory indexes. Falls back to alphabetical/date ordering when not set or when items share the same priority.

site/docs/index.md

@@ -1,5 +1,6 @@
 ---
 title = "Documentation"
+priority = 0
 ---
 # Documentation
 

site/docs/installation.md

@@ -1,5 +1,6 @@
 ---
 title = "Installation"
+priority = 0
 ---
 # Installation
 

site/docs/markdown.md

@@ -1,5 +1,6 @@
 ---
 title = "Markdown Extensions"
+priority = 7
 ---
 # Markdown Extensions
 

site/docs/quickstart.md

@@ -1,5 +1,6 @@
 ---
 title = "Quickstart"
+priority = 1
 ---
 # Quickstart
 

site/docs/templates.md

@@ -1,5 +1,6 @@
 ---
 title = "Templates"
+priority = 8
 ---
 # Templates
 

site/docs/theming.md

@@ -1,5 +1,6 @@
 ---
 title = "Theming"
+priority = 6
 ---
 # Theming
 

site/docs/usage.md

@@ -1,5 +1,6 @@
 ---
 title = "Usage"
+priority = 3
 ---
 # Usage
 

site/heaven/index.md

@@ -1,5 +1,6 @@
 ---
 title = "Heaven"
+priority = 3
 content_warning = "This page may contain CSS"
 ---
 # Heaven

site/index.md

@@ -1,3 +1,7 @@
+---
+title = "Home"
+priority = 0
+---
 # _kewt_
 ### Pronounced "cute"
 
@@ -14,7 +18,7 @@ It's meant to be a static site generator, like _[kew](https://github.com/uint23/
 ## Features
 
 - No dependencies
-- Frontmatter support (title, date, draft, description)
+- Frontmatter support (title, date, draft, description, priority)
 - Supports many embed types
 - Automatic css variable replacement for older browsers
 - Automatic inlining and embedding of many filetypes with `\![link]` or `\![alt](link)`

site/site.conf

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