@jet-w/astro-blog 0.2.1 → 0.2.3

package/src/config/i18n.ts

@@ -0,0 +1,485 @@
+/**
+ * i18n Configuration Module
+ *
+ * Provides multi-language support configuration for the blog.
+ */
+
+import type { NavigationItem, SiteConfig } from '../types';
+import type { FooterConfig } from './footer';
+import type { SidebarConfig } from './sidebar';
+
+/**
+ * Locale definition
+ */
+export interface Locale {
+  /** Language code (e.g., 'en', 'zh-CN', 'ja') */
+  code: string;
+  /** Display name (e.g., 'English', '中文') */
+  name: string;
+  /** HTML lang attribute value */
+  htmlLang: string;
+  /** Locale for Intl.DateTimeFormat */
+  dateLocale: string;
+  /** Text direction */
+  direction?: 'ltr' | 'rtl';
+}
+
+/**
+ * UI translation strings
+ */
+export interface UITranslations {
+  // Navigation
+  home: string;
+  blog: string;
+  about: string;
+  search: string;
+
+  // Posts
+  posts: string;
+  postList: string;
+  noPostsFound: string;
+  readMore: string;
+  readingTime: string;
+  minuteRead: string;
+
+  // Tags & Categories
+  tags: string;
+  categories: string;
+  allTags: string;
+  allCategories: string;
+  taggedWith: string;
+  inCategory: string;
+
+  // Archives
+  archives: string;
+  postsInArchive: string;
+
+  // Sidebar
+  recentPosts: string;
+  popularTags: string;
+  friendLinks: string;
+  documentTree: string;
+
+  // Footer
+  quickLinks: string;
+  contact: string;
+
+  // Search
+  searchPlaceholder: string;
+  searchResults: string;
+  noResults: string;
+  searching: string;
+  searchArticles: string;
+  searchInAllArticles: string;
+  searchTips: string;
+  basicSearch: string;
+  advancedFeatures: string;
+  searchTipKeyword: string;
+  searchTipMixedLang: string;
+  searchTipCaseInsensitive: string;
+  searchTipRealtime: string;
+  searchTipFilter: string;
+  searchTipFuzzy: string;
+
+  // Hero section
+  browsePosts: string;
+  aboutMe: string;
+
+  // Pagination
+  previousPage: string;
+  nextPage: string;
+  page: string;
+  of: string;
+
+  // Article details
+  publishedOn: string;
+  updatedOn: string;
+  author: string;
+  tableOfContents: string;
+  readingProgress: string;
+  relatedPosts: string;
+  sharePost: string;
+  previousPost: string;
+  nextPost: string;
+
+  // Misc
+  backToTop: string;
+  copyCode: string;
+  copied: string;
+  expand: string;
+  collapse: string;
+  expandCode: string;
+  collapseCode: string;
+  lines: string;
+  viewMode: string;
+  cardView: string;
+  listView: string;
+  sortBy: string;
+  sortByDate: string;
+  sortByTitle: string;
+  filterByTag: string;
+  filterByCategory: string;
+  clearFilter: string;
+  allPosts: string;
+  draft: string;
+
+  // Slides
+  slides: string;
+  slidesList: string;
+
+  // RSS
+  rssFeed: string;
+
+  // Quick Navigation
+  quickNavigation: string;
+  timeline: string;
+  viewAllTimeline: string;
+  postsCount: string;
+}
+
+/**
+ * Locale-specific configuration
+ */
+export interface LocaleConfig {
+  /** Site configuration overrides */
+  site?: Partial<SiteConfig>;
+  /** Navigation menu items */
+  menu?: NavigationItem[];
+  /** Footer configuration overrides */
+  footer?: Partial<FooterConfig>;
+  /** Sidebar configuration overrides */
+  sidebar?: Partial<SidebarConfig>;
+  /** UI translation overrides */
+  ui?: Partial<UITranslations>;
+  /** Content path prefix for filtering posts by locale (e.g., 'blog_docs_en' for English) */
+  contentPathPrefix?: string;
+}
+
+/**
+ * i18n routing configuration
+ */
+export interface I18nRoutingConfig {
+  /** Whether to add prefix for default locale (e.g., /zh-CN/posts vs /posts) */
+  prefixDefaultLocale: boolean;
+}
+
+/**
+ * Complete i18n configuration
+ */
+export interface I18nConfig {
+  /** Default locale code */
+  defaultLocale: string;
+  /** Available locales */
+  locales: Locale[];
+  /** Locale-specific configurations */
+  localeConfigs: Record<string, LocaleConfig>;
+  /** Routing configuration */
+  routing: I18nRoutingConfig;
+}
+
+/**
+ * Default Chinese (Simplified) UI translations
+ */
+export const zhCNTranslations: UITranslations = {
+  // Navigation
+  home: '首页',
+  blog: '博客',
+  about: '关于',
+  search: '搜索',
+
+  // Posts
+  posts: '文章',
+  postList: '文章列表',
+  noPostsFound: '暂无文章',
+  readMore: '阅读更多',
+  readingTime: '阅读时间',
+  minuteRead: '分钟',
+
+  // Tags & Categories
+  tags: '标签',
+  categories: '分类',
+  allTags: '全部标签',
+  allCategories: '全部分类',
+  taggedWith: '标签',
+  inCategory: '分类',
+
+  // Archives
+  archives: '归档',
+  postsInArchive: '篇文章',
+
+  // Sidebar
+  recentPosts: '最新文章',
+  popularTags: '热门标签',
+  friendLinks: '友情链接',
+  documentTree: '文档目录',
+
+  // Footer
+  quickLinks: '快速链接',
+  contact: '联系方式',
+
+  // Search
+  searchPlaceholder: '搜索文章标题、内容、标签...',
+  searchResults: '搜索结果',
+  noResults: '没有找到相关结果',
+  searching: '搜索中...',
+  searchArticles: '搜索文章',
+  searchInAllArticles: '在所有文章中查找您感兴趣的内容',
+  searchTips: '搜索技巧',
+  basicSearch: '基础搜索',
+  advancedFeatures: '高级功能',
+  searchTipKeyword: '输入关键词搜索标题和内容',
+  searchTipMixedLang: '支持中英文混合搜索',
+  searchTipCaseInsensitive: '自动忽略大小写',
+  searchTipRealtime: '实时搜索建议',
+  searchTipFilter: '按标签和分类筛选',
+  searchTipFuzzy: '支持模糊匹配',
+
+  // Hero section
+  browsePosts: '浏览文章',
+  aboutMe: '关于我',
+
+  // Pagination
+  previousPage: '上一页',
+  nextPage: '下一页',
+  page: '第',
+  of: '页，共',
+
+  // Article details
+  publishedOn: '发布于',
+  updatedOn: '更新于',
+  author: '作者',
+  tableOfContents: '页面目录',
+  readingProgress: '阅读进度',
+  relatedPosts: '相关文章',
+  sharePost: '分享文章',
+  previousPost: '上一篇',
+  nextPost: '下一篇',
+
+  // Misc
+  backToTop: '回到顶部',
+  copyCode: '复制',
+  copied: '已复制',
+  expand: '展开',
+  collapse: '收起',
+  expandCode: '展开代码',
+  collapseCode: '收起代码',
+  lines: '行',
+  viewMode: '视图模式',
+  cardView: '卡片视图',
+  listView: '列表视图',
+  sortBy: '排序',
+  sortByDate: '按日期',
+  sortByTitle: '按标题',
+  filterByTag: '按标签筛选',
+  filterByCategory: '按分类筛选',
+  clearFilter: '清除筛选',
+  allPosts: '全部文章',
+  draft: '草稿',
+
+  // Slides
+  slides: '演示',
+  slidesList: '演示列表',
+
+  // RSS
+  rssFeed: 'RSS 订阅',
+
+  // Quick Navigation
+  quickNavigation: '快速导航',
+  timeline: '时间轴',
+  viewAllTimeline: '查看全部时间轴',
+  postsCount: '篇',
+};
+
+/**
+ * Default English UI translations
+ */
+export const enTranslations: UITranslations = {
+  // Navigation
+  home: 'Home',
+  blog: 'Blog',
+  about: 'About',
+  search: 'Search',
+
+  // Posts
+  posts: 'Posts',
+  postList: 'All Posts',
+  noPostsFound: 'No posts found',
+  readMore: 'Read more',
+  readingTime: 'Reading time',
+  minuteRead: 'min',
+
+  // Tags & Categories
+  tags: 'Tags',
+  categories: 'Categories',
+  allTags: 'All Tags',
+  allCategories: 'All Categories',
+  taggedWith: 'Tagged with',
+  inCategory: 'In category',
+
+  // Archives
+  archives: 'Archives',
+  postsInArchive: 'posts',
+
+  // Sidebar
+  recentPosts: 'Recent Posts',
+  popularTags: 'Popular Tags',
+  friendLinks: 'Friend Links',
+  documentTree: 'Document Tree',
+
+  // Footer
+  quickLinks: 'Quick Links',
+  contact: 'Contact',
+
+  // Search
+  searchPlaceholder: 'Search posts, tags, content...',
+  searchResults: 'Search Results',
+  noResults: 'No results found',
+  searching: 'Searching...',
+  searchArticles: 'Search Articles',
+  searchInAllArticles: 'Find content that interests you in all articles',
+  searchTips: 'Search Tips',
+  basicSearch: 'Basic Search',
+  advancedFeatures: 'Advanced Features',
+  searchTipKeyword: 'Enter keywords to search titles and content',
+  searchTipMixedLang: 'Supports mixed language search',
+  searchTipCaseInsensitive: 'Case insensitive',
+  searchTipRealtime: 'Real-time search suggestions',
+  searchTipFilter: 'Filter by tags and categories',
+  searchTipFuzzy: 'Supports fuzzy matching',
+
+  // Hero section
+  browsePosts: 'Browse Posts',
+  aboutMe: 'About Me',
+
+  // Pagination
+  previousPage: 'Previous',
+  nextPage: 'Next',
+  page: 'Page',
+  of: 'of',
+
+  // Article details
+  publishedOn: 'Published on',
+  updatedOn: 'Updated on',
+  author: 'Author',
+  tableOfContents: 'Table of Contents',
+  readingProgress: 'Reading Progress',
+  relatedPosts: 'Related Posts',
+  sharePost: 'Share',
+  previousPost: 'Previous',
+  nextPost: 'Next',
+
+  // Misc
+  backToTop: 'Back to Top',
+  copyCode: 'Copy',
+  copied: 'Copied',
+  expand: 'Expand',
+  collapse: 'Collapse',
+  expandCode: 'Expand code',
+  collapseCode: 'Collapse code',
+  lines: 'lines',
+  viewMode: 'View Mode',
+  cardView: 'Card View',
+  listView: 'List View',
+  sortBy: 'Sort by',
+  sortByDate: 'Date',
+  sortByTitle: 'Title',
+  filterByTag: 'Filter by tag',
+  filterByCategory: 'Filter by category',
+  clearFilter: 'Clear filter',
+  allPosts: 'All Posts',
+  draft: 'Draft',
+
+  // Slides
+  slides: 'Slides',
+  slidesList: 'All Slides',
+
+  // RSS
+  rssFeed: 'RSS Feed',
+
+  // Quick Navigation
+  quickNavigation: 'Quick Navigation',
+  timeline: 'Timeline',
+  viewAllTimeline: 'View all timeline',
+  postsCount: 'posts',
+};
+
+/**
+ * Built-in translations for common languages
+ */
+export const builtInTranslations: Record<string, UITranslations> = {
+  'zh-CN': zhCNTranslations,
+  'zh': zhCNTranslations,
+  'en': enTranslations,
+  'en-US': enTranslations,
+  'en-GB': enTranslations,
+};
+
+/**
+ * Default locales
+ */
+export const defaultLocales: Locale[] = [
+  {
+    code: 'zh-CN',
+    name: '中文',
+    htmlLang: 'zh-CN',
+    dateLocale: 'zh-CN',
+    direction: 'ltr',
+  },
+];
+
+/**
+ * Default i18n configuration (Chinese only, backward compatible)
+ */
+export const defaultI18nConfig: I18nConfig = {
+  defaultLocale: 'zh-CN',
+  locales: defaultLocales,
+  localeConfigs: {},
+  routing: {
+    prefixDefaultLocale: false,
+  },
+};
+
+/**
+ * Helper function to define i18n configuration with type safety
+ */
+export function defineI18nConfig(config: Partial<I18nConfig>): I18nConfig {
+  return {
+    defaultLocale: config.defaultLocale || 'zh-CN',
+    locales: config.locales || defaultLocales,
+    localeConfigs: config.localeConfigs || {},
+    routing: {
+      prefixDefaultLocale: config.routing?.prefixDefaultLocale ?? false,
+    },
+  };
+}
+
+/**
+ * Get UI translations for a specific locale
+ * Falls back to built-in translations, then to English
+ */
+export function getUITranslations(
+  locale: string,
+  config?: I18nConfig
+): UITranslations {
+  // Check locale-specific config first
+  const localeConfig = config?.localeConfigs?.[locale];
+  const customTranslations = localeConfig?.ui;
+
+  // Get built-in translations as base
+  const baseTranslations =
+    builtInTranslations[locale] ||
+    builtInTranslations[locale.split('-')[0]] ||
+    builtInTranslations['en'];
+
+  // Merge custom translations over base
+  if (customTranslations) {
+    return { ...baseTranslations, ...customTranslations };
+  }
+
+  return baseTranslations;
+}
+
+// Re-export for convenience
+export type { NavigationItem, SiteConfig } from '../types';
+export type { FooterConfig } from './footer';
+export type { SidebarConfig } from './sidebar';

