Поделиться через

Клонирование и обновление вики-содержимого в автономном режиме

  • Статья

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Вы можете обновлять вики-страницы в автономном режиме таким же образом, как и при разработке кода в репозитории Git.

Вы можете использовать любой клиент, который хотите или средства командной строки Git, для обновления вики-сайта в автономном режиме. Дополнительные сведения о работе с репозиториями и поддерживаемыми средствами Git см. в статье Репозитории Git.

Ниже описаны основные действия по обновлению вики-содержимого в автономном режиме.

  1. Клонируйте репозиторий wiki Git в локальную интегрированную среду разработки или рабочую область.
  2. Добавьте файлы или папки в локальную ветвь Git.
  3. Обновите файлы order, чтобы отразить страницы и вложенные страницы.
  4. Зафиксируйте и отправьте обновления, внесенные в локальную ветвь Git.

Необходимые компоненты

Выполните следующие действия, чтобы перенести страницы Markdown из другого вики-сайта в вики-проект группы или содержимое, которое вы публикуете в качестве кода в вики-сайте.

Клонирование вики-сайта

Вики-репозиторий хранятся страницы, изображения, вложения и последовательность страниц и вложенных страниц. Клонируйте вики-сайт, чтобы начать.

  1. Войдите в проект (https://dev.azure.com/{Your_Organization/Your_Project}) и выберите вики-сайт.

  2. Откройте контекстное меню "Дополнительные действия" и выберите "Клонировать вики-сайт".

    Клонирование репозитория вики-сайта Git

  3. В диалоговом окне "Клонировать репозиторий" выберите "Копировать URL-адрес клона" в буфер обмена.

    Копирование URL-адреса вики-сайта

    Введите его в браузере, чтобы просмотреть файлы, определенные в ветви wikiMaster.

    Вики-основные файлы

  4. Используйте URL-адрес, скопированный для клонирования репозитория в интегрированной среде разработки. Дополнительные сведения см. в следующих статьях:

Добавление страниц в локальный репозиторий Git

Мы создаем страницы с помощью формата Markdown. Добавьте файл Markdown в локальную ветвь для каждой страницы и вложенной страницы, которую вы хотите добавить в вики-сайт.

Добавление страниц

Чтобы добавить страницы в корне вики-дерева, добавьте файл Markdown в корне репозитория Git.

  1. Для каждой страницы, которую вы хотите добавить, создайте файл Markdown с содержимым страницы, а затем добавьте его в корневую папку для репозитория.

    Для командного проекта CanaryBuilds он находится в следующей папке:

    C:\Users\UserName\Source\Repos\CanaryBuilds.wiki

  2. Чтобы добавить страницы в корне вики-дерева, добавьте файл Markdown для каждой страницы в корне репозитория Git.

    Репозиторий Git в локальной ветви

  3. После добавления всех страниц, которые нужно добавить в корневой каталог, обновите файл order в корневом каталоге. Она должна содержать одну запись для каждого файла Markdown, определенного в корневом каталоге. Каждая запись должна соответствовать заголовку файла с пробелами, замененными тире.

    Например:

     Welcome
 Roadmap  
 How-to-contribute  
 Home  
 Reference

Добавление вложенных страниц

  1. Создайте папку для родительской страницы и добавьте файлы Markdown для каждой подпапки в папке.

    Например, мы добавили следующие файлы в папку "Практическое руководство". Эти вложенные страницы отображаются на странице "Как внести вклад" в вики-сайте.

    Снимок экрана: вложенные страницы.

  2. Добавьте файл order в папку с порядком вложенных страниц, так как они должны отображаться в вики-сайте. Сведения об использовании файла order для последовательности страниц см. в файлах репозитория Wiki Git и структуре файлов.

    Например, файл содержит следующие вложенные страницы:

     Request-extensions  
 Licensing  
 Smoke-test  
 Coding-guidelines

Отправка изменений

После завершения работы со всеми обновлениями отправьте файлы в репозиторий Git.

Добавленные страницы и вложенные страницы отображаются сразу же в вики-сайте.

Вики-дерево обновлено

Если в процессе возникают ошибки, страницы отображаются в вики-сайте с знаком предупреждения.

Предупреждение при неправильном обновлении файла order.