Aprowizowane witryny typu wiki a opublikowany kod jako witryna typu wiki
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.
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:
- 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 | 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.
- 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 publikowania jako kodu 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. 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.
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.1
zwraca 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.
Powiązane artykuły
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla