翻译模块-IT外包|网络维护 - 宜兴IT外包服务

首页/
文章/
ODOO16在线文档/
翻译模块

文章详情

翻译模块

上传者： Administrator
上传时间：2023年12月06日 08时37分36秒

摘要：
本节将介绍如何为您的模块提供翻译功能。注解如果您想为Odoo本身的翻译做出贡献，请参考 Odoo Wiki页面 [1] 。导出可翻译术语 None [2] ** 你的模块中有许多术语是“隐式可翻译的”，因此，即使你没有进行任何特定的翻译工作，你也可以导出你的模块可翻译的术语，并找到需要处理的 ......

正文 相关文章 请喝咖啡

本节将介绍如何为您的模块提供翻译功能。

注解

如果您想为Odoo本身的翻译做出贡献，请参考 Odoo Wiki页面。

导出可翻译术语

你的模块中有许多术语是“隐式可翻译的”，因此，即使你没有进行任何特定的翻译工作，你也可以导出你的模块可翻译的术语，并找到需要处理的内容。

通过登录后台界面并打开设置 ‣ 翻译 ‣ 导入/导出 ‣ 导出翻译，可以通过管理界面执行翻译导出操作。

将语言保留为默认值（新语言/空模板）
选择 PO 文件格式
选择您的模块
点击导出并下载文件

这将给你一个名为 yourmodule.pot 的文件，应该移动到 yourmodule/i18n/ 目录中。该文件是一个 PO 模板，简单地列出可翻译的字符串，可以从中创建实际的翻译文件（PO 文件）。可以使用 msginit 创建 PO 文件，也可以使用专用的翻译工具如 POEdit，或者简单地将模板复制到一个名为 language.po 的新文件中。翻译文件应该放在 yourmodule/i18n/ 目录中，与 yourmodule.pot 并列，并且在对应的语言被安装时，Odoo 会自动加载它们（通过设置 ‣ 翻译 ‣ 语言）

注解

在安装或更新模块时，所有已加载语言的翻译也会被安装或更新。

隐式导出

Odoo会自动从“data”类型的内容中导出可翻译的字符串：

在非 QWeb 视图中，所有文本节点都会被导出，以及 string 、 help 、 sum 、 confirm 和 placeholder 属性的内容
QWeb模板（包括服务器端和客户端），所有文本节点都会被导出，除非在 t-translation="off" 块内， title 、 alt 、 label 和 placeholder 属性的内容也会被导出
对于 Field，除非它们的模型被标记为 _translate = False：
- 它们的 string 和 help 属性被导出
- 如果 selection 存在且为列表（或元组），则导出
- 如果它们的 translate 属性设置为 True，则会导出它们所有现有的值（在所有记录中）
help/error messages of _constraints and _sql_constraints are exported

显式导出

当涉及到Python代码或JavaScript代码中的更”命令式”的情况时，Odoo无法自动导出可翻译的术语，因此必须明确标记以进行导出。这可以通过将文字字符串包装在函数调用中来完成。

在Python中，包装函数是 odoo._():

title = _("Bank Accounts")

在JavaScript中，包装函数通常是 odoo.web._t()：

title = _t("Bank Accounts");

警告

只有字面字符串可以被标记为导出项，不能是表达式或变量。对于需要格式化的字符串，需要标记格式化字符串而不是格式化后的字符串。

懒惰版本的 _ 和 _t 是 odoo._lt() 在 python 中和 odoo.web._lt() 在 javascript 中。翻译查找只在渲染时执行，可以用于在类方法或全局变量中声明可翻译的属性。

注解

模块的翻译默认情况下不会被暴露给前端，因此无法从JavaScript中访问。为了实现这一点，模块名称必须以 website 为前缀（就像 website_sale ， website_event 等一样），或者通过在 ir.http 模型中实现 _get_translation_frontend_modules_name() 进行显式注册。

这可能看起来像下面这样:

from odoo import models

class IrHttp(models.AbstractModel):
    _inherit = 'ir.http'

    @classmethod
    def _get_translation_frontend_modules_name(cls):
        modules = super()._get_translation_frontend_modules_name()
        return modules + ['your_module']

变量

不要提取可能有效，但它不会正确翻译文本：

