Dodawanie i edytowanie stron typu wiki

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Tytuł i zawartość można dodać do strony po aprowizacji repozytorium Git typu wiki dla projektu zespołowego. Istnieje środowisko edycji równoległej i podglądu, w którym można edytować stronę i wyświetlać podgląd zawartości w miarę przechodzenia.

Dowiedz się, jak wykonywać następujące zadania:

  • Otwórz witrynę typu wiki
  • Dodawanie strony typu wiki
  • Wyświetlanie poprawek dla strony
  • Edytowanie i usuwanie stron typu wiki
  • Zmienianie kolejności stron typu wiki
  • Tworzenie strony głównej strony typu wiki

Podczas tworzenia stron przy użyciu formatu Markdown można również użyć okienka formatowania do formatowania tekstu sformatowanego i wstawiania obrazów, załączników i łączy.

Strona główna typu wiki

Podczas edytowania strony zapisz ją, wprowadzając klawisze Ctrl+S. Aby zapisać przy użyciu niestandardowego komunikatu poprawki, wybierz obok pozycji Zapisz. Aby uzyskać więcej skrótów, zobacz Skróty klawiaturowe do zarządzania stronami typu wiki.

Zapisywanie strony z komunikatem niestandardowym

Narzędzia wiersza polecenia typu wiki

Polecenia Opis
az devops wiki show Otwieranie witryny typu wiki
az devops wiki page show Pobieranie zawartości strony lub otwieranie strony
az devops wiki page create Dodawanie nowej strony
az devops wiki page update Edytowanie strony
az devops wiki page delete Usuwanie strony

Uwaga

Aby dodać lub edytować strony w witrynie typu wiki opublikowanej z repozytorium Git, zobacz Publikowanie repozytorium Git w witrynie typu wiki. W tym artykule opisano sposób dodawania i edytowania stron typu wiki aprowizowania dla projektu zespołowego.

Wymagania wstępne

  • Musisz mieć aprowizowaną witrynę typu wiki. Jeśli witryna typu wiki nie została jeszcze utworzona, utwórz ją teraz.
  • Musisz być członkiem projektu zespołowego jako współautor, aby dodać lub zaktualizować strony typu wiki.
  • Aby edytować witrynę typu wiki projektu, musisz mieć podstawowy poziom dostępu.

Otwórz witrynę typu wiki

Połącz się z projektem przy użyciu obsługiwanej przeglądarki internetowej i wybierz pozycję Wiki.

Tworzenie witryny typu wiki, aprowizuj repozytorium Git dla witryny typu wiki lub publikuj istniejące pliki markdown repozytorium

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

Aby dodać inną stronę, wybierz pozycję Nowa strona. Aby dodać podstronę, otwórz menu kontekstowe istniejącej strony i wybierz pozycję Dodaj podstronę.

Określ unikatowy tytuł 235 znaków lub mniej. Tytuły stron są uwzględniane w wielkości liter. Aby uzyskać informacje o innych ograniczeniach tytułu, zobacz Wiki Pliki repozytorium Git i struktura plików, Konwencje nazewnictwa plików.

Tworzenie witryny typu wiki i pierwszej strony

Możesz również użyć skrótów klawiaturowych, aby dodać nową stronę, naciskając n lub dodając podstronę, naciskając klawisz c. Aby uzyskać pełną listę skrótów klawiaturowych, zobacz Skróty klawiaturowe do zarządzania stronami typu wiki.

Ograniczenia nazewnictwa tytułów stron typu wiki

Każda strona typu wiki odpowiada plikowi w repozytorium Git typu wiki. Nazwy przypisywane do tytułu strony typu wiki muszą być zgodne z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Nazwa pliku W pełni kwalifikowana ścieżka strony nie powinna przekraczać 235 znaków.
Unikatowość Tytuły stron są uwzględniane w wielkości liter i muszą być unikatowe w hierarchii typu wiki.
Znaki specjalne
  1. Nie może zawierać żadnych znaków kontrolki Unicode ani znaków zastępczych
  2. Nie może zawierać następujących znaków drukowalnych: / \ #
  3. Nie może rozpoczynać się lub kończyć kropką (.)
Rozmiar pliku Nie może przekraczać maksymalnie 18 MB
Rozmiar pliku załącznika Nie może przekraczać maksymalnie 19 MB

