@hutusi/amytis 1.5.6 → 1.7.0

package/site.config.ts

@@ -1,67 +1,140 @@
+export interface NavItem {
+  name: string;
+  url: string;
+  weight: number;
+  dropdown?: string[];
+}
+
+// Defined up-front so footer.connect can reference these URLs without duplication
+const social = {
+  github: "https://github.com/hutusi/amytis",
+  twitter: "https://twitter.com/hutusi",
+  email: "mailto:huziyong@gmail.com",
+};
+
 export const siteConfig = {
+
+  // ── Site identity ─────────────────────────────────────────────────────────
   title: { en: "Amytis", zh: "Amytis" },
   description: { en: "A minimalist digital garden for growing thoughts and sharing knowledge.", zh: "一个极简的数字花园，用于培育思想和分享知识。" },
   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: { en: `© ${new Date().getFullYear()} Amytis. All rights reserved.`, zh: `© ${new Date().getFullYear()} Amytis. 保留所有权利。` },
-  nav: [
-    { name: "Home", url: "/", weight: 1 },
-    { name: "Flow", url: "/flows", weight: 1.1 },
-    { name: "Books", url: "/books", weight: 1.3 },
-    { name: "Series", url: "/series", weight: 1.5 },
-    { name: "Archive", url: "/archive", weight: 2 },
-    { name: "Tags", url: "/tags", weight: 3 },
-    { name: "About", url: "/about", weight: 4 },
-  ],
-  social: {
-    github: "https://github.com/hutusi/amytis",
-    twitter: "https://twitter.com/hutusi",
-    email: "mailto:huziyong@gmail.com",
+
+  // ── i18n ──────────────────────────────────────────────────────────────────
+  i18n: {
+    defaultLocale: 'en',
+    locales: ['en', 'zh'],
   },
-  series: {
-    navbar: ["digital-garden", "markdown-showcase", "ai-nexus-weekly"], // Slugs of series to show in navbar
+
+  // ── Navigation ────────────────────────────────────────────────────────────
+  nav: [
+    { name: "Flow", url: "/flows", weight: 1 },
+    { name: "Posts", url: "/posts", weight: 2 },
+    { name: "Series", url: "/series", weight: 3, dropdown: ["digital-garden", "markdown-showcase", "ai-nexus-weekly"] },
+    { name: "Books", url: "/books", weight: 4, dropdown: [] },
+    { name: "About", url: "/about", weight: 5 },
+  ] as NavItem[],
+
+  // ── Footer ────────────────────────────────────────────────────────────────
+  footer: {
+    explore: [
+      { name: "Archive", url: "/archive", weight: 1 },
+      { name: "Tags", url: "/tags", weight: 2 },
+      { name: "Links", url: "/links", weight: 3 },
+      { name: "About", url: "/about", weight: 4 },
+    ],
+    connect: [
+      { name: "GitHub", url: social.github, weight: 1 },
+      { name: "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: { en: "Built with Amytis", zh: "基于 Amytis 构建" },
+    },
   },
-  books: {
-    navbar: [] as string[], // Slugs of books to show in navbar dropdown
+
+  // ── Social & sharing ──────────────────────────────────────────────────────
+  social,
+  share: {
+    enabled: true,
+    // Supported: twitter, facebook, linkedin, weibo, reddit, hackernews,
+    //            telegram, bluesky, mastodon, douban, zhihu, copy
+    platforms: ['twitter', 'facebook', 'linkedin', 'weibo', 'copy'],
   },
-  archive: {
-    showAuthors: true,
+  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)
   },
-  pagination: {
-    posts: 5,
-    series: 1,
-    flows: 20,
+
+  // ── Features ──────────────────────────────────────────────────────────────
+  features: {
+    posts: {
+      enabled: true,
+      name: { en: "Posts", zh: "文章" },
+    },
+    series: {
+      enabled: true,
+      name: { en: "Series", zh: "系列" },
+    },
+    books: {
+      enabled: true,
+      name: { en: "Books", zh: "书籍" },
+    },
+    flows: {
+      enabled: true,
+      name: { en: "Flow", zh: "随笔" },
+    },
   },
-  includeDateInUrl: false,
-  // trailingSlash is configured in next.config.ts (Next.js handles URL normalization)
-  showFuturePosts: false,
-  toc: true,
-  themeColor: 'default', // 'default' | 'blue' | 'rose' | 'amber'
+
+  // ── Homepage ──────────────────────────────────────────────────────────────
   hero: {
     tagline: { en: "Digital Garden", zh: "数字花园" },
     title: { en: "Cultivating Digital Knowledge", zh: "培育数字知识" },
     subtitle: { en: "A minimalist digital garden for growing thoughts and sharing knowledge.", zh: "一个极简的数字花园，用于培育思想和分享知识。" },
   },
-  about: {
-    title: { en: "About Amytis", zh: "关于 Amytis" },
-    subtitle: { en: "Learn more about the philosophy and technology behind this digital garden.", zh: "了解这座数字花园背后的理念与技术。" },
+  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 },
+    ],
   },
-  flows: {
-    recentCount: 5,
+
+  // ── Content ───────────────────────────────────────────────────────────────
+  pagination: {
+    posts: 5,
+    series: 1,
+    flows: 20,
   },
-  featured: {
-    series: {
-      scrollThreshold: 2,  // Enable scrolling when more than this number
-      maxItems: 6,
-    },
-    stories: {
-      scrollThreshold: 1,  // Enable scrolling when more than this number
-      maxItems: 4,
+  posts: {
+    toc: true,
+    showFuturePosts: false,
+    includeDateInUrl: false,
+    // trailingSlash is configured in next.config.ts (Next.js handles URL normalization)
+    archive: {
+      showAuthors: true,
     },
   },
-  i18n: {
-    defaultLocale: 'en',
-    locales: ['en', 'zh'],
+  flows: {
+    recentCount: 5,
   },
+
+  // ── Appearance ────────────────────────────────────────────────────────────
+  themeColor: 'default', // 'default' | 'blue' | 'rose' | 'amber'
+
+  // ── Analytics ─────────────────────────────────────────────────────────────
   analytics: {
     provider: 'umami', // 'umami' | 'plausible' | 'google' | null
     umami: {
@@ -76,6 +149,8 @@ export const siteConfig = {
       measurementId: '', // G-XXXXXXXXXX
     },
   },
+
+  // ── Comments ──────────────────────────────────────────────────────────────
   comments: {
     provider: 'giscus', // 'giscus' | 'disqus' | null
     giscus: {
@@ -88,4 +163,11 @@ export const siteConfig = {
       shortname: '',
     },
   },
+
+  // ── 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 }>,
+
 };

package/src/app/[slug]/page.tsx

@@ -53,15 +53,5 @@ export default async function Page({
     return <PostLayout post={page} />;
   }
 
-  if (slug === 'about' && siteConfig.about) {
-    return (
-      <SimpleLayout
-        post={page}
-        titleOverride={siteConfig.about.title}
-        subtitleOverride={siteConfig.about.subtitle}
-      />
-    );
-  }
-
   return <SimpleLayout post={page} />;
 }

package/src/app/archive/page.tsx

@@ -1,7 +1,7 @@
 import Link from 'next/link';
-import { getAllPosts, PostData } from '@/lib/markdown';
+import { getAllPosts, getSeriesData, PostData } from '@/lib/markdown';
 import { siteConfig } from '../../../site.config';
-import { resolveLocale } from '@/lib/i18n';
+import { resolveLocale, t } from '@/lib/i18n';
 import PageHeader from '@/components/PageHeader';
 
 export const metadata = {
@@ -41,12 +41,20 @@ function groupPostsByDate(posts: PostData[]): GroupedPosts {
 export default function ArchivePage() {
   const posts = getAllPosts();
   const groupedPosts = groupPostsByDate(posts);
-  const showAuthors = siteConfig.archive?.showAuthors;
+  const showAuthors = siteConfig.posts?.archive?.showAuthors;
 
   // Sort years descending to show newest content first
   const years = Object.keys(groupedPosts).sort((a, b) => Number(b) - Number(a));
   const totalPosts = posts.length;
 
+  // Build series slug → title map (one lookup per unique series)
+  const seriesSlugs = [...new Set(posts.filter(p => p.series).map(p => p.series!))];
+  const seriesTitleMap: Record<string, string> = {};
+  for (const slug of seriesSlugs) {
+    const data = getSeriesData(slug);
+    if (data) seriesTitleMap[slug] = data.title;
+  }
+
   return (
     <div className="layout-main">
       <PageHeader
@@ -57,7 +65,25 @@ export default function ArchivePage() {
         subtitleParams={{ count: totalPosts, years: years.length }}
       />
 
-      <main className="max-w-4xl mx-auto">
+      <main>
+        {/* Year-jump navigation — mirrors content grid to align with timeline column */}
+        {years.length > 1 && (
+          <div className="grid grid-cols-1 md:grid-cols-[200px_1fr] gap-8 md:gap-16 mb-16">
+            <div />
+            <nav aria-label="Jump to year" className="flex flex-wrap items-center gap-2">
+              {years.map(year => (
+                <a
+                  key={year}
+                  href={`#${year}`}
+                  className="text-xs font-mono text-muted hover:text-accent border border-muted/20 hover:border-accent/40 rounded px-3 py-1 transition-all duration-200 no-underline"
+                >
+                  {year}
+                </a>
+              ))}
+            </nav>
+          </div>
+        )}
+
         <div className="space-y-24">
           {years.map((year) => {
             // Sort months within the year in descending order (December -> January)
@@ -67,7 +93,7 @@ export default function ArchivePage() {
             const yearTotal = months.reduce((total, month) => total + groupedPosts[year][month].length, 0);
 
             return (
-              <section key={year} className="relative grid grid-cols-1 md:grid-cols-[200px_1fr] gap-8 md:gap-16">
+              <section key={year} id={year} className="relative grid grid-cols-1 md:grid-cols-[200px_1fr] gap-8 md:gap-16">
                 {/* Year Marker */}
                 <div className="relative">
                   <div className="sticky top-24 lg:top-32 text-left md:text-right">
@@ -75,7 +101,7 @@ export default function ArchivePage() {
                       {year}
                     </h2>
                     <span className="block text-xs font-bold uppercase tracking-widest text-muted mt-2">
-                      {yearTotal} Posts
+                      {yearTotal} {t('posts')}
                     </span>
                   </div>
                 </div>
@@ -91,7 +117,9 @@ export default function ArchivePage() {
                         
                         <h3 className="text-base font-sans font-bold uppercase tracking-widest text-accent mb-8">
                           {getMonthName(Number(month))}
-                          <span className="ml-2 text-xs font-normal text-muted/60">({monthPosts.length})</span>
+                          <span className="ml-2 inline-flex items-center text-[10px] font-mono text-muted/60 bg-muted/10 rounded px-1.5 py-0.5 align-middle leading-none">
+                            {monthPosts.length}
+                          </span>
                         </h3>
                         
                         <ul className="space-y-6">
@@ -113,10 +141,10 @@ export default function ArchivePage() {
                                         </h4>
                                         {post.series && (
                                           <span
-                                            title={post.series}
-                                            className="text-[10px] font-sans font-medium uppercase tracking-wider text-accent/60 border border-accent/20 rounded px-1.5 py-0.5 shrink-0 leading-none max-w-[10ch] truncate inline-block align-baseline"
+                                            title={seriesTitleMap[post.series] ?? post.series}
+                                            className="text-[10px] font-sans font-medium uppercase tracking-wider text-accent/60 border border-accent/20 rounded px-1.5 py-0.5 shrink-0 leading-none max-w-[14ch] truncate inline-block align-baseline"
                                           >
-                                            {post.series}
+                                            {seriesTitleMap[post.series] ?? post.series}
                                           </span>
                                         )}
                                       </div>

package/src/app/books/[slug]/page.tsx

@@ -22,9 +22,27 @@ export async function generateMetadata({ params }: { params: Promise<{ slug: str
     return { title: 'Book Not Found' };
   }
 
+  const ogImage = book.coverImage && !book.coverImage.startsWith('text:') && !book.coverImage.startsWith('./')
+    ? book.coverImage
+    : siteConfig.ogImage;
+
   return {
     title: `${book.title} | ${resolveLocale(siteConfig.title)}`,
     description: book.excerpt,
+    openGraph: {
+      title: book.title,
+      description: book.excerpt,
+      type: 'website',
+      url: `${siteConfig.baseUrl}/books/${slug}`,
+      siteName: resolveLocale(siteConfig.title),
+      images: [{ url: ogImage, width: 1200, height: 630, alt: book.title }],
+    },
+    twitter: {
+      card: ogImage !== siteConfig.ogImage ? 'summary_large_image' : 'summary',
+      title: book.title,
+      description: book.excerpt,
+      images: [ogImage],
+    },
   };
 }
 

package/src/app/flows/[year]/[month]/[day]/page.tsx

@@ -5,6 +5,7 @@ import { notFound } from 'next/navigation';
 import { t, resolveLocale } from '@/lib/i18n';
 import FlowCalendarSidebar from '@/components/FlowCalendarSidebar';
 import MarkdownRenderer from '@/components/MarkdownRenderer';
+import ShareBar from '@/components/ShareBar';
 import Link from 'next/link';
 
 export function generateStaticParams() {
@@ -24,6 +25,19 @@ export async function generateMetadata({ params }: { params: Promise<{ year: str
   return {
     title: `${flow.title} | ${resolveLocale(siteConfig.title)}`,
     description: flow.excerpt,
+    openGraph: {
+      title: flow.title,
+      description: flow.excerpt,
+      type: 'article',
+      publishedTime: flow.date,
+      url: `${siteConfig.baseUrl}/flows/${year}/${month}/${day}`,
+      siteName: resolveLocale(siteConfig.title),
+    },
+    twitter: {
+      card: 'summary',
+      title: flow.title,
+      description: flow.excerpt,
+    },
   };
 }
 
@@ -36,6 +50,7 @@ export default async function FlowPage({ params }: { params: Promise<{ year: str
   const allFlows = getAllFlows();
   const entryDates = allFlows.map(f => f.date);
   const { prev, next } = getAdjacentFlows(flow.slug);
+  const flowUrl = `${siteConfig.baseUrl}/flows/${year}/${month}/${day}`;
 
   return (
     <div className="layout-main">
@@ -62,7 +77,7 @@ export default async function FlowPage({ params }: { params: Promise<{ year: str
         <article className="flex-1 min-w-0">
           {/* Header */}
           <header className="mb-8">
-            <time className="text-sm font-mono text-accent">{flow.date}</time>
+            <time className="text-sm font-mono text-accent" data-pagefind-meta="date[content]">{flow.date}</time>
             <h1 className="mt-2 text-3xl md:text-4xl font-serif font-bold text-heading">{flow.title}</h1>
           </header>
 
@@ -71,14 +86,16 @@ export default async function FlowPage({ params }: { params: Promise<{ year: str
             <MarkdownRenderer content={flow.content} />
           </div>
 
+          <ShareBar url={flowUrl} title={flow.title} className="mt-8 mb-2" />
+
           {/* Prev/Next navigation */}
-          <nav className="mt-16 pt-8 border-t border-muted/20 grid grid-cols-2 gap-4">
+          <nav className="mt-12 pt-12 border-t border-muted/20 grid grid-cols-2 gap-4">
             {prev ? (
               <Link
                 href={`/flows/${prev.slug}`}
                 className="group text-left no-underline"
               >
-                <span className="text-xs text-muted">Older</span>
+                <span className="text-xs text-muted">{t('older')}</span>
                 <div className="text-sm font-medium text-heading group-hover:text-accent transition-colors truncate">
                   {prev.title}
                 </div>
@@ -90,7 +107,7 @@ export default async function FlowPage({ params }: { params: Promise<{ year: str
                 href={`/flows/${next.slug}`}
                 className="group text-right no-underline"
               >
-                <span className="text-xs text-muted">Newer</span>
+                <span className="text-xs text-muted">{t('newer')}</span>
                 <div className="text-sm font-medium text-heading group-hover:text-accent transition-colors truncate">
                   {next.title}
                 </div>

package/src/app/layout.tsx

@@ -6,7 +6,7 @@ import Analytics from "@/components/Analytics";
 import { siteConfig } from "../../site.config";
 import { ThemeProvider } from "@/components/ThemeProvider";
 import { LanguageProvider } from "@/components/LanguageProvider";
-import { getAllSeries, getAllBooks } from "@/lib/markdown";
+import { getAllSeries, getAllBooks, getSeriesData } from "@/lib/markdown";
 import { resolveLocale } from "@/lib/i18n";
 import "./globals.css";
 
@@ -47,6 +47,12 @@ const baskerville = localFont({
   variable: "--font-baskerville",
 });
 
+const siteTwitterHandle = (() => {
+  const url = siteConfig.social?.twitter ?? '';
+  const m = url.match(/(?:twitter\.com|x\.com)\/([^/?#]+)/);
+  return m ? `@${m[1]}` : undefined;
+})();
+
 export const metadata: Metadata = {
   metadataBase: new URL(siteConfig.baseUrl),
   title: resolveLocale(siteConfig.title),
@@ -54,6 +60,17 @@ export const metadata: Metadata = {
   icons: {
     icon: "/icon.svg",
   },
+  openGraph: {
+    siteName: resolveLocale(siteConfig.title),
+    locale: siteConfig.i18n.defaultLocale,
+    type: 'website',
+    images: [{ url: siteConfig.ogImage, width: 1200, height: 630 }],
+  },
+  twitter: {
+    card: 'summary',
+    site: siteTwitterHandle,
+    creator: siteTwitterHandle,
+  },
 };
 
 export default function RootLayout({
@@ -61,33 +78,43 @@ export default function RootLayout({
 }: Readonly<{
   children: React.ReactNode;
 }>) {
-  const allSeries = getAllSeries();
-  const featuredSeries = siteConfig.series?.navbar;
-  
-  const seriesKeys = Object.keys(allSeries).sort();
-  const filteredKeys = featuredSeries 
-    ? seriesKeys.filter(slug => featuredSeries.includes(slug))
-    : seriesKeys.slice(0, 5);
+  const features = siteConfig.features;
 
-  const seriesList = filteredKeys.map(slug => ({
-    name: allSeries[slug][0]?.series || slug,
-    slug,
-  }));
+  // Build series list for navbar (only when series feature is enabled)
+  const seriesNavItem = siteConfig.nav.find(item => item.url === '/series');
+  const featuredSeries = seriesNavItem?.dropdown;
+  let seriesList: { name: string; slug: string }[] = [];
+  if (features?.series?.enabled !== false) {
+    const allSeries = getAllSeries();
+    const seriesKeys = Object.keys(allSeries).sort();
+    const filteredKeys = featuredSeries && featuredSeries.length > 0
+      ? seriesKeys.filter(slug => featuredSeries.includes(slug))
+      : seriesKeys.slice(0, 5);
+    seriesList = filteredKeys.map(slug => ({
+      name: getSeriesData(slug)?.title || allSeries[slug][0]?.series || slug,
+      slug,
+    }));
+  }
 
-  // Build books list for navbar
-  const allBooks = getAllBooks();
-  const featuredBookSlugs = siteConfig.books?.navbar;
-  const booksList = featuredBookSlugs && featuredBookSlugs.length > 0
-    ? allBooks
-        .filter(book => featuredBookSlugs.includes(book.slug))
-        .map(book => ({ name: book.title, slug: book.slug }))
-    : allBooks.map(book => ({ name: book.title, slug: book.slug }));
+  // Build books list for navbar (only when books feature is enabled)
+  const booksNavItem = siteConfig.nav.find(item => item.url === '/books');
+  const featuredBookSlugs = booksNavItem?.dropdown;
+  let booksList: { name: string; slug: string }[] = [];
+  if (features?.books?.enabled !== false) {
+    const allBooks = getAllBooks();
+    booksList = featuredBookSlugs && featuredBookSlugs.length > 0
+      ? allBooks
+          .filter(book => featuredBookSlugs.includes(book.slug))
+          .map(book => ({ name: book.title, slug: book.slug }))
+      : allBooks.slice(0, 5).map(book => ({ name: book.title, slug: book.slug }));
+  }
 
   return (
-    <html lang="en" suppressHydrationWarning>
+    <html lang={siteConfig.i18n.defaultLocale} suppressHydrationWarning>
       <body
         className={`${inter.variable} ${baskerville.variable} font-sans min-h-screen transition-colors duration-300`}
         data-palette={siteConfig.themeColor}
+        suppressHydrationWarning
       >
         {/* Skip to main content link for accessibility */}
         <a