# 自定义国际化资源

# 假设

假设网站根目录有一个 assets/ 文件夹,用于配置国际化资源。我们将该路径称为 websiteRoot/assets/

# 配置

  1. 将SDK包中的 lib/locales 文件夹拷贝到 websiteRoot/assets/

  2. 设置 i18n 路径来加载资源。

    new UIExtension.PDFUI({
        i18n: {
            absolutePath: 'websiteRoot/assets/locals'
        },
        // the other options...
    });
    
  3. 添加更多本地化语言。在 websiteRoot/assets/locales 目录下新建一个文件夹,该文件夹的命名需要遵守语言代码标准,比如,中文需要命名为zh-CN,俄语需要命名为ru-RU。

  4. websiteRoot/assets/locales/en-US 目录下的 "ui_.json" 文件拷贝到上一步骤中新建的文件夹中。翻译(本地化) "ui_.json" 文件中的所有条目。

  5. 设置默认语言。

    new UIExtension.PDFUI({
        i18n: {
            absolutePath: `websiteRoot/assets/locals`,
            lng: 'zh-CN'
        }// the other options
    })
    

# 在开发环境中验证配置

  1. 清除浏览器缓存以确保加载最新的 i18n 资源。

  2. 刷新浏览器,在 DevTools 中打开 Network 面板,检查 ui_.json 请求 url 是否指向您自定义的语言路径。如果是,则说明配置成功。