@atlassian/i18n 财产装入器

I18n 装入器 *.properties 在 Atlassian 服务器产品和插件中可以使用网络包装或rspack的文件.

动机

如果你在现代前端服务器代码上的工作 很有可能你已经在使用 阿特拉斯网络资源网络包插件。 。 。 . 如果您真的配置了您的网页软件包来使用开发服务器, 您可能会丢失显示正确的翻译短语 现在.

这个 @atlassian/i18n-properties-loader 可以帮助你解决这个问题。 这是一个网络包装装填器 允许你 在您的开发工作流程中显示翻译短语,同时使用WRM.

关于翻译系统的更多信息,请查看阿特拉斯发展文件页:

• 正在国际化您的插件

安装

npm install @atlassian/i18n-properties-loader --save-dev

用法实例

// webpack.config.js

const myI18nFiles = [
  'foo/i18n/my-translation-file.properties',
  'foo/bar/i18n/my-other-translation-file.properties',
  'bar/i18n/some-translation-file.properties',
];

module.exports = {
  module: {
    rules: [
      {
        test: /\.jsx?$/,
        include: ['src'],

        use: [
          {
            loader: '@atlassian/i18n-properties-loader',
            options: {
              i18nFiles: myI18nFiles,
            },
          },

          {
            loader: 'babel-loader',
          },
        ],
      },
    ],
  },
};

选项

• i18nFiles 路径列表 *.properties 文件( 需要)
• disabled 禁用装入器; 是否用于禁用生产捆绑( 可选, 默认) false(中文(简体) )

创建生产捆绑

装载机仅在开发模式下需要. 你应该记得,当您在生产捆绑时, 把它禁用.

用网络包装及其 mode 配置 您可以截取您网络包装配置中当前选择的模式, 并禁用装入器 :

// webpack.config.js

module.exports = (env, argv) => {
  const isDevelopmentMode = argv.mode === 'development'; // 1. Check if we are running webpack in "development" mode

  return {
    module: {
      rules: [
        {
          test: /\.jsx?$/,
          include: ['src'],

          use: [
            {
              loader: '@atlassian/i18n-properties-loader',
              options: {
                i18nFiles,
                disabled: !isDevelopmentMode, // 2. Skip and disable loader when webpack is running in "production" mode
              },
            },

            {
              loader: 'babel-loader',
            },
          ],
        },
      ],
    },
  };
};

反应 i18n 帮助器

这个套件很适合 @atlassian/wrm-react-i18n 当您想要使用时 I18n.getText() 带有 React 组件的翻译助手.

您可以检查软件包描述的更多细节,并学习如何将其与你的网络包配置相融合.

其他链接

• https://www.npmjs.com/package/@atlassian/i18n-properties-loader (英语)
• https://www.npmjs.com/package/@atlassian/wrm-react-i18n (英语)
• https://www.npmjs.com/package/atlassian-webresources-webpack-plugin (中文(简体) )

最低要求

此插件兼容 :

• 网包5,或 rspack 1 或 2
• 节点12+