@hutusi/amytis 1.5.5

package/scripts/new-post.ts

@@ -0,0 +1,98 @@
+import fs from 'fs';
+import path from 'path';
+
+const args = process.argv.slice(2);
+const valuedFlags = ['--template', '--prefix', '--series'];
+const title = args.filter(arg => !arg.startsWith('--') && !valuedFlags.includes(args[args.indexOf(arg) - 1]))[0];
+const templateArgIndex = args.indexOf('--template');
+const templateName = templateArgIndex > -1 ? args[templateArgIndex + 1] : 'default';
+const prefixArgIndex = args.indexOf('--prefix');
+const prefix = prefixArgIndex > -1 ? args[prefixArgIndex + 1] : '';
+const seriesArgIndex = args.indexOf('--series');
+const series = seriesArgIndex > -1 ? args[seriesArgIndex + 1] : '';
+const useFolder = args.includes('--folder');
+const useMd = args.includes('--md');
+
+if (!title) {
+  console.error('Please provide a post title.');
+  console.error('Usage: bun new <title> [--template <name>] [--prefix <name>] [--series <slug>] [--folder] [--md]');
+  process.exit(1);
+}
+
+const slug = title
+  .toLowerCase()
+  .replace(/[^a-z0-9]+/g, '-')
+  .replace(/(^-|-$)+/g, '');
+
+const date = new Date().toISOString().split('T')[0];
+const ext = useMd ? '.md' : '.mdx';
+const prefixedSlug = prefix ? `${prefix}-${slug}` : slug;
+let targetPath = '';
+
+if (series) {
+  // Series posts go into content/series/<slug>/ without date prefix
+  const seriesDir = path.join(process.cwd(), 'content', 'series', series);
+  if (!fs.existsSync(seriesDir)) {
+    console.error(`Error: Series directory "${series}" does not exist at ${seriesDir}`);
+    process.exit(1);
+  }
+  if (useFolder) {
+    const dirPath = path.join(seriesDir, prefixedSlug);
+    if (!fs.existsSync(dirPath)) {
+      fs.mkdirSync(dirPath, { recursive: true });
+    }
+    fs.mkdirSync(path.join(dirPath, 'images'), { recursive: true });
+    targetPath = path.join(dirPath, `index${ext}`);
+  } else {
+    targetPath = path.join(seriesDir, `${prefixedSlug}${ext}`);
+  }
+} else if (useFolder) {
+  const dirName = `${date}-${prefixedSlug}`;
+  const dirPath = path.join(process.cwd(), 'content', 'posts', dirName);
+  if (!fs.existsSync(dirPath)) {
+    fs.mkdirSync(dirPath, { recursive: true });
+  }
+  fs.mkdirSync(path.join(dirPath, 'images'), { recursive: true });
+  targetPath = path.join(dirPath, `index${ext}`);
+} else {
+  const filename = `${date}-${prefixedSlug}${ext}`;
+  targetPath = path.join(process.cwd(), 'content', 'posts', filename);
+}
+
+const templatePath = path.join(process.cwd(), 'templates', `${templateName}${ext}`);
+// Fallback to .mdx template if .md specific template doesn't exist
+const fallbackTemplatePath = path.join(process.cwd(), 'templates', `${templateName}.mdx`);
+
+let content = '';
+
+if (fs.existsSync(templatePath)) {
+  content = fs.readFileSync(templatePath, 'utf8');
+} else if (fs.existsSync(fallbackTemplatePath)) {
+  content = fs.readFileSync(fallbackTemplatePath, 'utf8');
+} else {
+  // Fallback default template if file not found
+  content = `---
+title: "{{title}}"
+date: "{{date}}"
+excerpt: ""
+category: "Uncategorized"
+tags: []
+authors: ["Amytis"]
+layout: "post"
+draft: false
+latex: false
+---
+
+Write your content here...
+`;
+}
+
+content = content.replace(/{{title}}/g, title).replace(/{{date}}/g, date);
+
+if (fs.existsSync(targetPath)) {
+  console.error(`Error: Post already exists at ${targetPath}`);
+  process.exit(1);
+}
+
+fs.writeFileSync(targetPath, content);
+console.log(`Created new post: ${targetPath}`);

package/scripts/new-series.ts

