@hutusi/amytis 1.9.0 → 1.11.0

package/public/next-image-export-optimizer-hashes.json

@@ -1,4 +1,74 @@
 {
-    "posts/02-routing-mastery/assets/m-p-model.png": "fDmvlEkZnE-UCvPK4gmDkJD7SU8coOTl4iw5hpsmcWI=",
-    "/screenshot.png": "dGCNrjp1oMIL3NrVh1VDW0K+7Pp-cI5KH6tW4-6o9zg="
+    "books/agentic-design-patterns/images/appendix-a/image1.png": "k8G1J92r2m-rIbN+EDXjtOtXL3Im9pfIF9E+N4gR6+o=",
+    "books/agentic-design-patterns/images/appendix-b/image1.png": "j7jY3StmUJFaDcCc37qmkMNApRPw-hqtxo6xGMEvvSI=",
+    "books/agentic-design-patterns/images/appendix-d/image1.png": "Jz-nZ-kZPaM1XYPAzWY8jJRrmZHH3TOZKMVX6hD-G0I=",
+    "books/agentic-design-patterns/images/appendix-d/image2.png": "flQCnHTEIqAftdXjvY3gwc+OYbcZDaqwr3rtxDU7PjE=",
+    "books/agentic-design-patterns/images/appendix-d/image3.png": "FPPSaVvnYJhlRplp25grIwI0+vmtc9NHl+6EcpXIAic=",
+    "books/agentic-design-patterns/images/appendix-d/image4.png": "TvxBNTKaZCho+W8eTm67fiYmSwDJzwj1AOOguIV+o04=",
+    "books/agentic-design-patterns/images/appendix-d/image5.png": "EPlVRP7VlPQqkF9fawSV43kQg7JKVsjy-dHLFH6LIBY=",
+    "books/agentic-design-patterns/images/appendix-d/image6.png": "s7zF5TgNEQfvkakIHhdHXQ7S5imi4+AOtaD+PG7w0xM=",
+    "books/agentic-design-patterns/images/appendix-g/image1.png": "r-KvQvaqGSwZrN+30Dg6KZx4dEUzKZwPJ+eezw-KH70=",
+    "books/agentic-design-patterns/images/chapter-1/image1.png": "yfUwbocNorvSCdvdxTqQZmmiZsoRWbsn9iby6iKJYFQ=",
+    "books/agentic-design-patterns/images/chapter-1/image2.png": "pisZVOmTdn1Y+qs7sAqTqn04BeR3UngCd17kApWgehk=",
+    "books/agentic-design-patterns/images/chapter-10/image1.png": "aKJwlDxhZkAglLFTGgT8qpjIAlNQ5gV5ovCAnBjwx7M=",
+    "books/agentic-design-patterns/images/chapter-11/image1.png": "n9ou0BpTuPt3kcTEnCJEQRnMKFd9lI666DBxWDJzd3A=",
+    "books/agentic-design-patterns/images/chapter-11/image2.png": "30uw9sGMGnE+jyt++vVURBUQNXe5ty+8i8h+PMw4GfM=",
+    "books/agentic-design-patterns/images/chapter-12/image1.png": "4e4AD2MJFSB3GByGxGVr4VCQ4H+eYkR3oq39KuZhzw8=",
+    "books/agentic-design-patterns/images/chapter-12/image2.png": "1MyjXYovLBeKJmUGnUnx38T-UgkhRfV5opzOcP+OEdw=",
+    "books/agentic-design-patterns/images/chapter-13/image1.png": "PB3msIGhOmq1Oyrv6ubGJZJCvO+dD7XNxZiw5Ck-834=",
+    "books/agentic-design-patterns/images/chapter-14/image1.png": "p-06-D2Vp2x7HMXwmkTNLneS9sjsfSvmTsLTlVUjY5k=",
+    "books/agentic-design-patterns/images/chapter-14/image2.png": "XvXKYbuijYChfq4+MlZYXLBpxTg11ddJ0AFnzvntLPw=",
+    "books/agentic-design-patterns/images/chapter-14/image3.png": "YhmOWyJo3pDKVbKW7RMgTbNrbmsE89RkmaJ2z76vhos=",
+    "books/agentic-design-patterns/images/chapter-14/image4.png": "QBNe+Wt65qdLfkC5MJqaiNBJGMa-DbCm3gCOqfB7ehk=",
+    "books/agentic-design-patterns/images/chapter-15/image1.png": "I90CSqCb8g-h1F0a3sDusDC+LmHdjJTBBk6iFw4ZnJY=",
+    "books/agentic-design-patterns/images/chapter-15/image2.png": "HaxOSZ1f67BhEPa3KXtYAlK0cNm3G4H24dnLXpcgyA0=",
+    "books/agentic-design-patterns/images/chapter-16/image1.png": "Blc0vDhlie6PM3f6QSUX3argbfezTNDOLYhmT9uuS6E=",
+    "books/agentic-design-patterns/images/chapter-16/image2.png": "9-KZ0VOekDwFVL1dEzB9aleyCYF+WU6bx1h3aVNoOAM=",
+    "books/agentic-design-patterns/images/chapter-17/image1.png": "jjGM2Ll5bdszl9xFThVxxJzcq76iYDM1zz8qq2MVVYE=",
+    "books/agentic-design-patterns/images/chapter-17/image2.png": "O1KLKrodQew2Pdd7k3vBZhE4dCiK9u6JLvXSXy7h1do=",
+    "books/agentic-design-patterns/images/chapter-17/image3.png": "Sd9qFn-U5g8dhinNPJEk5LaeaN8DFH2FCus1Wcm6oSg=",
+    "books/agentic-design-patterns/images/chapter-17/image4.png": "eV38Dg78Y2Qo-0sqlsvcK8-p19fgRJqwx42sBKTzC+s=",
+    "books/agentic-design-patterns/images/chapter-17/image5.png": "bgKPC1TSVlvfkCG5vILT-4j9gJU7LyeGFkXO+8OFdXE=",
+    "books/agentic-design-patterns/images/chapter-17/image6.png": "qMku-C8gxZEFQEl8Qq8Y1ld5zUntH1Q-2izcb4QxLA0=",
+    "books/agentic-design-patterns/images/chapter-17/image7.png": "20wopLVN59okB+C-F+U5vi79Lg0uH+5P6wIj72gV7wU=",
+    "books/agentic-design-patterns/images/chapter-18/image1.png": "kjCIoNU60icXMOHmYNXWNMjdi5nIdJZYDSp0WFnG2Es=",
+    "books/agentic-design-patterns/images/chapter-19/image1.png": "XrQVFAWWsMcwKHgcqx8jGLy4q+6RbiGZ5CuKpRlk4Y0=",
+    "books/agentic-design-patterns/images/chapter-19/image2.png": "URHY+cH5AR4KvA6HPnXPhZd5fwwGdlwvFvxgCdTkWjg=",
+    "books/agentic-design-patterns/images/chapter-19/image3.png": "VLp1qFNcaj126-RuATV6ikSsow8lrXsn3EuZotvR5N4=",
+    "books/agentic-design-patterns/images/chapter-19/image4.png": "CnyNMtPiFSdzqrewwLgPu2X1CKdgMqCl8T8+d7lw2Fw=",
+    "books/agentic-design-patterns/images/chapter-2/image1.png": "C6odPDB9zhN28YxfU909JAoQWe0mRm3lUsyG8NzHBWk=",
+    "books/agentic-design-patterns/images/chapter-20/image1.png": "qkzjKCUjVFD8IWyoZQXuBuZ4zFJ0Y0CQfKepVcrnEN0=",
+    "books/agentic-design-patterns/images/chapter-21/image1.png": "3KpW6uLQDru7DFDdgi6ntD5WhuGS383aYwlQLWoVX+w=",
+    "books/agentic-design-patterns/images/chapter-21/image2.png": "wSXMrRuAnhQcEM5fg-sJ5ZikM3olj0vz6FDKWKIUyW8=",
+    "books/agentic-design-patterns/images/chapter-3/image1.png": "iHnUE2kckwzB0xiIySSe4O34c6bIs3VlO7pUQBmV8iI=",
+    "books/agentic-design-patterns/images/chapter-3/image2.png": "9-G6F+aBymQVTnDQy4zwsXDZMkLaYKBe4xw26tC24R8=",
+    "books/agentic-design-patterns/images/chapter-4/image1.png": "8h0PBlqt+JFo7Y803cA9MgfTe8TZeZd6te9l+WEsIss=",
+    "books/agentic-design-patterns/images/chapter-4/image2.png": "p-arzpUPFdnKmzTOKaDQys5Eml0jHA7VuUV0FyLYpqM=",
+    "books/agentic-design-patterns/images/chapter-5/image1.png": "XE5qhAklrW-7eVf7T9x9vo4xQX3WesZjZ9IjuyeSUkc=",
+    "books/agentic-design-patterns/images/chapter-5/image2.png": "MqUdsG5aXQECft+lsCRTeMIJP-YzxWFHC8HdNzio6aw=",
+    "books/agentic-design-patterns/images/chapter-6/image1.png": "t6mFrbVSNJYF73t+Q+YydXdwRQr1c4yIUkySvCelw1I=",
+    "books/agentic-design-patterns/images/chapter-6/image2.png": "zvwqWis6Ad7Iv1-wgYtTgz2ItXsno2PetcHRHon0-wY=",
+    "books/agentic-design-patterns/images/chapter-6/image3.png": "al-H2S7UznxQzP3KT3N0lCTNd83B45bqbPppuhSphy0=",
+    "books/agentic-design-patterns/images/chapter-6/image4.png": "u2k2jHjTOABLTlJ3OsxkGyCoOR-fwHeDmTXMACbtQ+4=",
+    "books/agentic-design-patterns/images/chapter-7/image1.png": "izX9YjrJ+gHGOiR9RHbuMIupCE2zyB01w-gwJAJr4Is=",
+    "books/agentic-design-patterns/images/chapter-7/image2.png": "-0zrZR8CNZqtuyaBRwUbZSfthKwuqrBu4fLar9L4Clg=",
+    "books/agentic-design-patterns/images/chapter-7/image3.png": "dKr7VICWOTc-ZRhm4Aaokz+xPZ8IXS0SiDOJeF1Y03c=",
+    "books/agentic-design-patterns/images/chapter-8/image1.png": "GWG47Om+9GwRvl8x-X269Sa-Mv3rqkW2xkx1WIB-I-E=",
+    "books/agentic-design-patterns/images/chapter-9/image1.png": "fIZ4QE7EIQSAv0K2GmU99OmTBAkpvnYUsFFScCv6VPI=",
+    "books/agentic-design-patterns/images/chapter-9/image2.png": "6y-8OjY7oEedk5ZhUUU2YIU3tjMxIzpnxcDxIRWPGpI=",
+    "books/agentic-design-patterns/images/chapter-9/image3.png": "69nSkOOPfX9FkIJGhKIrhSuCOZt29L5UAukVXfMXN2E=",
+    "books/agentic-design-patterns/images/chapter-9/image4.png": "GQCpjBMz5DRxsHIA8-73IMsxeBPc5ZTMaIsx2iihMME=",
+    "books/agentic-design-patterns/images/cover.png": "R47dqw-ws79m6VBfzhWuLi9ihoCaU7JcezquBAB1-bQ=",
+    "images/amytis-screenshot.jpg": "t9tzciqJPsNz1hlixAFLrrvD4Fsaih2Kbd1Jd2C-fqs=",
+    "images/antelope-canyon.jpg": "xuP3HlbwqA4z1Hsq7s1u2u61yN3SHzIMUd6Wl5yqgK8=",
+    "images/avatar.jpg": "SUGxOhDUD96YiVxZJkVJ6ou4W5MdCJ9hTBQMSQanZOM=",
+    "images/cappadocia.jpg": "EE2Mt8d9ERKd40SfwyhjFsejZLhFx1SfSAQmlu+TQOo=",
+    "images/flowers.jpg": "Lq9dhpZvAIgkYnijDsFIzrKiv8trdM-cUnl-5Y86PuM=",
+    "images/galaxy.jpg": "-3YwMkU3PGsm4P2yNsA2S02XRL1j0KbBh6nWKwy0hYc=",
+    "images/lake.jpg": "imAORQhxpmoU3jzKBMNFJuFSa0UgiSf2Dmea5Rj8-8M=",
+    "images/mountains.jpg": "FsrkZws9EKMqHCk1Hc6i6nEIcTRcrMBa4ddgqR6oRaI=",
+    "images/screenshot.png": "FAqbAgLRbWbYq9yJ4iggq2aKxRD8hdeDICc3DI14yhg=",
+    "images/vibrant-waves.avif": "pP6wNch0dvCr+HGjkA8zIT6ZuZCSSofiVkG922udk54=",
+    "images/wechat-qr.jpg": "DNIzz0Wcl8WP0h-jHHgZ9LEvf3ZKOXHgxlvpw3gK2ME=",
+    "posts/02-routing-mastery/assets/m-p-model.png": "fDmvlEkZnE-UCvPK4gmDkJD7SU8coOTl4iw5hpsmcWI="
 }

