Установка средств разработки содержимого

В этой статье описывается, как установить рекомендуемые инструменты, необходимые для эффективного глубокого или большого вклада в Microsoft Learn. Ниже приведены примеры основных обновлений:

• Длительные редакции в нескольких статьях
• Создание статьи
• Работа, для которой требуется использовать доступные расширения Visual Studio Code, например пакет разработки Learn.

Важно!

Если вы вносите только незначительные изменения, вам не нужно выполнить действия, описанные в этой статье. См. статью "Изменить" в браузере , чтобы узнать, как быстро изменять без установки средств.

Участники, которые будут вносить крупные изменения, рекомендуется выполнить эти действия. Даже если у вас есть разрешения на запись в основном репозитории, мы настоятельно рекомендуем (и в этом руководстве предполагается), что вы вилку и клонируете репозиторий и храните предлагаемые изменения в вилке.

Работая с этой статьей, вы узнаете о следующем.

• Установка репозитория Git
• Установка Visual Studio Code
• Установка пакета разработки Learn

Установка клиентских средств Git для Windows

Эта установка включает систему управления версиями Git и Git Bash, приложение командной строки, используемое для взаимодействия с локальным репозиторием Git.

1. Скачайте Git для Windows.

2. Запустите скачанный исполняемый файл (.EXE) и следуйте инструкциям по установке. Щелкните Далее в каждом запросе, чтобы принять все параметры по умолчанию.

3. При появлении запроса выберите редактор кода. Редактор кода по умолчанию — Vim.

4. Щелкните Готово, чтобы завершить установку.

После установки Git для Windows настройте имя Git и адрес электронной почты.

Установка клиентских средств Git для Mac и Linux

• Git для Mac предоставляется как часть средств командной строки Xcode. Просто запустите git из командной строки. При необходимости вам будет предложено установить средства командной строки. Вы также можете скачать Git для Mac из Software Freedom Conservancy.
• Git для Linux и Unix

Следуйте инструкциям по установке и настройке для выбранного клиента.

Установка Visual Studio Code

Visual Studio Code — это упрощенный редактор, который работает в Windows, Linux и Mac. Она включает интеграцию Git и поддержку расширений.

Скачайте и установите Visual Studio Code для операционной системы:

• Windows.
• Mac
• Linux

Во время установки примите все параметры по умолчанию.

Совет

Чтобы запустить VS Code и открыть текущую папку, выполните команду code . в командной строке или оболочке Bash. Если текущая папка является частью локального репозитория Git, интеграция GitHub отображается в Visual Studio Code автоматически.

Установка пакета разработки Learn

Пакет разработки Learn для Visual Studio Code включает базовую помощь по разработке Markdown, предварительные просмотры страниц, поддержку шаблонов Markdown, markdownlint и средства проверки орфографии. Эти функции упрощают и упрощают процесс вклада. Таким образом, мы считаем пакет разработки Learn обязательным расширением для участник.

Чтобы установить пакет разработки Learn, выберите "Установить " на странице пакета разработки Learn в VS Code Marketplace.

Чтобы использовать функцию пакета разработки Learn, нажмите клавишу Alt+M Visual Studio Code. Чтобы настроить панель инструментов для отображения доступных возможностей, измените параметры Visual Studio Code (CTRL+запятая) и добавьте параметр пользователя "markdown.showToolbar": true.

Дополнительные сведения см. в статье Learn Authoring Pack for Visual Studio Code.

Сведения о редакторах Markdown

Markdown — это упрощенный язык разметки, используемый для создания содержимого. Visual Studio Code — предпочтительное средство для редактирования разметки Markdown в Майкрософт. Доступны другие средства редактирования Markdown. В статье "Справочник по Markdown" рассматриваются основы Markdown и функции, поддерживаемые веб-сайтом learn.microsoft.com .

Следующие шаги

Теперь вы готовы настроить локальный репозиторий Git.