@terrymooreii/sia 1.0.2 → 2.0.1

package/_config.yml

@@ -0,0 +1,32 @@
+site:
+  title: "Terry Moore II"
+  description: "A personal blog built with Sia"
+  url: "http://localhost:3000"
+  author: "Terry Moore II"
+
+input: src
+output: dist
+
+collections:
+  posts:
+    path: posts
+    layout: post
+    permalink: /blog/:slug/
+    sortBy: date
+    sortOrder: desc
+  pages:
+    path: pages
+    layout: page
+    permalink: /:slug/
+  notes:
+    path: notes
+    layout: note
+    permalink: /notes/:slug/
+    sortBy: date
+    sortOrder: desc
+
+pagination:
+  size: 10
+
+server:
+  port: 3000

package/bin/cli.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+
+import { program } from 'commander';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { readFileSync } from 'fs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
+
+// Import commands
+import { devCommand } from '../lib/server.js';
+import { buildCommand } from '../lib/build.js';
+import { newCommand } from '../lib/new.js';
+import { initCommand } from '../lib/init.js';
+
+program
+  .name('sia')
+  .description('A simple, powerful static site generator')
+  .version(pkg.version);
+
+program
+  .command('init [directory]')
+  .description('Create a new Sia site')
+  .option('-y, --yes', 'Skip prompts and use defaults')
+  .option('-g, --github-actions', 'Add GitHub Actions workflow for GitHub Pages')
+  .action(initCommand);
+
+program
+  .command('dev')
+  .description('Start development server with live reload')
+  .option('-p, --port <port>', 'Port to run the server on', '3000')
+  .action(devCommand);
+
+program
+  .command('build')
+  .description('Build the site for production')
+  .option('-c, --clean', 'Clean output directory before building', true)
+  .action(buildCommand);
+
+program
+  .command('new [type] [title]')
+  .description('Create new content (post, page, note)')
+  .option('-q, --quick', 'Skip prompts and use defaults')
+  .option('-t, --tags <tags>', 'Comma-separated tags')
+  .option('-d, --draft', 'Save as draft (posts only)')
+  .action(newCommand);
+
+program.parse();
+

package/defaults/includes/footer.njk

@@ -0,0 +1,14 @@
+<footer class="site-footer">
+  <div class="container">
+    <p class="footer-text">
+      © {{ "now" | date('year') }} {{ site.author or site.title }}. 
+      Built with <a href="https://github.com/sia/sia">Sia</a>.
+    </p>
+    
+    <nav class="footer-nav">
+      <a href="{{ '/feed.xml' | url }}" class="footer-link">RSS</a>
+      <a href="{{ '/tags/' | url }}" class="footer-link">Tags</a>
+    </nav>
+  </div>
+</footer>
+

package/defaults/includes/header.njk

