@gravity-ui/i18n-babel-插图
优化翻译文件交付的 Babel 插件 .
如果你没有用贝布尔,那么 i18n-优化-插件 适合你吗.
变换 i18n.ts 文件 :
- 从信件中删除元( id, 描述等)
- 将下标记转换为 html( 当
meta.markdown === true(中文(简体) ) - 对关键内容应用打字规则
东都:
- 根据 ICU 信件格式验证语法
- 编译 ICU 信件格式到 AST
- 将原始密钥替换为散列( 允许缩短密钥长度)
使用量
安装插件 :
npm install @gravity-ui/i18n-babel-plugin --save-dev
连接插件到构建中 。 实例,如果你在使用 app-builder数字 :
import {defineConfig} from '@gravity-ui/app-builder';
export default defineConfig({
client: {
babel: (config) => {
const plugins = config.plugins ? [...config.plugins] : [];
return {
...config,
plugins: [
...plugins,
require.resolve('@gravity-ui/i18n-babel-plugin')
],
};
}
}
});
设置
错误
允许配置 类型规则。 。 。 .
默认使用 DEFAULT_TYPOGRAF_CONFIG 规则.
自定义打字规则的例子:
plugins: [
require.resolve('@gravity-ui/i18n-babel-plugin', {
typograf: {
enabled: ['common/nbsp/afterNumber', 'common/nbsp/afterParagraphMark'],
disabled: ['common/symbols/cf', 'common/space/trimRight', 'common/space/trimLeft'],
}
})
],
无法使用的打字机示例 :
plugins: [
require.resolve('@gravity-ui/i18n-babel-plugin', {
typograf: false,
})
],
根号
允许限制插件的范围 。 插件不会处理超出指定范围的文件 .
类型 : string。 。 。 .
默认 : src。 。 。 .
文件名Matcher
允许使用自定义名称处理翻译文件 .
类型 : FilenameMatcher | FilenameMatcher[]时 FilenameMatcher 为:
string—— 与文件路径的结尾相比, 所以i18n.ts匹配两者Component/i18n.ts财务报告和审定财务报表Component/component.i18n.ts· ;RegExp——按常态化路径进行考核(\→/(三);{type: 'regexp', pattern: string, flags?: string}以可序列形式(用于.babelrc/ JSON 配置词.
默认 : 'i18n.ts'。 。 。 .
带有自定义文件名的示例 :
plugins: [
require.resolve('@gravity-ui/i18n-babel-plugin', {
filenameMatcher: ['i18n.ts', 'keysets.ts'],
})
],
带有正则表达式的示例( 匹配) Component/component.translations.ts 财务报告和审定财务报表 Component/component.translations.tsx:
plugins: [
require.resolve('@gravity-ui/i18n-babel-plugin', {
filenameMatcher: /\.translations\.tsx?$/,
})
],
同样的正则表达式 .babelrc数字 :
{
"plugins": [
["@gravity-ui/i18n-babel-plugin", {
"filenameMatcher": {"type": "regexp", "pattern": "\\.translations\\.tsx?$"}
}]
]
}
注意 root 限制仍然适用: 外部的文件 root 即使匹配, 也不会处理 filenameMatcher。 。 。 .