共用方式為


安裝內容撰寫工具

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

  • 多個發行項的冗長修訂
  • 建立新文章
  • 使用您想要使用可用的 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 用戶端工具

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

安裝 Visual Studio Code

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

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

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

提示

若要啟動 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 存放庫