安装内容创作工具

本文介绍了如何安装推荐的工具,以便高效、深入或大量参与 Microsoft Learn。 主要更新示例包括:

  • 对多篇冗长文章进行了修订
  • 创建新文章
  • 支持可用的 Visual Studio Code 扩展,例如 Learn 创作包

重要

如果要进行次要更改,无需完成本文中的相关步骤。 请参阅“在浏览器中编辑”,了解如何在不安装任何工具的情况下快速编辑。

建议进行主要更改的参与者完成这些步骤。 即使具有针对主存储库的写入权限,也强烈建议(同时本指南假定)为存储库创建分支并克隆存储库,并在分支中存储建议的更改。

在本文中,你将:

安装适用于 Windows 的 Git 客户端工具

此安装包括 Git 版本控制系统,以及用于与本地 Git 存储库进行交互的命令行应用 Git Bash。

  1. 下载 Git for Windows

  2. 运行下载的可执行文件 (.EXE) 文件,然后按照提示安装。 在每次出现提示时选择“下一步”以接受所有默认设置。

  3. 出现提示时,选择代码编辑器。 默认编辑器为 Vim。

  4. 选择“完成”以完成安装。

安装 Git for Windows 后,配置 Git 名称和电子邮件地址。

安装适用于 Mac 和 Linux 的 Git 客户端工具

  • Git for Mac 作为 Xcode 命令行工具的一部分提供。 只需从命令行运行 git。 系统将提示你安装命令行工具(如有必要)。 你也可以从软件自由保护组织中下载 Git for Mac
  • Git for Linux 和 Git for Unix

按照说明,对选定的客户端进行安装和配置。

安装 Visual Studio Code

Visual Studio Code 是一种轻型编辑器,适用于 Windows、Linux 和 Mac。 它包括 Git 集成和扩展支持。

下载和安装适用于操作系统的 Visual Studio Code:

在安装过程中接受所有默认设置。

提示

要启动 VS Code 和打开当前文件夹,请运行命令行中的 code . 命令或 Bash shell。 如果当前文件夹是本地 Git 存储库的一部分,GitHub 集成将在 Visual Studio Code 中自动显示。

安装 Learn 创作包

Visual Studio Code 的 Learn 创作包中包括基本的 Markdown 创作协助、页面预览、对 Markdown 模板的支持、markdownlint 和代码拼写检查器。 这些功能简化了参与流程。 在这种情况下,我们认为 Learn 创作包对参与者来说是一种必备扩展。

要安装 Learn 创作包,请从 VS Code 商城中的 Learn 创作包页面安装。

要使用 Learn 创作包功能,请在 Visual Studio Code 中按 Alt+M。 若要配置工具栏以显示可用的功能,请编辑 Visual Studio Code 设置(Ctrl+逗号),然后添加用户设置 "markdown.showToolbar": true

有关详细信息,请参阅“适用于 Visual Studio Code 的 Learn 创作包”。

了解 Markdown 编辑器

Markdown 是一种用于创作内容的轻型标记语言。 Visual Studio Code 是用于在 Microsoft 中编辑 Markdown 的首选工具。 还可以使用其他 Markdown 编辑工具。 Markdown 参考文章介绍了 Markdown 基础知识和网站 learn.microsoft.com 支持的功能。

后续步骤

现在可以开始设置本地 Git 存储库了。