@jet-w/astro-blog 0.2.1 → 0.2.3

package/src/config/site.ts

@@ -0,0 +1,61 @@
+import type { SiteConfig } from '../types';
+
+/**
+ * Default site configuration
+ * Users should override this in their own config
+ */
+export const siteConfig: SiteConfig = {
+  title: 'My Astro Blog',
+  description: '',
+  author: 'Author',
+  email: '',
+  avatar: '/images/avatar.svg',
+  social: {
+    github: '',
+    twitter: '',
+    linkedin: '',
+    email: ''
+  },
+  menu: [
+    {
+      name: '首页',
+      href: '/',
+      icon: 'home'
+    },
+    {
+      name: '博客',
+      href: '/posts',
+      icon: 'posts'
+    },
+    {
+      name: '关于',
+      href: '/about',
+      icon: 'about'
+    }
+  ]
+};
+
+export const defaultSEO = {
+  title: siteConfig.title,
+  description: siteConfig.description,
+  image: '/images/og-image.jpg',
+  type: 'website' as const
+};
+
+/**
+ * Create site config with user overrides
+ */
+export function defineSiteConfig(config: Partial<SiteConfig>): SiteConfig {
+  return {
+    ...siteConfig,
+    ...config,
+    social: {
+      ...siteConfig.social,
+      ...config.social
+    },
+    menu: config.menu || siteConfig.menu
+  };
+}
+
+// 向后兼容的别名
+export const defaultSiteConfig = siteConfig;

package/src/config/social.ts

