# DDCS

**Repository Path**: detechn/DDCS

## Basic Information

- **Project Name**: DDCS
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-04
- **Last Updated**: 2025-08-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DDCS

DDCS，全称Docker Desktop Chinese Script，即Docker汉化脚本。

master 分支目前支持 Windows / Mac。

<big>**你可以在这个仓库找到各个版本的汉化包：【 https://github.com/asxez/DockerDesktop-CN 】**</big>

## 环境需求
- python3.10+
- nodejs

**注意：如果出现如下类似报错则：**
```text
asar : 无法将“asar”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。
```
```bash
npm install -g asar
```

## 使用方法
下载源码，管理员权限启动终端并进入到源码根目录，使用以下命令即可：
```bash
python ddcs.py
```
注意：请务必使用管理员权限启动终端。

## 自动提取 (Beta)

通过正则和简单的代码分析, 自动提取出 Docker Desktop 页面中出现的文本,
并保存到 [extract_config.py](./lib/extract_config.py).

### 对于使用者

目前自动提取翻译属于 Beta 状态, 因此需要在使用 ddcs.py 时显式地声明使用 v2, 即

```bash
python ddcs.py --v2
```

### 对于翻译者 & 开发者

1. 运行自动提取 (仅在 Docker Desktop 发布新版本后需要)

    ```shell
    # 默认情况下与 ddcs.py 一致, 自动寻找本机 Docker Desktop app.asar 并解包
    python ddcs_extract.py
    ```
   或
    ```shell
    # path 参数为手动解包 asar 之后的路径 
    python ddcs_extract.py --path xxx
    ```
2. 进行翻译

   在 [extract_config.py](./lib/extract_config.py) 中的 config 是一个元组列表, 即 `[(英文, 中文), ...]`. 运行自动提取后,
   新增的元组项包含一个英文文本, 和一个为空字符串(`""`)的中文文本, 请在 [extract_config.py](./lib/extract_config.py)
   搜索空字符串并进行翻译.

   **注意事项**:
    - 英文文本可能为包含 js 变量的模板字符串, 如 `Images (${c.images.count})`, 翻译后的中文应当保留变量, 即
      `镜像（${c.images.count}）`
    - 英文文本可能为包含替换字段(`{0},{1},etc.`)的格式化字符串,如 `Select {0} in the {1} column to see it running.`,
      翻译后的中文应当保留替换字段, 即`在 {1} 列选择 {0} 以查看其运行情况`. 如果替换字段遗漏, 在替换阶段也会有警告日志输出.
    - 对于不需要翻译的项目, **请不要删除**, 而是将中文值设为 `None`, 如 `("Python", None)`
    - 对于没有自动提取的文本, 请添加到 [extract_config_manually.py](./lib/extract_config_manually.py) 中

3. 验证翻译

    ```bash
    python ddcs.py --v2
    ```
   替换后启动 Docker Desktop, 验证各个页面. 因为自动提取显然不可能足够精准, 因此可能会:
    - 遗漏部分内容. 表现: 某些地方仍为英文; 解决方法: 添加到 extract_config_manually.py 或者优化 extract.py
    - 错误提取. 表现: Docker Desktop 页面出现报错; 解决方法: 根据报错定位错误文本并修复 (大多出现在
      extract_config_manually 中, 如漏掉引号等)

## 更多问题？
有问题的可以扫码加群咨询。
![](images/1.jpg)

## 更新历史
2024.8.13 发布MAC版本

2024.8.10 发布首个汉化脚本版本。

## Stars
如果你觉得本仓库对你有用，或者你对本仓库感兴趣，欢迎Star。