Share via

Aprowizowane witryny typu wiki a opublikowany kod jako witryna typu wiki

  • Artykuł

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

W usłudze Azure DevOps możesz zachować zawartość typu wiki w witrynie typu wiki projektu zespołowego lub opublikowaną jako witryna typu wiki kodu. W witrynie typu wiki opublikowanej jako kod można obsługiwać kilka wersji witryn typu wiki w celu obsługi potrzeb związanych z zawartością, chociaż jest ona dostępna tylko wtedy, gdy usługa Azure Repos jest włączona.

Obie opcje wiążą się z przechowywaniem zawartości typu wiki w repozytoriach Git, ale inne są sposoby dodawania i aktualizowania zawartości oraz zarządzania nią.

Uwaga

Kod publikowania jako funkcja typu wiki jest obecnie dostępny w usłudze Azure DevOps Server 2018 i nowszych wersjach. W przypadku starszych wersji można aprowizować tylko witrynę typu wiki dla projektu zespołowego.

Opcje menu strony typu wiki

Za pomocą aprowizowanej witryny typu wiki można dodawać i edytować strony bezpośrednio w witrynie typu wiki. Wszystkie aktualizacje zawartości aprowizowanej witryny typu wiki są wykonywane w witrynie typu wiki.

Za pomocą kodu publikowania jako witryny typu wiki można dodawać, edytować i aktualizować zawartość z repozytoriów lub kodu.

Na poniższej ilustracji przedstawiono opcje aprowizowanej witryny typu wiki. Kilka z tych opcji nie jest obsługiwanych w przypadku publikowania jako stron typu wiki kodu.

Zrzut ekranu przedstawiający opcje menu strony typu wiki aprowizowania.

Na przykład opcja Edytuj w repozytoriach dla kodu publikowania jako witryna typu wiki powoduje przejście do strony Repozytorium w celu edytowania tej konkretnej strony. Aktualizacje, że zostanie utworzona strona w gałęzi wybranej dla witryny typu wiki, zostanie automatycznie opublikowana w witrynie typu wiki.

Obsługiwane funkcje i różnice operacyjne

Oba typy stron typu wiki obsługują następujące funkcje:

W poniższej tabeli podsumowano te operacje lub funkcje, które mogą się różnić w zależności od typu witryny typu wiki.

Operacja Aprowizowana witryna typu wiki Publikowanie kodu jako witryny typu wiki
Obsługa wielu witryn typu wiki, nazwij witrynę typu wiki ✔️
Dodawanie lub edytowanie stron z plików repozytoriów>lub plików kodu> ✔️
Przywracanie wcześniejszej poprawki z witryny Typu Wiki ✔️
Przywracanie wcześniejszej poprawki z repozytoriów lub kodu ✔️ ✔️
Obsługa wersji witryn typu wiki ✔️
Wybierz wersję typu wiki ✔️
Cofanie publikowania witryny typu wiki kodu ✔️

Dodawanie stron

W przypadku obu typów stron typu wiki wybierz pozycję Nowa strona lub Dodaj podstronę. Aby uzyskać więcej informacji, zobacz Dodawanie i edytowanie stron typu wiki.

Sekwencja stron i lista stron w okienku nawigacji

Zaaprowizowana witryna typu wiki automatycznie zarządza sekwencją stron i listą stron podczas dodawania lub przenoszenia stron w okienku nawigacji.

Aby określić strukturę listy stron w okienku nawigacji dla kodu publikowania jako wiki, zdefiniuj plik order w katalogu głównym i dla każdej podfolderu lub strony nadrzędnej zawierającej podstrony.

Oba typy stron typu wiki są zgodne z tą samą strukturą plików. Wystarczy, że kod publikowania w witrynie typu wiki wymaga ręcznego obsługi sekwencji stron.

Aby uzyskać więcej informacji na temat pracy z plikami order , zobacz Wiki repository files and file structure (Pliki repozytorium Git typu wiki i struktura plików).

Wersje strony i przywracanie do poprzedniej wersji

W witrynie typu wiki możesz wyświetlić poprawki dowolnej strony typu wiki. Wybierz pozycję Poprawki lub opcję menu Wyświetl poprawki .

Jednak proces przywracania różni się w zależności od typu strony typu wiki.

Przechowywanie wersji i cofanie publikowania witryny typu wiki

W przypadku przechowywania wersji można publikować różne wersje zawartości w różnych witrynach typu wiki w oparciu o wersję gałęzi repozytorium Git. Przechowywanie wersji i cofanie publikowania witryny typu wiki jest obsługiwane tylko w przypadku witryn typu wiki utworzonych przez opublikowanie kodu w witrynie typu wiki. Aby uzyskać więcej informacji, zobacz Publikowanie strony typu wiki kodu/Cofanie publikowania witryny typu wiki kodu.

Usuwanie witryny typu wiki projektu

Uwaga

Interfejsy API REST stron typu wiki nie obsługują usuwania witryny typu wiki projektu. Dlatego musisz usunąć repozytorium wiki.

  1. Sklonuj repozytorium wiki, aby utworzyć kopię zapasową całej zawartości. Więcej opcji zawiera adres URL klonowania witryny typu wiki, którego można użyć do sklonowania witryny typu wiki.

  2. Pobierz identyfikator repozytorium git, który będzie wspierać witrynę typu wiki. Możesz użyć interfejsu API REST, aby pobrać wszystkie witryny typu wiki w projekcie.

    Na przykład GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1 zwraca wszystkie witryny typu wiki w projekcie, aby można było wybrać, który z nich chcesz usunąć.

  3. Użyj interfejsu API REST, aby usunąć repozytorium Git. Użyj identyfikatora repozytorium witryny typu wiki projektu znalezionej w poprzednim kroku i sprawdź dwukrotnie identyfikator repozytorium, aby nie usunąć nieprawidłowego.

    Na przykład DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/{repositoryId}?api-version=4.1

Aktualizowanie witryny typu wiki w trybie offline

Możesz pracować w trybie offline lub w gałęzi lokalnej, aby zaktualizować zawartość aprowizowanej witryny typu wiki i opublikować ją jako witrynę typu wiki kodu. Aby uzyskać więcej informacji, zobacz Klonowanie i aktualizowanie stron typu wiki w trybie offline.