DandersFrames 中文化

External Chinese localization addon for DandersFrames with zhTW / zhCN support.
Localization only — does not modify DandersFrames core gameplay logic or frame behavior.
本插件為 DandersFrames 外置中文化模組，支援 繁體中文（zhTW）/ 簡體中文（zhCN）。
僅提供介面本地化翻譯，不修改主插件核心功能、設定邏輯或框體行為。

---

📌 Overview / 簡介

繁體中文（zhTW）
本插件是 DandersFrames 的外置中文化模組，提供繁體中文（zhTW）與簡體中文（zhCN）語系支援。
主要用途是將 DandersFrames 原始英文介面文字、本地設定頁、工具提示與部分動態內容轉換為中文，提升中文玩家的可讀性與操作便利性。

本插件專注於 本地化與介面翻譯體驗，不修改 DandersFrames 的核心功能、戰鬥邏輯、框體行為或設定運作方式。

简体中文（zhCN）
本插件是 DandersFrames 的外置中文化模块，提供繁体中文（zhTW）与简体中文（zhCN）语言支持。
主要用于将 DandersFrames 原始英文界面文本、设置页面、提示文本与部分动态内容转换为中文，提升中文玩家的可读性与使用体验。

本插件专注于 本地化与界面翻译体验，不会修改 DandersFrames 的核心功能、战斗逻辑、框体行为或配置运行方式。

English
This addon is an external Chinese localization module for DandersFrames, with support for both Traditional Chinese (zhTW) and Simplified Chinese (zhCN).
It translates the original English UI, configuration pages, tooltips, and selected dynamic strings into Chinese for better readability and usability.

This addon is localization-focused only and does not modify DandersFrames core gameplay logic, combat behavior, or frame systems.

---

✨ Features / 功能特色

• Dual-locale support: zhTW / zhCN
  支援繁體中文 / 簡體中文雙語系，自動跟隨遊戲客戶端語系切換。

• Expanded GUI translation coverage
  擴充常見 GUI 元件翻譯覆蓋，例如按鈕、標籤、滑桿、輸入框、提示文字與下拉選單。

• Improved page refresh translation
  改善切頁、開窗後的即時翻譯刷新，降低部分頁面需要重開才會更新文字的情況。

• Dropdown / nested options translation support
  支援下拉選單與巢狀 options 文字翻譯。

• A/B translation mode switching
  提供兩種翻譯模式：

  • Mode A / Stable：穩定、省性能，適合日常使用
  • Mode B / Full：翻譯較完整，適合需要更高覆蓋率的頁面

• In-game options support
  可於遊戲內開啟簡易面板與 WoW 設定頁切換模式、重新掃描與清快取。

• Special-page handling improvements
  針對 Aura Blacklist / Aura Designer 等特殊頁面做了較穩定的翻譯補強與切頁處理。

• Cache cleanup when UI closes
  當 DandersFrames UI 關閉後，會清理部分快取以降低長時間使用造成的資源累積。

• Built-in debug tools for reporting untranslated strings
  內建進階除錯 / 診斷工具，方便後續補翻與回報未翻譯內容。

• No changes to original DandersFrames files
  不改動主插件原始檔案，方便獨立更新與維護。

---

🆕 What’s New in 1.2.0 / 1.2.0 重點

• Added translation mode switching: stable / full
• Added a simplified player panel for easier mode switching
• Added Options.lua integration for WoW in-game settings
• Moved advanced debug tools into a separate debug panel
• Improved translation stability for special pages such as:
  • Aura Blacklist
  • Aura Designer
• Added cache cleanup and safer refresh behavior to reduce lag / memory growth
• Improved zhCN wording consistency for hardcoded zhTW fallback text

---

📦 Requirements / 安裝需求

• Requires DandersFrames main addon
• This addon is an external localization module and does not replace the main addon
• 需先安裝 DandersFrames 主插件
• 本插件為外置中文化模組，不能單獨取代主插件使用

---

🚀 Installation / 安裝方式

English

1. Install DandersFrames
2. Install this localization addon
3. Restart the game or run /reload
4. Make sure both addons are enabled

繁體中文

1. 先安裝 DandersFrames 主插件
2. 安裝本中文化插件
3. 重新登入遊戲或輸入 /reload
4. 確認兩個插件都已啟用

---

⌨️ Commands / 指令

Basic / 常用

• /dfzh
• /dfzh ui
• /dfzh options
• /dfzh mode stable
• /dfzh mode full
• /dfzh preset rec
• /dfzh force
• /dfzh clearcache

Advanced / Debug

• /dfzh debugui
• /dfzh stats
• /dfzh report
• /dfzh dump [n]
• /dfzh clear
• /dfzh trace on|off
• /dfzh on|off

---

💡 Recommended Usage / 使用建議

For most players / 一般玩家建議：

1. Use Recommended Preset
2. Switch to Mode A / Stable
3. Only switch to Mode B / Full if you want more complete translation coverage on certain pages

建議流程：

1. 先用 推薦設定
2. 日常使用切到 模式A / 穩定
3. 如果 Aura Blacklist / Aura Designer 等頁面想補更多翻譯，再切 模式B / 完整

---

ℹ️ Notes / 補充說明

• Locale follows your game client locale automatically (zhTW / zhCN)
  語系會自動跟隨遊戲客戶端（zhTW / zhCN）

• Some newly added upstream strings may remain untranslated temporarily after DandersFrames updates
  主插件更新後，若新增字串尚未收錄，可能會暫時顯示英文

• This addon does not add gameplay features or alter combat behavior
  本插件不會新增玩法功能，也不會改動戰鬥邏輯

• Full translation mode may use more resources than Stable mode
  完整模式的資源消耗可能高於穩定模式

---

🧩 Troubleshooting / 常見問題

Still seeing English text?

• Make sure both addons are enabled
• Run /reload
• Try /dfzh force or /dfzh clearcache

Some pages look partially translated?

• Try switching from stable to full mode

I only want simple controls

• Use /dfzh ui or /dfzh options

進遊戲還有英文？

• 確認主插件與中文化插件都已啟用
• 輸入 /reload
• 可嘗試 /dfzh force 或 /dfzh clearcache

某些頁面翻譯不完整？

• 可改用 /dfzh mode full

只想用簡單設定，不想看 debug？

• 用 /dfzh ui 或 /dfzh options 即可

---

🛠️ Feedback / 問題回報

If you find untranslated text, please include:

• Original English text
• Where it appears (page / tab / button / tooltip)
• How to reproduce it
• Screenshot (optional)

如果你發現未翻譯內容，回報時建議附上：

• 英文原文
• 出現位置（頁面 / 分頁 / 按鈕 / tooltip）
• 重現步驟
• 截圖（可選）

---

📎 Additional Notes / 補充資訊

• Compatible with current Retail versions of DandersFrames

• Unofficial external localization addon

• New strings added by upstream updates may temporarily remain in English until patched

• Changelog is provided in each release

• 相容目前 Retail 版 DandersFrames

• 本插件為非官方外置中文化模組

• 主插件更新新增字串後，可能短暫保留英文，後續版本會補齊

• 每次更新內容請參閱版本 Changelog

---

🙏 Acknowledgements / 致謝

Thanks to the original DandersFrames author(s) and all players who reported untranslated strings and UI issues.
感謝 DandersFrames 原作者，以及所有協助回報未翻譯內容與介面問題的玩家。