如何在Django中高效管理超长翻译文本？

针对你遇到的超长文本（使用条款、用户指南等）与短文本混在同一po文件难以维护的问题，有几个实用方案可以解决：

1. 利用gettext命名空间（Domain）拆分po文件 #

Django的i18n支持自定义gettext domain，默认domain是django，我们可以为不同类型的超长文本创建独立domain，生成单独的po/mo文件：

• 模板中指定domain：
  对于超长文本块，使用domain参数指定自定义域：

  {% blocktrans domain="terms" %}
  这里是使用条款的超长内容...
  {% endblocktrans %}
  
  {% trans "用户指南标题" domain="guide" %}
  

• 生成对应domain的po文件：
  执行makemessages时指定domain参数，比如生成中文的使用条款po文件：

  django-admin makemessages -l zh_CN -d terms
  

  这会在locale/zh_CN/LC_MESSAGES/下生成terms.po，和默认的django.po完全分开。
• 编译domain文件：
  编译指定domain的po文件：

  django-admin compilemessages -d terms
  

• 视图中调用：
  如果需要在视图里使用该domain的翻译，直接指定domain参数：

  from django.utils.translation import ugettext_lazy as _
  
  terms_content = _("使用条款内容", domain="terms")
  

这个方案完全基于Django原生i18n机制，不需要额外依赖，完美拆分短/长文本的翻译文件。

2. 用独立配置文件存储超长文本 #

如果觉得po文件编辑大段文本仍不方便，可以将超长文本存在YAML/JSON等格式的独立文件中，通过自定义模板标签加载：

• 创建语言对应文件：
  在locale/zh_CN/下创建terms.yaml，写入翻译内容：

  title: "服务使用条款"
  content: |
    第一条：用户需遵守...
    第二条：版权声明...
  

• 编写自定义模板标签：
  创建一个模板标签，根据当前激活的语言加载对应文件：

  # templatetags/custom_i18n.py
  import yaml
  from django import template
  from django.conf import settings
  from django.utils.translation import get_language
  
  register = template.Library()
  
  @register.simple_tag
  def get_translated_doc(doc_name):
      lang = get_language()
      file_path = f"{settings.LOCALE_PATH}/{lang}/{doc_name}.yaml"
      with open(file_path, encoding="utf-8") as f:
          return yaml.safe_load(f)
  

• 模板中使用：

  {% load custom_i18n %}
  {% get_translated_doc "terms" as terms %}
  <h1>{{ terms.title }}</h1>
  <div>{{ terms.content|linebreaks }}</div>
  

这种方式适合不需要gettext翻译流程的大段静态文本，编辑起来更直观。

3. 用modeltranslation管理可编辑的超长文本 #

如果这些超长文本需要后台人员编辑（而非开发人员维护翻译文件），可以用django-modeltranslation插件实现多语言模型字段：

• 安装并配置modeltranslation：

  pip install django-modeltranslation
  

  在settings中添加modeltranslation到INSTALLED_APPS，然后配置TRANSLATION_LANGUAGES。
• 创建静态页面模型：

  # models.py
  from django.db import models
  from modeltranslation.translator import register, TranslationOptions
  
  class StaticPage(models.Model):
      slug = models.SlugField(unique=True)  # 用于标识页面，比如"terms"
      title = models.CharField(max_length=200)
      content = models.TextField()
  
  @register(StaticPage)
  class StaticPageTranslationOptions(TranslationOptions):
      fields = ('title', 'content')
  

• 后台编辑与模板调用：
  后台会自动生成各语言的title和content字段，直接编辑即可。模板中根据当前语言调用：

  {% load i18n %}
  {% get_current_language as LANG %}
  {% with page=static_page %}
      <h1>{{ page.title|getattr:LANG }}</h1>
      <div>{{ page.content|getattr:LANG|linebreaks }}</div>
  {% endwith %}
  

这个方案适合需要动态更新的超长文本，无需手动维护翻译文件。

内容的提问来源于stack exchange，提问作者ken