docshelper: Improve template lookup order descriptions

- Always include example for "with layout/type set"
- Use lowercase for "set to" examples (lookup is case sensitive)
- Consistent use of taxonomy and term

Fixes gohugoio/hugoDocs#1734

data/docs.yaml

@@ -921,8 +921,8 @@ config:
       dir: :cacheDir/:project
       maxAge: -1
     images:
-      dir: :cacheDir/images
+      dir: :resourceDir/_gen
-      maxAge: 1.8e+15
+      maxAge: -1
     modules:
       dir: :cacheDir/modules
       maxAge: -1
@@ -1541,12 +1541,16 @@ config:
     enableInlineShortcodes: false
     exec:
       allow:
-      - ^((dart-)?sass(-embedded)?|go|npx|postcss)$
+      - ^(dart-)?sass(-embedded)?$
+      - ^go$
+      - ^npx$
+      - ^postcss$
       osEnv:
-      - (?i)^(PATH|PATHEXT|APPDATA|HOME|TMP|TEMP|TERM)$
+      - (?i)^((HTTPS?|NO)_PROXY|PATH(EXT)?|APPDATA|TE?MP|TERM|GO\w+|(XDG_CONFIG_)?HOME|USERPROFILE|SSH_AUTH_SOCK|DISPLAY|LANG)$
     funcs:
       getenv:
-      - ^(HUGO_|REPOSITORY_URL|^BRANCH$)
+      - ^HUGO_
+      - ^CI$
     goTemplates:
       allowActionJSTmpl: false
     http:
@@ -1684,7 +1688,7 @@ output:
     - layouts/_default/baseof.html.html
     - layouts/_default/single-baseof.html
     - layouts/_default/baseof.html
-  - Example: Single page in "posts" section with layout set
+  - Example: Single page in "posts" section with layout set to "demolayout"
     Kind: page
     OutputFormat: html
     Suffix: html
@@ -1697,7 +1701,7 @@ output:
     - layouts/_default/single.html.html
     - layouts/_default/demolayout.html
     - layouts/_default/single.html
-  - Example: Base template for single page in "posts" section with layout set
+  - Example: Base template for single page in "posts" section with layout set to "demolayout"
     Kind: page
     OutputFormat: html
     Suffix: html
@@ -1774,7 +1778,7 @@ output:
     - layouts/_default/home-baseof.html
     - layouts/_default/list-baseof.html
     - layouts/_default/baseof.html
-  - Example: Home page with type set
+  - Example: Home page with type set to "demotype"
     Kind: home
     OutputFormat: html
     Suffix: html
@@ -1797,7 +1801,7 @@ output:
     - layouts/_default/index.html
     - layouts/_default/home.html
     - layouts/_default/list.html
-  - Example: Base template for home page with type set
+  - Example: Base template for home page with type set to "demotype"
     Kind: home
     OutputFormat: html
     Suffix: html
@@ -1826,7 +1830,7 @@ output:
     - layouts/_default/home-baseof.html
     - layouts/_default/list-baseof.html
     - layouts/_default/baseof.html
-  - Example: Home page with layout set
+  - Example: Home page with layout set to "demolayout"
     Kind: home
     OutputFormat: html
     Suffix: html
@@ -1913,7 +1917,88 @@ output:
     - layouts/_default/home.xml
     - layouts/_default/list.xml
     - layouts/_internal/_default/rss.xml
