Lingo.dev + .md/.mdx (문서)

Lingo.dev CLI는 마크다운 및 MDX 문서, 블로그, 콘텐츠를 번역하면서 서식, 코드 블록, 링크, React 컴포넌트 및 대화형 요소를 보존합니다. CLI는 .md와 .mdx 파일 모두에 대해 mdx 버킷을 권장 구성으로 사용하며, 코드 블록과 인라인 코드를 번역으로부터 보호하고, URL을 보존하면서 설명을 번역하고, 프론트매터 메타데이터를 유지하고, React 컴포넌트와 임포트를 그대로 유지하며, JSX 속성을 지능적으로 번역하고, Next.js, Gatsby 및 MDX 도구와 원활하게 작동합니다.

빠른 설정

마크다운 및 MDX 파일 모두에 대해 mdx 버킷을 사용하여 구성:

{
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de"]
  },
  "buckets": {
    "mdx": {
      "include": ["docs/[locale]/*.md", "content/[locale]/*.mdx"]
    }
  }
}

참고: [locale]은 CLI 실행 중에 실제 로케일로 대체되므로 구성에서 문자 그대로 유지해야 하는 플레이스홀더입니다.

문서 번역

npx lingo.dev@latest i18n

모든 마크다운 서식과 MDX React 컴포넌트를 보존하면서 콘텐츠를 번역합니다.

마크다운 콘텐츠 처리

코드 블록 보존

```javascript
const message = "Hello, world!";
console.log(message);
```

코드는 번역되지 않고 그대로 유지되며 주변 설명만 현지화됩니다.

링크 및 참조 처리

Visit [our website](https://example.com) for more details.

See the [configuration guide](./config.md) for setup instructions.

URL 및 상대 경로는 그대로 유지되고 링크 텍스트만 번역됩니다.

프론트매터 보호

---

title: "Getting Started"
date: 2024-01-15
tags: ["tutorial", "beginner"]

---

# Getting Started

Your content begins here...

YAML 프론트매터는 그대로 유지되고 콘텐츠만 번역됩니다.

MDX 컴포넌트 기능

React 컴포넌트 블록

import { Alert } from "@components/Alert";

# 환영 가이드

<Alert type="info">이것은 사용자를 위한 중요한 정보입니다.</Alert>

일반 마크다운 콘텐츠는 여기서 번역됩니다.

컴포넌트 임포트와 JSX는 그대로 유지되는 반면 텍스트 콘텐츠는 현지화됩니다.

인라인 JSX 요소

여기에 <Button variant="primary">시작하기</Button> 버튼이 텍스트 안에 있습니다.

컴포넌트는 유지되지만 "시작하기"는 번역됩니다.

번역 가능한 콘텐츠가 있는 Props

<VideoPlayer
  title="소개 비디오"
  description="5분 안에 기본 사항 배우기"
  src="/videos/intro.mp4"
/>

문자열 props는 번역되는 반면 기술적 props는 변경되지 않습니다.

Export 구문

export const title = "사용자 가이드";
export const published = "2024-01-15";

# {title}

콘텐츠가 여기서 시작됩니다...

번역 가능한 콘텐츠가 있는 명명된 내보내기는 현지화됩니다.

컴포넌트가 있는 Frontmatter

---

title: "시작하기"
components:
  - Alert
  - CodeBlock

---

import { Alert, CodeBlock } from "@components";

<Alert>저희 플랫폼에 오신 것을 환영합니다!</Alert>

고급 구성

다중 콘텐츠 디렉토리

"mdx": {
  "include": [
    "docs/[locale]/*.md",
    "content/[locale]/*.mdx",
    "blog/[locale]/*.{md,mdx}"
  ]
}

참고: 이중 별표(**)는 글로브 패턴에서 지원되지 않습니다. 디렉토리 내 파일 매칭에는 단일 별표(*)를 사용하세요.

특정 파일 제외

"mdx": {
  "include": ["docs/[locale]/*.{md,mdx}"],
  "exclude": ["docs/[locale]/drafts/*.{md,mdx}"]
}

컴포넌트 Props 잠금

"mdx": {
  "include": ["content/[locale]/*.{md,mdx}"],
  "lockedKeys": ["src", "href", "id", "className"]
}