마크다운

Lingo.dev CLI를 이용한 마크다운 파일의 AI 번역

마크다운이란 무엇인가요?

마크다운은 일반 텍스트 서식 구문을 사용하여 구조화된 문서를 만드는 경량 마크업 언어입니다. 문서화, README 파일, 블로그 및 콘텐츠 관리 시스템에 널리 사용됩니다.

예를 들면:


---

title: "제품 출시 가이드"
description: "최신 제품 기능에 대해 알아야 할 모든 것"
author: "Product Team"

---

# 새로운 대시보드에 오신 것을 환영합니다

워크플로우를 간소화하고 생산성을 향상시키도록 설계된 강력한 새 기능을 발견하세요.

## 시작하기

계정을 설정하고 플랫폼을 효과적으로 사용하기 시작하려면 다음 간단한 단계를 따르세요.

![대시보드 개요 스크린샷](image.jpg)

Lingo.dev CLI란 무엇인가요?

Lingo.dev CLI는 AI로 앱과 콘텐츠를 번역하기 위한 무료 오픈소스 CLI입니다. 기존 파이프라인과 통합하면서 전통적인 번역 관리 소프트웨어를 대체하도록 설계되었습니다.

자세한 내용은 개요를 참조하세요.

이 가이드에 대하여

이 가이드는 Lingo.dev CLI로 마크다운 파일을 번역하는 방법을 설명합니다.

다음 내용을 배우게 됩니다:

  • 처음부터 프로젝트 생성하기
  • 번역 파이프라인 구성하기
  • AI로 번역 생성하기

사전 요구사항

Lingo.dev CLI를 사용하려면 Node.js v18+ 이상이 설치되어 있는지 확인하세요:

❯ node -v
v22.17.0

1단계. 프로젝트 설정하기

프로젝트 디렉토리에 i18n.json 파일을 생성하세요:

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {}
}

이 파일은 번역할 언어와 파일 시스템에서 현지화 가능한 콘텐츠가 존재하는 위치를 포함하여 번역 파이프라인의 동작을 정의합니다.

사용 가능한 속성에 대해 자세히 알아보려면 i18n.json을 참조하세요.

2단계. 소스 로케일 구성하기

_소스 로케일_은 콘텐츠가 원래 작성된 언어와 지역입니다. 소스 로케일을 구성하려면 i18n.json 파일에서 locale.source 속성을 설정하세요:

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {}
}

소스 로케일은 BCP 47 언어 태그 형식으로 제공되어야 합니다.

Lingo.dev CLI가 지원하는 로케일 코드의 전체 목록은 지원되는 로케일 코드를 참조하세요.

3단계. 대상 로케일 구성하기

_대상 로케일_은 콘텐츠를 번역하고자 하는 언어와 지역입니다. 대상 로케일을 구성하려면 i18n.json 파일에서 locale.targets 속성을 설정하세요:

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {}
}

4단계. 소스 콘텐츠 생성하기

아직 생성하지 않았다면, 번역할 콘텐츠가 포함된 하나 이상의 마크다운 파일을 생성하세요. 이 파일들은 경로 어딘가에 소스 로케일이 포함된 위치에 있어야 합니다(예: en/과 같은 디렉토리 이름이나 messages.en.md와 같은 파일 이름의 일부로).

