在线配置 VCS 集成
要配置版本控制系统集成，请指定您要翻译的源文件，以及 Crowdin 应如何在您的仓库中构建翻译文件。
选择好用于翻译的仓库和分支后，下一步是配置所选分支。 点击 打开 分支配置 对话框，开始配置。 在 分支配置 对话框中，您可以加载仓库中已有的配置文件，也可以从头创建新的配置。
如果您希望 VCS 集成在 目标文件包模式 下运行，则需要为每个已选择用于翻译的分支配置目标文件包。
详细了解为 VCS 集成配置目标文件包。
要加载仓库中已有的配置文件，请按照以下步骤操作：
- 单击 并选择 加载配置。
- 指定仓库中配置文件的名称。
- 单击继续。
配置将显示在 分支配置 对话框中。 您可以直接使用，也可以根据需要进行修改。
要创建供集成使用的新配置文件，请在 分支配置 对话框中指定首选名称，然后点击 继续。
然后使用下方列出的模式和占位符指定源文件路径和翻译文件路径。 在右侧面板中，您可以根据指定的路径预览将上传以供翻译的源文件结构以及翻译文件的结构。
完成所选分支的配置设置并保存更改后，配置文件将保存在仓库中翻译分支的根目录下。
您可以使用通配符（*、**、?、[set]、\）模式来指定应上传以供翻译的文件。
详细了解通配符模式。
使用占位符指定翻译文件的存放位置及命名方式：
| Name | Description |
|---|---|
%original_file_name% | Original file name |
%original_path% | Take parent folder names in the Crowdin project to build file path in the resulting bundle |
%file_extension% | Original file extension |
%file_name% | File name without extension |
%language% | Language name (e.g., Ukrainian) |
%two_letters_code% | Language code ISO 639-1 (e.g., uk) |
%three_letters_code% | Language code ISO 639-2/T (e.g., ukr) |
%locale% | Locale (e.g., uk-UA) |
%locale_with_underscore% | Locale (e.g., uk_UA) |
%android_code% | Android Locale identifier used to name “values-” directories |
%osx_code% | OS X Locale identifier used to name “.lproj” directories |
%osx_locale% | OS X locale used to name translation resources (e.g., uk, zh-Hans, zh_HK) |
高级设置提供对集成行为的更多控制。 您可以指定要排除在翻译之外的文件、映射自定义语言代码，以及配置结构化文件格式（如电子表格和 XML）的解析选项。 本节还介绍了可通过手动编辑仓库中的 crowdin.yml 文件来配置的其他参数。
如果您不希望某些文件被翻译，请单击 添加忽略模式，指定这些文件的模式，Crowdin 将不会上传这些文件进行翻译。
如果您的项目对语言区域目录使用自定义名称，您可以使用语言映射将自己的语言映射为 Crowdin 可识别的语言。
要添加语言映射，请按照以下步骤操作：
- 点击 语言映射。
- 选择所需的语言和占位符。
- 指定您的自定义代码。
- 点击 添加映射 以添加另一个自定义代码。
- 点击保存。
您可以在 方案 字段中指定电子表格文件的方案。 要为 CSV 或 XLS/XLSX 文件创建方案，请使用以下常量：
identifier– 列包含字符串标识符。source_phrase– 列包含源字符串。source_or_translation– 列包含源字符串，但文件导出时同一列将填充译文。 如果您上传现有译文，此列的值将用作译文。translation– 列包含译文。context– 列包含源字符串的评论或语境信息。max_length– 列包含字符串译文的最大长度限制值。labels– 列包含源字符串的标记。none– 导入时将跳过的列。
方案示例：identifier,source_phrase,context,fr,de,it,uk（语言代码）。
如果电子表格包含多个目标语言的译文，请选择 多语言文件。 如果您不想翻译第一行中存储的文本，请选择 将第一行作为标题导入。
您可以配置 XML 文件导入设置，以指定 Crowdin 应如何处理 XML 文件。
| 选项 | 描述 |
|---|---|
| 翻译内容 | 选中以翻译标签内存储的文本。 |
| 翻译属性 | 选中以翻译标签属性。 |
| 内容分段 | 选中以将 XML 源文件的内容拆分为较短的文本片段。 |
| 可翻译元素 | 这是一个字符串数组，其中每个条目是应导入的 DOM 元素的 XPath。 示例路径：/path/to/node 或 /path/to/attribute[@attr] |
以下参数无法在线配置：
preserve_hierarchy- 在 Crowdin 中保留目录结构dest- 允许您在 Crowdin 中指定文件名type- 允许您在 Crowdin 中指定文件类型update_option- 在文件更新期间保留译文并保留/删除已更改字符串的审核commit_message- additional text appended to the default commit messageappend_commit_message- controls whether your custom text is appended to or replaces the default commit messageexport_languages- 导出指定语言的译文
保存在线配置后，crowdin.yml 文件将保存在仓库中已配置分支的根目录下。 您可以手动编辑此文件以添加所需参数。
详细了解配置文件。
- 单击 保存 以预览已创建的配置。
- 如果您有多个具有不同配置的文件组，请点击 添加文件过滤器。
如果项目中有多个分支具有相同的配置，且您希望对它们应用相同的过滤器，请选择 将过滤器应用于所有可翻译分支。 - 点击 保存 以保存创建的配置。
配置保存后，可本地化的文件将开始上传到您的 Crowdin 项目。