Udostępnij za pośrednictwem


Klonowanie i aktualizowanie zawartości typu wiki w trybie offline

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

Strony typu wiki można aktualizować w trybie offline w taki sam sposób, w jaki opracowuje się kod w repozytorium Git.

Aby zaktualizować witrynę typu wiki w trybie offline, możesz użyć dowolnego klienta lub narzędzia wiersza polecenia git. Aby uzyskać szczegółowe informacje na temat pracy z repozytoriami Git i obsługiwanymi narzędziami, zobacz Repozytoria Git.

Podstawowe kroki aktualizowania zawartości typu wiki w trybie offline są następujące:

  1. Sklonuj repozytorium Git typu wiki do lokalnego środowiska IDE lub obszaru roboczego.
  2. Dodaj pliki lub foldery do lokalnej gałęzi git.
  3. Zaktualizuj pliki order, aby odzwierciedlały strony i podstrony.
  4. Zatwierdź i wypchnij aktualizacje wprowadzone do lokalnej gałęzi git.

Wymagania wstępne

Wykonaj poniższe kroki, aby przeprowadzić migrację stron markdown z innej witryny typu wiki do witryny typu wiki projektu zespołowego lub do zawartości publikowanej jako kod w witrynie typu wiki.

Klonowanie witryny typu wiki

Repozytorium wiki przechowuje strony, obrazy, załączniki oraz sekwencję stron i podstron. Sklonuj witrynę typu wiki, aby rozpocząć.

  1. Zaloguj się do projektu (https://dev.azure.com/{Your_Organization/Your_Project}), a następnie wybierz swoją witrynę typu wiki.

  2. Otwórz menu kontekstowe Więcej akcji i wybierz pozycję Klonuj witrynę typu wiki.

    Klonowanie repozytorium Git wiki

  3. W oknie dialogowym Klonowanie repozytorium wybierz pozycję Kopiuj adres URL klonowania do schowka.

    Kopiowanie adresu URL witryny typu wiki

    Wprowadź go w przeglądarce, aby wyświetlić pliki zdefiniowane w gałęzi wikiMaster.

    Pliki główne witryny typu wiki

  4. Użyj skopiowanego adresu URL, aby sklonować repozytorium w używanym środowisku IDE. Aby uzyskać więcej informacji, zobacz jeden z następujących artykułów:

Dodawanie stron do lokalnego repozytorium Git

Strony są tworzone przy użyciu formatu Markdown. Dodaj plik Markdown do gałęzi lokalnej dla każdej strony i podstrony, którą chcesz dodać do witryny typu wiki.

Dodawanie stron

Aby dodać strony w katalogu głównym drzewa wiki, dodaj plik Markdown w katalogu głównym repozytorium Git.

  1. Dla każdej strony, którą chcesz dodać, utwórz plik Markdown z zawartością strony, a następnie dodaj go w folderze głównym repozytorium.

    W przypadku projektu zespołowego CanaryBuilds znajduje się on w następującym folderze:

    C:\Users\UserName\Source\Repos\CanaryBuilds.wiki

  2. Aby dodać strony w katalogu głównym drzewa wiki, dodaj plik Markdown dla każdej strony w katalogu głównym repozytorium Git.

    Repozytorium Git witryny typu wiki gałęzi lokalnej

  3. Po dodaniu wszystkich stron, które chcesz dodać w katalogu głównym, zaktualizuj plik order w katalogu głównym. Powinien on zawierać jeden wpis dla każdego pliku Markdown zdefiniowanego w katalogu głównym. Każdy wpis powinien być zgodny z tytułem pliku spacjami zastąpionymi kreską.

    Na przykład:

     Welcome
     Roadmap  
     How-to-contribute  
     Home  
     Reference  
    

Dodawanie podstron

  1. Utwórz folder dla strony nadrzędnej, a następnie dodaj pliki Markdown dla każdej podstrony w folderze.

    Na przykład dodaliśmy następujące pliki do folderu Instrukcje współtworzenia. Te podstrony są wyświetlane na stronie Jak współtworzyć w witrynie typu wiki.

    Zrzut ekranu przedstawiający podstrony.

  2. Dodaj plik order w folderze z kolejnością podstron, tak jak powinny być wyświetlane w witrynie typu wiki. Aby zrozumieć użycie pliku order do sekwencjonowania stron, zobacz wiki pliki repozytorium Git i struktura plików.

    Na przykład plik ma następujące podstrony:

     Request-extensions  
     Licensing  
     Smoke-test  
     Coding-guidelines  
    

Wypychanie zmian

Po zakończeniu wszystkich aktualizacji wypchnij pliki do repozytorium Git.

Dodane strony i podstrony są natychmiast wyświetlane w witrynie typu wiki.

Zaktualizowane drzewo stron typu wiki

Jeśli w procesie występują jakiekolwiek błędy, strony są wyświetlane w witrynie typu wiki z znakiem ostrzegawczym.

Ostrzeżenie, gdy plik order nie jest poprawnie aktualizowany.