@terrymooreii/sia 2.1.5 → 2.1.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@terrymooreii/sia",
-  "version": "2.1.5",
+  "version": "2.1.7",
   "description": "A simple, powerful static site generator with markdown, front matter, and Nunjucks templates",
   "main": "lib/index.js",
   "bin": {

package/readme.md

@@ -12,7 +12,8 @@ A simple, powerful static site generator built with JavaScript. Similar to Eleve
 - **Pagination** - Built-in pagination for listing pages
 - **Image Support** - Automatic image copying and organization
 - **Live Reload** - Development server with hot reloading
-- **Themes** - Built-in themes (main, minimal) with light/dark mode toggle
+- **Themes** - Built-in themes (main, minimal, developer, magazine) with light/dark mode toggle
+- **Custom Themes** - Create and share themes as npm packages (`sia-theme-*`)
 - **RSS Feed** - Automatic RSS feed generation
 - **YAML/JSON Config** - Flexible configuration options
 
@@ -105,7 +106,8 @@ site:
   url: "https://example.com"
   author: "Your Name"
 
-theme: main  # 'main' or 'minimal'
+theme:
+  name: main  # Options: main, minimal, developer, magazine
 
 input: src
 output: dist
@@ -390,8 +392,55 @@ sia build --clean
 sia new post "Title"
 sia new page "Title"
 sia new note "Content"
+
+# Create a new theme package
+sia theme my-theme
+sia theme my-theme --quick  # Skip prompts
+```
+
+## Custom Theme Packages
+
+Sia supports external themes distributed as npm packages. Theme packages must be named `sia-theme-{name}`.
+
+### Using an External Theme
+
+```bash
+# Install the theme package
+npm install sia-theme-awesome
+
+# Configure in _config.yml
+```
+
+```yaml
+theme:
+  name: awesome  # Uses sia-theme-awesome package
 ```
 
+Sia resolves themes in this order:
+1. Built-in themes (`main`, `minimal`, `developer`, `magazine`)
+2. npm packages matching `sia-theme-{name}`
+
+### Creating a Theme Package
+
+```bash
+# Generate a new theme scaffold
+sia theme my-theme
+
+# This creates sia-theme-my-theme/ with:
+# - package.json (properly configured)
+# - README.md (documentation template)
+# - layouts/, includes/, pages/, styles/
+```
+
+After customizing, publish to npm:
+
+```bash
+cd sia-theme-my-theme
+npm publish
+```
+
+See [Creating Themes](docs/creating-themes.md) for detailed documentation.
+
 ## Upgrading
 
 If you installed Sia as a dependency (recommended):

package/themes/developer/includes/hero.njk

@@ -0,0 +1,6 @@
+{% if config.theme.showHero %}
+<section class="hero-section">
+  <h1 class="hero-title">{{ site.title }}</h1>
+  <p class="hero-description">{{ site.description }}</p>
+</section>
+{% endif %}

package/themes/developer/pages/index.njk

@@ -2,10 +2,7 @@
 
 {% block content %}
 <div class="home-page">
-  <section class="hero-section">
-    <h1 class="hero-title">{{ site.title }}</h1>
-    <p class="hero-description">{{ site.description }}</p>
-  </section>
+  {% include "hero.njk" %}
   
   <section class="posts-section">
     <div class="section-header">
@@ -54,7 +51,7 @@
       {% for note in collections.notes | limit(3) %}
       <article class="note-card">
         <time class="note-time">{{ note.date | date('short') }}</time>
-        <div class="note-preview">{{ note.excerpt | excerpt(150) }}</div>
+        <div class="note-preview">{{ note.excerptHtml | safe  }}</div>
         <a href="{{ note.url }}" class="note-link">Read more →</a>
       </article>
       {% endfor %}

package/themes/magazine/includes/hero.njk

@@ -0,0 +1,8 @@
+{% if config.theme.showHero %}
+<section class="hero">
+  <div class="hero-content">
+    <h1 class="hero-title">{{ site.title }}</h1>
+    <p class="hero-subtitle">{{ site.description }}</p>
+  </div>
+</section>
+{% endif %}

package/themes/magazine/pages/index.njk

@@ -1,12 +1,7 @@
 {% extends "base.njk" %}
 
 {% block content %}
-<section class="hero">
-  <div class="hero-content">
-    <h1 class="hero-title">{{ site.title }}</h1>
-    <p class="hero-subtitle">{{ site.description }}</p>
-  </div>
-</section>
+{% include "hero.njk" %}
 
 {% set featuredPost = collections.posts[0] %}
 {% if featuredPost %}
@@ -17,7 +12,7 @@
       <span class="featured-category">{{ featuredPost.tags[0] }}</span>
       {% endif %}
       <h2 class="featured-title">
-        <a href="{{ featuredPost.url }}">{{ featuredPost.title }}</a>
+        <a href="{{ featuredPost.url | url }}">{{ featuredPost.title }}</a>
       </h2>
       <p class="featured-excerpt">{{ featuredPost.excerpt | excerpt(200) }}</p>
       <div class="featured-meta">
@@ -44,7 +39,7 @@
         <span class="card-category">{{ post.tags[0] }}</span>
         {% endif %}
         <h3 class="card-title">
-          <a href="{{ post.url }}">{{ post.title }}</a>
+          <a href="{{ post.url | url }}">{{ post.title }}</a>
         </h3>
         <p class="card-excerpt">{{ post.excerpt | excerpt(100) }}</p>
         <div class="card-meta">
@@ -70,7 +65,7 @@
     <article class="note-preview">
       <time datetime="{{ note.date | date('iso') }}">{{ note.date | date('short') }}</time>
       <p>{{ note.excerpt | excerpt(150) }}</p>
-      <a href="{{ note.url }}" class="note-link">Read note →</a>
+      <a href="{{ note.url | url }}" class="note-link">Read note →</a>
     </article>
     {% endfor %}
   </div>

package/themes/main/includes/footer.njk

@@ -2,7 +2,7 @@
   <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>.
+      Built with <a href="https://github.com/terrymooreii/sia">Sia</a>.
     </p>
     
     <nav class="footer-nav">

package/themes/main/includes/hero.njk

@@ -0,0 +1,6 @@
+{% if config.theme.showHero %}
+<section class="hero">
+  <h1 class="hero-title">{{ site.title }}</h1>
+  <p class="hero-description">{{ site.description }}</p>
+</section>
+{% endif %}

package/themes/main/pages/index.njk

@@ -1,10 +1,7 @@
 {% extends "base.njk" %}
 
 {% block content %}
-<section class="hero">
-  <h1 class="hero-title">{{ site.title }}</h1>
-  <p class="hero-description">{{ site.description }}</p>
-</section>
+{% include "hero.njk" %}
 
 <section class="section">
   <div class="section-header">
@@ -47,7 +44,7 @@
   <div class="notes-grid">
     {% for note in collections.notes | limit(3) %}
     <article class="note-card">
-      <div class="note-card-content">{{ note.excerpt }}</div>
+      <div class="note-card-content">{{ note.excerptHtml | safe  }}</div>
       <footer class="note-card-footer">
         <time datetime="{{ note.date | date('iso') }}">{{ note.date | date('full_time') }}</time>
         <a href="{{ note.url }}" class="note-card-link">View →</a>

package/themes/minimal/includes/footer.njk

@@ -2,7 +2,7 @@
   <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>.
+      Built with <a href="https://github.com/terrymooreii/sia">Sia</a>.
     </p>
     
     <nav class="footer-nav">

package/themes/minimal/includes/hero.njk

@@ -0,0 +1,6 @@
+{% if config.theme.showHero %}
+<section class="hero">
+  <h1 class="hero-title">{{ site.title }}</h1>
+  <p class="hero-description">{{ site.description }}</p>
+</section>
+{% endif %}

package/themes/minimal/pages/index.njk

@@ -1,10 +1,7 @@
 {% extends "base.njk" %}
 
 {% block content %}
-<section class="hero">
-  <h1 class="hero-title">{{ site.title }}</h1>
-  <p class="hero-description">{{ site.description }}</p>
-</section>
+{% include "hero.njk" %}
 
 <section class="section">
   <div class="section-header">
@@ -47,7 +44,7 @@
   <div class="notes-grid">
     {% for note in collections.notes | limit(3) %}
     <article class="note-card">
-      <div class="note-card-content">{{ note.excerpt }}</div>
+      <div class="note-card-content">{{ note.excerptHtml | safe }}</div>
       <footer class="note-card-footer">
         <time datetime="{{ note.date | date('iso') }}">{{ note.date | date('full_time') }}</time>
         <a href="{{ note.url }}" class="note-card-link">View →</a>