Подготовленные вики-сайты и опубликованный код в качестве вики-сайта
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
В Azure DevOps вы можете поддерживать вики-содержимое вики-проекта группы или опубликованную в качестве вики-сайта кода. Используя вики-сайт, опубликованный как код, вы можете поддерживать несколько версий вики-сайтов для поддержки потребностей содержимого, хотя оно доступно только в том случае, если Azure Repos включен.
Хотя оба варианта поддерживают вики-содержимое в репозиториях Git, способы добавления и обновления вики-содержимого, а также управления им будут различными.
Примечание.
Код публикации как вики-функция в настоящее время доступен в Azure DevOps Server 2018 и более поздних версиях. Для более старых версий можно подготовить только вики-сайт для проекта группы.
Параметры меню вики-страницы
С помощью подготовленного вики-сайта можно добавлять и изменять страницы непосредственно в вики-сайте. Все обновления содержимого подготовленного вики-сайта происходят в вики-сайте.
С помощью кода публикации в качестве вики-сайта можно добавлять, изменять и обновлять содержимое из Репозитория или кода.
На следующем рисунке показаны параметры подготовленного вики-сайта. Некоторые из этих параметров не поддерживаются для публикации в виде вики-страниц кода.
Например, параметр "Изменить в Репозитории" для кода публикации, так как вики-сайт принимает вас на страницу репозитория, чтобы изменить эту конкретную страницу. Обновления, что вы делаете на страницу в ветви, выбранной для вики-сайта, автоматически публикуется в вики-сайте.
Поддерживаемые функции и операционные различия
Оба типа вики-сайта поддерживают следующие функции:
- Формат Markdown
- HTML-теги
- Вставка и изменение размера изображений
- Математические нотации и символы
- Связывание с рабочими элементами с помощью #
- Присоединение файлов
- Фильтрация содержимого вики-сайта
- Печать вики-страницы
- Обновление содержимого в автономном режиме
- Добавление или изменение страниц из вики-сайта
В следующей таблице приведены сведения об этих операциях или функциях, которые могут отличаться в зависимости от вики-типа.
Операция | Подготовленный вики-сайт | Публикация кода в виде вики-сайта |
---|---|---|
Поддержка нескольких вики-сайтов, имя вики-сайта | ✔️ | |
Добавление или изменение страниц из файлов Репозитория>или файлов кода> | ✔️ | |
Возврат к более ранней редакции из вики-сайта | ✔️ | |
Возврат к более ранней редакции из Репозитория или кода | ✔️ | ✔️ |
Обслуживание версий вики-сайтов | ✔️ | |
Выбор вики-версии | ✔️ | |
Отмена публикации вики-сайта кода | ✔️ |
Добавление страниц
Для обоих типов вики-страницы выберите "Создать" или "Добавить вложенную страницу". Дополнительные сведения см. в разделе "Добавление и изменение вики-страниц".
Последовательность страниц и список страниц в области навигации
Подготовленный вики-сайт автоматически управляет последовательностью страниц и списком страниц при добавлении или перемещении страниц в области навигации.
Чтобы структурировать список страниц в области навигации для вики-кода публикации, определите файл order в корне и для каждой подпапки или родительской страницы, содержащей вложенные страницы.
Оба типа вики-сайтов соответствуют той же структуре файлов, что и код публикации, так как вики-сайт требует, чтобы вы поддерживали последовательность страниц вручную.
Дополнительные сведения о работе с файлами order см. вики-файлах репозитория 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
Обновление вики-сайта в автономном режиме
Вы можете работать в автономном режиме или в локальной ветви для обновления содержимого подготовленного вики-сайта и публикации в качестве вики-кода. Дополнительные сведения см. в разделе "Клонирование" и обновление вики-страниц в автономном режиме.
Связанные статьи
Кері байланыс
https://aka.ms/ContentUserFeedback.
Жақында қолжетімді болады: 2024 жыл бойы біз GitHub Issues жүйесін мазмұнға арналған кері байланыс механизмі ретінде біртіндеп қолданыстан шығарамыз және оны жаңа кері байланыс жүйесімен ауыстырамыз. Қосымша ақпаратты мұнда қараңыз:Жіберу және пікірді көру