package/scripts/deploy.ts

@@ -0,0 +1,77 @@
+import { spawnSync } from 'child_process';
+import fs from 'fs';
+
+// ─── Argument parsing ─────────────────────────────────────────────────────────
+
+function flag(name: string): string | undefined {
+  const idx = process.argv.indexOf(`--${name}`);
+  if (idx === -1) return undefined;
+  const value = process.argv[idx + 1];
+  // Treat missing or another flag as absent
+  return value && !value.startsWith('--') ? value : undefined;
+}
+
+// Flags take priority over .env / .env.local values (loaded automatically by Bun)
+const host     = flag('host')     ?? process.env.DEPLOY_HOST;
+const user     = flag('user')     ?? process.env.DEPLOY_USER;
+const password = flag('password') ?? process.env.DEPLOY_PASSWORD;
+const path     = flag('path')     ?? process.env.DEPLOY_PATH ?? '/var/www/html';
+
+// ─── Validation ───────────────────────────────────────────────────────────────
+
+const missing = (['host', 'user', 'password'] as const).filter(k => !({ host, user, password }[k]));
+if (missing.length > 0) {
+  console.error(`Missing required value(s): ${missing.map(k => `--${k}`).join(', ')}`);
+  console.error('');
+  console.error('Provide them as flags or set in .env.local:');
+  console.error('  DEPLOY_HOST=<ip>');
+  console.error('  DEPLOY_USER=<user>');
+  console.error('  DEPLOY_PASSWORD=<password>');
+  console.error('  DEPLOY_PATH=<remote-path>   (optional, default: /var/www/html)');
+  console.error('');
+  console.error('Usage: bun run deploy [--host <ip>] [--user <user>] [--password <pass>] [--path <path>]');
+  process.exit(1);
+}
+
+if (!fs.existsSync('out')) {
+  console.error('Error: out/ directory not found. Run `bun run build` first.');
+  process.exit(1);
+}
+
+const check = spawnSync('which', ['sshpass']);
+if (check.status !== 0) {
+  console.error('Error: sshpass not found. Install it first:');
+  console.error('  macOS: brew install hudochenkov/sshpass/sshpass');
+  console.error('  Linux: apt install sshpass');
+  process.exit(1);
+}
+
+// ─── Deploy ───────────────────────────────────────────────────────────────────
+
+const destination = `${user}@${host}:${path}/`;
+console.log(`Deploying out/ → ${destination}`);
+
+const rsync = spawnSync(
+  'sshpass',
+  ['-p', password!, 'rsync', '-avz', '--delete', '-e', 'ssh -o StrictHostKeyChecking=accept-new', 'out/', destination],
+  { stdio: 'inherit' }
+);
+
+if (rsync.status !== 0) {
+  console.error('\nDeploy failed.');
+  process.exit(rsync.status ?? 1);
+}
+
+console.log('\nReloading nginx...');
+
+const reload = spawnSync(
+  'sshpass',
+  ['-p', password!, 'ssh', '-o', 'StrictHostKeyChecking=accept-new', `${user}@${host}`, 'nginx -s reload'],
+  { stdio: 'inherit' }
+);
+
+if (reload.status !== 0) {
+  console.warn('Warning: nginx reload failed (site was still deployed).');
+}
+
+console.log('Done.');

