Verwenden eines Texteditors in der lokalen Umgebung, um eine Zieldokumentationsseite zu erstellen local-authoring

Die Anweisungen auf dieser Seite zeigen Ihnen, wie Sie einen Texteditor verwenden können, um in Ihrer lokalen Umgebung Dokumentation zu erstellen und eine Pull-Anforderung (PR) zu senden. Bevor Sie die hier angegebenen Schritte durchführen, lesen Sie Ihr Ziel in Adobe Experience Platform-Zielen dokumentieren.

Stellen Sie eine Verbindung zu GitHub her und richten Sie Ihre lokale Authoring-Umgebung ein. set-up-environment

  1. Navigieren Sie in Ihrem Browser zu https://github.com/AdobeDocs/experience-platform.en .

  2. Um das Repository zu fork zu verzweigen, klicken Sie auf Verzweigung , wie unten dargestellt. Dadurch wird eine Kopie des Experience Platform-Repositorys in Ihrem eigenen GitHub-Konto erstellt.

    Fork-Adobe-Dokumentations-Repository

  3. Klonen Sie das Repository auf Ihrem lokalen Computer. Wählen Sie "Code > HTTPS > Öffnen mit GitHub Desktop", wie unten dargestellt. Stellen Sie sicher, dass GitHub Desktop installiert ist. Weitere Informationen finden Sie unter Lokalen Klon des Repositorys erstellen im Adobe-Contributor-Handbuch.

    Adobe-Dokumentations-Repository in lokale Umgebung klonen

  4. Navigieren Sie in Ihrer lokalen Dateistruktur zu experience-platform.en/help/destinations/catalog/[...], wobei [...] die gewünschte Kategorie für Ihr Ziel ist. Wenn Sie beispielsweise ein Personalisierungsziel zu Experience Platform hinzufügen, wählen Sie den Ordner personalization aus.

Dokumentationsseite für Ihr Ziel erstellen author-documentation

  1. Ihre Dokumentationsseite basiert auf der Self-Service-Zielvorlage. Laden Sie die Zielvorlage herunter. Entpacken Sie sie und extrahieren Sie die Datei "yourdestination-template.md" in das Verzeichnis, das oben in Schritt 4 erwähnt wurde. Benennen Sie die Datei "YOURDESTINATION.md"um, wobei YOURDESTINATION der Name Ihres Ziels in Adobe Experience Platform ist. Wenn Ihr Unternehmen beispielsweise Moviestar heißt, würden Sie Ihre Datei moviestar.md nennen.
  2. Öffnen Sie die neue Datei in Ihrem gewünschten Texteditor. Adobe empfiehlt die Verwendung von Visual Studio Code und die Installation der Adobe Markdown Authoring-Erweiterung. Um die Erweiterung zu installieren, öffnen Sie Visual Studio Code, wählen Sie die Registerkarte "Extensions"auf der linken Bildschirmseite und suchen Sie nach "adobe markdown authoring". Wählen Sie die Erweiterung aus und klicken Sie auf "Install".
    Installieren der Adobe Markdown Authoring-Erweiterung
  3. Bearbeiten Sie die Vorlage mit relevanten Informationen für Ihr Ziel. Befolgen Sie die Anweisungen in der Vorlage.
  4. Navigieren Sie für Screenshots oder Bilder, die Sie Ihrer Dokumentation hinzufügen möchten, zu GitHub/experience-platform.en/help/destinations/assets/catalog/[...], wobei [...] die gewünschte Kategorie für Ihr Ziel ist. Wenn Sie beispielsweise ein Personalisierungsziel zu Experience Platform hinzufügen, wählen Sie den Ordner personalization aus. Erstellen Sie einen neuen Ordner für Ihr Ziel und speichern Sie Ihre Bilder hier. Sie müssen auf der Seite, die Sie erstellen, eine Verknüpfung zu ihnen herstellen. Siehe Anweisungen zum Verknüpfen von Bildern.
  5. Wenn Sie bereit sind, speichern Sie die Datei, an der Sie arbeiten.

Übermitteln der Dokumentation zur Überprüfung submit-review

TIP
Beachten Sie, dass hier nichts kaputt gemacht werden kann. Indem Sie den Anweisungen in diesem Abschnitt folgen, schlagen Sie einfach eine Aktualisierung der Dokumentation vor. Ihre vorgeschlagene Aktualisierung wird vom Dokumentationsteam von Adobe Experience Platform genehmigt oder bearbeitet.
  1. Erstellen Sie in GitHub Desktop eine Arbeitsverzweigung für Ihre Aktualisierungen und wählen Sie Publish-Verzweigung aus, um die Verzweigung auf GitHub zu veröffentlichen.

Neuer lokaler Zweig

  1. In GitHub Desktop commit Ihre Arbeit, wie unten dargestellt.

    Lokalen Bestätigen

  2. Im GitHub-Desktop wird Ihre Arbeit durch Push an den Zweig remote übertragen, wie unten dargestellt.

    Push your commit

  3. Öffnen Sie in der GitHub-Webschnittstelle eine Pull-Anfrage (PA), um Ihre Arbeitsverzweigung mit der Masterverzweigung des Adobe-Dokumentations-Repositorys zusammenzuführen. Vergewissern Sie sich, dass die Verzweigung, an der Sie gearbeitet haben, ausgewählt ist, und wählen Sie Contribute > Pull-Anforderung öffnen.

    Pull-Anforderung erstellen

  4. Stellen Sie sicher, dass die Basis- und Vergleichsverzweigungen korrekt sind. Fügen Sie der PA einen Hinweis hinzu, beschreiben Sie Ihre Aktualisierung und wählen Sie Pull-Anforderung erstellen aus. Dadurch wird ein PR-Vorgang zum Zusammenführen der Arbeitsverzweigung Ihrer Verzweigung mit der Masterverzweigung des Adobe-Repositorys geöffnet.

    note tip
    TIP
    Lassen Sie das Kontrollkästchen Änderungen durch Betreuer zulassen aktiviert, damit das Adobe-Dokumentationsteam die PR bearbeiten kann.

    Pull-Anforderung zum Adobe-Dokumentations-Repository erstellen

  5. An dieser Stelle wird eine Benachrichtigung angezeigt, in der Sie aufgefordert werden, die Lizenzvereinbarung für Adobe Contributor License Agreement (CLA) zu unterzeichnen. Dies ist ein notwendiger Schritt. Nachdem Sie die CLA signiert haben, aktualisieren Sie die PR-Seite und senden Sie die Pull-Anforderung.

  6. Sie können bestätigen, dass die Pull-Anforderung gesendet wurde, indem Sie die Registerkarte Pull Requests in https://github.com/AdobeDocs/experience-platform.en überprüfen.

PA erfolgreich

  1. Vielen Dank! Das Adobe-Dokumentationsteam wird sich in der PR für den Fall, dass Änderungen erforderlich sind, an Sie wenden und Ihnen mitteilen, wann die Dokumentation veröffentlicht wird.
TIP
Lesen Sie zum Hinzufügen von Bildern und Links zu Ihrer Dokumentation sowie zu allen anderen Fragen rund um Markdown den Abschnitt Verwenden vonin der kollaborativen Anleitung zum Schreiben in Adobe Markdown.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6