Skip to content

예시 ​

GitHub의 examples/에 있는 실행 가능한 프로젝트 — 각각 고유한 구성, 커밋된 로케일 출력 및 README를 포함합니다. API 키 없이 번역된 파일을 탐색할 수 있습니다. 번역을 다시 실행하려면 공급자 키가 필요합니다(공급자 및 모델).

독립 실행 (npx degit) ​

전체 저장소를 복제하지 않고 예제 하나만 복사합니다.

Node.js 예제 ​

각 Node.js 예제는 현재 패키지 버전과 일치하는 ai-i18n-tools의 게시된 캐럿 범위를 선언하고 npm에서 CLI를 설치합니다:

bash
npx degit wsj-br/ai-i18n-tools/examples/<name> <name>
cd <name>
pnpm install

Python 예제 ​

python-streamlit, python-flask, python-fastapi 및 python-gettext에는 package.json가 없습니다. 아래 표의 degit 명령은 유효합니다. GitHub Release에서 ai-i18n-tools-python-examples.zip을 다운로드할 수도 있습니다. 해당 zip 파일은 동일한 4개의 디렉터리로 구성됩니다. 이는 npm 패키지의 일부가 아니며 독립 실행형 실행 파일 내부에도 포함되어 있지 않습니다.

python-streamlit, python-flask 및 python-fastapi는 virtualenv와 pip install -r requirements.txt을 사용합니다. python-gettext는 표준 라이브러리만 사용합니다. 독립 실행형 실행 파일을 사용하여 번역하십시오.

bash
npx degit wsj-br/ai-i18n-tools/examples/python-streamlit python-streamlit
cd python-streamlit
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Windows에서는 .venv\Scripts\activate을 활성화하십시오.

ai-i18n-tools 저장소 전체를 복제한 경우, 저장소 루트에서 pnpm install 및 pnpm run build을 실행한 다음 cd examples/<name>를 실행하십시오. 작업 영역(Node.js) 예제는 pnpm run i18n:* 스크립트를 통해 로컬 CLI를 사용하거나 PATH 설정 후 일반 ai-i18n-tools …를 사용합니다. 해당 체크아웃의 Python 예제는 빌드 후 node ../../bin/ai-i18n-tools.mjs를 사용하여 번역합니다. 설치 — 복제된 모노레포를 참조하십시오.

.NET 예제 ​

dotnet-console 및 dotnet-resx에는 package.json가 없습니다. 아래 표의 degit 명령은 유효합니다. 또한 GitHub Release에서 ai-i18n-tools-dotnet-examples.zip를 다운로드할 수 있습니다. 해당 zip 파일에는 동일한 두 디렉터리와 프로젝트가 ../../assets/dotnet를 통해 컴파일하는 assets/dotnet가 포함되어 있습니다. 이는 npm 패키지의 일부가 아니며, 독립 실행형 실행 파일 안에도 없습니다. 해당 zip 파일 이전에 게시된 릴리스에는 포함되어 있지 않습니다.

둘 다 xUnit 프로젝트입니다. dotnet-console는 I18n.cs을(를) 확인합니다. dotnet-resx는 I18nResx.cs 및 .resx 위성 어셈블리(satellites)를 확인합니다. 둘 다 번역 API를 호출하지 않습니다. 해당 디렉터리에서 dotnet test를 실행합니다. 전체 클론에서 리포지토리 루트의 pnpm test:dotnet는 둘 다 실행하며, dotnet가 PATH에 없을 때 건너뜁니다.

ai-i18n-tools-dotnet-examples.zip의 압축을 푼 다음, 예제 디렉터리에서 검사를 실행합니다. 아카이브는 examples/과 assets/dotnet를 나란히 유지하며, 이는 프로젝트가 컴파일되는 경로입니다.

bash
cd examples/dotnet-console
dotnet test

degit는 하나의 디렉터리를 복사하며 assets/dotnet을(를) 포함하지 않습니다. 이러한 컴파일 링크는 전체 클론에서 또는 zip 파일 압축 해제 후에 해결됩니다.

어떤 예제가 제 프로젝트에 맞을까요? ​

예시 목록 ​

