From fba1b065036115cea8d067b74ee04c292db022b8 Mon Sep 17 00:00:00 2001
From: Alex Auvolat <alex@adnab.me>
Date: Mon, 31 Jan 2022 16:28:01 +0100
Subject: [PATCH] Improve sections as pages

---
 .../{quick_start.md => quick-start/_index.md} |  4 +-
 templates/documentation.html                  |  4 +-
 templates/partials/doc/page_toc.html          |  6 +-
 templates/partials/doc/pagination.html        | 63 ++++++++-----------
 4 files changed, 35 insertions(+), 42 deletions(-)
 rename content/documentation/{quick_start.md => quick-start/_index.md} (99%)

diff --git a/content/documentation/quick_start.md b/content/documentation/quick-start/_index.md
similarity index 99%
rename from content/documentation/quick_start.md
rename to content/documentation/quick-start/_index.md
index 617d1d5..91910eb 100644
--- a/content/documentation/quick_start.md
+++ b/content/documentation/quick-start/_index.md
@@ -1,6 +1,8 @@
 +++
 title = "Quick Start"
-weight = 5
+weight = 0
+sort_by = "weight"
+template = "documentation.html"
 +++
 
 
diff --git a/templates/documentation.html b/templates/documentation.html
index 154df5f..d22d9e6 100644
--- a/templates/documentation.html
+++ b/templates/documentation.html
@@ -39,7 +39,9 @@
             {% include "partials/doc/page_toc.html" %}
         </div>
         <div class="2xl:hidden">
-            {% if page.earlier or page.later or page.lighter or page.heavier %}
+            {% if page.earlier or page.later or page.lighter or page.heavier or page.pages %}
+                {% include "partials/doc/pagination.html" %}
+            {% elif page.ancestors and page.ancestors | length == 3 %}
                 {% include "partials/doc/pagination.html" %}
             {% endif %}
         </div>
diff --git a/templates/partials/doc/page_toc.html b/templates/partials/doc/page_toc.html
index 238d8c3..b874b4b 100644
--- a/templates/partials/doc/page_toc.html
+++ b/templates/partials/doc/page_toc.html
@@ -26,8 +26,10 @@
         </ol>
     {% endif %}
     <div class="bg-gray-100 rounded-bl-lg">
-        {% if page.earlier or page.later or page.lighter or page.heavier %}
+        {% if page.earlier or page.later or page.lighter or page.heavier or page.pages %}
+            {% include "partials/doc/pagination.html" %}
+        {% elif page.ancestors and page.ancestors | length == 3 %}
             {% include "partials/doc/pagination.html" %}
         {% endif %}
     </div>
-</aside>
\ No newline at end of file
+</aside>
diff --git a/templates/partials/doc/pagination.html b/templates/partials/doc/pagination.html
index 0170a77..167669e 100644
--- a/templates/partials/doc/pagination.html
+++ b/templates/partials/doc/pagination.html
@@ -7,64 +7,51 @@
                 </div>
                 <nav class="flex space-x-4 items-center justify-center p-4">
                     {% if page.earlier %}
+                      {% set left = page.earlier %}
+                    {% elif page.lighter %}
+                      {% set left = page.lighter %}
+                    {% elif page.ancestors and page.ancestors | length == 3 %}
+                      {% set left_path = page.ancestors | last %}
+                      {% set left = get_section(path=left_path) %}
+                    {% endif %}
+
+                    {% if left %}
                         <div>
                             <a class="flex items-center space-x-1 hover:text-garage-orange text-garage-gray text-sm bg-white transform hover:scale-110 transition border border-garage-orange p-2.5 rounded-full"
-                                href="{{ page.earlier.permalink }}"
-                                title="{{ page.earlier.title }}">
+                                href="{{ left.permalink }}"
+                                title="{{ left.title }}">
                                 <span class="icon">
                                     <svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24"
                                         xmlns="http://www.w3.org/2000/svg">
                                         <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
                                             d="M7 16l-4-4m0 0l4-4m-4 4h18"></path>
                                     </svg>
+                                    <span class="mt-0.5 2xl:hidden">{{ left.title }}</span>
                                 </span>
                             </a>
                         </div>
                     {% endif %}
+
                     {% if page.later %}
+                      {% set right = page.later %}
+                    {% elif page.heavier %}
+                      {% set right = page.heavier %}
+                    {% elif page.pages %}
+                      {% set right = page.pages | first %}
+                    {% endif %}
+
+                    {% if right %}
                         <div>
                             <a class="flex items-center space-x-1 hover:text-garage-orange text-garage-gray text-sm bg-white transform hover:scale-110 transition border border-garage-orange p-2.5 rounded-full"
-                                href="{{ page.later.permalink }}"
-                                title="{{ page.later.title }}">
+                                href="{{ right.permalink }}"
+                                title="{{ right.title }}">
                                 <span class="icon">
                                     <svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24"
                                         xmlns="http://www.w3.org/2000/svg">
                                         <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
                                             d="M17 8l4 4m0 0l-4 4m4-4H3"></path>
                                     </svg>
-                                </span>
-                            </a>
-                        </div>
-                    {% endif %}
-                
-                    {% if page.lighter %}
-                        <div>
-                            <a class="flex items-center space-x-1 hover:text-garage-orange text-garage-gray text-sm bg-white transform hover:scale-110 transition border border-garage-orange p-2.5 rounded-full"
-                                href="{{ page.lighter.permalink }}"
-                                title="{{ page.lighter.title }}">
-                                <span class="icon flex space-x-1.5 2xl:inline 2xl:space-x-0">
-                                    <svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24"
-                                        xmlns="http://www.w3.org/2000/svg">
-                                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
-                                            d="M7 16l-4-4m0 0l4-4m-4 4h18"></path>
-                                    </svg>
-                                    <span class="mt-0.5 2xl:hidden">{{ page.lighter.title }}</span>
-                                </span>
-                            </a>
-                        </div>
-                    {% endif %}
-                    {% if page.heavier %}
-                        <div>
-                            <a class="flex items-center space-x-1 hover:text-garage-orange text-garage-gray text-sm bg-white transform hover:scale-110 transition border border-garage-orange p-2.5 rounded-full"
-                                href="{{ page.heavier.permalink }}"
-                                title="{{ page.heavier.title }}">
-                                <span class="icon flex space-x-1.5 2xl:inline 2xl:space-x-0">
-                                    <span class="mt-0.5 2xl:hidden">{{ page.heavier.title }}</span>
-                                    <svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24"
-                                        xmlns="http://www.w3.org/2000/svg">
-                                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
-                                            d="M17 8l4 4m0 0l-4 4m4-4H3"></path>
-                                    </svg>
+                                    <span class="mt-0.5 2xl:hidden">{{ right.title }}</span>
                                 </span>
                             </a>
                         </div>
@@ -73,4 +60,4 @@
             </div>
         </div>
     </div>
-</section>
\ No newline at end of file
+</section>