CCM-10850: add sidebar section ordering (#115)

* feat(navigation): add sidebar section ordering

* Introduced a new YAML file to define the order of sections in the sidebar navigation.
* Updated the page layout to utilize the defined section order, ensuring sections not listed appear at the end in alphabetical order.

* fix(page layout): remove unnecessary blank lines in page.html

Author: afernandez-nhs

docs/_data/sidebar-section-order.yml

@@ -0,0 +1,9 @@
+# Section ordering for sidebar navigation
+# Add sections in the order you want them to appear
+# Sections not listed here will appear at the end in alphabetical order
+
+sections:
+  - "By use case"
+  - "Accessing NHS Notify"
+  - "Writing a message"
+  - "Sending a message"

docs/_layouts/page.html

@@ -16,8 +16,36 @@
 assign first_level = nav_pages
 | where_exp: "item", "item.dir == first_level_dir"
 | group_by: "section"
-| sort: 'name', 'last'
 -%}
+
+{%- assign section_order = site.data.sidebar-section-order.sections -%}
+
+{%- assign ordered_sections = "" | split: "" -%}
+{%- for section_name in section_order -%}
+  {%- for section in first_level -%}
+    {%- if section.name == section_name -%}
+      {%- assign ordered_sections = ordered_sections | push: section -%}
+      {%- break -%}
+    {%- endif -%}
+  {%- endfor -%}
+{%- endfor -%}
+
+{%- comment -%}
+Add any sections not in the manual order list at the end
+{%- endcomment -%}
+{%- for section in first_level -%}
+  {%- assign found = false -%}
+  {%- for ordered_section in ordered_sections -%}
+    {%- if section.name == ordered_section.name -%}
+      {%- assign found = true -%}
+      {%- break -%}
+    {%- endif -%}
+  {%- endfor -%}
+  {%- unless found -%}
+    {%- assign ordered_sections = ordered_sections | push: section -%}
+  {%- endunless -%}
+{%- endfor -%}
+
 <div class="nhsuk-width-container">
   {%- include breadcrumb.html -%}
   <main class="nhsuk-main-wrapper--s" id="maincontent" role="main">
@@ -27,7 +55,7 @@
           <div class="nhsnotify-pane__side-bar">
             <nav class="nhsnotify-side-nav">
               <ul class="nhsuk-list nhsnotify-side-nav__list">
-                {% for section in first_level %}
+                {% for section in ordered_sections %}
                 {% if section.name != "" %}
                 <li class="nhsuk-u-font-weight-bold nhsnotify-side-nav__list-section">{{ section.name }}</li>
                 {% endif %}