Skip to content

프로그래밍 방식 API ​

모든 공개 타입과 클래스는 패키지 루트에서 내보내집니다. 예시: CLI 없이 Node.js에서 translate-ui 단계를 실행하는 방법:

ts
import { loadI18nConfigFromFile, runTranslateUI } from 'ai-i18n-tools';

// Config must have features.translateUIStrings: true (and valid targetLocales, etc.).
const config = loadI18nConfigFromFile('ai-i18n-tools.config.json');

const summary = await runTranslateUI(config, {
  cwd: process.cwd(),
  locales: config.targetLocales,
  force: false,
  dryRun: false,
  verbose: false,
});
console.log(
  `Updated ${summary.stringsUpdated} string(s); locales touched: ${summary.localesTouched.join(', ')}`
);

Node.js에서 구성을 스캐폴드합니다. 네 번째 인수는 기본 제공 프리셋입니다(세 번째 인수는 cwd). 선택 사항인 다섯 번째 인수 { withReadme: true }은(는) 템플릿에 README.md이(가) 아직 나열되지 않은 경우 플랫 README 문서 블록을 추가하고, 해당 블록이 추가되었는지 여부를 반환합니다.

ts
import { writeInitConfigFile } from 'ai-i18n-tools';

writeInitConfigFile('ai-i18n-tools.config.json', 'uiMarkdown', process.cwd(), 'anthropic');
writeInitConfigFile('ai-i18n-tools.config.json', 'docsMarkdown', process.cwd(), 'openrouter');
writeInitConfigFile('ai-i18n-tools.config.json', 'uiPython', process.cwd(), 'openrouter', {
  withReadme: true,
});

주요 내보내기 (일반적으로 사용됨 — 전체 공개 표면은 src/index.ts 참조):

내보내기설명
loadI18nConfigFromFileJSON 파일에서 설정을 로드하고 병합한 후 유효성을 검사합니다.
parseI18nConfig원시 설정 객체의 유효성을 검사합니다.
TranslationCacheSQLite 캐시 - cacheDir 경로로 인스턴스 생성.
UIStringExtractorJS/TS 소스에서 t("…") 문자열 추출.
collectHtmlI18nStrings / markHtmlContentHTML에서 data-i18n* 마커 스캔/삽입 (extract용 .html 및 mark-html 명령 지원).
MarkdownExtractor마크다운에서 번역 가능한 구문 추출.
HtmlTemplateExtractor일반 HTML 문서 추출 및 재구성(텍스트 및 번역 가능한 속성; src / href는 제자리에 유지).
JsonExtractorDocusaurus JSON 레이블 파일(UI 카탈로그, MDX 본문 아님)에서 추출합니다.
SvgExtractorSVG 파일에서 추출.
LlmClient활성 LLM 공급자에게 번역 요청을 합니다( OpenRouterClient는 더 이상 사용되지 않는 별칭).
rankProviderModels / resolveSuggestionWeights한 제공업체의 채팅 카탈로그 순위를 매깁니다. 인덱스는 ChrF 및 Arena이며, 품질 프로필은 해당 인덱스에 따라 정렬하고, 가격 프로필은 파레토 프론티어를 따릅니다. 구성을 인쇄하거나 쓰지 않습니다.
PlaceholderHandler번역 주위의 마크다운 구문 보호/복원 (HTML 태그, 주석, 앵커, MDX 주석/JSX/중괄호, URL, 인라인 코드, 강조).
protectMdx / restoreMdxMDX 주석, JSX 태그, 중괄호 표현식 및 JSX 문자열 속성 보호/복원 (PlaceholderHandler에 의해 호출됨; 직접 사용을 위해 내보내기도 함).
splitTranslatableIntoBatches구문을 LLM 크기의 배치로 그룹화.
validateTranslation번역 후 구조 검사 (async — 대기해야 함).
resolveDocumentationOutputPath번역된 문서의 출력 파일 경로 결정.
Glossary / GlossaryMatcher번역 용어집을 로드하고 적용하며, 선택적인 용어 Context 메모를 포함합니다.
loadTranslationContext / computeGuidanceFingerprint캐시 무효화를 위한 glossary.contextFiles 및 지문 가이드를 로드합니다.
runTranslateUI프로그래밍 방식의 translate-ui 진입점.
writeInitConfigFile시작 구성 JSON(template, cwd, 필수 providerKey 및 선택 사항 { withReadme })을 작성합니다. { readmeBlockAdded, hasReadmeBlock }을(를) 반환합니다.
DEFAULT_INIT_MODELS_BY_PROVIDERinit -P에서 사용하는 내장 프리셋당 스타터 translationModels.
PROVIDER_PRESETS내장 공급자 사전 설정 맵 (baseUrl, apiKeyEnv).

파이썬 런타임(i18n.py) ​

