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

Перенос страниц из вики-расширения в вики-проекта группы

  • Статья

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

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

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

Категория Требования
доступ к проекту Член проекта, в котором находится вики-сайт. Если у вас нет доступа, попросите его от администратора проекта.
разрешения Участник группы участников.
Уровни доступа По крайней мере базовый доступ .

Перенос страниц и других артефактов

  1. Клонируйте vsts-wikiTools репозиторий и скомпилируйте средство MigrateToVSTSWiki.
  2. Создайте и клонируйте вики-сайт Azure DevOps.
  3. Переместите и зафиксируйте все страницы Markdown в вики-сайт Azure DevOps.
  4. Запустите средство миграции вики-сайта MigrateToVSTSWiki.exe
  5. После завершения инструмента вики-миграции отправьте изменения в основную ветвь по умолчанию, wikiMain, репозитория вики-сайта Azure DevOps.

Подробные шаги

  1. Клонируйте vsts-wikiTools репозиторий и скомпилируйте средство MigrateToVSTSWiki.

  2. Скомпилируйте проект по пути Tools/MigrateToVSTSWiki, чтобы создать средство миграции EXE.

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

  4. Получите URL-адрес для клонирования вики-сайта. См. статью Клонируйте ваш вики и изменяйте страницы вики в автономном режиме.
    Присвойте этому клону имя LocationA для этой процедуры.

  5. Клонируйте репозиторий wiki с помощью интегрированной среды разработки или команды клонирования git.

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

    Например, вы клонировали ранее упомянутые sampleWiki в расположении C:\wiki\sampleWiki*. The wiki pages are saved in the path *C:\wiki\sampleWiki\ _extensionWiki

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

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

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

    • Location A = репозиторий Azure DevOps Wiki
    • Расположение B = репозиторий расширения Wiki
    • 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. Запустите git commit -m <commit message>, чтобы зафиксировать локальные промежуточные файлы.

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

После переноса файлов вики-расширений в вики-сайт Azure DevOps вы готовы к удалению вики-расширения.

Взносы

Этот проект принял Microsoft Open Source Code of Conduct. Дополнительные сведения см. в часто задаваемых вопросов или контактных данных opencode@microsoft.com с любыми вопросами или комментариями.