-  - Example: RSS section posts
+  - Example: Section list for "posts"
+    Kind: section
+    OutputFormat: html
+    Suffix: html
+    Template Lookup Order:
+    - layouts/posts/posts.html.html
+    - layouts/posts/section.html.html
+    - layouts/posts/list.html.html
+    - layouts/posts/posts.html
+    - layouts/posts/section.html
+    - layouts/posts/list.html
+    - layouts/section/posts.html.html
+    - layouts/section/section.html.html
+    - layouts/section/list.html.html
+    - layouts/section/posts.html
+    - layouts/section/section.html
+    - layouts/section/list.html
+    - layouts/_default/posts.html.html
+    - layouts/_default/section.html.html
+    - layouts/_default/list.html.html
+    - layouts/_default/posts.html
+    - layouts/_default/section.html
+    - layouts/_default/list.html
+  - Example: Section list for "posts" with type set to "blog"
+    Kind: section
+    OutputFormat: html
+    Suffix: html
+    Template Lookup Order:
+    - layouts/blog/posts.html.html
+    - layouts/blog/section.html.html
+    - layouts/blog/list.html.html
+    - layouts/blog/posts.html
+    - layouts/blog/section.html
+    - layouts/blog/list.html
+    - layouts/posts/posts.html.html
+    - layouts/posts/section.html.html
+    - layouts/posts/list.html.html
+    - layouts/posts/posts.html
+    - layouts/posts/section.html
+    - layouts/posts/list.html
+    - layouts/section/posts.html.html
+    - layouts/section/section.html.html
+    - layouts/section/list.html.html
+    - layouts/section/posts.html
+    - layouts/section/section.html
+    - layouts/section/list.html
+    - layouts/_default/posts.html.html
+    - layouts/_default/section.html.html
+    - layouts/_default/list.html.html
+    - layouts/_default/posts.html
+    - layouts/_default/section.html
+    - layouts/_default/list.html
+  - Example: Section list for "posts" with layout set to "demolayout"
+    Kind: section
+    OutputFormat: html
+    Suffix: html
+    Template Lookup Order:
+    - layouts/posts/demolayout.html.html
+    - layouts/posts/posts.html.html
+    - layouts/posts/section.html.html
+    - layouts/posts/list.html.html
+    - layouts/posts/demolayout.html
+    - layouts/posts/posts.html
+    - layouts/posts/section.html
+    - layouts/posts/list.html
+    - layouts/section/demolayout.html.html
+    - layouts/section/posts.html.html
+    - layouts/section/section.html.html
+    - layouts/section/list.html.html
+    - layouts/section/demolayout.html
+    - layouts/section/posts.html
+    - layouts/section/section.html
+    - layouts/section/list.html
+    - layouts/_default/demolayout.html.html
+    - layouts/_default/posts.html.html
+    - layouts/_default/section.html.html
+    - layouts/_default/list.html.html
+    - layouts/_default/demolayout.html
+    - layouts/_default/posts.html
+    - layouts/_default/section.html
+    - layouts/_default/list.html
+  - Example: Section list for "posts"
     Kind: section
     OutputFormat: rss
     Suffix: xml
@@ -1934,7 +2019,44 @@ output:
     - layouts/_default/section.xml
     - layouts/_default/list.xml
     - layouts/_internal/_default/rss.xml
-  - Example: Taxonomy in categories
+  - Example: Taxonomy list for "categories"
+    Kind: taxonomy
+    OutputFormat: html
+    Suffix: html
+    Template Lookup Order:
+    - layouts/categories/category.terms.html.html
+    - layouts/categories/terms.html.html
+    - layouts/categories/taxonomy.html.html
+    - layouts/categories/list.html.html
+    - layouts/categories/category.terms.html
+    - layouts/categories/terms.html
+    - layouts/categories/taxonomy.html
+    - layouts/categories/list.html
+    - layouts/category/category.terms.html.html
+    - layouts/category/terms.html.html
+    - layouts/category/taxonomy.html.html
+    - layouts/category/list.html.html
+    - layouts/category/category.terms.html
+    - layouts/category/terms.html
+    - layouts/category/taxonomy.html
+    - layouts/category/list.html
+    - layouts/taxonomy/category.terms.html.html
+    - layouts/taxonomy/terms.html.html
+    - layouts/taxonomy/taxonomy.html.html
+    - layouts/taxonomy/list.html.html
+    - layouts/taxonomy/category.terms.html
+    - layouts/taxonomy/terms.html
+    - layouts/taxonomy/taxonomy.html
+    - layouts/taxonomy/list.html
+    - layouts/_default/category.terms.html.html
+    - layouts/_default/terms.html.html
+    - layouts/_default/taxonomy.html.html
+    - layouts/_default/list.html.html
+    - layouts/_default/category.terms.html
+    - layouts/_default/terms.html
+    - layouts/_default/taxonomy.html
+    - layouts/_default/list.html
+  - Example: Taxonomy list for "categories"
     Kind: taxonomy
     OutputFormat: rss
     Suffix: xml
@@ -1976,7 +2098,52 @@ output:
     - layouts/_default/taxonomy.xml
     - layouts/_default/list.xml
     - layouts/_internal/_default/rss.xml
