安装内容创作工具
本文介绍了如何安装推荐的工具,以便高效、深入或大量参与 Microsoft Learn。 主要更新示例包括:
- 对多篇冗长文章进行了修订
- 创建新文章
- 支持可用的 Visual Studio Code 扩展,例如 Learn 创作包。
重要
如果要进行次要更改,无需完成本文中的相关步骤。 请参阅“在浏览器中编辑”,了解如何在不安装任何工具的情况下快速编辑。
建议进行主要更改的参与者完成这些步骤。 即使具有针对主存储库的写入权限,也强烈建议(同时本指南假定)为存储库创建分支并克隆存储库,并在分支中存储建议的更改。
在本文中,你将:
- 安装 Git
- 安装 Visual Studio Code
- 安装 Learn 创作包
安装适用于 Windows 的 Git 客户端工具
此安装包括 Git 版本控制系统,以及用于与本地 Git 存储库进行交互的命令行应用 Git Bash。
下载 Git for Windows。
运行下载的可执行文件 (.EXE) 文件,然后按照提示安装。 在每次出现提示时选择“下一步”以接受所有默认设置。
出现提示时,选择代码编辑器。 默认编辑器为 Vim。
选择“完成”以完成安装。
安装 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 存储库了。