@@ -0,0 +1,40 @@
+import fs from 'fs';
+import path from 'path';
+import GithubSlugger from 'github-slugger';
+
+const args = process.argv.slice(2);
+const title = args[0];
+
+if (!title) {
+  console.error('Please provide a series title.');
+  console.error('Usage: bun run new-series "My Series Name"');
+  process.exit(1);
+}
+
+const slugger = new GithubSlugger();
+const slug = slugger.slug(title);
+const seriesDir = path.join(process.cwd(), 'content', 'series', slug);
+
+if (fs.existsSync(seriesDir)) {
+  console.error(`Series "${slug}" already exists.`);
+  process.exit(1);
+}
+
+fs.mkdirSync(seriesDir, { recursive: true });
+fs.mkdirSync(path.join(seriesDir, 'images'));
+
+const date = new Date().toISOString().split('T')[0];
+
+const content = `---
+title: "${title}"
+excerpt: "A description for ${title}."
+date: "${date}"
+coverImage: "https://images.unsplash.com/photo-1618005182384-a83a8bd57fbe?auto=format&fit=crop&w=800&q=80"
+---
+
+Welcome to the ${title} series.
+`;
+
+fs.writeFileSync(path.join(seriesDir, 'index.mdx'), content);
+
+console.log(`Created new series at content/series/${slug}/index.mdx`);

package/scripts/series-draft.ts

@@ -0,0 +1,136 @@
+import fs from 'fs';
+import path from 'path';
+import matter from 'gray-matter';
+
+const args = process.argv.slice(2);
+const seriesSlug = args.find(arg => !arg.startsWith('--'));
+const undraft = args.includes('--undraft');
+
+if (!seriesSlug) {
+  console.error('Please provide a series slug.');
+  console.error('Usage: bun run series-draft <series-slug> [--undraft]');
+  console.error('');
+  console.error('Options:');
+  console.error('  --undraft   Remove draft status instead of setting it');
+  process.exit(1);
+}
+
+const contentDir = path.join(process.cwd(), 'content', 'posts');
+const seriesDir = path.join(process.cwd(), 'content', 'series', seriesSlug);
+
+// Check if series exists
+if (!fs.existsSync(seriesDir)) {
+  console.error(`Error: Series "${seriesSlug}" not found at ${seriesDir}`);
+  process.exit(1);
+}
+
+// Read series metadata to get manual posts list
+let manualPosts: string[] = [];
+const seriesIndexMdx = path.join(seriesDir, 'index.mdx');
+const seriesIndexMd = path.join(seriesDir, 'index.md');
+let seriesIndexPath = '';
+
+if (fs.existsSync(seriesIndexMdx)) {
+  seriesIndexPath = seriesIndexMdx;
+} else if (fs.existsSync(seriesIndexMd)) {
+  seriesIndexPath = seriesIndexMd;
+}
+
+if (seriesIndexPath) {
+  const seriesContent = fs.readFileSync(seriesIndexPath, 'utf8');
+  const { data } = matter(seriesContent);
+  if (data.posts && Array.isArray(data.posts)) {
+    manualPosts = data.posts;
+  }
+}
+
+// Find all post files that belong to this series
+const postFiles: { path: string; slug: string }[] = [];
+
+// 1. Check posts in series folder
+if (fs.existsSync(seriesDir)) {
+  const items = fs.readdirSync(seriesDir, { withFileTypes: true });
+  for (const item of items) {
+    if (item.name === 'index.mdx' || item.name === 'index.md') continue;
+
+    if (item.isFile() && (item.name.endsWith('.mdx') || item.name.endsWith('.md'))) {
+      const slug = item.name.replace(/\.mdx?$/, '');
+      postFiles.push({ path: path.join(seriesDir, item.name), slug });
+    } else if (item.isDirectory()) {
+      const indexMdx = path.join(seriesDir, item.name, 'index.mdx');
+      const indexMd = path.join(seriesDir, item.name, 'index.md');
+      if (fs.existsSync(indexMdx)) {
+        postFiles.push({ path: indexMdx, slug: item.name });
+      } else if (fs.existsSync(indexMd)) {
+        postFiles.push({ path: indexMd, slug: item.name });
+      }
+    }
+  }
+}
+
+// 2. Check posts in content/posts with series frontmatter or in manual list
+if (fs.existsSync(contentDir)) {
+  const items = fs.readdirSync(contentDir, { withFileTypes: true });
+  for (const item of items) {
+    let filePath = '';
+    let slug = '';
+
+    if (item.isFile() && (item.name.endsWith('.mdx') || item.name.endsWith('.md'))) {
+      filePath = path.join(contentDir, item.name);
+      slug = item.name.replace(/\.mdx?$/, '').replace(/^\d{4}-\d{2}-\d{2}-/, '');
+    } else if (item.isDirectory()) {
+      const indexMdx = path.join(contentDir, item.name, 'index.mdx');
+      const indexMd = path.join(contentDir, item.name, 'index.md');
+      if (fs.existsSync(indexMdx)) {
+        filePath = indexMdx;
+      } else if (fs.existsSync(indexMd)) {
+        filePath = indexMd;
+      }
+      slug = item.name.replace(/^\d{4}-\d{2}-\d{2}-/, '');
+    }
+
+    if (!filePath) continue;
+
+    const content = fs.readFileSync(filePath, 'utf8');
+    const { data } = matter(content);
+
+    // Include if series matches or slug is in manual posts list
+    if (data.series === seriesSlug || manualPosts.includes(slug)) {
+      // Avoid duplicates
+      if (!postFiles.find(p => p.path === filePath)) {
+        postFiles.push({ path: filePath, slug });
+      }
+    }
+  }
+}
+
+if (postFiles.length === 0) {
+  console.log(`No posts found in series "${seriesSlug}".`);
+  process.exit(0);
+}
+
+console.log(`Found ${postFiles.length} post(s) in series "${seriesSlug}":`);
+
+let updated = 0;
+for (const { path: filePath, slug } of postFiles) {
+  const content = fs.readFileSync(filePath, 'utf8');
+  const { data, content: body } = matter(content);
+
+  const currentDraft = data.draft === true;
+  const targetDraft = !undraft;
+
+  if (currentDraft === targetDraft) {
+    console.log(`  [skip] ${slug} - already ${targetDraft ? 'draft' : 'published'}`);
+    continue;
+  }
+
+  data.draft = targetDraft;
+
+  const newContent = matter.stringify(body, data);
+  fs.writeFileSync(filePath, newContent);
+
+  console.log(`  [${targetDraft ? 'draft' : 'publish'}] ${slug}`);
+  updated++;
+}
+
+console.log(`\nUpdated ${updated} post(s).`);

