New Crowdin translations by GitHub Action (#170)

Co-authored-by: Crowdin Bot <[email protected]>

Author: github-actions[bot]

src/i18n/en-US/docusaurus-plugin-content-docs/current/compile/index.md

@@ -1,18 +1,25 @@
 ---
-title: 11. 编译模板 API速查表
+title: 包说明
 ---
 
 <br/>
 
-|         类名         |            作用           |   Namespaces   |     操作类型    |
-| :----------------: | :---------------------: | :------------: | :---------: |
-|      NAssembly     |  快速创建同程序集的 oop 及委托等操作类  |       全局       | 静态初始化,动态实例化 |
-|      NInstance     |    根据类型，提供一个初始化实例的委托    |       全局       |      静态     |
-|      NDelegate     | 快速创建指定域的 Action/Func 委托 |       全局       | 静态初始化,动态实例化 |
-|       NClass       |        快速创建一个公有类        |       全局       | 静态初始化,动态实例化 |
-|     NInterface     |        快速创建一个公有接口       |       全局       | 静态初始化,动态实例化 |
-|        NEnum       |        快速创建一个枚举类        |       全局       | 静态初始化,动态实例化 |
-|       NRecord      |        快速创建一个记录类        |       全局       | 静态初始化,动态实例化 |
-|       NStruct      |        快速创建一个结构体        |       全局       | 静态初始化,动态实例化 |
-| FakeMethodOperator |    仿造 MethodInfo 创建方法   | Natasha.CSharp | 静态初始化,动态实例化 |
-| FastMethodOperator |          快速创建方法         | Natasha.CSharp | 静态初始化,动态实例化 |
+### 域实现包
+
+`DotNetCore.Natasha.DynamicLoad.Base` 包为编译单元与域的粘合接口包，自定义实现域并给 Natasha 编译单元用。
+
+`DotNetCore.Natasha.Domain` Natasha 官方的 Core3.0+ 域操作包。
+
+`Natasha.CSharp.Compiler.Domain` 继承自 `DotNetCore.Natasha.Domain` 并实现了 `DotNetCore.Natasha.DynamicLoad.Base` 编译粘合接口包。
+
+## 编译单元包
+
+`DotNetCore.Natasha.CSharp.Compiler` Natasha 基础编译单元包。
+
+### 扩展包
+
+`DotNetCore.Natasha.CSharp.Template.Core` 在编译单元基础上构建的模板编译包。
+
+`DotNetCore.Natasha.CSharp.Extension.Ambiguity` 在编译单元基础上扩展的解决二义性引用的包。
+
+`DotNetCore.Natasha.CSharp.Extension.Codecov` 在编译单元基础上扩展的统计动态程序集使用率的包。

src/i18n/en-US/docusaurus-plugin-content-docs/current/template/001-static-init.md

@@ -0,0 +1,40 @@
+---
+title: 1. 模板初始化操作
+---
+
+Natasha 的所有模板均继承自 ComplierTemplate ，ComplierTemplate 本身会提供静态构造方法。因此上层 API 也会被支持。Therefore, the upper-level API is also supported.因此上层 API 也会被支持。
+
+<br/>
+
+## 使用
+
+NDelegate / NAssembly / NClass.. / xxx_Oerator 等等以下称为 “Handler”.
+
+<br/>
+
+#### 静态初始化代码：
+
+```cs
+
+//使用 domain 域
+Handler.UseDomain(domian, compiler => { 编译器配置 });
+
+
+//使用某编译器的域
+Handler.UseCompiler(assemblyCSharpCompiler, compiler => { 编译器配置 }));
+
+
+//创建一个 "domainJim" 域
+Handler.CreateDomain("domianJim", compiler => { 编译器配置 });
+
+
+//使用默认域
+Handler.DefaultDomain(compiler => { 编译器配置 });
+
+
+//使用随机域
+Handler.RandomDomain(compiler => { 编译器配置 });
+
+```
+
+<br/>

src/i18n/en-US/docusaurus-plugin-content-docs/current/template/002-api-samples.md

@@ -0,0 +1,163 @@
+---
+title: 2. 模板 API 用法展示(未更新)
+---
+
+- **引入**
+
+NUGET `DotNetCore.Natasha.CSharp`
+预热:
+
+```C#
+NatashaInitializer.Preheating();
+```
+
+- **NDelegate**
+
+```cs
+//NDelegate 支持：
+
+// 普通方法：      Func/Action
+// 异步方法：      Async Func/Action
+// 非安全方法：    Unsafe Func/Action
+// 非安全异步方法： UnsafeAsync Func/Action
+
+var func = NDelegate
+  //创建域
+  .CreateDomain("NDomain2")    
+  //在域中创建 Func<string,int> 方法, 参数与系统定义的 Func<T1,T> 参数名一样.
+  .Func<string,int>("return arg.Length;"); 
+
+Assert.Equal(3, func("abc"));
+//卸载
+DomainManagement.Remove("NDomain2");
+```
+
+Or
+
+```cs
+//或者
+var func = NDelegate
+    //使用随机域
+    .RandomDomain()
+    //忽略第一个参数调用实例
+    .WithFirstArgInvisible()
+    //在域中创建 Func<string,int> 方法, 参数与系统定义的 Func<T1,T> 参数名一样.
+    .Func<string,int>("return Length;"); 
+
+Assert.Equal(3, func("abc"));
+//卸载
+func.DisposeDomain();
+```
+
+```cs
+NormalTestModel model = new NormalTestModel();
+var func = NDelegate
+  .CreateDomain("NDomain6")
+  .Action<NormalTestModel, int, int>("arg1.Age=arg2+arg3;");
+func(model,1,2);
+Assert.Equal(3, model.Age);
+```
+
+案例2：
+
+```cs
+var action = NDelegate
+  .DefaultDomain()
+  .UnsafeAsyncFunc<string, string, Task<string>>(@"
+      string result = arg1 +"" ""+ arg2;
+      await Task.Delay(1000);
+      Console.WriteLine(result);
+      return result;");
+
+string result = await action("Hello", "World1!");
+//result = "Hello World1!"
+```
+
+<br/>
+
+<br/>
+
+#### FastMethodOperator
+
+  <br/>
+
+- 普通定制
+
+> 快速定制一个方法
+
+```cs
+var action = FastMethodOperator.DefaultDomain()
+             .Param<string>("str1")
+             .Param(typeof(string),"str2")
+             .Body("return str1+str2;")
+             .Return<string>()
+             .Complie<Func<string,string,string>>();
+
+var result = action("Hello ","World!");    //result:   "Hello World!"
+```
+
+<br/>
+
+```cs
+var delegateAction = FastMethodOperator.Random()
+
+       .Async()
+       //如果不指定Param 和 Return 则默认使用 Func<string,string,Task<string>> 系统定义的参数名, F12 可看
+       .Body(@"
+               await Task.Delay(100);
+               string result = arg1 +"" ""+ arg2;
+               Console.WriteLine(result);
+               return result;")
+
+       .Complie<Func<string, string, Task<string>>>();
+
+string result = await delegateAction?.Invoke("Hello", "World2!");   //result:   "Hello World2!"
+```
+
+<br/>
+<br/>
+
+#### DelegateOperator
+
+> 快速快速实现委托
+
+```cs
+
+//定义一个委托
+public delegate string GetterDelegate(int value);
+
+//方法一
+var action = NDelegate.RandomDomain().Delegate<GetterDelegate>("value += 101; return value.ToString();");
+string result = action(1);
+//result: "102"
+```
+
+<br/>
+<br/>
+
+#### FakeMethodOperator
+
+> 快速复制方法并实现
+
+```cs
+public class Test
+{
+   public string Handler(string str)
+   {
+        return null;
+   }
+}
+```
+
+```cs
+var action = FakeMethodOperator.RandomDomain()
+             .UseMethod(typeof(Test).GetMethod("Handler"))
+             .StaticMethodContent(" str += \"hello\";return str; ")
+             .Complie<Func<string,string>>();
+
+string result = action("xiao");
+//result: "hello"              
+```
+
+<br/>
+<br/>

src/i18n/en-US/docusaurus-plugin-content-docs/current/template/004-development-specification.md

@@ -0,0 +1,64 @@
+---
+title: 4. 建议的封装规范
+---
+
+## Natasha 封装规约
+
+Natasha 有自己的封装规则，这可以让封装者思路更加清晰，并让作品更加容易维护。
+
+<br/>
+
+## 一个完整的 Operator
+
+Operator 作为动态构建对外使用的操作类，一个 Operator 可大致由以下 3 部分组成：
+
+- Template
+- Builder
+- Package / Extension
+
+Template + Compiler => Builder
+Package(Builder) + API + Extension => Operator
+
+<br/>
+
+## 脚本构建器（Builder）
+
+As the most important core part of Operator, Builder primarily provides delegates for Operator, can receive configurations from outside, can combine templates internally, and compiles them.<br x-id="2" />
+it is roughly divided into two parts, the Template template and the Compiler compiler：<br x-id="2" />
+it is roughly divided into two parts, the Template template and the Compiler compiler：\
+其大致分为两部分 Template 模板与 Compiler 编译器：
+
+<br/>
+
+- Template 构建模板
+  使用 Template 模板构建运行时脚本字符串，模板对外暴漏 API 以方便使用者组成编译字符串。
+  - UsingTemplat 是 Natasha 内置模板，提供了从命名空间到完整对象的代码构建。
+  - DelegateTemplate 是 Natasha 内置模板，提供了方法代码的构建。
+  - FieldTemplate 是 Natasha 内置模板，提供了字段代码的构建。
+  - PropertyTemplate 是 Natasha 内置模板，提供了属性代码的构建。
+
+<br/>  
+
+- Compiler 编译器
+  编译器接收模板提供的字符串并进行编译，完成 Builder 的编译任务。
+  - AssemblyCSharpBuilder  : 使用 Natasha 的 CSharp 编译器可以轻松的完成字符串的编译和元数据的提取。
+
+<br/>
+
+直接使用 Natasha 内置的 Builder 可以快速实现定制，例如： OopBuilder[TOperator] ，MethodBuilder[Operator] 泛型方法。
+前者为其提供对象构造模板，后者专注构建方法。
+
+<br/>
+
+## 操作类（Operator）
+
+Operator 在 Builder 的基础上进行了 Package 封装，Operator 存储了 Builder 提供的编译结果，对外暴漏用户级别的 API 。 <br/>
+
+#### 案例
+
+例如 Natasha 内置的 [FastMethodOperator](https://github.com/dotnetcore/Natasha/blob/master/src/Natasha.CSharp/Natasha.CSharp.Template/Api/Level1/Operator/FastMethodOperator.cs) 在 [MethodBuilder](https://github.com/dotnetcore/Natasha/blob/master/src/Natasha.CSharp/Natasha.CSharp.Template/Builder/MethodBuilder.cs) 的基础上进行了包装和简化，FastMethodOpeartor 的初始化函数中定制了一个专属自己的脚本构建流程，如下模板翻译成 `public static` ：
+
+```cs
+this.Access(AccessFlags.Public)
+.Modifier(ModifierFlags.Static);
+```

src/i18n/ja-JP/docusaurus-plugin-content-docs/current/compile/index.md

@@ -1,18 +1,25 @@
 ---
-title: 11. 编译模板 API速查表
+title: 包说明
 ---
 
 <br/>
 
-|         类名         |            作用           |      命名空间      |     操作类型    |
-| :----------------: | :---------------------: | :------------: | :---------: |
-|      NAssembly     |  快速创建同程序集的 oop 及委托等操作类  |       全局       | 静态初始化,动态实例化 |
-|      NInstance     |    根据类型，提供一个初始化实例的委托    |       全局       |      静态     |
-|      NDelegate     | 快速创建指定域的 Action/Func 委托 |       全局       | 静态初始化,动态实例化 |
-|       NClass       |        快速创建一个公有类        |       全局       | 静态初始化,动态实例化 |
-|     NInterface     |        快速创建一个公有接口       |       全局       | 静态初始化,动态实例化 |
-|        NEnum       |        快速创建一个枚举类        |       全局       | 静态初始化,动态实例化 |
-|       NRecord      |        快速创建一个记录类        |       全局       | 静态初始化,动态实例化 |
-|       NStruct      |        快速创建一个结构体        |       全局       | 静态初始化,动态实例化 |
-| FakeMethodOperator |    仿造 MethodInfo 创建方法   | Natasha.CSharp | 静态初始化,动态实例化 |
-| FastMethodOperator |          快速创建方法         | Natasha.CSharp | 静态初始化,动态实例化 |
+### 域实现包
+
+`DotNetCore.Natasha.DynamicLoad.Base` 包为编译单元与域的粘合接口包，自定义实现域并给 Natasha 编译单元用。
+
+`DotNetCore.Natasha.Domain` Natasha 官方的 Core3.0+ 域操作包。
+
+`Natasha.CSharp.Compiler.Domain` 继承自 `DotNetCore.Natasha.Domain` 并实现了 `DotNetCore.Natasha.DynamicLoad.Base` 编译粘合接口包。
+
+## 编译单元包
+
+`DotNetCore.Natasha.CSharp.Compiler` Natasha 基础编译单元包。
+
+### 扩展包
+
+`DotNetCore.Natasha.CSharp.Template.Core` 在编译单元基础上构建的模板编译包。
+
+`DotNetCore.Natasha.CSharp.Extension.Ambiguity` 在编译单元基础上扩展的解决二义性引用的包。
+
+`DotNetCore.Natasha.CSharp.Extension.Codecov` 在编译单元基础上扩展的统计动态程序集使用率的包。

src/i18n/ja-JP/docusaurus-plugin-content-docs/current/template/001-static-init.md

@@ -0,0 +1,40 @@
+---
+title: 1. 模板初始化操作
+---
+
+Natasha 的所有模板均继承自 ComplierTemplate ，ComplierTemplate 本身会提供静态构造方法。因此上层 API 也会被支持。
+
+<br/>
+
+## 使用
+
+NDelegate / NAssembly / NClass.. / xxx_Oerator 等等以下称为 “Handler”.
+
+<br/>
+
+#### 静态初始化代码：
+
+```cs
+
+//使用 domain 域
+Handler.UseDomain(domian, compiler => { 编译器配置 });
+
+
+//使用某编译器的域
+Handler.UseCompiler(assemblyCSharpCompiler, compiler => { 编译器配置 }));
+
+
+//创建一个 "domainJim" 域
+Handler.CreateDomain("domianJim", compiler => { 编译器配置 });
+
+
+//使用默认域
+Handler.DefaultDomain(compiler => { 编译器配置 });
+
+
+//使用随机域
+Handler.RandomDomain(compiler => { 编译器配置 });
+
+```
+
+<br/>