# General Translation Integrations: クイックスタート
URL: https://generaltranslation.com/ja/docs/integrations/paraglide/quickstart.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 各 Paraglide JS メッセージの周辺のソースコードを記録し、文脈として翻訳に送信します。

`@generaltranslation/paraglide-js` は、アプリ内で Paraglide JS メッセージが使われている箇所をすべて検出し、その周辺のコードを保存します。これにより、「Order」のようなメッセージも、ボタン・見出し・名詞・動詞のいずれなのかがわかるコードと一緒に翻訳へ渡されます。

このパッケージは原文ファイルを読み取るだけです。Paraglide JS に手を加えることはなく、バンドラーを実行することもないため、アプリのビルド方法にかかわらず動作します。

## 始める前に [#before-start]

以下が必要です。

* Node.js 20 以降
* Paraglide JS 1、2、または 3 (出力ディレクトリが生成されるよう、少なくとも一度コンパイルしておくこと) 
* inlang メッセージ形式 (`plugin.inlang.messageFormat`) で保存されたメッセージ (例：`messages/en.json`) 
* それらのメッセージファイルを CLI で翻訳するプロジェクト ([CLI クイックスタート](/docs/cli/quickstart)を参照) 
* JavaScript、TypeScript、JSX 以外のコンポーネントを使用する場合は、そのフレームワークの言語ツールがアプリにインストールされていること ([サポートされているファイル形式](/docs/integrations/paraglide/reference/file-formats)を参照)

## クイックスタート [#quickstart]

パッケージをインストールして文脈を収集したら、あとは通常どおり翻訳するだけです。

### 1. `@generaltranslation/paraglide-js` をインストールする

<Tabs items={['npm', 'yarn', 'bun', 'pnpm']}>
  <Tab value="npm">
    ```bash
    npm install --save-dev @generaltranslation/paraglide-js
    ```
  </Tab>

  <Tab value="yarn">
    ```bash
    yarn add --dev @generaltranslation/paraglide-js
    ```
  </Tab>

  <Tab value="bun">
    ```bash
    bun add --dev @generaltranslation/paraglide-js
    ```
  </Tab>

  <Tab value="pnpm">
    ```bash
    pnpm add --save-dev @generaltranslation/paraglide-js
    ```
  </Tab>
</Tabs>

### 2. 文脈を収集する

アプリのディレクトリで [`paraglide-context`](/docs/integrations/paraglide/reference/paraglide-context) を実行します。`--verbose` を指定すると、検出された使用箇所の数と、参照した Paraglide JS の出力ディレクトリが表示されます。

```bash
npx paraglide-context --verbose
```

ベースロケールの各メッセージファイルには、同じ場所にメタデータファイルが生成されます。使用されているメッセージごとに、その使用箇所の周辺コードがソースファイル単位で記録されます：

```json title="messages/en.metadata.json"
{
  "greeting": {
    "sourceCode": {
      "src/Header.tsx": [
        {
          "before": "import { m } from './paraglide/messages.js';\n…",
          "target": "  return <h1>{m.greeting({ username })}</h1>;",
          "after": "}\n…"
        }
      ]
    }
  }
}
```

<Callout type="info">
  警告には、スキップされた対象とその修正方法が表示されます。たとえば、解決できないインポートエイリアス、見つからない言語ツール、Paraglide JS の出力として認識されなかったディレクトリなどです ([インポートの解決](/docs/integrations/paraglide/guides/resolving-imports)を参照) 。
</Callout>

### 3. メッセージを翻訳する

[`gt translate`](/docs/cli/reference/commands/translate) を実行します。CLI は各メッセージファイルと同じ場所にあるメタデータファイルを検出し、メッセージとともに[キーごとのメタデータ](/docs/cli/reference/keyed-metadata)として送信します。

```bash
npx gt translate
```

文脈を常に最新の状態に保つため、翻訳を実行する前に毎回文脈を収集してください：

```json title="package.json"
{
  "scripts": {
    "translate": "paraglide-context && gt translate"
  }
}
```

<Callout type="info">
  文脈を追加しただけでは、メッセージは再翻訳されません。メッセージが再翻訳されるのは、原文が変更された場合のみです。
</Callout>

## Next steps

- /docs/integrations/paraglide/guides/resolving-imports
- /docs/integrations/paraglide/guides/adding-file-formats

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.