提示
有关在Phrase Strings中使用Contentful集成的信息，请参阅Contentful (Strings)。
Contentful提供无头内容管理基础设施，以创建、管理和分发内容到任何平台或设备。Phrase通过两种方式与Contentful集成：
-
通过专用的Contentful连接器（2.0，入门级，字段级）
-
通过Contentful Marketplace插件以获得定制体验
说明
该连接器不支持JSON对象的翻译。
支持的本地化方法
Contentful支持多种本地化方法。请参见Contentful文档以获取详细描述。
Contentful 2.0连接器是当前和首选的集成，支持字段级本地化。它还提供：
-
多个空格
-
环境别名
-
预览URL设置
-
参考导入
-
基于标签的内容过滤
-
实时预览配置
入门级本地化（遗留）
使用Contentful (入门级)连接器。
入门级连接器仅适用于具有本地化参考字段的内容类型（例如，名为参考的字段，启用了本地化）。
字段级本地化 (原)
使用 Contentful (字段级) 连接器。
字段级连接器仅适用于具有可译字段的内容类型（例如，文本 或 富文本 字段，启用了本地化）以及可选的媒体资产。它导入引用的条目及其可译字段（如果引用字段已本地化）。
说明
遗留连接器不再积极维护，但仍然可以使用。
连接器 有多种用例：
-
项目经理可以直接从在线存储库向项目添加文件。内容可以通过条目 ID 进行搜索。
-
设置 提交者门户，以便提交者可以直接从在线存储库向请求添加文件。内容可以通过条目 ID 进行搜索。
-
使用 自动项目创建 (APC)，当检测到监控文档或文件夹的 内容大小 发生更改时，自动创建新项目。
-
首次运行 APC 时导入所选文件。
-
应用程序 的用例：
-
内容编辑者可以直接从 Contentful 提交条目以进行本地化。这使得内容编辑者或经理可以完全控制本地化流程，并在查看条目时实时获取状态更新。
一旦条目已最终确定：
-
选择所需的目标语言进行本地化。
-
仅将选定语言的条目提交给 Phrase TMS，或使用 字段选择 选项卡选择字段。
-
如果未选择任何字段，则所有可本地化字段将被提交进行翻译。
-
如果选择了不可本地化字段，该字段仍将不会被提交进行翻译。仅提交可本地化字段。
-
如果仅选择了一些可本地化字段，则仅这些字段将被提交进行翻译。
-
-
根据APC设置，作业会自动从提交的内容中创建。在APC运行期间，仅提交状态中的条目会被选中以创建作业。
-
一旦从提交的条目创建了作业，状态会更改为进行中。当翻译被推送回Contentful时，状态会更改为已完成。
-
之前翻译的条目在原始内容更改后可以重新提交。
-
-
内容编辑者可以使用Phrase TMS主页来：
-
批量提交条目。
-
在批量提交时指定单个目标语言。
-
查看活动翻译作业的概览。
-
Contentful设置
在使用Phrase TMS应用程序时：
-
从市场下载Phrase TMS应用程序。
-
将应用程序安装到当前活动空间，并选择应用程序需要安装的内容模型。
-
输入在Phrase TMS中创建连接器时获得的Phrase TMS认证令牌。
-
点击安装。
可选 - 启动应用程序（Contentful已弃用）
如果通过Contentful的启动应用程序使用工作流支持，请按照以下步骤操作：
-
将Contentful的启动应用程序安装到一个或多个空间。
说明
每个空间只能创建一个工作流。如果在一个Contentful空间内需要不同的内容类型方法，请联系专门的客户成功经理。
-
设置所需的本地化工作流。
-
选择遵循所描述工作流的内容类型。
如果连接器中的工作流已设置，当监控的文章或内容类型的工作流步骤发生更改时，自动项目创建（APC）将自动创建新项目。
已提交的作业可以被取消，允许在进行更改后重新提交内容。这些作业仍将存在于Phrase中，需要由项目经理删除。
说明
Contentful启动应用程序在2.0连接器中不受支持。
-
从设置
页面，下拉到部分。
-
单击连接器。
页面打开。
-
点击新连接器。
页面打开。
-
将类型更改为Contentful 2.0。
-
为连接器提供一个名称。
-
点击连接到Contentful 2.0。
Contentful登录窗口打开。
-
提供登录详细信息并点击登录（或使用其他登录方法）。登录窗口关闭，显示。
-
如果与应用程序一起使用连接器，可以选择Phrase Contentful应用程序复选框。
-
点击生成令牌。
窗口打开。
-
点击生成令牌。
生成一个令牌，应复制到剪贴板或文本文件中。确保在关闭窗口之前复制令牌，因为它将不再可见。此令牌将在连接到应用程序时使用。
-
关闭窗口，显示。
-
-
如果使用Contentful 标签来识别可译内容，请输入标签ID并按回车。
ID已显示，可以添加更多。
-
如有需要，选择（嵌套内容）。
在导入和创建作业时，将包含所有嵌套内容。
-
如有需要，选择。
显示字段。输入一个值以启用分类法设置。
-
如有需要，选择。
别名用于所有APC监控和作业重新导入/导出。如果将来更改别名目标，APC将监控新目标中的内容，作业将从新别名目标重新导入/导出。
-
（默认和推荐）
APC和创建的工作与别名在创建工作/APC时所指向的环境相关。APC仅监控该环境和内容；工作被导出并重新导入到其中。
-
APC和创建的工作与别名本身相关。APC仅监控该别名和内容；工作被导出并重新导入到其中。
如果别名目标被更改，APC将监控新的别名目标（环境）；工作现在将导出并重新导入到其中。
-
-
如有需要，请提供。
这是指向Contentful渲染内容的URL模板。支持以下占位符：
-
{env_id}:Environment ID -
{entry.id}:Entry ID -
{space_id}:Space 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（字段级）。
-
如果与应用程序一起使用连接器，可以选择Phrase Contentful应用程序复选框。
-
Contentful应用令牌
生成一个应用令牌，以便输入到Phrase TMS Contentful应用程序中。生成令牌后，保存连接器并将其复制到Contentful应用中。
说明
一旦保存，令牌不能在Contentful中更改。要更新它，请从Phrase TMS中的连接器配置中撤销令牌并生成一个新令牌。
-
-
配置与语言无关的设置。
-
源语言
选择源语言以覆盖Contentful默认语言。然后，连接器将从连接器配置中设置的语言中提取内容。
示例：
说明
使用该应用程序时不适用。
-
-
选择如何通过条目导入模式处理嵌套内容。内容可以使用引用字段引用其他内容，从而创建实体的层次结构。
-
Contentful（条目级）
条目级连接器会自动遍历整个嵌套内容的层次结构。
-
Contentful（字段级）
选择字段级连接器应如何导入嵌套内容。
-
-
从存储库中添加时明确选择的内容将被导入。
-
APC检测到的更改将被导入以进行翻译。
-
-
导入引用的条目
-
连接器遍历整个嵌套内容的层次结构，并导入所有可译字段以进行翻译。
-
-
-
-
在省略可译字段中创建一个以逗号分隔的列表，以省略在导入到Phrase TMS时检查的的字段。使用以下结构：
内容类型ID:字段ID。-
如果列出的字段应留空，请选择将省略的字段留空。此设置将应用于所有列出的条目。
-
如果列出的字段应包含源值，请选择将源复制到目标。此设置将应用于所有列出的条目。
-
-
如果源语言中某个字段的数据缺失，请选择。
如果需要，从下拉列表中选择。在数据缺失的情况下，将使用此语言区域。
说明
Contentful后备语言与此设置之间没有关系。
-
如有需要，请提供（测试版）。
这是指向Contentful渲染内容的URL模板。支持以下占位符：
-
{env_id}:Environment ID -
{entry.sys.id}：Entry ID -
{space_id}:Space 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日停止支持工作流。不支持继续使用。
-