package/site.config.ts

@@ -0,0 +1,91 @@
+export const siteConfig = {
+  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
+  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",
+  },
+  series: {
+    navbar: ["digital-garden", "markdown-showcase", "ai-nexus-weekly"], // Slugs of series to show in navbar
+  },
+  books: {
+    navbar: [] as string[], // Slugs of books to show in navbar dropdown
+  },
+  archive: {
+    showAuthors: true,
+  },
+  pagination: {
+    posts: 5,
+    series: 1,
+    flows: 20,
+  },
+  includeDateInUrl: false,
+  // trailingSlash is configured in next.config.ts (Next.js handles URL normalization)
+  showFuturePosts: false,
+  toc: true,
+  themeColor: 'default', // 'default' | 'blue' | 'rose' | 'amber'
+  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: "了解这座数字花园背后的理念与技术。" },
+  },
+  flows: {
+    recentCount: 5,
+  },
+  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,
+    },
+  },
+  i18n: {
+    defaultLocale: 'en',
+    locales: ['en', 'zh'],
+  },
+  analytics: {
+    provider: 'umami', // 'umami' | 'plausible' | 'google' | null
+    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: {
+    provider: 'giscus', // 'giscus' | 'disqus' | null
+    giscus: {
+      repo: 'hutusi/amytis', // username/repo
+      repoId: 'R_kgDOQ1YSwA',
+      category: 'Announcements',
+      categoryId: 'DIC_kwDOQ1YSwM4C2NmL',
+    },
+    disqus: {
+      shortname: '',
+    },
+  },
+};

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

