README.zh-cn.md

IntelliSenseLocalizer

用于生成和安装本地化IntelliSense文件的工具。

简介

在.net6之前，我们可以在这个页面 - Download localized .NET IntelliSense files下载本地化的智能感知文件。但.net6发布很长一段时间后，这个页面也没有添加.net6的本地化的智能感知文件。根据dotnet/docs中的这个issue，里面说不再提供本地化智能感知文件了 - "Yes, unfortunately, we will no longer be localizing IntelliSense."。但是在线文档里面还有本地化描述。所以有了这个工具。

IntelliSenseLocalizer使用在线文档生成本地化智能感知文件。工具会下载所有的api页面并分析页面以匹配原始的智能感知文件，然后生成目标xml。

得益于在线文档良好的本地化和统一的页面布局。这个工具理论上可以生成所有区域的智能感知文件。但是如果页面布局变动了，这个工具无法自动的适配新的布局。

如何使用

1. 安装本工具

dotnet tool install -g islocalizer

运行 islocalizer -h 可以看到更多的命令和帮助信息.

在命令最后加上参数 -h 即可查看命令的帮助，例如：

islocalizer install auto -h
islocalizer cache -h

2. 尝试从nuget.org安装已生成好的智能感知文件

查看可用的包 Nuget

这个命令将尝试从nuget.org找到并安装zh-cn的net6.0智能感知包:

islocalizer install auto -m net6.0 -l zh-cn

你也可以使用-cc来指定内容双语对照类型

islocalizer install auto -m net6.0 -l zh-cn -cc LocaleFirst

3. 自己构建本地化智能感知文件

构建net6.0相关的文件:

islocalizer build -m net6.0

这个命令可能会运行很久。。。不过缓存完文件后，第二次生成会快很多。 生成的压缩包将会存放到默认输出目录，可以在控制台输出中找到路径。

4. 安装生成的智能感知文件

islocalizer install {ArchivePackagePath}

ArchivePackagePath 是build命令输出的路径.