Joomla! 编码规范
INI
关于
编码规范
客户端语法风格指南
附录
.ini 语言文件格式
一个 .ini 文件由字符串和注释组成。请参阅 语言文件规范。
格式
注释
有两种类型的注释
- 用作节的注释,以阐明一组字符串的用途。
- 用于通知翻译人员下方字符串的一些特征的注释。这些注释前面不应有空行。
字符串
- 所有语言字符串均为英国英语 (en-GB)。请参阅 Joomla! en-GB 用户界面文本指南
- 带注释的行应以分号开头。
- 字符串应使用“标准字母顺序”而不是“ASCII 顺序”按字母顺序排列。这里主要意味着下划线在字母之前排序。
示例
COM_ABCD_FORMAT_WHATEVER
在之前
COM_ABCD_FORMATTING_WHATEVER
某些特定的文本编辑器仅按“ASCII 顺序”排序,不应使用。
插件
某些 IDE 具有用于按“标准字母顺序”对行进行排序的特定插件。
示例
可能需要将排序设置为“不区分大小写的排序”才能获得正确的结果。
在线工具
还有一个在线工具可以按这种方式排序(以及其他功能): https://wordcounter.net/alphabetize
备注
当文件包含注释部分时,字符串应在每个部分中按字母顺序排列。
警告:当注释涉及特定字符串并且排序已修改顺序时,应将注释移动到正确的位置。