Experience Manager Guides und Edge Delivery Services

Öffnen Sie das Experience Manager Guides-Vorlagenrepository aem-guides-boilerplate.

Erstellen Sie mithilfe dieser Vorlage ein neues Repository. Erfahren Sie Erstellen eines Repositorys aus einer Vorlage. Stellen Sie sicher, dass die Repository-Sichtbarkeit auf "" ist, damit der Zugriff über EDS möglich ist.

Navigieren Sie auf GitHub zur linken Seitenleiste und wählen Sie Entwicklereinstellungen.

Wählen Sie in der linken Seitenleiste OAuth-Apps aus.

Wählen Sie Neue OAuth-App aus.

{width="650"}

Registrieren Sie Ihre Anwendung, indem Sie die folgenden obligatorischen Details angeben:

• Anwendungsname: Geben Sie den Namen Ihres EDS-Repositorys ein
• Homepage-URL: Geben Sie die URL für die Experience Manager Guides-Instanz ein. (Das Beispiel-URL-Format finden Sie in Schritt 4 des Abschnitts Erstellen einer neuen GitHubApp).
• Autorisierungs-Callback-URL: identisch mit der Homepage-URL

Wählen Sie die Option Gerätefluss aktivieren und wählen Sie dann Anwendung registrieren, um die Registrierung abzuschließen.

{width="650"}

Öffnen Sie die fstab.yaml-Datei in Ihrem GitHub-Repository.

Aktualisieren Sie den url unter Verwendung des folgenden Formats:

https://guides.adobe.com/eds-workers/<account type>/<git acc domain>/<git username>/<git repo>/<branch>/<root folder>

In der folgenden Tabelle werden die einzelnen Felder der URL beschrieben:

Wenn beispielsweise Ihr GitHub-Benutzername my-username und Ihr Repository-Name my-eds-repo ist, wird die fstab.yaml wie folgt angezeigt:

mountpoints:
  /:
    url: https://guides.adobe.com/eds-workers/github/github.com/my-username/my-eds-repo/main/docs
    type: markup

{width="650"}

Wiederholen Sie die Schritte 2 und 3 aus dem Abschnitt Verbinden von GitHub mit Adobe über AEM Code-), um das Repository zu autorisieren.

Navigieren Sie zur Seite AEM Code Sync und wählen Sie Installieren.

AEM Code Sync überwacht Repository-Änderungen und stellt sicher, dass Aktualisierungen korrekt an GitHub gesendet werden.

Gewähren Sie auf der nächsten Seite Zugriff auf das von Ihnen erstellte Repository. Wählen Sie Nur Repositorys auswählen und wählen Sie dann Ihr Repository aus der Dropdown-Liste aus.

{width="350"}

Wählen Sie Installieren und autorisieren aus.

Sie werden zur GitHub-Setup-Seite weitergeleitet.

Überprüfen Sie die Details zum Quell-Code und wählen Sie Weiter aus.

Konfigurieren Sie auf Seite Inhaltsquelle“ die folgenden Einstellungen:

• Quelltyp des Inhalts: Wählen Sie Sonstige (eigenes Markup einbringen).
• Inhaltsquellen-URL: Überprüfen Sie die URL, die als Bereitstellungspunkt-URL in der fstab.yaml-Datei konfiguriert ist. Wenn Sie die URL in der Datei nicht aktualisiert haben, können Sie sie hier aktualisieren.
• Dateierweiterung: Ändern Sie das standardmäßige .html Suffix in .htm.

Stellen Sie sicher dass „Andere Inhaltsquelle verwenden ausgewählt ist.

Fügen Sie auf Seite Benutzer“ bei Bedarf Benutzer hinzu und klicken Sie auf Weiter.

Überprüfen Sie die Konfigurationsübersicht und wählen Sie Speichern aus.

Nach erfolgreicher Registrierung wird eine Bestätigungsseite angezeigt. Sie können die URLs Vorschau und Live für Ihre Website von dieser Seite kopieren und speichern.

Wechseln Sie zu Workspace Einstellungen > Profile veröffentlichen.

Wählen Sie das Symbol + aus, um ein neues Veröffentlichungsprofil zu erstellen, und geben Sie die folgenden Details an:

• Servertyp*: Wählen Sie Git (Edge Delivery-Service) aus der Dropdown-Liste aus.

• Name*: Geben Sie einen Namen für das Veröffentlichungsprofil ein.

• Git-Kontotyp*: Wählen Sie GitHub oder GitLab aus der Dropdown-Liste aus, je nach Git-Repository-Anbieter.

• Instanz-URL*: Geben Sie die URL Ihrer GitHub- oder GitLab-Instanz ein, z. B. https://github.com oder https://gitlab.com.

