# Wit-Localezhcn-ttkbootstrap

**Repository Path**: WitOpenSource/wit-localezhcn-ttkbootstrap

## Basic Information

- **Project Name**: Wit-Localezhcn-ttkbootstrap
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-10-01
- **Last Updated**: 2025-10-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ttkbootstrap 全中文本地化项目

## 项目简介

这是一个为 ttkbootstrap 库提供完整中文本地化支持的项目。ttkbootstrap 是一个基于 tkinter ttk 的现代化主题扩展库，本项目通过提供全面的中文语言包，使 ttkbootstrap 应用程序能够在中文环境下完全本地化，包括所有按钮、对话框、提示信息等界面元素。

### 界面效果对比

以下是英文原界面与中文本地化界面的对比展示：

#### 英文界面

![英文界面](en.png)

#### 中文界面

![中文界面](zhcn.png)

## 功能特点

- ✅ 完整覆盖 ttkbootstrap 所有内置消息和文本
- ✅ 支持所有常用控件和对话框的中文显示
- ✅ 简单易用的导入和设置方式
- ✅ 提供多个演示示例，展示实际应用效果
- ✅ 兼容 ttkbootstrap 最新版本

## 目录结构

```
Localezhcn/
├── .gitignore           # Git忽略文件配置
├── LICENSE              # 项目许可证文件
├── README.md            # 项目说明文档
├── data_generator.py    # 测试数据生成工具
├── delete_test.py       # 删除功能测试工具
├── dialog_test.py       # 对话框测试工具
├── en.png               # 英文界面截图
├── messagebox_test.py   # 消息框测试工具
├── src\                 # 源代码目录
│   ├── localezhcn.py    # 核心中文语言包文件
│   └── tableview_demo.py # 表格视图演示应用
├── treeview_demo.py     # 树状视图演示应用
└── zhcn.png             # 中文界面截图
```

## 安装与使用

### 基本要求

- Python 3.7+ 
- ttkbootstrap 库

### 安装依赖

```bash
pip install ttkbootstrap
```

### 快速开始

1. 将 `localezhcn.py` 文件复制到您的项目目录中

2. 在您的 ttkbootstrap 应用中导入并设置中文语言：

```python
import ttkbootstrap as ttk
from ttkbootstrap.localization import MessageCatalog
from localezhcn import *
from ttkbootstrap import localization

# 创建应用窗口
root = ttk.Window(themename="cosmo")
# 初始化本地化并设置为中文
localization.initialize_localities()
MessageCatalog.locale("zh_cn_all")

# 后续应用程序代码...
root.mainloop()
```

## 语言包内容

`localezhcn.py` 语言包包含以下类别的中文翻译：

- 按钮文本：确定、取消、应用、保存、打开等
- 对话框标题和消息：文件操作、确认对话框、错误提示等
- 界面元素：颜色选择器、字体选择器、表格操作等
- 菜单选项：编辑、查看、帮助等
- 状态提示：成功、失败、警告等消息

语言包使用 `zh_cn_all` 作为语言标识，共包含 200 余条中英文对照翻译。

## 示例应用

项目包含两个完整的示例应用，展示了中文本地化的实际应用效果：

### 1. 表格视图演示 (tableview_demo.py)

一个员工信息管理系统示例，展示了 Tableview 控件的中文本地化使用，包括：
- 表格数据的展示与操作
- 部门筛选功能
- 数据导出功能
- 自适应表格列宽

### 2. 树状视图演示 (treeview_demo.py)

一个商品管理系统示例，展示了 Treeview 控件的中文本地化使用，包括：
- 树形数据的增删改查
- 数据排序与搜索
- 数据导出功能
- 自定义对话框

## 运行示例

```bash
python tableview_demo.py
# 或
python treeview_demo.py
```

## 自定义扩展

您可以根据需要扩展或修改语言包内容。编辑 `localezhcn.py` 文件，添加或修改相应的中英文对照翻译：

```python
MESSAGES.append(LocaleMsgs(
    "zh_cn_all",
    ("原始英文文本1", "中文翻译1"),
    ("原始英文文本2", "中文翻译2"),
    # 添加更多翻译...
))
```

## 注意事项

1. 确保在创建应用窗口后再初始化本地化设置
2. 某些第三方组件可能需要单独进行本地化处理
3. 如遇到未翻译的文本，请检查是否为 ttkbootstrap 内置文本或自定义文本
4. 自定义对话框中的文本需要手动设置为中文

## 许可证

本项目采用 MIT 许可证 - 详情请查看 LICENSE 文件

## 贡献

欢迎提交问题和改进建议，共同完善 ttkbootstrap 中文本地化支持！

## 更新日志

- 2025-10-01: 初始版本发布，提供完整的 ttkbootstrap 中文语言包