Créer des documents Markdown à partir de l’éditeur id223MIE0B079
Markdown est un langage de balisage léger qui peut vous aider à ajouter des éléments de mise en forme aux documents en texte brut. Adobe Experience Manager Guides permet de créer et de prévisualiser une rubrique Markdown (.md) à partir de l’éditeur. Vous pouvez également charger les documents Markdown existants et les modifier dans l’éditeur.
Créer une rubrique Markdown
Pour créer une rubrique Markdown à partir de l’éditeur, procédez comme suit :
-
Dans le panneau Référentiel, sélectionnez
-
Dans la boîte de dialogue Nouvelle rubrique, fournissez les détails suivants :
- Titre : indiquez un titre pour la rubrique.
- Name : le nom du fichier est suggéré automatiquement en fonction du titre du topic. Si votre administrateur a activé les noms de fichiers automatiques en fonction du paramètre UUID, le champ Nom ne s’affiche pas.
- Modèle : sélectionnez Markdown dans la liste déroulante. Le modèle Rubrique est sélectionné par défaut.
- Chemin : recherchez le chemin d’accès où vous souhaitez enregistrer le fichier de rubrique. Par défaut, le chemin du dossier actuellement sélectionné dans le référentiel s’affiche dans le champ Chemin .
En cas de mise à niveau, vous devez ajouter le modèle Markdown dans le profil de dossier actuel utilisé. Vous pouvez créer un modèle Markdown à partir de l’éditeur ou utiliser un modèle existant pour la création Markdown. Pour plus d’informations sur l’ajout de modèles de création dans Experience Manager Guides, consultez Configuration de profils globaux ou au niveau du dossier.
-
Sélectionnez Créer.
La rubrique Markdown est créée au niveau du chemin d’accès sélectionné et est ouverte pour modification.
Connaître les fonctionnalités de l’éditeur pour une rubrique Markdown
Cette section vous guide à travers les différentes fonctionnalités disponibles dans l’éditeur pour la création de rubriques Markdown. L’interface de création est divisée en plusieurs sections ou zones :
Barre d’outils
La barre d’outils se trouve juste en dessous de la barre d’onglets. Les fonctionnalités disponibles dans la barre d’outils sont expliquées comme suit :
Remarque : vous pouvez également faire glisser et déposer des images et d’autres fichiers dans l’éditeur Markdown. Les fichiers sont ajoutés en tant que liens de référence croisée, tandis que les images sont affichées en tant qu’éléments d’image standard.
Zone d'édition du contenu
La zone de modification du contenu affiche la source Markdown de votre rubrique, dans laquelle vous apportez toutes les modifications au contenu. Dans la vue côte à côte, cette zone se divise en deux sections : vue source Markdown à gauche et Aperçu à droite. Plusieurs rubriques peuvent être ouvertes en même temps et s’afficher dans leurs onglets respectifs.
Modes Source, Côte à côte et Aperçu
Pour la création Markdown, l’éditeur prend en charge trois modes d’affichage différents pour faciliter la création et la mise en forme du contenu :
- Source
- Côte à côte
- Prévisualisation
Source
Il s’agit de l’affichage du code Markdown de l’éditeur. Vous pouvez modifier des rubriques Markdown comme vous le feriez dans n’importe quel éditeur Markdown standard. Dans la vue Source, vous avez la possibilité d'enregistrer une révision du document, d'insérer des en-têtes, d'insérer un tableau, d'insérer une image, etc.
Utilisez cette vue si vous souhaitez vous concentrer uniquement sur l’écriture et la modification du markdown brut sans afficher la sortie rendue.
Côte à côte
Ce mode divise l’éditeur en deux panneaux :
- Panneau Source qui affiche la rubrique Markdown que vous modifiez.
- Panneau d’aperçu qui affiche la sortie rendue de la rubrique Markdown en temps réel.
Utilisez cette vue pour afficher la sortie rendue en temps réel lorsque vous modifiez des rubriques Markdown.
Aperçu
L’ouverture d’une rubrique Markdown en mode Prévisualisation permet de voir comment une rubrique sera affichée lorsqu’elle est consultée par un utilisateur dans son navigateur. Dans cette vue, toutes les fonctions de modification sont supprimées de la barre d’outils. Cependant, vous pouvez toujours accéder aux fonctions Enregistrer en tant que nouvelles versions, Verrouiller/déverrouiller de la barre d’outils, ainsi qu’à la fonction Propriétés du fichier dans le panneau de droite.
Panneau de droite
Le panneau de droite vous donne accès au panneau **Propriétés du fichier).
Les propriétés du fichier comportent les deux sections suivantes :
Général
La section Général vous donne accès aux fonctionnalités suivantes :
- Nom de fichier : affiche le nom de fichier de la rubrique sélectionnée.
- ID : affiche l’ID de la rubrique sélectionnée.
- Langue : affiche la langue de la rubrique. Elle est définie à partir du champ langue de la page des propriétés.
- Créé le : affiche la date et l’heure de création de la rubrique.
- Modifié le : affiche la date et l’heure de modification de la rubrique.
- Verrouillé par : affiche l’utilisateur qui a extrait la rubrique.
- État du document : vous pouvez sélectionner et mettre à jour l’état du document de la rubrique actuellement ouverte. Pour plus d’informations, voir État du document.
- Balises : il s’agit des balises de métadonnées de la rubrique. Elles sont définies dans le champ de balises de la page de propriétés. Vous pouvez les saisir ou les sélectionner dans la liste déroulante. Les balises s’affichent sous la liste déroulante. Pour supprimer une balise, sélectionnez l’icône en forme de croix en regard de la balise.
- Modifier plus de propriétés : vous pouvez modifier d’autres propriétés à partir de la page des propriétés du fichier.
Références
La section Références vous donne accès aux fonctionnalités suivantes :
- Utilisé dans : le champ Utilisé dans les références répertorie les documents dans lesquels le fichier actuel est référencé ou utilisé.
- Liens sortants : les liens sortants répertorient les documents auxquels il est fait référence dans le document actif.
Toutes les références de liens utilisés dans et sortants renvoient vers les documents sous forme d’un lien hypertexte. Vous pouvez facilement ouvrir et modifier les documents liés.
Limites des fonctionnalités
Les fonctionnalités Experience Manager Guides suivantes ne s’appliquent actuellement pas à la création Markdown :
- Révision
- Fusionner
- Assistant IA
- Suivi des modifications
- Rechercher et remplacer
- Rechercher et filtrer
Rubrique parente : Présentation de l’éditeur