mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-16 01:40:46 +08:00
80 lines
1.9 KiB
Markdown
80 lines
1.9 KiB
Markdown
# auto_localization
|
||
|
||
这个命令行工具可以帮助您自动翻译本地化目录中的不同语言文档。
|
||
|
||
## TODO
|
||
|
||
- [x] 调用git api获取中文文档旧版本完整文本内容
|
||
- [ ] githook
|
||
- [ ] 完成后格式化xaml
|
||
|
||
## 配置
|
||
|
||
在使用前，您需要配置OpenAI API密钥。运行init子命令将会提示您输入API密钥和文档根目录，并将其存储在.env文件中。
|
||
|
||
## 参数
|
||
|
||
```bash
|
||
python run.py -h
|
||
```
|
||
|
||
```
|
||
options:
|
||
-h, --help show this help message and exit
|
||
|
||
positional arguments:
|
||
|
||
{init,create,update}
|
||
|
||
init 初始化工具
|
||
|
||
create 初始化其他语言的文档
|
||
-f, --force 强制覆盖已有的部分
|
||
-t, --test 跳过chatgpt翻译进行测试
|
||
-l, --language 指定语言，可选参数：en-us, zh-tw, ja-jp, ko-kr
|
||
|
||
update 更新本地化翻译
|
||
-t, --test 跳过chatgpt翻译进行测试
|
||
-l, --language 指定语言，可选参数：en-us, zh-tw, ja-jp, ko-kr
|
||
|
||
```
|
||
|
||
## 依赖
|
||
|
||
运行
|
||
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
Enjoy!
|
||
|
||
## 要求
|
||
|
||
自动本地化有几点要求看看能不能做到：
|
||
|
||
1. 不要破坏缩进（包括空行不带空格）
|
||
2. `<ResourceDictionary x:Uid="KeyName">` 如果能在资源字典找到Uid对应的Key，把对应的Value作为注释写入，像这样（注意注释中的空格）：
|
||
```xml
|
||
<!-- 设置 -->
|
||
<ResourceDictionary x:Uid="Settings">
|
||
</ResourceDictionary>
|
||
```
|
||
3. 由于字典被拆分了，重复的键要交给脚本检查
|
||
4. 因为zh-cn可能会混入一些中文梗，所以ja-jp、ko-kr尽量由en-us翻译
|
||
|
||
```code
|
||
check duplicate Key()
|
||
if exist duplicate Key:
|
||
throw (or raise) an exception
|
||
|
||
zh-cn -> zh-tw
|
||
if exist en-us:
|
||
en-us -> ja-jp
|
||
en-us -> ko-kr
|
||
else:
|
||
zh-cn -> ja-jp
|
||
zh-cn -> ko-kr
|
||
zh-cn -> en-us
|
||
```
|