ブログダッシュボード

概要

generaltranslation ライブラリの概要

はじめに

generaltranslation は、翻訳やフォーマットのためのユーティリティ関数とクラスを備えた、GT の中核的な i18n ライブラリです。 通常は gt-next や gt-react などのフレームワーク向けパッケージと組み合わせて使用されますが、単体のライブラリとしても利用できます。

index.ts
import { GT } from 'generaltranslation';

const gt = new GT({
  apiKey: 'your-api-key',
  projectId: 'your-project-id',
  sourceLocale: 'en',
  targetLocale: 'es',
});

// コンテンツを翻訳
const result = await gt.translate('Hello, world!', 'es');
// "¡Hola, mundo!"

// 数値・日付・通貨をフォーマット
const formattedPrice = gt.formatCurrency(29.99, 'USD');
const formattedDate = gt.formatDateTime(new Date());
// "$29.99"
// "9/25/2025"

// ロケールを操作
const localeProps = gt.getLocaleProperties('fr-CA');
const isValid = gt.isValidLocale('de');
// { language: "fr", region: "CA", ... }
// true

インストール

npm install generaltranslation
yarn add generaltranslation
bun add generaltranslation
pnpm add generaltranslation

例

翻訳には大きく2つの種類があります。文字列翻訳とファイル翻訳です。

セットアップ

翻訳を有効にするには、プロジェクトIDとAPIキーを指定する必要があります。 詳しくは、constructor メソッドをご確認ください。

const gt = new GT({
  apiKey: 'your-api-key',
  projectId: 'your-project-id',
  targetLocale: 'es',
});

文字列の翻訳

詳しくは translate メソッドをご参照ください。

try {
  const result = await gt.translate('こんにちは、世界！');
  console.log(result); // "¡Hola, mundo!"
} catch (error) {
  console.error('翻訳に失敗しました：', error.message);
}

ファイルの翻訳

ファイルはジョブとして翻訳されます。 ファイルをアップロードするとジョブが開始されます。 複数のファイルをアップロードすると、その分だけ複数のジョブが開始されます。

詳細は uploadSourceFiles および checkFileTranslations メソッドをご参照ください。

// アップロード対象のファイル
const files = [
  {
    source: {
      fileName: 'src/components/Button.tsx',
      fileFormat: 'TSX',
      locale: 'en',
      content: '...',
    },
  },
];

// ソースファイルをアップロードする
await gt.uploadSourceFiles(files);

目次

GT クラス

翻訳および locale 機能を提供するメインクラス:

  • Constructor - 設定を用いて GT インスタンスを初期化します
  • setConfig - GT インスタンスの設定を更新します

翻訳メソッド

書式設定メソッド

ロケール関連メソッド

ユーティリティ関数

フォーマット関数

ロケール関数

型とインターフェース

TypeScript 定義:

次のステップ

フレームワーク別の利用方法は、Next.js または React のドキュメントを参照してください。

このガイドはいかがですか?

このページについて

はじめに
インストール
例
セットアップ
文字列の翻訳
ファイルの翻訳
目次
GT クラス
翻訳メソッド
書式設定メソッド
ロケール関連メソッド
ユーティリティ関数
フォーマット関数
ロケール関数
型とインターフェース
次のステップ