# html-translation

**Repository Path**: sn_yang/html-translation

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-10
- **Last Updated**: 2025-03-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HTML 翻译

## 功能

1. 翻译目录下所有 HTML 文件。
2. 异步翻译 HTML 文件。
3. 复制其它文件。
4. 翻译成功的文件，会被保存到输出目录。
5. 翻译成功的文件，不会被再次翻译。
6. 翻译失败的内容，保留原内容。
7. 翻译失败的文件，不会被保存到输出目录。
8. 缓存翻译的结果，避免重复翻译。

## 准备环境

- 安装 uv
- 安装 python
- 安装依赖

```shell
uv sync

# Windows
./.venv/Scripts/activate

# Linux
source ./.venv/bin/activate
```

## 运行

- 编译 `main.py`

```python
    # 被翻译的目录
    input_dir = "./documentation"
    # 翻译后的目录
    output_dir = "./translated"
    # 目标语言
    lang = "zh-cn"
    asyncio.run(translate_directory(input_dir, output_dir, lang=lang))
    # test()
    save_failed_files()
```

- 运行 `main.py`

```shell
python main.py
```

翻译失败的文件不会被保存到输出目录。
翻译过的文件不会被再次翻译。
所以多次翻译，可以确保文件都被翻译了。