WP CLI说明文档

wp i18n make-pot

命令概述

扫描PHP、Blade-PHP和JavaScript文件中的可翻译字符串,并生成POT文件。

适用于WordPress插件或主题的国际化流程,自动检测源目录类型并提取字符串。

参数列表

参数 说明
<source> 用于字符串提取的扫描目录。
[<destination>] 结果POT文件的名称。
[--slug=<slug>] 插件或主题的slug,默认为源目录的basename。
[--domain=<domain>] 文本域,默认使用插件或主题的”Text Domain”头部,若未提供则回退到项目slug。
[--ignore-domain] 完全忽略文本域并提取任何文本域的字符串。
[--merge[=<paths>]] 逗号分隔的POT文件列表,其内容应与提取字符串合并,默认目标POT文件。
[--subtract=<paths>] 逗号分隔的POT文件列表,其内容作为字符串提取黑名单。
[--subtract-and-merge] 是否将生成的POT文件中的源代码引用和注释添加到用于减法的POT文件中。
[--include=<paths>] 逗号分隔的文件和路径列表,仅用于字符串提取。
[--exclude=<paths>] 逗号分隔的文件和路径列表,跳过字符串提取。
[--headers=<headers>] JSON格式的数组,用于自定义POT文件头部。
[--location] 是否写入#: filename:line行,默认为true。
[--skip-js] 跳过JavaScript字符串提取。
[--skip-php] 跳过PHP字符串提取。
[--skip-blade] 跳过Blade-PHP字符串提取。
[--skip-block-json] 跳过从block.json文件提取字符串。
[--skip-theme-json] 跳过从theme.json文件提取字符串。
[--skip-audit] 跳过字符串审核。
[--file-comment=<file-comment>] 添加到POT文件顶部的注释字符串。
[--package-name=<name>] 用于POT文件Project-Id-Version头部的包名。

常用示例

为当前目录的WordPress插件/主题创建POT文件

$ wp i18n make-pot . languages/my-plugin.pot

为WordPress核心的大洲和城市列表创建POT文件

$ wp i18n make-pot . continents-and-cities.pot --include="wp-admin/includes/continents-cities.php" --ignore-domain

为当前目录的WordPress主题创建带自定义头部的POT文件

$ wp i18n make-pot . languages/my-theme.pot --headers='{"Report-Msgid-Bugs-To":"https://github.com/theme-author/my-theme/","POT-Creation-Date":""}'