@@ -0,0 +1,29 @@
+/**
+ * 社交链接配置
+ */
+
+export interface SocialLink {
+  type: string;
+  url: string;
+  label?: string;
+  icon?: string;
+}
+
+export const defaultIcons: Record<string, string> = {
+  github: 'M12 0C5.374 0 0 5.373 0 12c0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23A11.509 11.509 0 0112 5.803c1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576C20.566 21.797 24 17.3 24 12c0-6.627-5.373-12-12-12z',
+  twitter: 'M23.953 4.57a10 10 0 01-2.825.775 4.958 4.958 0 002.163-2.723c-.951.555-2.005.959-3.127 1.184a4.92 4.92 0 00-8.384 4.482C7.69 8.095 4.067 6.13 1.64 3.162a4.822 4.822 0 00-.666 2.475c0 1.71.87 3.213 2.188 4.096a4.904 4.904 0 01-2.228-.616v.06a4.923 4.923 0 003.946 4.827 4.996 4.996 0 01-2.212.085 4.936 4.936 0 004.604 3.417 9.867 9.867 0 01-6.102 2.105c-.39 0-.779-.023-1.17-.067a13.995 13.995 0 007.557 2.209c9.053 0 13.998-7.496 13.998-13.985 0-.21 0-.42-.015-.63A9.935 9.935 0 0024 4.59z',
+  linkedin: 'M20.447 20.452h-3.554v-5.569c0-1.328-.027-3.037-1.852-3.037-1.853 0-2.136 1.445-2.136 2.939v5.667H9.351V9h3.414v1.561h.046c.477-.9 1.637-1.85 3.37-1.85 3.601 0 4.267 2.37 4.267 5.455v6.286zM5.337 7.433c-1.144 0-2.063-.926-2.063-2.065 0-1.138.92-2.063 2.063-2.063 1.14 0 2.064.925 2.064 2.063 0 1.139-.925 2.065-2.064 2.065zm1.782 13.019H3.555V9h3.564v11.452zM22.225 0H1.771C.792 0 0 .774 0 1.729v20.542C0 23.227.792 24 1.771 24h20.451C23.2 24 24 23.227 24 22.271V1.729C24 .774 23.2 0 22.222 0h.003z',
+  email: 'M3 8l7.89 4.26a2 2 0 002.22 0L21 8M5 19h14a2 2 0 002-2V7a2 2 0 00-2-2H5a2 2 0 00-2 2v10a2 2 0 002 2z',
+  youtube: 'M23.498 6.186a3.016 3.016 0 0 0-2.122-2.136C19.505 3.545 12 3.545 12 3.545s-7.505 0-9.377.505A3.017 3.017 0 0 0 .502 6.186C0 8.07 0 12 0 12s0 3.93.502 5.814a3.016 3.016 0 0 0 2.122 2.136c1.871.505 9.376.505 9.376.505s7.505 0 9.377-.505a3.015 3.015 0 0 0 2.122-2.136C24 15.93 24 12 24 12s0-3.93-.502-5.814zM9.545 15.568V8.432L15.818 12l-6.273 3.568z',
+  discord: 'M20.317 4.3698a19.7913 19.7913 0 00-4.8851-1.5152.0741.0741 0 00-.0785.0371c-.211.3753-.4447.8648-.6083 1.2495-1.8447-.2762-3.68-.2762-5.4868 0-.1636-.3933-.4058-.8742-.6177-1.2495a.077.077 0 00-.0785-.037 19.7363 19.7363 0 00-4.8852 1.515.0699.0699 0 00-.0321.0277C.5334 9.0458-.319 13.5799.0992 18.0578a.0824.0824 0 00.0312.0561c2.0528 1.5076 4.0413 2.4228 5.9929 3.0294a.0777.0777 0 00.0842-.0276c.4616-.6304.8731-1.2952 1.226-1.9942a.076.076 0 00-.0416-.1057c-.6528-.2476-1.2743-.5495-1.8722-.8923a.077.077 0 01-.0076-.1277c.1258-.0943.2517-.1923.3718-.2914a.0743.0743 0 01.0776-.0105c3.9278 1.7933 8.18 1.7933 12.0614 0a.0739.0739 0 01.0785.0095c.1202.099.246.1981.3728.2924a.077.077 0 01-.0066.1276 12.2986 12.2986 0 01-1.873.8914.0766.0766 0 00-.0407.1067c.3604.698.7719 1.3628 1.225 1.9932a.076.076 0 00.0842.0286c1.961-.6067 3.9495-1.5219 6.0023-3.0294a.077.077 0 00.0313-.0552c.5004-5.177-.8382-9.6739-3.5485-13.6604a.061.061 0 00-.0312-.0286zM8.02 15.3312c-1.1825 0-2.1569-1.0857-2.1569-2.419 0-1.3332.9555-2.4189 2.157-2.4189 1.2108 0 2.1757 1.0952 2.1568 2.419 0 1.3332-.9555 2.4189-2.1569 2.4189zm7.9748 0c-1.1825 0-2.1569-1.0857-2.1569-2.419 0-1.3332.9554-2.4189 2.1569-2.4189 1.2108 0 2.1757 1.0952 2.1568 2.419 0 1.3332-.946 2.4189-2.1568 2.4189z'
+};
+
+export const socialLinks: SocialLink[] = [];
+export const defaultSocialLinks = socialLinks;
+
+/**
+ * Define social links
+ */
+export function defineSocialLinks(links: SocialLink[]): SocialLink[] {
+  return links;
+}

package/src/types/index.ts

@@ -0,0 +1,80 @@
+export interface BlogPost {
+  slug: string;
+  title: string;
+  description: string;
+  content: string;
+  pubDate: Date;
+  updatedDate?: Date;
+  tags: string[];
+  categories: string[];
+  author?: string;
+  image?: string;
+  draft?: boolean;
+  readingTime?: number;
+}
+
+export interface PostFrontmatter {
+  title: string;
+  description: string;
+  pubDate: string;
+  updatedDate?: string;
+  tags?: string[];
+  categories?: string[];
+  author?: string;
+  image?: string;
+  draft?: boolean;
+}
+
+export interface Tag {
+  name: string;
+  count: number;
+  slug: string;
+}
+
+export interface Category {
+  name: string;
+  count: number;
+  slug: string;
+}
+
+export interface SearchResult {
+  title: string;
+  description: string;
+  url: string;
+  content: string;
+  tags: string[];
+  categories: string[];
+}
+
+export interface NavigationItem {
+  name: string;
+  href: string;
+  icon?: string;
+  children?: NavigationItem[];
+}
+
+export interface SiteConfig {
+  title: string;
+  description: string;
+  author: string;
+  email?: string;
+  avatar?: string;
+  social?: {
+    github?: string;
+    twitter?: string;
+    linkedin?: string;
+    email?: string;
+  };
+  menu: NavigationItem[];
+}
+
+export interface SEOProps {
+  title?: string;
+  description?: string;
+  image?: string;
+  url?: string;
+  type?: 'website' | 'article';
+  publishedTime?: string;
+  modifiedTime?: string;
+  tags?: string[];
+}