_("Scheduled meeting with %s" % invitee.name)

**请**将动态变量设置为翻译查找的参数 (如果翻译中缺少占位符，将会回退到源文本):

_("Scheduled meeting with %s", invitee.name)

块

**不要**将您的翻译分成多个块或多行:

# bad, trailing spaces, blocks out of context
_("You have ") + len(invoices) + _(" invoices waiting")
_t("You have ") + invoices.length + _t(" invoices waiting");

# bad, multiple small translations
_("Reference of the document that generated ") + \
_("this sales order request.")

**请**保持在一个块中，为翻译者提供完整的上下文:

# good, allow to change position of the number in the translation
_("You have %s invoices wainting") % len(invoices)
_.str.sprintf(_t("You have %s invoices wainting"), invoices.length);

# good, full sentence is understandable
_("Reference of the document that generated " + \
  "this sales order request.")

复数

**不要**按照英语的方式复数化术语：

msg = _("You have %(count)s invoice", count=invoice_count)
if invoice_count > 1:
  msg += _("s")

**请**记住每种语言都有不同的复数形式：

if invoice_count > 1:
  msg = _("You have %(count)s invoices", count=invoice_count)
else:
  msg = _("You have one invoice")

读取时间 vs 运行时间

**不要**在服务器启动时调用翻译查找:

ERROR_MESSAGE = {
  # bad, evaluated at server launch with no user language
  'access_error': _('Access Error'),
  'missing_error': _('Missing Record'),
}

class Record(models.Model):

  def _raise_error(self, code):
    raise UserError(ERROR_MESSAGE[code])

**不要**在读取javascript文件时调用翻译查找:

# bad, js _t is evaluated too early
var core = require('web.core');
var _t = core._t;
var map_title = {
    access_error: _t('Access Error'),
    missing_error: _t('Missing Record'),
};

**请**使用延迟翻译查找方法:

ERROR_MESSAGE = {
  'access_error': _lt('Access Error'),
  'missing_error': _lt('Missing Record'),
}

class Record(models.Model):

  def _raise_error(self, code):
    # translation lookup executed at error rendering
    raise UserError(ERROR_MESSAGE[code])

或者动态地评估可翻译的内容：

# good, evaluated at run time
def _get_error_message(self):
  return {
    access_error: _('Access Error'),
    missing_error: _('Missing Record'),
  }

在 JS 文件读取时进行翻译查找的情况下，使用 _lt 而不是 _t 来翻译术语在其使用时:

# good, js _lt is evaluated lazily
var core = require('web.core');
var _lt = core._lt;
var map_title = {
    access_error: _lt('Access Error'),
    missing_error: _lt('Missing Record'),
};

本文章从网上收集，如有侵权请联系tderp@tderp.com删除

微信扫一扫，一分也是爱:

服务原则及地区范围

宜兴通达网络科技有限公司，地处中国宜兴环科园内，是一家高新技术企业。公司在企业网络维护和企业信息化建设与咨询方面，有10多年经验。

我公司愿与客户一道，力求彻底解决客户问题！
我们不是在给企业提供“头痛医头、脚痛医脚”的暂时解决方案，而是在部署根本性安全与稳定服务！！
我们愿携手客户，建立企业IT规划；杜绝随意安装系统、软件等操作；力求共同维护有序、安全、稳定的网络办公环境！！！
IT服务，服务是根本，客户是上帝；我们提供快速响应、快速上门、快速排查，提供优质高效的服务！！！！

通达科技提供全国范围内的服务，服务形式包括远程协助、电话咨询、电子邮件咨询、传真咨询、问答平台的问题解决等。

宜兴地区提供上门服务：

市区服务：宜城街道、城北街道（屺亭街道）、新街街道、新庄街道、环科园、渚桥开发区
市郊服务：张渚镇、西渚镇、太华镇、徐舍镇、官林镇、杨巷镇、新建镇、和桥镇、高塍镇、万石镇、周铁镇、芳桥镇、丁蜀镇、湖父镇。

联系电话：189-21-343434
在线沟通：

通达科技 - 宜兴电脑维护及IT服务外包服务商

导出可翻译术语

隐式导出

显式导出

变量

块

复数

读取时间 vs 运行时间

服务原则及地区范围

下一步你可以