web/
├── locales/                # 語言資源目錄
│   ├── zh/                 # 中文（簡體）
│   ├── cht/                # 中文（繁體）
│   ├── en/                 # 英文
│   └── ...                 # 其他語言
├── scripts/
│   └── generate_po.py      # 翻譯文件生成腳本
└── utils/
    └── baidutran.py        # 百度翻譯工具
    └── chinesetw.py  # 中文轉換工具

# 生成所有語言翻譯
python generate_po.py

# 生成特定語言翻譯
python generate_po.py en

<!-- 使用 _() 函數(shù)進行文本本地化 -->
<span>{{ _('用戶名') }}</span>

@router.get("/change_language")
def change_language(request: Request, lang: str):
    # 設置語言 Cookie 或 Session
    request.session['lang'] = lang

<div class="info-item">
    <span class="info-label"> {{ _('賬號類型') }} :</span>
    <span>
        {{ _('管理員') if user.is_admin else _('普通用戶') }}
    </span>
</div>
<div class="info-item">
    <span class="info-label"> {{ _('性別') }} :</span>
    <span>
        {{ _('男') if user.sex == '1' else _('女') if user.sex == '0' else user.sex}}
    </span>
</div>

<form action="" method="">
    <div class="mb-3">
        <input type="hidden" name="id" id="id" value="0">
        <label for="content" class="form-label">{{ _('詢價') }} </label>
        <textarea class="form-control" id="content" name="content" rows="3" required></textarea>
    </div>
    <button type="button" class="btn btn-primary">{{ _('提交') }} </button>
</form>

$(function(){
    $('.btn-primary').on('click', function(e) {
        $.ajax({
            url:'/addcomment',
            type: 'POST',
            data: form.serialize(),
            success: function(data) {
                if (data.status === 'success') {
                    location.reload();
                } else {
                    // 使用服務端傳遞的本地化錯誤消息
                    errorDiv.text(data.message);
                }
            }
        });
    });
});

def baidu_translate(query, from_lang='zh', to_lang='en'):
    """調(diào)用百度翻譯API進行翻譯"""
    # 安全檢查：跳過特定類型的文本
    if re.match(r'^/?https?://.+\.(jpg|png|jpeg|gif|bmp|mp3|wav|ogg|mp4|avi|mov|wmv|flv|mkv)$', query):
        return query
    elif re.match(r'^\d{1,11}@[\w.-]{2,30}\.[\w.-]{2,10}$', query):
        return query
    
    # 生成百度翻譯所需的簽名
    salt = random.randint(32768, 65536)
    sign_str = f"{app_id}{query}{salt}{secret_key}"
    sign = hashlib.md5(sign_str.encode('utf-8')).hexdigest()
    
    # 調(diào)用翻譯 API
    params = {
        'q': query,
        'from': from_lang,
        'to': to_lang,
        'appid': app_id,
        'salt': salt,
        'sign': sign
    }

# 中文翻譯到英文
english_text = baidu_translate("國際婚姻網(wǎng)", from_lang='zh', to_lang='en')
# 結果: "International Marriage Network"

# 英文翻譯到中文
chinese_text = baidu_translate("Hello World", from_lang='en', to_lang='zh')
# 結果: "你好，世界"

# 支持多種語言轉換
japanese_text = baidu_translate("你好", from_lang='zh', to_lang='jp')
french_text = baidu_translate("Hello", from_lang='en', to_lang='fra')

error_map = {
    '52003': '未授權用戶',
    '54000': '必填參數(shù)為空',
    '54001': '簽名錯誤',
    '54003': '訪問頻率受限',
    '54004': '賬戶余額不足',
    '54005': '長query請求頻繁',
    '58000': '客戶端IP非法',
    '58001': '譯文語言方向不支持'
}

# .env 文件配置
BAIDU_TRANS_APPID=your_app_id
BAIDU_TRANS_SECRET_KEY=your_secret_key
BAIDU_TRANS_HOST=https://fanyi-api.baidu.com/api/trans/vip/translate

class ChineseConverter:
    def __init__(self):
        self.s2t = OpenCC('s2t')  # 簡體到繁體
        self.t2s = OpenCC('t2s')  # 繁體到簡體

    def to_traditional(self, text: str) -> str:
        """將簡體中文轉換為繁體中文"""
        return self.s2t.convert(text)

    def to_simplified(self, text: str) -> str:
        """將繁體中文轉換為簡體中文"""
        return self.t2s.convert(text)

    def to_pinyin(self, text: str, style=Style.NORMAL) -> list:
        """
        將中文轉換為拼音
        支持多種拼音樣式
        """
        return pinyin(text, style=style)

    def to_pinyin_str(self, text: str, separator=' ', style=Style.NORMAL) -> str:
        """將中文轉換為拼音字符串"""
        py_list = self.to_pinyin(text, style=style)
        return separator.join([''.join(p) for p in py_list])

converter.to_pinyin_str("國際婚姻網(wǎng)")
# 輸出: guo ji hun yin wang

converter.to_pinyin_str("國際婚姻網(wǎng)", style=Style.TONE)
# 輸出: guó jì hūn yìn wǎng

converter.to_pinyin_str("國際婚姻網(wǎng)", style=Style.TONE2)
# 輸出: guo2 ji4 hun1 yin4 wang3

