# JapStudy2

**Repository Path**: JamesJoeLee/jap-study2

## Basic Information

- **Project Name**: JapStudy2
- **Description**: 日语单词背诵小程序
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-09
- **Last Updated**: 2025-11-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# JapStudy2

## 描述
JapStudy2 是一个用于学习日语单词的桌面应用程序。它提供了一个图形用户界面 (GUI)，允许用户加载和浏览存储在 Excel 文件中的日语单词，并提供设置界面以自定义学习体验。

## 软件架构
该项目基于 Python 的 `tkinter` 库构建，使用 `tk.Toplevel` 和 `tk.Tk` 创建 GUI 界面。主要组件包括：
- `JapaneseWordApp`: 主应用程序类，负责管理 UI 和单词学习逻辑。
- `SettingsWindow`: 设置窗口类，用于配置应用程序设置。
- 支持从 Excel 文件加载单词，并提供导航功能（上一个/下一个单词）。
- 支持保存和加载配置文件（JSON 格式）。

## 安装
1. 确保已安装 Python 3.x。
2. 安装依赖库：
   ```bash
   pip install pandas openpyxl
   ```
3. 克隆仓库：
   ```bash
   git clone https://gitee.com/JamesJoeLee/jap-study2
   ```
4. 将 `japs.xlsx` 文件放置在项目目录中，或在设置中指定自定义路径。

## 使用说明
1. 运行主程序：
   ```bash
   python main.py
   ```
2. 使用“设置”窗口配置 Excel 文件路径和其他选项。
3. 使用“加载单词”按钮加载单词列表。
4. 使用“上一个”和“下一个”按钮浏览单词，或使用“开始学习”进入学习模式。

## 贡献
欢迎贡献代码或提出改进建议！请遵循以下步骤：
1. Fork 仓库。
2. 创建新分支。
3. 提交更改。
4. 发起 Pull Request。

## Gitee 特性
- 项目托管于 [Gitee](https://gitee.com)，便于协作和版本控制。
- 支持通过 Issues 跟踪问题和功能请求。
- 提供 Wiki 文档支持。

## 许可证
本项目采用 MIT 许可证。详情请参阅 `LICENSE` 文件。