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/output/index.html
+++ b/output/index.html
@ -0,0 +1,34 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>My Awesome Site - A brief description of my site</title>
+        <link rel="stylesheet" href="/static/css/minimaltemplate-v1.css">
+        </head>
+<body>
+    <header>
+        <h1><a href="http://localhost:8000">My Awesome Site</a></h1>
+        <p>A brief description of my site</p>
+    </header>
+
+    <main>
+        <section id="posts-list">
+            <h2>Latest Posts</h2>
+                        <ul>
+                                <li>
+                    <h3><a href="http://localhost:8000/posts/hello-world.html">Hello,
+World!</a></h3>
+                                        <p class="date">2024-05-30</p>
+                                                            <p>My first
+post using the qsgen3 static site generator.</p>
+                                    </li>
+                            </ul>
+                    </section>
+    </main>
+
+    <footer>
+        <p>&copy; 2025 My Awesome Site. Generated by qsgen3.</p>
+    </footer>
+</body>
+</html>