Differences

This shows you the differences between two versions of the page.

--- docs:theme_development:themes [2025/10/07 20:04] – created - external edit 127.0.0.1
+++ docs:theme_development:themes [2026/04/12 11:13] (current) – alice
@@ Line 7: / Line 7: @@
 The theme in use on a given website is defined in the [[Docs:configuration:Site configuration|site configuration (site.json)]] file
-=== Theme Structure ===
+===== Theme Structure =====
 A basalt theme consists of three key parts: A theme definition file (theme.json), one or more jinja2 templates, and static files
-==== Theme definition file ====
+===== Theme definition file =====
 The theme definition file should be located in the root of the theme directory, in a file named "theme.json"
@@ Line 25: / Line 25: @@
 }
 </code>
-==== Page template ====
+===== Page template =====
 The page template is the template that actually gets rendered by basalt during page rendering. It's a good idea to have the page template defined in the theme definition file be something akin to an entrypoint, from which you branch off into other template files you include using jinja.
 The variables available that the page templates need to use are detailed on the [[Docs:theme_development:Theme template variables|template variables]] page.
-==== Static files ====
+===== Static files =====
 Files placed in the "static" directory inside the theme directory will be copied into the built site's static directory.
 If a file with the same name is present in the site's static directory, it takes precedence over the theme's copy - this is to allow users to override theme files.