Instalowanie narzędzi do tworzenia zawartości

W tym artykule opisano sposób instalowania zalecanych narzędzi potrzebnych do zapewnienia wydajnego, szczegółowego lub dużego udziału w usłudze Microsoft Learn. Przykłady głównych aktualizacji to:

• Długie poprawki do wielu artykułów
• Tworzenie nowego artykułu
• Praca, dla której chcesz używać dostępnych rozszerzeń programu Visual Studio Code, takich jak Learn Authoring Pack.

Ważne

Jeśli wprowadzasz tylko drobne zmiany, nie musisz wykonywać kroków opisanych w tym artykule. Zobacz Edytowanie w przeglądarce , aby dowiedzieć się, jak tworzyć szybkie edycje bez instalowania jakichkolwiek narzędzi.

Współautorzy, którzy będą wprowadzać poważne zmiany, są zachęcani do wykonania tych kroków. Nawet jeśli masz uprawnienia do zapisu w repozytorium głównym, zdecydowanie zalecamy (i w tym przewodniku przyjęto założenie), że rozwidlenie i sklonowanie repozytorium oraz zapisanie proponowanych zmian w rozwidleniu.

W tym artykule wykonasz następujące elementy:

• Instalacja programu Git
• Instalacja programu Visual Studio Code
• Instalowanie pakietu Learn Authoring Pack

Instalowanie narzędzi klienckich Git dla systemu Windows

Ta instalacja obejmuje system kontroli wersji usługi Git i powłokę Git Bash, aplikację wiersza polecenia używaną do interakcji z lokalnym repozytorium Git.

1. Pobierz narzędzie Git dla systemu Windows.

2. Uruchom pobrany plik wykonywalny (.EXE) i postępuj zgodnie z monitami, aby zainstalować. Wybierz pozycję Dalej po każdym wyświetleniu monitu, aby zaakceptować wszystkie ustawienia domyślne.

3. Po wyświetleniu monitu wybierz edytor kodu. Domyślnym edytorem kodu jest Vim.

4. Wybierz pozycję Zakończ , aby ukończyć instalację.

Po zainstalowaniu usługi Git dla systemu Windows skonfiguruj nazwę usługi Git i swój adres e-mail.

Instalowanie narzędzi klienckich Git dla komputerów Mac i Linux

• Usługa Git dla komputerów Mac jest dostarczana jako jedno z narzędzi wiersza polecenia programu Xcode. Uruchom polecenie git z wiersza polecenia. W razie potrzeby zostanie wyświetlony monit o zainstalowanie narzędzi wiersza polecenia. Usługę Git dla komputerów Mac można również pobrać z witryny organizacji Software Freedom Conservancy.
• Git dla systemów Linux i Unix

Postępuj zgodnie z instrukcjami dla wybranego klienta dotyczącymi instalacji i konfiguracji.

Instalowanie programu Visual Studio Code

Visual Studio Code to uproszczony edytor, który działa w systemach Windows, Linux i Mac. Obejmuje integrację z usługą Git i obsługę rozszerzeń.

Pobierz i zainstaluj program Visual Studio Code dla swojego systemu operacyjnego:

• Windows.
• Mac
• Linux

Podczas instalacji zaakceptuj wszystkie ustawienia domyślne.

Napiwek

Aby uruchomić program VS Code i otworzyć bieżący folder, uruchom polecenie code . w wierszu polecenia lub powłoce Bash. Jeśli bieżący folder jest częścią lokalnego repozytorium Git, integracja z usługą GitHub jest wyświetlana automatycznie w programie Visual Studio Code.

Instalowanie pakietu Learn Authoring Pack

Pakiet Learn Authoring Pack dla programu Visual Studio Code zawiera podstawową pomoc dotyczącą tworzenia języka Markdown, podglądy stron, obsługę szablonów języka Markdown, znaczników markdownlint i sprawdzania pisowni kodu. Te funkcje ułatwiają i usprawniają proces współtworzenia. W związku z tym uważamy pakiet Learn Authoring Pack za wymagane rozszerzenie dla współautorów.

Aby zainstalować pakiet Learn Authoring Pack, wybierz pozycję Zainstaluj na stronie Pakiet do tworzenia środowiska Learn w witrynie VS Code Marketplace.

Aby użyć funkcji pakietu Learn Authoring Pack, naciśnij klawisz Alt+M w programie Visual Studio Code. Aby skonfigurować pasek narzędzi do wyświetlania dostępnych funkcji, edytuj ustawienia programu Visual Studio Code (Kontrolka+przecinek) i dodaj ustawienie "markdown.showToolbar": trueużytkownika .

Aby uzyskać więcej informacji, zobacz Learn Authoring Pack for Visual Studio Code (Pakiet learn Authoring Pack dla programu Visual Studio Code).

Zrozumienie edytorów języka Markdown

Markdown to lekki język znaczników używany do tworzenia zawartości. Preferowanym narzędziem do edycji języka Markdown w firmie Microsoft jest Visual Studio Code. Dostępne są inne narzędzia do edycji języka Markdown. Artykuł dokumentacji języka Markdown obejmuje podstawy języka Markdown i funkcje obsługiwane przez witrynę internetową learn.microsoft.com .

Następne kroki

Teraz możesz przystąpić do konfigurowania lokalnego repozytorium Git.