Skip to content

통합 ​

프레임워크 통합 참조: 공유하는 내용과 셸 문자열이 다른 방식. 웹사이트에 언어를 추가하려면 웹사이트 또는 문서 사이트에 i18n 추가에서 시작하세요. 앱의 경우 JS/TS 앱에 i18n 추가, Python 앱에 i18n 추가, 또는 .NET 앱에 i18n 추가에서 시작하세요. 리포지토리 README 및 기타 Markdown 파일의 경우 README 및 Markdown 문서에 i18n 추가에서 시작하세요.

문서 통합은 페이지 콘텐츠에 대해 문서 파이프라인(translate-docs / sync)을 사용하며, 셸 문자열(탐색, 사이드바, 테마)은 명시된 경우 별도의 JSON 파이프라인을 통하지 않고 동일한 파이프라인 내에서 처리됩니다. Python 애플리케이션은 UI 문자열 파이프라인(extract / translate-ui)을 사용합니다.

어떤 가이드를 읽어야 할까요? ​

프레임워크당 하나의 초기화 템플릿이 있는 선택기 테이블은 웹사이트 또는 문서 사이트에 i18n 추가에 있습니다. 해당 페이지의 연습 프롬프트는 프레임워크의 i18n을 활성화합니다. 아래 통합 페이지에는 셸 카탈로그 세부 정보가 유지됩니다. Python 프레임워크: Python.

공유 개념 ​

문서 프레임워크 통합은 Documents에 설명된 동일한 docs[] 블록 모델을 공유합니다. docsOutput.style을 사용 중인 프레임워크("docusaurus", "vitepress", "nextra", "fumadocs" 또는 "astro-starlight")와 일치하도록 설정하십시오. 출력 폴더 레이아웃 및 링크 재작성 동작에 대해서는 Output layouts 및 Link rewriting을 참조하십시오. Python 설정은 별도로 진행됩니다: Python.

각 init -t ui-* -P <provider> 스캐폴드는 해당 프리셋의 LLM 공급자 블록을 작성합니다. translate-docs 또는 sync 전에, 일치하는 API 키를 설정하세요. 자세한 내용은 공급자 및 API 키를 참조하세요.

프레임워크 간 비교는 프레임워크 셸 번역을 참조하세요. 아래 링크된 각 가이드는 해당 프레임워크의 설정 방법을 다룹니다.

프레임워크 셸 번역 ​

프레임워크셸 / 테마 문자열파이프라인
Docusauruswrite-translations 카탈로그 ({ message, description })문서 — docs[].docusaurusCatalogDir + translate-docs
VitePress테마/nav/sidebar 카탈로그문서 — docsOutput.vitepressThemeCatalog + translate-docs
Nextra_meta.ts 사이드바 라벨문서 — style: "nextra" + translate-docs 시 자동
Nextra테마 사전 .ts문서 — docs[].nextraDictionaryPath + translate-docs
Fumadocsmeta.json 사이드바 라벨문서 — style: "fumadocs" + translate-docs 시 자동
FumadocsUI 오버라이드 카탈로그문서 — docsOutput.fumadocsUiCatalog + translate-docs
Astro Starlight내장 UI 문자열 (다수 로케일); 추가 셸 파이프라인 없음문서 — translate-docs (페이지만)

프레임워크 셸/테마 문자열을 json[]에 넣지 마세요 — 해당 파이프라인은 관련 없는 앱 로케일 번들을 위한 것입니다. 프레임워크별 설정 세부 정보는 어떤 가이드를 읽어야 할지에서 링크된 가이드에 나와 있습니다.

실행 가능한 예제 ​

프레임워크예제 저장소
Astro Starlightexamples/astro-docs
일반 Astro 웹사이트examples/astro-website
Docusaurusexamples/docusaurus-docs
VitePressexamples/vitepress-docs
Nextraexamples/nextra-docs
Fumadocsexamples/fumadocs-docs
Streamlitexamples/python-streamlit
Flaskexamples/python-flask
FastAPIexamples/python-fastapi
GNU gettextexamples/python-gettext
.NET JSON 도우미examples/dotnet-console
.NET ResourceManager 도우미examples/dotnet-resx

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