@@ -0,0 +1,71 @@
+<header class="site-header">
+  <div class="container">
+    <a href="{{ '/' | url }}" class="site-logo">{{ site.title }}</a>
+    
+    <nav class="site-nav">
+      <a href="{{ '/' | url }}" class="nav-link{% if page.url == ('/' | url) %} active{% endif %}">Home</a>
+      <a href="{{ '/blog/' | url }}" class="nav-link{% if page.url and page.url.startsWith('/blog') %} active{% endif %}">Blog</a>
+      <a href="{{ '/notes/' | url }}" class="nav-link{% if page.url and page.url.startsWith('/notes') %} active{% endif %}">Notes</a>
+      <a href="{{ '/tags/' | url }}" class="nav-link{% if page.url and page.url.startsWith('/tags') %} active{% endif %}">Tags</a>
+      {% if collections.pages %}
+      {% for p in collections.pages | limit(3) %}
+      <a href="{{ p.url }}" class="nav-link{% if page.url == p.url %} active{% endif %}">{{ p.title }}</a>
+      {% endfor %}
+      {% endif %}
+      
+      <button class="theme-toggle" id="theme-toggle" aria-label="Toggle dark mode" title="Toggle dark mode">
+        <svg class="icon-sun" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+          <circle cx="12" cy="12" r="5"></circle>
+          <line x1="12" y1="1" x2="12" y2="3"></line>
+          <line x1="12" y1="21" x2="12" y2="23"></line>
+          <line x1="4.22" y1="4.22" x2="5.64" y2="5.64"></line>
+          <line x1="18.36" y1="18.36" x2="19.78" y2="19.78"></line>
+          <line x1="1" y1="12" x2="3" y2="12"></line>
+          <line x1="21" y1="12" x2="23" y2="12"></line>
+          <line x1="4.22" y1="19.78" x2="5.64" y2="18.36"></line>
+          <line x1="18.36" y1="5.64" x2="19.78" y2="4.22"></line>
+        </svg>
+        <svg class="icon-moon" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+          <path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"></path>
+        </svg>
+      </button>
+    </nav>
+  </div>
+</header>
+
+<script>
+(function() {
+  const toggle = document.getElementById('theme-toggle');
+  const html = document.documentElement;
+  
+  // Check for saved preference or system preference
+  function getPreferredTheme() {
+    const saved = localStorage.getItem('theme');
+    if (saved) return saved;
+    return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
+  }
+  
+  // Apply theme
+  function setTheme(theme) {
+    html.setAttribute('data-theme', theme);
+    localStorage.setItem('theme', theme);
+  }
+  
+  // Initialize
+  setTheme(getPreferredTheme());
+  
+  // Toggle handler
+  toggle.addEventListener('click', function() {
+    const current = html.getAttribute('data-theme');
+    setTheme(current === 'dark' ? 'light' : 'dark');
+  });
+  
+  // Listen for system preference changes
+  window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', function(e) {
+    if (!localStorage.getItem('theme')) {
+      setTheme(e.matches ? 'dark' : 'light');
+    }
+  });
+})();
+</script>
+

package/defaults/includes/pagination.njk

@@ -0,0 +1,26 @@
+{% if pagination and pagination.totalPages > 1 %}
+<nav class="pagination" aria-label="Pagination">
+  <div class="pagination-info">
+    Page {{ pagination.pageNumber }} of {{ pagination.totalPages }}
+  </div>
+  
+  <div class="pagination-links">
+    {% if pagination.previousUrl %}
+    <a href="{{ pagination.previousUrl }}" class="pagination-link pagination-prev" aria-label="Previous page">
+      ← Newer
+    </a>
+    {% else %}
+    <span class="pagination-link pagination-prev disabled">← Newer</span>
+    {% endif %}
+    
+    {% if pagination.nextUrl %}
+    <a href="{{ pagination.nextUrl }}" class="pagination-link pagination-next" aria-label="Next page">
+      Older →
+    </a>
+    {% else %}
+    <span class="pagination-link pagination-next disabled">Older →</span>
+    {% endif %}
+  </div>
+</nav>
+{% endif %}
+

package/defaults/includes/tag-list.njk

@@ -0,0 +1,11 @@
+{% if allTags and allTags.length %}
+<div class="tag-cloud">
+  {% for tag in allTags %}
+  <a href="{{ '/tags/' | url }}{{ tag.slug }}/" class="tag tag-{{ 'lg' if tag.count > 10 else ('md' if tag.count > 5 else 'sm') }}">
+    {{ tag.name }}
+    <span class="tag-count">({{ tag.count }})</span>
+  </a>
+  {% endfor %}
+</div>
+{% endif %}
+

package/defaults/layouts/base.njk

