戻る

gt-next@6.14.0

Jackie Chen avatarJackie Chen
gt-nextgt-i18ngt-nodegt-tanstack-startversion-idhooki18n

概要

新しいuseVersionIdフックとgetVersionIdヘルパー関数が、すべてのGT JavaScriptパッケージで利用できるようになりました。これにより、実行時にGT設定から_versionIdを閲覧できます。デバッグ、キャッシュバスティング、ログ記録、現在有効な翻訳バージョンの追跡に役立ちます。

パッケージバージョンエクスポート
gt-next6.14.0useVersionId (クライアント + サーバー) , getVersionId (関数)
gt-i18n0.7.0getVersionId (関数)
gt-node0.4.0getVersionId (関数)
gt-tanstack-start0.2.0getVersionId (関数)
gt-i18n (Python)0.3.0get_version_id() (関数)
gt-fastapi0.3.0get_version_id() (関数)
gt-flask0.3.0get_version_id() (関数)

使い方

Next.js (クライアント)

import { useVersionId } from 'gt-next';

function DebugFooter() {
  const versionId = useVersionId();
  return <footer>Translation version: {versionId ?? 'unknown'}</footer>;
}

Next.js (サーバー)

import { useVersionId } from 'gt-next/server';

export default function Page() {
  const versionId = useVersionId();
  // server component、ロギング、ヘッダーなどで使用
}

Node / React を使わない場合

import { getVersionId } from 'gt-i18n';
// または: import { getVersionId } from 'gt-node';

console.log('Current translation version:', getVersionId());

Python (gt-fastapi / gt-flask)

from gt_i18n import get_version_id
# または: from gt_fastapi import get_version_id
# または: from gt_flask import get_version_id

print("Current translation version:", get_version_id())

version_id は initialize_gt() に直接渡すこともできます：

initialize_gt(version_id="abc123", ...)

設定

gt.config.json で _versionId を設定します。この値は、translate コマンドを実行すると、CLI (コマンドラインインターフェース) によって自動的に設定されます。

{
  "defaultLocale": "en",
  "locales": ["en", "es", "fr"],
  "_versionId": "abc123"
}

次に来るもの

ロケールとバージョン ID に実行時にアクセスできるようになったので、次のステップは アナリティクス追跡 です。これにより、開発者はアナリティクスイベントとあわせて、実際にどの翻訳がレンダリングされているかを可視化できるようになります。

計画しているのは、ハッシュ集約の導入です。<T>、gt()、m() のような翻訳コンポーネントが実行時に解決されるたびに、それらのハッシュを追跡可能なセットに収集します。新しい useAnalytics() フック により、開発者はアナリティクスイベントが発火した時点で、現在解決済みのハッシュのセットを参照でき、<AnalyticsScope> ラッパーにより、その収集範囲を React ツリーの特定の部分に限定できるようになります。