语言本地化（Localization）

本指南解释了如何在 Melody Auth 中为身份页面和邮件模板添加和使用新的语言。

概述

• 默认语言：en 和 fr
• 额外支持：zh
• 你可以通过提供翻译并更新配置来添加更多语言

为邮件模板添加翻译

在 server/src/configs/locale.ts 中为你的新语言提供翻译。

为身份页面添加翻译

你可以在 server/src/pages/tools/locale.ts 中为身份页面添加翻译。

在服务器配置中允许该语言

在 server/wrangler.toml 的 [vars] 中更新 SUPPORTED_LOCALES，这样身份页面和邮件才能使用它。

[vars]
SUPPORTED_LOCALES = ["en", "fr", "de"]
# 可选：在身份页面上显示语言切换器
ENABLE_LOCALE_SELECTOR = true

注意事项：

• 文档中提到的支持语言：['en', 'fr', 'zh']
• 如果 SUPPORTED_LOCALES 中只包含一种语言，即使 ENABLE_LOCALE_SELECTOR 为 true，切换器也会被隐藏。
• 你可以从 SUPPORTED_LOCALES 中移除任意语言以禁用它。

为不同用户渲染不同语言

你可以在通过 SDK 启动认证流程时指定一个语言。示例：

import { useAuth } from '@melody-auth/react'

function LoginButton() {
  const { loginRedirect } = useAuth()
  return (
    <button onClick={() => loginRedirect({ locale: 'de' })}>
      Login (DE)
    </button>
  )
}