Priority systen

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