Uwaga
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Po skonfigurowaniu repozytorium Git typu wiki dla projektu zespołowego możesz dodać tytuł dla wiki oraz zawartość strony. Interfejs użytkownika usługi Azure DevOps zapewnia równoległe środowisko, w którym można edytować strony i wyświetlać podgląd zmian podczas pracy.
W okienku Edycja wprowadzasz zawartość strony przy użyciu składni formatu Markdown. Można również wstawić obrazy, załączniki i łącza. Podczas wprowadzania zmian zawartość zostanie zaktualizowana w okienku Podgląd . Zawartość ze specjalnym formatowaniem, takimi jak nagłówki, listy, linki i obrazy, są wyświetlane jako tekst sformatowany w okienku Podgląd .
Podczas edytowania strony użyj skrótu klawiaturowego Ctrl+S , aby szybko zapisać pracę. Możesz również zapisać pracę z niestandardowym komunikatem poprawki, na przykład "Dodano linki do strony". Ta opcja jest dostępna w menu rozwijanym Zapisz
:
Dostępne są inne skróty klawiaturowe. Aby uzyskać więcej informacji, zobacz Skróty klawiaturowe do zarządzania stronami typu wiki.
Uwaga
W tym artykule opisano sposób dodawania i edytowania stron w witrynie typu wiki utworzonej dla projektu zespołowego. Jeśli chcesz dodać lub edytować strony w witrynie typu wiki opublikowanej z repozytorium Git, zobacz Publikowanie repozytorium Git w witrynie typu wiki.
Narzędzia wiki do wiersza poleceń
Możesz używać komend CLI Azure DevOps do zarządzania zawartością wiki. Poniższa tabela zawiera linki do sekcji w tym artykule, które opisują sposób pracy z określonymi poleceniami.
| Komenda | opis |
|---|---|
| az devops wiki show | Otwórz witrynę typu wiki i wyświetl stronę główną witryny typu wiki. |
| az devops wiki page show - pokaż stronę wiki w Azure DevOps | Pokaż określoną stronę w witrynie typu wiki. |
| Użyj komendy az devops wiki page create aby utworzyć stronę wiki w Az DevOps. | Dodaj nową stronę do wiki. |
| aktualizacja strony wiki az devops | Edytuj istniejącą stronę w witrynie typu wiki. |
| usuń stronę wiki az devops | Usuń stronę w witrynie typu wiki. |
Wymagania wstępne
| Kategoria | Wymagania |
|---|---|
| Dostęp do projektu | Członek projektu, w którym znajduje się witryna typu wiki. W razie potrzeby możesz zażądać dostępu od administratora projektu. |
| uprawnienia | Członek grupy współautorów . |
| poziomy dostępu | Co najmniej podstawowy dostęp. |
| Zadania | Przygotuj aprowizowaną witrynę typu wiki dla projektu. |
Otwórz witrynę typu wiki
Możesz otworzyć i wyświetlić stronę typu wiki dla projektu zespołowego z usługi Azure DevOps w przeglądarce lub użyć interfejsu wiersza polecenia usługi Azure DevOps.
Nawiąż połączenie z projektem przy użyciu obsługiwanej przeglądarki internetowej i wybierz pozycję Wiki:
Jeśli chcesz przełączyć projekt zespołowy, wybierz pozycję 
Azure DevOps , aby przeglądać wszystkie projekty zespołowe i zespoły.
Dodawanie strony typu wiki
W tej sekcji opisano sposób dodawania strony do witryny typu wiki. Możesz pracować bezpośrednio z interfejsem użytkownika usługi Azure DevOps w przeglądarce lub użyć interfejsu wiersza polecenia usługi Azure DevOps.
Aby dodać nową stronę do witryny typu wiki, masz dwie opcje. Zacznij od wybrania strony na liście, takiej jak strona główna.
Aby dodać stronę na tym samym poziomie co bieżąca strona, wybierz pozycję Nowa strona w dolnej części interfejsu użytkownika usługi Azure DevOps.
Aby dodać podstronę do bieżącej strony, wybierz pozycję Więcej opcji (...) >Dodaj podstronę.
Do dodawania stron można również użyć skrótów klawiaturowych. Wybierz bieżącą stronę, a następnie dodaj nową stronę, wybierając n lub dodaj podstronę, wybierając pozycję c. Aby uzyskać więcej informacji, zobacz Skróty klawiaturowe do zarządzania stronami typu wiki.
Tytuł strony i nazwa pliku
Wprowadź unikatowy tytuł strony. Wielkość liter ma znaczenie. Tytuł jest używany jako nazwa pliku dla strony. W nazwie pliku spacje w tytule strony są zastępowane łącznikami (-). Na przykład tytuł strony "Jak współtworzyć" odpowiada nazwie pliku How-to-contribute.md. W pełni kwalifikowana ścieżka do pliku powinna wynosić 235 znaków lub mniej.
Aby uzyskać informacje o innych ograniczeniach nazw plików, zobacz Wiki Pliki repozytorium Git i struktura plików, Konwencje nazewnictwa plików.
Ograniczenia tytułu strony i nazwy pliku
Każda strona typu wiki odpowiada plikowi w repozytorium Git typu wiki. Następujące ograniczenia odnoszą się do nazw plików stron oraz rozmiaru pliku:
Nazwa pliku: podczas wybierania nazwy dla pliku stronicowania należy pamiętać, że w pełni kwalifikowana ścieżka do pliku powinna mieć 235 znaków lub mniej. Pełna ścieżka do strony składa się z adresu URL repozytorium, ścieżki folderu do pliku strony i nazwy pliku strony. Na przykład
https://github.com/ExampleWiki/Contributors/Code/How-to-add-code-to-the-project.md.Unikatowość: nazwa pliku strony musi być unikatowa w jej lokalizacji folderu w hierarchii repozytorium wiki. W nazwie jest rozróżniana wielkość liter.
Znaki specjalne: nazwa pliku strony ma ograniczenia dotyczące następujących znaków specjalnych:
- Brak znaków kontrolnych Unicode ani znaków zastępczych
- Brak znaków drukowalnych: ukośnik do przodu, ukośnik
/\odwrotny, skrót# - Brak symbolu kropki
.na początku lub na końcu nazwy
Rozmiar pliku: maksymalny rozmiar pliku strony to 18 MB.
Rozmiar pliku załącznika: maksymalny rozmiar dowolnego załącznika do pliku strony wynosi 19 MB.
Dozwolone znaki specjalne
W nazwie pliku strony dozwolonych jest kilka znaków specjalnych, takich jak dwukropek : i łącznik -. Możesz na przykład nazwać plik Markdown jako FAQ:0525 lub Setup-Guide.
Ważne
Aby uniknąć błędów w składni strony i nawigacji w przeglądarce, nie używaj znaku spacji ( ) w nazwach plików strony. Jeśli nazwy plików stron są oparte na tytule strony, zastąp wszystkie spacje w tytule strony łącznikiem (-) w nazwie pliku.
W poniższej tabeli wymieniono znaki specjalne dozwolone w nazwach plików stron typu wiki oraz odpowiadający im ciąg zakodowany identyfikatorem URI:
| Charakter | Symbol | Ciąg identyfikatora URI |
|---|---|---|
| Dwukropek | : |
%3A |
| Lewy nawias kątowy | < |
%3C |
| Nawias kątowy w prawo | > |
%3E |
| Gwiazdka (symbol wieloznaczny) | * |
%2A |
| Znak zapytania | ? |
%3F |
| potoku | | |
%7C |
| Łącznik (kreska) | - |
%2D |
| Podwójny cudzysłów | " |
22% |
Na przykład nazwa pliku FAQ:0525 jest zakodowana jako FAQ%3A0525.
Ustawianie strony głównej witryny typu wiki
Domyślnie pierwsza strona dodana podczas tworzenia strony typu wiki jest ustawiana jako strona główna typu wiki. Jeśli inna strona stanie się bardziej odpowiednia, możesz zmienić stronę typu wiki. Aby uzyskać więcej informacji, zobacz Zmienianie kolejności lub przenoszenie stron typu wiki.
Edytowanie i usuwanie stron typu wiki
W tej sekcji opisano sposób edytowania lub usuwania strony w witrynie typu wiki. Możesz pracować bezpośrednio z interfejsem użytkownika usługi Azure DevOps w przeglądarce lub użyć interfejsu wiersza polecenia usługi Azure DevOps.
Istnieje kilka sposobów edytowania istniejącej strony typu wiki w przeglądarce:
- Otwórz stronę typu wiki i wybierz pozycję Edytuj.
- Otwórz stronę typu wiki i użyj skrótu klawiaturowego e.
- Wybierz stronę typu wiki na liście stron, a następnie wybierz pozycję Więcej opcji (...) >Edytuj.
Aby uzyskać więcej informacji na temat określonych funkcji edycji, zobacz Use Markdown guidance (Korzystanie ze wskazówek dotyczących języka Markdown).
Edytowanie w repozytoriach dla wiki kodu
Podczas publikowania kodu w witrynie typu wiki można edytować strony typu wiki w centrum Repozytoria . To samo środowisko edytora równoległego jest dostępne z opcjami formatowania paska narzędzi Języka Markdown. Wybierz Edytuj>Edytuj w Repozytorium, aby utworzyć gałąź i kontynuować edytowanie:
Opcja Edytuj w repozytoriach jest dostępna tylko dla wiki dla kodu z włączonymi politykami gałęzi. Jeśli nie widzisz tej opcji, może to być spowodowane tym, że Twoje wiki nie jest wiki kodu lub zasady dla gałęzi nie są włączone. Aby uzyskać więcej informacji, zobacz Zasady i ustawienia gałęzi.
Usuwanie strony typu wiki w przeglądarce
Aby usunąć stronę typu wiki, wybierz stronę typu wiki na liście stron, a następnie wybierz pozycję Więcej opcji (...) >Usuń. Możesz również wybrać polecenie Usuń z menu po kliknięciu prawym przyciskiem myszy na stronę.
Po wybraniu pozycji Usuń potwierdź usunięcie w oknie dialogowym.
Uwaga
Usunięcie strony typu wiki powoduje również usunięcie wszystkich metadanych strony i wszystkich podstron dołączonych do strony.
Zmienianie kolejności lub przenoszenie stron typu wiki
W przeglądarce można zmienić kolejność stron w widoku drzewa wiki, aby strony wyświetlane w preferowanej sekwencji. Sekwencja domyślna jest alfabetycznie według nazwy pliku. Możesz zmienić kolejność stron według artykułu, kategorii lub zamierzonej grupy odbiorców.
Aby wykonać następujące zadania, możesz użyć akcji przeciągania i upuszczania w tytułach stron w widoku drzewa:
Przenieś: Zmień relację między stroną główną a podstroną. Jeśli przeniesiesz stronę w sekwencji wiki, linki do strony z innych stron typu wiki mogą zostać przerwane. Te linki można naprawić ręcznie po przeniesieniu strony.
Zmień kolejność: zmień kolejność strony w sekwencji wiki. Zmiana kolejności stron w sekwencji stron typu wiki nie ma wpływu na linki stron.
Naprawianie uszkodzonych łączy po przesunięciu strony
Aby naprawić przerwany link po przeniesieniu strony w sekwencji wiki, wykonaj następujące kroki:
Przetestuj inne strony w witrynie typu wiki i poszukaj linków do przeniesionej strony.
Sprawdź komunikaty o błędach na stronie lub brakującą zawartość.
Otwórz stronę z przerwanym linkiem, wybierz pozycję Edytuj i przejdź do uszkodzonego linku w zawartości strony.
Aby znaleźć uszkodzony link w zawartości, możesz wyszukać nazwę przeniesionej strony, oryginalną ścieżkę pliku przeniesionej strony lub tekst linku dla przerwanego łącza.
Zaktualizuj uszkodzony link. Typową poprawką jest zmiana adresu URL lub ścieżki w linku w celu kierowania nowej lokalizacji dla przeniesionej strony.
Zapisz zmiany na stronie, aby zaktualizować link.
Otwórz zaktualizowaną stronę w przeglądarce i przetestuj link. Potwierdź, że pomyślnie otworzy przeniesioną stronę.
Zmienianie kolejności stron najwyższego poziomu
Skróty klawiaturowe umożliwiają zmienianie kolejności stron najwyższego poziomu w sekwencji typu wiki. Ta akcja nie działa w przypadku podstron.
Wybierz stronę na liście stron typu wiki i użyj skrótu CTRL + STRZAŁKA W GÓRĘ lub CTRL + STRZAŁKA W DÓŁ , aby przenieść stronę w sekwencji. Zmiana jest stosowana natychmiast.
Zmienianie kolejności stron/podstron
Możesz również zmienić kolejność stron/podstron dla dowolnej strony w sekwencji wiki.
Wybierz stronę, którą chcesz przenieść na liście stron typu wiki.
Wybierz Więcej opcji (...) >Przenieś, co otwiera okno dialogowe Przenieś stronę.
W oknie dialogowym Przenoszenie strony wybierz stronę, która będzie służyć jako nowa strona nadrzędna .
Po wybraniu nowej strony nadrzędnej system skanuje pod kątem potencjalnie uszkodzonych linków związanych z przeniesieniem strony. Raportuje linki, które należy dostosować:
Wybierz opcję Aktualizuj łącza, których dotyczy problem, na stronach i elementach roboczych (zalecane), a następnie wybierz pozycję Przenieś , aby ukończyć przenoszenie strony.
Aby uzyskać pełną listę skrótów klawiaturowych, zobacz Skróty klawiaturowe do zarządzania stronami typu wiki.