扫描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头部的包名。 |
$ wp i18n make-pot . languages/my-plugin.pot
$ wp i18n make-pot . continents-and-cities.pot --include="wp-admin/includes/continents-cities.php" --ignore-domain
$ wp i18n make-pot . languages/my-theme.pot --headers='{"Report-Msgid-Bugs-To":"https://github.com/theme-author/my-theme/","POT-Creation-Date":""}'