マークダウン

Lingo.dev CLIによるマークダウンファイルのAI翻訳

Markdownとは何ですか？

Markdownは、プレーンテキストの書式構文を使用して構造化されたドキュメントを作成する軽量のマークアップ言語です。ドキュメント、READMEファイル、ブログ、コンテンツ管理システムなどで広く使用されています。

例えば：


---

title: "製品発売ガイド"
description: "最新の製品機能について知っておくべきすべてのこと"
author: "製品チーム"

---

# 新しいダッシュボードへようこそ

ワークフローを効率化し、生産性を向上させるために設計された強力な新機能をご覧ください。

## はじめに

アカウントを設定し、プラットフォームを効果的に使い始めるための簡単な手順に従ってください。

![ダッシュボード概要のスクリーンショット](image.jpg)

Lingo.dev CLIとは何ですか？

Lingo.dev CLIは、AIでアプリやコンテンツを翻訳するための無料のオープンソースCLIです。従来の翻訳管理ソフトウェアに代わるものとして設計されており、既存のパイプラインと統合できます。

詳細については、概要をご覧ください。

このガイドについて

このガイドでは、Lingo.dev CLIを使用してMarkdownファイルを翻訳する方法を説明します。

以下の方法を学びます：

  • ゼロからプロジェクトを作成する
  • 翻訳パイプラインを設定する
  • AIで翻訳を生成する

前提条件

Lingo.dev CLIを使用するには、Node.js v18+がインストールされていることを確認してください：

❯ node -v
v22.17.0

ステップ1. プロジェクトのセットアップ

プロジェクトのディレクトリにi18n.jsonファイルを作成します：

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {}
}

このファイルは、どの言語間で翻訳するか、ローカライズ可能なコンテンツがファイルシステム上のどこに存在するかなど、翻訳パイプラインの動作を定義します。

利用可能なプロパティの詳細については、i18n.jsonをご覧ください。

ステップ 2. ソースロケールを設定する

_ソースロケール_とは、コンテンツが最初に書かれた元の言語と地域です。ソースロケールを設定するには、i18n.jsonファイル内のlocale.sourceプロパティを設定します：

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {}
}

ソースロケールはBCP 47言語タグとして提供する必要があります。

Lingo.dev CLIがサポートするロケールコードの完全なリストについては、サポートされているロケールコードを参照してください。

ステップ 3. ターゲットロケールを設定する

_ターゲットロケール_とは、コンテンツを翻訳したい言語と地域です。ターゲットロケールを設定するには、i18n.jsonファイル内のlocale.targetsプロパティを設定します：

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {}
}

ステップ 4. ソースコンテンツを作成する

まだ作成していない場合は、翻訳するコンテンツを含む1つ以上のMarkdownファイルを作成します。これらのファイルは、パスのどこかにソースロケールを含むパスに配置する必要があります（例：ディレクトリ名としてen/や、ファイル名の一部としてmessages.en.mdなど）。

