Подготовленные вики-сайты и опубликованный код в качестве вики-сайта

  • Статья

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

В Azure DevOps вы можете поддерживать вики-содержимое вики-проекта группы или опубликованную в качестве вики-сайта кода. Используя вики-сайт, опубликованный как код, вы можете поддерживать несколько версий вики-сайтов для поддержки потребностей содержимого, хотя оно доступно только в том случае, если Azure Repos включен.

Хотя оба варианта поддерживают вики-содержимое в репозиториях Git, способы добавления и обновления вики-содержимого, а также управления им будут различными.

Примечание.

Код публикации как вики-функция в настоящее время доступен в Azure DevOps Server 2018 и более поздних версиях. Для более старых версий можно подготовить только вики-сайт для проекта группы.

Параметры меню вики-страницы

С помощью подготовленного вики-сайта можно добавлять и изменять страницы непосредственно в вики-сайте. Все обновления содержимого подготовленного вики-сайта происходят в вики-сайте.

С помощью кода публикации в качестве вики-сайта можно добавлять, изменять и обновлять содержимое из Репозитория или кода.

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

Снимок экрана: параметры меню

Например, параметр "Изменить в Репозитории" для кода публикации, так как вики-сайт принимает вас на страницу репозитория, чтобы изменить эту конкретную страницу. Обновления, что вы делаете на страницу в ветви, выбранной для вики-сайта, автоматически публикуется в вики-сайте.

Поддерживаемые функции и операционные различия

Оба типа вики-сайта поддерживают следующие функции:

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

Операция Подготовленный вики-сайт Публикация кода в виде вики-сайта
Поддержка нескольких вики-сайтов, имя вики-сайта ✔️
Добавление или изменение страниц из файлов Репозитория>или файлов кода> ✔️
Возврат к более ранней редакции из вики-сайта ✔️
Возврат к более ранней редакции из Репозитория или кода ✔️ ✔️
Обслуживание версий вики-сайтов ✔️
Выбор вики-версии ✔️
Отмена публикации вики-сайта кода ✔️

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

Для обоих типов вики-страницы выберите "Создать" или "Добавить вложенную страницу". Дополнительные сведения см. в разделе "Добавление и изменение вики-страниц".

Последовательность страниц и список страниц в области навигации

Подготовленный вики-сайт автоматически управляет последовательностью страниц и списком страниц при добавлении или перемещении страниц в области навигации.

Чтобы структурировать список страниц в области навигации для вики-кода публикации, определите файл order в корне и для каждой подпапки или родительской страницы, содержащей вложенные страницы.

Оба типа вики-сайтов соответствуют той же структуре файлов, что и код публикации, так как вики-сайт требует, чтобы вы поддерживали последовательность страниц вручную.

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

Редакции страниц и отменить изменения для предыдущей версии

Вики-сайт можно просмотреть редакции любой вики-страницы. Выберите пункт "Редакции " или меню "Просмотр редакций ".

Но процесс отменить изменения отличается в зависимости от типа вики-страницы.

Управление версиями и отмена публикации вики-сайта

С помощью управления версиями можно публиковать различные версии содержимого в разных вики-сайтах на основе версии ветвь репозитория Git. Управление версиями и отмена публикации вики-сайта поддерживается только для вики-сайтов, созданных путем публикации кода вики-сайта. Дополнительные сведения см. в статье "Публикация вики-сайта кода" или "Отмена публикации вики-кода".

Удаление вики-сайта проекта

Примечание.

Вики-ИНТЕРФЕЙСы REST API не поддерживают удаление вики-сайта проекта. Поэтому вместо этого необходимо удалить вики-репозиторий.

  1. Клонируйте вики-репозиторий, чтобы создать резервную копию всего содержимого. Дополнительные параметры имеют клонированный вики-URL-адрес, который можно использовать для клонирования вики-сайта.

  2. Получите идентификатор репозитория Git, который поддерживает вики-сайт. REST API можно использовать для получения всех вики-сайтов в проекте.

    Например, GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1 возвращает все вики-сайты в проекте, чтобы выбрать один из них для удаления.

  3. Используйте REST API для удаления резервного репозитория Git. Используйте идентификатор репозитория вики-сайта проекта, который вы нашли на предыдущем шаге, и дважды проверка идентификатор репозитория, чтобы не удалить неправильный.

    Например: DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/{repositoryId}?api-version=4.1

Обновление вики-сайта в автономном режиме

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