# gt: General Translation CLI tool: HTML
URL: https://generaltranslation.com/zh/docs/cli/reference/formats/html-files.mdx
---

title: HTML
description: 使用 General Translation CLI 翻译 HTML 文件。HTML 文件格式的 API 参考。

---

CLI 可翻译 HTML 文件。源文件中的所有语法和格式都会在翻译后的文件中原样保留。

## 配置 [#config]

在 `files` 下添加一个 `html` 条目，并将 `include` 数组设为一组 glob 模式。使用 `[locale]` 占位符，以便 CLI 能找到源文件，并将翻译保存到正确的路径。

```json title="gt.config.json"
{
  "defaultLocale": "en",
  "locales": ["es", "fr"],
  "files": {
    "html": {
      "include": ["docs/[locale]/**/*.html"]
    }
  }
}
```

有关所有文件键 (包括用于重命名翻译输出的 `transform`) ，请参阅[配置参考](/docs/cli/reference/config#files)。

## 更新现有翻译 [#update-translations]

HTML 文件发生变更时，General Translation 会复用先前版本中匹配的已翻译元素，仅翻译新增或变更的内容。这样既能保留现有翻译，也能减少更新所需的工作量。

强制重新翻译和词汇表重新翻译会跳过这种增量复用。