일반 HTML 앱
단일 HTML 파일로 유지되는 인터랙티브 페이지에 이 경로를 사용하십시오. extract은(는) data-i18n* 마커를 strings.json(으)로 읽어들이고, translate-ui은(는) 로캘별로 하나의 플랫 JSON 번들을 생성하며, 브라우저 스크립트가 문자열을 적용합니다. 이 스크립트를 사용하면 이미지 파일 이름에 접미사를 추가하고 현재 페이지의 링크를 유지할 수도 있습니다.
로케일당 하나의 번역된 HTML 파일을 생성해야 하는 정적 사이트(런타임 없음, 교차 페이지 링크 재작성됨)의 경우, 대신 HTML 페이지를 사용하세요. 각 파일은 하나의 파이프라인에만 속합니다.
빠른 시작
ai-i18n-tools init -t ui-plain-html -P openai으로 스캐폴드하거나 아래 구성을 추가합니다. 리포지토리 README도 번역해야 하는 경우--with-readme을(를) 추가합니다(README 및 Markdown 문서에 i18n 추가).- 소스 HTML을 마크업합니다(또는
mark-html가 하도록 합니다). ui.sourceRoots및ui.uiExtractor.extensions가 해당 파일을 가리키도록 합니다.extract를 실행한 다음translate-ui을(를) 실행합니다(또는sync-ui으로 둘 다 실행합니다).- 페이지와 동일한 디렉터리에
i18n.js을(를) 복사하고 자체 스크립트보다 먼저 로드합니다. - HTTP를 통해 폴더를 서비스합니다.
file://은(는) 로캘 JSON을fetch할 수 없습니다.
ai-i18n-tools mark-html public/index.html --write
ai-i18n-tools extract
ai-i18n-tools translate-ui
# Equivalent to the previous two commands:
ai-i18n-tools sync-uiai-i18n-tools.config.json 예제:
{
"sourceLocale": "en",
"targetLocales": ["es", "fr", "pt-BR"],
"features": { "translateUIStrings": true },
"ui": {
"sourceRoots": ["public"],
"stringsJson": "public/strings.json",
"flatOutputDir": "public/locales",
"uiExtractor": { "extensions": [".html"] }
}
}스캐폴드는 translate-ui에서 사용하는 LLM 공급자 구성도 추가합니다. HTML 전용 설정이 잘 보이도록 위 예제에서는 생략했습니다.
extract은(는) strings.json을(를) 관리하고 ui-languages.json을(를) 기록합니다. translate-ui은(는) 대상 로캘 JSON 파일을 관리합니다. 생성된 이러한 파일을 수동으로 편집하지 마십시오.
flatOutputDir은(는) 생성된 로캘 파일이 저장되는 위치입니다. 스크립트의 data-locales-base은(는) 해당 디렉터리를 i18n.js(페이지가 아님) 기준 상대 URL로 가리켜야 합니다. public/i18n.js에서 ./locales 기준 경로를 사용하면 public/locales/pt-BR.json을(를) 로드합니다. 배포 하위 경로에서도 사이트가 정상적으로 작동하도록 상대 기준 경로를 사용하십시오.
런타임 가져오기
i18n.js은(는) 클래식 스크립트입니다(모듈이 아님). 다음 중 하나를 복사하십시오. 모두 동일한 파일입니다.
- 패키지 설치 후
node_modules/ai-i18n-tools/dist/html-runtime/i18n.js - examples/plain-html/public/i18n.js
- 런타임 소스 아래의 목록
<body>의 끝부분에서 로드한 다음 자체 스크립트를 로드합니다. <html>에 class="i18n-pending"을(를) 추가하고 해당 클래스가 설정되어 있는 동안 본문을 숨겨 원본 언어가 잠깐 표시되지 않도록 합니다.
<html lang="en" class="i18n-pending">
<head>
<style>
html.i18n-pending body { visibility: hidden; }
</style>
</head>
<body>
<!-- page -->
<script
src="i18n.js"
data-source-locale="en"
data-locales-base="./locales"
data-storage-key="ai-i18n-locale"
data-locale-select="#locale-select"
data-label-mode="native"
></script>
<script src="app.js"></script>
</body>
</html>필요에 따라 스크립트 속성을 조정하십시오:
| 속성 | 기본값 | 역할 |
|---|---|---|
data-source-locale | en | 영어 HTML을 유지하고 번들 가져오기를 건너뛰는 로캘 |
data-locales-base | ./locales | 스크립트 URL을 기준으로 확인되는 ui-languages.json 및 {locale}.json의 디렉터리 |
data-storage-key | ai-i18n-locale | localStorage 키 |
data-locale-select | (없음) | 매니페스트에서 채울 <select>의 CSS 선택기 |
data-locale-list | (없음) | 언어 링크로 채울 요소의 CSS 선택기 |
data-label-mode | native | native(매니페스트 label), english(englishName) 또는 both(다른 경우 englishName / label) |
window.i18n은(는) t(key), locale, dir, apply(), setLocale(code) 및 ready(Promise)를 노출합니다. 자체 스크립트에서 확인된 로캘이나 번역된 값에 의존하기 전에 ready을(를) 대기하십시오. 마킹된 새 요소를 삽입한 후 apply()을(를) 호출하십시오.
번역을 위한 HTML 마킹
베어 마커를 사용하는 것이 좋습니다. 소스 언어 텍스트는 요소에 남아 있으며, 해당 텍스트가 카탈로그 키가 됩니다. 이는 모든 언어가 될 수 있는 sourceLocale에 작성됩니다. extract이(가) 이를 읽고 런타임은 번역을 동일한 속성에 다시 씁니다.
data-i18n— 키는textContent입니다. 런타임이textContent을(를) 설정합니다.data-i18n-title— 키는title입니다.data-i18n-placeholder— 키는placeholder입니다.data-i18n-alt— 키는alt입니다.data-i18n-aria-label— 키는aria-label입니다.
하나의 요소에 이러한 마커를 여러 개 포함할 수 있습니다. 각 마커는 고유한 카탈로그 항목이 됩니다.
텍스트
콘텐츠가 텍스트로만 이루어진 요소에 data-i18n을(를) 배치합니다:
<title data-i18n>Plain HTML demo</title>
<h1 data-i18n>Plain HTML demo</h1>
<button type="button" data-i18n>Apply</button>
<option value="" data-i18n>All locales</option>
<th data-i18n>Filepath</th>
<figcaption data-i18n>Sample usage chart</figcaption>런타임은 <title> 요소의 document.title도 설정합니다. 혼합 콘텐츠 컨테이너에 data-i18n을(를) 배치하지 마십시오. 런타임이 textContent을(를) 할당하여 하위 요소를 제거하게 됩니다.
도구 설명
<select title="Filter by locale" data-i18n-title></select>컨트롤은 레이블과 도구 설명을 두 개의 키로 번역할 수 있습니다:
<button type="button" title="Clear the filters" data-i18n data-i18n-title>Clear</button>자리 표시자
<input type="search" placeholder="Filename (partial)" data-i18n-placeholder />동일한 필드의 자리 표시자 및 도구 설명:
<input
type="text"
placeholder="Filename (partial)"
title="Filter by filepath"
data-i18n-placeholder
data-i18n-title
/>대체 텍스트
<img src="chart.png" alt="Sample usage chart" width="577" height="139" data-i18n-alt />접근 가능한 이름
<button type="button" aria-label="Close dialog" data-i18n-aria-label>×</button>버튼 레이블 ×에는 data-i18n이(가) 없으므로 입력된 그대로 유지됩니다. 접근성 이름은 번역되는 문자열입니다.
혼합 콘텐츠
data-i18n은 요소의 전체 textContent을 읽습니다. 문장이 다른 요소와 같은 부모를 공유할 경우 각 텍스트 런을 다음처럼 래핑합니다:
<p>
<span data-i18n>Run</span> <code>mark-html</code>
<span data-i18n>to add bare markers.</span>
</p>
<label for="locale-select">
<span data-i18n>Language</span>
<select id="locale-select"></select>
</label>소스 언어만
data-i18n-ignore은 mark-html 및 UI 문자열 extract 모두에 대해 해당 요소와 하위 요소를 건너뜁니다. 샘플 행, 식별자, 브랜드 이름에 사용합니다:
<a
href="https://github.com/wsj-br/ai-i18n-tools"
aria-label="wsj-br/ai-i18n-tools on GitHub"
data-i18n-ignore
>
<span>wsj-br/ai-i18n-tools</span>
</a>
<tbody data-i18n-ignore>
<tr>
<td>public/index.html</td>
<td>pt-BR</td>
</tr>
</tbody>다른 카탈로그 키
값이 지정된 마커는 카탈로그 키를 명명합니다. 런타임은 여전히 번역을 요소(또는 명명된 속성)에 작성합니다:
<button type="button" data-i18n="Save changes">Save</button>
<img src="chart.png" alt="Chart" data-i18n-alt="Sample usage chart" />mark-html은 위의 베어 마커를 삽입합니다. --write을 전달하지 않는 한 드라이 런으로 실행됩니다. data-i18n-ignore 하위 트리, 코드 유사 요소(code, pre, kbd, samp, var), 그리고 비어 있거나 숫자로만 이루어진 텍스트는 건너뜁니다. 혼합 콘텐츠 부모를 보고하고 사용자가 <span data-i18n>(으)로 래핑할 수 있도록 남겨둡니다. 값이 지정된 마커는 절대 작성하지 않습니다.
에이전트 프롬프트
mark-html --write은(는) 이미 베어 마커를 삽입합니다. 보고서에 혼합 콘텐츠 상위 요소, JavaScript가 삽입하는 텍스트, 소스 언어로 유지되어야 하는 식별자 등 남은 항목이 여전히 나열되는 경우 다음을 붙여넣으세요.
# Finish plain-HTML markers after mark-html
## Context
ai-i18n-tools extracts the source-language text of elements that carry `data-i18n`, `data-i18n-title`, `data-i18n-placeholder`, `data-i18n-alt`, or `data-i18n-aria-label`. The visible text is the catalog key. Run `ai-i18n-tools mark-html <file> --write` first. This task only fixes what that command reports. Do not translate any string.
## Scope
Edit the HTML files under `ui.sourceRoots`. Skip text already marked, `data-i18n-ignore` subtrees, and code-like elements (`code`, `pre`, `kbd`, `samp`, `var`).
## Call shape
- Mixed-content parents: wrap each text run in `<span data-i18n>`. Do not put `data-i18n` on an element that also has child elements. The runtime assigns `textContent` and would remove those children.
- Text that JavaScript inserts: call `window.i18n.t("Source sentence")` and then `window.i18n.apply()` after the nodes exist. Await `window.i18n.ready` before reading the locale.
- Identifiers, code samples, and brand names: add `data-i18n-ignore` on the element (it covers descendants).
## Order
1. `ai-i18n-tools mark-html <file> --write`
2. Fix the leftovers above.
3. `ai-i18n-tools extract`
## Do not
- Do not translate, rename, or reword the source text.
- Do not write valued markers (`data-i18n="someKey"`) unless the visible text must differ from the catalog key.
- Do not hand-edit `strings.json`, locale JSON, or `ui-languages.json`.
- Do not change layout, ids, or behaviour.
## Verify
- `extract` lists the marked sentences.
- The page still shows the original copy in the source locale.
- A target locale changes those sentences after `translate-ui`, and mixed-content markup (links, `code`) is still in the DOM.
## Report back
List files changed, each string left unmarked and why, and any JavaScript-inserted sentence you were not sure was user-facing.런타임은 처음 실행될 때 각 소스 키를 내부 data-i18n-source 속성에 기록하므로, 나중에 로케일을 전환해도 여전히 영어 문자열을 조회합니다. 이러한 속성은 추출되지 않습니다.
로캘별 이미지 및 링크
이러한 마커는 번역기로 전송되지 않습니다. mark-html은 이를 추가하지 않습니다.
data-i18n-locale-src— 베어:chart.png은chart-pt-BR.png(으)로 변환됩니다(로캘 코드가 확장자 앞에 삽입됨). 값 지정: 값은 템플릿입니다.examples/plain-html은chart_{locale}.png을(를) 사용하며, 이는chart_pt-BR.png(으)로 변환됩니다.data-i18n-locale-href—?locale=을(를) 추가하여 링크가 동일한 HTML 파일에 유지되도록 합니다.
<img
src="chart.png"
alt="Sample usage chart"
data-i18n-alt
data-i18n-locale-src="chart_{locale}.png"
/>
<a href="about.html" data-i18n-locale-href>About</a>원본 로케일은 원본 URL을 유지합니다. data-i18n-locale-src의 경우, 절대 URL, 프로토콜 상대 URL, data: URL 및 # 프래그먼트는 그대로 유지되며, 쿼리 문자열과 프래그먼트도 제자리에 유지됩니다. 값 있는 마커는 모든 비원본 로케일에 대해 해당 템플릿을 사용하며 {locale}만 대체합니다. 지역화된 이미지가 404 오류를 반환하면, 런타임은 원본 src를 한 번 복원합니다. chart_pt-BR.png는 직접 제공해야 하며, 스크립트는 이를 생성하지 않습니다.
data-i18n-locale-href은 이 카탈로그 모델용입니다. about.pt-BR.html에 대한 링크는 HTML 페이지 파이프라인에 속합니다.
언어 선택기
data-locale-select을 빈 <select>에 지정합니다. 런타임은 ui-languages.json의 행당 하나의 <option>을 채웁니다(code, label, englishName, direction). 선택 항목을 변경하면 setLocale이 호출되어 선택 항목을 저장하고, ?locale=을 history.pushState으로 업데이트하며(다시 로드 없음), 번들을 가져오고, 모든 마커를 다시 적용하고, <html lang> 및 dir를 설정합니다. 뒤로 버튼은 URL의 로케일을 다시 적용합니다.
data-locale-list은 링크(lang, hreflang 및 활성 링크의 aria-current)에 대해서도 동일한 작업을 수행합니다. 이러한 링크는 카탈로그 페이지를 전환하며 문서 파이프라인에서 작성하는 파일별 링크가 아닙니다. 하나의 스크립트 태그로 두 선택기를 모두 설정할 수 있습니다:
<label for="locale-select">
<span data-i18n>Language</span>
<select id="locale-select" title="Switch UI language" data-i18n-title></select>
</label>
<nav id="locale-list"></nav>
<script
src="i18n.js"
data-source-locale="en"
data-locales-base="./locales"
data-locale-select="#locale-select"
data-locale-list="#locale-list"
data-label-mode="native"
></script>두 컨트롤을 모두 비워 둡니다. 이 매니페스트에서 data-label-mode="native"은 포르투갈어를 Português (Brasil)(으)로 레이블링합니다. english은 Portuguese (Brazil)(으)로 레이블링합니다. both은 두 이름이 다르므로 Portuguese (Brazil) / Português (Brasil)(으)로 레이블링합니다. ui-languages.json의 아래 스니펫을 참조하세요:
[
{
"code": "en",
"label": "English",
"englishName": "English",
"direction": "ltr"
},
{
"code": "pt-BR",
"label": "Português (Brasil)",
"englishName": "Portuguese (Brazil)",
"direction": "ltr"
}
]?locale=pt-BR을 사용하면 런타임이 select의 옵션과 목록의 하위 요소를 대체합니다. 해당 요소에 설정한 속성은 그대로 유지됩니다:
<select id="locale-select" title="Switch UI language" data-i18n-title>
<option value="en" lang="en">English</option>
<option value="pt-BR" lang="pt-BR" selected>Português (Brasil)</option>
</select>
<nav id="locale-list">
<a href="#" lang="en" hreflang="en">English</a>
<a href="#" lang="pt-BR" hreflang="pt-BR" aria-current="true">Português (Brasil)</a>
</nav>"direction": "rtl" 행은 해당 로캘이 활성 상태일 때 <html>에 dir="rtl"을(를) 설정합니다.
이 외에 navigator.language을 통한 자동 리디렉션을 설정하지 마십시오. 런타임은 URL과 localStorage에 선택 항목이 없을 때만 브라우저 언어를 사용하도록 이미 설정되어 있습니다. URL을 무시하는 리디렉션은 로케일 공유 및 페이지 크롤링을 어렵게 만듭니다.
ui-languages.json은 extract 또는 generate-ui-languages에 의해 languagesManifestPath에 기록됩니다(기본값 {ui.flatOutputDir}/ui-languages.json). 언어 전환기 및 RTL을 참조하십시오.
문제 해결
| 증상 | 확인할 사항 |
|---|---|
| 로캘 파일이 로드되지 않음 | 로컬 서버로 사이트를 엽니다. file://이 fetch을(를) 차단하면 런타임이 소스 텍스트로 폴백합니다. |
ui-languages.json에서 404 오류 | data-locales-base은 i18n.js에 대한 상대 경로입니다. flatOutputDir과 일치해야 합니다. |
{locale}.json에서 404 오류 발생 | 해당 로캘에 대해 translate-ui을(를) 실행하고 로캘 코드가 파일 이름과 정확히 일치하는지 확인합니다. |
/docs/에서 문자열이 영어로 유지됨 | 동일한 기본 경로 문제입니다. 로케일 디렉토리가 호스트 루트에 있지 않은 한 선행 /을 사용하지 마십시오. |
| 영어가 잠깐 표시된 후 번역됨 | <html>에 class="i18n-pending"을 추가하고 위의 가시성 규칙을 적용합니다. |
| 두 번째 전환 시 번역된 문자열이 키로 표시됨 | 배포된 i18n.js을 로드하십시오. 텍스트를 대체하기 전에 data-i18n-source을 저장합니다. |
| RTL 레이아웃이 반전되지 않음 | 매니페스트 행에 "direction": "rtl"이 필요합니다. 런타임은 <html>에만 dir을 설정합니다. |
| 새 DOM 노드가 영어로 유지됨 | 노드를 삽입한 후 window.i18n.apply()을 호출하십시오. |
포르투갈어에서 이미지가 chart.png(으)로 유지됨 | 요소에 data-i18n-locale-src이(가) 필요하며 로캘은 소스 로캘이 아니어야 합니다. |
런타임의 normalizeI18nText은(는) src/extractors/html-i18n-marks.ts의 normalizeI18nText과(와) 일치합니다. 즉, 공백을 자르고 축소합니다. 소스 언어 텍스트가 카탈로그 키이므로 번역이 누락된 경우 해당 소스 텍스트로 대체됩니다.
실행 가능한 데모는 examples/plain-html입니다. pnpm dev가 http://localhost:3090/?locale=pt-BR에서 이를 제공합니다.
런타임 소스
/* global document, window, localStorage, fetch, URLSearchParams, URL, history, navigator, PopStateEvent */
/**
* Drop-in catalog runtime for plain HTML.
*
* Classic script (not a module) so `document.currentScript` is available.
* Configure with data-* attributes on the script tag:
* data-source-locale, data-locales-base, data-storage-key,
* data-locale-select, data-locale-list, data-label-mode
*
* `data-locales-base` resolves against this script's URL, not the page URL.
* Put class="i18n-pending" on <html> and hide the body while that class is set
* to avoid a flash of source-locale text.
*/
(function () {
"use strict";
var TEXT_SOURCE_ATTR = "data-i18n-source";
function runtimeScript() {
if (document.currentScript) return document.currentScript;
var marked = document.querySelectorAll(
"script[data-ai-i18n-runtime], script[data-source-locale], script[data-locales-base]"
);
return marked.length > 0 ? marked[marked.length - 1] : null;
}
var scriptEl = runtimeScript();
function attr(name, fallback) {
if (!scriptEl) return fallback;
var value = scriptEl.getAttribute(name);
return value === null || value === "" ? fallback : value;
}
var SOURCE_LOCALE = attr("data-source-locale", "en");
var LOCALES_BASE_ATTR = attr("data-locales-base", "./locales");
var STORAGE_KEY = attr("data-storage-key", "ai-i18n-locale");
var SELECT_SEL = attr("data-locale-select", "");
var LIST_SEL = attr("data-locale-list", "");
var LABEL_MODE = attr("data-label-mode", "native");
function resolveLocalesBase() {
var baseUrl = scriptEl && scriptEl.src ? scriptEl.src : window.location.href;
return new URL(LOCALES_BASE_ATTR, baseUrl).href.replace(/\/$/, "");
}
var LOCALES_BASE = resolveLocalesBase();
var I18N = { locale: SOURCE_LOCALE, dir: "ltr", bundle: {} };
var languages = [];
var titleKey = "";
var selectBound = false;
/**
* Collapse insignificant whitespace. MUST stay identical to `normalizeI18nText`
* in `src/extractors/html-i18n-marks.ts` and `src/dashboard-app/app.js`.
*/
function normalizeI18nText(s) {
return s.trim().replace(/\s+/g, " ");
}
function normalizeLocaleCode(code) {
if (!code) return "";
var parts = String(code).split("-");
if (parts.length === 1) return parts[0].toLowerCase();
return parts[0].toLowerCase() + "-" + parts.slice(1).join("-");
}
function isSourceLocale(locale) {
return normalizeLocaleCode(locale) === normalizeLocaleCode(SOURCE_LOCALE);
}
function t(key) {
var raw = I18N.bundle[key];
return typeof raw === "string" && raw.length > 0 ? raw : key;
}
function findLanguage(code) {
var norm = normalizeLocaleCode(code);
for (var i = 0; i < languages.length; i++) {
if (normalizeLocaleCode(languages[i].code) === norm) return languages[i];
}
return undefined;
}
function resolveLocale() {
var params = new URLSearchParams(window.location.search);
var fromUrl = params.get("locale");
if (fromUrl) return fromUrl;
try {
var stored = localStorage.getItem(STORAGE_KEY);
if (stored) return stored;
} catch {
/* private mode */
}
var browser = navigator.language || (navigator.languages && navigator.languages[0]) || SOURCE_LOCALE;
var match = findLanguage(browser);
return match ? match.code : SOURCE_LOCALE;
}
function loadJson(url) {
return fetch(url, { cache: "no-store" }).then(function (res) {
return res.ok ? res.json() : null;
});
}
function labelFor(row) {
var native = row.label || row.code;
var english = row.englishName || native;
if (LABEL_MODE === "english") return english;
if (LABEL_MODE === "both") return english === native ? english : english + " / " + native;
return native;
}
function sourceAttrName(attrName) {
return attrName ? TEXT_SOURCE_ATTR + "-" + attrName : TEXT_SOURCE_ATTR;
}
function rememberKey(el, attrName, marker) {
var stored = el.getAttribute(sourceAttrName(attrName));
if (stored) return stored;
var valued = el.getAttribute(marker);
var key = valued
? valued
: attrName
? normalizeI18nText(el.getAttribute(attrName) || "")
: normalizeI18nText(el.textContent || "");
if (key) el.setAttribute(sourceAttrName(attrName), key);
return key;
}
function applyTextMarkers(selector, attrName, write) {
var marker = attrName ? "data-i18n-" + attrName : "data-i18n";
document.querySelectorAll(selector).forEach(function (el) {
var key = rememberKey(el, attrName, marker);
if (key) write(el, t(key));
});
}
function isSkippableUrl(url) {
return /^(?:[a-z][a-z0-9+.-]*:|\/\/|#)/i.test(url);
}
function withLocaleSuffix(url, locale) {
if (!url || isSourceLocale(locale) || isSkippableUrl(url)) return url;
var hash = url.indexOf("#");
var fragment = hash >= 0 ? url.slice(hash) : "";
var pathQuery = hash >= 0 ? url.slice(0, hash) : url;
var q = pathQuery.indexOf("?");
var path = q >= 0 ? pathQuery.slice(0, q) : pathQuery;
var query = q >= 0 ? pathQuery.slice(q) : "";
return path.replace(/(\.[^./]+)$/, "-" + locale + "$1") + query + fragment;
}
function applyLocaleTemplate(template, locale) {
return template.split("{locale}").join(locale);
}
function withLocaleQuery(url, locale) {
if (!url || isSourceLocale(locale) || isSkippableUrl(url)) return url;
var next = new URL(url, window.location.href);
next.searchParams.set("locale", locale);
if (/^(?:[a-z][a-z0-9+.-]*:|\/\/)/i.test(url)) return next.href;
return next.pathname + next.search + next.hash;
}
function applyLocaleSrc() {
document.querySelectorAll("[data-i18n-locale-src]").forEach(function (el) {
var baseAttr = "data-i18n-locale-src-base";
var raw = el.getAttribute(baseAttr);
if (raw === null) {
raw = el.getAttribute("src") || "";
el.setAttribute(baseAttr, raw);
}
var valued = el.getAttribute("data-i18n-locale-src") || "";
var next = raw;
if (!isSourceLocale(I18N.locale)) {
next = valued ? applyLocaleTemplate(valued, I18N.locale) : withLocaleSuffix(raw, I18N.locale);
}
if (next) el.setAttribute("src", next);
if (el.tagName === "IMG" && !el.hasAttribute("data-i18n-src-fallback-bound")) {
el.setAttribute("data-i18n-src-fallback-bound", "");
el.addEventListener("error", function onErr() {
var original = el.getAttribute(baseAttr);
if (original && el.getAttribute("src") !== original) el.setAttribute("src", original);
el.removeEventListener("error", onErr);
});
}
});
}
function applyLocaleHref() {
document.querySelectorAll("[data-i18n-locale-href]").forEach(function (el) {
var baseAttr = "data-i18n-locale-href-base";
var raw = el.getAttribute(baseAttr);
if (raw === null) {
raw = el.getAttribute("href") || "";
el.setAttribute(baseAttr, raw);
}
el.setAttribute("href", isSourceLocale(I18N.locale) ? raw : withLocaleQuery(raw, I18N.locale));
});
}
function applyStaticI18n() {
applyTextMarkers("[data-i18n]", "", function (el, text) {
el.textContent = text;
});
applyTextMarkers("[data-i18n-title]", "title", function (el, text) {
el.setAttribute("title", text);
});
applyTextMarkers("[data-i18n-placeholder]", "placeholder", function (el, text) {
el.setAttribute("placeholder", text);
});
applyTextMarkers("[data-i18n-alt]", "alt", function (el, text) {
el.setAttribute("alt", text);
});
applyTextMarkers("[data-i18n-aria-label]", "aria-label", function (el, text) {
el.setAttribute("aria-label", text);
});
applyLocaleSrc();
applyLocaleHref();
if (titleKey) document.title = t(titleKey);
}
function fillSelect(select) {
var previous = select.value;
select.replaceChildren();
languages.forEach(function (row) {
var opt = document.createElement("option");
opt.value = row.code;
opt.textContent = labelFor(row);
opt.lang = row.code;
if (normalizeLocaleCode(row.code) === normalizeLocaleCode(I18N.locale)) opt.selected = true;
select.appendChild(opt);
});
if (!select.value && previous) select.value = previous;
if (!selectBound) {
selectBound = true;
select.addEventListener("change", function () {
void setLocale(select.value);
});
}
}
function fillList(list) {
list.replaceChildren();
languages.forEach(function (row) {
var link = document.createElement("a");
link.href = "#";
link.textContent = labelFor(row);
link.lang = row.code;
link.hreflang = row.code;
var active = normalizeLocaleCode(row.code) === normalizeLocaleCode(I18N.locale);
if (active) link.setAttribute("aria-current", "true");
link.addEventListener("click", function (event) {
event.preventDefault();
void setLocale(row.code);
});
list.appendChild(link);
});
}
function renderSelectors() {
if (SELECT_SEL) {
var select = document.querySelector(SELECT_SEL);
if (select) fillSelect(select);
}
if (LIST_SEL) {
var list = document.querySelector(LIST_SEL);
if (list) fillList(list);
}
}
function syncUrl(locale) {
var url = new URL(window.location.href);
if (isSourceLocale(locale)) url.searchParams.delete("locale");
else url.searchParams.set("locale", locale);
history.pushState({ locale: locale }, "", url.pathname + url.search + url.hash);
}
function setLocale(code, opts) {
var push = !opts || opts.push !== false;
I18N.locale = code;
var langRow = findLanguage(code);
I18N.dir = langRow && langRow.direction === "rtl" ? "rtl" : "ltr";
var bundlePromise = isSourceLocale(code)
? Promise.resolve(null)
: loadJson(LOCALES_BASE + "/" + encodeURIComponent(code) + ".json");
return bundlePromise.then(function (bundle) {
I18N.bundle = bundle && typeof bundle === "object" && !Array.isArray(bundle) ? bundle : {};
document.documentElement.setAttribute("lang", (langRow && langRow.code) || code);
document.documentElement.setAttribute("dir", I18N.dir);
try {
localStorage.setItem(STORAGE_KEY, code);
} catch {
/* private mode */
}
applyStaticI18n();
renderSelectors();
if (push) syncUrl(code);
document.documentElement.classList.remove("i18n-pending");
});
}
function onPopState() {
var params = new URLSearchParams(window.location.search);
void setLocale(params.get("locale") || SOURCE_LOCALE, { push: false });
}
if (window.__aiI18nPop) window.removeEventListener("popstate", window.__aiI18nPop);
window.__aiI18nPop = onPopState;
window.addEventListener("popstate", onPopState);
function captureTitleKey() {
var titleEl = document.querySelector("title");
if (!titleEl) {
titleKey = normalizeI18nText(document.title || "");
return;
}
titleKey =
titleEl.getAttribute(TEXT_SOURCE_ATTR) ||
titleEl.getAttribute("data-i18n") ||
normalizeI18nText(titleEl.textContent || "");
if (titleKey) titleEl.setAttribute(TEXT_SOURCE_ATTR, titleKey);
}
function initI18n() {
document.documentElement.classList.add("i18n-pending");
captureTitleKey();
return loadJson(LOCALES_BASE + "/ui-languages.json").then(function (manifest) {
languages = Array.isArray(manifest) ? manifest : [];
return setLocale(resolveLocale(), { push: false });
});
}
var ready = initI18n().catch(function () {
applyStaticI18n();
document.documentElement.classList.remove("i18n-pending");
});
window.i18n = {
t: t,
get locale() {
return I18N.locale;
},
get dir() {
return I18N.dir;
},
apply: applyStaticI18n,
setLocale: function (code) {
return setLocale(code);
},
ready: ready,
};
})();