package/src/utils/i18n.ts

@@ -0,0 +1,418 @@
+/**
+ * i18n Utility Functions
+ *
+ * Provides helper functions for multi-language support.
+ */
+
+import type {
+  I18nConfig,
+  Locale,
+  UITranslations,
+} from '../config/i18n';
+import {
+  defaultI18nConfig,
+  getUITranslations,
+} from '../config/i18n';
+import type { SiteConfig, NavigationItem } from '../types';
+import type { FooterConfig } from '../config/footer';
+import type { SidebarConfig } from '../config/sidebar';
+import { defaultSiteConfig } from '../config/site';
+import { defaultMenu } from '../config/menu';
+import { defaultFooterConfig } from '../config/footer';
+import { sidebarConfig as defaultSidebarConfig } from '../config/sidebar';
+
+/**
+ * Merged locale configuration with all defaults applied
+ */
+export interface MergedLocaleConfig {
+  locale: Locale;
+  site: SiteConfig;
+  menu: NavigationItem[];
+  footer: FooterConfig;
+  sidebar: SidebarConfig;
+  ui: UITranslations;
+}
+
+/**
+ * Alternate link for SEO (hreflang)
+ */
+export interface AlternateLink {
+  locale: string;
+  url: string;
+  hreflang: string;
+}
+
+/**
+ * Get current locale from URL pathname
+ *
+ * @example
+ * getLocaleFromPath('/en/posts', config) // 'en'
+ * getLocaleFromPath('/posts', config) // 'zh-CN' (default)
+ * getLocaleFromPath('/zh-CN/about', config) // 'zh-CN'
+ */
+export function getLocaleFromPath(
+  pathname: string,
+  config: I18nConfig = defaultI18nConfig
+): string {
+  // Remove leading slash and get first segment
+  const segments = pathname.replace(/^\//, '').split('/');
+  const firstSegment = segments[0];
+
+  // Check if first segment matches any locale code
+  const matchedLocale = config.locales.find(
+    (locale) => locale.code === firstSegment
+  );
+
+  if (matchedLocale) {
+    return matchedLocale.code;
+  }
+
+  // Return default locale
+  return config.defaultLocale;
+}
+
+/**
+ * Get locale data by code
+ */
+export function getLocaleByCode(
+  code: string,
+  config: I18nConfig = defaultI18nConfig
+): Locale | undefined {
+  return config.locales.find((locale) => locale.code === code);
+}
+
+/**
+ * Remove locale prefix from pathname
+ *
+ * @example
+ * removeLocalePrefix('/en/posts', config) // '/posts'
+ * removeLocalePrefix('/posts', config) // '/posts'
+ */
+export function removeLocalePrefix(
+  pathname: string,
+  config: I18nConfig = defaultI18nConfig
+): string {
+  const locale = getLocaleFromPath(pathname, config);
+
+  // If it's default locale and prefix is not required, pathname has no prefix
+  if (locale === config.defaultLocale && !config.routing.prefixDefaultLocale) {
+    return pathname;
+  }
+
+  // Remove the locale prefix
+  const prefix = `/${locale}`;
+  if (pathname.startsWith(prefix)) {
+    const rest = pathname.slice(prefix.length);
+    return rest || '/';
+  }
+
+  return pathname;
+}
+
+/**
+ * Get localized path for a given locale
+ *
+ * @example
+ * getLocalizedPath('/posts', 'en', config) // '/en/posts'
+ * getLocalizedPath('/en/posts', 'zh-CN', config) // '/posts' (if zh-CN is default)
+ */
+export function getLocalizedPath(
+  pathname: string,
+  targetLocale: string,
+  config: I18nConfig = defaultI18nConfig
+): string {
+  // First, remove any existing locale prefix
+  const basePath = removeLocalePrefix(pathname, config);
+
+  // If target is default locale and prefix is not required
+  if (
+    targetLocale === config.defaultLocale &&
+    !config.routing.prefixDefaultLocale
+  ) {
+    return basePath;
+  }
+
+  // Add locale prefix
+  if (basePath === '/') {
+    return `/${targetLocale}`;
+  }
+
+  return `/${targetLocale}${basePath}`;
+}
+
+/**
+ * Get all alternate links for SEO (hreflang tags)
+ *
+ * @example
+ * getAlternateLinks('/posts', 'https://example.com', config)
+ * // Returns links for all locales
+ */
+export function getAlternateLinks(
+  pathname: string,
+  baseUrl: string,
+  config: I18nConfig = defaultI18nConfig
+): AlternateLink[] {
+  const links: AlternateLink[] = [];
+
+  for (const locale of config.locales) {
+    const localizedPath = getLocalizedPath(pathname, locale.code, config);
+    links.push({
+      locale: locale.code,
+      url: `${baseUrl.replace(/\/$/, '')}${localizedPath}`,
+      hreflang: locale.htmlLang,
+    });
+  }
+
+  // Add x-default pointing to default locale
+  const defaultPath = getLocalizedPath(
+    pathname,
+    config.defaultLocale,
+    config
+  );
+  links.push({
+    locale: 'x-default',
+    url: `${baseUrl.replace(/\/$/, '')}${defaultPath}`,
+    hreflang: 'x-default',
+  });
+
+  return links;
+}
+
+/**
+ * Deep merge two objects
+ */
+function deepMerge<T extends object>(base: T, override: Partial<T>): T {
+  const result = { ...base };
+
+  for (const key in override) {
+    if (Object.prototype.hasOwnProperty.call(override, key)) {
+      const overrideValue = override[key];
+      const baseValue = base[key];
+
+      if (
+        typeof overrideValue === 'object' &&
+        overrideValue !== null &&
+        !Array.isArray(overrideValue) &&
+        typeof baseValue === 'object' &&
+        baseValue !== null &&
+        !Array.isArray(baseValue)
+      ) {
+        (result as any)[key] = deepMerge(baseValue as object, overrideValue as object);
+      } else if (overrideValue !== undefined) {
+        (result as any)[key] = overrideValue;
+      }
+    }
+  }
+
+  return result;
+}
+
+/**
+ * Get merged configuration for a specific locale
+ * Combines default config with locale-specific overrides
+ */
+export function getLocaleConfig(
+  locale: string,
+  config: I18nConfig = defaultI18nConfig
+): MergedLocaleConfig {
+  const localeData = getLocaleByCode(locale, config);
+  const localeOverrides = config.localeConfigs[locale] || {};
+
+  // Get locale info (fallback to creating one from code)
+  const localeInfo: Locale = localeData || {
+    code: locale,
+    name: locale,
+    htmlLang: locale,
+    dateLocale: locale,
+    direction: 'ltr',
+  };
+
+  // Merge site config
+  const site = deepMerge(defaultSiteConfig, localeOverrides.site || {});
+
+  // Use locale-specific menu or default menu
+  const menu = localeOverrides.menu || defaultMenu;
+
+  // Merge footer config
+  const footer = deepMerge(defaultFooterConfig, localeOverrides.footer || {});
+
+  // Merge sidebar config
+  const sidebar = localeOverrides.sidebar
+    ? {
+        ...defaultSidebarConfig,
+        ...localeOverrides.sidebar,
+        // Use locale-specific groups if provided, otherwise keep default
+        groups: localeOverrides.sidebar.groups || defaultSidebarConfig.groups,
+      }
+    : defaultSidebarConfig;
+
+  // Get UI translations
+  const ui = getUITranslations(locale, config);
+
+  return {
+    locale: localeInfo,
+    site,
+    menu,
+    footer,
+    sidebar,
+    ui,
+  };
+}
+
+/**
+ * Translation function - get a UI translation string
+ *
+ * @example
+ * t('readMore', 'en') // 'Read more'
+ * t('readMore', 'zh-CN') // '阅读更多'
+ */
+export function t(
+  key: keyof UITranslations,
+  locale: string,
+  config?: I18nConfig
+): string {
+  const translations = getUITranslations(locale, config);
+  return translations[key] || key;
+}
+
+/**
+ * Format date according to locale
+ *
+ * @example
+ * formatDate(new Date(), 'en') // 'January 1, 2024'
+ * formatDate(new Date(), 'zh-CN') // '2024年1月1日'
+ */
+export function formatDate(
+  date: Date | string,
+  locale: string,
+  options?: Intl.DateTimeFormatOptions
+): string {
+  const dateObj = typeof date === 'string' ? new Date(date) : date;
+
+  const defaultOptions: Intl.DateTimeFormatOptions = {
+    year: 'numeric',
+    month: 'long',
+    day: 'numeric',
+  };
+
+  return new Intl.DateTimeFormat(locale, options || defaultOptions).format(
+    dateObj
+  );
+}
+
+/**
+ * Format date in short format
+ *
+ * @example
+ * formatDateShort(new Date(), 'en') // '1/1/2024'
+ * formatDateShort(new Date(), 'zh-CN') // '2024/1/1'
+ */
+export function formatDateShort(
+  date: Date | string,
+  locale: string
+): string {
+  const dateObj = typeof date === 'string' ? new Date(date) : date;
+
+  return new Intl.DateTimeFormat(locale, {
+    year: 'numeric',
+    month: 'numeric',
+    day: 'numeric',
+  }).format(dateObj);
+}
+
+/**
+ * Check if a locale is RTL (right-to-left)
+ */
+export function isRTL(
+  locale: string,
+  config: I18nConfig = defaultI18nConfig
+): boolean {
+  const localeData = getLocaleByCode(locale, config);
+  return localeData?.direction === 'rtl';
+}
+
+/**
+ * Get the HTML dir attribute value
+ */
+export function getTextDirection(
+  locale: string,
+  config: I18nConfig = defaultI18nConfig
+): 'ltr' | 'rtl' {
+  return isRTL(locale, config) ? 'rtl' : 'ltr';
+}
+
+/**
+ * Check if multi-language is enabled (more than one locale)
+ */
+export function isMultiLanguageEnabled(
+  config: I18nConfig = defaultI18nConfig
+): boolean {
+  return config.locales.length > 1;
+}
+
+/**
+ * Get prefix for a locale in routes
+ * Returns empty string for default locale if prefixDefaultLocale is false
+ */
+export function getLocalePrefix(
+  locale: string,
+  config: I18nConfig = defaultI18nConfig
+): string {
+  if (locale === config.defaultLocale && !config.routing.prefixDefaultLocale) {
+    return '';
+  }
+  return `/${locale}`;
+}
+
+/**
+ * Get content path prefix for a specific locale
+ * Returns the contentPathPrefix from locale config, or undefined if not set
+ */
+export function getContentPathPrefix(
+  locale: string,
+  config: I18nConfig = defaultI18nConfig
+): string | undefined {
+  const localeConfig = config.localeConfigs[locale];
+  return localeConfig?.contentPathPrefix;
+}
+
+/**
+ * Filter posts by locale based on contentPathPrefix
+ * If contentPathPrefix is set, only return posts that start with that prefix
+ * If not set, return all posts (backward compatible)
+ *
+ * @example
+ * // If en locale has contentPathPrefix: 'blog_docs_en'
+ * filterPostsByLocale(posts, 'en', config)
+ * // Returns only posts with id starting with 'blog_docs_en/'
+ */
+export function filterPostsByLocale<T extends { id: string }>(
+  posts: T[],
+  locale: string,
+  config: I18nConfig = defaultI18nConfig
+): T[] {
+  const contentPathPrefix = getContentPathPrefix(locale, config);
+
+  // If no contentPathPrefix is set, return all posts (backward compatible)
+  if (!contentPathPrefix) {
+    return posts;
+  }
+
+  // Filter posts that start with the content path prefix
+  return posts.filter((post) => {
+    const postPath = post.id.toLowerCase();
+    const prefix = contentPathPrefix.toLowerCase();
+    return postPath.startsWith(prefix + '/') || postPath === prefix;
+  });
+}
+
+// Re-export types and config functions
+export type { I18nConfig, Locale, LocaleConfig, UITranslations } from '../config/i18n';
+export {
+  defaultI18nConfig,
+  defineI18nConfig,
+  getUITranslations,
+  builtInTranslations,
+  zhCNTranslations,
+  enTranslations,
+} from '../config/i18n';