---
title: "Angular クイックスタート"
description: "Angular アプリの ngx-translate ロケールファイルを verbatra で翻訳します。インストールから最初のドイツ語の文字列が画面に出るまでを説明します。"
type: "tutorial"
---
# Angular クイックスタート

Angular アプリの ngx-translate ロケールファイルを verbatra で翻訳します。インストールから最初のドイツ語の文字列が画面に出るまでを説明します。

このページを終えると、Angular アプリに、verbatra が `src/assets/i18n/en.json` から翻訳したドイツ語の文字列が表示されます。以降の実行では、ロックファイルのおかげで変更された分だけが翻訳されます。必要なものは、Node.js `^22.22.0 || >=24`、Angular プロジェクト、10 分ほどの時間です。最初の 4 つの手順には、アカウントも API キーも必要ありません。

すでにロケールファイルとコーディングエージェントがある場合は、代わりに [AI エージェントで verbatra をセットアップする](https://verbatra.kreitz-webdev.de/ja/docs/start-with-ai.md)のプロンプトをエージェントに渡します。エージェントはプロジェクトにあるファイルに合わせて作業し、費用が発生する前に止まります。

## 手順 [#手順]

<Steps>
<Step>

### CLI をインストールする [#cli-をインストールする]

```bash
npm install --save-dev @verbatra/cli
```

verbatra は開発用のツールで、アプリに同梱されることはありません。以下のコマンドは `npx` を使います。pnpm、yarn、bun を使う場合は、代わりに `pnpm verbatra`、`yarn verbatra`、`bun run verbatra` を実行します。

</Step>
<Step>

### ソースロケールファイルを追加する [#ソースロケールファイルを追加する]

`src/assets/i18n/en.json` がすでにある場合は、この手順を飛ばします。ない場合は、文字列を 2 つ入れて作成します。そのうち 1 つにはプレースホルダーを含めます。

```json title="src/assets/i18n/en.json"
{
  "greeting": "Hello, {{name}}!",
  "cart": {
    "empty": "Your cart is empty."
  }
}
```

</Step>
<Step>

### 設定ファイルを作成する [#設定ファイルを作成する]

```bash
npx @verbatra/cli init --format ngx-translate-json --provider gemini --yes
```

`--format` の `ngx-translate-json` は、`@ngx-translate/core` のファイルフォーマットです。`init` はロケールファイルを探し、まだない場合はパターン `src/assets/i18n/{locale}.json` を書き込みます。`--yes` を付けると、`init` が検出した内容をそのまま採用し、質問を表示しません。作成された `verbatra.config.ts` は `en` から `de` へ翻訳します。言語を増やすには、`targetLocales` にコードを追加します。

</Step>
<Step>

### API キーなしで実行をプレビューする [#api-キーなしで実行をプレビューする]

```bash
npx @verbatra/cli translate --dry-run
```

```text output
verbatra: dry run over 1 locale, no provider call
verbatra: de done, 2 would translate
verbatra translate (dry run)
  de: 2 would translate, 0 unchanged
1 succeeded, 0 partial, 0 failed (dry run: nothing written)
[ok] dry run done in 0.0s, nothing written
next: verbatra translate (run it for real)
```

ドライランはプロバイダーを生成しません。そのため API キーは不要で、費用はかからず、何も書き込まれません。

</Step>
<Step>

### 翻訳する [#翻訳する]

```bash
cp .env.example .env
```

`.env` を開き、`GEMINI_API_KEY=` の後ろに API キーを貼り付けます。まだ API キーがない場合、Gemini には無料枠があります。[Google AI Studio](https://aistudio.google.com/apikey) で作成します。ほかのプロバイダーとその環境変数は、[プロバイダー](https://verbatra.kreitz-webdev.de/ja/docs/providers.md)にあります。

```bash
npx @verbatra/cli translate
```

verbatra は 2 つの文字列を Gemini に送り、すべてのプレースホルダーが残っているかをチェックして、`src/assets/i18n/de.json` を書き込みます。表現はモデルによって変わります。たとえば次のようになります。

```json title="src/assets/i18n/de.json"
{
  "greeting": "Hallo, {{name}}!",
  "cart": {
    "empty": "Dein Warenkorb ist leer."
  }
}
```

</Step>
<Step>

### すべてのロケールが同期していることを確認する [#すべてのロケールが同期していることを確認する]

```bash
npx @verbatra/cli check
```

```text output
[ok] checking the locales (0.0s)
verbatra check
  de: 0 missing, 0 stale, 2 up-to-date (in sync)
all locales in sync
```

`check` はプロバイダーを呼び出さず、ロケールが同期していなければ終了コード `1` で終了します。そのため、pull request をゲートで止められます。

</Step>
<Step>

### アプリでロケールを読み込む [#アプリでロケールを読み込む]

`@ngx-translate/core` を追加します。

```bash
npm install @ngx-translate/core @ngx-translate/http-loader
```

次に、2 つのファイルを読み込み、あいさつを表示します。

```ts title="src/app/app.config.ts"
import { provideHttpClient } from "@angular/common/http";
import type { ApplicationConfig } from "@angular/core";
import { provideTranslateService } from "@ngx-translate/core";
import { provideTranslateHttpLoader } from "@ngx-translate/http-loader";

export const appConfig: ApplicationConfig = {
  providers: [
    // keep the providers the Angular CLI generated, and add:
    provideHttpClient(),
    provideTranslateService({
      lang: "de",
      fallbackLang: "en",
      loader: provideTranslateHttpLoader({ prefix: "./assets/i18n/", suffix: ".json" }),
    }),
  ],
};
```

```ts title="src/app/app.ts"
import { Component } from "@angular/core";
import { TranslatePipe } from "@ngx-translate/core";

@Component({
  selector: "app-root",
  imports: [TranslatePipe],
  template: `<p>{{ 'greeting' | translate: { name: 'Ada' } }}</p>`,
})
export class App {}
```

```jsonc title="angular.json"
// projects.<name>.architect.build.options
"assets": [
  { "glob": "**/*", "input": "public" },
  { "glob": "**/*", "input": "src/assets", "output": "assets" }
]
```

アプリを起動すると、あいさつが `Hallo, Ada!` と表示されます。

</Step>
</Steps>

## ここで起きたこと [#ここで起きたこと]

- `verbatra.lock.json` が各ソース文字列のハッシュを記録します。そのため、次回の実行では新しい文字列と変更された文字列だけが送られます。[ロックファイルと来歴](https://verbatra.kreitz-webdev.de/ja/docs/the-lock-file.md)を参照してください。
- プレースホルダーが失われた結果は保留され、書き込まれません。[翻訳の安全性](https://verbatra.kreitz-webdev.de/ja/docs/translation-safety.md)を参照してください。

ロケールファイル、`verbatra.lock.json`、`verbatra.provenance.json` は、まとめてコミットします。

## 任意：コーディングエージェントを接続する [#任意コーディングエージェントを接続する]

<AvailableFrom version="0.12.0" />

```bash
npx @verbatra/cli init --agent
```

設定ファイルがすでにある場合、`init --agent` は変更を加えず、エージェント用のファイルだけを追加します。追加されるのは、`AGENTS.md` の verbatra のルール（指示ファイルが `CLAUDE.md` だけの場合は `CLAUDE.md`）と、検出した各コーディングエージェントのプロジェクト設定に登録する verbatra MCP サーバー（課金はオフ）です。どのエージェントにどのファイルを書き込むか、また `--client` でエージェントを自分で指定する方法は、[コーディングエージェントを設定する](https://verbatra.kreitz-webdev.de/ja/docs/cli/init.md#コーディングエージェントを設定する)にあります。`--dry-run` を付けると、ファイルを書き込まずに表示します。

CLI を使わずに、MCP サーバーだけを VS Code のユーザープロファイルに追加することもできます。どちらか一方の方法だけを使い、両方は使わないでください。

[VS Code に追加](vscode:mcp/install?%7B%22name%22%3A%22verbatra%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40verbatra%2Fmcp%22%5D%7D)

## 次のステップ [#次のステップ]

<Cards>
  <Card title="言語を追加する" href="https://verbatra.kreitz-webdev.de/ja/docs/add-a-language.md" description="ターゲットロケールを追加し、1 回の実行で埋めます。" />
  <Card title="CI で verbatra を実行する" href="https://verbatra.kreitz-webdev.de/ja/docs/ci-and-exit-codes.md" description="ロケールがドリフトしたら pull request を失敗させます。" />
  <Card title="技術スタックを選ぶ" href="https://verbatra.kreitz-webdev.de/ja/docs/pick-your-stack.md" description="ほかのすべてのフレームワークのフォーマット ID とファイルのレイアウト。" />
</Cards>
