---
title: AIでMkDocsサイトを翻訳 | Smartcat
description: AIでMkDocsサイトを翻訳し、文脈の中でレビューします。headブロックのテーマオーバーライドを通じてインストールします。
canonical: https://ja.smartcat.com/integrations/mkdocs/
language: ja
updated: 2026-11-16
---

# AIでMkDocsサイトを翻訳 | Smartcat

## AIを使ってあなたのMkDocsサイトを翻訳

SmartcatのウェブサイトスニペットをMkDocsプロジェクトに一度追加し、通常のパイプラインを通じてデプロイすれば、言語を公開する前にSmartcatで翻訳を確認できます。

- [無料トライアルを開始](https://smartcat.com/sign-up)

- [デモを予約](https://www.smartcat.com/book-a-demo/?mkdocs)

## MkDocsにSmartcatを追加する方法

公開されているMkDocsのURLからSmartcatウェブサイトプロジェクトを作成し、ターゲット言語を選択します。

head ブロックのテーマオーバーライドを通じて、生成された Smartcat スニペットをインストールします（extra_javascript はアセットのみを読み込みます）。

変更をデプロイし、公開されたサイトを開いてスニペットが存在することを確認します。

Smartcatのビジュアルエディターで翻訳を確認し、準備が整った言語を公開します。

## 生成されたHTMLを編集することなくMkDocsサイトを翻訳する

MkDocsの出典構成で統合を維持してください。extra_javascriptはJavaScriptアセットを読み込みますが、提供されたインストールにheadマークアップが必要な場合はテーマのオーバーライドが必要になることがあります。Material for MkDocsでは、インストールされたテーマパッケージを変更するのではなく、サポートされているテンプレート拡張を使用してください。

リビルドしてデプロイし、ナビゲーション、警告、コード例が含まれるガイドをレビューします。翻訳された警告はその重大度を維持する必要があり、コマンドの例は実行可能なままである必要があります。ウェブサイトの翻訳によって、Markdownの出典の2つ目のセットが生成されることはありません。

## 訪問者にとっての変更点、そしてMkDocsに残るもの

ウェブサイトの翻訳は、公開された読書体験に変更をもたらします。これにより、MkDocsリポジトリ内に翻訳された出典ファイル、メッセージカタログ、またはロケールビルドが作成されることはありません。

## 言語が公開される前のレビュー

機械翻訳は迅速に初稿を作成できます。Smartcatのビジュアルエディターでは、ページ上で翻訳された各列を確認し、モバイルで長くなりすぎる見出しを短縮し、用語集を使用して製品名やブランド名の一貫性を保つことができます。ページの承認が必要な場合はレビュー担当者を割り当て、準備が整った言語のみを公開します。

## よくある質問

### HTMLのscriptタグをextra_javascriptに貼り付けることはできますか？

extra_javascript はアセット設定であり、自由形式の HTML head フィールドではありません。サポートされている構造に従い、実際のマークアップが必要な場合はテーマオーバーライドを使用してください。

### 公開する前に翻訳を編集することはできますか？

はい。Smartcatのビジュアルエディターで言い回しを推敲して確認し、準備が整った言語を公開します。

### MkDocsで新しいページを追加するとどうなりますか？

新しいテキストは、Smartcatプロジェクトで選択された翻訳モードに従います。すべての新しいページで承認が必要な場合は、翻訳レビュー済みの翻訳を選択してください。自動モードでは、新しく検出されたテキストを翻訳できます。どちらのモードも、MkDocs内の出典コンテンツを変更することはありません。

MkDocsサイトをより多くの言語で公開する

スニペットを一度インストールし、文脈の中で翻訳を確認して、オーディエンスが必要としている言語を公開します。すべての[ウェブサイト統合](https://www.smartcat.com/integrations/category/website-translation/)を確認するか、[ウェブサイト翻訳者](https://www.smartcat.com/website-translator/)の仕組みをお読みください。

- [無料トライアルを開始](https://smartcat.com/sign-up)
