MDX
표현식, 가져오기 구문, 컴포넌트 구조는 그대로 유지하면서 MDX 본문과 선택한 컴포넌트의 리터럴 속성을 번역합니다.
MDX를 사용하면 글 본문에 대화형 컴포넌트를 함께 넣을 수 있습니다. mdx 파일 핸들러는 마크업을 유지하면서 지원되는 본문과 컴포넌트의 자식 요소를 번역합니다. 컴포넌트의 리터럴 속성에도 독자에게 보이는 문구가 있다면 해당 속성을 명시적으로 선택하세요. 텍스트를 찾기 위해 가져오기 구문이나 표현식을 실행하지는 않습니다.
본문과 컴포넌트 데이터 분리하기 #
예를 들어 콜아웃에는 화면에 표시되는 제목과 동작을 제어하는 속성이 함께 있습니다.
import Callout from "./Callout";
## Delivery options {#delivery}
<Callout title="Delivery deadline" kind="warning">
Confirm your address before checkout.
</Callout>제목과 자식 요소의 본문은 번역 대상 텍스트입니다. kind은 그대로 유지해야 하는 컴포넌트 데이터입니다. title은 컴포넌트 속성 규칙으로 선택한 경우에만 번역 대상이 됩니다. 서로 관련 없는 컴포넌트에서 이름이 같은 속성을 모두 번역하기보다는 Callout과 title에만 적용되는 규칙을 사용하는 편이 안전합니다.
문자열 리터럴 속성을 지원합니다. 표현식으로 계산되는 속성은 리터럴 메시지와 같지 않습니다. 가져오기 구문, 자바스크립트 표현식, 코드 블록은 일반적인 본문 추출 대상에서 제외됩니다. 컴포넌트 구조는 애플리케이션의 렌더러와 호환되어야 합니다.
프런트매터와 제목 앵커 #
파일 핸들러는 기본적으로 프런트매터의 title과 description를 선택합니다. 프런트매터를 번역하지 않으려면 빈 선택 목록을 지정하세요. 맵이나 시퀀스를 선택하면 그 아래의 스칼라 값도 모두 포함됩니다. 따라서 인접한 라우팅 필드를 그대로 유지해야 한다면 seo.title처럼 정확한 경로를 선택하세요. translateFrontmatterFields과 translateComponentProps에 대해서는 CLI 구성을 참조하세요.
Docusaurus의 {#delivery} 같은 제목 앵커는 제목 텍스트가 바뀌어도 보호됩니다. 앵커 처리 기능은 코드 펜스 바깥의 제목 줄 구문을 인식하며 URL 슬러그는 변경하지 않습니다. 사이트에서 렌더링된 제목 식별자와 해당 제목으로 연결되는 링크를 확인하세요.
업데이트와 대응 관계 #
이전 원문과 번역문의 텍스트 단위 및 보호된 인라인 구조가 서로 대응하면 기존 문구를 재사용할 수 있습니다. 대응 관계가 불분명하면 핸들러가 재사용을 거부할 수 있습니다. 구조적으로 관련 없는 문서를 별다른 표시 없이 제공하지 말고, 승인된 번역문을 해당 원문 리비전과 짝지어 보관하세요.
재구성 후에는 자식 요소의 본문 밖에 표시되는 레이블까지 포함해 선택한 속성을 점검하고, 애플리케이션의 MDX 프로세서로 결과를 빌드하세요.
MDX 번역 구성하기 #
CLI는 .mdx에서 mdx을 추론합니다. 이 형식에서는 키 범위를 사용할 수 없습니다. 파일 옵션은 CLI 구성 또는 GitHub를 참조하세요.
렌더링된 컴포넌트 확인하기 #
가져온 MDX를 실제 사용하는 프로세서로 빌드하고 컴포넌트 속성, 앵커, 변수, 코드 예제를 함께 점검하세요. MDX 파일 번역은 JSX가 포함된 문서를 보존합니다. 반면 리액트 메시지 추출은 애플리케이션 소스에서 지원되는 호출을 찾아 카탈로그를 생성합니다. 메시지가 작성되는 위치에 맞는 워크플로를 선택하세요.