内容应用引擎常见问题解答

什么是内容应用程序?

一个内容应用是一个应用程序,促进Lokalise和第三方平台之间的内容交换。

什么是托管应用程序?

托管应用程序是运行在Lokalise基础设施上的应用程序。用户通过Lokalise界面与它们交互。这类应用的例子包括GitHub而且意旨集成,或者自定义占位符

什么是内容引擎?

内容引擎是Lokalise架构的一个组件,允许在其之上构建托管内容应用程序。引擎负责构建内容应用程序所需的所有常见功能:它负责用户界面,处理标准的安装、配置和内容管理流程,并依赖连接器与第三方平台api进行交互。

什么是连接器?

一个连接器是一项服务,作为Lokalise内容引擎和第三方内容平台(如Freshdesk)之间的桥梁。它将被安装并托管在Lokalise上,它将成为两个平台之间可翻译内容交换的重要部分。

我可以使用连接器构建内容应用程序吗?

当然!任何开发人员都可以构建自己的连接器,并将其提交给Lokalise Apps。检查内容引擎托管连接器的可行性评估验证您的内容平台是否满足要求。

我想创建自己的应用程序,我应该从哪里开始呢?

首先,看一下可行性评估决定在Lokalise上翻译哪种类型的内容,并确保内容管理平台满足实现连接器的要求。基本上,它应该提供用于授权和读写内容的API端点。

然后,您可以利用我们的连接器模板,用于节点而且PHP.在内容交换连接器的技术要求您将看到需要构建的连接器服务的详细说明。

请让我们知道你有兴趣建立一个新的应用程序。这样,我们可以进一步帮助你,并提前计划应用程序审查。您可以使用应用提交门户,或写信给(电子邮件保护)跟我们说说你的应用吧。

我可以创建一个内容应用程序,并让它只对我的公司可见吗?

是的,这是可能的。

有什么一般(技术)要求吗?

是的。您可以在App审核清单文档。连接器模板已经提供了一个很好的起点,但这里有一些重要的事情需要记住:

  • 可交付的代码必须遵循相应语言和框架的编码标准。
  • 交付内容必须包含大量描述代码功能和逻辑的文档,可以作为单独的文档,也可以作为嵌入在代码中的内联注释。
  • 你的应用应该测试(理想情况下,应该准备一个自动测试套件)。

总是可以构建连接器吗?

不,有时构建连接器可能不可能或不可行。以下是一些典型案例:

  • 内容平台没有提供API来管理内容项,或者API具有非常严格的限制,这严重限制了执行内容交换的能力。
  • 内容平台不支持多语言内容,也没有可行的方法来克服这一限制。

如果内容平台不提供多语言支持怎么办?

您可能会找到克服这种限制的方法。根据我们的经验,通常会有解决这个问题的选项

  • 可能会有第三方插件支持多语言。
  • 也许,您可以找到一种特定的方式来存储翻译后的内容。您可以尝试使用分支、选项卡、组或任何其他可用于组织此类内容的临时组件来组织它。在这种情况下,必须通过API访问这些元素。
  • 如果其他方法都不起作用,您可以尝试创建“主要”内容的翻译副本,并以某种方式使用自定义属性将其链接到原始内容。

如果内容平台包含由多个元素组成的项呢?

完全没问题!Lokalise可以导入/导出多个元素,并将它们链接到单独的翻译键。此外,还可以进一步对相关项进行分组。

Lokalise支持哪些授权方法?

目前内容引擎支持两种授权方法: OAuth 2.0和API令牌。那么,有什么不同呢?

  • 一个API的令牌由用户手动生成,并将由连接器随每个API请求一起发送。连接器需要读/写令牌。
  • OAuth 2.0Flow使连接器能够代表其他用户操作,而不需要手动生成任何令牌。使用OAuth 2.0,用户将被要求授予应用程序某些权限(例如,管理翻译或导出翻译数据)。

你们提供连接器应用程序的模板吗?

是的,我们有!您可以使用我们的连接器模板节点而且PHP

我的应用程序准备好了。接下来我该怎么办?

好消息!如果你认为你的应用程序已经准备好了,请阅读App审核清单并确保你的应用程序符合所提供的要求。如果一切都好,你可以跟着审查和发布你的应用文档。具体来说,你需要执行以下步骤: