TYPO3中XLF文件文本片段键命名规范及自定义方案问询

背景 #

• 目前未发现TYPO3官方针对XLF文件文本片段键的统一命名规范，计划采用点标记法自定义键规则
• 核心要求：
  • 键需覆盖三个核心维度：文本功能、代码位置、内容核心含义
  • 仅在wrap场景下，可选择性添加两个标记：
    • 文本中变量占位符（如%1$s）的数量
    • 文本片段包含HTML标签的提示标记

当前试用的命名模式 #

试用的键结构为：func.location.LocationSpec.[LocationSpec2].content.[Count].[h]，各部分含义如下：

• func：文本功能类型，比如title（标题）、label（表单标签）、button（按钮文本）、error（错误提示）等
• location：代码位置标识，比如tca（TCA配置文件）、flex（Flexform配置）、ctrl（控制器）、view（前端视图模板）等
• LocationSpec：具体位置的通用标识，比如控制器名、数据表名、模板文件名等
• LocationSpec2：可选的细粒度位置描述，比如TCA中的字段分组、视图中的具体区块名
• content：文本内容的核心关键词，比如save对应“保存”、delete对应“删除”、required对应“必填”
• Count：wrap场景下，文本中变量占位符的数量（如2代表包含%1$s和%2$s两个变量）
• h：wrap场景下的可选标记，表明文本片段包含HTML标签

待确认的问题 #

1. 上述需求是否遗漏重要维度？比如文本的适用场景（前端/后端）、多语言特殊标识等？
2. 是否存在更简洁且满足需求的通用命名规范？

实用优化建议 #

• 简化层级：如果觉得当前模式过于复杂，可将LocationSpec2合并到LocationSpec中，用下划线连接（如tca.sys_news.basic_fields.save.label），减少点分隔的层级
• 参考核心扩展习惯：TYPO3核心扩展常用精简结构，比如tca.[tableName].[fieldName].label、module.[moduleName].[actionName].title，逻辑偏向“位置+核心标识+功能”
• 统一标记后缀：将变量数量和HTML标记改为后缀式，比如用_2_h表示含2个变量且带HTML，结构简化为func.location.spec.content_2_h

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