From dc985df5fe8c748e05181a8f5062eba3f9a2b64a Mon Sep 17 00:00:00 2001
From: Ben Bridle <bridle.benjamin@gmail.com>
Date: Fri, 6 Feb 2026 14:51:33 +1300
Subject: Add comments

More housekeeping to make the codebase more understandable.
---
 src/generate_html.rs | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

(limited to 'src/generate_html.rs')

diff --git a/src/generate_html.rs b/src/generate_html.rs
index 7bec912..b635767 100644
--- a/src/generate_html.rs
+++ b/src/generate_html.rs
@@ -6,8 +6,11 @@ use recipe::*;
 
 pub fn generate_html(page: &Page, website: &Website) -> String {
     let root = page.root();
+
+    // Get page name as a plain string and as an HTML fragment.
     let mut page_name_plain = page.name.clone();
     let mut page_name_html = sanitize_text(&page_name_plain, true);
+    // Find any override-title fragments.
     for block in &page.document.blocks {
         if let Block::Fragment { language, content } = block {
             if language == "override-title" {
@@ -17,8 +20,10 @@ pub fn generate_html(page: &Page, website: &Website) -> String {
             }
         }
     }
-    let site_name = sanitize_text(&website.name, true);
     page_name_plain = sanitize_text(&page_name_plain, true);
+
+    // Get the URL of the parent page.
+    let site_name = sanitize_text(&website.name, true);
     let mut parent_url = String::new();
     for segment in &page.parents {
         parent_url.push_str(&make_url_safe(segment)); parent_url.push('/');
@@ -31,6 +36,8 @@ pub fn generate_html(page: &Page, website: &Website) -> String {
         Some(name) => format!("<a id='parent' href='../{}.html'>{name}</a>", make_url_safe(name)),
         None => String::new(),
     };
+
+    // Format tables of contents and the main page.
     let toc = get_table_of_contents(page);
     let toc_main = if page.headings.len() >= 3 {
         format!("<details><summary></summary>\n{toc}</details>\n")
-- 
cgit v1.2.3-70-g09d2