Avec la fonction XML simplifié de FrameMaker, créez des documents XML valides sans avoir à apprendre les règles de contenu sous-jacentes ni la structure XML.
L'environnement de programmation structuré permet d'imposer à structure homogène entre les types d'informations similaires. Pour utiliser l’environnement de programmation structuré, un auteur doit bien maîtriser les règles de contenu et de programmation XML.
La fonction XML simplifié permet de connaître les règles de contenu sous-jacentes ou la structure XML permettant de créer ou d'utiliser un document structuré. La vue XML simplifiée fournit une interface très similaire à la vue WYSIWYG. Toutefois, des champs de formulaire sont contenus pour chaque élément avec lequel un auteur peut travailler. La barre d’outils d’élément rapide est également personnalisée pour créer du contenu dans la vue XML simplifiée, qui permet d’insérer facilement des objets valides dans votre document structuré.
Cette section traite des rubriques suivantes :
Créez des documents conformes à DITA 1.2 et 1.3 à l’aide de l’interface utilisateur XML simplifiée.
L'application structurée DITA 1.3 et 1.2 a été mise à jour de manière à prendre en charge la vue XML simplifiée. Les rubriques DITA suivantes sont prises en charge dans la vue XML simplifiée :
Rubrique ()
Tâche ()
Concept ()
Référence ()
Dépannage () pour DITA 1.3 uniquement
Toutefois, pour créer ou afficher vos rubriques DITA dans la vue XML simplifiée, vous devez activer préalablement cette fonction dans FrameMaker.
Ouvrez la boîte de dialogue Préférences (), puis accédez à l’onglet XML simplifié.
Sélectionnez l’option Activer la vue XML simplifiée.
Configurez les options suivantes des messages d’alerte :
Insérer à l’emplacement valide suivant : FrameMaker déplace le XXX
Ne pas insérer à l’emplacement valide suivant : ne pas insérer l’élément du tout.
Sélectionnez Afficher une alerte lors de la saisie dans un emplacement non valide pour afficher une alerte lorsque vous tentez de saisir ou d’insérer un contenu dans un emplacement où la saisie directe n’est pas autorisée. Dans ce cas, une alerte vous invite à appuyer sur Entrée pour afficher la liste des objets valides ou pour insérer un objet depuis la Barre d’outils Élément rapide..
Sélectionnez cette option pour afficher une alerte lorsque vous tentez de supprimer un objet qui ne peut pas être inséré à l’aide de la barre d’outils d’élément rapide.
Cliquez sur OK pour enregistrer vos préférences.
Vous devez redémarrer FrameMaker pour que la modification prenne effet
Après avoir activé la fonction XML simplifié, vous pouvez commencer à créer des documents structurés dans la vue XML simplifiée. Vous devez cliquer sur le bouton Vue Auteur dans la barre d’application pour passer à la vue XML simplifiée, puis vous pouvez créer un document ou ouvrir un fichier XML existant.
La figure suivante montre une rubrique DITA 1.3 dans la vue XML simplifiée.

