dogsbay 0.2.0-beta.4 → 0.2.0-beta.5

package/dist/commands/site-init.js

@@ -253,24 +253,28 @@ title: About
 Whatever you want to say here.
 \`\`\`
 
-Then add it to \`content/nav.yml\` so it appears in the sidebar:
+Then add it to \`content/nav.yml\` so it appears in the sidebar.
+Each entry is a single-key map — key = label, value = file path:
 
 \`\`\`yaml
-- label: About
-  href: ${basePath}/about
+- About: about.md
+\`\`\`
+
+External URLs work the same way:
+
+\`\`\`yaml
+- GitHub: https://github.com/your-org/your-repo
 \`\`\`
 
 ## 3. Group pages
 
-To create a section in the sidebar, use \`children\`:
+To create a section in the sidebar, give the entry a list of
+children instead of a single file:
 
 \`\`\`yaml
-- label: Guides
-  children:
-    - label: Configuration
-      href: ${basePath}/guides/configuration
-    - label: Deployment
-      href: ${basePath}/guides/deployment
+- Guides:
+    - Configuration: guides/configuration.md
+    - Deployment: guides/deployment.md
 \`\`\`
 
 The folder structure under \`content/\` doesn't have to match the
@@ -281,19 +285,24 @@ nav — but it usually does, because it makes URLs predictable.
     writeFileSync(navPath, `# Sidebar navigation. Loaded by Dogsbay automatically — name this
 # file nav.yml, nav.yaml, or nav.json (in that order of precedence).
 #
-# Each entry is either:
-#   - { label, href }                       a single link
-#   - { label, children: [...] }            a group (label is the section header)
-#   - { label, href, children: [...] }      a link that's also a group root
+# Each entry is a single-key map. The key is the sidebar label.
+# The value is one of:
+#   - a file path (relative to content/, e.g. "guide.md")
+#   - an absolute URL (e.g. "https://...")
+#   - a list of child entries (creates a group)
+#
+# Examples:
+#   - Home: index.md                       # leaf — file path
+#   - GitHub: https://github.com/…         # leaf — external URL
+#   - Guides:                              # group — children below
+#       - Configuration: guides/config.md
+#       - Deployment: guides/deploy.md
 #
-# Hrefs are absolute paths. Edit freely as you add or rearrange
-# pages. See https://github.com/dogsbay/dogsbay for the full
-# nav-file reference.
-
-- label: Home
-  href: ${basePath}/
-- label: Getting started
-  href: ${basePath}/getting-started
+# Edit freely as you add or rearrange pages. See
+# https://github.com/dogsbay/dogsbay for the full nav-file reference.
+
+- Home: index.md
+- Getting started: getting-started.md
 `);
     written.push(navPath);
     return written;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dogsbay",
-  "version": "0.2.0-beta.4",
+  "version": "0.2.0-beta.5",
   "description": "CLI for Dogsbay — scaffold, build, and serve documentation sites with markdown / MkDocs / Obsidian / OpenAPI sources",
   "type": "module",
   "bin": {
@@ -30,14 +30,14 @@
     "picocolors": "^1.1.0",
     "prompts": "^2.4.2",
     "yaml": "^2.8.3",
-    "@dogsbay/format-mkdocs": "0.2.0-beta.4",
-    "@dogsbay/format-astro": "0.2.0-beta.4",
-    "@dogsbay/format-mdx": "0.2.0-beta.4",
-    "@dogsbay/format-starlight": "0.2.0-beta.4",
-    "@dogsbay/format-obsidian": "0.2.0-beta.4",
-    "@dogsbay/format-dogsbay-md": "0.2.0-beta.4",
-    "@dogsbay/format-openapi": "0.2.0-beta.4",
-    "@dogsbay/types": "0.2.0-beta.4"
+    "@dogsbay/format-mkdocs": "0.2.0-beta.5",
+    "@dogsbay/format-astro": "0.2.0-beta.5",
+    "@dogsbay/format-obsidian": "0.2.0-beta.5",
+    "@dogsbay/format-mdx": "0.2.0-beta.5",
+    "@dogsbay/format-dogsbay-md": "0.2.0-beta.5",
+    "@dogsbay/format-starlight": "0.2.0-beta.5",
+    "@dogsbay/format-openapi": "0.2.0-beta.5",
+    "@dogsbay/types": "0.2.0-beta.5"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",