diff --git a/config/_default/hugo.toml b/config/_default/hugo.toml
index 65ddad68..7aa6ee0e 100644
--- a/config/_default/hugo.toml
+++ b/config/_default/hugo.toml
@@ -8,7 +8,7 @@ enableRobotsTXT = true
# We disable RSS, because (a) it's useless, (b) Hugo seems to generate broken
# links to it when used with a --baseURL (for example, https://spec.matrix.org/v1.4/
# contains ``).
-disableKinds = ["taxonomy", "RSS"]
+disableKinds = ["taxonomy", "rss"]
[languages]
[languages.en]
diff --git a/content/changelog/_index.md b/content/changelog/_index.md
index c1c55f6c..0254102a 100644
--- a/content/changelog/_index.md
+++ b/content/changelog/_index.md
@@ -1,6 +1,7 @@
---
title: Changelog
type: docs
+layout: changelog-index
weight: 1000
---
diff --git a/layouts/_default/_markup/td-heading-self-link.html b/layouts/_default/_markup/td-heading-self-link.html
deleted file mode 100644
index 3d8d7df5..00000000
--- a/layouts/_default/_markup/td-heading-self-link.html
+++ /dev/null
@@ -1,11 +0,0 @@
-{{- /*
-
- A simplified copy of the inlined "_default/_markup/_td-heading-self-link.html"
- template in Docsy's "_default/_markup/td-render-heading.html" template to be
- able to reuse it when the heading has custom markup.
-
- Takes a string which is the ID of the heading.
-
-*/ -}}
-
-
\ No newline at end of file
diff --git a/layouts/_default/_markup/render-heading.html b/layouts/_markup/render-heading.html
similarity index 86%
rename from layouts/_default/_markup/render-heading.html
rename to layouts/_markup/render-heading.html
index 7ae7aba7..d16aac8f 100644
--- a/layouts/_default/_markup/render-heading.html
+++ b/layouts/_markup/render-heading.html
@@ -8,4 +8,4 @@
heading.
*/ -}}
-{{ template "_default/_markup/td-render-heading.html" . }}
+{{ partial "td/render-heading.html" . }}
diff --git a/layouts/partials/added-in.html b/layouts/_partials/added-in.html
similarity index 100%
rename from layouts/partials/added-in.html
rename to layouts/_partials/added-in.html
diff --git a/layouts/partials/alert.html b/layouts/_partials/alert.html
similarity index 100%
rename from layouts/partials/alert.html
rename to layouts/_partials/alert.html
diff --git a/layouts/partials/breadcrumb.html b/layouts/_partials/breadcrumb.html
similarity index 100%
rename from layouts/partials/breadcrumb.html
rename to layouts/_partials/breadcrumb.html
diff --git a/layouts/partials/changed-in.html b/layouts/_partials/changed-in.html
similarity index 100%
rename from layouts/partials/changed-in.html
rename to layouts/_partials/changed-in.html
diff --git a/layouts/partials/events/example.html b/layouts/_partials/events/example.html
similarity index 100%
rename from layouts/partials/events/example.html
rename to layouts/_partials/events/example.html
diff --git a/layouts/partials/events/render-event.html b/layouts/_partials/events/render-event.html
similarity index 97%
rename from layouts/partials/events/render-event.html
rename to layouts/_partials/events/render-event.html
index 31d71115..30a20974 100644
--- a/layouts/partials/events/render-event.html
+++ b/layouts/_partials/events/render-event.html
@@ -24,7 +24,7 @@
diff --git a/layouts/partials/favicons.html b/layouts/_partials/favicons.html
similarity index 100%
rename from layouts/partials/favicons.html
rename to layouts/_partials/favicons.html
diff --git a/layouts/partials/footer/center.html b/layouts/_partials/footer/center.html
similarity index 100%
rename from layouts/partials/footer/center.html
rename to layouts/_partials/footer/center.html
diff --git a/layouts/partials/head-css.html b/layouts/_partials/head-css.html
similarity index 100%
rename from layouts/partials/head-css.html
rename to layouts/_partials/head-css.html
diff --git a/layouts/partials/hooks/body-end.html b/layouts/_partials/hooks/body-end.html
similarity index 100%
rename from layouts/partials/hooks/body-end.html
rename to layouts/_partials/hooks/body-end.html
diff --git a/layouts/partials/hooks/head-end.html b/layouts/_partials/hooks/head-end.html
similarity index 100%
rename from layouts/partials/hooks/head-end.html
rename to layouts/_partials/hooks/head-end.html
diff --git a/layouts/partials/json-schema/resolve-additional-types.html b/layouts/_partials/json-schema/resolve-additional-types.html
similarity index 98%
rename from layouts/partials/json-schema/resolve-additional-types.html
rename to layouts/_partials/json-schema/resolve-additional-types.html
index 9d5e630a..bcc4e562 100644
--- a/layouts/partials/json-schema/resolve-additional-types.html
+++ b/layouts/_partials/json-schema/resolve-additional-types.html
@@ -66,7 +66,7 @@
* If the input `schema` was itself an object that we should create a table for,
* this will be the same as the first entry in `objects`.
*/
-{{ define "partials/resolve-additional-types-inner" }}
+{{ define "_partials/resolve-additional-types-inner" }}
{{ $this_object := .schema }}
{{ $anchor_base := .anchor_base }}
{{ $name := .name }}
@@ -222,7 +222,7 @@
* * `objects`: The array of object schema definitions.
* * `schema`: An updated copy of the `schema` input (eg, an `anchor` may be added).
*/
-{{ define "partials/get-additional-objects" }}
+{{ define "_partials/get-additional-objects" }}
/* .name is the name of the object for logging purposes */
{{ $name := .name }}
@@ -246,6 +246,6 @@
* This is needed for uniqify to work - otherwise objects that are the same
* but with (for example) different examples will be considered different.
*/
-{{ define "partials/clean-object" }}
+{{ define "_partials/clean-object" }}
{{ return (dict "title" .title "properties" .properties "additionalProperties" .additionalProperties "patternProperties" .patternProperties "required" .required "enum" .enum "anchor" .anchor) }}
{{ end }}
diff --git a/layouts/partials/json-schema/resolve-allof.html b/layouts/_partials/json-schema/resolve-allof.html
similarity index 100%
rename from layouts/partials/json-schema/resolve-allof.html
rename to layouts/_partials/json-schema/resolve-allof.html
diff --git a/layouts/partials/json-schema/resolve-examples.html b/layouts/_partials/json-schema/resolve-examples.html
similarity index 100%
rename from layouts/partials/json-schema/resolve-examples.html
rename to layouts/_partials/json-schema/resolve-examples.html
diff --git a/layouts/partials/json-schema/resolve-refs.html b/layouts/_partials/json-schema/resolve-refs.html
similarity index 100%
rename from layouts/partials/json-schema/resolve-refs.html
rename to layouts/_partials/json-schema/resolve-refs.html
diff --git a/layouts/partials/navbar.html b/layouts/_partials/navbar.html
similarity index 98%
rename from layouts/partials/navbar.html
rename to layouts/_partials/navbar.html
index ca8347ee..0de6f46c 100644
--- a/layouts/partials/navbar.html
+++ b/layouts/_partials/navbar.html
@@ -80,7 +80,7 @@
-{{ define "partials/version-string" }}
+{{ define "_partials/version-string" }}
{{ $ret := "unstable version"}}
{{ $status := .Site.Params.version.status }}
diff --git a/layouts/partials/openapi/render-api.html b/layouts/_partials/openapi/render-api.html
similarity index 100%
rename from layouts/partials/openapi/render-api.html
rename to layouts/_partials/openapi/render-api.html
diff --git a/layouts/partials/openapi/render-content-type.html b/layouts/_partials/openapi/render-content-type.html
similarity index 100%
rename from layouts/partials/openapi/render-content-type.html
rename to layouts/_partials/openapi/render-content-type.html
diff --git a/layouts/partials/openapi/render-media-type-objects.html b/layouts/_partials/openapi/render-media-type-objects.html
similarity index 100%
rename from layouts/partials/openapi/render-media-type-objects.html
rename to layouts/_partials/openapi/render-media-type-objects.html
diff --git a/layouts/partials/openapi/render-object-table.html b/layouts/_partials/openapi/render-object-table.html
similarity index 94%
rename from layouts/partials/openapi/render-object-table.html
rename to layouts/_partials/openapi/render-object-table.html
index 08dd5790..00bc4b21 100644
--- a/layouts/partials/openapi/render-object-table.html
+++ b/layouts/_partials/openapi/render-object-table.html
@@ -47,8 +47,8 @@
@@ -138,7 +138,7 @@ resolve-additional-types.)
* `format`: optional string for the format of the type, used for strings.
*/}}
-{{ define "partials/property-type" }}
+{{ define "_partials/property-type" }}
{{ $type := "" }}
{{ if eq .type "object" }}
@@ -215,7 +215,7 @@ resolve-additional-types.)
* `anchor`: optional HTML element id for the target type, which will be used to link to it.
*/}}
-{{ define "partials/object-type-or-title" }}
+{{ define "_partials/object-type-or-title" }}
{{ $type := "object" }}
{{ if .properties }}
{{/*
@@ -306,7 +306,7 @@ resolve-additional-types.)
* `x-changedInMatrixVersion`: optional string indicating in which Matrix
spec version this property was last changed.
*/}}
-{{ define "partials/property-description" -}}
+{{ define "_partials/property-description" -}}
{{ $description := .property.description -}}
{{ if .required -}}
{{/*
@@ -331,7 +331,7 @@ resolve-additional-types.)
Computes the type to display for a string format, given the identifier of
the format as a string.
*/}}
-{{ define "partials/string-format" }}
+{{ define "_partials/string-format" }}
{{ $stringFormat := "" }}
{{ with index site.Data "string-formats" . }}
diff --git a/layouts/partials/openapi/render-operation.html b/layouts/_partials/openapi/render-operation.html
similarity index 97%
rename from layouts/partials/openapi/render-operation.html
rename to layouts/_partials/openapi/render-operation.html
index 7869a42b..c1e34ddf 100644
--- a/layouts/partials/openapi/render-operation.html
+++ b/layouts/_partials/openapi/render-operation.html
@@ -37,7 +37,7 @@
diff --git a/layouts/partials/openapi/render-parameters.html b/layouts/_partials/openapi/render-parameters.html
similarity index 100%
rename from layouts/partials/openapi/render-parameters.html
rename to layouts/_partials/openapi/render-parameters.html
diff --git a/layouts/partials/openapi/render-request.html b/layouts/_partials/openapi/render-request.html
similarity index 100%
rename from layouts/partials/openapi/render-request.html
rename to layouts/_partials/openapi/render-request.html
diff --git a/layouts/partials/openapi/render-responses.html b/layouts/_partials/openapi/render-responses.html
similarity index 100%
rename from layouts/partials/openapi/render-responses.html
rename to layouts/_partials/openapi/render-responses.html
diff --git a/layouts/partials/render-example.html b/layouts/_partials/render-example.html
similarity index 100%
rename from layouts/partials/render-example.html
rename to layouts/_partials/render-example.html
diff --git a/layouts/partials/sidebar-tree.html b/layouts/_partials/sidebar-tree.html
similarity index 100%
rename from layouts/partials/sidebar-tree.html
rename to layouts/_partials/sidebar-tree.html
diff --git a/layouts/partials/toc.html b/layouts/_partials/toc.html
similarity index 100%
rename from layouts/partials/toc.html
rename to layouts/_partials/toc.html
diff --git a/layouts/partials/version-banner.html b/layouts/_partials/version-banner.html
similarity index 100%
rename from layouts/partials/version-banner.html
rename to layouts/_partials/version-banner.html
diff --git a/layouts/shortcodes/added-in.html b/layouts/_shortcodes/added-in.html
similarity index 100%
rename from layouts/shortcodes/added-in.html
rename to layouts/_shortcodes/added-in.html
diff --git a/layouts/shortcodes/boxes/note.html b/layouts/_shortcodes/boxes/note.html
similarity index 100%
rename from layouts/shortcodes/boxes/note.html
rename to layouts/_shortcodes/boxes/note.html
diff --git a/layouts/shortcodes/boxes/rationale.html b/layouts/_shortcodes/boxes/rationale.html
similarity index 100%
rename from layouts/shortcodes/boxes/rationale.html
rename to layouts/_shortcodes/boxes/rationale.html
diff --git a/layouts/shortcodes/boxes/warning.html b/layouts/_shortcodes/boxes/warning.html
similarity index 100%
rename from layouts/shortcodes/boxes/warning.html
rename to layouts/_shortcodes/boxes/warning.html
diff --git a/layouts/shortcodes/changed-in.html b/layouts/_shortcodes/changed-in.html
similarity index 100%
rename from layouts/shortcodes/changed-in.html
rename to layouts/_shortcodes/changed-in.html
diff --git a/layouts/shortcodes/cs-module.html b/layouts/_shortcodes/cs-module.html
similarity index 100%
rename from layouts/shortcodes/cs-module.html
rename to layouts/_shortcodes/cs-module.html
diff --git a/layouts/shortcodes/definition.html b/layouts/_shortcodes/definition.html
similarity index 100%
rename from layouts/shortcodes/definition.html
rename to layouts/_shortcodes/definition.html
diff --git a/layouts/shortcodes/diagram.html b/layouts/_shortcodes/diagram.html
similarity index 100%
rename from layouts/shortcodes/diagram.html
rename to layouts/_shortcodes/diagram.html
diff --git a/layouts/shortcodes/event-fields.html b/layouts/_shortcodes/event-fields.html
similarity index 100%
rename from layouts/shortcodes/event-fields.html
rename to layouts/_shortcodes/event-fields.html
diff --git a/layouts/shortcodes/event-group.html b/layouts/_shortcodes/event-group.html
similarity index 100%
rename from layouts/shortcodes/event-group.html
rename to layouts/_shortcodes/event-group.html
diff --git a/layouts/shortcodes/event.html b/layouts/_shortcodes/event.html
similarity index 100%
rename from layouts/shortcodes/event.html
rename to layouts/_shortcodes/event.html
diff --git a/layouts/shortcodes/http-api.html b/layouts/_shortcodes/http-api.html
similarity index 100%
rename from layouts/shortcodes/http-api.html
rename to layouts/_shortcodes/http-api.html
diff --git a/layouts/shortcodes/msgtypes.html b/layouts/_shortcodes/msgtypes.html
similarity index 100%
rename from layouts/shortcodes/msgtypes.html
rename to layouts/_shortcodes/msgtypes.html
diff --git a/layouts/shortcodes/proposal-tables.html b/layouts/_shortcodes/proposal-tables.html
similarity index 100%
rename from layouts/shortcodes/proposal-tables.html
rename to layouts/_shortcodes/proposal-tables.html
diff --git a/layouts/shortcodes/rver-fragment.html b/layouts/_shortcodes/rver-fragment.html
similarity index 100%
rename from layouts/shortcodes/rver-fragment.html
rename to layouts/_shortcodes/rver-fragment.html
diff --git a/layouts/shortcodes/sas-emojis.html b/layouts/_shortcodes/sas-emojis.html
similarity index 100%
rename from layouts/shortcodes/sas-emojis.html
rename to layouts/_shortcodes/sas-emojis.html
diff --git a/layouts/_default/content.html b/layouts/content.html
similarity index 100%
rename from layouts/_default/content.html
rename to layouts/content.html
diff --git a/layouts/docs/baseof.html b/layouts/docs/baseof.html
index a167f72b..ef748ab7 100644
--- a/layouts/docs/baseof.html
+++ b/layouts/docs/baseof.html
@@ -25,7 +25,9 @@
{{ partial "version-banner.html" . }}
- {{ if not .Site.Params.ui.breadcrumb_disable }}{{ partial "breadcrumb.html" . }}{{ end }}
+ {{ if not (.Param "ui.breadcrumb_disable") -}}
+ {{ partial "breadcrumb.html" . -}}
+ {{ end -}}
{{ block "main" . }}{{ end }}
diff --git a/layouts/docs/changelog-index.html b/layouts/docs/changelog-index.html
new file mode 100644
index 00000000..11471498
--- /dev/null
+++ b/layouts/docs/changelog-index.html
@@ -0,0 +1,13 @@
+{{- /*
+
+ Template to the `changelog` section page.
+
+ This redirects the page to the latest version's changelog page.
+
+*/ -}}
+
+{{ define "main" }}
+ {{ with index .RegularPages.ByDate.Reverse 0 -}}
+
+ {{ end -}}
+{{ end }}
diff --git a/layouts/docs/changelog.html b/layouts/docs/changelog.html
index 94fa55a3..805d3609 100644
--- a/layouts/docs/changelog.html
+++ b/layouts/docs/changelog.html
@@ -1,14 +1,8 @@
{{- /*
- Template to render a page with a `changelog` layout or the `changelog`
- section page. This conflation seems to be a limitation of Hugo currently, it
- uses this template for both cases.
+ Template to render a page with a `changelog` layout.
- For the `changelog` section page, this redirects the page to the latest
- version's changelog page.
-
- For a page with a `changelog` layout, this adds a table at the top of the
- page with information about the release:
+ This adds a table at the top of the page with information about the release:
* A link to the matrix-spec repository at the time of the release, with the
version taken from the `linkTitle` in the frontmatter of the page, unless
@@ -21,11 +15,6 @@
*/ -}}
{{ define "main" }}
-{{ if .IsSection -}}
- {{ with index .RegularPages.ByDate.Reverse 0 -}}
-
- {{ end -}}
-{{ else -}}
{{ $version := lower .LinkTitle -}}