ステップ 5. バケットを作成する

  1. i18n.jsonファイルのbucketsオブジェクトに"markdown"オブジェクトを追加します：

    {
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "markdown": {}
  }
}

  2. "markdown"オブジェクト内で、1つ以上のincludeパターンの配列を定義します：

    {
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "markdown": {
      "include": ["./[locale]/example.md"]
    }
  }
}

    これらのパターンは、翻訳するファイルを定義します。

    パターン自体は：

    • 設定されたロケールのプレースホルダーとして[locale]を含む必要があります
    • ファイルパスを指定できます（例："[locale]/docs.md"）
    • ワイルドカードプレースホルダーとしてアスタリスクを使用できます（例："[locale]/*.md"）

    再帰的なグロブパターン（例：**/*.md）はサポートされていません。

ステップ 6. LLMを設定する

Lingo.dev CLIは大規模言語モデル（LLM）を使用してAIでコンテンツを翻訳します。これらのモデルを使用するには、サポートされているプロバイダーからAPIキーが必要です。

できるだけ早く始めるために、毎月10,000トークンの無料使用量を提供する当社独自のホスト型プラットフォームLingo.dev Engineの使用をお勧めします：

  1. Lingo.devアカウントにサインアップする。

  2. 次のコマンドを実行します：

    npx lingo.dev@latest login

    これによりデフォルトのブラウザが開き、認証を求められます。

  3. 画面の指示に従ってください。

ステップ 7. 翻訳を生成する

i18n.jsonファイルが含まれているディレクトリで、次のコマンドを実行します：

npx lingo.dev@latest run

このコマンドは以下を行います：

  1. i18n.jsonファイルを読み込みます。
  2. 翻訳が必要なファイルを見つけます。
  3. ファイルから翻訳可能なコンテンツを抽出します。
  4. 設定されたLLMを使用して抽出されたコンテンツを翻訳します。
  5. 翻訳されたコンテンツをファイルシステムに書き戻します。

翻訳が初めて生成されるとき、i18n.lockファイルが作成されます。このファイルは、どのコンテンツが翻訳されたかを追跡し、後続の実行で不要な再翻訳を防ぎます。

例

en/example.md


---

title: "製品リリースガイド"
description: "最新の製品機能について知っておくべきすべてのこと"
author: "製品チーム"
date: 2024-01-15
tags: ["apples", "bananas", "pears"]

---

# 新しいダッシュボードへようこそ

ワークフローを効率化し、生産性を向上させるために設計された強力な新機能をご覧ください。

## はじめに

アカウントを設定し、プラットフォームを効果的に使用し始めるには、次の簡単な手順に従ってください。

---

当社の高度な分析機能により、自信を持ってデータ駆動型の意思決定を行うことができます。

![ダッシュボード概要のスクリーンショット](image.jpg)

直感的なインターフェースにより、さまざまな機能やツール間の移動が簡単に行えます。

[ドキュメントを見る](https://example.com)

始めるにあたってサポートが必要ですか？サポートチームが24時間365日対応しています。

***

当社のプラットフォームでビジネスを変革した何千もの満足顧客に加わりましょう。

es/example.md


---

title: Guía de lanzamiento de producto
description: Todo lo que necesitas saber sobre las últimas características de
  nuestro producto
author: Equipo de producto
date: 2024-01-15
tags:
  - apples
  - bananas
  - pears

---

# Bienvenido a nuestro nuevo panel de control

Descubre nuevas y potentes funciones diseñadas para optimizar tus flujos de trabajo y aumentar la productividad.

## Primeros pasos

Sigue estos sencillos pasos para configurar tu cuenta y comenzar a utilizar nuestra plataforma de manera efectiva.

---

Nuestros análisis avanzados te ayudan a tomar decisiones basadas en datos con confianza.

![Captura de pantalla de la visión general del panel](image.jpg)

La interfaz intuitiva facilita la navegación entre diferentes funciones y herramientas.

[Ver documentación](https://example.com)

¿Necesitas ayuda para empezar? Nuestro equipo de soporte está disponible 24/7 para asistirte.

---

Únete a miles de clientes satisfechos que han transformado su negocio con nuestra plataforma.

i18n.json

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "markdown": {
      "include": ["./[locale]/example.md"]
    }
  }
}

i18n.lock

version: 1
checksums:
  eed9ef23a605b747d38b8916cee1d500:
    md-section-0: d53f61b8c8922fb62d9df5678d9b44a8
    md-section-1: 98aec271471bedce0e12b530c7060827
    md-section-2: 9e5a786192608844493dfbb6e4100886
    md-section-3: 1a5299c38bb20c1b8af0e64e33d7b2b0
    md-section-4: 51adf33450cab2ef392e93147386647c
    md-section-5: e56cc804e3e06b5f5fb2484e88c18adc
    md-section-6: 0ea86a3338305070c865e8fe138da890
    md-section-7: bbabf7f391569a72099001e3d81eb251
    md-section-8: 36cbfd93f42528edce4faac2ac3c2c12
    md-section-9: a1c50054ab23d70be8d453789b214580
    md-section-10: 51adf33450cab2ef392e93147386647c
    md-section-11: cb596c9608828f7b87a0ab8fa37beb07
    fm-attr-title: f3469c4e3d3377c39a705c844930b3a5
    fm-attr-description: 2e988d98001e44997a3f5fa3fb487ca6
    fm-attr-author: ec8c8711fce61265a4fe296ce2ba3b6f
    fm-attr-tags: 313ac6f17ee08e4f4a6a2ca95e5ae024