package/src/config/index.ts

@@ -0,0 +1,42 @@
+/**
+ * 配置文件统一导出
+ */
+
+export { siteConfig, defaultSiteConfig, defaultSEO, defineSiteConfig } from './site';
+export { menu, defaultMenu, defineMenu } from './menu';
+export { sidebarConfig, defaultSidebarConfig, defineSidebarConfig } from './sidebar';
+export { defaultIcons, socialLinks, defaultSocialLinks, defineSocialLinks } from './social';
+export { footerConfig, defaultFooterConfig, defineFooterConfig } from './footer';
+
+// i18n exports
+export {
+  defaultI18nConfig,
+  defineI18nConfig,
+  getUITranslations,
+  builtInTranslations,
+  zhCNTranslations,
+  enTranslations,
+  defaultLocales,
+} from './i18n';
+
+export type {
+  SidebarConfig,
+  SidebarGroup,
+  SidebarItem,
+  ScanConfig,
+  ManualConfig,
+  MixedConfig,
+  DividerConfig,
+  PathMatchConfig
+} from './sidebar';
+export type { SocialLink } from './social';
+export type { FooterConfig, FooterLink } from './footer';
+
+// i18n types
+export type {
+  I18nConfig,
+  Locale,
+  LocaleConfig,
+  UITranslations,
+  I18nRoutingConfig,
+} from './i18n';

