@hutusi/amytis 1.6.0 → 1.7.0

package/content/privacy.zh.mdx

@@ -0,0 +1,32 @@
+---
+title: "隐私政策"
+date: "2026-02-20"
+excerpt: "本站如何收集和处理您的数据。"
+layout: "simple"
+---
+
+# 隐私政策
+
+您的隐私对我们很重要。本页面说明您在访问本站时收集了哪些数据，以及这些数据如何被使用。
+
+## 数据分析
+
+本站使用 **Umami**，一个注重隐私的开源分析平台。Umami 不使用 Cookie，不跨网站追踪用户，也不收集任何个人身份信息。所收集的数据仅限于匿名页面访问统计，如来源网站、浏览器类型和所在国家，仅用于了解哪些内容最受欢迎。
+
+数据不会被出售或与任何第三方共享。
+
+## 评论
+
+文章评论由 **Giscus** 提供支持，基于 GitHub Discussions 实现。留言需要使用 GitHub 账号登录。您的评论和 GitHub 用户名由 GitHub 存储，受 [GitHub 隐私政策](https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement)约束。
+
+如果您没有 GitHub 账号或不希望使用，也可以通过页脚中的电子邮件直接联系我。
+
+## 外部链接
+
+本站可能包含指向外部网站的链接。一旦您离开本站，这些第三方网站的隐私实践将适用，超出本站的控制范围。
+
+## 联系我们
+
+如果您对本隐私政策有任何疑问，请通过页脚中的电子邮件地址联系我们。
+
+*最后更新：2026 年 2 月。*

package/docs/ARCHITECTURE.md

@@ -50,6 +50,10 @@ src/app/
     [author]/page.tsx               # Posts by author
   archive/
     page.tsx                        # Chronological archive
+  subscribe/
+    page.tsx                        # Subscription options
+  search.json/
+    route.ts                        # Supplementary structured search data
   [slug]/page.tsx                   # Static pages (about, etc.)
 ```
 
@@ -60,6 +64,7 @@ src/app/
 - **`Footer`** - Social links, copyright, site metadata, and language switch.
 - **`Hero`** - Homepage hero with collapsible intro.
 - **`BookLayout`** - Dedicated layout for book chapters with sidebar navigation.
+- **`PageHeader`** - Consistent header for simple pages (Archive, Tags, About).
 
 ### Content Display
 - **`PostList`** - Card-based post listing.
@@ -67,6 +72,8 @@ src/app/
 - **`SeriesCatalog`** - Timeline-style post listing for series.
 - **`PostCard`** - Individual post preview card.
 - **`CoverImage`** - Optimized image component using `next-image-export-optimizer` with dynamic desaturated gradients.
+- **`ShareBar`** - Social sharing buttons for posts and books.
+- **`TagContentTabs`** - Tabbed interface for filtering posts vs flows by tag.
 
 ### Content Rendering
 - **`MarkdownRenderer`** - Core rendering component using `react-markdown` with plugins (GFM, Math, Raw HTML).
@@ -78,6 +85,7 @@ src/app/
 - **`Search`** - Full-text search modal (Cmd/Ctrl+K) powered by Pagefind. Supports type filter tabs (All/Post/Flow/Book), recent searches, keyboard navigation, debounced input, focus trap, and ARIA accessibility. Search syntax: `"exact phrase"`, `word1 word2` (AND), `-exclude`.
 - **`Pagination`** - Previous/Next page navigation.
 - **`ReadingProgressBar`** - Top-of-page progress bar for book chapters.
+- **`SubscribePage`** - Centralized page for all subscription options.
 
 ## Data Access Layer (`src/lib/markdown.ts`)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hutusi/amytis",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "A high-performance digital garden and blog engine with Next.js 16 and Tailwind CSS v4",
   "repository": {
     "type": "git",
@@ -44,6 +44,7 @@
     "next-themes": "^0.4.6",
     "react": "19.2.4",
     "react-dom": "19.2.4",
+    "react-icons": "^5.5.0",
     "react-markdown": "^10.1.0",
     "react-syntax-highlighter": "^16.1.0",
     "rehype-katex": "^7.0.1",

package/scripts/copy-assets.ts

@@ -51,7 +51,7 @@ function getSlugFromFilename(filename: string): string {
   const dateRegex = /^(\d{4}-\d{2}-\d{2})-(.*)$/;
   const match = nameWithoutExt.match(dateRegex);
 
-  if (match && !siteConfig.includeDateInUrl) {
+  if (match && !siteConfig.posts?.includeDateInUrl) {
     return match[2];
   }
   return nameWithoutExt;

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">
@@ -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,30 +78,39 @@ 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}