# Odoo i18n 技能 — 完整的国际化参考此技能提供了 Odoo 国际化 (i18n) 和本地化 (l10n) 方面的深厚专业知识。它涵盖提取可翻译字符串、验证 .po 文件、生成翻译报告以及处理 Odoo 版本 14 至 19 中的阿拉伯语/RTL 布局。 ** ** ## 1\. Odoo 翻译架构 ### 1.1 文件类型 Odoo 使用 GNU gettext 标准进行翻译：文件 |目的|地点 ---|---|--- `.pot` |可移植对象模板 — 包含所有源字符串的主模板 | `模块/i18n/module.pot` `.po` |可移植对象 — 特定语言的翻译字符串 | `模块/i18n/ar.po` `.mo` |机器对象 — 编译的二进制文件，从 .po 自动生成 |仅运行时缓存 ### 1.2 目录结构每个支持翻译的 Odoo 模块都必须有一个 `i18n/` 目录：我的模块/ ├── __manifest__.py ├── i18n/ │ ├── my_module.pot ← 模板（所有源字符串，无翻译） │ ├── ar.po ← 阿拉伯语翻译 │ ├── ar_SA.po ← 沙特阿拉伯语变体（可选） │ ├── fr.po ← 法语翻译 │ └── tr.po ← 土耳其语翻译 ├── 型号/ ├── 浏览量/ └── ... ### 1.3 .po 文件剖析 # my_module 的阿拉伯语翻译 # 版权所有 (C) 2024 TaqaTechno # 该文件是在与 my_module 包相同的许可证下分发的。 # 译者：Ahmed Al-Rashidi ，2024 # msgstr "" 消息字符串“” “项目 ID 版本：Odoo Server 17.0\n” “报告 Msgid-Bugs-至：\n” “POT-创建日期：2024-01-15 10:30+0300\n” “PO-修订日期：2024-01-20 14:00+0300\n” “最后一位翻译者：Ahmed Al-Rashidi \n” “语言团队：阿拉伯语\n” “语言：ar\n” “MIME 版本：1.0\n” “内容类型：文本/纯文本；字符集=UTF-8\n” “内容传输编码：8位\n” "复数形式: nplurals=6;plural=n==0 ? 0 : n==1 ? 1 : n==2 ? 2 : n%100>=3 && n%100<=10 ? 3 : n%100>=11 && n%100<=99 ? 4 : 5;\n" #.模块：我的模块 #: 型号:ir.model,名称:my_module.model_my_record msgstr "我的记录" msgstr "???" #.模块：我的模块 #: model_terms:ir.ui.view,arch_db:my_module.view_my_form msgstr "保存" msgstr "ЭЁи" #.模块：我的模块＃：代码：addons / my_module / models / my_model.py：45 #, python 格式 msgstr "未找到记录 %s" msgstr "??? %s ?????????” ### 1.4 Odoo 如何加载翻译 1. 在模块安装/更新时：Odoo 从 `i18n/` 目录读取 `.po` 文件 2. 在语言安装上：Odoo 在所有已安装的模块中加载该语言的所有“.po”文件 3.运行时：翻译被缓存在内存中并根据用户的“res.lang”应用 4. 对于网站：根据 URL 语言前缀（`/ar/`、`/en/`）或会话语言应用翻译 ### 1.5 翻译加载优先级 Odoo 按以下优先级顺序应用翻译（从高到低）： 1. 用户特定的覆盖（来自翻译菜单） 2.模块`.po`文件 3. 基础 Odoo 翻译 4. 源字符串（后备） ** ** ## 2\. Python 翻译 ### 2.1 基本导入和使用来自 odoo import _、api、字段、模型从 odoo.exceptions 导入 UserError、ValidationError 类 MyModel(models.Model): _name = '我的.model' _description = '我的模型' def action_validate(自我): 对于自我记录：如果不是rec.name： # 正确：将文字字符串包装在 _() 中 raise UserError(_('验证前需要输入名称。')) ### 2.2 字符串插值——关键规则 # 正确：外部变量替换 _() raise UserError(_('记录“%s”无法删除。') % record.name) raise UserError(_('发现 %d 条记录匹配条件。') % count) # 正确：命名格式说明符（为了清晰起见，首选） raise UserError(_('发票 %(number)s 处于状态 %(state)s。') % { 'number': 发票.名称, '状态'：发票.状态， }) # 正确：.format() 可以工作，但 % 在 Odoo 中是约定俗成的引发 UserError(_('你好 {}!').format(partner.name)) # 错误：f-strings 破坏了 i18n — 字符串在 _() 看到它之前就被求值了 raise UserError(_(f'Record {record.name} not found')) # 不要使用 # 错误：字符串连接破坏了 i18n raise UserError(_('记录') + record.name + _('未找到')) # 不要使用 # 错误：在 _() 之前构建字符串 - 翻译器永远看不到完整的上下文 msg = '未找到记录' raise UserError(_(msg)) # 技术上可行，但提取起来很困难 ### 2.3 使用 `_lt()` 进行惰性翻译对在类加载时而不是调用时定义的模块级字符串使用 _lt() ：从 odoo.tools.translate 导入 _lt 类 MyModel(models.Model): _name = '我的.model' # 正确：使用 _lt() 进行类级字符串定义状态 = fields.Selection([ ('草稿', _lt('草稿')), ('已确认', _lt('已确认')), ('已验证', _lt('已验证')), ('已取消', _lt('已取消')), ], string='状态', 默认='草稿') # 正确：类属性字符串 _description = 'My Model' # 这不需要 _() — 它不是面向最终用户的 # 错误：在类级别使用 _() 会导致问题，因为不存在请求上下文 # state = fields.Selection([('draft', _('Draft'))], ...) # 避免这种情况 ### 2.4 字段字符串属性字段“string”参数由 Odoo 自动翻译 - 不要将它们包装在“_()”中：类 MyModel(models.Model): _name = '我的.model' # 正确：string= 由 Odoo 的 i18n 系统自动翻译 name = fields.Char(string='名称', required=True) Partner_id = fields.Many2one('res.partner', string='客户') amount_total = fields.Float(string='总金额',digits=(16, 2)) # 帮助属性也是自动翻译的参考 = 字段.Char( 字符串='参考', help='用于跟踪目的的内部参考号。' ） ### 2.5 型号名称及说明类 MyModel(models.Model): _name = '我的.model' _description = '我的模型' # 自动翻译；不要用 _() 包裹起来 ### 2.6 Python 中的报告翻译 def _get_report_values（自我，docids，数据=无）： docs = self.env['my.model'].browse(docids) 返回{ 'doc_ids': docids, 'doc_model': '我的模型', “文档”：文档， 'report_title': _('月度销售报告'), } ### 2.7 电子邮件模板翻译在 Python 生成的电子邮件中，将字符串括在“_()”中。对于基于 XML 的模板，请使用 Odoo 翻译系统的“”。 def send_notification（自我）： subject = _('您的订单%(ref)s已确认') % {'ref': self.name} body = _('亲爱的%(name)s，您的订单已准备好。') % {'name': self.partner_id.name} self.message_post（主题=主题，正文=正文） ** ** ## 3\. XML / QWeb 翻译 ### 3.1 查看字段翻译通过“string”属性在视图中定义的字段标签可以自动翻译： <记录id =“view_my_model_form”模型=“ir.ui.view”> my.model.form my.model <字段名称=“拱形”类型=“xml”>

欢迎来到我们的网站

销售订单

我的意思是我的意思

欢迎

我们的产品

Odoo 国际化

包含技能