Перенос страниц из вики-расширения в вики-проекта группы
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Узнайте, как перенести страницы, созданные с помощью расширения Wiki Marketplace в вики-сайт проекта группы. С выпуском встроенной вики-системы любые вики-страницы, созданные с помощью расширения Wiki Marketplace, можно сохранить в командном Git-репозитории.
Необходимые условия
Категория | Требования |
---|---|
доступ к проекту | Член проекта, в котором находится вики-сайт. Если у вас нет доступа, попросите его от администратора проекта. |
разрешения | Участник группы участников. |
Уровни доступа | По крайней мере базовый доступ . |
Перенос страниц и других артефактов
- Клонируйте vsts-wikiTools репозиторий и скомпилируйте средство MigrateToVSTSWiki.
- Создайте и клонируйте вики-сайт Azure DevOps.
- Переместите и зафиксируйте все страницы Markdown в вики-сайт Azure DevOps.
- Запустите средство миграции вики-сайта MigrateToVSTSWiki.exe
- После завершения инструмента вики-миграции отправьте изменения в основную ветвь по умолчанию,
wikiMain
, репозитория вики-сайта Azure DevOps.
Подробные шаги
Клонируйте vsts-wikiTools репозиторий и скомпилируйте средство MigrateToVSTSWiki.
Скомпилируйте проект по пути
Tools/MigrateToVSTSWiki
, чтобы создать средство миграции EXE.В веб-браузере откройте командный проект Azure DevOps и создайте первую вики-страницу.
Получите URL-адрес для клонирования вики-сайта. См. статью Клонируйте ваш вики и изменяйте страницы вики в автономном режиме.
Присвойте этому клону имяLocationA
для этой процедуры.Клонируйте репозиторий wiki с помощью интегрированной среды разработки или команды клонирования git.
Клонируйте репозиторий вики-расширения. Вики-сайт сопоставляется с папкой, предоставленной вам во время создания вики-сайта. Вы можете подтвердить это, перейдя к параметру "управление вики" в существующем вики-сайте, как показано в следующем примере. Существующие вики-страницы сохраняются под папкой, помеченной
Root
.Например, вы клонировали ранее упомянутые
sampleWiki
в расположенииC:\wiki\sampleWiki*. The wiki pages are saved in the path *C:\wiki\sampleWiki\ _extensionWiki
Назовите это место
LocationB
для этой процедуры.Создайте пустую папку в любом пути на локальном компьютере и назовите ее
LocationC
для этой процедуры.В итоге следующие расположения представлены следующим образом:
- Location A = репозиторий Azure DevOps Wiki
- Расположение B = репозиторий расширения Wiki
- Location C = Пустая папка для запуска средства миграции
Откройте командную строку от имени администратора и запустите
MigrateToVSTSWiki.exe
. Это средство копирует файлы из существующего вики-сайта в указанный вами каталог назначения. Во время копирования средство преобразует страницы в соответствие с вики-сайтом Azure DevOps.MigrateToVSTSWiki.exe /source:LocationB /destination:LocationC
Например:
-
E:\wiki\sampleWiki\_extensionWiki
— это папка, в которой присутствуют существующие вики-файлы -
E:\Temp\Wiki\New
— пустая папка, в которую копируются перенесенные файлы.
-
Удалите все файлы из
LocationA
(если таковые) помимо связанных файлов Git, таких как.gitignore
и т. д.Скопируйте все файлы из
LocationC
и вставьте их вLocationA
.Запустите
git add .
, чтобы подготовить к коммиту все новые добавленные файлы вLocationA
.Запустите
git commit -m <commit message>
, чтобы зафиксировать локальные промежуточные файлы.Запустите
git push origin wikiMain -f
, чтобы отправить изменения в ветвь по умолчанию вики-сайта Azure DevOps.
После переноса файлов вики-расширений в вики-сайт Azure DevOps вы готовы к удалению вики-расширения.
Связанные статьи
- правила именования страниц на вики
- Клонировать и обновить вики-страницы в автономном режиме
- исходный код для вики-инструментов
- Быстрый старт по Git
Взносы
Этот проект принял Microsoft Open Source Code of Conduct. Дополнительные сведения см. в часто задаваемых вопросов или контактных данных opencode@microsoft.com с любыми вопросами или комментариями.