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/index.html
+++ b/layouts/index.html
@ -0,0 +1,47 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>$site_name$ - $site_tagline$</title>
+    $for(css)$
+    <link rel="stylesheet" href="$css$">
+    $endfor$
+    $if(site_rss_url)$
+    <link rel="alternate" type="application/rss+xml" title="RSS Feed" href="$site_rss_url$">
+    $endif$
+</head>
+<body>
+    <header>
+        <h1><a href="$site_url$">$site_name$</a></h1>
+        <p>$site_tagline$</p>
+    </header>
+
+    <main>
+        <section id="posts-list">
+            <h2>Latest Posts</h2>
+            $if(posts)$
+            <ul>
+                $for(posts)$
+                <li>
+                    <h3><a href="$posts.url$">$posts.title$</a></h3>
+                    $if(posts.date)$
+                    <p class="date">$posts.date$</p>
+                    $endif$
+                    $if(posts.summary)$
+                    <p>$posts.summary$</p>
+                    $endif$
+                </li>
+                $endfor$
+            </ul>
+            $else$
+            <p>No posts found.</p>
+            $endif$
+        </section>
+    </main>
+
+    <footer>
+        <p>&copy; $current_year$ $site_name$. Generated by qsgen3.</p>
+    </footer>
+</body>
+</html>