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 :

  1. Dans le panneau Référentiel, sélectionnez , puis sélectionnez Rubrique dans la liste déroulante.

  2. Dans la boîte de dialogue Nouvelle rubrique, fournissez les détails suivants :

    {width="300"}

    • 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.

  3. Sélectionnez Créer.

    La rubrique Markdown est créée au niveau du chemin d’accès sélectionné et est ouverte pour modification.

    {width="650"}

NOTE
Vous pouvez également créer une rubrique Markdown pour un dossier dans le panneau Référentiel. Sélectionnez le dossier dans lequel vous souhaitez créer une rubrique Markdown et sélectionnez Nouveau, puis Rubrique dans le menu Options. Vous pouvez désormais créer une rubrique Markdown en fournissant des détails sur la rubrique dans la boîte de dialogue Créer une rubrique.

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 :

Fonctions
Description
Modifier les actions
Permet d'accéder à diverses fonctions d'édition de documents, y compris Couper   , Annuler   , Rétablir   , Copier   , Supprimer   et Rechercher et remplacer   . Vous pouvez accéder aux options disponibles à partir du menu déroulant Menu.
Options de formatage du texte
Permet d’accéder à diverses options de formatage de texte, y compris Titres   , Gras   , Italique   , Barré   , Code   et Citation en bloc   .
Options d'insertion de contenu
Fournit des options pour insérer une liste numérotée   , Liste ordonnée   , Tableau   , Image , Référence croisée   et symbole   dans un document.

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.
Historique des versions
Permet de créer des versions des fichiers Markdown et d’afficher l’historique des modifications. Vous pouvez comparer différentes versions et revenir aux versions précédentes si nécessaire. L’option Historique des versions est présente dans le menu déroulant Menu.
Enregistrer comme nouvelle version
Enregistre les modifications apportées à la rubrique et crée également une nouvelle version de la rubrique. Si vous travaillez sur une rubrique nouvellement créée, les informations de version apparaissent comme aucune.
Verrouiller/déverrouiller
Verrouille ou déverrouille le fichier courant. Le verrouillage d’un fichier vous donne un accès exclusif en écriture au fichier. Cela empêche d’autres utilisateurs de modifier le fichier. Déverrouillez le fichier si vous souhaitez que d’autres utilisateurs aient un accès en modification. En tant qu’administrateur, vous avez également accès à la fonctionnalité Forcer le déverrouillage qui vous permet de déverrouiller le fichier verrouillé par une autre personne.
NOTE
La fonctionnalité Historique des versions et les fonctionnalités mentionnées sous les actions de modification, la mise en forme du texte et l’insertion de contenu sont accessibles à partir des vues Source et côte à côte de la rubrique Markdown.

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.

{width="550"}

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 :

  1. Révision
  2. Fusionner
  3. Assistant IA
  4. Suivi des modifications
  5. Rechercher et remplacer
  6. Rechercher et filtrer
NOTE
La fonction Rechercher et remplacer ne traite pas les fichiers Markdown au niveau du référentiel. Cela inclut la recherche d’un fichier Markdown dans un mappage ou un dossier. Cependant, elle peut toujours être utilisée dans l’éditeur Markdown. En outre, les options Rechercher et Filtrer de la vue Référentiel ne traitent pas les fichiers Markdown.

Rubrique parente : Présentation de l’éditeur

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178