package/src/config/menu.ts

@@ -0,0 +1,32 @@
+import type { NavigationItem } from '../types';
+
+/**
+ * Default menu configuration
+ */
+export const menu: NavigationItem[] = [
+  {
+    name: '首页',
+    href: '/',
+    icon: 'home'
+  },
+  {
+    name: '博客',
+    href: '/posts',
+    icon: 'posts'
+  },
+  {
+    name: '关于',
+    href: '/about',
+    icon: 'about'
+  }
+];
+
+/**
+ * Define custom menu items
+ */
+export function defineMenu(items: NavigationItem[]): NavigationItem[] {
+  return items;
+}
+
+// 向后兼容
+export const defaultMenu = menu;

package/src/config/sidebar.ts

@@ -0,0 +1,142 @@
+/**
+ * 侧边栏配置系统
+ *
+ * 支持三种配置类型：
+ * 1. scan - 扫描指定文件夹，自动生成树形结构
+ * 2. manual - 手动配置显示特定内容
+ * 3. mixed - 混合使用以上两种方式
+ */
+
+// 路径匹配配置
+export interface PathMatchConfig {
+  pattern: string;
+  exact?: boolean;
+}
+
+// 侧边栏项目类型
+export interface SidebarItem {
+  title: string;
+  slug?: string;
+  link?: string;
+  icon?: string;
+  badge?: string;
+  badgeType?: 'info' | 'success' | 'warning' | 'error';
+  children?: SidebarItem[];
+  collapsed?: boolean;
+}
+
+// 扫描配置
+export interface ScanConfig {
+  type: 'scan';
+  title: string;
+  icon?: string;
+  scanPath: string;
+  collapsed?: boolean;
+  maxDepth?: number;
+  exclude?: string[];
+  include?: string[];
+  sortBy?: 'name' | 'date' | 'title' | 'custom';
+  sortOrder?: 'asc' | 'desc';
+  showForPaths?: string[];
+  hideForPaths?: string[];
+}
+
+// 手动配置
+export interface ManualConfig {
+  type: 'manual';
+  title: string;
+  icon?: string;
+  collapsed?: boolean;
+  items: SidebarItem[];
+  showForPaths?: string[];
+  hideForPaths?: string[];
+}
+
+// 混合配置
+export interface MixedConfig {
+  type: 'mixed';
+  title: string;
+  icon?: string;
+  collapsed?: boolean;
+  sections: (ScanConfig | ManualConfig)[];
+  showForPaths?: string[];
+  hideForPaths?: string[];
+}
+
+// 分隔符
+export interface DividerConfig {
+  type: 'divider';
+  title?: string;
+  showForPaths?: string[];
+  hideForPaths?: string[];
+}
+
+// 侧边栏组配置
+export type SidebarGroup = ScanConfig | ManualConfig | MixedConfig | DividerConfig;
+
+// 完整侧边栏配置
+export interface SidebarConfig {
+  enabled: boolean;
+  width?: string;
+  position?: 'left' | 'right';
+  showSearch?: boolean;
+  showRecentPosts?: boolean;
+  recentPostsCount?: number;
+  showPopularTags?: boolean;
+  popularTagsCount?: number;
+  showArchives?: boolean;
+  archivesCount?: number;
+  showFriendLinks?: boolean;
+  friendLinks?: Array<{
+    title: string;
+    url: string;
+    icon?: string;
+    description?: string;
+  }>;
+  groups: SidebarGroup[];
+}
+
+/**
+ * 默认侧边栏配置
+ */
+export const sidebarConfig: SidebarConfig = {
+  enabled: true,
+  width: '280px',
+  position: 'right',
+  showSearch: true,
+  showRecentPosts: true,
+  recentPostsCount: 5,
+  showPopularTags: true,
+  popularTagsCount: 8,
+  showArchives: true,
+  archivesCount: 6,
+  showFriendLinks: true,
+  friendLinks: [
+    { title: 'Astro 官网', url: 'https://astro.build' },
+    { title: 'Tailwind CSS', url: 'https://tailwindcss.com' },
+    { title: 'Vue.js', url: 'https://vuejs.org' },
+  ],
+  groups: [
+    {
+      type: 'scan',
+      title: '文档目录',
+      icon: 'folder',
+      scanPath: '',
+      collapsed: false,
+    }
+  ]
+};
+
+/**
+ * Define sidebar configuration
+ */
+export function defineSidebarConfig(config: Partial<SidebarConfig>): SidebarConfig {
+  return {
+    ...sidebarConfig,
+    ...config,
+    groups: config.groups || sidebarConfig.groups
+  };
+}
+
+// 向后兼容
+export const defaultSidebarConfig = sidebarConfig;