@karaoke-cms/create 0.6.2 → 0.9.0

package/karaoke-create-vault/.obsidian/plugins/templater-obsidian/manifest.json

@@ -0,0 +1,11 @@
+{
+    "id": "templater-obsidian",
+    "name": "Templater",
+    "version": "2.18.1",
+    "description": "Create and use templates",
+    "minAppVersion": "1.5.0",
+    "author": "SilentVoid",
+    "authorUrl": "https://github.com/SilentVoid13",
+    "helpUrl": "https://silentvoid13.github.io/Templater/",
+    "isDesktopOnly": false
+}

package/karaoke-create-vault/.obsidian/plugins/templater-obsidian/styles.css

@@ -0,0 +1,226 @@
+.templater_search {
+    width: calc(100% - 20px);
+}
+
+.templater_div {
+    border-top: 1px solid var(--background-modifier-border);
+}
+
+.templater_div > .setting-item {
+    border-top: none !important;
+    align-self: center;
+}
+
+.templater_div > .setting-item > .setting-item-control {
+    justify-content: space-around;
+    padding: 0;
+    width: 100%;
+}
+
+.templater_div
+    > .setting-item
+    > .setting-item-control
+    > .setting-editor-extra-setting-button {
+    align-self: center;
+}
+
+.templater_donating {
+    margin: 10px;
+}
+
+.templater_title {
+    margin: 0;
+    padding: 0;
+    margin-top: 5px;
+    text-align: center;
+}
+
+.templater_template {
+    align-self: center;
+    margin-left: 5px;
+    margin-right: 5px;
+    width: 70%;
+}
+
+.templater_cmd {
+    margin-left: 5px;
+    margin-right: 5px;
+    font-size: 14px;
+    width: 100%;
+}
+
+.templater_div2 > .setting-item {
+    align-content: center;
+    justify-content: center;
+}
+
+.templater-prompt-div,
+.templater-multisuggester-div {
+    display: flex;
+}
+
+.templater-prompt-form {
+    display: flex;
+    flex-grow: 1;
+}
+
+.templater-prompt-input,
+.templater-multisuggester-input {
+    flex-grow: 1;
+}
+
+.templater-button-div {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    margin-top: 1rem;
+}
+
+textarea.templater-prompt-input {
+    height: 10rem;
+}
+
+textarea.templater-prompt-input:focus {
+    border-color: var(--interactive-accent);
+}
+
+.templater-multisuggester-list {
+    margin: 1.5em 0;
+}
+
+.cm-s-obsidian .templater-command-bg {
+    left: 0px;
+    right: 0px;
+    background-color: var(--background-primary-alt);
+}
+
+.cm-s-obsidian .cm-templater-command {
+    font-size: 0.85em;
+    font-family: var(--font-monospace);
+    line-height: 1.3;
+}
+
+.cm-s-obsidian .templater-inline .cm-templater-command {
+    background-color: var(--background-primary-alt);
+}
+
+.cm-s-obsidian .cm-templater-command.cm-templater-opening-tag {
+    font-weight: bold;
+}
+
+.cm-s-obsidian .cm-templater-command.cm-templater-closing-tag {
+    font-weight: bold;
+}
+
+.cm-s-obsidian .cm-templater-command.cm-templater-interpolation-tag {
+    color: var(--code-property, #008bff);
+}
+
+.cm-s-obsidian .cm-templater-command.cm-templater-execution-tag {
+    color: var(--code-function, #c0d700);
+}
+
+.cm-s-obsidian .cm-templater-command.cm-keyword {
+    color: var(--code-keyword, #00a7aa);
+    font-weight: normal;
+}
+
+.cm-s-obsidian .cm-templater-command.cm-atom {
+    color: var(--code-normal, #f39b35);
+}
+
+.cm-s-obsidian .cm-templater-command.cm-value,
+.cm-s-obsidian .cm-templater-command.cm-number,
+.cm-s-obsidian .cm-templater-command.cm-type {
+    color: var(--code-value, #a06fca);
+}
+
+.cm-s-obsidian .cm-templater-command.cm-def,
+.cm-s-obsidian .cm-templater-command.cm-type.cm-def {
+    color: var(--code-normal, var(--text-normal));
+}
+
+.cm-s-obsidian .cm-templater-command.cm-property,
+.cm-s-obsidian .cm-templater-command.cm-property.cm-def,
+.cm-s-obsidian .cm-templater-command.cm-attribute {
+    color: var(--code-function, #98e342);
+}
+
+.cm-s-obsidian .cm-templater-command.cm-variable,
+.cm-s-obsidian .cm-templater-command.cm-variable-2,
+.cm-s-obsidian .cm-templater-command.cm-variable-3,
+.cm-s-obsidian .cm-templater-command.cm-meta {
+    color: var(--code-property, #d4d4d4);
+}
+
+.cm-s-obsidian .cm-templater-command.cm-callee,
+.cm-s-obsidian .cm-templater-command.cm-operator,
+.cm-s-obsidian .cm-templater-command.cm-qualifier,
+.cm-s-obsidian .cm-templater-command.cm-builtin {
+    color: var(--code-operator, #fc4384);
+}
+
+.cm-s-obsidian .cm-templater-command.cm-tag {
+    color: var(--code-tag, #fc4384);
+}
+
+.cm-s-obsidian .cm-templater-command.cm-comment,
+.cm-s-obsidian .cm-templater-command.cm-comment.cm-tag,
+.cm-s-obsidian .cm-templater-command.cm-comment.cm-attribute {
+    color: var(--code-comment, #696d70);
+}
+
+.cm-s-obsidian .cm-templater-command.cm-string,
+.cm-s-obsidian .cm-templater-command.cm-string-2 {
+    color: var(--code-string, #e6db74);
+}
+
+.cm-s-obsidian .cm-templater-command.cm-header,
+.cm-s-obsidian .cm-templater-command.cm-hr {
+    color: var(--code-keyword, #da7dae);
+}
+
+.cm-s-obsidian .cm-templater-command.cm-link {
+    color: var(--code-normal, #696d70);
+}
+
+.cm-s-obsidian .cm-templater-command.cm-error {
+    border-bottom: 1px solid #c42412;
+}
+
+.CodeMirror-hints {
+    position: absolute;
+    z-index: 10;
+    overflow: hidden;
+    list-style: none;
+
+    margin: 0;
+    padding: 2px;
+
+    -webkit-box-shadow: 2px 3px 5px rgba(0, 0, 0, 0.2);
+    -moz-box-shadow: 2px 3px 5px rgba(0, 0, 0, 0.2);
+    box-shadow: 2px 3px 5px rgba(0, 0, 0, 0.2);
+    border-radius: 3px;
+    border: 1px solid silver;
+
+    background: white;
+    font-size: 90%;
+    font-family: monospace;
+
+    max-height: 20em;
+    overflow-y: auto;
+}
+
+.CodeMirror-hint {
+    margin: 0;
+    padding: 0 4px;
+    border-radius: 2px;
+    white-space: pre;
+    color: black;
+    cursor: pointer;
+}
+
+li.CodeMirror-hint-active {
+    background: #08f;
+    color: white;
+}

package/karaoke-create-vault/.obsidian/workspace.json

@@ -0,0 +1,225 @@
+{
+  "main": {
+    "id": "bf48daa9b3525d37",
+    "type": "split",
+    "children": [
+      {
+        "id": "4d1b0940e2f6130e",
+        "type": "tabs",
+        "children": [
+          {
+            "id": "d663da17c7b12a45",
+            "type": "leaf",
+            "state": {
+              "type": "markdown",
+              "state": {
+                "file": "docs/getting-started.md",
+                "mode": "source",
+                "source": false
+              },
+              "icon": "lucide-file",
+              "title": "getting-started"
+            }
+          },
+          {
+            "id": "52e565c48d7a7c39",
+            "type": "leaf",
+            "state": {
+              "type": "markdown",
+              "state": {
+                "file": "karaoke-cms/templates/docs-header.md",
+                "mode": "source",
+                "source": false
+              },
+              "icon": "lucide-file",
+              "title": "docs-header"
+            }
+          }
+        ],
+        "currentTab": 1
+      }
+    ],
+    "direction": "vertical"
+  },
+  "left": {
+    "id": "f848878ad9626a8e",
+    "type": "split",
+    "children": [
+      {
+        "id": "ea3061d9ba4255be",
+        "type": "tabs",
+        "children": [
+          {
+            "id": "94f03deca1f3d6ef",
+            "type": "leaf",
+            "state": {
+              "type": "file-explorer",
+              "state": {
+                "sortOrder": "alphabetical",
+                "autoReveal": false
+              },
+              "icon": "lucide-folder-closed",
+              "title": "Files"
+            }
+          },
+          {
+            "id": "b92a29ffd5bd2fcd",
+            "type": "leaf",
+            "state": {
+              "type": "search",
+              "state": {
+                "query": "",
+                "matchingCase": false,
+                "explainSearch": false,
+                "collapseAll": false,
+                "extraContext": false,
+                "sortOrder": "alphabetical"
+              },
+              "icon": "lucide-search",
+              "title": "Search"
+            }
+          },
+          {
+            "id": "2fa9963b38cc204e",
+            "type": "leaf",
+            "state": {
+              "type": "bookmarks",
+              "state": {},
+              "icon": "lucide-bookmark",
+              "title": "Bookmarks"
+            }
+          }
+        ]
+      }
+    ],
+    "direction": "horizontal",
+    "width": 300
+  },
+  "right": {
+    "id": "068d5dd11487213f",
+    "type": "split",
+    "children": [
+      {
+        "id": "b36a87ef12a5b05e",
+        "type": "tabs",
+        "children": [
+          {
+            "id": "5040cbb52c2ed323",
+            "type": "leaf",
+            "state": {
+              "type": "backlink",
+              "state": {
+                "collapseAll": false,
+                "extraContext": false,
+                "sortOrder": "alphabetical",
+                "showSearch": false,
+                "searchQuery": "",
+                "backlinkCollapsed": false,
+                "unlinkedCollapsed": true
+              },
+              "icon": "links-coming-in",
+              "title": "Backlinks"
+            }
+          },
+          {
+            "id": "262dc809ddada450",
+            "type": "leaf",
+            "state": {
+              "type": "outgoing-link",
+              "state": {
+                "linksCollapsed": false,
+                "unlinkedCollapsed": true
+              },
+              "icon": "links-going-out",
+              "title": "Outgoing links"
+            }
+          },
+          {
+            "id": "27e78afa43f86c41",
+            "type": "leaf",
+            "state": {
+              "type": "tag",
+              "state": {
+                "sortOrder": "frequency",
+                "useHierarchy": true,
+                "showSearch": false,
+                "searchQuery": ""
+              },
+              "icon": "lucide-tags",
+              "title": "Tags"
+            }
+          },
+          {
+            "id": "b25127a84b56f576",
+            "type": "leaf",
+            "state": {
+              "type": "all-properties",
+              "state": {
+                "sortOrder": "frequency",
+                "showSearch": false,
+                "searchQuery": ""
+              },
+              "icon": "lucide-archive",
+              "title": "All properties"
+            }
+          },
+          {
+            "id": "9144cec5db6c0b0e",
+            "type": "leaf",
+            "state": {
+              "type": "outline",
+              "state": {
+                "followCursor": false,
+                "showSearch": false,
+                "searchQuery": ""
+              },
+              "icon": "lucide-list",
+              "title": "Outline"
+            }
+          },
+          {
+            "id": "d5b8fda7e074d1fc",
+            "type": "leaf",
+            "state": {
+              "type": "file-properties",
+              "state": {
+                "file": "karaoke-cms/templates/docs-header.md"
+              },
+              "icon": "lucide-info",
+              "title": "File properties for docs-header"
+            }
+          }
+        ],
+        "currentTab": 5
+      }
+    ],
+    "direction": "horizontal",
+    "width": 300
+  },
+  "left-ribbon": {
+    "hiddenItems": {
+      "switcher:Open quick switcher": false,
+      "graph:Open graph view": false,
+      "canvas:Create new canvas": false,
+      "daily-notes:Open today's daily note": false,
+      "templates:Insert template": false,
+      "command-palette:Open command palette": false,
+      "bases:Create new base": false,
+      "templater-obsidian:Templater": false
+    }
+  },
+  "active": "52e565c48d7a7c39",
+  "lastOpenFiles": [
+    "karaoke-cms/templates/blog-header.md",
+    "karaoke-cms/templates/docs-header.md",
+    "karaoke-cms/templates/index-by-foldernote.md",
+    "karaoke-cms/manual/content.md",
+    "karaoke-cms/manual/configuration.md",
+    "blog/hello-world.md",
+    "karaoke-cms/templates",
+    "karaoke-cms/index.md",
+    "blog/draft-post.md",
+    "docs/testing.md",
+    "docs/getting-started.md"
+  ]
+}

package/karaoke-create-vault/blog/draft-post.md

@@ -0,0 +1,15 @@
+---
+title: Draft Post
+publish: false
+date: 2026-01-02
+---
+
+This post has `publish: false`. It lives in your vault but never appears on the site.
+
+Change it to `publish: true` when you're ready to share it.
+
+## Tips for drafting
+
+- Write freely — nothing here ships until you say so
+- Use `date:` to pre-date a post for scheduling context
+- `tags:` and `description:` can be added before publishing

package/karaoke-create-vault/blog/hello-world.md

@@ -0,0 +1,26 @@
+---
+title: Hello World !
+publish: true
+date: 2026-01-01
+author: The Team
+description: Your first published post.
+---
+
+Welcome! This post has `publish: true` so it appears on your site.
+
+## How publishing works
+
+Every file in your vault is private by default. To make a note public:
+
+1. Add `publish: true` to the frontmatter
+2. Push to `main` — GitHub Actions builds and deploys automatically
+
+That's it. No config, no CMS, no dashboard. The vault is your editorial system.
+
+## What you can write
+
+- Use standard Markdown: headers, lists, code blocks, images
+- Link between notes with `[[wikilinks]]` — karaoke-cms resolves them automatically
+- Drafts with `publish: false` live in your vault and never ship to production
+
+See [[karaoke-cms/manual/content]] for the full content guide.

package/karaoke-create-vault/docs/getting-started.md

@@ -0,0 +1,49 @@
+---
+title: "Getting Started"
+publish: true
+date: 2026-01-01
+description: "How to set up and use your karaoke-cms site."
+---
+
+## Open in Obsidian
+
+Your project root is an Obsidian vault. Open this folder in Obsidian to write content with full wikilink navigation, templates, and graph view.
+
+## Configure your site
+
+Edit `karaoke.config.ts` to set your title, theme, and modules:
+
+```ts
+const config: KaraokeConfig = {
+  title: "My Site",
+  description: "What this site is about.",
+  theme: "default",       // or "minimal"
+  modules: {
+    search: { enabled: true },
+  },
+};
+```
+
+## Write content
+
+- **Blog posts** → `content/blog/`
+- **Documentation** → `content/docs/`
+- Add `publish: true` to make a file public
+- Push to `main` → your site deploys automatically via GitHub Actions + Cloudflare Pages
+
+## Frontmatter reference
+
+```yaml
+---
+title: "My Post"          # required
+publish: true             # required to appear on site
+date: 2026-01-15          # optional, YYYY-MM-DD
+author: "Name"            # optional
+description: "..."        # optional, used in OG tags and RSS
+tags: [tag1, tag2]        # optional
+---
+```
+
+## Learn more
+
+The **[[karaoke-cms/manual/index|Handbook]]** explains everything — it lives inside your vault and is visible at `/karaoke-cms` in dev mode.

package/karaoke-create-vault/karaoke-cms/config/collections.yaml

@@ -0,0 +1,10 @@
+collections:
+  blog:
+    modes: [dev, prod]
+    label: Blog
+  docs:
+    modes: [dev, prod]
+    label: Docs
+  karaoke-cms:
+    modes: [dev]
+    label: Handbook

package/karaoke-create-vault/karaoke-cms/config/menus.yaml

@@ -0,0 +1,33 @@
+# menus.yaml — define named menus for your site.
+#
+# Each menu has an orientation (horizontal or vertical) and a list of entries.
+# Entries are sorted by weight (ascending). Submenus are defined by nesting entries.
+#
+# when: collection:name — hide entry when the collection is disabled or has no
+#                         published posts. Omit `when` to always show.
+#
+# If this file is absent, karaoke-cms generates a default main menu (Blog/Docs/Tags)
+# and a default footer menu (RSS) from your active collections.
+
+menus:
+  main:
+    orientation: horizontal
+    entries:
+      - text: Blog
+        href: /blog
+        weight: 10
+        when: collection:blog
+      - text: Docs
+        href: /docs
+        weight: 20
+        when: collection:docs
+      - text: Tags
+        href: /tags
+        weight: 30
+
+  footer:
+    orientation: horizontal
+    entries:
+      - text: RSS
+        href: /rss.xml
+        weight: 10

package/karaoke-create-vault/karaoke-cms/manual/configuration.md

@@ -0,0 +1,77 @@
+---
+title: "Configuration"
+---
+
+# Configuration
+
+> **Handbook — dev only.**
+
+## karaoke.config.ts
+
+The main config file at your project root. TypeScript — fully typed.
+
+```ts
+import type { KaraokeConfig } from '@karaoke-cms/astro';
+
+const config: KaraokeConfig = {
+  title: "My Site",
+  description: "What this site is about.",
+  theme: "default",         // "default" | "minimal"
+  modules: {
+    search: {
+      enabled: true,        // Pagefind full-text search
+    },
+    comments: {
+      enabled: true,        // Giscus (GitHub Discussions)
+      repo: "owner/repo",
+      repoId: "R_...",
+      category: "General",
+      categoryId: "DIC_...",
+    },
+  },
+};
+
+export default config;
+```
+
+Get Giscus values from [giscus.app](https://giscus.app) after enabling Discussions on your repo.
+
+## collections.yaml
+
+`content/karaoke-cms/config/collections.yaml` controls which collections are visible in dev vs prod:
+
+```yaml
+collections:
+  blog:
+    modes: [dev, prod]   # visible in both dev and production
+    label: Blog
+  docs:
+    modes: [dev, prod]
+    label: Docs
+  karaoke-cms:
+    modes: [dev]         # dev-only — never ships
+    label: Handbook
+```
+
+To add a custom collection (e.g., `content/notes/`):
+
+```yaml
+collections:
+  notes:
+    modes: [dev, prod]
+    label: Notes
+```
+
+## Layout regions
+
+Place UI components in the sidebar or header via `karaoke.config.ts`:
+
+```ts
+layout: {
+  regions: {
+    right: { components: ['recent-posts'] },
+  },
+},
+```
+
+Available components: `header`, `main-menu`, `search`, `recent-posts`, `footer`.