Подготовленная вики-страница и опубликованная как вики-сайт кода
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Вы можете поддерживать вики-содержимое вики-проекта группы или опубликованную в качестве вики-кода. Используя вики-сайт, опубликованный как код, вы можете поддерживать несколько версий вики-сайтов для поддержки потребностей содержимого, хотя оно доступно только в том случае, если Azure Repos включен.
Хотя оба варианта поддерживают вики-содержимое в репозиториях Git, способы добавления и обновления вики-содержимого, а также управления им будут различными.
Примечание.
Опубликованная вики-функция вики-кода в настоящее время доступна в Azure DevOps Server 2018 и более поздних версиях. Для более старых версий можно подготовить только вики-сайт для проекта группы.
Параметры меню вики-страницы
С помощью подготовленного вики-сайта можно добавлять и изменять страницы непосредственно в вики-сайте. Все обновления содержимого подготовленного вики-сайта происходят в вики-сайте.
С помощью вики-сайта, опубликованного как код, можно добавлять, изменять и обновлять содержимое из Репозитория или кода.
На следующем рисунке показаны параметры подготовленного вики-сайта. Некоторые из этих вариантов не поддерживаются для опубликованных вики-страниц кода.
Например, параметр "Изменить в Репозитории " для опубликованного вики-файла вики-кода позволяет изменить эту определенную страницу репозитория . Обновления, внесенные на страницу в ветви, выбранной для вики-сайта, автоматически публикуются в вики-сайте.
Поддерживаемые функции и операционные различия
Оба типа вики-сайта поддерживают следующие функции:
- Формат Markdown
- HTML-теги
- Вставка и изменение размера изображений
- Математические нотации и символы
- Связывание с рабочими элементами с помощью #
- Присоединение файлов
- Фильтрация содержимого вики-сайта
- Печать вики-страницы
- Обновление содержимого в автономном режиме
- Добавление или изменение страниц из вики-сайта
В следующей таблице приведены сведения об этих операциях или функциях, которые могут отличаться в зависимости от вики-типа.
| Операция | Подготовленный вики-сайт | Опубликовано как вики-сайт кода |
|---|---|---|
| Поддержка нескольких вики-сайтов, имя вики-сайта | ✔️ | |
| Добавление или изменение страниц из файлов Репозитория>или файлов кода> | ✔️ | |
| Возврат к более ранней редакции из вики-сайта | ✔️ | |
| Возврат к более ранней редакции из Репозитория или кода | ✔️ | ✔️ |
| Обслуживание версий вики-сайтов | ✔️ | |
| Выбор вики-версии | ✔️ | |
| Отмена публикации вики-сайта кода | ✔️ |
Добавление страниц
Для обоих типов вики-страницы выберите "Создать" или "Добавить вложенную страницу". Дополнительные сведения см. в разделе "Добавление и изменение вики-страниц".
Последовательность страниц и список страниц в области навигации
Подготовленный вики-сайт автоматически управляет последовательностью страниц и списком страниц при добавлении или перемещении страниц в области навигации.
Чтобы структурировать список страниц в области навигации для опубликованного вики-кода, определите *.order* файл в корне и для каждой подпапки или родительской страницы, содержащей вложенные страницы.
Оба типа вики-сайтов следуют одной и той же структуре файлов, это просто то, что опубликованный вики-код требует, чтобы вы поддерживали последовательность страниц вручную.
Дополнительные сведения о работе с файлами .order см. в файлах репозитория Wiki Git и структуре файлов.
Редакции страниц и возврат к предыдущей версии
Вики-сайт можно просмотреть редакции любой вики-страницы. Выберите пункт "Редакции " или меню "Просмотр редакций ".
Но процесс возврата отличается в зависимости от типа вики-страницы.
- Для подготовленной вики-страницы выберите "Вернуть", как описано в разделе "Вернуть фиксацию на подготовленную вики-страницу"
- Для опубликованной вики-страницы, опубликованной как код, обратитесь к локальной ветви и отправьте запрос на вытягивание, чтобы обновить ветвь, из которую вы работаете.
Управление версиями и отмена публикации вики-сайта
С помощью управления версиями можно публиковать различные версии содержимого в разных вики-сайтах на основе версии ветвь репозитория Git. Вы можете использовать версию и отменить публикацию вики-сайта только в том случае, если вы создали его, публикуя код в вики-сайте. Дополнительные сведения см. в статье "Отмена публикации вики-сайта кода".
Удаление вики-сайта проекта
Примечание.
Вики-ИНТЕРФЕЙСы REST API не поддерживают удаление вики-сайта проекта. Поэтому вместо этого необходимо удалить вики-репозиторий.
Клонируйте вики-репозиторий, чтобы создать резервную копию всего содержимого. Дополнительные параметры имеют клонированный вики-URL-адрес, который можно использовать для клонирования вики-сайта.
Получите идентификатор репозитория Git, который поддерживает вики-сайт. REST API можно использовать для получения всех вики-сайтов в проекте.
Например,
GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1возвращает все вики-сайты в проекте, чтобы выбрать один из них для удаления.Используйте REST API для удаления резервного репозитория Git. Используйте идентификатор репозитория вики-сайта проекта, который вы нашли на предыдущем шаге, и дважды проверьте идентификатор репозитория, чтобы не удалить неправильный.
Например:
DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/{repositoryId}?api-version=4.1
Обновление вики-сайта в автономном режиме
Вы можете работать в автономном режиме или в локальной ветви для обновления содержимого подготовленного вики-сайта и публикации в качестве вики-кода. Дополнительные сведения см. в разделе "Клонирование" и обновление вики-страниц в автономном режиме.