Aprowizowana witryna typu wiki a opublikowana jako witryna typu wiki kodu
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. 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
Opublikowana jako funkcja typu wiki kodu jest obecnie dostępna 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.
W witrynie typu wiki opublikowanej jako kod 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 dla opublikowanych jako stron typu wiki kodu.
Na przykład opcja Edytuj w repozytoriach opublikowana jako witryna typu wiki kodu powoduje przejście do strony Repozytorium w celu edytowania tej konkretnej strony. Aktualizacje wykonywane na stronie w gałęzi wybranej dla strony typu wiki są automatycznie publikowane w witrynie typu wiki.
Obsługiwane funkcje i różnice operacyjne
Oba typy stron typu wiki obsługują następujące funkcje:
- Format języka Markdown
- Tagi HTML
- Wstawianie i zmienianie rozmiaru obrazów
- Notacja matematyczna i znaki
- Łączenie z elementami roboczymi przy użyciu polecenia #
- Dołączanie plików
- Filtrowanie zawartości witryny typu wiki
- Drukowanie strony typu wiki
- Aktualizowanie zawartości w trybie offline
- Dodawanie lub edytowanie stron z witryny Typu Wiki
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 | Opublikowano jako witrynę typu wiki kodu |
|---|---|---|
| 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 opublikowanej jako witryna typu wiki kodu, zdefiniuj *.order* plik 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. Jest to tylko to, że opublikowana jako witryna typu wiki kodu wymaga ręcznego zachowania sekwencji stron.
Aby uzyskać więcej informacji na temat pracy z plikami .order , zobacz Wiki pliki repozytorium Git 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.
- W przypadku aprowizowanej strony typu wiki wybierz pozycję Przywróć, zgodnie z opisem w artykule Przywracanie zatwierdzenia do aprowizowanej strony typu wiki
- W przypadku strony typu wiki opublikowanej jako kod pracuj z gałęzi lokalnej i prześlij żądanie ściągnięcia, aby zaktualizować gałąź, z której pracujesz.
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. Możesz wersję i cofnąć publikowanie witryny typu wiki tylko wtedy, gdy jesteś tym, który go utworzył, publikując kod w witrynie typu wiki. Aby uzyskać więcej informacji, zobacz 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.
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.
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.1zwraca wszystkie witryny typu wiki w projekcie, aby można było wybrać, który z nich chcesz usunąć.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.