init -t ui-python, ui-python-gettext 및 ui-python-flask는 i18n.py이(가) 누락된 경우 이 모듈을 프로젝트에 작성합니다. 이는 Python 3.10 이상을 위한 표준 라이브러리 도우미입니다. 해당 파일에서 가져오십시오. 아래 함수들은 위 표의 Node 내보내기와는 별개입니다. Django 프로젝트는 Django의 gettext를 유지하므로 ui-python-django는 i18n.py을(를) 작성하지 않습니다.

호출 형태, 안전하지 않은 f-string 및 프레임워크별 로캘 연결: Python 애플리케이션.

함수동작
set_locale(locale)현재 로캘을 설정합니다. 코드의 밑줄은 하이픈으로 저장됩니다(pt_BR은(는) pt-BR이(가) 됨). ContextVar 토큰을 반환합니다.
reset_locale(token)해당 토큰에서 로캘을 복원합니다. FastAPI 및 Flask 미들웨어를 포함하여 finally에서 호출하십시오.
get_locale()현재 로캘을 반환합니다.
set_backend(backend)"auto", "json" 또는 "gettext"을(를) 선택합니다.
get_ui_languages()플랫 JSON 디렉터리 옆에 있는 ui-languages.json을(를) 읽거나, 플랫 출력이 꺼져 있을 때는 gettext 디렉터리를 읽습니다.
get_direction(locale=None)해당 로캘(생략 시 현재 로캘)에 대한 매니페스트 행에서 "rtl" 또는 "ltr"을(를) 반환합니다.
_(message)리터럴 하나를 조회한 다음 카탈로그 문자열 또는 메시지 자체를 반환합니다.
t(template, *, plurals=False, count=None, **values)리터럴을 조회한 다음 보간합니다. translate은(는) 동일한 함수입니다. Python 3.14에서 translate(t"Hello, {name}!")은(는) 템플릿과 해당 값을 유지합니다. 키워드 인수는 템플릿 문자열에서 가져온 값을 재정의합니다.
ngettext(singular, plural, n, **values)복수형 조회 후 보간합니다. count은(는) 형식 문자열에서 사용할 수 있습니다.
pgettext(context, message, **values)컨텍스트 조회(msgctxt 또는 context + U+0004 + 플랫 JSON의 소스 언어 문자열) 후 보간합니다.
streamlit_language_selector(sidebar=True, key="lang_selector")Streamlit 선택 상자입니다. st.session_state.locale 및 st.query_params["lang"]을(를) 작성하고, set_locale을(를) 호출하며, 선택한 코드를 반환합니다.

.NET 런타임 (I18n.cs) ​

I18n.cs가 누락된 경우 init -t ui-dotnet는 assets/dotnet/I18n.cs을 프로젝트에 복사합니다. 이는 .NET 6 이상 버전용 종속성 없는 도우미입니다. 아래 멤버는 위 표의 Node 내보내기와 별개입니다. 호출 형태 및 XAML 마크업: .NET 애플리케이션.

멤버동작
SetLocale(locale)정확한 파일이 누락된 경우 CultureInfo.Parent을 탐색하여 해당 로케일의 플랫 JSON을 로드합니다. LocaleChanged를 발생시킵니다.
T(source, args)잘라낸 리터럴을 찾아 string.Format로 서식을 지정하고, 원본의 선행 및 후행 공백을 다시 넣습니다.
Tn(singular, plural, count, args)복수형 조회. {0}은 개수입니다. 카탈로그 키는 잘라낸 단수형의 MD5-8에 _와 CLDR 형식을 더한 값입니다.
Tp(context, source, args)컨텍스트 + U+0004 + 소스를 조회한 다음 서식을 지정합니다.
N(source)source을 반환합니다. 정적 레이블을 카탈로그화할 수 있도록 추출되었습니다.
Loc[source]T을 호출하는 인덱서. Loc는 StringSourceLocalizer 형식의 정적 필드입니다.
Configure(options)SourceLocale이 비어 있지 않을 때 소스 로케일을 설정합니다. 모든 호출은 Strict, FlatDirectory, 및 OpenLocale를 대체합니다(null은 디렉터리와 스트림 로더를 지웁니다). Locales는 배열이 null이 아닐 때만 언어 목록을 대체합니다.
SupportedLocalesBuiltInLocales null이 아닌 Locales 배열이 전달될 때까지. 기본 이름 및 영어 이름. null Locales 배열은 스탬프를 복원하지 않습니다.
IsRightToLeft(locale)CultureInfo.TextInfo.IsRightToLeft.
PluralForm(locale, n).po 파일과 동일한 GNU 규칙에서 가져온 CLDR 형식 이름.

init -t ui-dotnet-resx는 대신 I18nResx.cs을 복사합니다. T, Tn, Tp는 동일한 원본 문자열 키로 ResourceManager를 호출합니다. SetLocale는 CurrentUICulture 및 CurrentCulture을 설정합니다. 세부 정보: .NET ResourceManager 앱에 i18n 추가.

MIT 라이선스에 따라 배포됩니다.