Weblate 4.2.2 用户文档

• 语言: 中文（简体）
• 格式: .epub
• 来源: docs.weblate.org

摘要

文档详细介绍了Weblate 4.2.2的功能和配置，包括前端构建工具如Bootstrap和jQuery，依赖管理工具yarn，代码格式化工具Prettier和ESLint，本地化功能的实现方法，如gettext函数的使用，错误报告的配置如Rollbar和Sentry的支持，以及REST API的功能和使用指南。同时，文档还涵盖了性能优化、缓存设置、依赖管理以及 Translation Memory 的相关配置。

AI总结

# Weblate 4.2.2 用户文档总结

## 1. 项目结构与工具
- **依赖管理**：采用 `yarn` 管理前端第三方库，配置文件位于 `scripts/yarn`，使用 `scripts/yarn-update` 更新并构建库文件到 `weblate/static/vendor`。
- **代码风格**：使用 `Prettier` 格式化 JavaScript 和 CSS 文件，使用 `ESLint` 检查 JavaScript 代码。
- **前端框架**：基于 `Bootstrap` 和 `jQuery` 构建前端。

## 2. 本地化功能
- 用户界面文本需本地化化，使用 `gettext` 函数处理可翻译文本：
- 单数/复数处理：使用 `ngettext` 根据数量生成不同形式。
- 格式化字符串：使用 `interpolate` 处理格式化字符串。
- 示例：

  var object_count = 1;
  s = ngettext('literal for the singular case', 'literal for the plural case', object_count);
  fmts = ngettext('There is %s object. Remaining: %s', 'There are %s objects. Remaining: %s', 11);
  s = interpolate(fmts, [11, 20]); // 输出: 'There are 11 objects. Remaining: 20'

## 3. 翻译记忆库
- **导入**：使用 `import_memory` 命令将 TMX 或 JSON 文件导入翻译记忆库。
- 参数：
- `--language-map`：映射语言代码，例如 `--language-map en_US:en` 将 `en_US` 映射为 `en`。
- **导出**：使用 `dump_memory` 命令导出翻译记忆库。

## 4. 项目管理
- **导入项目**：使用 `import_project` 命令从 Git 仓库导入项目，自 3.0 版本起基于组件发现插件。
- **批量导入**：支持通过 JSON 文件批量导入组件，使用 `import_json` 命令。
- JSON 文件结构示例：

    [
      {
        "slug": "po",
        "name": "Gettext PO",
        "file_format": "po",
        "file_mask": "po/*.po",
        "new_lang": "none"
      },
      {
        "name": "Android",
        "file_mask": "android/values-*/strings.xml",
        "template": "android/values/strings.xml",
        "repo": "weblate://test/test",
        "file_format": "aresource"
      }
    ]

## 5. 配置与扩展
- **错误报告**：支持集成 `Rollbar` 和 `Sentry`。
- Rollbar 配置：

    ROLLBAR_KEY = '您的 Rollbar 令牌'
    ROLLBAR_ENVIRONMENT = '生产环境'  # 默认 production

- Sentry 配置：

    SENTRY_DSN = '您的 Sentry DSN'
    SENTRY_ENVIRONMENT = '您的环境'  # 可选

- **本地化 CDN**：配置 JavaScript 文件本地化 CDN：

  WEBLATE_LOCALIZE_CDN_URL = 'https://cdn.example.com/'
  WEBLATE_LOCALIZE_CDN_PATH = '/app/data/l10n-cdn'  # 容器内路径

- **邮件配置**：配置 SMTP 服务器发送邮件：

## 6. API 使用
- **REST API**：自 2.6 版本起提供，基于 Django REST framework，访问路径为 `/api/`。
- 公共项目 API 无需认证，但未认证请求频率受限（默认 100 次/天），建议使用认证。
- 认证方式：在 `Authorization` 头中使用令牌，获取路径见用户概况。
- **请求参数**：
- `format`：响应格式，默认支持 `json` 和 `api`。
- `Accept`：指定响应内容类型。
- `Content-Type`：请求内容类型。
- `Authorization`：认证令牌。

## 7. 系统依赖
- **主要依赖**：
- Python 3.6 或更高版本。
- Django
- Celery
- Translate Toolkit
- translation-finder
- Python Social Auth
- Django REST framework
- **可选依赖**：
- Mercurial（Mercurial 仓库支持）
- phply（PHP 支持）
- tesserocr（截屏 OCR 功能）
- akismet（垃圾邮件保护）
- ruamel.yaml（YAML 文件支持）

## 8. 其他工具
- **创建演示项目**：使用 `import_demo` 创建基于 [WeblateOrg/demo](https://github.com/WeblateOrg/demo) 的示例项目。
- **导入 JSON 文件**：使用 `import_json` 从 JSON 数据批量导入组件。
- **用户数据导出**：支持导出用户数据。

如需进一步了解，请参考该文档的原文。