Aprowizowana witryna typu wiki a opublikowana jako witryna typu wiki kodu

2025-05-28

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

Zawartość witryny typu wiki można przechowywać w witrynie typu wiki projektu zespołowego lub opublikowanej jako witryna typu wiki kodu. Z opublikowaną jako kod wiki można utrzymywać kilka wersjonowanych witryn typu wiki, aby zaspokoić potrzeby związane z treścią. Ta opcja jest dostępna po włączeniu usługi Azure Repos.

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ą.

Obsługa zawartości typu wiki

W przypadku obu typów stron typu wiki możesz pracować bezpośrednio w usłudze GitHub lub pracować w trybie offline, a następnie wypchnąć zmiany do repozytorium.

W przypadku aprowizowanej strony typu wiki można dodawać i obsługiwać strony typu wiki bezpośrednio w sekcji Wiki>Pages w repozytorium. Wszystkie aktualizacje zawartości aprowizowanej witryny typu wiki są wykonywane w samej witrynie typu wiki.

W przypadku wiki opublikowanej jako kod można dodawać i zarządzać zawartością wiki jako plikami kodu w repozytorium. Uzyskujesz dostęp do plików w sekcjach Repozytoria lub Kod repozytorium w usłudze GitHub.

Na poniższej ilustracji przedstawiono opcje menu dla aprowizowanej witryny typu wiki:

Niektóre opcje menu nie są obsługiwane na stronach opublikowanych jako wiki kodu. W przypadku strony typu wiki opublikowanej jako kod opcja Edytuj w repozytoriach otwiera bieżącą stronę, aby można było edytować zawartość w miejscu. Aktualizacje wykonywane na stronie w wybranej gałęzi witryny typu wiki są automatycznie publikowane w witrynie typu wiki.

Dodawanie stron typu wiki

Opcje menu Nowa strona i Dodaj podstronę są dostępne dla obu typów stron typu wiki w usłudze GitHub. Aby uzyskać więcej informacji, zobacz Dodawanie i edytowanie stron typu wiki.

Dostosowywanie sekwencji stron i listy stron

Oba typy stron typu wiki stosują ten sam folder i strukturę plików w repozytorium Git. Różnica polega na zachowaniu sekwencji stron.

W przypadku aprowizowanej witryny typu wiki usługa GitHub automatycznie zarządza sekwencją stron i listą stron podczas dodawania lub przenoszenia stron w okienku nawigacji.

W przypadku wiki opublikowanego jako kod, należy ręcznie zarządzać kolejnością stron. Aby określić strukturę listy stron w okienku nawigacji, należy zdefiniować plik order w katalogu głównym i dla każdej podfolderu lub strony nadrzędnej zawierającej podstrony. Aby uzyskać więcej informacji, zobacz Wiki pliki repozytorium Git i struktura plików.

Wyświetlanie poprawek strony i przywracanie do starszej wersji

Na stronie wiki repozytorium Git możesz wyświetlić poprawki dowolnej strony w witrynie typu wiki. Użyj opcji menu Poprawki lub Wyświetl poprawki . Aby przywrócić bieżącą zawartość strony do starszej wersji, proces różni się w zależności od typu strony typu wiki.

W przypadku aprowizowanej strony typu wiki wybierz opcję menu Przywróć . Aby uzyskać więcej informacji, zobacz Przywracanie zatwierdzenia do aprowizowanej strony typu wiki.

W przypadku strony opublikowanej jako kod wiki pracujesz z lokalnej gałęzi i przesyłasz "pull request", aby zaktualizować gałąź, z której pracujesz.

Używanie przechowywania wersji i cofanie publikowania witryny typu wiki

Obsługa przechowywania wersji umożliwia publikowanie różnych wersji zawartości w różnych witrynach typu wiki w oparciu o wersję gałęzi repozytorium Git.

Możesz wersjonować i odpublikować wiki tylko wtedy, gdy jesteś użytkownikiem, który opublikował kod do jego utworzenia. Aby uzyskać więcej informacji, zobacz Cofanie publikowania witryny typu wiki kodu.

Usuwanie witryny typu wiki projektu

W poniższych krokach opisano sposób usuwania witryny typu wiki projektu.

Uwaga

Nie można użyć interfejsu API REST do usunięcia witryny typu wiki projektu. Zamiast tego usuń repozytorium wiki bezpośrednio.

Sklonuj repozytorium wiki, aby utworzyć kopię zapasową całej zawartości. Adres URL witryny typu wiki można znaleźć w menu Więcej opcji (...).
Pobierz identyfikator repozytorium Git skojarzony z 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 polecenie zwraca wszystkie witryny typu wiki w projekcie. Uruchom polecenie i wybierz witrynę typu wiki do usunięcia.
Usuń repozytorium Git skojarzone ze swoją witryną typu wiki przy użyciu interfejsu API REST. Użyj identyfikatora repozytorium znalezionej wcześniej witryny typu wiki projektu. Sprawdź dokładnie identyfikator repozytorium, aby upewnić się, że nie usuniesz nieprawidłowej witryny typu wiki.

Na przykład DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/<repositoryId>?api-version=4.1 polecenie usuwa witrynę typu wiki. Zastąp <repositoryId> identyfikatorem repozytorium wiki do usunięcia.

Aktualizowanie witryny typu wiki w trybie offline

Możesz pracować w trybie offline lub w gałęzi lokalnej, aby zaktualizować zawartość dla obu typów stron typu wiki. Aby uzyskać więcej informacji, zobacz Klonowanie i aktualizowanie stron typu wiki w trybie offline.

Eksplorowanie innych funkcji i operacji

Oba typy stron typu wiki obsługują kilka innych funkcji i operacji:

Kilka operacji i funkcji jest dostępnych tylko dla jednego typu witryny typu wiki lub podejście użycia różni się:

Operacja	Udostępnione	Opublikowany jako kod
Obsługa wielu witryn typu wiki, nazwij witrynę typu wiki		✔️
Dodawaj lub edytuj strony z repozytoriów>plików lub z Kodu>Plików		✔️
Przywróć do wcześniejszej wersji ze strony Wiki	✔️
Przywracanie do wcześniejszej wersji z opcji Repo lub z opcji Kod	✔️	✔️
Obsługa wersji witryn typu wiki		✔️
Wybierz wersję typu wiki		✔️
Wyłączenie publikacji wiki kodu		✔️