• Repository-Name*: Geben Sie den Namen Ihres GitHub- oder GitLab-Repositorys ein.

• Benutzername*: Geben Sie Ihren GitHub- oder GitLab-Benutzernamen ein.

• Zweigname: auf main (Standard) gesetzt.

• Stammordner*: Auf docs (Standard) gesetzt.

• Site-Inhaber (nur GitLab): Geben Sie den Inhaber der Edge Delivery Services-Site ein.

• Site-Repository (nur -Lab: Geben Sie den Repository-Namen ein, der mit der Edge Delivery Services-Site verknüpft ist.

• HLX-API-Schlüssel Geben Sie den HLX-API-Schlüssel für Ihre EDS-Konfiguration ein. Dieser Schlüssel ist erforderlich, um die Funktion „Veröffentlichung rückgängig gemacht“ zu unterstützen, die in der Version 2026.11.0 von Experience Manager Guides as a Cloud Service eingeführt wurde. Außerdem ist der Schlüssel für die Veröffentlichung des Inhalts in EDS erforderlich, wenn die Inhaltsgröße mehr als 100 Dateien beträgt.

• Authentifizierungsberechtigungen: Geben Sie die Anmeldeinformationen basierend auf dem ausgewählten Git-Kontotyp an:

  • GitHub: Geben Sie die Client-ID* und Client-Geheimnis* ein, die Sie von Ihrer GitHub OAuth-App erhalten haben. Weitere Informationen finden ​ unter „Erstellen einer neuen OAuth-".
  • GitLab: Geben Sie das Zugriffstoken* ein, das für Ihr GitLab-Konto generiert wurde.

(Nur GitHub) Wählen Sie Anmelden aus, um sich zu authentifizieren. Für GitLab ist keine Anmeldung erforderlich, da das Zugriffstoken für die Authentifizierung verwendet wird.

{width="650"}

Klicken Sie auf Speichern. Für GitHub ist die Option Speichern nach erfolgreicher Authentifizierung verfügbar.

Öffnen Sie Ihre Karte in der Kartenkonsole.

Wählen Sie auf Registerkarte Ausgabevorgaben“ + aus, um eine neue Ausgabevorgabe zu erstellen.

Geben Sie Dialogfeld „Neue" die folgenden Details ein:

• type: Edge Delivery-Service auswählen
• Name: Geben Sie einen Namen für diese Voreinstellung an

Wählen Sie Hinzufügen aus.

{width="650"}

Öffnen Sie die neu erstellte EDS-Ausgabevorgabe und konfigurieren Sie die folgenden Felder:

• Bedingte Filterung: Wählen Sie Keine, um eine Ausgabe ohne Filterung zu generieren, oder Mit DITAVAL, um die bedingte Filterung anzuwenden.

• Unterordner veröffentlichen: Geben Sie den Namen des Unterordners ein, in dem die Ausgabe veröffentlicht wird. Der Unterordner wird im Repository unter dem Stammordner erstellt und erscheint in den EDS-Links zum veröffentlichten Inhalt. Wenn beispielsweise der Stammordner docs und der Unterordner Veröffentlichen product-guide ist, wird der Inhalt in docs/contents/product-guide veröffentlicht.

• Veröffentlichungsprofil: Sie das im vorherigen Abschnitt konfigurierte GitHub- oder GitLab-Veröffentlichungsprofil aus.

  {width="650"}

Wählen Sie Speichern und dann Ausgabe generieren.

Wechseln Sie zu Ihrem GitHub-Repository und öffnen Sie den Ordner blocks .

Wählen Sie den Breadcrumbs-Block aus.

{width="650"}

Öffnen Sie die css und aktualisieren Sie die Textfarbe.

Übertragen Sie die Änderungen an GitHub.

Aktualisieren Sie die Live-Website, um die Aktualisierungen anzuzeigen.

Öffnen Sie die Themendatei und wählen Sie den Text in einem Tag-Element aus.

Im folgenden Screenshot ist der Inhalt innerhalb des example-Tags ausgewählt.
{width="650"}

So konfigurieren Sie den Text im example-Tag:

• Navigieren Sie zu Inhaltseigenschaften.
• Fügen Sie das Attribut outputclass hinzu.
• Legen Sie den Wert auf example eds-force-block fest.
• Wählen Sie Hinzufügen aus.
  {width="650"}

Speichern und regenerieren Sie die Ausgabe.

Erstellen Sie einen neuen Ordner mit demselben Namen wie der outputclass im blocks. Erfahren Sie mehr über Hinzufügen von Dateien zu einem Repository.

{width="650"}

Fügen Sie die erforderlichen css und optionale js hinzu.

{width="650"}

Änderungen übernehmen und Ausgabe neu generieren.