WP-CLI 是 WordPress 的命令行工具，允许你通过命令行界面管理 WordPress 安装和操作。它可以用来执行各种任务，包括生成 .pot 文件、安装和更新插件、管理用户等等。
安装 WP-CLI
你可以按照以下步骤安装 WP-CLI：
- 下载 WP-CLI PHAR 文件：
|
1 |
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar |
- 检查 PHAR 文件是否正常工作：
|
1 |
php wp-cli.phar --info |
- 将 PHAR 文件设置为可执行文件并移动到系统路径：
|
1 2 |
chmod +x wp-cli.phar sudo mv wp-cli.phar /usr/local/bin/wp |
- 确认 WP-CLI 安装成功：
|
1 |
wp --info |
使用 WP-CLI 生成 .pot 文件
以下是使用 WP-CLI 生成 .pot 文件的步骤：
- 进入主题或插件目录：
|
1 |
cd /path/to/your/theme-or-plugin |
- 运行
wp i18n make-pot命令：
|
1 |
wp i18n make-pot . languages/your-theme-or-plugin.pot |
这将在当前目录下扫描所有 PHP 文件，并在 languages 目录下生成 your-theme-or-plugin.pot 文件。
示例
假设你的主题目录结构如下：
|
1 2 3 4 |
my-theme/ ├── functions.php ├── style.css └── languages/ |
- 进入主题目录：
|
1 |
cd /path/to/my-theme |
- 运行 WP-CLI 命令生成
.pot文件：
|
1 |
wp i18n make-pot . languages/my-theme.pot |
这将在 languages 目录下生成 my-theme.pot 文件。
配置 WP-CLI 扫描选项
你可以通过 wp i18n make-pot 命令的一些选项来自定义扫描和生成 .pot 文件的行为。例如：
- 排除特定文件或目录：
|
1 |
wp i18n make-pot . languages/my-theme.pot --exclude=vendor,tests |
- 指定域名：
|
1 |
wp i18n make-pot . languages/my-theme.pot --domain=my-theme |
使用生成的 .pot 文件创建翻译
- 下载并安装 Poedit。
- 打开 Poedit，选择“创建新翻译”。
- 选择生成的
.pot文件。 - 选择目标语言（如中文）。
- 翻译每个字符串并保存。Poedit 会生成
.po和.mo文件。
将翻译文件上传到主题或插件
将生成的 zh_CN.po 和 zh_CN.mo 文件上传到主题或插件的 languages 文件夹中：
|
1 2 3 4 5 6 |
my-theme/ ├── functions.php ├── style.css └── languages/ ├── zh_CN.po ├── zh_CN.mo |
加载翻译文件
确保在主题的 functions.php 文件中正确加载语言文件：
|
1 2 3 4 |
function mytheme_setup() { load_theme_textdomain('my-theme', get_template_directory() . '/languages'); } add_action('after_setup_theme', 'mytheme_setup'); |
总结
通过以上步骤，你可以使用 WP-CLI 工具生成 .pot 文件，并通过 Poedit 创建和管理翻译文件。这样可以确保你的 WordPress 主题或插件能够支持多语言，并根据站点语言设置自动加载相应的翻译文件。