-  - Example: Term in categories
+  - Example: Term list for "categories"
+    Kind: term
+    OutputFormat: html
+    Suffix: html
+    Template Lookup Order:
+    - layouts/categories/term.html.html
+    - layouts/categories/category.html.html
+    - layouts/categories/taxonomy.html.html
+    - layouts/categories/list.html.html
+    - layouts/categories/term.html
+    - layouts/categories/category.html
+    - layouts/categories/taxonomy.html
+    - layouts/categories/list.html
+    - layouts/term/term.html.html
+    - layouts/term/category.html.html
+    - layouts/term/taxonomy.html.html
+    - layouts/term/list.html.html
+    - layouts/term/term.html
+    - layouts/term/category.html
+    - layouts/term/taxonomy.html
+    - layouts/term/list.html
+    - layouts/taxonomy/term.html.html
+    - layouts/taxonomy/category.html.html
+    - layouts/taxonomy/taxonomy.html.html
+    - layouts/taxonomy/list.html.html
+    - layouts/taxonomy/term.html
+    - layouts/taxonomy/category.html
+    - layouts/taxonomy/taxonomy.html
+    - layouts/taxonomy/list.html
+    - layouts/category/term.html.html
+    - layouts/category/category.html.html
+    - layouts/category/taxonomy.html.html
+    - layouts/category/list.html.html
+    - layouts/category/term.html
+    - layouts/category/category.html
+    - layouts/category/taxonomy.html
+    - layouts/category/list.html
+    - layouts/_default/term.html.html
+    - layouts/_default/category.html.html
+    - layouts/_default/taxonomy.html.html
+    - layouts/_default/list.html.html
+    - layouts/_default/term.html
+    - layouts/_default/category.html
+    - layouts/_default/taxonomy.html
+    - layouts/_default/list.html
+  - Example: Term list for "categories"
     Kind: term
     OutputFormat: rss
     Suffix: xml
@@ -2027,169 +2194,6 @@ output:
     - layouts/_default/taxonomy.xml
     - layouts/_default/list.xml
     - layouts/_internal/_default/rss.xml
