ngx-translate-extract 项目常见问题解决方案

ngx-translate-extract 项目常见问题解决方案

ngx-translate-extract Extract translatable (using ngx-translate) strings and save as a JSON or Gettext pot file 项目地址: https://gitcode.com/gh_mirrors/ng/ngx-translate-extract

项目基础介绍

ngx-translate-extract 是一个用于 Angular 项目的开源工具，主要用于提取可翻译的字符串并将其保存为 JSON 或 Gettext pot 文件。该项目的主要编程语言是 TypeScript，适用于 Angular 应用程序的国际化（i18n）需求。

新手使用注意事项及解决方案

1. 安装和配置问题

问题描述：新手在安装和配置 ngx-translate-extract 时，可能会遇到依赖项安装失败或配置文件错误的问题。

解决步骤：

1. 检查依赖项：确保项目中已经安装了 @angular/core 和 @ngx-translate/core 等必要的依赖项。
2. 正确配置 package.json：在 package.json 中添加以下脚本：

   "scripts": {
     "i18n:init": "ngx-translate-extract --input ./src --output ./src/assets/i18n/template.json --key-as-default-value --replace --format json",
     "i18n:extract": "ngx-translate-extract --input ./src --output ./src/assets/i18n/[en,da,de,fi,nb,nl,sv].json --clean --format json"
   }
   

3. 运行脚本：使用 npm run i18n:extract 命令来提取字符串。

2. 提取字符串不完整

问题描述：在提取字符串时，可能会发现某些字符串没有被正确提取。

解决步骤：

1. 检查标记函数：确保所有需要翻译的字符串都被正确标记。可以使用 marker 函数来标记需要提取的字符串：

   import { marker } from '@biesbjerg/ngx-translate-extract-marker';
   marker('Extract me');
   

2. 多目录提取：如果项目中有多个源代码目录，确保在提取时包含了所有目录：

   ngx-translate-extract --input ./src-a ./src-b --output ./src/assets/i18n/strings.json
   

3. 路径扩展：使用路径扩展来保存多个文件：

   ngx-translate-extract --input ./src --output ./src/i18n/[da,en].json
   

3. JSON 格式问题

问题描述：提取的字符串在保存为 JSON 文件时，可能会出现格式问题，如缩进不一致。

解决步骤：

1. 指定缩进格式：在提取时指定 JSON 文件的缩进格式，例如使用空格缩进：

   ngx-translate-extract --input ./src --output ./src/i18n/en.json --format-indentation ' '
   

2. 检查输出文件：确保输出文件的格式正确，可以使用 JSON 格式化工具进行检查和修正。

通过以上步骤，新手可以更好地使用 ngx-translate-extract 项目，解决常见的问题，提高开发效率。

ngx-translate-extract Extract translatable (using ngx-translate) strings and save as a JSON or Gettext pot file 项目地址: https://gitcode.com/gh_mirrors/ng/ngx-translate-extract