mmdzanata 0.7

# mmdzanata
## 先决条件
* [libmodulemd](https://github.com/fedora-modularity/libmodulemd)
* [koji](https://pagure.io/koji)
* [zanata-client](https:// github.com/zanata/zanata-client)要

在 Fedora 28+ 上
安装
，请运行： mmdzanata` 或在 Fedora 28+ 上使用 `dnf install mmdzanata` （推荐）。## CLI 使用### Zanata 客户端设置使用上传功能提取字符串需要正确设置Zanata 客户端。跟着











[说明](http://docs.zanata.org/en/release/client/configuration/) 来自
Zanata 以正确设置您的 `~/.config/zanata.ini` 文件。请注意，
您需要针对
https://fedora.zanata.org
而不是
https://translate.zanata.org

### 提取可翻译
字符串从特定 Fedora
版本的模块中提取可翻译字符串（例如 f29） :
```
mmdzanata --branch f29 extract [--upload]
```
这将从 Koji 构建系统读取所有模块元数据，
并将可翻译的字符串转换为 Zanata 兼容的 gettext 文档。如果
通过了 `--upload`，它也会尝试使用 `zanata-cli` 工具
将字符串上传到 Zanata 服务器。
有关如何配置的信息，请参阅上面的“Zanata 客户端设置”部分。

### Produce modulemd-translations YAML
从 Zanata 读取翻译后的字符串并将其转换为
可以包含在 repodata 中的 modulemd-translations YAML 文档：
```
mmdzanata --branch f29 generate_modulemd
```

这将在包含所有已知
翻译字符串的当前目录。

## API
### mmdzanata
mmdzanata 类有两个主要方法：
* get_module_catalog_from_tags()
* generate_metadata()

#### mmdzanata.get_module_catalog_from_tags()
这将返回一个 babel.message.Catalog 对象，其中包含
来自任何模块的所有可翻译字符串，这些模块带有一个传递的标签。

#### mmmdzanata.generate_metadata()
从提供的
Zanata 项目和分支返回一个可迭代的 modulemd-translation 对象。

### mmdzanata.fedora这个类提供了在 Fedora模块
中处理翻译的帮助程序。