converter.to_pinyin_str("國際婚姻網(wǎng)", style=Style.FIRST_LETTER, separator='')
# 輸出: gjhyw

# 簡體轉繁體
traditional_text = converter.to_traditional("國際婚姻網(wǎng)")
# 結果: 國際婚姻網(wǎng)

# 繁體轉簡體
simplified_text = converter.to_simplified("國際婚姻網(wǎng)")
# 結果: 國際婚姻網(wǎng)

# 獲取帶聲調(diào)拼音
pinyin_with_tone = converter.to_pinyin_str("國際婚姻網(wǎng)", style=Style.TONE)
# 結果: guó jì hūn yìn wǎng

# 推薦創(chuàng)建全局轉換器實例
converter = ChineseConverter()

class Translation(Base):
    __tablename__ = 'translations'
    
    # 主鍵
    id = Column(Integer, primary_key=True, autoincrement=True)
    
    # 原始文本標識符
    msgid = Column(String(255), nullable=False)
    
    # 翻譯后的文本
    msgstr = Column(String(255), nullable=False)
    
    # 語言代碼
    lang_code = Column(String(10), nullable=False)
    
    # 創(chuàng)建時間戳
    created_at = Column(DateTime, server_default=func.now())
    
    # 最后更新時間戳
    updated_at = Column(DateTime, server_default=func.now(), onupdate=func.now())

    # 唯一約束：確保每個 msgid 在特定語言中只有一個翻譯
    __table_args__ = (
        UniqueConstraint('msgid', 'lang_code', name='unique_translation'),
    )

# 創(chuàng)建新翻譯
new_translation = Translation(
    msgid='用戶名',
    msgstr='Username',
    lang_code='en'
)
db.add(new_translation)
db.commit()

# 查詢特定語言翻譯
english_translations = db.query(Translation).filter_by(lang_code='en').all()

def generate_translations(output_dir='locales', specific_lang=None):
    """
    生成翻譯文件
    
    Args:
        output_dir (str): 輸出目錄
        specific_lang (str, optional): 指定語言代碼
    """
    # 獲取中文（簡體）基礎翻譯
    zh_translations = generator.get_translations('zh')
    
    # 確定要生成的語言
    if specific_lang:
        other_langs = [specific_lang]
    else:
        other_langs = generator.get_available_languages()

    # 為每種語言生成翻譯文件
    for lang_code in other_langs:
        # 創(chuàng)建語言目錄
        lang_dir = os.path.join(output_dir, lang_code, 'LC_MESSAGES')
        os.makedirs(lang_dir, exist_ok=True)
        
        # 生成 .po 文件
        with open(os.path.join(lang_dir, 'messages.po'), 'w') as f:
            # 寫入文件頭
            # 寫入翻譯條目
            for zh_trans in zh_translations:
                # 使用百度翻譯 API 翻譯
                msgstr = baidu_translate(zh_trans['msgid'], from_lang='zh', to_lang=lang_code)
                
                # 寫入翻譯條目
                f.write(f'msgid "{zh_trans["msgid"]}"\n')
                f.write(f'msgstr "{msgstr}"\n')

### 語言提示保存在表里

DROP TABLE IF EXISTS translations;
CREATE TABLE translations (
id int NOT NULL AUTO_INCREMENT,
msgid varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL,
msgstr varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL,
lang_code varchar(10) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL,
created_at timestamp NULL DEFAULT CURRENT_TIMESTAMP,
updated_at timestamp NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (id) USING BTREE,
UNIQUE INDEX unique_translation(msgid ASC, lang_code ASC) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 32 CHARACTER SET = utf8mb4 COLLATE = utf8mb4_general_ci ROW_FORMAT = Dynamic;

INSERT INTO translations VALUES (1, ‘首頁', ‘首頁', ‘zh', ‘2025-02-15 13:50:35', ‘2025-02-15 13:53:03');
INSERT INTO translations VALUES (2, ‘分類', ‘分類', ‘zh', ‘2025-02-15 13:50:35', ‘2025-02-15 13:53:03');
INSERT INTO translations VALUES (3, ‘標簽', ‘標簽', ‘zh', ‘2025-02-15 13:50:35', ‘2025-02-15 13:53:03');
INSERT INTO translations VALUES (4, ‘關于', ‘關于', ‘zh', ‘2025-02-15 13:50:35', ‘2025-02-15 13:53:03');
INSERT INTO translations VALUES (5, ‘個人資料', ‘個人資料', ‘zh', ‘2025-02-15 13:50:35', ‘2025-02-15 13:53:03');

#中文
msgid “郵件驗證”
msgstr “郵件驗證”

msgid “郵箱”
msgstr “郵箱”

msgid “郵編”
msgstr “郵編”

msgid “閱讀更多”
msgstr “閱讀更多”

msgid “首頁”
msgstr “閱讀更多”

msgid “驗證碼”
msgstr “驗證碼”
msgid “郵件驗證”
msgstr “Email Verification”

msgid “郵箱”
msgstr “Email Box”

msgid “郵編”
msgstr “Postal Code”

msgid “閱讀更多”
msgstr “Read More”

msgid “首頁”
msgstr “Home Page”

msgid “驗證碼”
msgstr “Verification Code”