如何将 MDN Web Docs 翻译成西班牙语

大家好！将文档翻译成不同语言比以往任何时候都更加重要。随着讲西班牙语的 Web 开发者数量不断增加，确保他们能够访问更新的资源至关重要。在本文中，我将基于最近一项旨在使这些资源更易于访问的计划，引导您完成将 MDN Web Docs 翻译成西班牙语的过程。

了解 MDN Web Docs

MDN Web Docs 是一个广受欢迎的平台，记录了 HTML、CSS 和 JavaScript 等 Web 技术。它是一个开源项目，这意味着任何人都可以为其做出贡献。截至 2026 年 5 月，MDN 包含近 14,000 个英文页面，并提供包括西班牙语在内的多种语言的翻译版本。该计划是支持全球开发者更广泛努力的一部分。

为什么要翻译 MDN Web Docs？

MDN Web Docs 的西班牙语版本更新频率不如英语版本。通过翻译这些文档，我们可以帮助讲西班牙语的开发者获取最新信息并提升他们的技能。这项努力不仅使个人受益，而且也加强了全球开发者社区。

入门指南

第 1 步：熟悉指南

在开始翻译之前，了解 MDN 的写作和翻译指南至关重要。这些指南确保了文档的一致性和质量。关键资源包括：

• 写作指南：这些涵盖了要记录的内容以及如何编写。
• 翻译 MDN 页面：本指南提供了翻译内容的逐步流程。

第 2 步：设置您的开发环境

要做出贡献，您需要设置您的开发环境。方法如下：

1. Fork 仓库：创建一个个人副本，复制 mdn/translated-content GitHub 上的仓库。

2. 克隆仓库：使用 Git 将仓库下载到您的本地机器。您可以使用以下命令执行此操作：

   git clone https://github.com/YOUR_USERNAME/translated-content.git

3. 安装必要工具：确保您的计算机上安装了文本编辑器（例如 Visual Studio Code）和 Git。

第 3 步：翻译内容

翻译时，请遵循以下最佳实践：

• 文件路径：不要翻译文件路径。它们在所有语言中都应保持相同。
• Front-Matter（前置数据）：翻译 title 和 short-title 字段，但保留 slug 和 l10n.sourceCommit 字段不变。
• 链接：对于内部链接，将语言环境前缀从 /en-US/ 更改为 /es/。外部链接应保持不变。
• 文本格式：保留粗体和斜体文本的原始格式。
• 图片：不要将图片复制到西班牙语文件夹中。构建过程将从英语文件夹中提取它们。仅翻译替代文本（alt text）。
• 标注（Callouts）：不要翻译类似 [!NOTE] 或 [!WARNING]这样的标注标记；只翻译其中的内容。

第 4 步：参与社区

MDN Web Docs 拥有一个充满活力的贡献者社区。参与这个社区可以提供支持并加强您的翻译工作。您可以通过 MDN 社区门户找到讨论并与其他贡献者建立联系。

第 5 步：提交您的贡献

翻译内容后，通过 GitHub 上的拉取请求 (PR) 提交您的更改。在合并之前，请确保您的 PR 遵循 MDN 的贡献指南并通过所有检查。

结论

将 MDN Web Docs 翻译成西班牙语是为开发者社区做贡献的一种有价值的方式。通过遵循这些步骤，您可以帮助讲西班牙语的开发者更容易地获取 Web 开发资源。

优点

• 为讲西班牙语的开发者提供更新的资源。
• 加强全球开发者社区。
• 鼓励协作和开源贡献。

缺点

• 需要花费时间和精力来确保高质量的翻译。
• 随着英语版本的变化，可能需要持续更新。

注意事项

本文仅供教育目的。在做贡献时，请记住将任何占位符值替换为实际内容。在依赖它们之前，始终对照原始出处验证相关主张。

常见问题解答

• 我该如何为 MDN Web Docs 做出贡献？ ——您可以遵循提供的指南，通过翻译现有文档或创建新文档来做出贡献。
• 翻译 MDN Web Docs 需要什么工具？ ——您需要在计算机上安装文本编辑器和 Git 来管理您的贡献。
• 翻译有具体的指南吗？ ——是的，MDN 拥有详细的写作和翻译指南以确保一致性。
• 我可以翻译文档中的图片吗？ ——不可以，不要复制图片；只需翻译替代文本（alt text）。
• 我应该如何处理内部链接？ ——更改语言环境前缀，从 /en-US/ 到 /es/ ，用于内部链接。
• 我如何提交我的翻译？ ——在确保它们符合指南后，通过 GitHub 上的拉取请求提交您的翻译。

标签

#mdn #translation #opensource #webdevelopment #documentation #spanish #programming #community #contribution #guidelines