@@ -0,0 +1,41 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <meta name="description" content="{{ page.excerpt or site.description }}">
+  <title>{% if title %}{{ title }} | {% endif %}{{ site.title }}</title>
+  
+  <!-- Prevent flash of incorrect theme -->
+  <script>
+    (function() {
+      var saved = localStorage.getItem('theme');
+      var theme = saved || (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light');
+      document.documentElement.setAttribute('data-theme', theme);
+    })();
+  </script>
+  
+  <link rel="stylesheet" href="{{ '/styles/main.css' | url }}">
+  
+  <!-- Open Graph -->
+  <meta property="og:title" content="{{ title or site.title }}">
+  <meta property="og:description" content="{{ page.excerpt or site.description }}">
+  <meta property="og:type" content="{% if page.collection == 'posts' %}article{% else %}website{% endif %}">
+  <meta property="og:url" content="{{ site.url }}{{ page.url or ('/' | url) }}">
+  
+  <!-- RSS Feed -->
+  <link rel="alternate" type="application/rss+xml" title="{{ site.title }}" href="{{ '/feed.xml' | url }}">
+  
+  {% block head %}{% endblock %}
+</head>
+<body>
+  {% include "header.njk" %}
+  
+  <main class="main">
+    {% block content %}{% endblock %}
+  </main>
+  
+  {% include "footer.njk" %}
+</body>
+</html>
+

package/defaults/layouts/note.njk

@@ -0,0 +1,25 @@
+{% extends "base.njk" %}
+
+{% block content %}
+<article class="note">
+  <div class="note-content prose">
+    {{ content | safe }}
+  </div>
+  
+  <footer class="note-footer">
+    <time datetime="{{ page.date | date('iso') }}">{{ page.date | date('full') }}</time>
+    {% if page.tags and page.tags.length %}
+    <span class="note-tags">
+      {% for tag in page.tags %}
+      <a href="{{ '/tags/' | url }}{{ tag | slug }}/" class="tag">{{ tag }}</a>
+      {% endfor %}
+    </span>
+    {% endif %}
+  </footer>
+</article>
+
+<nav class="note-nav">
+  <a href="{{ '/notes/' | url }}" class="btn btn-secondary">← All Notes</a>
+</nav>
+{% endblock %}
+

package/defaults/layouts/page.njk

@@ -0,0 +1,14 @@
+{% extends "base.njk" %}
+
+{% block content %}
+<article class="page">
+  <header class="page-header">
+    <h1 class="page-title">{{ page.title }}</h1>
+  </header>
+  
+  <div class="page-content prose">
+    {{ content | safe }}
+  </div>
+</article>
+{% endblock %}
+

package/defaults/layouts/post.njk

@@ -0,0 +1,43 @@
+{% extends "base.njk" %}
+
+{% block content %}
+<article class="post">
+  <header class="post-header">
+    <h1 class="post-title">{{ page.title }}</h1>
+    
+    <div class="post-meta">
+      <time datetime="{{ page.date | date('iso') }}">{{ page.date | date('long') }}</time>
+      {% if page.tags and page.tags.length %}
+      <span class="post-meta-divider">·</span>
+      <span class="post-tags">
+        {% for tag in page.tags %}
+        <a href="{{ '/tags/' | url }}{{ tag | slug }}/" class="tag">{{ tag }}</a>{% if not loop.last %}, {% endif %}
+        {% endfor %}
+      </span>
+      {% endif %}
+      <span class="post-meta-divider">·</span>
+      <span class="reading-time">{{ page.content | readingTime }}</span>
+    </div>
+  </header>
+  
+  <div class="post-content prose">
+    {{ content | safe }}
+  </div>
+  
+  <footer class="post-footer">
+    {% if page.tags and page.tags.length %}
+    <div class="post-tags-footer">
+      <span class="tags-label">Tagged:</span>
+      {% for tag in page.tags %}
+      <a href="{{ '/tags/' | url }}{{ tag | slug }}/" class="tag">{{ tag }}</a>
+      {% endfor %}
+    </div>
+    {% endif %}
+    
+    <nav class="post-nav">
+      <a href="{{ '/blog/' | url }}" class="btn btn-secondary">← Back to Blog</a>
+    </nav>
+  </footer>
+</article>
+{% endblock %}
+

package/defaults/pages/blog.njk

@@ -0,0 +1,36 @@
+{% extends "base.njk" %}
+
+{% block content %}
+<header class="page-header">
+  <h1 class="page-title">Blog</h1>
+  <p class="page-description">All posts, newest first</p>
+</header>
+
+<div class="post-list">
+  {% for post in posts %}
+  <article class="post-card">
+    <h2 class="post-card-title">
+      <a href="{{ post.url }}">{{ post.title }}</a>
+    </h2>
+    <div class="post-card-meta">
+      <time datetime="{{ post.date | date('iso') }}">{{ post.date | date('long') }}</time>
+      <span class="post-card-reading-time">{{ post.content | readingTime }}</span>
+    </div>
+    {% if post.tags and post.tags.length %}
+    <div class="post-card-tags">
+      {% for tag in post.tags %}
+      <a href="{{ '/tags/' | url }}{{ tag | slug }}/" class="tag tag-sm">{{ tag }}</a>
+      {% endfor %}
+    </div>
+    {% endif %}
+    <p class="post-card-excerpt">{{ post.excerpt }}</p>
+    <a href="{{ post.url }}" class="post-card-link">Read more →</a>
+  </article>
+  {% else %}
+  <p class="empty-message">No posts yet. Create your first post with <code>npx sia new post "My First Post"</code></p>
+  {% endfor %}
+</div>
+
+{% include "pagination.njk" %}
+{% endblock %}
+

package/defaults/pages/feed.njk

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
+  <channel>
+    <title>{{ site.title | safe }}</title>
+    <description>{{ site.description | safe }}</description>
+    <link>{{ site.url | safe }}</link>
+    <atom:link href="{{ site.url | safe }}/feed.xml" rel="self" type="application/rss+xml"/>
+    <language>en-us</language>
+    <lastBuildDate>{{ buildDate | safe }}</lastBuildDate>
+    <generator>Sia Static Site Generator</generator>
+    {% for post in posts | limit(20) %}
+    <item>
+      <title><![CDATA[{{ post.title | safe }}]]></title>
+      <link>{{ site.url | safe }}{{ post.url | safe }}</link>
+      <guid isPermaLink="true">{{ site.url | safe }}{{ post.url | safe }}</guid>
+      <pubDate>{{ post.date | date('rss') }}</pubDate>
+      {% if post.tags and post.tags.length %}
+      {% for tag in post.tags %}
+      <category>{{ tag | safe }}</category>
+      {% endfor %}
+      {% endif %}
+      <description><![CDATA[{{ post.excerpt | safe }}]]></description>
+      <content:encoded><![CDATA[{{ post.content | safe }}]]></content:encoded>
+    </item>
+    {% endfor %}
+  </channel>
+</rss>
+

package/defaults/pages/index.njk

@@ -0,0 +1,60 @@
+{% extends "base.njk" %}
+
+{% block content %}
+<section class="hero">
+  <h1 class="hero-title">{{ site.title }}</h1>
+  <p class="hero-description">{{ site.description }}</p>
+</section>
+
+<section class="section">
+  <div class="section-header">
+    <h2 class="section-title">Latest Posts</h2>
+    <a href="{{ '/blog/' | url }}" class="section-link">View all →</a>
+  </div>
+  
+  <div class="post-list">
+    {% for post in collections.posts | limit(5) %}
+    <article class="post-card">
+      <h3 class="post-card-title">
+        <a href="{{ post.url }}">{{ post.title }}</a>
+      </h3>
+      <div class="post-card-meta">
+        <time datetime="{{ post.date | date('iso') }}">{{ post.date | date('short') }}</time>
+        {% if post.tags and post.tags.length %}
+        <span class="post-card-tags">
+          {% for tag in post.tags | limit(3) %}
+          <a href="{{ '/tags/' | url }}{{ tag | slug }}/" class="tag tag-sm">{{ tag }}</a>
+          {% endfor %}
+        </span>
+        {% endif %}
+      </div>
+      <p class="post-card-excerpt">{{ post.excerpt }}</p>
+    </article>
+  {% else %}
+  <p class="empty-message">No posts yet. Create your first post with <code>npx sia new post "My First Post"</code></p>
+  {% endfor %}
+  </div>
+</section>
+
+{% if collections.notes and collections.notes.length %}
+<section class="section">
+  <div class="section-header">
+    <h2 class="section-title">Recent Notes</h2>
+    <a href="{{ '/notes/' | url }}" class="section-link">View all →</a>
+  </div>
+  
+  <div class="notes-grid">
+    {% for note in collections.notes | limit(3) %}
+    <article class="note-card">
+      <div class="note-card-content">{{ note.excerpt }}</div>
+      <footer class="note-card-footer">
+        <time datetime="{{ note.date | date('iso') }}">{{ note.date | date('short') }}</time>
+        <a href="{{ note.url }}" class="note-card-link">View →</a>
+      </footer>
+    </article>
+    {% endfor %}
+  </div>
+</section>
+{% endif %}
+{% endblock %}
+

package/defaults/pages/notes.njk

@@ -0,0 +1,34 @@
+{% extends "base.njk" %}
+
+{% block content %}
+<header class="page-header">
+  <h1 class="page-title">Notes</h1>
+  <p class="page-description">Short thoughts and quick updates</p>
+</header>
+
+<div class="notes-stream">
+  {% for note in notes %}
+  <article class="note-item">
+    <div class="note-item-content prose">
+      {{ note.content | safe }}
+    </div>
+    <footer class="note-item-footer">
+      <time datetime="{{ note.date | date('iso') }}">{{ note.date | date('full') }}</time>
+      {% if note.tags and note.tags.length %}
+      <div class="note-item-tags">
+        {% for tag in note.tags %}
+        <a href="{{ '/tags/' | url }}{{ tag | slug }}/" class="tag tag-sm">{{ tag }}</a>
+        {% endfor %}
+      </div>
+      {% endif %}
+      <a href="{{ note.url }}" class="note-item-permalink">Permalink</a>
+    </footer>
+  </article>
+  {% else %}
+  <p class="empty-message">No notes yet. Create your first note with <code>npx sia new note "Quick thought"</code></p>
+  {% endfor %}
+</div>
+
+{% include "pagination.njk" %}
+{% endblock %}
+

package/defaults/pages/tag.njk

@@ -0,0 +1,41 @@
+{% extends "base.njk" %}
+
+{% block content %}
+<header class="page-header">
+  <h1 class="page-title">Tagged: {{ tag.name }}</h1>
+  <p class="page-description">{{ tag.count }} item{% if tag.count != 1 %}s{% endif %} tagged with "{{ tag.name }}"</p>
+</header>
+
+<div class="post-list">
+  {% for post in posts %}
+  <article class="post-card">
+    <h2 class="post-card-title">
+      <a href="{{ post.url }}">{{ post.title or post.excerpt }}</a>
+    </h2>
+    <div class="post-card-meta">
+      <time datetime="{{ post.date | date('iso') }}">{{ post.date | date('long') }}</time>
+      {% if post.collection %}
+      <span class="post-card-collection">{{ post.collection }}</span>
+      {% endif %}
+    </div>
+    {% if post.tags and post.tags.length %}
+    <div class="post-card-tags">
+      {% for t in post.tags %}
+      <a href="{{ '/tags/' | url }}{{ t | slug }}/" class="tag tag-sm{% if t | slug == tag.slug %} active{% endif %}">{{ t }}</a>
+      {% endfor %}
+    </div>
+    {% endif %}
+    {% if post.excerpt %}
+    <p class="post-card-excerpt">{{ post.excerpt }}</p>
+    {% endif %}
+  </article>
+  {% endfor %}
+</div>
+
+{% include "pagination.njk" %}
+
+<nav class="page-nav">
+  <a href="{{ '/tags/' | url }}" class="btn btn-secondary">← All Tags</a>
+</nav>
+{% endblock %}
+

package/defaults/pages/tags.njk

@@ -0,0 +1,39 @@
+{% extends "base.njk" %}
+
+{% block content %}
+<header class="page-header">
+  <h1 class="page-title">Tags</h1>
+  <p class="page-description">Browse all {{ allTags.length }} tags</p>
+</header>
+
+{% if allTags and allTags.length %}
+<div class="tags-page">
+  {% include "tag-list.njk" %}
+  
+  <div class="tags-detail">
+    {% for tag in allTags %}
+    <section class="tag-section" id="{{ tag.slug }}">
+      <h2 class="tag-section-title">
+        <a href="{{ '/tags/' | url }}{{ tag.slug }}/">{{ tag.name }}</a>
+        <span class="tag-section-count">({{ tag.count }})</span>
+      </h2>
+      <ul class="tag-posts">
+        {% for item in tag.items | limit(5) %}
+        <li>
+          <a href="{{ item.url }}">{{ item.title or item.excerpt }}</a>
+          <time datetime="{{ item.date | date('iso') }}">{{ item.date | date('short') }}</time>
+        </li>
+        {% endfor %}
+        {% if tag.count > 5 %}
+        <li><a href="{{ '/tags/' | url }}{{ tag.slug }}/" class="more-link">View all {{ tag.count }} →</a></li>
+        {% endif %}
+      </ul>
+    </section>
+    {% endfor %}
+  </div>
+</div>
+{% else %}
+<p class="empty-message">No tags yet. Add tags to your posts in the front matter.</p>
+{% endif %}
+{% endblock %}
+