A. Nom du champ de formulaire B. Champ de saisie de données de formulaire C. La barre d'outils Élément rapide dans l'environnement de programmation XML simplifié
Une vue de type formulaire de la rubrique DITA est présentée avec le nom du champ de formulaire au-dessus suivi du champ de saisie de données. Pour plus d’informations sur la personnalisation des champs de formulaire, voir Personnalisation de l’environnement de programmation XML simplifié.
Pour saisir des données dans un champ, utilisez les touches fléchées pour sélectionner le champ requis, ou cliquez dans le champ et commencez la saisie. Par exemple, si vous voulez entrer un titre, placez le point d'insertion à l'intérieur du champ du titre de la rubrique et saisissez un titre pour votre document. Le titre que vous avez saisi est imbriqué dans un élément valide en arrière-plan.
Familiarisez-vous avec l’environnement de création de type formulaire et facile à remplir de la vue XML simplifiée dans FrameMaker.
La vue XML simplifiée vous permet de créer facilement des rubriques DITA (1.3 et 1.2) sans nécessiter de connaissances sur la façon dont la structure du document est configurée. Cette vue permet d'écrire plus rapidement lorsque vous travaillez dans un environnement de programmation facile à remplir de type formulaire. En outre, la structure de votre application est conservée lorsque vous placez les éléments à l’emplacement correct et dans les balises XML valides.
Pour créer un contenu dans la vue XML simplifiée :
Sélectionnez l’option Activer la vue XML simplifié dans la boîte de dialogue Préférences.
Cliquez sur le bouton Vue Auteur dans la barre d’application.
La vue se transforme en vue XML simplifiée.
Création d’une rubrique DITA.
Entrez le titre de la rubrique.
Utilisez la touche fléchée bas pour déplacer le curseur vers le champ de description courte et entrez une brève description de la rubrique. Dans le cas d’une description courte, cependant, vous pouvez appliquer le formatage des caractères, par exemple le gras, l’italique, le souligné, et télétype. Pour ce faire, sélectionnez le texte dans le champ de description courte et modifiez le formatage.
Par exemple, pour marquer une partie du texte en gras, sélectionnez le texte et utilisez l’une des méthodes suivantes :
Appuyez sur Ctrl+b.
Appuyez sur Ctrl+1 et choisissez Gras.
Cliquez sur B dans la barre d'outils d'élément rapide.
Pour supprimer l’attribut Gras du texte, sélectionnez le texte et utilisez les méthodes mentionnées ci-dessus.
Exécutez les mêmes étapes pour entrer le nom de l'auteur dans le champ de saisie de votre nom.
Déplacez le curseur sur le contenu du champ de rubrique.
Par défaut, le premier élément disponible dans le domaine de contenu est le paragraphe. Cela signifie que si vous commencez à taper, le texte est placé à l'intérieur de la balise de paragraphe en arrière-plan.
Utilisez la barre d’outils d’élément rapide ou le menu déroulant Insérer un objet pour insérer des éléments.
La section suivante contient plus de détails sur l’insertion et l’utilisation des objets disponibles.
Cette section explique les différentes méthodes permettant de manipuler les objets les plus fréquemment utilisés.
Pour créer une liste triée ou non triée dans le document, sélectionnez le bouton correspondant de la barre d’outils d’élément rapide.
Pour créer un élément de liste, placez le curseur à la fin de l’élément actuel, puis appuyez sur Entrée.
Dans un élément de liste, pour insérer un objet (par exemple une image ou un tableau), utilisez la barre d'outils d'élément rapide ou le menu déroulant Insérer un objet.
Pour convertir entre la liste triée et les listes non triées, placez le point d'insertion n'importe où à l'intérieur de la liste et choisissez le type de liste alternatif depuis la barre d'outils d'élément rapide.
Pour annuler une liste, placez le point d’insertion à la fin du dernier élément de la liste et appuyez sur la touche Entrée deux fois, ou cliquez sur le bouton Atteindre la fin de l’élément de formulaire dans la barre d’outils d’élément rapide.
Pour insérer un élément de liste entre deux listes, placez le point d’insertion à la fin du premier élément de la liste ou au début du second élément de liste et appuyez sur Entrée.
Pour scinder un élément de liste en deux éléments, placez le point d’insertion là où vous souhaitez scinder un élément, puis appuyez sur Entrée.
Pour scinder une liste en deux, placez le point d’insertion à la fin du premier élément de la liste, puis appuyez sur Entrée deux fois. Un nouveau paragraphe est créé entre les listes.
Vous pouvez utiliser les touches de tabulation et majuscule ou le bouton Retrait de liste ou Retrait de liste négatif dans la barre d'outils d'élément rapide pour mettre en retrait ou en retrait négatif (imbriquer) des éléments de liste :
Pour mettre en retrait un élément de la liste, placez le point d'insertion au début de l'élément de liste et appuyez sur la touche de tabulation. Vous pouvez également placer le point d'insertion n'importe sur l'élément Liste et cliquez sur Retrait de liste négatif.
Pour réduire le retrait de l'élément de liste, placez le point d'insertion au début de l'élément de liste et appuyez sur la touche Maj. + Tab. Vous pouvez également placer le point d'insertion n'importe où sur l'élément Liste et cliquer sur Retrait de liste négatif.
Si une liste comporte plusieurs éléments, pour imbriquer certains des éléments de la liste, sélectionnez les éléments et appuyez sur la touche de tabulation, ou cliquez sur Retrait de liste.
Pour réduire le retrait de tout élément d’une liste imbriquée, placez le point d’insertion au début de l’élément de liste et appuyez sur Maj+Tab. Vous pouvez également placer le point d'insertion n'importe où sur l'élément Liste et cliquer sur Retrait de liste négatif.
Si vous insérez un tableau dans votre rubrique, la vue XML simplifiée affiche un ancrage de tableau qui vous permet de sélectionner, développer ou réduire facilement le tableau.
Pour insérer des éléments d’après le tableau, cliquez sur Atteindre la fin de l’élément de formulaire dans la barre d’outils d’élément rapide.
Pour ajouter une ligne au tableau, appuyez sur Tab dans la dernière colonne de la dernière ligne.
Pour passer d’une cellule à l’autre dans un tableau, utilisez la touche Tab, les touches Maj+Tab, ou les touches fléchées.
Pour déplacer le tableau, vous devez cliquer sur l’ancrage du tableau puis faire un glisser-déposer du tableau. Vous pouvez également sélectionner et déplacer (glisser-déposer ou copier/couper/coller) des lignes et des colonnes de tableau, dans un tableau ou entre plusieurs tableaux.
Lorsque vous travaillez dans une rubrique, un concept ou un document de référence DITA, cliquez sur le bouton Figure dans la barre d'outils d'élément rapide ou sélectionnez l'objet Figure dans le menu déroulant Insérer un objet pour insérer une image.
Lorsque vous travaillez sur un document de tâche DITA ou pour dépanner un document, cliquez sur l'icône de données d'image dans la barre d'outils d'élément rapide ou sélectionnez l'objet de données d'image depuis le menu Insérer un objet pour insérer une image.
Dans la boîte de dialogue Insérer un graphique, entrez les détails suivants :
Chemin d’accès au fichier : cliquez sur Parcourir et sélectionnez le fichier d’image que vous souhaitez insérer.
PPP : sélectionnez les PPP (ou la résolution) dans le menu déroulant ou saisissez la résolution à laquelle vous souhaitez insérer l'image.
Titre : (facultatif) Pour un document de rubrique, de concept ou de référence DITA, saisissez le titre ou la légende de l'image. Le champ Titre n'est pas disponible lorsque vous travaillez sur le dépannage d'un document de type de tâches DITA.
Texte de remplacement : (Facultatif) Entrez le texte affiché au cas où l'image n'est pas publiée.
Si vous créez une rubrique de tâche DITA, vous pouvez insérer un graphique dans les champs Titre de procédure, Courte description, et Etapes de procédure. Ceci est dû au fait que dans les rubriques de tâche, le graphique est imbriqué dans l'élément d'image.
Si vous insérez une image, la vue XML simplifiée affiche un ancrage qui vous permet de sélectionner, développer ou réduire facilement l’image.
Pour déplacer l'image, vous devez cliquer sur l'ancrage de l'image puis faire un glisser-déposer d'image.
Pour redimensionner une image, cliquez pour sélectionner l'objet Image (pas l'ancrage d'image) et faites glisser une poignée latérale pour modifier la largeur ou la hauteur.
. Pour afficher les propriétés de l’objet du cadre ancré, cliquez sur l’ancrage, puis sélectionnez .
Vous pouvez insérer des équations MathML dans les types de documents 1.3 DITA (rubrique, tâche, concept, référence, et dépannage)
Pour insérer une équation MathML, cliquez sur le bouton conteneur MathML dans la barre d'outils d'élément rapide.
Si vous insérez une équation MathML dans votre rubrique, la vue XML simplifiée affiche un ancrage d'équation qui vous permet de sélectionner facilement l'équation MathML.
Pour déplacer l'équation MathML, vous devez cliquer sur l'ancrage de l'équation puis faire un glisser-déposer d'équation.
Vous pouvez insérer un élément de liste de définitions en cliquant sur le bouton Liste de définitions dans la barre d’outils d’élément rapides.
Pour insérer une entrée de liste de définitions, cliquez sur le bouton Entrée de liste de définition dans la barre d’outils d’élément rapide.
Pour insérer des éléments après une liste de définition, cliquez sur Atteindre la fin de l’élément de formulaire dans la barre d’outils d’élément rapide.
Vous pouvez insérer un élément de Block de code en cliquant sur le bouton BLock de code dans la barre d'outils d'élément rapides.
Pour insérer des éléments après un bloc de code, cliquez sur Atteindre la fin de l’élément de formulaire dans la barre d’outils d’élément rapide.
Si vous souhaitez appliquer le formatage télétype (espacement unique) à votre contenu, sélectionnez le texte voulu et cliquez sur le bouton d'espacement unique Télétype dans la barre d’outils d’élément rapide.
FrameMaker crée automatiquement une structure valide si vous copiez et collez le contenu depuis des applications externes telles que MS Word, Excel ou un navigateur. Toutefois, si le collage d'un contenu externe génère un fichier DITA non valide, une invite s'affiche et vous demande de copier le contenu sans formatage ou de copier un bloc à la fois.
Vous pouvez également effectuer un glisser-déposer de contenu dans un document. Cependant, si vous essayez d'insérer à un emplacement incorrect le contenu déplacé, FrameMaker affiche une icône rouge et bloque l'opération.
Vous pouvez ouvrir une rubrique DITA dans la vue XML simplifiée. Si la rubrique contient des éléments qui ne sont pas définis dans le formulaire, ces éléments seront affichés, mais ne pourront pas être modifiés. Vous pouvez apporter des modifications au contenu modifiable puis enregistrer la rubrique.
FrameMaker fournit une prise en charge prête à l'emploi pour rubrique, tâche, référence et concept DITA. Toutefois, un fichier XML dont l'application structurée correspondante est configurée avec le fichier de configuration Vue XML simplifiée peut être ouvert dans cette vue. Si le fichier de configuration est défini mais que le modèle n’est pas spécifié, le modèle par défaut défini dans l’application structurée est utilisé et un message apparaît dans la console lorsque vous passez à la vue XML simplifiée. Pour plus d’informations, voir Personnalisation de l’environnement de programmation XML simplifié.
Apprenez à personnaliser l’environnement de programmation XML simplifiée dans FrameMaker.
Vous pouvez spécifier les champs (ainsi que leur aspect) dans la vue XML simplifiée pour une application structurée spécifique. Par exemple, dans l’application structurée par rubrique DITA, vous pouvez choisir de masquer le champ de description courte ou d’afficher uniquement les champs de titre de rubrique et de corps. FrameMaker vous permet également de spécifier un fichier modèle personnalisé, qui permet d’effectuer le rendu des champs de formulaire dans la vue XML simplifiée.
Chaque application structurée prenant en charge la vue XML simplifiée comprend un fichier de configuration (.ini). Vous pouvez utiliser des indicateurs dans ce fichier pour personnaliser les champs dans la vue XML simplifiée correspondante.
Ouvrez le document suivant :
<Fm_install_location>\Structure\structapps.fm
L’application structurée de chaque type de rubrique DITA (rubrique, tâche, référence, concept et dépannage) dans ce fichier inclut un champ Vue de formulaire.
La Vue formulaire contient deux indicateurs :
Fichier de configuration : définit le fichier de configuration pour l’application structurée correspondante.
Modèle : définit le fichier modèle associé à l'application structurée pour le rendu de l'interface utilisateur dans la vue XML simplifiée.
Pour personnaliser le fichier .ini, vous devez le copier dans un emplacement en dehors du répertoire d'installation FrameMaker actuel.
Dans le champ Fichier de configuration du formulaire, mettez à jour l’emplacement du fichier conformément à l’étape précédente.
Le fichier de configuration permet de travailler avec les champs suivants.
Spécifiez les éléments d'application structurée à afficher dans la vue XML simplifiée. La syntaxe pour spécifier les FormElements est :
corps,Corps,1,1| où,
corps : nom de l'élément défini dans le modèle structuré.
Corps : Etiquette affichée en haut du champ de formulaire dans la vue XML simplifiée.
0,1 : Spécifiez si cet élément est facultatif (0) ou obligatoire (1). Si vous spécifiez un élément comme étant obligatoire, l'utilisateur doit saisir une valeur correspondant à cet élément avant de sauvegarder le document.
0,1 : (Facultatif) Indiquez si un champ est le champ de contenu et si le catalogue d'objets d'insertion s'affiche lors de l'activation de la touche Entrée dans ce champ. Par défaut, la valeur 0 est affectée à un champ où cette valeur n'est pas spécifiée.
| : Délimiteur (barre verticale discontinue) pour spécifier d’autres éléments.
Exemple : FormElements=title,titre de votre rubrique,1|shortdesc,courte description - un paragraphe,0|l’auteur, saisissez votre nom,1|corps,contenu de votre rubrique,1,1
Le format de paragraphe défini dans le modèle utilisé pour afficher les intitulés de formulaire.
Exemple : FormLabelPgfFormat=fm-title
Le format de paragraphe défini dans le modèle utilisé pour afficher les intitulés de formulaire obligatoires.
Exemple : RequiredFormLabelPgfFormat=fm-titlerequired
Définissez la couleur de limite par défaut pour la limite du champ de formulaire.
Exemple : FormFieldColor=GrayDark
Définissez la couleur de la limite de champ obligatoire.
Exemple : RequiredFormFieldColor=Red
Définissez la couleur de la limite de champ actuellement sélectionné.
Exemple : SelectedFormFieldColor=Blue
Spécifiez l’élément à créer lorsque vous appuyez sur la touche Entrée dans un élément de paragraphe. Vous pouvez également spécifier plusieurs éléments séparés par une barre verticale (|).
Si vous avez défini plusieurs éléments, FrameMaker insère le premier élément valide dans le contexte actuel. Par exemple, dans le cas d’une tâche DITA, vous pouvez associer cet indicateur à un paragraphe et à des éléments d’informations ((p|info). Lorsqu’un utilisateur appuie sur la touche Entrée, FrameMaker tente d’abord d’insérer un élément de paragraphe à l’emplacement actuel, mais si le paragraphe est incorrect, il insère alors l’élément d’information (<info>).
Exemple : ParaElements=p|info
Spécifiez l'élément associé à la liste triée. Par exemple, dans une rubrique DITA, vous pouvez associer cet indicateur à l'élément <ol> pour créer une nouvelle liste triée. Toutefois, dans le cas d’une tâche DITA, vous pouvez associer cet indicateur à l’élément <étapes> pour créer une nouvelle procédure.
Exemple : OrderedListElement=ol
Spécifiez l'élément par défaut à créer lorsque vous appuyez sur la touche Entrée dans un élément de liste triée. Par exemple, dans une rubrique DITA, vous pouvez associer cet indicateur à l'élément <li> pour créer un nouvel élément de liste dans une liste triée. Toutefois, dans le cas d’une tâche DITA, vous pouvez associer cet indicateur à l’élément étape pour créer une nouvelle étape dans une procédure.
Exemple : OrderedListItemElement=li
Spécifiez l'élément associé à la liste non triée. Par exemple, dans une rubrique DITA, vous pouvez associer cet indicateur< sur l'élément> UL pour créer une nouvelle liste non ordonnée. Toutefois, dans le cas d’une tâche DITA, vous pouvez associer cet indicateur à l’élément étapes-non trié pour créer une nouvelle procédure imbriquée.
Exemple : UnorderedListElement=ul
Spécifiez l'élément par défaut à créer lorsque vous appuyez sur la touche Entrée dans un élément de liste non triée. Par exemple, dans une rubrique DITA, vous pouvez associer cet indicateur à l'élément <li> pour créer un nouvel élément dans une liste non triée. Toutefois, dans le cas d'une tâche DITA, vous pouvez associer cet indicateur à l'élément étape pour créer une nouvelle étape dans une procédure imbriquée.
Exemple : UnorderedListItemElement=li
Spécifiez l’élément à utiliser (<b>) pour appliquer le formatage gras au texte lorsque la combinaison de touches Ctrl+b est utilisée.
Exemple : BoldElement=b
Spécifiez l’élément à utiliser (<i>) pour appliquer le formatage italique au texte lorsque la combinaison de touches Ctrl+i est utilisée.
Exemple : ItalicElement=i
Spécifiez l’élément à utiliser (<u>) pour appliquer le formatage souligné au texte lorsque la combinaison de touches Ctrl+u est utilisée.
Exemple : UnderlineElement=u
Après avoir apporté les modifications nécessaires au fichier de configuration, enregistrez le fichier.
Redémarrez l'application structurée active.
Accédez à structapps.fm et sélectionnez .
Si une rubrique structurée est ouverte, accédez à la rubrique et passez à la vue Auteur.
Toutes les modifications apportées au fichier de configuration sont immédiatement répercutées.
Chaque application structurée prenant en charge la vue XML simplifiée comporte un modèle FrameMaker. Ce modèle définit comment les différents éléments de formulaire sont présentés dans la vue XML simplifiée. Par exemple, vous pouvez personnaliser la taille et la couleur des étiquettes de champs obligatoires du formulaire ou définir les règles d’insertion automatique des éléments. Toutes les modifications que vous apportez à ce fichier modèle sont répercutées dans la vue XML simplifiée.
Dans structapps.fm, le champ permet de définir le fichier modèle de vue XML simplifiée pour l’application structurée correspondante.
Pour personnaliser le fichier modèle, vous devez le copier dans un emplacement en dehors du répertoire d'installation FrameMaker actuel.
Dans le champ Modèle, mettez à jour l'emplacement du fichier conformément à l'étape précédente.
Mettez à jour le fichier modèle au besoin et enregistrez le fichier.
Redémarrez l'application structurée active.
Accédez à structapps.fm et sélectionnez .
Si une rubrique structurée est ouverte, accédez à la rubrique et passez à la vue Auteur.
Toutes les modifications apportées au fichier modèle sont immédiatement répercutées.