undocs 0.2.24 → 0.2.26

package/app/modules/og-image/runtime/handler.ts

@@ -7,7 +7,12 @@ export default defineLazyEventHandler(async () => {
 
   // Read server assets
   const storage = useStorage()
-  const fontNames = await storage.getKeys('assets:og-image:fonts:')
+  // https://github.com/unjs/unstorage/issues/477
+  // const fontNames = await storage.getKeys('assets:og-image:fonts:')
+  const fontNames = ['200', '300', '400', '500', '600', '700', '800', '900'].flatMap((weight) => [
+    `assets:og-image:fonts:nunito-latin-${weight}-normal.woff2`,
+    `assets:og-image:fonts:nunito-latin-ext-${weight}-normal.woff2`,
+  ])
   const fontBuffers = await Promise.all(fontNames.map((name) => storage.getItemRaw(name)))
 
   // Load icon

package/app/pages/[...slug].vue

@@ -110,8 +110,8 @@ onMounted(() => {
             :links="[
               {
                 icon: 'i-ph-pen-duotone',
-                label: 'Edit this page on GitHub',
-                to: `https://github.com/${appConfig.docs.github}/edit/main/docs/${page._file}`,
+                label: `Edit this page ${page.automd ? '(some contents are generated with automd from source)' : ''}`,
+                to: `https://github.com/${appConfig.docs.github}/edit/${appConfig.docs.branch || 'main'}/docs/${page._file}`,
                 target: '_blank',
               },
             ]"

package/app/server/plugins/content.ts

@@ -1,5 +1,18 @@
 // @ts-ignore
 export default defineNitroPlugin((nitroApp) => {
+  nitroApp.hooks.hook('content:file:beforeParse', (file) => {
+    if (typeof file.body !== 'string') {
+      return // can be json meta
+    }
+    if (file.body.includes('<!-- automd:')) {
+      // Add meta
+      if (file.body.startsWith('---')) {
+        file.body = file.body.replace('---', '---\nautomd: true\n')
+      } else {
+        file.body = `---\nautomd: true\n---\n${file.body}`
+      }
+    }
+  })
   nitroApp.hooks.hook('content:file:afterParse', (file: ContentFile) => {
     // Filter out non-markdown files
     if (!file._id?.endsWith('.md')) {

package/cli/setup.mjs

@@ -1,5 +1,6 @@
 import { fileURLToPath } from 'node:url'
 import { resolve } from 'node:path'
+import { execSync } from 'node:child_process'
 import { loadConfig, watchConfig } from 'c12'
 
 const appDir = fileURLToPath(new URL('../app', import.meta.url))
@@ -62,6 +63,7 @@ export async function setupDocs(docsDir, opts = {}) {
       },
       docs: {
         github: docsconfig.github,
+        branch: docsconfig.branch || getGitBranch() || 'main',
       },
     },
     nitro: {
@@ -97,3 +99,23 @@ function inferSiteURL() {
     process.env.CF_PAGES_URL // Cloudflare Pages
   )
 }
+
+function getGitBranch() {
+  const envName =
+    process.env.CF_PAGES_BRANCH ||
+    process.env.CI_COMMIT_BRANCH ||
+    process.env.VERCEL_BRANCH_URL ||
+    process.env.BRANCH ||
+    process.env.GITHUB_REF_NAME
+  if (envName && envName !== 'HEAD') {
+    return envName
+  }
+  try {
+    const branch = execSync('git rev-parse --abbrev-ref HEAD').toString().trim()
+    if (branch && branch !== 'HEAD') {
+      return branch
+    }
+  } catch {
+    // Ignore
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "undocs",
-  "version": "0.2.24",
+  "version": "0.2.26",
   "repository": "unjs/undocs",
   "license": "MIT",
   "type": "module",

package/schema/config.d.ts

@@ -5,6 +5,7 @@ export interface DocsConfig {
   shortDescription?: string
   url?: string
   github?: string
+  branch?: string
   themeColor?: string
   redirects?: Record<string, string>
   automd?: unknown

package/schema/config.json

@@ -30,6 +30,10 @@
       "type": "string",
       "description": "The GitHub repository for the documentation site."
     },
+    "branch": {
+      "type": "string",
+      "description": "The branch of the GitHub repository for the documentation site."
+    },
     "themeColor": {
       "type": "string",
       "description": "The theme color of the documentation site.\nIt will be used as the `theme-color` meta tag and a full palette of colors will be generated from it."