chore: update theme guide

src/content/posts/Theme Guide-zh-tw.md

@@ -9,3 +9,186 @@ abbrlink: theme-guide
 ---
 
 Retypeset 是一款基於 [Astro](https://astro.build/) 框架的靜態部落格主題，中文名為重新編排。本主題以 [活版印字](https://astro-theme-typography.vercel.app/) 為設計靈感，通過建立全新的視覺規範，對所有頁面進行重新編排，打造紙質書頁般的閱讀體驗，再現版式之美。所見皆為細節，方寸盡顯優雅。
+
+## 主題配置
+
+以下為 Retypeset 的主題配置介紹。通過修改配置文件 [src/config.ts](https://github.com/radishzzz/astro-theme-retypeset/blob/master/src/config.ts) 來自定義你的部落格。
+
+### 站點信息
+
+```ts
+site: {
+  // 站點標題
+  title: 'Retypeset'
+  // 站點副標題
+  subtitle: 'Revive the beauty of typography'
+  // 站點介紹
+  description: 'Retypeset is a static blog theme...'
+  // 使用 src/i18n/ui.ts 中的多語言標題/副標題/站點描述，替換以上靜態配置
+  i18nTitle: true // true, false
+  // 作者名稱
+  author: 'radishzz'
+  // 站點地址
+  url: 'https://retypeset.radishzz.cc'
+  // 站點圖標
+  // 推薦格式: svg, png, ico
+  favicon: '/icon/favicon.svg' // 或 https://example.com/favicon.svg
+}
+```
+
+### 主題配色
+
+```ts
+color: {
+  // 默認主題
+  mode: 'light' // light, dark
+  // 亮色模式
+  light: {
+    // 高亮顏色
+    // 用於站點標題、滑鼠懸停效果等
+    primary: 'oklch(25% 0.005 298)'
+    // 次要顏色
+    // 用於普通文本
+    secondary: 'oklch(40% 0.005 298)'
+    // 背景色
+    background: 'oklch(96% 0.005 298)'
+  }
+  // 暗色模式
+  dark: {
+    // 高亮顏色
+    // 用於標題、hover等
+    primary: 'oklch(92% 0.005 298)'
+    // 次要顏色
+    // 用於普通文本
+    secondary: 'oklch(77% 0.005 298)'
+    // 背景色
+    background: 'oklch(22% 0.005 298)'
+  }
+}
+```
+
+### 全局設置
+
+```ts
+global: {
+  // 默認語言
+  // 站點根路徑 '/' 的語言
+  locale: 'zh' // zh, zh-tw, ja, en, es, ru
+  // 更多語言
+  // 生成 '/ja/' '/en/' 等多語言路徑
+  // 不要重複填寫默認語言
+  moreLocales: ['zh-tw', 'ja', 'en', 'es', 'ru'] // ['zh', 'zh-tw', 'ja', 'en', 'es', 'ru']
+  // 字體樣式
+  fontStyle: 'sans' // sans, serif
+  // 文章日期格式
+  dateFormat: 'YYYY-MM-DD' // YYYY-MM-DD, MM-DD-YYYY, DD-MM-YYYY, MONTH DAY YYYY, DAY MONTH YYYY
+  // 標題與副標題之間的距離
+  titleGap: 2 // 1, 2, 3
+}
+```
+
+### 評論服務
+
+```ts
+comment: {
+  // 開啟評論
+  enabled: true // true, false
+  // waline 評論
+  waline: {
+    // 服務器地址
+    serverURL: 'https://retypeset-comment.radishzz.cc'
+    // emoji 表情地址
+    emoji: [
+      'https://unpkg.com/@waline/emojis@1.2.0/tw-emoji'
+      // 'https://unpkg.com/@waline/emojis@1.2.0/bmoji'
+      // 更多表情: https://waline.js.org/en/guide/features/emoji.html
+    ]
+    // gif 搜索
+    search: false // true, false
+    // 圖片上傳
+    imageUploader: false // true, false
+  }
+}
+```
+
+### 搜索引擎優化
+
+```ts
+seo: {
+  // @twitter ID
+  twitterID: '@radishzz_'
+  // 站點驗證
+  verification: {
+    // google 搜索控制台
+    google: 'AUCrz5F1e5qbnmKKDXl2Sf8u6y0kOpEO1wLs6HMMmlM'
+    // bing 網站管理員工具
+    bing: '64708CD514011A7965C84DDE1D169F87'
+    // yandex 網站管理員
+    yandex: ''
+    // baidu 站長工具
+    baidu: ''
+  }
+  // google 網站分析
+  googleAnalyticsID: ''
+  // umami 網站分析
+  umamiAnalyticsID: '520af332-bfb7-4e7c-9386-5f273ee3d697'
+  // follow 驗證
+  follow: {
+    // 訂閱 ID
+    feedID: ''
+    // 用戶 ID
+    userID: ''
+  }
+  // apiflash access key 訪問密鑰
+  // 自動生成網站截圖用於 open graph
+  // 獲取訪問密鑰: https://apiflash.com/
+  apiflashKey: ''
+}
+```
+
+### 自定義頁腳
+
+```ts
+footer: {
+  // 社交鏈接
+  links: [
+    {
+      name: 'RSS',
+      url: '/rss.xml', // rss.xml, atom.xml
+    },
+    {
+      name: 'GitHub',
+      url: 'https://github.com/radishzzz/astro-theme-retypeset',
+    },
+    {
+      name: 'Twitter',
+      url: 'https://x.com/radishzz_',
+    },
+    // {
+    //   name: 'Email',
+    //   url: 'https://example@gmail.com',
+    // }
+  ]
+  // 建站年份
+  startYear: 2024
+}
+```
+
+### 資源預加載
+
+```ts
+preload: {
+  // 鏈接預加載策略
+  linkPrefetch: 'viewport' // hover, tap, viewport, load
+  // 評論服務器地址
+  commentURL: 'https://retypeset-comment.radishzz.cc'
+  // 圖床地址
+  imageHostURL: 'https://image.radishzz.cc'
+  // 定制 google analytics js
+  // 適用於路由 google analytics js 到自定義域名的情況
+  customGoogleAnalyticsJS: ''
+  // 定制 umami analytics js
+  // 適用於自部署 umami，或路由 umami analytics js 到自定義域名的情況
+  customUmamiAnalyticsJS: 'https://js.radishzz.cc/jquery.min.js'
+}
+```