feat(template): fingerprint local asset URLs

README.md

@@ -39,6 +39,7 @@ IgnIt is a [kiln](https://github.com/hakula139/kiln) theme built with Tailwind C
 
 - All CDN deps exact-pinned with SRI hashes (FontAwesome, KaTeX, lightGallery, Mermaid, Twikoo)
 - Phase-scoped dep loading — each dep emitted once per page, gated on actual content needs
+- Content-hashed URLs for local CSS and JavaScript entry assets
 - LQIP wrappers paint kiln's base64 backdrop while sources decode
 
 ### Accessibility

templates/_partials/layout/body-deps.html

@@ -15,28 +15,43 @@
   {{ cdn.script(lg ~ "/lightgallery.min.js", deps.lightgallery.sri.js) }}
   {{ cdn.script(lg ~ "/plugins/thumbnail/lg-thumbnail.min.js", deps.lightgallery.sri.thumbnail) }}
   {{ cdn.script(lg ~ "/plugins/zoom/lg-zoom.min.js", deps.lightgallery.sri.zoom) }}
-  <script src="{{ base | safe }}/js/content/lightgallery.js" defer></script>
+  <script
+    src="{{ base | safe }}{{ asset_url('/js/content/lightgallery.js') | safe }}"
+    defer
+  ></script>
 {%- endif %}
 
 {%- if need_math %}
   {%- set katex = cdn_base ~ "/katex@" ~ deps.katex.version -%}
   {{ cdn.script(katex ~ "/dist/katex.min.js", deps.katex.sri.js) }}
   {{ cdn.script(katex ~ "/dist/contrib/auto-render.min.js", deps.katex.sri.autorender) }}
-  <script src="{{ base | safe }}/js/content/math.js" defer></script>
+  <script
+    src="{{ base | safe }}{{ asset_url('/js/content/math.js') | safe }}"
+    defer
+  ></script>
 {%- endif %}
 
 {%- if need_mermaid %}
   {%- set mermaid = cdn_base ~ "/mermaid@" ~ deps.mermaid.version -%}
   {{ cdn.script(mermaid ~ "/dist/mermaid.min.js", deps.mermaid.sri.js) }}
-  <script src="{{ base | safe }}/js/content/mermaid.js" defer></script>
+  <script
+    src="{{ base | safe }}{{ asset_url('/js/content/mermaid.js') | safe }}"
+    defer
+  ></script>
 {%- endif %}
 
 {%- if need_twikoo %}
   {%- set twikoo = cdn_base ~ "/twikoo@" ~ deps.twikoo.version -%}
   {{ cdn.script(twikoo ~ "/dist/twikoo.min.js", deps.twikoo.sri.js) }}
-  <script src="{{ base | safe }}/js/comments/twikoo.js" defer></script>
+  <script
+    src="{{ base | safe }}{{ asset_url('/js/comments/twikoo.js') | safe }}"
+    defer
+  ></script>
 {%- endif %}
 
 {%- if need_pagination %}
-  <script src="{{ base | safe }}/js/listing/pagination.js" defer></script>
+  <script
+    src="{{ base | safe }}{{ asset_url('/js/listing/pagination.js') | safe }}"
+    defer
+  ></script>
 {%- endif %}

templates/base.html

@@ -12,12 +12,20 @@
   <link rel="stylesheet" href="{{ config.base_url | safe }}/pagefind/pagefind-component-ui.css">
   <script src="{{ config.base_url | safe }}/pagefind/pagefind-component-ui.js" type="module"></script>
   {%- endif %}
-  <link rel="stylesheet" href="{{ config.base_url | safe }}/css/style.css">
+  <link
+    rel="stylesheet"
+    href="{{ config.base_url | safe }}{{ asset_url('/css/style.css') | safe }}"
+  >
   {%- if page_css %}
   <link rel="stylesheet" href="{{ page_css | safe }}">
   {%- endif %}
-  <script src="{{ config.base_url | safe }}/js/layout/theme.js"></script>
-  <script src="{{ config.base_url | safe }}/js/util/dom-ready.js" defer></script>
+  <script
+    src="{{ config.base_url | safe }}{{ asset_url('/js/layout/theme.js') | safe }}"
+  ></script>
+  <script
+    src="{{ config.base_url | safe }}{{ asset_url('/js/util/dom-ready.js') | safe }}"
+    defer
+  ></script>
   {% include "_partials/layout/head-deps.html" %}
   {%- block head %}{% endblock %}
 </head>
@@ -46,13 +54,28 @@
   <pagefind-modal></pagefind-modal>
   {%- endif %}
   {# Defer scripts ordered by visual urgency: paint-affecting first, interaction-only last. #}
-  <script src="{{ config.base_url | safe }}/js/content/lqip.js" defer></script>
-  <script src="{{ config.base_url | safe }}/js/content/content.js" defer></script>
-  <script src="{{ config.base_url | safe }}/js/content/toc.js" defer></script>
+  <script
+    src="{{ config.base_url | safe }}{{ asset_url('/js/content/lqip.js') | safe }}"
+    defer
+  ></script>
+  <script
+    src="{{ config.base_url | safe }}{{ asset_url('/js/content/content.js') | safe }}"
+    defer
+  ></script>
+  <script
+    src="{{ config.base_url | safe }}{{ asset_url('/js/content/toc.js') | safe }}"
+    defer
+  ></script>
   {%- if config.params.effects and config.params.effects.cursor_glow %}
-  <script src="{{ config.base_url | safe }}/js/layout/glow.js" defer></script>
+  <script
+    src="{{ config.base_url | safe }}{{ asset_url('/js/layout/glow.js') | safe }}"
+    defer
+  ></script>
   {%- endif %}
-  <script src="{{ config.base_url | safe }}/js/layout/float-buttons.js" defer></script>
+  <script
+    src="{{ config.base_url | safe }}{{ asset_url('/js/layout/float-buttons.js') | safe }}"
+    defer
+  ></script>
   {%- if assets is defined %}
   {%- for script in assets.scripts %}
   <script src="{{ script.url | safe }}"

theme.toml

@@ -1,7 +1,7 @@
 name = "IgnIt"
 description = "A clean, feature-rich theme for kiln — inspired by Hugo LoveIt"
 license = "MIT"
-min_kiln_version = "0.3.0-rc.1"
+min_kiln_version = "0.3.0-rc.2"
 
 [author]
 name = "Hakula"