Merge pull request #443 from pdmosses/nav-exclude

Limit the effect of `nav_exclude` to the main navigation

_includes/nav.html

@@ -1,6 +1,5 @@
 <ul class="nav-list">
-  {%- assign included_pages = include.pages
-        | where_exp:"item", "item.nav_exclude != true"
+  {%- assign titled_pages = include.pages
         | where_exp:"item", "item.title != nil" -%}
 
   {%- comment -%}
@@ -15,9 +14,9 @@
     The case-sensitivity of string sorting is determined by `site.nav_sort`.
   {%- endcomment -%}
   
-  {%- assign string_ordered_pages = included_pages
+  {%- assign string_ordered_pages = titled_pages
         | where_exp:"item", "item.nav_order == nil" -%}
-  {%- assign nav_ordered_pages = included_pages
+  {%- assign nav_ordered_pages = titled_pages
         | where_exp:"item", "item.nav_order != nil"  -%}
 
   {%- comment -%}
@@ -60,10 +59,8 @@
   
   {%- for node in pages_list -%}
     {%- if node.parent == nil -%}
+      {%- unless node.nav_exclude -%}
       <li class="nav-list-item{% if page.url == node.url or page.parent == node.title or page.grand_parent == node.title %} active{% endif %}">
-        {%- if page.parent == node.title or page.grand_parent == node.title -%}
-          {%- assign first_level_url = node.url | absolute_url -%}
-        {%- endif -%}
         {%- if node.has_children -%}
           <a href="#" class="nav-list-expander"><svg viewBox="0 0 24 24"><use xlink:href="#svg-arrow-right"></use></svg></a>
         {%- endif -%}
@@ -72,10 +69,8 @@
           {%- assign children_list = pages_list | where: "parent", node.title -%}
           <ul class="nav-list ">
           {%- for child in children_list -%}
+            {%- unless child.nav_exclude -%}
             <li class="nav-list-item {% if page.url == child.url or page.parent == child.title %} active{% endif %}">
-              {%- if page.url == child.url or page.parent == child.title -%}
-                {%- assign second_level_url = child.url | absolute_url -%}
-              {%- endif -%}
               {%- if child.has_children -%}
                 <a href="#" class="nav-list-expander"><svg viewBox="0 0 24 24"><use xlink:href="#svg-arrow-right"></use></svg></a>
               {%- endif -%}
@@ -84,17 +79,21 @@
                 {%- assign grand_children_list = pages_list | where: "parent", child.title | where: "grand_parent", node.title -%}
                 <ul class="nav-list">
                 {%- for grand_child in grand_children_list -%}
+                  {%- unless grand_child.nav_exclude -%}
                   <li class="nav-list-item {% if page.url == grand_child.url %} active{% endif %}">
                     <a href="{{ grand_child.url | absolute_url }}" class="nav-list-link{% if page.url == grand_child.url %} active{% endif %}">{{ grand_child.title }}</a>
                   </li>
+                  {%- endunless -%}
                 {%- endfor -%}
                 </ul>
               {%- endif -%}
             </li>
+            {%- endunless -%}
           {%- endfor -%}
           </ul>
         {%- endif -%}
       </li>
+      {%- endunless -%}
     {%- endif -%}
   {%- endfor -%}
 </ul>

_layouts/default.html

@@ -101,6 +101,21 @@ layout: table_wrappers
     <div id="main-content-wrap" class="main-content-wrap">
       {% unless page.url == "/" %}
         {% if page.parent %}
+          {%- for node in pages_list -%}
+            {%- if node.parent == nil -%}
+              {%- if page.parent == node.title or page.grand_parent == node.title -%}
+                {%- assign first_level_url = node.url | absolute_url -%}
+              {%- endif -%}
+              {%- if node.has_children -%}
+                {%- assign children_list = pages_list | where: "parent", node.title -%}
+                {%- for child in children_list -%}
+                  {%- if page.url == child.url or page.parent == child.title -%}
+                    {%- assign second_level_url = child.url | absolute_url -%}
+                  {%- endif -%}
+                {%- endfor -%}
+              {%- endif -%}
+            {%- endif -%}
+          {%- endfor -%}
           <nav aria-label="Breadcrumb" class="breadcrumb-nav">
             <ol class="breadcrumb-nav-list">
               {% if page.grand_parent %}

docs/navigation-structure.md

@@ -66,7 +66,9 @@ nav_exclude: true
 ---
 ```
 
-Pages with no `title` are automatically excluded from the navigation.
+The `nav_exclude` parameter does not affect the [auto-generating list of child pages](#auto-generating-table-of-contents), which you can use to access pages excluded from the main navigation.
+
+Pages with no `title` are automatically excluded from the navigation. 
 
 ---
 

docs/tests/navigation/disambiguation/a.md

@@ -1,6 +1,6 @@
 ---
 layout: default
-title: A
+title: Tests for disambiguation A
 has_children: true
 ---
 
@@ -9,6 +9,6 @@ has_children: true
 A top-level page
 
 ```yaml
-title: A
+title: Tests for disambiguation A
 has_children: true
 ```

docs/tests/navigation/disambiguation/b.md

@@ -1,6 +1,6 @@
 ---
 layout: default
-title: B
+title: Tests for disambiguation B
 has_children: true
 ---
 
@@ -9,6 +9,6 @@ has_children: true
 A top-level page
 
 ```yaml
-title: B
+title: Tests for disambiguation B
 has_children: true
 ```

docs/tests/navigation/disambiguation/ca.md

@@ -0,0 +1,16 @@
+---
+layout: default
+title: Tests for disambiguation C
+parent: Tests for disambiguation A
+has_children: true
+---
+
+# C
+
+A child of page A, and parent of page D
+
+```yaml
+title: Tests for disambiguation C
+parent: Tests for disambiguation A
+has_children: true
+```

docs/tests/navigation/disambiguation/cb.md

@@ -0,0 +1,16 @@
+---
+layout: default
+title: Tests for disambiguation C
+parent: Tests for disambiguation B
+has_children: true
+---
+
+# C
+
+A child of page B, and parent of page D
+
+```yaml
+title: Tests for disambiguation C
+parent: Tests for disambiguation B
+has_children: true
+```

docs/tests/navigation/disambiguation/dca.md

@@ -0,0 +1,16 @@
+---
+layout: default
+title: Tests for disambiguation D
+parent: Tests for disambiguation C
+grand_parent: Tests for disambiguation A
+---
+
+# D
+
+A grandchild of page A
+
+```yaml
+title: Tests for disambiguation D
+parent: Tests for disambiguation C
+grand_parent: Tests for disambiguation A
+```

docs/tests/navigation/disambiguation/dcb.md

@@ -0,0 +1,16 @@
+---
+layout: default
+title: Tests for disambiguation D
+parent: Tests for disambiguation C
+grand_parent: Tests for disambiguation B
+---
+
+# D
+
+A grandchild of page B
+
+```yaml
+title: Tests for disambiguation D
+parent: Tests for disambiguation C
+grand_parent: Tests for disambiguation B
+```

docs/tests/navigation/disambiguation/index.md

@@ -0,0 +1,14 @@
+---
+layout: default
+title: Disambiguation 
+parent: Navigation
+grand_parent: Tests
+---
+
+# Disambiguation
+
+When different pages with children have the same title, referencing the relevant grandparent in the children disambiguates which page is intended.
+
+- [Page A](a/) has a child [page with title C](ca/), and a grandchild [page with title D](dca/).
+- [Page B](b/) has a child [page with title C](cb/), and a grandchild [page with title D](dcb/).
+- The grandchild pages specify their parent and grandparent pages, so there is no ambiguity.

docs/tests/navigation/exclude/excluded-child.md

@@ -1,15 +0,0 @@
----
-layout: default
-title: Excluded Child
-parent: Not Excluded
-nav_exclude: true
----
-# Excluded Child
-
-This child page is explicitly excluded, and should not appear in the navigation.
-
-```yaml
-title: Excluded Child
-parent: Not Excluded
-nav_exclude: true
-```

docs/tests/navigation/exclude/excluded-grandchild.md

@@ -1,17 +0,0 @@
----
-layout: default
-title: Excluded Grandchild
-parent: Non-excluded Child
-grand_parent: Non-excluded
-nav_exclude: true
----
-# Excluded Grandchild
-
-This grandchild page is explicitly excluded, and should not appear in the navigation.
-
-```yaml
-title: Excluded Grandchild
-parent: Non-excluded Child
-grand_parent: Non-excluded
-nav_exclude: true
-```

docs/tests/navigation/exclude/excluded.md

@@ -1,15 +0,0 @@
----
-layout: default
-title: Excluded
-has_children: true
-nav_exclude: true
----
-# Excluded
-
-This top-level page is explicitly excluded, and should not appear in the navigation. Any child pages are implicitly excluded.
-
-```yaml
-title: Excluded
-has_children: true
-nav_exclude: true
-```

docs/tests/navigation/exclude/non-excluded-child-of-excluded.md

@@ -1,15 +0,0 @@
----
-layout: default
-title: Non-excluded Child of Excluded
-parent: Excluded
-nav_exclude: false
----
-# Non-excluded Child of Excluded
-
-This child page is explicitly not excluded, but its parent page is excluded, so it should not appear in the navigation.
-
-```yaml
-title: Non-excluded Child of Excluded
-parent: Excluded
-nav_exclude: false
-```

docs/tests/navigation/exclude/non-excluded-child.md

@@ -1,16 +0,0 @@
----
-layout: default
-title: Non-excluded Child
-parent: Non-excluded
-has_children: true
-nav_exclude: false
----
-# Non-excluded Child
-
-This child page is explicitly not excluded, and should appear in the navigation.
-
-```yaml
-title: Non-excluded Child
-parent: Non-excluded
-nav_exclude: false
-```

docs/tests/navigation/exclude/non-excluded-grandchild-of-excluded.md

@@ -1,17 +0,0 @@
----
-layout: default
-title: Non-excluded Grandchild of Excluded
-parent: Non-excluded Child
-grand_parent: Excluded
-nav_exclude: false
----
-# Non-excluded Grandchild of Excluded
-
-This grandchild page is explicitly not excluded, and neither is its parent page; but its grandparent page is excluded, so it should not appear in the navigation.
-
-```yaml
-title: Non-excluded Grandchild of Excluded
-parent: Non-excluded Child
-grand_parent: Excluded
-nav_exclude: false
-```

docs/tests/navigation/exclude/non-excluded-grandchild.md

@@ -1,17 +0,0 @@
----
-layout: default
-title: Non-excluded Grandchild
-parent: Non-excluded Child
-grand_parent: Non-excluded
-nav_exclude: false
----
-# Non-excluded Grandchild
-
-This grandchild page is explicitly not excluded, and neither is its parent page nor its grandparent page, so it should appear in the navigation.
-
-```yaml
-title: Non-excluded Grandchild of Excluded
-parent: Non-excluded Child
-grand_parent: Excluded
-nav_exclude: false
-```

docs/tests/navigation/exclude/non-excluded.md

@@ -1,14 +0,0 @@
----
-layout: default
-title: Non-excluded
-has_children: true
-nav_exclude: false
----
-# Non-excluded
-
-This top-level page is explicitly not excluded, and should appear in the navigation.
-
-```yaml
-title: Non-excluded
-nav_exclude: false
-```

docs/tests/navigation/exclusion/0.md

@@ -0,0 +1,13 @@
+---
+layout: default
+title: Tests for exclusion 0
+has_children: true
+nav_exclude: true
+---
+# Tests for exclusion 0
+
+```yaml
+title: Tests for exclusion 0
+has_children: true
+nav_exclude: true
+```

docs/tests/navigation/exclusion/00.md

@@ -0,0 +1,15 @@
+---
+layout: default
+title: Tests for exclusion 00
+parent: Tests for exclusion 0
+has_children: true
+nav_exclude: true
+---
+# Tests for exclusion 00
+
+```yaml
+title: Tests for exclusion 00
+parent: Tests for exclusion 0
+has_children: true
+nav_exclude: true
+```

docs/tests/navigation/exclusion/000.md

@@ -0,0 +1,17 @@
+---
+layout: default
+title: Tests for exclusion 000
+parent: Tests for exclusion 00
+grand_parent: Tests for exclusion 0
+has_children: false
+nav_exclude: true
+---
+# Tests for exclusion 000
+
+```yaml
+title: Tests for exclusion 000
+parent: Tests for exclusion 00
+grand_parent: Tests for exclusion 0
+has_children: false
+nav_exclude: true
+```

docs/tests/navigation/exclusion/001.md

@@ -0,0 +1,17 @@
+---
+layout: default
+title: Tests for exclusion 001
+parent: Tests for exclusion 00
+grand_parent: Tests for exclusion 0
+has_children: false
+nav_exclude: false
+---
+# Tests for exclusion 001
+
+```yaml
+title: Tests for exclusion 001
+parent: Tests for exclusion 00
+grand_parent: Tests for exclusion 0
+has_children: false
+nav_exclude: false
+```

docs/tests/navigation/exclusion/01.md

@@ -0,0 +1,15 @@
+---
+layout: default
+title: Tests for exclusion 01
+parent: Tests for exclusion 0
+has_children: true
+nav_exclude: false
+---
+# Tests for exclusion 01
+
+```yaml
+title: Tests for exclusion 01
+parent: Tests for exclusion 0
+has_children: true
+nav_exclude: false
+```

docs/tests/navigation/exclusion/010.md

@@ -0,0 +1,17 @@
+---
+layout: default
+title: Tests for exclusion 010
+parent: Tests for exclusion 01
+grand_parent: Tests for exclusion 0
+has_children: false
+nav_exclude: true
+---
+# Tests for exclusion 010
+
+```yaml
+title: Tests for exclusion 010
+parent: Tests for exclusion 01
+grand_parent: Tests for exclusion 0
+has_children: false
+nav_exclude: true
+```

docs/tests/navigation/exclusion/011.md

@@ -0,0 +1,17 @@
+---
+layout: default
+title: Tests for exclusion 011
+parent: Tests for exclusion 01
+grand_parent: Tests for exclusion 0
+has_children: false
+nav_exclude: false
+---
+# Tests for exclusion 011
+
+```yaml
+title: Tests for exclusion 011
+parent: Tests for exclusion 01
+grand_parent: Tests for exclusion 0
+has_children: false
+nav_exclude: false
+```

docs/tests/navigation/exclusion/1.md

@@ -0,0 +1,13 @@
+---
+layout: default
+title: Tests for exclusion 1
+has_children: true
+nav_exclude: false
+---
+# Tests for exclusion 1
+
+```yaml
+title: Tests for exclusion 1
+has_children: true
+nav_exclude: false
+```

docs/tests/navigation/exclusion/10.md

@@ -0,0 +1,15 @@
+---
+layout: default
+title: Tests for exclusion 10
+parent: Tests for exclusion 1
+has_children: true
+nav_exclude: true
+---
+# Tests for exclusion 10
+
+```yaml
+title: Tests for exclusion 10
+parent: Tests for exclusion 1
+has_children: true
+nav_exclude: true
+```

docs/tests/navigation/exclusion/100.md

@@ -0,0 +1,17 @@
+---
+layout: default
+title: Tests for exclusion 100
+parent: Tests for exclusion 10
+grand_parent: Tests for exclusion 1
+has_children: false
+nav_exclude: true
+---
+# Tests for exclusion 100
+
+```yaml
+title: Tests for exclusion 100
+parent: Tests for exclusion 10
+grand_parent: Tests for exclusion 1
+has_children: false
+nav_exclude: true
+```

docs/tests/navigation/exclusion/101.md

@@ -0,0 +1,17 @@
+---
+layout: default
+title: Tests for exclusion 101
+parent: Tests for exclusion 10
+grand_parent: Tests for exclusion 1
+has_children: false
+nav_exclude: false
+---
+# Tests for exclusion 101
+
+```yaml
+title: Tests for exclusion 101
+parent: Tests for exclusion 10
+grand_parent: Tests for exclusion 1
+has_children: false
+nav_exclude: false
+```

docs/tests/navigation/exclusion/11.md

@@ -0,0 +1,15 @@
+---
+layout: default
+title: Tests for exclusion 11
+parent: Tests for exclusion 1
+has_children: true
+nav_exclude: false
+---
+# Tests for exclusion 11
+
+```yaml
+title: Tests for exclusion 11
+parent: Tests for exclusion 1
+has_children: true
+nav_exclude: false
+```

docs/tests/navigation/exclusion/110.md

@@ -0,0 +1,17 @@
+---
+layout: default
+title: Tests for exclusion 110
+parent: Tests for exclusion 11
+grand_parent: Tests for exclusion 1
+has_children: false
+nav_exclude: true
+---
+# Tests for exclusion 110
+
+```yaml
+title: Tests for exclusion 110
+parent: Tests for exclusion 11
+grand_parent: Tests for exclusion 1
+has_children: false
+nav_exclude: true
+```

docs/tests/navigation/exclusion/111.md

@@ -0,0 +1,17 @@
+---
+layout: default
+title: Tests for exclusion 111
+parent: Tests for exclusion 11
+grand_parent: Tests for exclusion 1
+has_children: false
+nav_exclude: false
+---
+# Tests for exclusion 111
+
+```yaml
+title: Tests for exclusion 111
+parent: Tests for exclusion 11
+grand_parent: Tests for exclusion 1
+has_children: false
+nav_exclude: false
+```

docs/tests/navigation/exclusion/excluded.md

@@ -0,0 +1,11 @@
+---
+layout: default
+nav_exclude: true
+---
+# Tests for exclusion untitled and excluded
+
+This page does not have a `title`, and it is explicitly excluded from the navigation
+
+```yaml
+nav_exclude: true
+```

docs/tests/navigation/exclusion/index.md

@@ -0,0 +1,36 @@
+---
+layout: default
+title: Exclusion
+parent: Navigation
+grand_parent: Tests
+---
+
+# Exclusion
+
+Pages excluded from the main navigation can have parents and children. Navigation to and between excluded pages can be supported by the auto-generating list of child pages inserted at the bottom of each page, and by links to parents in the breadcrumbs at the top of each page.
+
+The following tests cover all combinations of excluded and included pages for the top level, child pages, and grandchild pages. The last binary digit in a page title indicates whether the page is included (1) or excluded (0); preceding digits refer to its parent and grandparent.
+
+## Included in main navigation
+
+- [Tests for exclusion 1](1/)
+- [Tests for exclusion 11](11/)
+- [Tests for exclusion 111](111/)
+
+## Included only in child navigation
+
+- [Tests for exclusion 110](110/)
+- [Tests for exclusion 10](10/)
+- [Tests for exclusion 101](101/)
+- [Tests for exclusion 100](100/)
+- [Tests for exclusion 01](01/)
+- [Tests for exclusion 011](011/)
+- [Tests for exclusion 010](010/)
+- [Tests for exclusion 00](00/)
+- [Tests for exclusion 001](001/)
+- [Tests for exclusion 000](000/)
+
+## Not included in main or child navigation
+
+- [Tests for exclusion 0](0/)
+- ["Untitled"](untitled/)

docs/tests/navigation/exclusion/untitled.md

@@ -1,6 +1,6 @@
 ---
 layout: default
 ---
-# Untitled
+# Tests for exclusion untitled
 
 This page does not have a `title`, and it is excluded from the navigation -- unless it is located in a Jekyll collection (which provides default titles). To exclude a title-less page from the navigation, regardless of whether it is located in a collection, set `nav_exclude: true`.

docs/tests/navigation/grandparent/ca.md

@@ -1,16 +0,0 @@
----
-layout: default
-title: C
-parent: A
-has_children: true
----
-
-# C
-
-A child of page A, and parent of page D
-
-```yaml
-title: C
-parent: A
-has_children: true
-```

docs/tests/navigation/grandparent/cb.md

@@ -1,16 +0,0 @@
----
-layout: default
-title: C
-parent: B
-has_children: true
----
-
-# C
-
-A child of page B, and parent of page D
-
-```yaml
-title: C
-parent: B
-has_children: true
-```

docs/tests/navigation/grandparent/dca.md

@@ -1,16 +0,0 @@
----
-layout: default
-title: D
-parent: C
-grand_parent: A
----
-
-# D
-
-A grandchild of page A
-
-```yaml
-title: D
-parent: C
-grand_parent: A
-```

docs/tests/navigation/grandparent/dcb.md

@@ -1,16 +0,0 @@
----
-layout: default
-title: D
-parent: C
-grand_parent: B
----
-
-# D
-
-A grandchild of page B
-
-```yaml
-title: D
-parent: C
-grand_parent: B
-```

docs/tests/navigation/index.md

@@ -2,27 +2,7 @@
 layout: default
 title: Navigation
 parent: Tests
+has_children: true
 ---
 
 # Navigation
-
-## Parent page disambiguation
-
-- [Page A](grandparent/a/) has a child [page with title C](grandparent/ca/), and a grandchild [page with title D](grandparent/dca/).
-- [Page B](grandparent/b/) has a child [page with title C](grandparent/cb/), and a grandchild [page with title D](grandparent/dcb/).
-- The grandchild pages specify their parent and grandparent pages, so there is no ambiguity.
-
-## Page exclusion
-
-- An [untitled page](exclude/untitled/) is excluded from the navigation.
-- An excluded [top level page](exclude/excluded/), [child page](exclude/excluded-child/), or [grandchild page](exclude/excluded-grandchild/) does not appear.
-- A non-excluded [top level page](exclude/non-excluded/) appears; and a non-excluded [child page](exclude/non-excluded-child/) or [grandchild page](exclude/non-excluded-grandchild/) appears if its parent appears.
-- A non-excluded child page or grandchild page does not appear if its parent is excluded.
-
-## Page order
-
-- [Default](order/default/), using `title` instead of `nav_order` fields.
-- [Strings](order/strings/), lexicographically ordered, possibly case-insensitively.
-- [Integers](order/integers/), numerically ordered.
-- [Floats](order/floats/), numerically ordered.
-- [Mixture](order/mixture/), with numbers before strings.

docs/tests/navigation/order/default/10.md

@@ -2,7 +2,7 @@
 layout: default
 title: "10"
 parent: Default
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 10
@@ -10,5 +10,5 @@ grand_parent: Order
 ```yaml
 title: "10"
 parent: Default
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/default/2.md

@@ -2,7 +2,7 @@
 layout: default
 title: "2"
 parent: Default
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 2
@@ -10,5 +10,5 @@ grand_parent: Order
 ```yaml
 title: "2"
 parent: Default
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/default/a.md

@@ -2,7 +2,7 @@
 layout: default
 title: A
 parent: Default
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # A
@@ -10,5 +10,5 @@ grand_parent: Order
 ```yaml
 title: A
 parent: Default
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/default/aa-lower.md

@@ -2,7 +2,7 @@
 layout: default
 title: aa
 parent: Default
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # aa
@@ -10,5 +10,5 @@ grand_parent: Order
 ```yaml
 title: aa
 parent: Default
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/default/aa.md

@@ -2,7 +2,7 @@
 layout: default
 title: Aa
 parent: Default
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # Aa
@@ -10,5 +10,5 @@ grand_parent: Order
 ```yaml
 title: Aa
 parent: Default
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/default/index.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Default
-parent: Order
+parent: Tests for order
 nav_order: 1
 has_children: true
 ---

docs/tests/navigation/order/floats/-1.1.md

@@ -3,7 +3,7 @@ layout: default
 title: "-1.1"
 nav_order: -1.1
 parent: Floats
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # -1.1
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "-1.1"
 nav_order: -1.1
 parent: Floats
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/floats/0.0.md

@@ -3,7 +3,7 @@ layout: default
 title: "0.0"
 nav_order: 0.0
 parent: Floats
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 0.0
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "0.0"
 nav_order: 0.0
 parent: Floats
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/floats/10.0.md

@@ -3,7 +3,7 @@ layout: default
 title: "10.0"
 nav_order: 10.0
 parent: Floats
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 10.0
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "10.0"
 nav_order: 10.0
 parent: Floats
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/floats/2.2222.md

@@ -3,7 +3,7 @@ layout: default
 title: "2.2222"
 nav_order: 2.2222
 parent: Floats
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 2.2222
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "2.2222"
 nav_order: 2.2222
 parent: Floats
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/floats/index.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Floats
-parent: Order
+parent: Tests for order
 nav_order: 4
 has_children: true
 ---

docs/tests/navigation/order/index.md

@@ -1,8 +1,16 @@
 ---
 layout: default
 title: Order
-has_children: true
-nav_order: 110
+parent: Navigation
+grand_parent: Tests
 ---
 
 # Order
+
+The value of `nav_order` can be numbers (integers, floats) and/or strings. The following tests illustrate their effects.
+
+- [Default](default/), using `title` instead of `nav_order` fields.
+- [Strings](strings/), lexicographically ordered, possibly case-insensitively.
+- [Integers](integers/), numerically ordered.
+- [Floats](floats/), numerically ordered.
+- [Mixture](mixture/), with numbers before strings.

docs/tests/navigation/order/integers/-1.md

@@ -3,7 +3,7 @@ layout: default
 title: "-1"
 nav_order: -1
 parent: Integers
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # -1
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "-1"
 nav_order: -1
 parent: Integers
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/integers/0.md

@@ -3,7 +3,7 @@ layout: default
 title: "0"
 nav_order: 0
 parent: Integers
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 0
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "0"
 nav_order: 0
 parent: Integers
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/integers/10.md

@@ -3,7 +3,7 @@ layout: default
 title: "10"
 nav_order: 10
 parent: Integers
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 10
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "10"
 nav_order: 10
 parent: Integers
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/integers/2.md

@@ -3,7 +3,7 @@ layout: default
 title: "2"
 nav_order: 2
 parent: Integers
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 2
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "2"
 nav_order: 2
 parent: Integers
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/integers/index.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Integers
-parent: Order
+parent: Tests for order
 nav_order: 3
 has_children: true
 ---

docs/tests/navigation/order/mixture/-1.1.md

@@ -3,7 +3,7 @@ layout: default
 title: "-1.1"
 nav_order: -1.1
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # -1.1
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "-1.1"
 nav_order: -1.1
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/mixture/-1.md

@@ -3,7 +3,7 @@ layout: default
 title: "-1"
 nav_order: -1
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # -1
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "-1"
 nav_order: -1
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/mixture/0.0.md

@@ -3,7 +3,7 @@ layout: default
 title: "0.0"
 nav_order: 0.0
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 0.0
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "0.0"
 nav_order: 0.0
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/mixture/0.md

@@ -3,7 +3,7 @@ layout: default
 title: "0"
 nav_order: 0
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 0
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "0"
 nav_order: 0
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/mixture/10.0.md

@@ -3,7 +3,7 @@ layout: default
 title: "10.0"
 nav_order: 10.0
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 10.0
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "10.0"
 nav_order: 10.0
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/mixture/10.md

@@ -2,7 +2,7 @@
 layout: default
 title: "10"
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 10
@@ -10,5 +10,5 @@ grand_parent: Order
 ```yaml
 title: "10"
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/mixture/2.2222.md

@@ -3,7 +3,7 @@ layout: default
 title: "2.2222"
 nav_order: 2.2222
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 2.2222
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "2.2222"
 nav_order: 2.2222
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/mixture/2.md

@@ -2,7 +2,7 @@
 layout: default
 title: "2"
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 2
@@ -10,5 +10,5 @@ grand_parent: Order
 ```yaml
 title: "2"
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/mixture/a.md

@@ -2,7 +2,7 @@
 layout: default
 title: A
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # A
@@ -10,5 +10,5 @@ grand_parent: Order
 ```yaml
 title: A
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/mixture/aa-lower.md

@@ -3,7 +3,7 @@ layout: default
 title: aa
 nav_order: "aa"
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # aa
@@ -12,5 +12,5 @@ grand_parent: Order
 title: aa
 nav_order: "aa"
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/mixture/aa.md

@@ -3,7 +3,7 @@ layout: default
 title: Aa
 nav_order: "Aa"
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # Aa
@@ -12,5 +12,5 @@ grand_parent: Order
 title: Aa
 nav_order: "Aa"
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/mixture/index.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Mixture
-parent: Order
+parent: Tests for order
 nav_order: 5
 has_children: true
 ---

docs/tests/navigation/order/order.md

@@ -0,0 +1,7 @@
+---
+layout: default
+title: Tests for order
+has_children: true
+---
+
+# Order

docs/tests/navigation/order/strings/10.md

@@ -3,7 +3,7 @@ layout: default
 title: "10"
 nav_order: "10"
 parent: Strings
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 10
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "10"
 nav_order: "10"
 parent: Strings
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/strings/2.md

@@ -3,7 +3,7 @@ layout: default
 title: "2"
 nav_order: "2"
 parent: Strings
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 2
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "2"
 nav_order: "2"
 parent: Strings
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/strings/a.md

@@ -3,7 +3,7 @@ layout: default
 title: A
 nav_order: A
 parent: Strings
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # A
@@ -12,5 +12,5 @@ grand_parent: Order
 title: A
 nav_order: A
 parent: Strings
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/strings/aa-lower.md

@@ -3,7 +3,7 @@ layout: default
 title: aa
 nav_order: "aa"
 parent: Strings
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # aa
@@ -12,5 +12,5 @@ grand_parent: Order
 title: aa
 nav_order: "aa"
 parent: Strings
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/strings/aa.md

@@ -3,7 +3,7 @@ layout: default
 title: Aa
 nav_order: "Aa"
 parent: Strings
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # Aa
@@ -12,5 +12,5 @@ grand_parent: Order
 title: Aa
 nav_order: "Aa"
 parent: Strings
-grand_parent: Order
+grand_parent: Tests for order
 ```

docs/tests/navigation/order/strings/index.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Strings
-parent: Order
+parent: Tests for order
 nav_order: 2
 has_children: true
 ---