diff --git a/docs/src/guide/advanced/autoimport.md b/docs/src/guide/advanced/autoimport.md index 4e956e9..15f2c3c 100644 --- a/docs/src/guide/advanced/autoimport.md +++ b/docs/src/guide/advanced/autoimport.md @@ -6,7 +6,7 @@ import { t } from "./languages" ``` -由于默认情况下,`voerkai18 compile`命令会在当前工程的`/languages`文件夹下,这样我们为了导入`t`翻译函数不得不使用各种相对引用,这即容易出错,又不美观,如下: +由于默认情况下,`t`函数位于当前工程的`/languages`文件夹下,这样我们为了导入`t`翻译函数不得不使用各种相对引用,这即容易出错,又不美观,如下: ```javascript | pure import { t } from "./languages" @@ -17,9 +17,9 @@ import { t } from "../../../languages" 作为国际化解决方案,一般工程的大部份源码中均会使用到翻译函数,这种使用体验比较差。 -为此,我们提供了几个插件可以来自动完成翻译函数的自动导入,包括: +为此,我们提供了插件可以来自动完成翻译函数的自动导入,包括: -- `babel`插件 -- `vite`插件 +- (`babel`插件)[../tools/babel] +- (`vite`插件)[../tools/vite] 当启用了`babel/vite`插件后,就会在编译时自动导入`t`函数。关于插件如何使用请参阅文档。 diff --git a/docs/src/guide/advanced/textMap.md b/docs/src/guide/advanced/textMap.md index 80d79f1..3221157 100644 --- a/docs/src/guide/advanced/textMap.md +++ b/docs/src/guide/advanced/textMap.md @@ -20,7 +20,7 @@ ```javascript | pure //idMap.js { - "1":"中华人民共和国万岁" + "中华人民共和国万岁":"1" } // en.js { @@ -32,13 +32,13 @@ } ``` -如此,就消除了在`en.js`、`jp.js`文件中的冗余。但是在源代码文件中还存在`t("中华人民共和国万岁")`,整个运行环境中存在两份副本,一份在源代码文件中,一份在`idMap.js`中。 +如此,就消除了在`en.js`、`jp.js`文件中的冗余。但是在源代码文件中还存在`t("中华人民共和国万岁")`,整个运行环境中存在两份副本,一份在`源代码`文件中,一份在`idMap.js`中。 -为了进一步减少重复内容,因此,我们需要将源代码文件中的`t("中华人民共和国万岁")`更改为`t("1")`,这样就能确保无重复冗余。但是,很显然,我们不可能手动来更改源代码文件,这就需要由`voerkai18n`提供的一个编译期插件来做这一件事了。 +为了进一步减少冗余内容,因此,我们需要将源代码文件中的`t("中华人民共和国万岁")`更改为`t("1")`,这样就能确保无重复冗余。但是,很显然,我们不可能手动来更改源代码文件,这就需要由`voerkai18n`提供的一个编译期插件来做这一件事了。 -以`babel-plugin-voerkai18n`插件为例,该插件同时还完成一份任务,就是自动读取`voerkai18n compile`生成的`idMap.js`文件,然后将`t("中华人民共和国万岁")`自动更改为`t("1")`,这样就完全消除了重复冗余信息。 +以`babel-plugin-voerkai18n`插件为例,该插件同时还完成一项任务,就是自动读取`voerkai18n compile`生成的`idMap.js`文件,然后将`t("中华人民共和国万岁")`自动更改为`t("1")`,这样就完全消除了重复冗余信息。 -所以,在最终形成的代码中,实际上每一个t函数均是`t("1")`、`t("2")`、`t("3")`、`...`、`t("n")`的形式,最终代码还是采用了用`key`来进行转换,只不过这个过程是自动完成的而已。 +所以,在最终形成编译后的代码中,实际上每一个t函数均是`t("1")`、`t("2")`、`t("3")`、`...`、`t("n")`的形式,最终代码还是采用了用`key`来进行转换,只不过这个过程是自动完成的而已。 **注意:** diff --git a/docs/src/guide/intro/versions.md b/docs/src/guide/intro/versions.md index 04c3fcf..9ca3b9d 100644 --- a/docs/src/guide/intro/versions.md +++ b/docs/src/guide/intro/versions.md @@ -2,7 +2,7 @@ | 包| 版本号| 最后更新|说明| | --- | :---:| --- |---| |**@voerkai18n/utils**|1.0.12|2022/08/05|公共工具库 -|**@voerkai18n/runtime**|1.0.28|2022/08/07|核心运行时 +|**@voerkai18n/runtime**|1.0.29|2022/08/16|核心运行时 |**@voerkai18n/formatters**|1.0.6|2022/04/15|格式化器,提供对要翻译文本的转换功能 |**@voerkai18n/react**|1.0.4|2022/04/16|React支持,提供语言切换等功能 |**@voerkai18n/cli**|1.0.33|2022/08/07|命令行工具,用来初始化/提取/编译/自动翻译等工具链 diff --git a/docs/src/guide/tools/vue.md b/docs/src/guide/tools/vue.md index d21185f..51cd700 100644 --- a/docs/src/guide/tools/vue.md +++ b/docs/src/guide/tools/vue.md @@ -55,7 +55,7 @@ this.i18n = { 注入`i18n`实例后就可以在此基础上实现`激活语言`、`默认语言`、`切换语言`等功能。 -```vue +```javascript | pure