diff --git a/_includes/footer.html b/_includes/footer.html
index e277f0f..2a6a0b7 100644
--- a/_includes/footer.html
+++ b/_includes/footer.html
@@ -1,62 +1,68 @@
-{%- assign col = site.collections | where: "label", page.collection | first -%}
-{%- if page.changelog -%}
- {%- assign changelogpage=site.documents | where:"ref", page.changelog | first -%}
- {%- unless changelogpage.ref -%}
- {%- assign changelogpage=site.pages | where:"ref", page.changelog | first -%}
- {%- endunless -%}
- {% assign changelogpageurl = changelogpage.url | relative_url %}
- {%- capture changelogtext -%}
- {%- include_cached t.html t="Changelog" lang=page.lang -%}
+{%- comment -%}
+ Find the page language.
+{%- endcomment -%}
+{%- assign page_lang = 'en' -%}
+{%- if page.lang -%}
+ {%- assign page_lang = page.lang -%}
+{%- endif -%}
+{%- comment -%}
+ Get the changelog page:
+ - Use the `custom_changelog` value when existing. Also supports the legacy `changelog` frontmatter variable for now.
+ - Else, append "changelog/` to the page `ref` or `url` to check if it matches a page.
+{%- endcomment -%}
+{%- if page.custom_changelog -%}
+ {%- assign changelog_url = page.custom_changelog -%}
+{%- elsif page.changelog -%}
+ {%- assign changelog_url = page.changelog -%}
+{%- elsif page.ref -%}
+ {%- assign changelog_url = page.ref | append: "changelog/" -%}
+{%- else -%}
+ {%- assign changelog_url = page.url | append: "changelog/" -%}
+{%- endif -%}
+{%- assign all_docs = site.documents | concat: site.pages -%}
+{%- assign changelog_page = all_docs | where: "url", changelog_url | first -%}
+{%- comment -%}
+ Build the link to the Changelog
+{%- endcomment -%}
+{%- if changelog_page -%}
+ {%- capture changelog -%}
+
{%- include_cached t.html t="Latest changes" lang=page_lang -%}
{%- endcapture -%}
- {%- assign changelog = '
' | append: changelogtext | append: '' -%}
{%- else -%}
{%- assign changelog = "" -%}
{%- endif -%}
+{%- comment -%}
+ Build the link to the Acknowledgements page
+{%- endcomment -%}
{%- if page.acknowledgements -%}
- {%- assign acknowledgementspage=site.documents | where:"ref", page.acknowledgements | first -%}
- {%- unless acknowledgementspage.ref -%}
- {%- assign acknowledgementspage=site.pages | where:"ref", page.acknowledgements | first -%}
- {%- endunless -%}
- {% assign acknowledgementspageurl = acknowledgementspage.url | relative_url %}
- {%- capture acknowledgementstext -%}
- {%- include_cached t.html t="Acknowledgements" lang=page.lang -%}
+ {%- assign acknowledgements_page = all_docs | where:"ref", page.acknowledgements | first -%}
+ {%- capture acknowledgements -%}
+
{%- include_cached t.html t="Acknowledgements" lang=page_lang -%}
{%- endcapture -%}
- {%- assign acknowledgements = '
' | append: acknowledgementstext | append: '' -%}
{%- else -%}
{%- assign acknowledgements = "" -%}
{%- endif -%}
-{% if col.footer %}
+{%- comment -%}
+ COLLECTION PAGE FOOTER
+ For collections, we use the collection footer when set.
+{%- endcomment -%}
+{%- assign col = site.collections | where: "label", page.collection | first -%}
+{%- if col.footer -%}
-{% else %}
- {% if page.footer %}
-
- {% endif %}
-{% endif %}
-
-{% comment %}
-
+{%- comment -%}
META FOOTER
-
- For the tutorials, we used data to form the footer. This way of constructing the footer is now called “metafooter” and needs to be enabled by setting `metafooter: true` in the frontmatter. Do NOT use with raw html `footer: ` frontmatter.
-
-{% endcomment %}
-{% if page.metafooter %}
+ For the tutorials, we use multiple frontmatter variables to form the page footer. This way of constructing the footer is called “metafooter” and needs to be enabled by setting `metafooter: true` in the frontmatter.
+ Do NOT use with raw html `footer: ` frontmatter.
+{%- endcomment -%}
+{%- elsif page.metafooter -%}