# HaTwinbasicIde

**Repository Path**: klima/ha-twinbasic-ide

## Basic Information

- **Project Name**: HaTwinbasicIde
- **Description**: 中文Twinbasic社区，汉化IDE
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: https://twinbasic.com
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2024-01-05
- **Last Updated**: 2024-01-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


>Hello everyone, this is a translation tool made by our internal team when using the community version of Twinbasic. 

>Today, I saw some friends asking if they could be translated into other languages. I just asked if the tb author could do this, And the author agreed.

>Later, I will optimize this project into a better tool for translating into multiple languages and publish it to: 
https://github.com/woeoio/twinbasic-locale



### 本项目一键汉化 TwinBasic IDE
是为了后续官方更新了之后避免每次都去修改源文件
- 本项目旨在解决官方版本尚无多国语言包的情况下实现中文汉化
- 如果官方认定本项目侵权，将会立即删除。

### 关于TwinBasic中文社区
- 源官方网站：https://www.twinbasic.com
- 中文交流群组：[点击链接加入群聊【TwinBasic开发交流】](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=dFalufubWf4Uik0VmGJAejZ4Ovip04VC&authKey=3HZqBkHlsNuiySgHCNZ1t5s7qAVc0rDAzGO87C48z1Skzja9QSSOtq%2Fvbi7gdt%2FO&noverify=0&group_code=788160802)：788160802

### 目录说明
- 1. `dist`目录是汉化工具的编译产物，执行里面的exe文件就可以一键汉化任意官方版本
- 2. `lang`目录是汉化语言包，所有的汉化字符都在这里面的json文件里面维护就行了
- 3. `src`目录是汉化工具的源码，可以根据需要修改
- 4. `twinbasic`目录是官方的IDE目录，里面用版本号作为子目录，是最终汉化产物，给开发者使用
- 5. `pic`是一些截图

### 如何使用
1. 下载本项目，解压到任意目录
2. 使用：
  - 如果你是想使用汉化后的 TwinBasic 就直接使用 twinbasic 目录下的任意版本就行，已汉化
  - 如果你是想加入汉化小组，共同维护汉化，可以对本仓库发起 PR 请求（正常是需要维护lang目录下的json文件就行，如果有更好的优化也可以修改 src 目录），成为贡献者，在TwinBasic历史上留下一笔。
3. 更新：
  - 后续从中文QQ群文件里面下载到 TwinBasic 官方的最新版文件包后，
  - 放入 twinbasic 目录下，就可以使用一键汉化工具直接翻译最新版了。

### 如何加入汉化小组
1. fork本项目
2. 在src目录下修改lang目录下的json文件
3. 修改完后提交PR
4. 等待管理员合并

### 如何修改 lang 目录的 json 文件
1. 打开 `lang` 目录下的 `zh-cn.json` 文件
2. 从IDE找到你想要修改的汉化字符作为关键词在main.js等文件里查找
3. 找到后，如果出现多个位置，那么要注意查看每个位置的含义是否都是用于界面显示的
4. 如果不是，那么就要继续扩大关键词范围，比如，`caption: "OPEN"`,就比 `OPEN`更精准 
5. 如果像上面这样关键词里面带了` \ " `这两个字符的，就需要在字符前面增加`\`进行转义。比如：
```json
    {
      "searchfrom": "caption: \"OPEN\"",
      "replaceto": "caption: \"打开\""
    },
    {
      "searchfrom": "Visual Styles:\\n\\nWith this setting on...",
      "replaceto": "视觉样式:\\n\\n当此设置为ON时..."
    },
```

### 关于在线汉化按钮和启动器
准备做个启动器，放在根目录，方便开发者直接启动Twinbasic最新版本的主程序
启动成功之后，启动器去本仓库检查当前本地版本号和仓库版本号，发现不一致就提示开发者是否升级。

真正实现一键升级汉化语言包和主程序，实现仓库小组汉化，所有开发者自动更新的好处。
（算了，只做个在线获取汉化包的吧，其他没时间搞了）
（2023-12-30在线获取汉化包的已完成）

### 汉化工具截图
![](pic/20240103/1704276601563.png)

### 汉化工具源码(在src目录)
![](pic/20231218/1702879154621.png)

### 汉化效果截图

![](pic/20231218/1702879605250.png)