ウェブサイト翻訳・ローカライズ： Base44 — 導入ガイド

1. 正しいプロジェクトを作成

GoLocal → New Project → Base44 で、公開先の正確なホストと必要な自分のプレビュードメインだけを登録します。元の言語は作成した UI の言語（例：英語）であり、訪問者や顧客データの言語ではありません。ウィジェットの言語と利用上限も確認します。公開プロジェクトキーのみを使用し、Base44 トークン・モデル・DB の秘密情報は使いません。Origin は管理者認証ではありません。

2. 許可された編集方法を選択

展開して README.txt を読みます。公式生成チャットに ai-editor-prompt.txt と helper/provider の実ファイルを一緒に渡し、差分を確認します。検証アカウントでは Code の手動編集と ZIP 出力は有料プランが必要で、生成は既存クレジットを使用しました。自分の権限を確認し、制限を回避したり、この手順だけのためにアップグレードしたりしないでください。

Base44 → Code Tab ↗

3. 公開範囲を明確に限定

２ファイルを同じ場所に置き、public-layout-example.jsx を既存の公開シェルに統合します。公開 DOM の後に provider を１つだけマウントします。#golocal-public は１つだけで、公開ナビゲーション・見出し・ページのみを含めます。非公開ルートとポータルは外側へ。顧客名・説明は収集前に data-user-content / data-gl-private、参照 ID は data-gl-record-id で除外します。汎用 body スクリプト追加や SDK 認証・ルーター置換は禁止です。

// Merge into your EXISTING PUBLIC shell; copy both supplied source files first.
import GoLocalPublicProvider from './integrations/GoLocalPublicProvider.jsx';

// Exactly one #golocal-public wraps only authored public content.
// Private routes/portals stay outside. Do not replace your router/auth gates.
// Mount once after the committed public DOM:
<GoLocalPublicProvider projectKey="YOUR_PROJECT_KEY" />

// Disable: remove this import/mount, rebuild, Publish and fully reload.
// The adapter pins runtime 1.3.2 + SRI; do not add another script.

<span>Source name</span>
<span data-user-content translate="no">Travail à domicile</span>
<div id="golocal-private-host" data-gl-private translate="no" />

4. 翻訳文ではなく ID で絞り込み

デモでは objects と nf-object-01 を維持し、フランス語では Objets と La Bouilloire n°4 を表示します。アプリ独自の公開検索は入力を書き換えず bouilloire を検索します。すべての Base44 入力の自動逆翻訳ではありません。Bubble の GoLocal Query は Base44 コンポーネントではありません。

en

Objects · The Kettle No. 4

fr

Objets · La Bouilloire n°4

ID / category

nf-object-01 / objects

Input → result

bouilloire → nf-object-01

6. 公開・検証・無効化

ビルドと差分確認後に明示的に Publish し、サンドボックスだけでなく公開 URL を再読み込みします。root・loader・widget 各１つ、runtime 1.3.2 と SRI を確認します。アクセント入力、保存済み名、絞り込み、SPA、遅延内容、手動修正、キャッシュ再訪問を検証します。無効化は provider の import/マウントだけを削除し、再ビルド・公開・完全再読み込みして GoLocal 通信ゼロを確認します。script タグ削除だけでは実行中のエンジンは止まりません。履歴の確認済みレイアウトを戻して再有効化します。

7. 対応範囲・費用・未検証項目

アダプターは無料、GoLocal SaaS と Base44 のホスティング・コード権限は別です。削除しても課金解約や翻訳削除は行いません。非公開 SDK の初回認証、認証境界を越える遅延応答、別アカウント、厳格 CSP、完全なアクセシビリティ、実機、広範な RTL は未検証です。ラボの非公開パネルは認証ではありません。SEO 用言語 URL、決済・メール翻訳、順位保証はなく、ネイティブ翻訳との二重処理を避けてください。

セキュリティ：ネイティブスキャナーは秘密情報露出に分類しましたが、説明では SRI はハッシュであり埋め込み秘密情報はないとしています。警告は却下せず保持しており、安全なスキャン完了の認証ではありません。SRI 無効化や SDK 認証の無検討な変更をせず、自分のアプリの報告を確認してください。