package/site.config.example.ts

@@ -0,0 +1,268 @@
+// Single-language starter template for Amytis.
+// Copy this file to site.config.ts and customize it for your site.
+//
+// This template has i18n disabled. All locale-aware fields use plain strings.
+// To add multi-language support later, switch to { en: '...', zh: '...' } objects
+// and set i18n.enabled: true with your locales.
+
+export interface NavChildItem {
+  name: string;
+  url: string;
+  external?: boolean;
+  dividerBefore?: boolean; // render a separator line before this item
+}
+
+export interface NavItem {
+  name: string;
+  url: string;
+  weight: number;
+  external?: boolean;
+  dropdown?: string[];
+  children?: NavChildItem[]; // static sub-links rendered as a dropdown
+}
+
+// Defined up-front so nav and posts config stay in sync — change once here
+const postsBasePath = 'posts'; // Change to e.g. 'articles' to serve all posts at /articles/[slug]
+
+// Defined up-front so footer.connect can reference these URLs without duplication
+const social = {
+  github: "https://github.com/your-username",
+  twitter: "https://twitter.com/your-username",
+  email: "mailto:you@example.com",
+};
+
+export const siteConfig = {
+
+  // ── Site identity ─────────────────────────────────────────────────────────
+  title: "My Garden",
+  logo: {
+    // Path to navbar logo image served from public/ (leave empty for the default built-in icon)
+    // Accepts SVG, PNG, etc. — e.g. "/logo.svg" or "/images/my-logo.png"
+    src: "",
+    // Path to favicon served from public/ (defaults to /icon.svg)
+    favicon: "/icon.svg",
+  },
+  description: "A personal digital garden — notes, articles, and ideas.",
+  baseUrl: "https://example.com", // Replace with your actual domain
+  ogImage: "/og-image.png", // Default OG/social preview image — place a 1200×630 PNG at public/og-image.png
+  footerText: `© ${new Date().getFullYear()} My Garden. All rights reserved.`,
+
+  // ── i18n ──────────────────────────────────────────────────────────────────
+  i18n: {
+    // i18n is disabled: the language switcher is hidden and defaultLocale is always used.
+    // To enable multi-language support, set enabled: true, add more locales, and
+    // convert plain string fields to locale maps: e.g. title: { en: '...', zh: '...' }
+    enabled: false,
+    defaultLocale: 'en',
+    locales: ['en'],
+  },
+
+  // ── Navigation ────────────────────────────────────────────────────────────
+  nav: [
+    { name: "Posts", url: `/${postsBasePath}`, weight: 1 },
+    { name: "Series", url: "/series", weight: 2 },
+    { name: "About", url: "/about", weight: 3 },
+    { name: "More", url: "", weight: 4, children: [
+      { name: "Archive", url: "/archive" },
+      { name: "Tags", url: "/tags" },
+      { name: "Subscribe", url: "/subscribe", dividerBefore: true },
+    ]},
+  ] as NavItem[],
+
+  // ── Footer ────────────────────────────────────────────────────────────────
+  footer: {
+    explore: [
+      { name: "Archive", url: "/archive", weight: 1 },
+      { name: "Tags", url: "/tags", weight: 2 },
+      { name: "About", url: "/about", weight: 3 },
+    ],
+    connect: [
+      { name: "GitHub", url: social.github, weight: 1 },
+      { name: "X (Twitter)", url: social.twitter, weight: 2 },
+      { name: "RSS Feed", url: "/feed.xml", weight: 3 },
+      { name: "Subscribe", url: "/subscribe", weight: 4 },
+    ],
+    builtWith: {
+      show: true,
+      url: "https://github.com/hutusi/amytis",
+      text: "Built with Amytis",
+    },
+    // bottomLinks: [
+    //   { text: '京ICP备12345678号', url: 'https://beian.miit.gov.cn/' },
+    // ],
+    bottomLinks: [],
+  },
+
+  // ── Social & sharing ──────────────────────────────────────────────────────
+  social,
+  share: {
+    enabled: true,
+    // Supported: twitter, facebook, linkedin, weibo, reddit, hackernews,
+    //            telegram, bluesky, mastodon, douban, zhihu, copy
+    platforms: ['twitter', 'facebook', 'linkedin', 'copy'],
+  },
+  subscribe: {
+    substack: '',       // Substack publication URL, e.g., 'https://yourname.substack.com'
+    telegram: '',       // Telegram channel URL, e.g., 'https://t.me/yourchannel'
+    wechat: {
+      qrCode: '',       // Path to QR image in public/, e.g., '/images/wechat-qr.png'
+      account: '',      // WeChat official account ID/name shown below QR
+    },
+    email: '',          // Newsletter/mailing list URL (distinct from social.email contact address)
+  },
+
+  // ── Features ──────────────────────────────────────────────────────────────
+  features: {
+    posts: {
+      enabled: true,
+      name: "Articles",
+    },
+    series: {
+      enabled: true,
+      name: "Series",
+    },
+    books: {
+      enabled: false,
+      name: "Books",
+    },
+    flow: {
+      enabled: false,
+      name: "Flow",
+    },
+  },
+
+  // ── Homepage ──────────────────────────────────────────────────────────────
+  hero: {
+    tagline: "My Personal Digital Garden",
+    title: "A place for ideas to grow.",
+    subtitle: "Notes, articles, and explorations — written for curiosity, shared for connection.",
+  },
+  homepage: {
+    sections: [
+      { id: 'hero',            enabled: true, weight: 1 },
+      { id: 'featured-posts',  enabled: true, weight: 2, maxItems: 4 },
+      { id: 'latest-posts',    enabled: true, weight: 3, maxItems: 3 },
+      { id: 'recent-flows',    enabled: false, weight: 4, maxItems: 8 },
+      { id: 'featured-series', enabled: true, weight: 5, maxItems: 6, scrollThreshold: 2 },
+      { id: 'featured-books',  enabled: false, weight: 6, maxItems: 4 },
+    ],
+  },
+
+  // ── Content ───────────────────────────────────────────────────────────────
+  pagination: {
+    posts: 10,
+    series: 5,
+    flows: 20,
+    notes: 20,
+  },
+  posts: {
+    basePath: postsBasePath,
+    toc: true,
+    showFuturePosts: false,
+    includeDateInUrl: false,
+    // trailingSlash is configured in next.config.ts (Next.js handles URL normalization)
+    authors: {
+      // Default author names applied when a post has no author in its frontmatter.
+      // Falls back to series authors first, then to this list.
+      default: ["Your Name"] as string[],
+      showInHeader: true,   // Show author byline below the post title
+      showAuthorCard: true, // Show author bio card at the end of the post
+    },
+    // Series slugs whose posts are hidden from the main posts listing.
+    // Posts remain accessible via their series page and direct URLs.
+    excludeFromListing: [] as string[],
+    archive: {
+      showAuthors: true,
+    },
+  },
+  series: {
+    // Per-series custom URL prefix for posts within that series
+    // e.g., { 'weeklies': 'weeklies' } → posts served at /weeklies/[slug]
+    customPaths: {} as Record<string, string>,
+  },
+  flows: {
+    recentCount: 5,
+  },
+
+  feed: {
+    maxItems: 20,                                           // Max items per feed (0 = no limit)
+    format: 'rss' as 'rss' | 'atom' | 'both',              // Format(s) to serve and advertise
+    content: 'full' as 'excerpt' | 'full',                  // Full post content or excerpt only
+    includeFlows: false,                                    // Include flow notes alongside posts
+  },
+
+  // ── Images ────────────────────────────────────────────────────────────────
+  images: {
+    // CDN base URL for serving images (leave empty to serve locally)
+    // e.g., "https://cdn.example.com" or "https://your-bucket.r2.dev"
+    // When set, local image paths like /posts/slug/images/cover.jpg are rewritten
+    // to https://cdn.example.com/posts/slug/images/cover.jpg at render time.
+    cdnBaseUrl: "",
+  },
+
+  // ── Appearance ────────────────────────────────────────────────────────────
+  themeColor: 'default', // 'default' | 'blue' | 'rose' | 'amber'
+
+  // ── Browser compatibility warning ─────────────────────────────────────────
+  browserCheck: {
+    // URL shown in the outdated-browser banner. Set to '' to hide the link
+    // (useful for corporate/intranet deployments where IT manages upgrades).
+    updateUrl: 'https://browsehappy.com/',
+  },
+
+  // ── Analytics ─────────────────────────────────────────────────────────────
+  analytics: {
+    providers: [], // enable one or many: 'umami' | 'plausible' | 'google'
+    umami: {
+      websiteId: process.env.NEXT_PUBLIC_UMAMI_WEBSITE_ID || '', // Your Umami Website ID
+      src: process.env.NEXT_PUBLIC_UMAMI_URL || 'https://us.umami.is/script.js', // Default or self-hosted URL
+    },
+    plausible: {
+      domain: '', // Your domain
+      src: 'https://plausible.io/js/script.js',
+    },
+    google: {
+      measurementId: '', // G-XXXXXXXXXX
+    },
+  },
+
+  // ── Comments ──────────────────────────────────────────────────────────────
+  comments: {
+    provider: null, // 'giscus' | 'disqus' | null
+    giscus: {
+      repo: 'your-username/your-repo', // username/repo
+      repoId: '',
+      category: 'Announcements',
+      categoryId: '',
+    },
+    disqus: {
+      shortname: '',
+    },
+  },
+
+  // ── Authors ───────────────────────────────────────────────────────────────
+  authors: {
+    // Map display name (as used in post frontmatter) to author profile.
+    // Example:
+    // "Author Name": {
+    //   bio: "Short bio shown in author card below each post.",
+    //   avatar: "/images/authors/author-name.jpg", // path under public/
+    //   social: [
+    //     { image: "/images/authors/wechat-qr.jpg", description: "WeChat Official Account" },
+    //   ],
+    // },
+    "Your Name": {
+      bio: "Write a short bio here.",
+      avatar: "/images/avatar.jpg",
+      social: [],
+    },
+  } as Record<string, {
+    bio?: string;
+    avatar?: string;  // Avatar image path served from public/
+    social?: Array<{
+      image: string;       // Social image (e.g. QR code) path served from public/
+      description: string; // Label shown below the image
+    }>;
+  }>,
+
+};

