提示
有关在Phrase Strings中集成Contentful的信息，请参阅Contentful (Strings)。
Contentful提供无头内容管理基础设施，以创建、管理和分发内容到任何平台或设备。Phrase以两种方式与Contentful集成：
-
通过专用的Contentful连接器（2.0，入门级，字段级）
Contentful 2.0连接器目前仅支持通过美国数据中心进行身份验证。
-
通过Contentful Marketplace插件以获得定制体验
注释
连接器不支持JSON对象的翻译。
支持的本地化方法
Contentful支持多种本地化方法。请参阅Contentful文档以获取详细描述。
Contentful 2.0连接器是当前和首选的集成，支持字段级本地化。它还提供：
-
多个空间
-
环境别名
-
预览 URL 设置
-
参考导入
-
基于标签的内容过滤
-
实时预览配置
入门级本地化（遗留）
使用 Contentful（入门级） 连接器。
入门级连接器仅适用于具有本地化参考字段的内容类型（例如，名为 参考 的字段，启用了本地化）。
字段级本地化（遗留）
使用 Contentful（字段级） 连接器。
字段级连接器仅适用于具有可翻译字段的内容类型（例如，启用了本地化的 文本 或 富文本 字段），并可选地支持媒体资产。它导入引用的条目及其可翻译字段（如果参考字段已本地化）。
注释
遗留连接器不再积极维护，但仍然可以使用。
连接器有多种用例：
-
项目经理可以直接从在线存储库向项目添加文件。内容可以通过条目 ID 搜索。
-
设置 提交者门户，以便提交者可以直接从在线存储库向请求添加文件。内容可以通过条目 ID 搜索。
-
使用 自动项目创建（APC），当检测到监控文档或文件夹的 内容大小 发生更改时，自动创建新项目。
应用程序 的用例：
-
内容编辑可以直接从Contentful提交条目以进行本地化。这使得内容编辑或管理者可以完全控制本地化流程，并在查看条目时实时获取状态更新。
一旦条目被最终确定：
-
选择所需的目标语言进行本地化。
-
仅将选定语言的条目提交给Phrase TMS，或使用字段选择选项卡选择字段。
-
如果未选择任何字段，则所有可本地化字段将被提交进行翻译。
-
如果选择了不可本地化字段，该字段仍将不会被提交进行翻译。仅提交可本地化字段。
-
如果仅选择了一些可本地化字段，则仅这些字段将被提交进行翻译。
-
-
根据APC设置，作业会从提交的内容中自动创建。在APC运行期间，仅已提交状态中的条目会被选中以创建作业。
-
一旦从提交的条目创建了作业，状态将更改为进行中。当翻译被推送回Contentful时，状态将更改为已完成。
-
在原始内容发生更改后，可以重新提交之前翻译的条目。
-
-
内容编辑可以使用Phrase TMS主屏幕来：
-
批量提交条目。
-
在批量提交时指定单个目标语言。
-
查看活动翻译作业的概览。
-
Contentful设置
在使用Phrase TMS应用程序时：
-
从市场下载短语 TMS应用程序。
-
将应用程序安装到当前可用的空间，并选择应用程序需要安装的内容模型。
-
输入在Phrase TMS中创建连接器时获得的短语 TMS身份验证令牌。
-
单击安装。
可选 - 启动应用程序（Contentful已弃用）
如果通过Contentful的启动应用程序使用工作流支持，请按照以下步骤操作：
-
将Contentful的启动应用程序安装到一个或多个空间。
注释
每个空间只能创建一个工作流。如果在一个Contentful空间内需要不同的内容类型处理方式，请联系专门的客户成功经理。
-
设置所需的本地化工作流。
-
选择遵循所述工作流的内容类型。
如果连接器中设置了工作流，当监控的文章或内容类型的工作流步骤发生变化时，自动项目创建（APC）将自动创建新项目。
已提交的作业可以被取消，允许在进行更改后重新提交内容。这些作业仍将存在于Phrase中，需要由项目经理删除。
注释
Contentful启动应用程序在2.0连接器中不受支持。
-
从设置
页面，下拉到部分。
-
单击连接器。
页面打开。
-
单击新连接器。
页面打开。
-
将类型更改为Contentful 2.0。
-
为连接器提供一个名称。
-
点击连接到Contentful 2.0。
Contentful登录窗口打开。
-
提供登录信息并点击登录（或使用其他登录方式）。登录窗口关闭，显示。
-
如果与应用一起使用连接器，可选择短语Contentful应用复选框。
-
点击生成令牌。
窗口打开。
-
点击生成令牌。
生成的令牌应复制到剪贴板或文本文件中。在关闭窗口之前确保已复制令牌，因为它将不再可见。此令牌将在连接到应用时使用。
-
关闭窗口，显示。
-
-
如果使用Contentful标记来识别可翻译内容，请输入标签ID并按回车。
ID已显示，可以添加更多。
-
如有需要，选择 。
-
如有需要，选择 （嵌套内容）。
显示 。应用所需的过滤器，以更细致地控制系统如何遍历内容关系。
-
限制 Phrase 在导入过程中跟随引用条目的深度。
默认值为 10,000。如有需要，选择其他值或指定自定义整数值。
-
选择是否在内容类型与指定列表匹配的条目处停止或继续。
-
排除父内容类型与指定列表匹配的条目。
-
选择是否在具有任何指定内容标签的条目处停止或继续。
-
选择是否在由指定字段 ID 引用的条目处停止或继续。
-
-
如有需要，选择 。
显示 字段。输入一个值以启用分类法设置。
-
当选中时，连接器从Contentful获取分类法并将其包含在.XLIFF文件中。窗格的CAT Editor将列出每个句段的Contentful分类法值。
-
如果分类法元数据不可用或连接器未配置，则窗格将被省略。
-
如果项目不需要功能/屏幕上下文，建议在.XLIFF导出时禁用分类法以优化性能。
-
-
如有需要，请选择。
别名用于所有APC监控和工作重新导入/导出。如果将来更改别名目标，APC将监控新目标中的内容，工作将从新别名目标重新导入/导出。
-
（默认和推荐）
APC和创建的工作与创建工作/APC时别名指向的环境相关联。APC仅监控该环境和内容；工作被导出并重新导入到该环境。
-
APC和创建的工作与别名本身相关联。APC仅监控该别名和内容；工作被导出并重新导入到该别名。
如果更改别名目标，APC将监控新的别名目标（环境）；工作将现在导出并重新导入到该目标。
-
-
如有需要，请提供。
这是指向Contentful渲染内容的URL模板。支持以下占位符：
-
{env_id}：环境ID -
{entry.id}：条目ID -
{space_id}：空间ID
一个 URL 模板可能看起来像这样：
https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry_id}
注释
该 URL 必须指向一个已部署的应用程序，该应用程序呈现 Contentful 内容。要使用实时预览，请在 URL 模板中用实际的应用程序域名替换
contentfulapp.tld。有关设置 内容预览 的更多信息，请参阅 Contentful 文档。
当前不支持将区域设为占位符。要在 URL 中使用区域，请指定一个固定值并创建多个连接器实例。
-
-
如有必要，提供应从导入到 Phrase 中省略的 ContentIDs。
-
提供 和 以获取 （必需）。
预览 API 需要一个名为 的 Contentful 访问令牌，该令牌应在 Contentful 空间的 API 设置中配置。
Contentful 2.0 集成使用此 API 导入内容并监控更改（APC）。
-
选择每个空间和环境以监控/从 Contentful 导入。
-
设置和访问在 Contentful 内部管理。
-
-
点击 保存。
连接器添加到了 页面上的列表中。
重要
如果从自定义域访问（例如 mydomain.phrase.jp），请打开一个隐身浏览器窗口，并通过 cloud.memsource.com 或 us.cloud.memsource.com 登录，以应用创建或保存连接器所需的身份验证。保存后，可以通过自定义域访问连接器。
-
从设置
-
单击连接器。
页面打开。
-
单击新连接器。
页面打开。
-
将 类型 更改为 要么 Contentful（条目级） 还是 Contentful（字段级） 并为连接器提供一个名称。
-
如果与应用一起使用连接器，可选择短语Contentful应用复选框。
-
Contentful 应用令牌
生成一个应用令牌，以便输入到Phrase TMS Contentful应用程序中。在生成令牌并将其复制到Contentful应用后，保存连接器。
注释
保存后，令牌无法在Contentful中更改。要更新它，请从Phrase TMS中的连接器配置中撤销令牌并生成一个新令牌。
-
-
配置与语言无关的设置。
-
源语言
选择一种源语言以覆盖Contentful的默认语言。然后，连接器将从连接器配置中设置的语言中提取内容。
示例：
注释
在使用该应用程序时不适用。
-
-
选择如何通过条目导入模式处理嵌套内容。内容可以使用参考字段引用其他内容，从而创建实体的层次结构。
-
Contentful（条目级别）
条目级连接器会自动遍历整个嵌套内容的层次结构。
-
Contentful（字段级别）
选择字段级连接器应如何导入嵌套内容。
-
-
从存储库中添加时明确选择的内容将被导入。
-
通过APC检测到的更改将被导入进行翻译。
-
-
导入引用的条目
-
连接器遍历整个嵌套内容的层次结构，并导入所有可译字段以进行翻译。
-
-
-
-
在省略可译字段中创建一个以逗号分隔的列表，以省略在导入到Phrase TMS时被检查的的字段。使用以下结构：
contentTypeID:fieldID。-
如果列出的字段应留空，请选择将省略的字段留空。此设置将应用于所有列出的条目。
-
如果列出的字段应包含源值，请选择将源复制到目标。此设置将应用于所有列出的条目。
-
-
如果源语言的特定字段缺少数据，请选择。
如果需要，从下拉列表中选择一个。在缺少数据的情况下，将使用此语言区域。
注释
Contentful的后备语言与此设置之间没有关系。
-
如有需要，请提供（BETA）。
这是指向Contentful渲染内容的URL模板。支持以下占位符：
-
{env_id}：环境ID -
{entry.sys.id}：条目ID -
{space_id}：空间ID
一个 URL 模板可能看起来像这样：
https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry.sys.id}
注释
该 URL 必须指向一个已部署的应用程序，该应用程序呈现 Contentful 内容。要使用实时预览，请在 URL 模板中用实际的应用程序域名替换
contentfulapp.tld。有关设置 内容预览 的更多信息，请参阅 Contentful 文档。
当前不支持将区域设为占位符。要在 URL 中使用区域，请指定一个固定值并创建多个连接器实例。
-
-
如果技术支持团队要求记录调试信息，请选择。
-
点击连接到Contentful。
如果连接成功，连接器设置中将出现一个勾号。否则将出现红色感叹号。将鼠标悬停在图标上可查看更多详细信息。
-
仅限Contentful（条目级）：
设置源语言。
注释
该语言应与在Contentful的区域设置中配置的Contentful空间的默认区域匹配。
-
点击 保存。
连接器添加到了 页面上的列表中。
-
可选地，编辑连接器以选择。
-
翻译文章：
连接器监视选定阶段（例如翻译阶段）中的文章。作者可以在文章准备好进行翻译时将此标签应用于文章。
从Contentful导入时：
-
当源文章被下载时，连接器将工作流推进到选定阶段（例如翻译进行中）。
导出到Contentful时：
-
当翻译被导出时，连接器将源文章的工作流阶段设置为选定阶段（例如翻译完成）。
注释
Contentful于2023年6月1日停止支持工作流。不支持继续使用。
-