마크다운
코드와 링크, 승인된 문구를 재사용하는 데 필요한 구조는 유지하면서 문서 본문과 선택한 프런트매터를 번역합니다.
마크다운 문서는 설명을 담은 텍스트와 독자의 이해를 돕는 구조로 이루어져 있습니다. md 파일 핸들러는 코드와 링크 대상을 보호하면서 제목, 문단, 표 셀, 지원되는 지시문 레이블의 텍스트를 번역합니다. 결과도 마크다운 형식이므로 기존 렌더러에서 그대로 사용할 수 있습니다.
텍스트와 보호되는 구조 #
예를 들어 링크 레이블은 바뀌어도 링크 대상과 함수 이름은 그대로 유지됩니다:
---
title: Delivery options
description: Choose how your order arrives.
slug: delivery
---
## Choose delivery
Read the [delivery policy](/policies/delivery) before calling `confirmOrder()`.제목, 문단 내용, 링크 레이블은 텍스트에 해당합니다. 링크 대상과 인라인 코드는 보호되는 구조입니다. 일반 문서 프로필에서는 코드 펜스로 감싼 코드와 원시 HTML을 본문 추출 대상에서 제외합니다. 원본이 HTML 문서라면 HTML을 사용하고, 사용자 지정 마크독 태그가 문서 언어의 일부라면 마크독을 사용하세요.
프런트매터 선택 #
기본적으로 파일 핸들러는 title 및 description를 선택합니다. 다른 필드는 명시적으로 선택하지 않으면 그대로 유지됩니다. translateFrontmatterFields 목록을 비워 두면 프런트매터는 번역하지 않습니다. 필드는 콘텐츠의 성격에 따라 선택해야 합니다. 독자에게 표시되는 제목은 번역할 수 있지만, 슬러그나 구성 요소 식별자, 라우팅 키는 그대로 유지해야 할 수 있습니다.
지원되는 필드 경로를 사용하면 시퀀스 항목을 비롯한 중첩 값을 지정할 수 있습니다. 맵이나 시퀀스를 선택하면 그 아래의 스칼라 값도 모두 포함됩니다. 인접한 라우팅 필드를 그대로 유지해야 한다면 seo.title처럼 정확한 경로를 선택하세요. 선택한 인터페이스의 프런트매터 옵션에서 번역할 텍스트를 지정하세요.
재사용하려면 문서 간 대응 관계가 명확해야 합니다 #
핸들러는 텍스트 단위를 이전 원본 및 그에 대응하는 번역본과 대조한 뒤, 변경된 번역을 현재 원본 구조에 삽입합니다. 기존 문구는 대응 관계가 명확할 때만 재사용할 수 있습니다. 이전 원본과 번역본에서 보호되는 인라인 구조가 서로 다르면 구조 불일치로 재사용에 실패할 수 있습니다.
승인된 번역 문구에 대응하는 원본 버전을 보관하세요. 번역본의 구조를 별도로 변경했다면 증분 업데이트를 요청하기 전에 해당 원본과 구조를 맞추세요. 사이트의 마크다운 처리기로 결과를 빌드해 마크다운 변형별 구문이 올바르게 처리되는지 확인하세요.
문서 설정 및 렌더링 #
CLI는 .md에서 md을 추론합니다. CLI 설정에서 파일 선택, 프런트매터 필드, 출력 경로를 설정하세요. 저장소 번역을 관리형으로 처리하려면 GitHub를 사용하세요. 마크다운에서는 CLI 키 범위를 사용할 수 없습니다.
사이트의 마크다운 처리기로 결과를 렌더링하세요. 번역된 메타데이터, 링크, 제목 프래그먼트, 코드 예제를 함께 확인하세요. /policies/delivery을 유지한다고 해서 해당 페이지가 다른 언어로 생성되는 것은 아닙니다. 정적 콘텐츠 가이드에서는 출력 경로를 사이트의 로더 및 로캘 경로와 연결하는 방법을 설명합니다.