Experience Manager Guides et Edge Delivery Services

Ouvrez le référentiel de modèles standard Experience Manager Guides aem-guides-boilerplate.

Créez un référentiel à l’aide de ce modèle. En savoir plus sur la création d’un référentiel à partir d’un modèle. Assurez-vous que la visibilité du référentiel est définie sur Public afin qu’il soit accessible par EDS.

Sur GitHub, accédez à la barre latérale gauche et sélectionnez Paramètres du développeur.

Dans la barre latérale gauche, sélectionnez Applications OAuth.

Sélectionnez Nouvelle application OAuth.

{width="650"}

Enregistrez votre application en fournissant les informations obligatoires suivantes :

• Nom de l’application : saisissez le nom de votre référentiel EDS
• URL de la page d’accueil : saisissez l’URL de l’instance Experience Manager Guides. (Pour obtenir un exemple de format d’URL, reportez-vous à l’étape 4 de la section Création d’une application GitHub).
• URL de rappel d’autorisation : identique à l’URL de la page d’accueil

Sélectionnez l’option Activer le flux d’appareils puis sélectionnez Enregistrer l’application pour terminer l’enregistrement.

{width="650"}

Dans votre référentiel GitHub, ouvrez le fichier fstab.yaml .

Mettez à jour la valeur url en utilisant le format suivant :

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

Le tableau suivant décrit chaque champ de l’URL :

Par exemple, si votre nom d’utilisateur GitHub est my-username et que votre nom de référentiel est my-eds-repo, le fichier fstab.yaml se présente comme suit :

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

{width="650"}

Répétez les étapes 2 et 3 de la section Connexion de GitHub à Adobe via la synchronisation de code AEM pour autoriser le référentiel.

Accédez à la page Synchronisation du code ​ et sélectionnez Installer.

La synchronisation du code surveille les modifications du référentiel et s’assure que les mises à jour sont correctement transmises à GitHub.

Sur la page suivante, accordez l’accès au référentiel que vous avez créé. Sélectionnez Sélectionner uniquement les référentiels, puis sélectionnez votre référentiel dans la liste déroulante.

{width="350"}

Sélectionnez Installer et autoriser.

Vous êtes redirigé vers la page de configuration GitHub.

Vérifiez les détails du code source et sélectionnez Suivant.

Sur la page Source de contenu, configurez les paramètres suivants :

• Type de source de contenu : sélectionnez Autre (apportez vos propres balises).
• URL de la source de contenu : vérifiez l’URL configurée comme URL de point de montage dans le fichier fstab.yaml. Si vous n’avez pas mis à jour l’URL dans le fichier , vous pouvez la mettre à jour ici.
• Extension de fichier : remplacez le suffixe .html par défaut par .htm.

Assurez-vous que l’option Utiliser une autre source de contenu est sélectionnée.

Sur la page Utilisateurs, ajoutez des utilisateurs si nécessaire, puis sélectionnez Suivant.

Vérifiez le résumé de la configuration et sélectionnez Enregistrer.

Une fois l’enregistrement effectué, une page de confirmation s’affiche. Vous pouvez copier et enregistrer les URL Aperçu et Live pour votre site web à partir de cette page.

Accédez à Paramètres > Publier des profils.

Sélectionnez l’icône + pour créer un profil de publication et fournissez les détails suivants :

• Type de serveur* : sélectionnez Git (Edge Delivery Service) dans la liste déroulante.

• Nom* : saisissez un nom pour le profil de publication.

• Type de compte Git* : sélectionnez GitHub ou GitLab dans la liste déroulante, en fonction de votre fournisseur de référentiel Git.

• URL de l’instance* : saisissez l’URL de votre instance GitHub ou GitLab, par exemple https://github.com ou https://gitlab.com.

• Nom du référentiel* : saisissez le nom de votre référentiel GitHub ou GitLab.

• Nom d’utilisateur* : saisissez votre nom d’utilisateur GitHub ou GitLab.

• Nom de la branche : défini sur main (par défaut).

• Dossier racine* : défini sur docs (par défaut).

• Propriétaire du site (GitLab uniquement) : saisissez le propriétaire du site Edge Delivery Services.

• Référentiel de site (GitLab uniquement) : saisissez le nom du référentiel associé au site Edge Delivery Services.

• Clé API HLX : saisissez la clé API HLX pour votre configuration EDS. Cette clé est nécessaire pour prendre en charge la fonctionnalité Dépublié introduite dans la version 2026.11.0 de Experience Manager Guides as a Cloud Service. En outre, la clé est requise pour publier le contenu sur EDS si la taille du contenu est supérieure à 100 fichiers.

• Informations d’authentification : les informations d’identification en fonction du type de compte Git sélectionné :

  • GitHub: saisissez l’ID client* et le Secret client* obtenus à partir de votre application OAuth GitHub. Pour plus d’informations, voir Création d’une application OAuth.
  • GitLab : saisissez le jeton d’accès* généré pour votre compte GitLab.

(GitHub uniquement) Sélectionnez Connexion pour vous authentifier. Pour GitLab, aucune connexion n’est requise, car le jeton d’accès est utilisé pour l’authentification.

{width="650"}

Sélectionnez Enregistrer. Pour GitHub, l’option Enregistrer est disponible après une authentification réussie.

Ouvrez votre carte dans la console Carte.

Dans l’onglet Paramètres prédéfinis de sortie, sélectionnez + pour créer un paramètre prédéfini de sortie.

Dans la boîte de dialogue Nouveau paramètre prédéfini de sortie, fournissez les détails suivants :

• Type : Sélectionnez Service Edge Delivery
• Nom : attribuez un nom à ce paramètre prédéfini

Sélectionnez Ajouter.

{width="650"}

Ouvrez le paramètre prédéfini de sortie EDS que vous venez de créer et configurez les champs suivants :

• Filtrage conditionnel : sélectionnez Aucun pour générer une sortie sans filtrage ou Utilisation de DITAVAL pour appliquer un filtrage conditionnel.

• Publier le sous-dossier : saisissez le nom du sous-dossier dans lequel la sortie est publiée. Le sous-dossier est créé dans votre référentiel sous le dossier racine et son nom apparaît dans les liens EDS vers le contenu publié. Par exemple, si le dossier racine est docs et que le sous-dossier de publication est product-guide, le contenu est publié sur docs/contents/product-guide.

• Profil de publication : sélectionnez le profil de publication GitHub ou GitLab configuré dans la section précédente.

  {width="650"}

Sélectionnez Enregistrer, puis Générer la sortie.

Accédez à votre référentiel GitHub et ouvrez le dossier blocks .

Sélectionnez le bloc chemin de navigation.

{width="650"}

Ouvrez le fichier css et mettez à jour la couleur du texte.

Validez les modifications dans GitHub.

Actualisez le site Web en ligne pour afficher les mises à jour.

Ouvrez le fichier de rubrique et sélectionnez le texte dans un élément de balise.

Dans la capture d’écran suivante, le contenu à l’intérieur de la balise example est sélectionné.
{width="650"}

Pour configurer le texte dans la balise example :

• Accédez à Propriétés du contenu.
• Ajoutez l’attribut outputclass .
• Définissez sa valeur sur example eds-force-block.
• Sélectionnez Ajouter.
  {width="650"}

Enregistrez et régénérez la sortie.

Créez un dossier portant le même nom que le outputclass dans le répertoire blocks. Découvrez comment ajouter des fichiers à un référentiel.

{width="650"}

Ajoutez les css requis et les fichiers js facultatifs.

{width="650"}

Validez les modifications et régénérez la sortie.