New theme and publish options / front matter

Author: gbro3n

.gitignore

@@ -15,4 +15,8 @@ node_modules
 
 # Test outputs
 
-test-results.txt
+test-results.txt
+
+# AgentKanban
+
+.vscode/mcp.json

.vscode/launch.json

@@ -7,7 +7,8 @@
             "request": "launch",
             "args": [
                 "--extensionDevelopmentPath=${workspaceFolder}/vs-code-extension",
-                "--disable-extensions"
+                "--disable-extensions",
+                "${env:HOME}/src/as-notes-demo-notes"
             ],
             "outFiles": [
                 "${workspaceFolder}/vs-code-extension/dist/**/*.js"

README.md

@@ -201,6 +201,16 @@ These commands toggle or cycle publishing-related fields in the file's YAML fron
 | **Retina** | Toggles `retina: true` / `retina: false` in front matter |
 | **Assets** | Toggles `assets: true` / `assets: false` in front matter |
 
+#### Front Matter Presets *(files without existing front matter)*
+
+These commands appear only when the current file has no YAML front matter block. They insert a complete front matter template with tabstop placeholders for easy editing.
+
+| Command | Action |
+|---|---|
+| **Front Matter: Blog Post** | Inserts front matter for a blog post: `title`, `description`, `date` (today), `author`, `public: true`, `layout: blog` |
+| **Front Matter: Docs Page** | Inserts front matter for a docs page: `title`, `description`, `public: true`, `layout: docs`, `order` |
+| **Front Matter: Wiki Page** | Inserts front matter for a wiki page: `title`, `description`, `public: true` |
+
 #### Kanban Card Commands *(kanban card files only)*
 
 The following command only appears when editing a kanban card file (`kanban/card_*.md`).
@@ -522,7 +532,40 @@ The converter is published as an npm package:
 npx asnotes-publish --config ./asnotes-publish.json
 ```
 
-See [Publishing a Static Site](https://docs.asnotes.io/publishing-a-static-site.html) for full documenation
+#### Blog index generation
+
+When the site-wide layout is `blog` (or `blogIndex: true` is set in the config), the auto-generated index page uses a blog-aware layout:
+
+1. **Recent posts** — the most recent posts (configurable via `recentCount`, default 3) shown as cards with title, date, author, description, and optional hero image
+2. **Current year** — remaining posts for the current year as a compact date + title list
+3. **Year archives** — links to auto-generated `archive-YYYY.html` pages for previous years
+4. **Undated** — posts without a `date` in front matter are listed at the bottom
+
+#### Front matter fields for publishing
+
+| Field | Type | Description |
+|---|---|---|
+| `public` | boolean | Include page in published output |
+| `title` | string | Page title (defaults to filename) |
+| `description` | string | Meta description for SEO |
+| `date` | string | Publication date (`YYYY-MM-DD`) — used for blog sorting, RSS, and sitemap |
+| `author` | string | Post author — displayed in blog layout and RSS feed |
+| `image` | string | Hero/thumbnail image path — displayed in blog layout and blog index cards |
+| `layout` | string | Per-page layout override (`docs`, `blog`, `minimal`) |
+| `order` | number | Navigation sort order |
+| `draft` | boolean | Exclude from output unless `--include-drafts` is set |
+| `assets` | boolean | Copy referenced images to output |
+| `retina` | boolean | Enable retina image sizing |
+
+#### Blog config options
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `siteTitle` | string | `"AS Notes Site"` | Site title used in RSS feed and blog index |
+| `recentCount` | number | `3` | Number of recent posts shown as cards on the blog index |
+| `blogIndex` | boolean | `false` | Use blog-style index generation (auto-enabled when `layout: "blog"`) |
+
+See [Publishing a Static Site](https://docs.asnotes.io/publishing-a-static-site.html) for full documentation
 
 ### Debugging
 

common/src/FrontMatterService.ts

@@ -39,6 +39,8 @@ export interface FrontMatterFields {
     retina?: boolean;
     draft?: boolean;
     date?: string;
+    author?: string;
+    image?: string;
     aliases?: string[];
 }
 
@@ -143,6 +145,12 @@ export class FrontMatterService {
                 case 'date':
                     fields.date = this.parseStringValue(rawValue);
                     break;
+                case 'author':
+                    fields.author = this.parseStringValue(rawValue);
+                    break;
+                case 'image':
+                    fields.image = this.parseStringValue(rawValue);
+                    break;
                 case 'aliases':
                     fields.aliases = this.parseAliasesFromLine(rawValue, lines, i);
                     break;

common/test/FrontMatterService.test.ts

@@ -258,6 +258,16 @@ describe('FrontMatterService — parseFrontMatterFields', () => {
         expect(service.parseFrontMatterFields(content).date).toBe('2026-03-23');
     });
 
+    it('should parse author field', () => {
+        const content = '---\nauthor: Jane Doe\n---\n\n# Page';
+        expect(service.parseFrontMatterFields(content).author).toBe('Jane Doe');
+    });
+
+    it('should parse image field', () => {
+        const content = '---\nimage: assets/images/hero.png\n---\n\n# Page';
+        expect(service.parseFrontMatterFields(content).image).toBe('assets/images/hero.png');
+    });
+
     it('should parse aliases via parseFrontMatterFields', () => {
         const content = '---\naliases: [Alias A, Alias B]\n---\n\n# Page';
         expect(service.parseFrontMatterFields(content).aliases).toEqual(['Alias A', 'Alias B']);

docs-src/asnotes-publish.includes.blog/header.html

@@ -1,5 +1,6 @@
 <div class="site-header">
     <a class="site-title" href="{{base-url}}/">
-        <svg class="site-logo" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 191.82 166.13" width="24" height="21"><path fill="currentColor" fill-rule="evenodd" d="M67.09,132.92,47.93,166.13H9.59L0,149.52,86.33,0H105.5L19.17,149.52H38.34l19.17-33.2h76.8l9.59,16.6Zm48-83.12,9.65,16.71H143.9L115.08,16.6q-24,41.57-48,83.12H143.9q14.37,24.9,28.76,49.8h-96l-9.59,16.61H182.24l9.58-16.61-38.34-66.4H96C95.85,82.9,113.39,52.73,115.08,49.8Z"/></svg>
+        {{site-icon}}
+        {{site-title}}
     </a>
-</div>
+</div>

docs-src/asnotes-publish.includes.blog/icon.svg

@@ -1,5 +1,6 @@
 <div class="site-header">
     <a class="site-title" href="{{base-url}}/">
-        <svg class="site-logo" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 191.82 166.13" width="24" height="21"><path fill="currentColor" fill-rule="evenodd" d="M67.09,132.92,47.93,166.13H9.59L0,149.52,86.33,0H105.5L19.17,149.52H38.34l19.17-33.2h76.8l9.59,16.6Zm48-83.12,9.65,16.71H143.9L115.08,16.6q-24,41.57-48,83.12H143.9q14.37,24.9,28.76,49.8h-96l-9.59,16.61H182.24l9.58-16.61-38.34-66.4H96C95.85,82.9,113.39,52.73,115.08,49.8Z"/></svg>
+        {{site-icon}}
+        {{site-title}}
     </a>
-</div>
+</div>