-  - Example: Section list for "posts" section
-    Kind: section
-    OutputFormat: html
-    Suffix: html
-    Template Lookup Order:
-    - layouts/posts/posts.html.html
-    - layouts/posts/section.html.html
-    - layouts/posts/list.html.html
-    - layouts/posts/posts.html
-    - layouts/posts/section.html
-    - layouts/posts/list.html
-    - layouts/section/posts.html.html
-    - layouts/section/section.html.html
-    - layouts/section/list.html.html
-    - layouts/section/posts.html
-    - layouts/section/section.html
-    - layouts/section/list.html
-    - layouts/_default/posts.html.html
-    - layouts/_default/section.html.html
-    - layouts/_default/list.html.html
-    - layouts/_default/posts.html
-    - layouts/_default/section.html
-    - layouts/_default/list.html
-  - Example: Section list for "posts" section with type set to "blog"
-    Kind: section
-    OutputFormat: html
-    Suffix: html
-    Template Lookup Order:
-    - layouts/blog/posts.html.html
-    - layouts/blog/section.html.html
-    - layouts/blog/list.html.html
-    - layouts/blog/posts.html
-    - layouts/blog/section.html
-    - layouts/blog/list.html
-    - layouts/posts/posts.html.html
-    - layouts/posts/section.html.html
-    - layouts/posts/list.html.html
-    - layouts/posts/posts.html
-    - layouts/posts/section.html
-    - layouts/posts/list.html
-    - layouts/section/posts.html.html
-    - layouts/section/section.html.html
-    - layouts/section/list.html.html
-    - layouts/section/posts.html
-    - layouts/section/section.html
-    - layouts/section/list.html
-    - layouts/_default/posts.html.html
-    - layouts/_default/section.html.html
-    - layouts/_default/list.html.html
-    - layouts/_default/posts.html
-    - layouts/_default/section.html
-    - layouts/_default/list.html
-  - Example: Section list for "posts" section with layout set to "demoLayout"
-    Kind: section
-    OutputFormat: html
-    Suffix: html
-    Template Lookup Order:
-    - layouts/posts/demolayout.html.html
-    - layouts/posts/posts.html.html
-    - layouts/posts/section.html.html
-    - layouts/posts/list.html.html
-    - layouts/posts/demolayout.html
-    - layouts/posts/posts.html
-    - layouts/posts/section.html
-    - layouts/posts/list.html
-    - layouts/section/demolayout.html.html
-    - layouts/section/posts.html.html
-    - layouts/section/section.html.html
-    - layouts/section/list.html.html
-    - layouts/section/demolayout.html
-    - layouts/section/posts.html
-    - layouts/section/section.html
-    - layouts/section/list.html
-    - layouts/_default/demolayout.html.html
-    - layouts/_default/posts.html.html
-    - layouts/_default/section.html.html
-    - layouts/_default/list.html.html
-    - layouts/_default/demolayout.html
-    - layouts/_default/posts.html
-    - layouts/_default/section.html
-    - layouts/_default/list.html
-  - Example: Taxonomy list in categories
-    Kind: taxonomy
-    OutputFormat: html
-    Suffix: html
-    Template Lookup Order:
-    - layouts/categories/category.terms.html.html
-    - layouts/categories/terms.html.html
-    - layouts/categories/taxonomy.html.html
-    - layouts/categories/list.html.html
-    - layouts/categories/category.terms.html
-    - layouts/categories/terms.html
-    - layouts/categories/taxonomy.html
-    - layouts/categories/list.html
-    - layouts/category/category.terms.html.html
-    - layouts/category/terms.html.html
-    - layouts/category/taxonomy.html.html
-    - layouts/category/list.html.html
-    - layouts/category/category.terms.html
-    - layouts/category/terms.html
-    - layouts/category/taxonomy.html
-    - layouts/category/list.html
-    - layouts/taxonomy/category.terms.html.html
-    - layouts/taxonomy/terms.html.html
-    - layouts/taxonomy/taxonomy.html.html
-    - layouts/taxonomy/list.html.html
-    - layouts/taxonomy/category.terms.html
-    - layouts/taxonomy/terms.html
-    - layouts/taxonomy/taxonomy.html
-    - layouts/taxonomy/list.html
-    - layouts/_default/category.terms.html.html
-    - layouts/_default/terms.html.html
-    - layouts/_default/taxonomy.html.html
-    - layouts/_default/list.html.html
-    - layouts/_default/category.terms.html
-    - layouts/_default/terms.html
-    - layouts/_default/taxonomy.html
-    - layouts/_default/list.html
-  - Example: Taxonomy term in categories
-    Kind: term
-    OutputFormat: html
-    Suffix: html
-    Template Lookup Order:
-    - layouts/categories/term.html.html
-    - layouts/categories/category.html.html
-    - layouts/categories/taxonomy.html.html
-    - layouts/categories/list.html.html
-    - layouts/categories/term.html
-    - layouts/categories/category.html
-    - layouts/categories/taxonomy.html
-    - layouts/categories/list.html
-    - layouts/term/term.html.html
-    - layouts/term/category.html.html
-    - layouts/term/taxonomy.html.html
-    - layouts/term/list.html.html
-    - layouts/term/term.html
-    - layouts/term/category.html
-    - layouts/term/taxonomy.html
-    - layouts/term/list.html
-    - layouts/taxonomy/term.html.html
-    - layouts/taxonomy/category.html.html
-    - layouts/taxonomy/taxonomy.html.html
-    - layouts/taxonomy/list.html.html
-    - layouts/taxonomy/term.html
-    - layouts/taxonomy/category.html
-    - layouts/taxonomy/taxonomy.html
-    - layouts/taxonomy/list.html
-    - layouts/category/term.html.html
-    - layouts/category/category.html.html
-    - layouts/category/taxonomy.html.html
-    - layouts/category/list.html.html
-    - layouts/category/term.html
-    - layouts/category/category.html
-    - layouts/category/taxonomy.html
-    - layouts/category/list.html
-    - layouts/_default/term.html.html
-    - layouts/_default/category.html.html
-    - layouts/_default/taxonomy.html.html
-    - layouts/_default/list.html.html
-    - layouts/_default/term.html
-    - layouts/_default/category.html
-    - layouts/_default/taxonomy.html
-    - layouts/_default/list.html
 tpl:
   funcs:
     cast: