First version of a version picker for Bevy Book

Added to the bottom of the Book section list on the left. - Reads versions from `content/learn/book/versions.toml` so we can start working on the book for a new version and have the content in `main` without neccessarly publishing it on the website
bevyengine · Apr 20, 2023 · af2dac4 · af2dac4
1 parent b81dc3c
commit af2dac4
Show file tree

Hide file tree

Showing 3 changed files with 44 additions and 0 deletions.
diff --git a/content/learn/book/versions.toml b/content/learn/book/versions.toml
@@ -0,0 +1,7 @@
+# [[versions]]
+# title = "v0.12.0"
+# path = "/learn/book/v0.12.0"
+
+[[versions]]
+title = "v0.11.0"
+path = "/learn/book/v0.11.0"
diff --git a/templates/book-section.html b/templates/book-section.html
@@ -13,6 +13,7 @@
 
 {% block page_menu %}
     {{book_macros::book_menu(prefix="page-menu", root=get_section(path="learn/book/_index.md"))}}
+    {{book_macros::version_menu()}}
 {% endblock %}
 
 {% block page_content %}

diff --git a/templates/macros/book.html b/templates/macros/book.html
@@ -41,3 +41,39 @@
         {% endfor %}
     </ul>
 {% endmacro %}
+
+{% macro version_menu() %}
+    {% set book_versions = load_data(path="content/learn/book/versions.toml") %}
+    {% set prefix = 'versions-menu' %}
+    <ul class="tree-menu">
+        {% set id = prefix ~ '-' ~ 'root-version' | slugify %}
+        {% set class = "tree-menu__item" %}
+        {% set label_class = "tree-menu__label" %}
+
+        {% set label_class = label_class ~ " tree-menu__label--with-chevron" %}
+        <input id="{{id}}" class="tree-menu__state" type="checkbox" {% if is_in_branch %}checked{% endif %}>
+
+        <li class="{{class}}">
+            <div class="{{label_class}}">
+                <a class="tree-menu__link" href="#">Versions</a>
+                {% if section.subsections %}
+                <label class="tree-menu__toggle" for="{{id}}">
+                    <img class="tree-menu__chevron" src="/assets/icon-chevron-down.svg">
+                </label>
+                {% endif %}
+            </div>
+            <ul class="tree-menu">
+                {% for version in book_versions.versions %}
+                        {% set version_id = prefix ~ '-' ~ version.path | slugify %}
+                        {% set version_class = "tree-menu__item" %}
+                        {% set version_label_class = "tree-menu__label" %}
+                        <li class="{{version_class}}">
+                            <div class="{{version_label_class}}">
+                                <a class="tree-menu__link" href="{{version.path}}">{{ version.title }}</a>
+                            </div>
+                        </li>
+                    {% endfor %}
+                </ul>
+            </li>
+    </ul>
+{% endmacro %}