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/posts/hello-world.html
+++ b/output/posts/hello-world.html
@ -0,0 +1,53 @@
+<!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 - Hello, World!</title>
+    <meta name="author" content="qsgen3">
+    <meta name="description" content=""> <!-- Add description to frontmatter -->
+    <meta name="date" content="2024-05-30">
+            <link rel="stylesheet" href="/static/css/minimaltemplate-v1.css">
+        
+</head>
+<body>
+    <header>
+        <h1><a href="/">My Awesome Site</a></h1>
+        <p>A brief description of my site</p>
+    </header>
+    <main>
+        <article>
+            <header>
+                <h1>Hello, World!</h1>
+                                    <p class="author">By: qsgen3</p>
+                                                    <p class="date">Published: 2024-05-30</p>
+                            </header>
+            <p>Welcome to qsgen3!</p>
+            <p>This is your first post. You can edit it or delete it and
+            start writing your own content.</p>
+            <h2 id="markdown-features">Markdown Features</h2>
+            <p>Qsgen3 supports standard Markdown features,
+            including:</p>
+            <ul>
+            <li>Headings</li>
+            <li><strong>Bold</strong> and <em>italic</em> text</li>
+            <li>Lists:
+            <ul>
+            <li>Unordered</li>
+            <li>Ordered</li>
+            </ul></li>
+            <li><a href="https://example.com">Links</a></li>
+            <li><code>Inline code</code></li>
+            </ul>
+            <div class="sourceCode" id="cb1"><pre
+            class="sourceCode bash"><code class="sourceCode bash"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true" tabindex="-1"></a><span class="co"># Code blocks</span></span>
+<span id="cb1-2"><a href="#cb1-2" aria-hidden="true" tabindex="-1"></a><span class="bu">echo</span> <span class="st">&quot;Hello from a code block!&quot;</span></span></code></pre></div>
+            <p>Enjoy creating your site!</p>
+        </article>
+    </main>
+    <footer>
+        <p>&copy; 2025 My Awesome Site. Generated by qsgen3. </p>
+        <p><a href="http://localhost:8000">http://localhost:8000</a></p>
+    </footer>
+</body>
+</html>