196 lines
7.3 KiB
Markdown
196 lines
7.3 KiB
Markdown
# HTBD：基于百度翻译 API 的免费开源 Wordpress 多语言插件
|
|
|
|
[](https://github.com/hanyixuanten/HTBD)
|
|
|
|
HTBD 是一款 WordPress 多语言翻译插件，通过百度翻译开放平台 API，将网站中的文章、页面及其他内容翻译为不同语言，并为译文生成独立的语言访问地址。
|
|
|
|
插件会将翻译结果保存在服务器的 `{$wpdb->prefix}hyx_bd_translations` 表中。除非用户主动刷新翻译，否则同一内容在同一目标语言下只需翻译一次。启用改名后的插件时，已有 `{$wpdb->prefix}btranslate_translations` 数据会自动迁移，无需在每次访问页面时重复调用翻译 API，有助于减少 API 请求量并提高页面加载速度。
|
|
|
|
## 项目地址
|
|
|
|
- 插件主页：[https://www.vblg.top/index.php/archives/147](https://www.vblg.top/index.php/archives/147)
|
|
- GitHub 仓库：[https://github.com/hanyixuanten/HTBD](https://github.com/hanyixuanten/HTBD)
|
|
- WordPress 插件主页：[https://wordpress.org/plugins/hyx-translator-for-baidu-translate/](https://wordpress.org/plugins/hyx-translator-for-baidu-translate/)
|
|
|
|
> **审核状态：** HTBD 目前尚未通过 WordPress.org 插件目录审核，因此暂时无法直接通过 WordPress 后台插件市场安装。现阶段请从 GitHub 仓库下载并手动安装。
|
|
|
|
## 主要功能
|
|
|
|
### 百度翻译 API 集成
|
|
|
|
HTBD 使用百度翻译开放平台提供的翻译 API。用户可以在 WordPress 后台配置自己的 App ID 和密钥，由插件完成请求签名、翻译调用及错误处理。
|
|
|
|
### 文章和页面翻译
|
|
|
|
插件支持翻译 WordPress 文章与页面中的主要内容，包括：
|
|
|
|
- 标题
|
|
- 正文
|
|
- 摘要
|
|
- SEO 字段
|
|
- 图片替代文本
|
|
- 标签
|
|
- 分类目录
|
|
- 部分界面文本
|
|
|
|
### 多语言访问地址
|
|
|
|
HTBD 可以为不同语言生成独立的访问地址，支持：
|
|
|
|
- 语言子目录，例如 `/en/`、`/jp/`
|
|
- 不同语言绑定不同域名
|
|
- 根据配置生成对应语言的固定链接
|
|
|
|
### 翻译结果持久化
|
|
|
|
翻译完成后，结果会保存在 WordPress 服务器中。后续访问相同译文时，插件优先读取已经保存的结果，而不是重新请求百度翻译 API。
|
|
|
|
当原文发生变化时，对应译文会被标记为需要更新，从而避免继续使用与原文不一致的旧译文。
|
|
|
|
### WordPress 内容兼容
|
|
|
|
插件在翻译内容时会尽量保留：
|
|
|
|
- Gutenberg 区块标记
|
|
- HTML 结构
|
|
- Shortcode 短代码
|
|
- 占位符
|
|
- URL
|
|
- `<pre>` 和 `<code>` 元素内的代码内容（不翻译）
|
|
- 受保护的特殊内容
|
|
|
|
### 多语言 SEO
|
|
|
|
HTBD 为多语言页面提供必要的 SEO 支持，包括：
|
|
|
|
- 多语言固定链接
|
|
- Canonical URL
|
|
- `hreflang` 多语言链接
|
|
- 站点地图兼容
|
|
- SEO 字段翻译
|
|
|
|
### 失败回退
|
|
|
|
如果百度翻译 API 请求失败，插件不会使网站页面报错：
|
|
|
|
- 如果没有可用译文，则显示网站的源语言内容。
|
|
- 如果存在以前成功保存的译文，则继续使用旧译文。
|
|
|
|
## 快速开始
|
|
|
|
### 一、获取百度翻译 API
|
|
|
|
1. 打开[百度翻译开放平台](https://fanyi-api.baidu.com/)。
|
|
2. 注册或登录百度账号。
|
|
3. 进入管理控制台。
|
|
4. 开通通用文本翻译 API 服务。
|
|
5. 创建应用并填写应用信息。
|
|
6. 在应用管理页面获取 **APP ID** 和 **密钥**。
|
|
|
|
> APP ID 和密钥属于敏感信息，请勿提交到公开的 GitHub 仓库，也不要通过网页前端代码或公开日志暴露。
|
|
|
|
百度翻译 API 的具体开通方式、计费规则和调用限制，请参考[百度翻译 API 官方文档](https://fanyi-api.baidu.com/doc/23)。
|
|
|
|
### 二、安装插件
|
|
|
|
由于插件目前尚未通过 WordPress.org 审核，需要从 GitHub 手动安装。
|
|
|
|
#### 方法一：上传 ZIP 压缩包
|
|
|
|
1. 访问 [HTBD GitHub 仓库](https://github.com/hanyixuanten/HTBD)。
|
|
2. 点击 **Releases**。
|
|
3. 从最新版本下载 zip 文件 **hyx-translator-for-baidu-translate-*.zip**
|
|
4. 登录 WordPress 管理后台。
|
|
5. 打开“插件” → “安装插件”。
|
|
6. 点击“上传插件”。
|
|
7. 选择下载的 ZIP 文件并开始安装。
|
|
8. 安装完成后启用 HTBD。
|
|
|
|
#### 方法二：上传到服务器
|
|
|
|
1. 访问 [HTBD GitHub 仓库](https://github.com/hanyixuanten/HTBD)。
|
|
2. 点击 **Releases**。
|
|
3. 从最新版本下载 zip 文件 **hyx-translator-for-baidu-translate-*.zip**
|
|
4. 将 `hyx-translator-for-baidu-translate` 目录上传到 WordPress 的插件目录： `wp-content/plugins/hyx-translator-for-baidu-translate/`
|
|
5. 登录 WordPress 管理后台。
|
|
6. 打开“插件” → “已安装插件”。
|
|
7. 找到 HTBD 并点击“启用”。
|
|
|
|
### 三、配置插件
|
|
|
|
1. 登录 WordPress 管理后台。
|
|
2. 打开 HTBD 设置页面。
|
|
3. 填写百度翻译开放平台提供的 **APP ID** 和 **密钥**。
|
|
4. 设置网站的源语言，或勾选“自动识别源语言”以使用百度翻译的 `auto` 源语言模式。
|
|
5. 添加需要启用的目标语言。
|
|
6. 选择语言 URL 模式，例如语言子目录或域名绑定。
|
|
7. 保存设置。
|
|
|
|
修改语言路由设置后，建议在 WordPress 后台打开“设置” → “固定链接”，确认固定链接配置已经正确生效。
|
|
|
|
自动识别状态使用独立选项保存。未勾选自动识别时在源语言输入框中主动填写 `auto`，仍属于不同的配置状态。
|
|
|
|
### 四、开始使用
|
|
|
|
1. 在 WordPress 后台打开需要翻译的文章或页面。
|
|
2. 保存或更新内容。
|
|
3. 使用 HTBD 提供的翻译功能生成目标语言译文。
|
|
4. 等待翻译任务完成。
|
|
5. 通过对应语言的访问地址检查译文。
|
|
|
|
例如，假设源语言页面地址为：
|
|
|
|
```txt
|
|
https://example.com/about/
|
|
```
|
|
|
|
英语使用 `/en/` 子目录时，译文地址为：
|
|
|
|
```txt
|
|
https://example.com/en/about/
|
|
```
|
|
|
|
日语使用 `/jp/` 子目录时，译文地址为：
|
|
|
|
```txt
|
|
https://example.com/jp/about/
|
|
```
|
|
|
|
通过目标语言子目录或绑定域名请求 `wp-login.php`、`wp-admin` 时，插件会重定向到源站对应地址，并保留查询参数。
|
|
|
|
插件会优先使用已保存的译文。只有在原文发生变化、译文失效或用户主动要求刷新时，才需要重新调用翻译 API。
|
|
|
|
## 使用建议
|
|
|
|
- 正式启用前，请先在测试环境中检查固定链接和多语言路由。
|
|
- 为百度翻译 API 设置合理的调用额度和安全策略。
|
|
- 不要在源代码、前端 JavaScript或公开日志中保存 API 密钥。
|
|
- 发布译文前，建议人工检查品牌名、专业术语和重要页面。
|
|
- 修改原文后，应检查对应语言的译文是否需要更新。
|
|
- 配置域名绑定时，需要同时完成 DNS、HTTPS 证书和服务器域名设置。
|
|
- 修改语言路由后，请检查 Canonical URL、`hreflang` 和站点地图是否正确。
|
|
|
|
## 系统要求
|
|
|
|
- WordPress 6.4 或更高版本
|
|
- PHP 8.1 或更高版本
|
|
- 可正常访问百度翻译 API 的服务器网络环境
|
|
- 有效的百度翻译开放平台 APP ID 和密钥
|
|
|
|
## 问题反馈与贡献
|
|
|
|
如果在使用过程中遇到问题，或者希望提交功能建议，可以前往 GitHub 仓库反馈：
|
|
|
|
[https://github.com/hanyixuanten/HTBD](https://github.com/hanyixuanten/HTBD)
|
|
|
|
提交问题时，建议提供以下信息：
|
|
|
|
- WordPress 版本
|
|
- PHP 版本
|
|
- HTBD 版本
|
|
- 使用的语言和路由模式
|
|
- 问题复现步骤
|
|
- 已隐藏敏感信息的错误日志
|
|
|
|
欢迎通过 Issue 或 Pull Request 参与 HTBD 的改进。
|