Docsbook
概览

向其他语言翻译文档

自动将您的文档翻译成任何语言。

必需：高级订阅（一次性 29 美元）

什么是自动翻译?#

Docsbook 可以将您所有的文档自动翻译成其他语言自动。

只需选择语言 — AI 会完成其余的工作。

示例：

Original documentation in English
                ↓
Select: Spanish, French, German
                ↓
All pages translated automatically
                ↓
Visitors see a language selection menu

支持的语言#

Docsbook 可以翻译成 100 多种语言：

主要语言：

  • 英语
  • Español (Spanish)
  • Français (French)
  • Deutsch (German)
  • Italiano (Italian)
  • Português (Portuguese)
  • Русский (Russian)
  • 日本語 (Japanese)
  • 中文 (Chinese)
  • 한국어 (Korean)
  • العربية (Arabic)
  • ภาษาไทย (Thai)

Plus 80+ other languages.

启用翻译#

步骤 1：检查高级版#

翻译仅在高级订阅中可用。

  1. 打开设置 (Float Widget)
  2. 检查状态 — 应显示“高级版”
  3. 如果免费 — 升级

步骤 2：打开翻译设置#

  1. 点击 Float Widget → 设置
  2. 找到 翻译语言

步骤 3：选择语言#

☑ English (default)
☐ Español
☐ Français
☐ Deutsch
☐ Italiano
☐ Português
☐ Русский
☐ 日本語
... and more
  1. 检查您需要的语言
  2. 点击保存
  3. Docsbook 开始翻译

步骤 4：等待#

翻译需要：

  • 小型文档（< 10 页）： 1-2 分钟
  • 中型（10-50 页）： 5-10 分钟
  • 大型（> 50 页）： 15-30 分钟

完成后 — 翻译版本将出现在网站上。

翻译是如何使用的？#

语言选择菜单#

您的站点将拥有一个语言选择器：

[EN ▼]  ← click to select another language

点击打开列表：

▼ English
  Español
  Français
  Deutsch
  Italiano

翻译后的页面 URL#

翻译后的页面可在不同的路径下找到：

English:  docs.example.com/page
Spanish:  docs.example.com/es/page
French:   docs.example.com/fr/page
German:   docs.example.com/de/page

什么会被翻译?#

  • ✅ 所有文本内容
  • ✅ 标题
  • ✅ 图片描述
  • ✅ 表格
  • ✅ 导航 (侧边栏)
  • ❌ 代码块 (保持不变)
  • ❌ URL 和链接 (保持不变)
  • ❌ 行内代码 (保持不变)

翻译质量#

它是如何工作的?#

使用人工智能 (Anthropic 的 Claude) 进行翻译。

质量: 适用于技术文档

翻译效果良好的内容:

  • 说明和指南
  • 技术解释
  • 列表和表格
  • 简单语言

可能需要编辑的内容:

  • 习语和表达
  • 文化参考
  • 特定俚语

示例翻译#

Original English:
"Getting started is a breeze. Just plug in your URL and boom,
you're done!"

Translated Spanish:
"Comenzar es muy fácil. Solo ingresa tu URL y listo, ¡hemos terminado!"

更新翻译#

翻译何时更新?#

当你更新文档时：

  1. 用英语编辑文件
  2. 提交到 GitHub
  3. Docsbook 发现更改
  4. 翻译更新到其他语言
  5. 完成！翻译版本已更新

这个过程是自动发生的，你不需要做任何事情。

如何手动更新?#

如果您想覆盖自动翻译：

  1. 下载翻译
  2. 编辑文件
  3. 上传回源
  4. Docsbook 使用您的版本

(如有疑问，请联系 support@docsbook.io)

SEO & Translations#

搜索引擎#

每种语言：

  • 完全被 Google 索引
  • 在搜索中拥有独立的页面
  • 自动添加 hreflang 标签

结果：说西班牙语的人可以在 Google 中用西班牙语找到您的文档。

Traffic to Other Languages#

添加翻译可以：

  • 📈 增加访问量
  • 🌍 扩大受众
  • 🔍 提高 SEO 排名

翻译的最佳实践#

1. 明确书写#

✅ Good (easy to translate):
"To install the package, run the command."

❌ Bad (hard to translate):
"Just pip this bad boy and you're golden!"

简洁明了的英语翻译效果更好。

2. 避免习语#

✅ Good:
"The setup process is simple."

❌ Bad:
"It's a piece of cake to set up."

习语在翻译时经常会丢失。

3. 使用结构#

✅ Good structure translates better:
- Short paragraphs
- Clear headings
- Lists and tables

4. 保持代码注释为英文#

# Good — keep English
def setup():
    """Configure the system."""
    pass
 
# Bad — mixing languages
def setup():
    """Configurar el sistema."""
    pass

5. 使用 ISO 日期格式#

✅ ISO format: 2024-03-25
❌ Local: 25/03/2024

ISO 格式在任何地方都一致。

管理翻译#

添加新的语言#

  1. 打开设置
  2. 点击“添加语言”
  3. 选择语言
  4. 保存

Docsbook 将当前页面翻译为新语言。

移除语言#

  1. 打开设置
  2. 点击 ✕ 旁边的语言
  3. 保存

该语言的页面将从网站中消失。历史记录会被保存并可以恢复。

更改默认语言#

默认语言为英语。要更改它：

  1. 打开设置
  2. 从默认语言中选择
  3. 保存

访客首先看到此语言。

URL 示例#

翻译网站的结构#

没有自定义域名：

docsbook.io/user/repo              — English
docsbook.io/user/repo/es           — Spanish
docsbook.io/user/repo/fr           — French
docsbook.io/user/repo/de/guides    — German (subpage)

带有自定义域名：

docs.example.com                    — English
docs.example.com/es                 — Spanish
docs.example.com/fr                 — French
docs.example.com/de/api/overview    — German (subpage)

按语言分析#

(即将内置)

目前可以通过 Google Analytics 跟踪：

  1. 将 GA 代码添加到网站
  2. 按 URL 过滤 (/es, /fr, /de)
  3. 查看按语言划分的流量

如有帮助，请联系 support@docsbook.io。

翻译常见问题#

Q: AI 翻译会出错吗？

A: 是的，有时会。尤其是在处理技术术语或特定内容时。您可以手动编辑翻译。

Q: 翻译需要多长时间？

A: 根据翻译量，需要 1 到 30 分钟。

Q: 我可以手动编辑翻译吗？

A: 是的，下载翻译，编辑，然后上传回系统。

Q: 如果我需要一种稀有语言怎么办？

A: Docsbook 支持 100 多种语言。如果需要特定语言，请联系 support@docsbook.io。

Q: 翻译是免费的吗？

A: 包含在 Premium 订阅中。无需额外费用。

Q: 当我更新文档时，翻译会更新吗？

A: 是的，将在下一次更新时自动更新。

下一步是什么?#

由...提供支持 Docsbook