Django Translations 项目教程

经优英

于 2024-09-15 08:12:07 发布

阅读量1k

点赞数 22

本文链接：https://blog.csdn.net/gitblog_00500/article/details/142275050

版权

Django Translations 项目教程

django-translations Django model translation for perfectionists with deadlines. 项目地址: https://gitcode.com/gh_mirrors/dj/django-translations

1. 项目介绍

Django Translations 是一个为 Django 项目提供动态内容翻译解决方案的开源项目。它主要针对那些需要在数据库中存储内容并进行多语言翻译的开发者。Django 本身已经提供了静态内容的翻译功能，但对于动态内容（如存储在数据库中的内容），Django Translations 提供了一个专门的解决方案。

主要特点

动态内容翻译：支持数据库中存储的动态内容的翻译。
兼容性：目前不兼容 PostgreSQL。
易于集成：可以轻松集成到现有的 Django 项目中。

2. 项目快速启动

安装

首先，使用 pip 安装 Django Translations：

pip install django-translations

配置

在 Django 项目的 settings.py 文件中进行以下配置：

INSTALLED_APPS += [
    'translations',
]

USE_I18N = True  # 启用国际化
USE_L10N = True  # 启用本地化

MIDDLEWARE += [
    'django.middleware.locale.LocaleMiddleware',  # 添加本地化中间件
]

LANGUAGE_CODE = 'en-us'  # 默认语言

LANGUAGES = (
    ('en', 'English'),
    ('en-gb', 'English (Great Britain)'),
    ('de', 'German'),
    ('tr', 'Turkish'),
)

迁移

运行迁移命令以应用数据库更改：

python manage.py migrate

使用示例

模型定义

在需要翻译的模型中继承 Translatable：

from translations.models import Translatable

class Continent(Translatable):
    code = models.CharField(max_length=2)
    name = models.CharField(max_length=255)
    denonym = models.CharField(max_length=255)

    class TranslatableMeta:
        fields = ['name', 'denonym']

管理界面

在管理界面中使用翻译功能：

from translations.admin import TranslatableAdmin, TranslationInline

class ContinentAdmin(TranslatableAdmin):
    inlines = [TranslationInline]

查询集

使用查询集扩展进行翻译：

from sample.models import Continent

continents = Continent.objects.all().distinct().probe(['en', 'de']).filter(
    countries__cities__name__startswith='Köln'
).translate('de').translate_related('countries', 'countries__cities')

print(continents)
print(continents[0].countries.all())
print(continents[0].countries.all()[0].cities.all())