예시가장 적합한 용도degit으로 복사실행
console-appt() UI 문자열 + README 번역이 포함된 가장 작은 작동 앱npx degit wsj-br/ai-i18n-tools/examples/console-app console-apppnpm start
nextjs-appReact / Next.js + 복수형 + 대시보드; 중첩 Docusaurus 문서 + 평면 README + SVG 에셋npx degit wsj-br/ai-i18n-tools/examples/nextjs-app nextjs-apppnpm dev (앱 :3030; 문서용 cd docs-site && pnpm start :3040)
docusaurus-docsDocusaurus 문서 사이트 전용 (docusaurus 프리셋)npx degit wsj-br/ai-i18n-tools/examples/docusaurus-docs docusaurus-docspnpm start (:3100; 빌드 + 서브, 로케일 메뉴 작동)
astro-websiteAstro 랜딩 페이지: 전체 페이지 HTML + t() 하이브리드npx degit wsj-br/ai-i18n-tools/examples/astro-website astro-websitepnpm dev
astro-docsAstro Starlight 문서 사이트npx degit wsj-br/ai-i18n-tools/examples/astro-docs astro-docspnpm dev (:3050)
vitepress-docsVitePress 문서 사이트 + 테마 JSON (pt-BR, zh-Hans)npx degit wsj-br/ai-i18n-tools/examples/vitepress-docs vitepress-docspnpm run docs:dev (:3060)
nextra-docsNextra 4 MDX + _meta.ts / 사전 .ts 셸, 하나의 t() 서버 컴포넌트(pt-BR, zh-Hans) 포함npx degit wsj-br/ai-i18n-tools/examples/nextra-docs nextra-docspnpm run dev (:3070)
fumadocs-docsFumadocs 4 MDX + meta.json / UI 카탈로그 (pt, zh, 점 파서)npx degit wsj-br/ai-i18n-tools/examples/fumadocs-docs fumadocs-docspnpm run dev (:3080)
plain-html순수 HTML + data-i18n* 마커; 정적 로케일 JSON (대시보드 스타일 UI)npx degit wsj-br/ai-i18n-tools/examples/plain-html plain-htmlpnpm dev (:3090)
plain-html-docs문서로서의 일반 HTML: 로케일당 한 페이지, 현지화된 이미지, hreflangnpx degit wsj-br/ai-i18n-tools/examples/plain-html-docs plain-html-docspnpm dev (:3092)
multi-providerLLM 공급자 선택 또는 벤치마크 (-P / --provider)npx degit wsj-br/ai-i18n-tools/examples/multi-provider multi-providerai-i18n-tools translate-docs -P openai --force
test-markdown마크다운 / CJK 번역 회귀 테스트 (데바나가리, MDX)npx degit wsj-br/ai-i18n-tools/examples/test-markdown test-markdownpnpm build
intlayer-migrationIntlayer .content.ts → t() (migrate-intlayer, 재설정 + AI 에이전트 보고서)npx degit wsj-br/ai-i18n-tools/examples/intlayer-migration intlayer-migrationpnpm reset && pnpm dev (:3091)
intlayer-translateIntlayer 유지, 누락된 로케일 제자리에서 채우기 (translate-intlayer; en + pt-BR 제공됨, es + zh-Hans 누락됨)npx degit wsj-br/ai-i18n-tools/examples/intlayer-translate intlayer-translatepnpm reset && pnpm translate (pnpm dev :3093)
python-streamlitStreamlit 대시보드, t() / _(), 소스 문자열 JSONnpx degit wsj-br/ai-i18n-tools/examples/python-streamlit python-streamlitpython3 -m venv .venv && pip install -r requirements.txt && streamlit run app.py
python-flaskFlask + Jinja, t() / _(), 소스 문자열 JSONnpx degit wsj-br/ai-i18n-tools/examples/python-flask python-flaskpython3 -m venv .venv && pip install -r requirements.txt && flask --app app run
python-fastapiFastAPI, ContextVar 로케일, t() / _(), 소스 문자열 JSONnpx degit wsj-br/ai-i18n-tools/examples/python-fastapi python-fastapipython3 -m venv .venv && pip install -r requirements.txt && uvicorn app:app
python-gettext기존 GNU gettext CLI; extract / translate-ui 새로 고침 .po 및 .monpx degit wsj-br/ai-i18n-tools/examples/python-gettext python-gettextpython3 app.py --lang es
dotnet-consoleI18n.cs의 xUnit 검사: 내장 JSON, 문화권 대체, {0}, 복수형, 및 Configurenpx degit wsj-br/ai-i18n-tools/examples/dotnet-console dotnet-consoledotnet test
dotnet-resxI18nResx.cs 및 소스 문자열 .resx 위성 어셈블리(satellites)의 xUnit 검사npx degit wsj-br/ai-i18n-tools/examples/dotnet-resx dotnet-resxdotnet test

각 예시 이름은 전체 설정, 명령 및 프로젝트 레이아웃이 포함된 GitHub README로 연결되거나 저장소의 예시 색인을 탐색할 수 있습니다.

Node.js 예제는 pnpm install 이후 npm에서 CLI를 설치합니다. 네 가지 Python 예제는 venv 및 pip를 사용하며(python-gettext는 표준 라이브러리만 사용), 번역을 위해 독립 실행형 실행 파일을 사용합니다. 두 가지 .NET 예제는 xUnit 프로젝트입니다. dotnet test로 실행합니다. 또한 GitHub Release의 ai-i18n-tools-dotnet-examples.zip에 있습니다.


면책 조항

제품명 및 아이콘은 각 소유자에게 귀속되며 식별 목적으로만 사용됩니다. 이 소프트웨어는 해당 브랜드와 제휴 관계가 없으며, 해당 브랜드의 공식적인 보증을 받지 않습니다.

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