Install content authoring tools (Installieren von Erstellungstools für Inhalte)

  • Artikel

In diesem Artikel wird beschrieben, wie Sie die empfohlenen Tools installieren, die Sie benötigen, um effiziente oder große Beiträge für Microsoft Learn zu erstellen. Beispiele für wichtige Updates sind:

  • Langwierige Überarbeitungen von mehreren Artikeln
  • Erstellen eines neuen Artikels
  • Arbeiten, für die Sie die verfügbaren Visual Studio Code-Erweiterungen, wie das Learn Authoring Pack, verwenden möchten.

Wichtig

Wenn Sie nur kleine Änderungen vornehmen, müssen Sie die Schritte in dieser Anleitung nicht durchführen. Lesen Sie Bearbeiten im Browser , um zu erfahren, wie Sie schnelle Bearbeitungen vornehmen können, ohne Tools zu installieren.

Mitwirkende, die wichtige Änderungen vornehmen, werden ermutigt, diese Schritte auszuführen. Auch wenn Sie über Schreibrechte im Haupt-Repository verfügen, empfehlen wir Ihnen dringend (und dieser Leitfaden geht davon aus), das Repository zu forken und zu klonen und Ihre Änderungsvorschläge in Ihrem Fork zu speichern.

In diesem Artikel führen Sie Folgendes durch:

Installieren der Git-Clienttools für Windows

Diese Installation umfasst das Versionskontrollsystem von Git sowie Git Bash, die Befehlszeilen-App, die Sie zur Interaktion mit Ihrem lokalen Git-Repository verwenden.

  1. Laden Sie Git für Windows herunter.

  2. Führen Sie die heruntergeladene ausführbare Datei (.EXE) aus, und befolgen Sie die Anweisungen zur Installation. Wählen Sie an den einzelnen Eingabeaufforderungen Weiter aus, um alle Standardeinstellungen zu übernehmen.

  3. Wählen Sie einen Code-Editor aus, wenn Sie dazu aufgefordert werden. Der Standardeditor ist Vim.

  4. Wählen Sie Fertig stellen aus, um die Installation abzuschließen.

Nachdem Sie Git für Windows installiert haben, konfigurieren Sie Ihren Git-Namen und Ihre E-Mail-Adresse.

Installieren der Git-Clienttools für Mac und Linux

  • Git für Mac ist Teil der Xcode Command Line Tools. Führen Sie einfach git über die Befehlszeile aus. Sie werden ggf. aufgefordert, die Befehlszeilentools zu installieren. Sie können auch Git für Mac von Software Freedom Conservancy herunterladen.
  • Git für Linux und Unix

Befolgen Sie die Anweisungen für die Installation und Konfiguration für Ihren Client.

Installieren von Visual Studio Code

Visual Studio Code ist ein leichtgewichtiger Editor, der unter Windows, Linux und Mac funktioniert. Er umfasst die Git-Integration sowie Unterstützung für Erweiterungen.

Laden Sie Visual Studio Code für Ihr Betriebssystem herunter, und installieren Sie es:

Übernehmen Sie während der Installation alle Standardeinstellungen.

Tipp

Um VS Code zu starten und den aktuellen Ordner zu öffnen, führen Sie den Befehl code . an der Befehlszeile oder in der Bash-Shell aus. Wenn der aktuelle Ordner zu einem lokalen Git-Repository gehört, wird die GitHub-Integration automatisch in Visual Studio Code angezeigt.

Learn Authoring Pack installieren

Das Learn Authoring Pack für Visual Studio Code enthält grundlegende Unterstützung für die Markdowndokumenterstellung, eine Seitenvorschau, Unterstützung für Markdownvorlagen, markdownlint und eine Rechtschreibprüfung für Code. Diese Features vereinfachen und optimieren den Prozess für Beiträge. Daher betrachten wir das Learn Authoring Pack als erforderliche Erweiterung für Mitwirkende.

Um das Learn Authoring Pack zu installieren, wählen Sie Installieren auf der Seite Learn Authoring Pack im VS Code Marketplace aus.

Drücken Sie Alt+M in Visual Studio Code, um die Funktionen des Learn Authoring Pack zu verwenden. Um eine Symbolleiste so zu konfigurieren, dass die verfügbaren Funktionen angezeigt werden, bearbeiten Sie Visual Studio Code-Einstellungen (STRG+KOMMA), und fügen Sie die Benutzereinstellung "markdown.showToolbar": true hinzu.

Weitere Informationen finden Sie unter Learn Authoring Pack für Visual Studio Code.

Grundlegendes zu Markdown-Editoren

Markdown ist eine schlanke Markupsprache, die zur Inhaltserstellung verwendet wird. Visual Studio Code ist das bei Microsoft bevorzugte Tool zum Bearbeiten von Markdown. Es sind weitere Markdown-Bearbeitungstools verfügbar. Der Markdown-Referenzartikel behandelt Markdown-Grundlagen und die von der learn.microsoft.com-Website unterstützten Features.

Nächste Schritte

Jetzt sind Sie bereit zum Einrichten eines lokalen Git-Repositorys.