feat: Implement robust theme system and document architecture

- Implement flexible theme switching via site.conf (site_theme, site_theme_css_file). - Ensure correct copying of theme static assets, with theme assets overriding root assets. - Resolve CSS linking issues by checking file existence after static copy and using correct paths for Pandoc. - Refactor path construction to prevent duplication when using absolute/relative output paths. - Create comprehensive how-it-works.md detailing system architecture, theme creation, and overall workflow. - Clarify design philosophy: qsgen3 remains design-agnostic, only linking main theme CSS automatically.
2025-05-31 00:00:21 +02:00
parent c14e943f2b
commit c470ac40c0
34 changed files with 5058 additions and 82 deletions
--- a/layouts/page.html
+++ b/layouts/page.html
@ -0,0 +1,32 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>$site_name$ - $title$</title>
+    <meta name="description" content="$description$"> <!-- Add description to frontmatter -->
+    <link rel="stylesheet" href="/static/css/style.css"> <!-- Assuming site served from root -->
+    $for(css)$
+        <link rel="stylesheet" href="$css$">
+    $endfor$
+    $if(math)$ $math$ $endif$
+</head>
+<body>
+    <header>
+        <h1><a href="/">$site_name$</a></h1>
+        <p>$site_tagline$</p>
+    </header>
+    <main>
+        <article>
+            <header>
+                <h1>$title$</h1>
+            </header>
+            $body$
+        </article>
+    </main>
+    <footer>
+        <p>&copy; $current_year$ $site_name$. Generated by qsgen3.</p>
+        <p><a href="$site_url$">$site_url$</a></p>
+    </footer>
+</body>
+</html>