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

Migrate pages from the wiki extension to a team project wiki

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

Learn how to migrate pages created using the Wiki Marketplace extension to your team project wiki. You can save any wiki pages created using the Wiki Marketplace extension to a Git repo in your team project.

Примечание.

The Wiki Marketplace extension is deprecated. Uninstall it after you migrate your pages.

Необходимые условия

Категория Требования
Project access Член проекта, в котором находится вики-сайт. Если у вас нет доступа, попросите его от администратора проекта.
Permissions Member of the Contributors group.
Уровни доступа At least Basic access.

Overview of migrating pages and other artifacts

  1. Clone the vsts-wikiTools repository and compile the MigrateToVSTSWiki tool.
  2. Создайте и клонируйте вики-сайт Azure DevOps.
  3. Переместите и зафиксируйте все страницы Markdown в вики-сайт Azure DevOps.
  4. Запустите средство миграции вики-сайта MigrateToVSTSWiki.exe
  5. When the wiki migration tool is complete, push the changes to the default main branch, wikiMain, of the Azure DevOps wiki repository.

Migrate pages from the wiki extension

  1. Clone the vsts-wikiTools repository and compile the MigrateToVSTSWiki tool.

  2. To generate the migration tool EXE, compile the project under the path Tools/MigrateToVSTSWiki.

  3. В веб-браузере откройте командный проект Azure DevOps и создайте первую вики-страницу.

  4. To clone your wiki, get the URL. For more information, see Clone your wiki and edit wiki pages offline.
    Name this clone location as LocationA for this procedure.

  5. Clone your wiki repo using your IDE or the git clone command.

  6. Clone the wiki extension repo. Вики-сайт сопоставляется с папкой, предоставленной вам во время создания вики-сайта. Вы можете подтвердить это, перейдя к параметру "управление вики" в существующем вики-сайте, как показано в следующем примере. Существующие вики-страницы сохраняются под папкой, помеченной Root.

    For example, you cloned the previously mentioned sampleWiki in the location C:\wiki\sampleWiki*. The wiki pages are saved in the path *C:\wiki\sampleWiki\ _extensionWiki

    Назовите это место LocationB для этой процедуры.

  7. Создайте пустую папку в любом пути на локальном компьютере и назовите ее LocationC для этой процедуры.

    В итоге следующие расположения представлены следующим образом:

    • Location A = Azure DevOps Wiki repo
    • Location B = Wiki extension repo
    • Location C = Пустая папка для запуска средства миграции

  8. Откройте командную строку от имени администратора и запустите MigrateToVSTSWiki.exe. Это средство копирует файлы из существующего вики-сайта в указанный вами каталог назначения. Во время копирования средство преобразует страницы в соответствие с вики-сайтом Azure DevOps.

    MigrateToVSTSWiki.exe /source:LocationB /destination:LocationC

    Например:

    • E:\wiki\sampleWiki\_extensionWiki — это папка, в которой присутствуют существующие вики-файлы
    • E:\Temp\Wiki\New — пустая папка, в которую копируются перенесенные файлы.

  9. Удалите все файлы из LocationA (если таковые) помимо связанных файлов Git, таких как .gitignoreи т. д.

  10. Скопируйте все файлы из LocationC и вставьте их в LocationA.

  11. Запустите git add ., чтобы подготовить к коммиту все новые добавленные файлы в LocationA.

  12. Run git commit -m <commit message> to commit the locally staged files.

  13. Запустите git push origin wikiMain -f, чтобы отправить изменения в ветвь по умолчанию вики-сайта Azure DevOps.

After you migrate your wiki extension files to the Azure DevOps wiki, you're ready to uninstall the Wiki extension.

Дальнейшие действия

Uninstall the Wiki extension

Взносы

Этот проект принял Microsoft Open Source Code of Conduct. For more information, see the Code of Conduct FAQ or contact opencode@microsoft.com with any questions or comments.