Python-i18n 使用教程

Python-i18n 使用教程

python-i18nEasy to use i18n library for Python项目地址:https://gitcode.com/gh_mirrors/py/python-i18n

项目介绍

Python-i18n 是一个为 Python 3 提供的国际化（i18n）功能库。该库的设计灵感来源于 Rails i18n 库，旨在为 Python 开发者提供简单易用的国际化支持。通过 Python-i18n，开发者可以轻松地管理应用程序的多语言翻译。

项目快速启动

安装

首先，使用 pip 安装 Python-i18n：

pip install python-i18n

如果需要使用 YAML 格式存储翻译文件，可以安装带有 YAML 支持的版本：

pip install python-i18n[YAML]

基本使用

以下是一个简单的示例，展示如何使用 Python-i18n 进行基本的翻译：

import i18n

# 添加翻译
i18n.add_translation('hello', '你好')

# 获取翻译
print(i18n.t('hello'))  # 输出: 你好

使用翻译文件

支持 YAML 和 JSON 格式的翻译文件。以下是一个 JSON 格式的翻译文件示例：

{
  "hello": "你好",
  "welcome": "欢迎使用 Python-i18n"
}

在代码中加载并使用该翻译文件：

import i18n

# 设置翻译文件路径
i18n.load_path.append('./translations')

# 设置默认语言
i18n.set('locale', 'zh')

# 获取翻译
print(i18n.t('hello'))  # 输出: 你好
print(i18n.t('welcome'))  # 输出: 欢迎使用 Python-i18n

应用案例和最佳实践

多语言支持

假设我们有一个多语言的网站，需要支持中文和英文。我们可以创建两个翻译文件 en.json 和 zh.json，并在代码中根据用户选择的语言加载相应的翻译文件。

import i18n

# 设置翻译文件路径
i18n.load_path.append('./translations')

# 设置默认语言
i18n.set('locale', 'zh')

# 获取翻译
print(i18n.t('hello'))  # 输出: 你好

# 切换语言
i18n.set('locale', 'en')
print(i18n.t('hello'))  # 输出: Hello

动态翻译

在某些情况下，我们需要根据变量动态生成翻译内容。例如，显示用户的消息数量：

import i18n

# 添加动态翻译
i18n.add_translation('mail_number', {
    'zero': 'You do not have any mail',
    'one': 'You have a new mail',
    'few': 'You only have %{count} mails',
    'many': 'You have %{count} new mails'
})

# 获取动态翻译
print(i18n.t('mail_number', count=0))  # 输出: You do not have any mail
print(i18n.t('mail_number', count=1))  # 输出: You have a new mail
print(i18n.t('mail_number', count=3))  # 输出: You only have 3 mails
print(i18n.t('mail_number', count=12))  # 输出: You have 12 new mails

典型生态项目

Python-i18n 可以与其他 Python 生态项目结合使用，例如 Flask 和 Django。以下是一个在 Flask 应用中使用 Python-i18n 的示例：

Flask 集成

from flask import Flask, request, render_template
import i18n

app = Flask(__name__)

# 设置翻译文件路径
i18n.load_path.append('./translations')

@app.route('/')
def index():
    # 根据用户选择的语言设置 locale
    locale = request.args.get('locale', 'zh')
    i18n.set('locale', locale)
    
   

python-i18nEasy to use i18n library for Python项目地址:https://gitcode.com/gh_mirrors/py/python-i18n