Znaki specjalne w tytułach stron typu wiki

Możesz określić tytuły stron, które zawierają co najmniej jeden z tych znaków : < > * ? | -specjalnych. Na przykład możesz nazwać plik Markdown jako "FAQ?" lub "Set-up guide". Znaki mają następujące ciągi zakodowane w identyfikatorze URI:

Znak Zakodowany ciąg
: %3A
< %3C
> %3E
* %2A
? %3F
| %7C
- %2D
" %22
Typ ograniczenia Ograniczenie
Nazwa pliku W pełni kwalifikowana ścieżka strony nie powinna przekraczać 235 znaków.
Unikatowość Tytuły stron są uwzględniane w wielkości liter i muszą być unikatowe w hierarchii typu wiki.
Znaki specjalne
  1. Nie może zawierać żadnych znaków kontrolki Unicode ani znaków zastępczych
  2. Nie może zawierać następujących znaków drukowanych: / : < \ * ? \ | - #
  3. Nie może rozpoczynać się lub kończyć kropką (.)
  4. Tytuły stron dodanych w trybie offline nie mogą zawierać pustego miejsca.
Rozmiar pliku Nie może przekraczać maksymalnie 18 MB
Rozmiar pliku załącznika Nie może przekraczać maksymalnie 19 MB

Edytowanie i usuwanie stron typu wiki

Aby edytować istniejącą stronę typu wiki, otwórz stronę i wybierz pozycję Edytuj lub otwórz menu kontekstowe i wybierz pozycję Edytuj. Możesz również użyć skrótu klawiaturowego e , aby szybko przejść do edycji bieżącej strony.

W przypadku stron typu wiki kodu możesz edytować stronę w edytorze obok siebie przy użyciu paska narzędzi markdown w celu utworzenia zawartości. To środowisko jest identyczne z procesem w witrynie typu wiki projektu. Strony typu wiki można również edytować w centrum Repozytoria, używając opcji Edytuj w repozytoriach.

Edytuj stronę typu wiki.

Uwaga

Jeśli masz zasady gałęzi w witrynie typu wiki kodu, użyj polecenia Edytuj w repozytoriach , aby utworzyć gałąź i kontynuować edytowanie.

Aby usunąć stronę, otwórz menu kontekstowe z drzewa lub wewnątrz strony i wybierz pozycję Usuń. Potwierdź usunięcie w wyświetlonym oknie dialogowym.

Uwaga

Usunięcie strony powoduje usunięcie strony wraz ze wszystkimi metadanymi i wszystkimi jego podstronami (jeśli istnieją) w hierarchii.

Zmienianie kolejności strony typu wiki

Możesz zmienić kolejność stron w widoku drzewa typu wiki, aby strony pojawiały się w żądanej kolejności i hierarchii. Aby wykonać następujące operacje, możesz przeciągać i upuszczać tytuł strony w widoku drzewa:

  • Zmień relację elementu nadrzędno-podrzędnego strony.
  • Zmień kolejność strony w hierarchii.

Uwaga

Przeniesienie strony w hierarchii może spowodować przerwanie linków do niej z innych stron. Zawsze można naprawić łącza ręcznie po przeniesieniu. Zmiana kolejności strony w hierarchii nie ma wpływu na linki stron.

Do zmiany kolejności stron można również użyć skrótów klawiaturowych. Wybierz stronę i naciśnij klawisze CTRL + STRZAŁKA W GÓRĘ lub CTRL + STRZAŁKA W DÓŁ , aby zmienić kolejność stron. Aby zmienić relację nadrzędny-podrzędny strony, otwórz menu kontekstowe i wybierz pozycję Przenieś. Zostanie otwarte okno dialogowe Przenoszenie strony . Wybierz stronę nadrzędną, w której można przenieść bieżącą stronę.

Przenoszenie strony typu wiki w hierarchii

Aby uzyskać pełną listę skrótów klawiaturowych, zobacz Skróty klawiaturowe do zarządzania stronami typu wiki.

Tworzenie strony głównej strony typu wiki

Domyślnie pierwsza strona dodana podczas tworzenia strony typu wiki jest ustawiana jako strona główna typu wiki. Możesz zmienić stronę główną typu wiki, jeśli inna strona stanie się bardziej odpowiednia, przeciągając i upuszczając stronę w górnej części drzewa.

Następne kroki