rest客户机检索和推送po项目服务上的数据
PO-Projects-client的Python项目详细描述
rest客户机来检索和推送po项目服务上的数据。
此客户端的目的是从django项目(或optimus)中的po项目翻译项目安装po文件,或发送更新的pot文件以更新服务上的翻译项目。
用法
在开始使用它之前,您必须在您的po projects服务上创建一个新的翻译项目。注意它的slug名称。
因此执行操作:
po_projects [ACTION]
但如果这是您的第一次使用,您应该向commandline提供一些参数,请在帮助下检查那些需要参数的参数:
po_projects help [ACTION]
首次成功连接服务后,将在当前目录中写入一个“po_projects.cfg”配置文件,该文件将包含连接到服务和获取项目数据所需的所有内容,而无需在命令参数中再次指定这些内容。
也可以在第一次使用之前写入配置文件,以避免给出命令参数。只需在项目根目录下的“po_projects.cfg”文件中(或在您想使用client命令的任何地方)编写此命令即可:
[PO_Project] host = http://192.168.0.103:8001/po/rest/ password = mypassword user = myusername locale_path = project/locale project_slug = myslug kind = django django_default_locale = en_US
- user和password来自在服务API上注册的用户帐户,它需要是管理帐户(is_staff=true);
- host是用于连接服务api的完整url;
- locale_path可以是project locales目录的每个相对路径或绝对路径,该目录将包含带有po文件的消息目录结构;
- kind可以是django(对于django项目)或messages(对于optimus等常见的gettext项目);
实际上,您不能从客户机在服务上创建和注册新项目,您必须在服务上创建它,然后注意slug名称以便在客户机上使用它。
拉
这是获取当前项目翻译tarball的命令:
po_projects pull
它将从PO项目服务的当前现有项目安装或更新您的区域设置目录(^ {TT6}$)。请注意,以前的locales目录将替换为新的,如果您愿意,应该在备份之前备份它。
推动
这是在服务上更新项目翻译的命令:
po_projects push
它将把您当前的本地翻译目录发送到服务,这样它将从提取的字符串中合并项目上的翻译字符串。
使用djangokind时,它需要一个额外的参数django_default_locale,这是要发送到服务以更新项目的区域设置目录的目录名(相对于locale_path)。{TT14}$$不需要它,因为它直接使用Django项目中不存在的POT文件;