@terrymooreii/sia 2.1.6 → 2.1.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@terrymooreii/sia",
-  "version": "2.1.6",
+  "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
 
@@ -391,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/pages/index.njk

@@ -51,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/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/pages/index.njk

@@ -44,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">