Markdown - Lingo.dev CLI

什么是 Markdown？

Markdown 是一种轻量级标记语言，使用纯文本格式语法来创建结构化文档。它广泛用于文档、README 文件、博客和内容管理系统。

例如：


---

title: "产品发布指南"
description: "关于我们最新产品功能的所有信息"
author: "产品团队"

---

# 欢迎使用我们的新仪表板

探索旨在简化您的工作流程并提高生产力的强大新功能。

## 入门指南

按照以下简单步骤设置您的账户并有效地开始使用我们的平台。

![仪表板概览截图](image.jpg)

什么是 Lingo.dev CLI？

Lingo.dev CLI 是一个免费的开源命令行工具，用于通过 AI 翻译应用程序和内容。它旨在取代传统的翻译管理软件，同时与现有的流水线集成。

要了解更多信息，请参阅概述。

关于本指南

本指南解释了如何使用 Lingo.dev CLI 翻译 Markdown 文件。

您将学习如何：

从头开始创建项目
配置翻译流水线
使用 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. 创建源内容

如果尚未创建，请创建一个或多个包含待翻译内容的 Markdown 文件。这些文件的路径中必须包含源语言环境（例如，作为目录名称 en/ 或作为文件名的一部分 messages.en.md）。

步骤 5. 创建存储桶

在 i18n.json 文件中，向 buckets 对象添加一个 "markdown" 对象：

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

在 "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"）
不支持递归的 glob 模式（例如，**/*.md）。

第 6 步：配置 LLM

Lingo.dev CLI 使用大型语言模型 (LLM) 通过 AI 翻译内容。要使用这些模型之一，您需要从支持的提供商处获取 API 密钥。

为了尽快开始使用，我们推荐使用 Lingo.dev Engine —— 我们自己的托管平台，每月提供 10,000 个免费令牌：

注册一个 Lingo.dev 账户。
运行以下命令：
```
npx lingo.dev@latest login
```
这将打开您的默认浏览器并要求您进行身份验证。
按照提示操作。

第 7 步：生成翻译

在包含 i18n.json 文件的目录中，运行以下命令：

npx lingo.dev@latest run

此命令将：

读取 i18n.json 文件。
查找需要翻译的文件。
从文件中提取可翻译的内容。
使用配置的 LLM 翻译提取的内容。
将翻译后的内容写回文件系统。

首次生成翻译时，会创建一个 i18n.lock 文件。此文件记录已翻译的内容，防止在后续运行中进行不必要的重新翻译。

示例

zh/example.md


---

title: "产品发布指南"
description: "关于我们最新产品功能的所有信息"
author: "产品团队"
date: 2024-01-15
tags: ["apples", "bananas", "pears"]

---

# 欢迎使用我们的新仪表板

探索旨在简化您的工作流程并提高生产力的强大新功能。

## 入门指南

按照以下简单步骤设置您的账户并有效地开始使用我们的平台。

---

我们的高级分析功能帮助您自信地做出数据驱动的决策。

![仪表板概览截图](image.jpg)

直观的界面使您可以轻松在不同功能和工具之间导航。

[查看文档](https://example.com)

需要帮助入门吗？我们的支持团队全天候 24/7 为您提供协助。

***

加入成千上万满意的客户，他们已经通过我们的平台改变了他们的业务。

zh/example.md


---

title: 产品发布指南
description: 关于我们最新产品功能的所有信息
author: 产品团队
date: 2024-01-15
tags:
  - apples
  - bananas
  - pears

---

# 欢迎使用我们的新仪表板

探索旨在优化您的工作流程并提高生产力的新功能和强大功能。

## 入门指南

按照以下简单步骤设置您的账户并有效地开始使用我们的平台。

---

我们的高级分析功能帮助您自信地做出数据驱动的决策。

![仪表板概览截图](image.jpg)

直观的界面使您可以轻松在不同功能和工具之间导航。

[查看文档](https://example.com)

需要帮助入门吗？我们的支持团队全天候 24/7 为您提供协助。

---

加入成千上万满意的客户，他们已经通过我们的平台改变了他们的业务。

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