作为框架的核心组件之一,传承goframe
一贯的便捷化设计思想,I18N
国际化组件的配置管理非常简便。
文件格式
gi18n
国际化组件支持框架通用的五种配置文件格式:xml/ini/yaml/toml/json
(更详细的文件支持列表具体以配置管理章节为主:配置管理)。同样的,和配置管理模块一样,框架推荐使用toml
文件格式。
文件存储
默认情况下gi18n
会自动读取当前项目源码根目录(或者当前PWD
运行目录下)下的i18n
目录,默认将该目录作为国际化转译文件存储目录。开发者也可以通过SetPath
方法自定义i18n
文件的存储目录路径。在i18n
目录下可以直接按照国际化名称命名的文件如:en.toml
/ja.toml
/zh-CN.toml
;也可以给定国际化名称目录,目录下随意自定义配置文件,如:en/editor.toml
/en/user.toml
、zh-CN/editor.toml
/zh-CN/user.toml
。您使用纯文件管理或者增加一级目录管理都是可以的,gi18n
可以智能识别加载。
国际化的文件/目录名称都是开发者可自行定义和维护的,该名称主要用于程序中设置和使用。建议按照标准化的国际化地区语言码进行命名,具体请参考WIKI:https://zh.wikipedia.org/wiki/ISO_639-1
例如,以下的i18n
目录结构以及文件格式都是支持的:
├── i18n
│ ├── en.toml
│ ├── ja.toml
│ ├── ru.toml
│ ├── zh-CN.toml
│ └── zh-TW.toml
├── i18n-dir
│ ├── en
│ │ ├── hello.toml
│ │ └── world.toml
│ ├── ja
│ │ ├── hello.yaml
│ │ └── world.yaml
│ ├── ru
│ │ ├── hello.ini
│ │ └── world.ini
│ ├── zh-CN
│ │ ├── hello.json
│ │ └── world.json
│ └── zh-TW
│ ├── hello.xml
│ └── world.xml
└── i18n-file
├── en.toml
├── ja.yaml
├── ru.ini
├── zh-CN.json
└── zh-TW.xml
资源管理器
gi18n
默认支持资源管理器(详情请参考章节:资源管理),默认情况下会从gres
配置管理器中检索i18n
目录,或者开发者设置的i18n
目录路径。
Content Menu