安裝內容撰寫工具

本文說明如何安裝建議的工具，以對 Microsoft Learn 進行有效率的深入或大量貢獻。 主要更新的範例包括：

• 多個發行項的冗長修訂
• 建立新文章
• 使用您想要使用可用的 Visual Studio Code 延伸模組，例如 Learn Authoring Pack。

重要

如果您只進行次要變更，就 不需要 完成本文中的步驟。 請參閱 瀏覽器中的 [編輯]，瞭解如何在不安裝任何工具的情況下快速編輯。

建議進行重大變更的參與者完成這些步驟。 即使您在主要存放庫中具有寫入許可權， 我們仍強烈建議您（本指南假設）派生並複製存放庫 ，並將建議的變更儲存在分叉中。

在本文中，您將：

• 安裝 Git
• 安裝 Visual Studio Code
• 安裝 Learn Authoring Pack

安裝適用於 Windows 的 Git 用戶端工具

此安裝包含 Git 版本控制系統和 Git Bash，這是您用來與本機 Git 存放庫互動的命令行應用程式。

1. 下載 Git for Windows。

2. 執行下載的可執行檔 （.EXE） 檔案，並遵循提示進行安裝。 在每個提示字元中選取 [下一步 ]，以接受所有預設設定。

3. 出現提示時，選取程式代碼編輯器。 默認程式代碼編輯器為 Vim。

4. 選取 [完成 ] 以完成安裝。

安裝 Git for Windows 之後，請設定您的 Git 名稱和電子郵件位址。

安裝適用於 Mac 和 Linux 的 Git 用戶端工具

• 適用於 Mac 的 Git 是隨著 Xcode 命令列工具提供。 只要從命令列執行 git。 系統將會提示您視需要安裝該命令列工具。 您也可以從 Software Freedom Conservancy 下載適用於 Mac 的 Git。
• 適用於 Linux 與 Unix 的 Git

請遵循您所選擇用戶端的指示，以進行安裝與設定。

安裝 Visual Studio Code

Visual Studio Code 是可在 Windows、Linux 和 Mac 上運作的輕量型編輯器。 它包含 Git 整合和支援延伸模組。

下載並安裝適用於您作業系統的 Visual Studio Code：

• Windows.
• Mac：
• Linux：

在安裝期間，接受所有預設設定。

提示

若要啟動 VS Code 並開啟目前的資料夾，請在命令行或 Bash 殼層中執行 命令 code . 。 如果目前資料夾是本機 Git 存放庫的一部分，則 GitHub 整合會自動出現在 Visual Studio Code 中。

安裝 Learn Authoring Pack

適用於 Visual Studio Code 的 Learn Authoring Pack 包含基本的 Markdown 撰寫協助、頁面預覽、Markdown 範本的支援、Markdownlint 和程式代碼拼字檢查工具。 這些功能可簡化並簡化參與程式。 因此，我們認為 Learn Authoring Pack 是 參與者的必要 擴充功能。

若要安裝 Learn Authoring Pack，請選擇 VS Code Marketplace 中的 [學習撰寫套件] 頁面的 [安裝]。

若要使用 Learn Authoring Pack 功能，請在 Visual Studio Code 中按 Alt+M 。 若要設定工具列以顯示可用的函式，請編輯 Visual Studio Code 設定 （Control+逗號），並新增使用者設定 "markdown.showToolbar": true。

如需詳細資訊，請參閱 Learn Authoring Pack for Visual Studio Code。

了解 Markdown 編輯器

Markdown 是用來撰寫內容的輕量標記語言。 Visual Studio Code 是 Microsoft 用來編輯 Markdown 的偏好工具。 其他 Markdown 編輯工具可供使用。 Markdown 參考 文章涵蓋 Markdown 基本概念和網站支援 learn.microsoft.com 的功能。

下一步

現在您已準備好 設定本機 Git 存放庫。