Dodawanie języka Markdown do pulpitu nawigacyjnego
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Widżet języka Markdown to uniwersalne narzędzie, które umożliwia obsługę zespołu i uczestników projektu przez dodanie cennych informacji bezpośrednio do pulpitu nawigacyjnego. Można go użyć do wyświetlania następujących elementów:
- Cele zespołu
- Linki do backlogów zespołowych lub tablic
- Linki do metryk
- Linki do innych elementów znajdujących się w udziale sieciowym, takich jak program OneNote, witryna programu SharePoint lub strony typu wiki
- Ważne daty lub terminy docelowe
Korzystając z widżetu Markdown, możesz mieć pewność, że podstawowe informacje są łatwo dostępne i widoczne dla zespołu i uczestników projektu.
W poniższym przykładzie przedstawiono informacje i linki zespołu: 
Wymagania wstępne
| Kategoria | Wymagania |
|---|---|
| poziomy dostępu |
-
Członek projektu. — Co najmniej dostęp Podstawowy lub określone uprawnienia pulpitu nawigacyjnego. |
| Uprawnienia użytkownika | Aby dodać, edytować lub zarządzać pulpitem nawigacyjnym zespołu, musisz być osobą będącą członkiem zespołu, a także grupy Administratorzy projektów. |
| Kategoria | Wymagania |
|---|---|
| poziomy dostępu |
-
Członek projektu. — Co najmniej dostęp Podstawowy lub określone uprawnienia pulpitu nawigacyjnego. |
| Uprawnienia użytkownika | Aby dodać, edytować lub zarządzać pulpitem nawigacyjnym zespołu, musisz być osobą będącą członkiem zespołu, a także grupy Administratorzy projektów. |
| Narzędzia | Aby widżety Analytics działały z pulpitem nawigacyjnym, funkcja Analytics jest włączona. |
| Kategoria | Wymagania |
|---|---|
| poziomy dostępu |
-
Członek projektu. — Co najmniej dostęp Podstawowy lub określone uprawnienia pulpitu nawigacyjnego. |
| Uprawnienia użytkownika | Aby dodać, edytować lub zarządzać pulpitem nawigacyjnym zespołu, musisz być członkiem zespołu oraz członkiem grupy Administratorzy Projektu lub być przypisanym do roli administratora zespołu . |
| Narzędzia |
-
Analytics Marketplace — rozszerzenie. Widżety analizy nie są dostępne, jeśli usługa Analytics nie jest zainstalowana, włączona lub uruchomiona. — Aby widżety Analytics działały z Twoim pulpitem nawigacyjnym, należy mieć włączone Analytics. |
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
- Znak ucieczki
Aby uzyskać więcej informacji, zobacz Wskazówki dotyczące składni dla 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
Dodawanie widżetu Markdown
Wykonaj następujące kroki, aby dodać widżet Markdown. Aby dodać pulpit nawigacyjny, zobacz Dodawanie, zmienianie nazwy i usuwanie pulpitów nawigacyjnych.
Zaloguj się do projektu (
https://dev.azure.com/{Your_Organization/Your_Project}).Wybierz pozycję pulpity nawigacyjne .
Wybierz pozycję
Edytuj. Katalog widżetów zostanie otwarty automatycznie.Dodaj lub przeciągnij widżet Markdown do pulpitu nawigacyjnego, w którym ma się znajdować.
Wybierz pozycję Gotowe edytowanie , aby zakończyć edytowanie pulpitu nawigacyjnego. Ta akcja odrzuca wykaz widżetów. Następnie można skonfigurować widżet Markdown zgodnie z potrzebami.
Wybierz
więcej akcji >
Konfiguruj.
(Opcjonalnie) Dostosuj rozmiar widżetu zgodnie z potrzebami, aby dopasować zawartość języka Markdown. Największy rozmiar to 10 kafelków szerokich o 10 kafelków wysokości. Rozmiar można zawsze dostosować później.
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.
Uwaga
- Łącza do dokumentów w udostępnianiu plików przy użyciu
file://nie są obsługiwane. To ograniczenie jest implementowane w celach bezpieczeństwa. - 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, wybierz
Wybierz plik markdown , wybierzrepozytorium, Gałąź iŚcieżka z menu rozwijanych.
- Łącza do dokumentów w udostępnianiu plików przy użyciu
Zapisz zmiany.