WP CLI说明文档

wp i18n make-json

命令概述

此命令将PO文件转换为Jed格式的JSON文件,用于WordPress JavaScript国际化。

适合在需要为JavaScript源文件生成翻译文件时使用。

参数列表

参数 说明
<source> 现有PO文件或包含多个PO文件的目录的路径。
[<destination>] 目标目录或生成的JSON文件的路径。默认为源目录。
[--domain=<domain>] 用于JSON文件名的文本域。覆盖从PO文件中提取的默认值。
[--extensions=<extensions>] 额外的自定义JS扩展,逗号分隔列表。默认搜索.min.js和.js扩展。
[--purge] 是否清除从原始源文件中提取的字符串。默认为true,使用--no-purge跳过移除。
[--update-mo-files] 更新PO文件后是否同时更新MO文件。仅在与--purge结合使用时有效。
[--pretty-print] 格式化输出JSON文件。
[--use-map=<paths_or_maps>] 是否使用字符串映射文件,作为JSON值,数组可指定多个。每个元素可以是字符串(文件路径)或对象(映射)。

常用示例

为语言目录中的所有PO文件创建JSON文件

$ wp i18n make-json languages

为my-plugin-de_DE.po创建JSON文件并保留PO文件不变

$ wp i18n make-json my-plugin-de_DE.po /tmp --no-purge

使用映射文件创建JSON文件

$ wp i18n make-json languages --use-map=build/map.json

使用多个映射文件创建JSON文件

$ wp i18n make-json languages '--use-map=["build/map.json","build/map2.json"]'

使用对象映射创建JSON文件

$ wp i18n make-json languages '--use-map={"source/index.js":"build/index.js"}'