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

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

  • Статья

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 можно удалить расширение Wiki.

Участие в проекте

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