定制的处理器

介绍

定制处理器使开发人员能够实现他们自己的中间件服务器,并在导入和导出翻译内容的过程中实现定制工作流和集成。

通过创建自定义处理服务器并将其连接到Lokalise,开发人员可以操作数据、连接到第三方服务,并将他们自己的自定义逻辑引入到流程中。

以下是处理器如何工作以及如何与Lokalise交互的技术概述:

要理解什么是自定义处理器,一个简单的方法是把它们想象成管道,数据在保存到Lokalise之前通过它传递,然后在它被导出回文件时再次传递:

用例

您知道有时您只需要在处理逻辑中做一点更改,但却找不到一种优雅的方法来实现它。

您知道那种希望能够在流程中添加一个“是的,但是……”函数的感觉吗?

有了Lokalise,梦想就会成真,而有了自定义处理器,用例只受限于您的想象。

下面是一些可以用自定义处理器实现的问题和解决方案的例子:

  • 验证器——确保禁止的词汇永远不会到达生产。
  • 上标处理——用于在不同的框架(如iOS和Android)中使用键。
  • 前/后处理-标准化符号,例如跨不同文件格式的空格和引号。
  • 标记对话——将HTML转换为Markdown(或任何其他语言)很容易。
  • QA和MT集成-在处理过程中连接到任何第三方API以丰富数据。

听起来很有趣吗?的确是!继续阅读,了解如何构建、实现Lokalise并将其连接到您自己的自定义处理器。

如何使用

要使用自定义处理器,你需要两件事:

  1. 一个将接收数据、处理数据并返回数据的服务器(不要担心——我们有一个样板服务器,可以让您在几分钟内开始)。
  2. 安装自定义处理器应用程序,并配置它连接到您的服务器。

为了帮助您加速实现,我们提供了一个带有样板服务器的存储库,它预先配置为可与自定义处理器API一起工作:自定义处理器样板库

一键部署

点击下面的按钮,几秒钟内就可以在Heroku上部署一个示例自定义处理器App:

部署部署

请注意:如果你在Heroku上没有账号,你需要在Heroku上注册。一旦你注册,你将被重定向到你的Heroku应用程序创建页面。

要开始,只需分叉存储库,您将得到:

  • 一个基于Fastly的可部署服务器,并预先配置了Docker和Procfile以方便部署。
  • 预先构建的用于预处理和后处理的路由,准备连接到Lokalise。
  • 处理函数的样板代码,它已经展示了如何迭代和处理有效负载。

在将服务器部署到web可访问的主机提供程序之后,下一步是定制处理功能的业务逻辑。在这里,您可以发挥创造性,集成其他服务,并对发送处理的数据执行任何操作。

当你准备好测试它时,转到Lokalise项目的Apps页面,安装Custom处理器应用程序。要配置应用程序,你需要定义3个值:

  1. 用于预处理的URL——这是已部署服务器的预处理端点的位置。
  2. 用于后处理的URL -相同,但用于后处理。
  3. 文件格式——如果愿意,可以将处理器限制为只与来自特定文件格式的数据交互。

就这样了——您已经准备好测试它了!

要查看它的运行情况,只需上传一个带有键的文件(您可以为此使用UI、API或CLI),您将在Lokalise中看到处理函数的结果。有人称之为魔法。我们称之为可扩展性。

查看更多Lokalise自定义处理器:示例应用程序


这个页面对你有帮助吗?