From c6a1c8be5c9f7e66c7400d2e061d192da560ee1c Mon Sep 17 00:00:00 2001 From: Vincent Prouillet Date: Thu, 18 Jun 2020 23:16:29 +0200 Subject: [PATCH] Clearer page sorting comment --- docs/content/documentation/content/section.md | 2 +- docs/content/documentation/templates/pages-sections.md | 4 +++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/content/documentation/content/section.md b/docs/content/documentation/content/section.md index 93df4663..0c35944d 100644 --- a/docs/content/documentation/content/section.md +++ b/docs/content/documentation/content/section.md @@ -159,7 +159,7 @@ to newest (at the bottom). `reverse` has no effect on `page.later`/`page.earlier` or `page.heavier`/`page.lighter`. ## Sorting subsections -Sorting sections is a bit less flexible: sections are always sorted by `weight`, +Sorting sections is a bit less flexible: sections can only be sorted by `weight`, and do not have variables that point to the heavier/lighter sections. By default, the lightest (lowest `weight`) subsections will be at diff --git a/docs/content/documentation/templates/pages-sections.md b/docs/content/documentation/templates/pages-sections.md index 0916b83a..ec550ed5 100644 --- a/docs/content/documentation/templates/pages-sections.md +++ b/docs/content/documentation/templates/pages-sections.md @@ -80,7 +80,9 @@ path: String; components: Array; permalink: String; extra: HashMap; -// Pages directly in this section, sorted if asked +// Pages directly in this section. By default, the pages are not sorted. Please set the "sorted_by" +// variable in the _index.md file of the corresponding section to "date" or "weight" for sorting by +// date and weight, respectively. pages: Array; // Direct subsections to this section, sorted by subsections weight // This only contains the path to use in the `get_section` Tera function to get