Dodawanie języka Markdown do pulpitu nawigacyjnego

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

Użyj widżetu Języka Markdown, aby wspierać zespół i osoby biorące udział w projekcie, dodając informacje, takie jak:

• Cele zespołu.
• Linki do:
  • Listy prac zespołu lub tablice.
  • Metryki.
  • Inne elementy znajdujące się w udziale sieciowym, takim jak oneNote, witryna programu SharePoint lub strony typu wiki.
• Ważne daty lub terminy docelowe.

Oto przykład:

Wymagania wstępne

• Dostęp:
  • Każda osoba mająca dostęp do projektu, w tym osoby biorące udział w projekcie, mogą wyświetlać pulpity nawigacyjne.
  • Być członkiem projektu i mieć co najmniej dostęp podstawowy lub mieć określone uprawnienia pulpitu nawigacyjnego przyznane Tobie.
• Uprawnienia:
  • Pulpity nawigacyjne zespołu: Aby dodać, edytować lub zarządzać pulpitem nawigacyjnym zespołu, spełnić następujące wymagania:
    • Bądź członkiem zespołu.
    • Być członkiem grupy Administratorzy projektu.

Uwaga

Dane wyświetlane na wykresie lub widżecie podlegają uprawnieniam udzielonym zalogowanym użytkownikowi. Jeśli na przykład użytkownik nie ma uprawnień do wyświetlania elementów roboczych w określonej ścieżce obszaru, te elementy nie są wyświetlane w widżecie wyników zapytania na pulpicie nawigacyjnym. Aby uzyskać więcej informacji, zobacz Często zadawane pytania dotyczące korzystania z pulpitów nawigacyjnych.

Obsługiwana składnia języka Markdown

Widżet Markdown obsługuje standardowe funkcje commonMark, takie jak:

• Nagłówki
• Akapity i znaki końca wiersza
• Cytat blokowy
• Zasada pozioma
• Wyróżnienie (pogrubienie, kursywa, przekreślenie)
• Tabele
• Listy, uporządkowane i nieurządzone
• Linki
• Obrazy
• Znaki ucieczki

Aby uzyskać szczegółowe informacje na temat użycia, zobacz Wskazówki dotyczące składni podstawowego użycia języka Markdown.

Ze względu na wydajność widżet Markdown nie dodaje obsługi wielu rozszerzonych funkcji, z których wiele jest obsługiwanych w witrynie typu wiki. Rozszerzone możliwości mogłyby utrudniać czas ładowania widżetu. Na przykład następujące rozszerzone funkcje języka Markdown nie są obsługiwane w widżecie języka Markdown:

• Osadzona składnia HTML
• Wyróżnianie kodu (wiki/inne obsługują kodowanie kolorami obsługującymi składnię języka, funkcja CommonMark po prostu renderuje kod jako zwykły tekst wstępnie sformatowany)
• Listy kontrolne
• Znaki emoji
• Załączniki
• Formuły matematyczne

Nawiązywanie połączenia z projektem

Aby dodać widżet Markdown do pulpitu nawigacyjnego, połącz się z projektem przy użyciu obsługiwanej przeglądarki internetowej.

Otwórz przeglądarkę internetową, połącz się z projektem i wybierz pozycję Przegląd>Pulpity nawigacyjne.

Jeśli musisz przełączyć się do innego projektu, wybierz logo usługi Azure DevOps, aby przeglądać wszystkie projekty.

Dodawanie widżetu Markdown

Jeśli musisz dodać pulpit nawigacyjny, zobacz Dodawanie, zmienianie nazwy i usuwanie pulpitów nawigacyjnych.

Aby dodać widżet Markdown do pulpitu nawigacyjnego, wybierz pozycję Edytuj. Katalog widżetów zostanie automatycznie otwarty.

1. Dodaj lub przeciągnij widżet Markdown do pulpitu nawigacyjnego, w którym ma się znajdować.

   

2. Wybierz pozycję Gotowe edytowanie , aby zakończyć edytowanie pulpitu nawigacyjnego. Spowoduje to odrzucenie wykazu widżetów. Następnie można skonfigurować widżet Markdown zgodnie z potrzebami.

3. Wybierz ikonę koła zębatego, aby otworzyć okno dialogowe konfiguracji widżetu.

   Aby edytować widżet markdown, może być konieczne być administratorem zespołu, członkiem grupy Administratorzy projektu lub mieć uprawnienia. Aby uzyskać więcej informacji, zobacz Ustawianie uprawnień pulpitu nawigacyjnego.

4. Dostosuj rozmiar widżetu zgodnie z potrzebami, aby dopasować zawartość wprowadzonego kodu Markdown. Największy rozmiar to 10 kafelków szerokich o 10 kafelków wysokości. Zawsze możesz dostosować to później.

   

5. Wprowadź tekst i składnię języka Markdown w oknie dialogowym konfiguracji. Aby uzyskać obsługiwaną składnię, zobacz Wskazówki dotyczące składni plików markdown, widżetów, witryn typu wiki i komentarzy żądania ściągnięcia.

   W tym miejscu pokażemy prosty tekst z listą punktowaną czterech łączy

   

   Napiwek

   Aby połączyć się ze stroną typu wiki, użyj następującej składni:
   /ProjectName/_wiki/wikis/WikiRepositoryName?pagePath=/FileName

   Aby połączyć się z plikiem repozytorium, stroną lub obrazem w projekcie, kliknij plik sformatowany i użyj pełnego adresu URL.

   Spowoduje to renderowanie następującego widżetu:

   

   Uwaga

   Łącza do dokumentów w udziałach plików, których używasz file:// , nie są obsługiwane. To ograniczenie zostało wdrożone w celach bezpieczeństwa.

6. Opcjonalnie możesz wybrać, aby wskazać plik w repozytorium.

   

Powiązane artykuły

• Dodawanie pulpitów nawigacyjnych i zarządzanie nimi
• Dodawanie widżetu do pulpitu nawigacyjnego
• Wskazówki dotyczące składni dla plików Markdown, widżetów, witryn typu wiki i komentarzy żądania ściągnięcia
• Widżety witryny Marketplace