@@ -0,0 +1,67 @@
+import { getPageBySlug, getAllPages } from '@/lib/markdown';
+import { notFound } from 'next/navigation';
+import PostLayout from '@/layouts/PostLayout';
+import SimpleLayout from '@/layouts/SimpleLayout';
+import { Metadata } from 'next';
+import { siteConfig } from '../../../site.config';
+import { resolveLocale } from '@/lib/i18n';
+
+/**
+ * Generates the static paths for all top-level pages at build time.
+ */
+export async function generateStaticParams() {
+  const pages = getAllPages();
+  return pages.map((page) => ({
+    slug: page.slug,
+  }));
+}
+
+export const dynamicParams = false;
+
+export async function generateMetadata({ params }: { params: Promise<{ slug: string }> }): Promise<Metadata> {
+  const { slug: rawSlug } = await params;
+  const slug = decodeURIComponent(rawSlug);
+  const page = getPageBySlug(slug);
+
+  if (!page) {
+    return { title: 'Page Not Found' };
+  }
+
+  return {
+    title: `${page.title} | ${resolveLocale(siteConfig.title)}`,
+    description: page.excerpt,
+  };
+}
+
+export default async function Page({
+  params,
+}: {
+  params: Promise<{ slug: string }>;
+}) {
+  const { slug: rawSlug } = await params;
+  const slug = decodeURIComponent(rawSlug);
+  const page = getPageBySlug(slug);
+
+  if (!page) {
+    notFound();
+  }
+
+  // Determine layout based on frontmatter, defaulting to 'simple' for pages
+  const layout = page.layout || 'simple';
+
+  if (layout === 'post') {
+    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

@@ -0,0 +1,147 @@
+import Link from 'next/link';
+import { getAllPosts, PostData } from '@/lib/markdown';
+import { siteConfig } from '../../../site.config';
+import { resolveLocale } from '@/lib/i18n';
+import PageHeader from '@/components/PageHeader';
+
+export const metadata = {
+  title: `Archive | ${resolveLocale(siteConfig.title)}`,
+  description: 'A complete list of all notes and thoughts.',
+};
+
+// Use month number as key for reliable sorting across all locales
+type GroupedPosts = Record<string, Record<string, PostData[]>>;
+
+const locale = siteConfig.i18n.defaultLocale === 'zh' ? 'zh-CN' : siteConfig.i18n.defaultLocale;
+
+function getMonthName(monthNum: number): string {
+  return new Date(2000, monthNum - 1).toLocaleString(locale, { month: 'long' });
+}
+
+function groupPostsByDate(posts: PostData[]): GroupedPosts {
+  const groups: GroupedPosts = {};
+
+  posts.forEach((post) => {
+    const date = new Date(post.date);
+    const year = date.getFullYear().toString();
+    const month = (date.getMonth() + 1).toString();
+
+    if (!groups[year]) {
+      groups[year] = {};
+    }
+    if (!groups[year][month]) {
+      groups[year][month] = [];
+    }
+    groups[year][month].push(post);
+  });
+
+  return groups;
+}
+
+export default function ArchivePage() {
+  const posts = getAllPosts();
+  const groupedPosts = groupPostsByDate(posts);
+  const showAuthors = siteConfig.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;
+
+  return (
+    <div className="layout-main">
+      <PageHeader
+        titleKey="archive"
+        subtitleKey="archive_subtitle"
+        subtitleOneKey="archive_subtitle_one"
+        count={years.length}
+        subtitleParams={{ count: totalPosts, years: years.length }}
+      />
+
+      <main className="max-w-4xl mx-auto">
+        <div className="space-y-24">
+          {years.map((year) => {
+            // Sort months within the year in descending order (December -> January)
+            const months = Object.keys(groupedPosts[year]).sort((a, b) => Number(b) - Number(a));
+
+            // Calculate total posts for the year
+            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">
+                {/* Year Marker */}
+                <div className="relative">
+                  <div className="sticky top-24 lg:top-32 text-left md:text-right">
+                    <h2 className="text-4xl md:text-5xl font-serif font-bold text-muted/50">
+                      {year}
+                    </h2>
+                    <span className="block text-xs font-bold uppercase tracking-widest text-muted mt-2">
+                      {yearTotal} Posts
+                    </span>
+                  </div>
+                </div>
+                
+                {/* Content Timeline */}
+                <div className="relative border-l-2 border-muted/20 pl-8 md:pl-12 space-y-16">
+                  {months.map((month) => {
+                    const monthPosts = groupedPosts[year][month];
+                    return (
+                      <div key={month} className="relative">
+                        {/* Month Marker - positioned relative to border */}
+                        <div className="absolute -left-[calc(2rem+1px)] md:-left-[calc(3rem+1px)] -translate-x-1/2 top-1.5 w-3 h-3 rounded-full bg-background border-2 border-accent/50"></div>
+                        
+                        <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>
+                        </h3>
+                        
+                        <ul className="space-y-6">
+                          {monthPosts.map((post) => {
+                            const dateObj = new Date(post.date);
+                            const day = dateObj.getDate().toString().padStart(2, '0');
+                            
+                            return (
+                              <li key={post.slug} className="group">
+                                <Link href={`/posts/${post.slug}`} className="block no-underline">
+                                  <div className="flex flex-col sm:flex-row sm:items-baseline justify-between gap-2 sm:gap-6">
+                                    <div className="flex items-baseline gap-6">
+                                      <span className="font-mono text-base text-muted shrink-0 w-8">
+                                        {day}
+                                      </span>
+                                      <div className="flex items-baseline gap-2">
+                                        <h4 className="text-xl font-serif font-medium text-heading/80 group-hover:text-accent transition-colors duration-200">
+                                          {post.title}
+                                        </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"
+                                          >
+                                            {post.series}
+                                          </span>
+                                        )}
+                                      </div>
+                                    </div>
+                                    {showAuthors && post.authors.length > 0 && (
+                                      <span className="text-sm font-sans italic text-muted/60 shrink-0 hidden sm:block">
+                                        {post.authors.join(', ')}
+                                      </span>
+                                    )}
+                                  </div>
+                                </Link>
+                              </li>
+                            );
+                          })}
+                        </ul>
+                      </div>
+                    );
+                  })}
+                </div>
+              </section>
+            );
+
+          })}
+        </div>
+      </main>
+    </div>
+  );
+}