5단계. 버킷 생성하기

  1. i18n.json 파일에서 buckets 객체에 "markdown" 객체를 추가하세요:

    {
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "markdown": {}
  }
}

  2. "markdown" 객체에서 하나 이상의 include 패턴 배열을 정의하세요:

    {
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "markdown": {
      "include": ["./[locale]/example.md"]
    }
  }
}

    이 패턴들은 어떤 파일을 번역할지 정의합니다.

    패턴 자체는:

    • 구성된 로케일의 플레이스홀더로 [locale]을 포함해야 합니다
    • 파일 경로를 가리킬 수 있습니다(예: "[locale]/docs.md")
    • 와일드카드 플레이스홀더로 별표를 사용할 수 있습니다(예: "[locale]/*.md")

    재귀적 글로브 패턴(예: **/*.md)은 지원되지 않습니다.

6단계. LLM 구성하기

Lingo.dev CLI는 AI로 콘텐츠를 번역하기 위해 대규모 언어 모델(LLM)을 사용합니다. 이러한 모델 중 하나를 사용하려면 지원되는 제공업체의 API 키가 필요합니다.

가능한 빨리 시작하려면 Lingo.dev Engine을 사용하는 것이 좋습니다 — 매월 10,000 토큰의 무료 사용량을 제공하는 자체 호스팅 플랫폼입니다:

  1. Lingo.dev 계정에 가입하세요.

  2. 다음 명령어를 실행하세요:

    npx lingo.dev@latest login

    이렇게 하면 기본 브라우저가 열리고 인증을 요청합니다.

  3. 안내에 따르세요.

7단계. 번역 생성하기

i18n.json 파일이 포함된 디렉토리에서 다음 명령어를 실행하세요:

npx lingo.dev@latest run

이 명령어는 다음을 수행합니다:

  1. i18n.json 파일을 읽습니다.
  2. 번역이 필요한 파일을 찾습니다.
  3. 파일에서 번역 가능한 콘텐츠를 추출합니다.
  4. 구성된 LLM을 사용하여 추출된 콘텐츠를 번역합니다.
  5. 번역된 콘텐츠를 파일 시스템에 다시 작성합니다.

번역이 처음 생성될 때 i18n.lock 파일이 생성됩니다. 이 파일은 어떤 콘텐츠가 번역되었는지 추적하여 이후 실행 시 불필요한 재번역을 방지합니다.

예시

en/example.md


---

title: "제품 출시 가이드"
description: "최신 제품 기능에 대해 알아야 할 모든 것"
author: "제품 팀"
date: 2024-01-15
tags: ["apples", "bananas", "pears"]

---

# 새로운 대시보드에 오신 것을 환영합니다

워크플로우를 간소화하고 생산성을 향상시키도록 설계된 강력한 새 기능을 발견해보세요.

## 시작하기

계정을 설정하고 플랫폼을 효과적으로 사용하기 위한 간단한 단계를 따르세요.

---

당사의 고급 분석 기능은 데이터 기반 의사 결정을 자신 있게 내릴 수 있도록 도와드립니다.

![대시보드 개요 스크린샷](image.jpg)

직관적인 인터페이스로 다양한 기능과 도구 간의 탐색이 용이합니다.

[문서 보기](https://example.com)

시작하는 데 도움이 필요하신가요? 저희 지원팀이 24시간 연중무휴로 도와드립니다.

***

저희 플랫폼으로 비즈니스를 혁신한 수천 명의 만족 고객들과 함께하세요.

es/example.md


---

title: Guía de lanzamiento de producto
description: Todo lo que necesitas saber sobre las últimas características de
  nuestro producto
author: Equipo de producto
date: 2024-01-15
tags:
  - apples
  - bananas
  - pears

---

# Bienvenido a nuestro nuevo panel de control

Descubre nuevas y potentes funciones diseñadas para optimizar tus flujos de trabajo y aumentar la productividad.

## Primeros pasos

Sigue estos sencillos pasos para configurar tu cuenta y comenzar a utilizar nuestra plataforma de manera efectiva.

---

Nuestros análisis avanzados te ayudan a tomar decisiones basadas en datos con confianza.

![Captura de pantalla de la visión general del panel](image.jpg)

La interfaz intuitiva facilita la navegación entre diferentes funciones y herramientas.

[Ver documentación](https://example.com)

¿Necesitas ayuda para empezar? Nuestro equipo de soporte está disponible 24/7 para asistirte.

---

Únete a miles de clientes satisfechos que han transformado su negocio con nuestra plataforma.

i18n.json

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "markdown": {
      "include": ["./[locale]/example.md"]
    }
  }
}

i18n.lock

version: 1
checksums:
  eed9ef23a605b747d38b8916cee1d500:
    md-section-0: d53f61b8c8922fb62d9df5678d9b44a8
    md-section-1: 98aec271471bedce0e12b530c7060827
    md-section-2: 9e5a786192608844493dfbb6e4100886
    md-section-3: 1a5299c38bb20c1b8af0e64e33d7b2b0
    md-section-4: 51adf33450cab2ef392e93147386647c
    md-section-5: e56cc804e3e06b5f5fb2484e88c18adc
    md-section-6: 0ea86a3338305070c865e8fe138da890
    md-section-7: bbabf7f391569a72099001e3d81eb251
    md-section-8: 36cbfd93f42528edce4faac2ac3c2c12
    md-section-9: a1c50054ab23d70be8d453789b214580
    md-section-10: 51adf33450cab2ef392e93147386647c
    md-section-11: cb596c9608828f7b87a0ab8fa37beb07
    fm-attr-title: f3469c4e3d3377c39a705c844930b3a5
    fm-attr-description: 2e988d98001e44997a3f5fa3fb487ca6
    fm-attr-author: ec8c8711fce61265a4fe296ce2ba3b6f
    fm-attr-tags: 313ac6f17ee08e4f4a6a2ca95e5ae024