From 1f64536c30df5212fb06788c699d8aa34c23600b Mon Sep 17 00:00:00 2001
From: Danila Fedorin <danila.fedorin@gmail.com>
Date: Sat, 30 Dec 2023 15:46:36 -0800
Subject: [PATCH] Add comments to HTML

---
 layouts/partials/head.html | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/layouts/partials/head.html b/layouts/partials/head.html
index bc30474..e820ff5 100644
--- a/layouts/partials/head.html
+++ b/layouts/partials/head.html
@@ -10,12 +10,19 @@
     <meta name="matrix-highlight-comments" content="{{ . }}">
     {{ end }}
 
+    <!-- Fonts -->
     <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Inconsolata:wght@400;700&family=Raleway&family=Lora&display=block" media="screen">
+
+    <!-- External CSS (normalize and KaTeX -->
     <link rel="stylesheet" href="{{ .Site.Params.normalizeCssUrl }}" media="screen">
     <link rel="stylesheet" href="{{ .Site.Params.katexCssUrl }}" crossorigin="anonymous">
+
+    <!-- Links to other formats (RSS, TOML) -->
     {{ range .AlternativeOutputFormats -}}
     <link rel="{{ .Rel }}" type="{{ .MediaType.Type | html }}" href="{{ .Permalink | safeURL }}">
     {{ end -}}
+
+    <!-- In-house CSS -->
     {{ $style := resources.Get "scss/style.scss" | resources.ToCSS | resources.Minify }}
     {{ $sidenotes := resources.Get "scss/sidenotes.scss" | resources.ToCSS | resources.Minify }}
     {{ $code := resources.Get "scss/code.scss" | resources.ToCSS | resources.Minify }}
@@ -28,6 +35,7 @@
     <link rel="icon" type="image/png" href="{{ $icon.Permalink }}">
 
     {{ if .Site.IsServer }}
+    <!-- KaTeX auto-rendering for when we don't have a post-processing step. -->
     <script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.0/dist/katex.min.js" integrity="sha384-X/XCfMm41VSsqRNQgDerQczD69XqmjOOOwYQvr/uuC+j4OPoNhVgjdGFwhvN02Ja" crossorigin="anonymous"></script>
     <script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.0/dist/contrib/auto-render.min.js" integrity="sha384-+XBljXPPiv+OzfbB3cVmLHf4hdUFHlWNZN5spNQ7rmHTXpd7WvJum6fIACpNNfIR" crossorigin="anonymous"
         onload="renderMathInElement(document.body);"></script>