SuperAPI AI 工具集

typo3-translations

写作与研究

查看项目

更新于 10-15 21:11

技能介绍

用途:指导 TYPO3 13 与 14 的翻译文件编写、格式选型、本地化键、ICU 字符串、LLL: 引用以及 v14 翻译域迁移。

主要能力:区分兼容模式——需同时支持 13+14 时保留 XLIFF 1.2 与完整 LLL:EXT: 引用;仅 v14 时可迁移到 XLIFF 2.0 并在 PHP 中使用翻译域。规范源语言文件(英文、无前缀,如 locallang.xlf 或 labels.xlf),目标语言以 locale 前缀并列存放(如 de.locallang.xlf、de_CH.locallang.xlf),不创建 en.locallang.xlf。每个 XLIFF 文件仅一个 <file>,每个目标文件仅一种目标语言;用 approved="yes"(1.2)或 state="reviewed"/"final"(2.0)标记已审校。ICU MessageFormat 仅限 TYPO3 14.2+,13 兼容代码不用 ICU。

使用方式:先盘点 Resources/Private/Language/.xlf 与 ContentBlocks/**/language/.xlf 及 PHP、TCA、YAML、Fluid、TypoScript、TSconfig 中的消费方,确定兼容模式,再规范化路径、文件名、XML 命名空间与键命名空间,添加或迁移标签,校验 XML、重复 ID、源/目标一致性与 LLL: 解析,最后清缓存并冒烟测试前后端语言上下文。v14 域由文件路径推导,如 locallang.xlf 对应 my_extension.messages,label.xlf 对应 my_extension.label;组合引用形如 my_extension.label:top。Fluid 可用 <f:translate domain="my_extension.label" key="top" /> 或 key="my_extension.label:top"。Content Blocks 标签位于 ContentBlocks/<Type>/<name>/language/labels.xlf,可用 vendor/bin/typo3 content-blocks:language:generate 生成或查看键。

限制:ICU 不可用于需在 TYPO3 13 原样运行的代码;不要因工具支持就迁移 XLIFF 方言;避免两个文件映射到同一域;不要自定义标签加载器,应使用 TYPO3 本地化 API 与 Fluid ViewHelper。详细示例与排错矩阵需查阅完整指南。