package/site.config.ts

@@ -25,6 +25,13 @@ export const siteConfig = {
 
   // ── Site identity ─────────────────────────────────────────────────────────
   title: { en: "Amytis", zh: "Amytis" },
+  logo: {
+    // Path to navbar logo image served from public/ (leave empty for the default built-in icon)
+    // Accepts SVG, PNG, etc. — e.g. "/logo.svg" or "/images/my-logo.png"
+    src: "",
+    // Path to favicon served from public/ (defaults to /icon.svg)
+    favicon: "/icon.svg",
+  },
   description: { en: "Amytis — an elegant open-source framework for building your personal digital garden.", zh: "Amytis — 优雅的开源数字花园框架。" },
   baseUrl: "https://example.com", // Replace with your actual domain
   ogImage: "/og-image.png", // Default OG/social preview image — place a 1200×630 PNG at public/og-image.png
@@ -32,6 +39,11 @@ export const siteConfig = {
 
   // ── i18n ──────────────────────────────────────────────────────────────────
   i18n: {
+    // Set enabled: false to disable multi-language support entirely.
+    // The language switcher will be hidden and the defaultLocale is always used.
+    // When disabled, all locale-aware fields (title, description, hero, etc.)
+    // accept plain strings instead of { en: '...', zh: '...' } objects.
+    enabled: true,
     defaultLocale: 'en',
     locales: ['en', 'zh'],
   },
@@ -61,7 +73,7 @@ export const siteConfig = {
     ],
     connect: [
       { name: "GitHub", url: social.github, weight: 1 },
-      { name: "Twitter", url: social.twitter, weight: 2 },
+      { name: "X (Twitter)", url: social.twitter, weight: 2 },
       { name: "RSS Feed", url: "/feed.xml", weight: 3 },
       { name: "Subscribe", url: "/subscribe", weight: 4 },
     ],
@@ -70,6 +82,14 @@ export const siteConfig = {
       url: "https://github.com/hutusi/amytis",
       text: { en: "Built with Amytis", zh: "基于 Amytis 构建" },
     },
+    // Optional custom links shown in the footer bottom bar.
+    // Common uses: ICP registration (China), PSB registration, cookie policy, sitemap, etc.
+    // Example:
+    // bottomLinks: [
+    //   { text: '京ICP备12345678号', url: 'https://beian.miit.gov.cn/' },
+    //   { text: 'Cookie Policy' },     // url is optional — renders as plain text
+    // ],
+    bottomLinks: [] as { text: string | Record<string, string>; url?: string }[],
   },
 
   // ── Social & sharing ──────────────────────────────────────────────────────
@@ -119,11 +139,11 @@ export const siteConfig = {
   homepage: {
     sections: [
       { id: 'hero',            enabled: true, weight: 1 },
-      { id: 'featured-series', enabled: true, weight: 2, maxItems: 6, scrollThreshold: 2 },
-      { id: 'featured-books',  enabled: true, weight: 3, maxItems: 4, scrollThreshold: 2 },
-      { id: 'featured-posts',  enabled: true, weight: 4, maxItems: 4, scrollThreshold: 1 },
-      { id: 'latest-posts',    enabled: true, weight: 5, maxItems: 5 },
-      { id: 'recent-flows',    enabled: true, weight: 6, maxItems: 5 },
+      { id: 'featured-posts',  enabled: true, weight: 2, maxItems: 4 },
+      { id: 'latest-posts',    enabled: true, weight: 3, maxItems: 3 },
+      { id: 'recent-flows',    enabled: true, weight: 4, maxItems: 8 },
+      { id: 'featured-series', enabled: true, weight: 5, maxItems: 6, scrollThreshold: 2 },
+      { id: 'featured-books',  enabled: true, weight: 6, maxItems: 4 },
     ],
   },
 
@@ -135,17 +155,48 @@ export const siteConfig = {
     notes: 20,
   },
   posts: {
+    basePath: 'posts', // Change to e.g. 'articles' to serve all posts at /articles/[slug]
     toc: true,
     showFuturePosts: false,
     includeDateInUrl: false,
     // trailingSlash is configured in next.config.ts (Next.js handles URL normalization)
+    authors: {
+      // Default author names applied when a post has no author in its frontmatter.
+      // Falls back to series authors first, then to this list.
+      default: ["John Hu"] as string[],
+      showInHeader: true,   // Show author byline below the post title
+      showAuthorCard: true, // Show author bio card at the end of the post
+    },
+    // Series slugs whose posts are hidden from the main posts listing.
+    // Posts remain accessible via their series page and direct URLs.
+    excludeFromListing: [] as string[],
     archive: {
       showAuthors: true,
     },
   },
+  series: {
+    // Per-series custom URL prefix for posts within that series
+    // e.g., { 'weeklies': 'weeklies' } → posts served at /weeklies/[slug]
+    customPaths: {} as Record<string, string>,
+  },
   flows: {
     recentCount: 5,
   },
+  feed: {
+    maxItems: 20,                                           // Max items per feed (0 = no limit)
+    format: 'rss' as 'rss' | 'atom' | 'both',              // Format(s) to serve and advertise
+    content: 'full' as 'excerpt' | 'full',                  // Full post content or excerpt only
+    includeFlows: false,                                    // Include flow notes alongside posts
+  },
+
+  // ── Images ────────────────────────────────────────────────────────────────
+  images: {
+    // CDN base URL for serving images (leave empty to serve locally)
+    // e.g., "https://cdn.example.com" or "https://your-bucket.r2.dev"
+    // When set, local image paths like /posts/slug/images/cover.jpg are rewritten
+    // to https://cdn.example.com/posts/slug/images/cover.jpg at render time.
+    cdnBaseUrl: "",
+  },
 
   // ── Appearance ────────────────────────────────────────────────────────────
   themeColor: 'default', // 'default' | 'blue' | 'rose' | 'amber'
@@ -159,7 +210,7 @@ export const siteConfig = {
 
   // ── Analytics ─────────────────────────────────────────────────────────────
   analytics: {
-    provider: 'umami', // 'umami' | 'plausible' | 'google' | null
+    providers: ['umami'] as ('umami' | 'plausible' | 'google')[], // enable one or many; [] disables analytics
     umami: {
       websiteId: process.env.NEXT_PUBLIC_UMAMI_WEBSITE_ID || '', // Your Umami Website ID
       src: process.env.NEXT_PUBLIC_UMAMI_URL || 'https://us.umami.is/script.js', // Default or self-hosted URL
@@ -189,8 +240,29 @@ export const siteConfig = {
 
   // ── Authors ───────────────────────────────────────────────────────────────
   authors: {
-    // Map display name (as used in post frontmatter) to author profile
-    // "Author Name": { bio: "Short bio shown in author card below each post." },
-  } as Record<string, { bio?: string }>,
+    // Map display name (as used in post frontmatter) to author profile.
+    // Example:
+    // "Author Name": {
+    //   bio: "Short bio shown in author card below each post.",
+    //   avatar: "/images/authors/author-name.jpg", // path under public/
+    //   social: [
+    //     { image: "/images/authors/wechat-qr.jpg", description: "WeChat Official Account" },
+    //   ],
+    // },
+    "John Hu": {
+      bio: "Coder, Writer, Creator.",
+      avatar: "/images/avatar.jpg",
+      social: [
+        { image: "/images/wechat-qr.jpg", description: "Follow on WeChat" },
+      ],
+    },
+  } as Record<string, {
+    bio?: string;
+    avatar?: string;  // Avatar image path served from public/
+    social?: Array<{
+      image: string;       // Social image (e.g. QR code) path served from public/
+      description: string; // Label shown below the image
+    }>;
+  }>,
 
 };