Docsbook
概要

他の言語へのドキュメント翻訳

ドキュメントを任意の言語に自動翻訳します。

必要: プレミアムサブスクリプション（1回限りの$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)

さらに 80 以上の言語に対応しています。

翻訳の有効化#

ステップ 1: プレミアムの確認#

翻訳はプレミアムサブスクリプションでのみ利用可能です。

  1. 設定を開く (Float Widget)
  2. ステータスを確認 — "Premium" と表示されるはずです
  3. Free の場合 — アップグレード

ステップ2：翻訳設定を開く#

  1. Float Widget → Settings をクリック
  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でスペイン語のドキュメントを見つけることができます。

他の言語へのトラフィック#

翻訳を追加することで、以下のことが可能になります。

  • 📈 訪問者の増加
  • 🌍 視聴者の拡大
  • 🔍 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 までお問い合わせください。

翻訳 FAQ#

Q: AI翻訳は間違っている可能性がありますか？

A: はい、時々あります。特に専門用語や特定のコンテンツの場合。翻訳を手動で編集できます。

Q: 翻訳にかかる時間はどれくらいですか？

A: 1～30分。量によって異なります。

Q: 翻訳を手動で編集できますか？

A: はい、翻訳をダウンロードして編集し、再度アップロードしてください。

Q: 珍しい言語が必要な場合はどうなりますか？

A: Docsbookは100以上の言語をサポートしています。特定の言語については、support@docsbook.io までお問い合わせください。

Q: 翻訳は無料ですか？

A: プレミアムサブスクリプションに含まれています。追加料金は発生しません。

Q: ドキュメントを更新すると、翻訳は更新されますか？

A: はい、次の更新時に自動的に更新されます。

次に何をするか?#

提供： Docsbook