Studio de mise en page PDF

Guide d'utilisation


Le studio de mise en page est destiné à la création des feuilles de style PDF et leur gestion par l'utilisateur en toute autonomie.

1. Créer une feuille de style

Par défaut, toutes les feuilles de style sont stockées dans la langue Commun.

[Note]

Il est possible de créer une feuille de style dans une langue particulière, afin d'effectuer un paramétrage spécifique qui respecte les contraintes de cette langue.

  1. Dans votre espace de travail, dans le menu Feuilles de style, cliquez sur Créer.

  2. Un nouvel onglet Calenco PDF Studio s'ouvre pour le paramétrage de la feuille de style.

Figure 1. Zones du studio

Zones du studio

2. Barre d'actions

Comme tout contenu Calenco, les feuilles de style ont deux noms (voir plus d'information sur  Nommage des contenus) :

  • Le nom technique est créé par défaut.
  • Le label est personnalisé et peut être modifié à tout moment.

    [Important]

    La feuille de style est créée dans Calenco lors de sa première sauvegarde.

    Le label mis à jour est visible dans la définition des publications existantes utilisant la feuille de style.

Cliquez sur à droite sur la barre d'actions, pour télécharger la feuille de style directement du studio.

3. Paramétrer une feuille de style

Tous les éléments d'un document paramétrables avec le studio sont organisées en trois menus principaux.

Un éditeur de paramètres est associé à chaque sous-menu.

La zone de prévisualisation affiche instantanément les modifications apportées.

Les outils de prévisualisation permettent de :

  • zoomer / dézoomer la zone de prévisualisation
  • afficher / masquer la zone du corps de page et les en-tête et pied de page.

3.1. Général

3.1.1. Dimensions de la page

Ce menu contient des paramétrages applicables à toutes les pages d'un document.

L'unité de mesure définie par défaut est le « millimètre ».

Il existe deux autres unités de mesure au choix pour certains paramètres :

  • pt : unité pertinente pour les documents qui doivent être imprimés ;
  • em : unité relative à la taille de la police. Elle est pertinente pour les documents qui seront consultés sur des écrans de différentes tailles (laptops, écrans externes, tablettes, smartphones).
En-tête et pied de page

Utilisez ces paramètres pour ajuster la hauteur des lignes avec la prévisualisation complète de la page.

Effectuez le paramétrage initial de l'en-tête et du pied de page avec le menu En-tête et pied de page.

3.1.2. Titres des éléments de structure

Les paramétrages effectués dans le menu Par défaut affectent tous les éléments de structure présents dans le document.

Le menu de chaque élément permet de paramétrer des valeurs particulières pour certains styles en préservant les valeurs par défaut pour d'autres.

En paramétrant les valeurs particulières, la flèche à droite de chaque paramètre devient active.

Cliquez sur la flèche pour revenir à la valeur par défaut.

La fonctionnalité Césure permet d'effectuer une coupure d'un mot particulièrement long à la fin de la ligne d'un titre.

3.1.3. Titres des sections

Ce menu est dédié au paramétrage des titres de 6 niveaux de sections.

La fonctionnalité Césure permet d'effectuer une coupure d'un mot particulièrement long à la fin de la ligne d'un titre.

3.1.4. Corps de texte

Ce menu est dédié au paramétrage du texte du document hors les titres.

La fonctionnalité Afficher l'adresse des liens permet d'afficher l'adresse url d'un lien intégré au texte via Liens et référencesLiensLien externe.

3.1.5. Table des matières

Ce menu est dédié au paramétrage de la table des matières :

  • propre à tout le document ;
  • propre à chaque élément de structure faisant partie d'un document ;
  • pour les figures et tableaux (pour les documents en structure « livre »).

Cliquez sur en face de l'élément pour lequel vous souhaitez afficher la prévisualisation de la table des matières.

Cliquez sur en face des éléments pour lesquels vous souhaitez activer / désactiver la table des matières dans votre publication.

Le paramètre « Nombre de niveaux » définit la granularité de la table des matières.

Le paramètre « Niveaux de section » définit la granularité de la table des matières propre aux sections du document.

[Note]

Le résultat de ce paramétrage est visible directement dans la publication.

Utilisez le menu Choix des éléments de structure (à droite de la zone de prévisualisation) pour masquer les éléments absents de la structure de votre document dans la prévisualisation.

Le menu Style des entrées permet de mettre en forme chaque type d'éléments défini pour la table des matières.

3.1.6. En-tête et pied de page

Ce menu est dédié au paramétrage des en-têtes et des pieds de page pour toutes les pages du document, y compris la page de garde.

Modes d'édition

Il existe trois modes d'édition :

  • édition de l'en-tête et du pied de page sans prévisualisation ;
  • édition de l'en-tête de page avec la prévisualisation ;
  • édition du pied de page avec la prévisualisation.

Cet onglet permet de prévisualiser les en-têtes et les pieds de page avec le contenu de la page.

Composition de l'en-tête et pied de page

Le paramétrage des zones de l'en-tête et du pied de page comprend :

  • ajout / suppression des lignes et des colonnes ;
  • modification de la hauteur / largeur des lignes et colonnes ;
  • alignement vertical et horizontal de tous les widgets de la ligne.

La composition de l'en-tête ou du pied de page s'effectue par glisser-déposer d'un widget dans la zone souhaitée sur le fond vert qui apparaît au moment où le widget survole le bord supérieur de la zone :

Une zone peut accueillir plusieurs widgets.

L'édition d'un widget placé dans la zone suit le mode opératoire décrit dans Widgets.

3.1.6.1. Widgets

Le panneau de paramétrage contient des widgets utilisables dans l'en-tête et/ou le pied de page.

L'édition de chaque widget peut s'effectuer directement sur le panneau de paramétrage. Dans ce cas, le widget peut être réutilisé comme modèle avec une mise en forme prédéfinie. Ce type d'édition est recommandé pour les widgets Texte et Image pour lesquels le contenu peut être modifié pour chaque réutilisation.

Les widgets standard qui portent le nom des éléments du document XML (Titre, Date, Auteur, etc.), sont réservés à ces éléments uniquement. Le widget Xpath personnalisé permet de récupérer d'autres éléments du document XML pour les lier à la feuille de style.

Le paramétrage du widget Xpath personnalisé suit le mode opératoire décrit dans Paramétrage du widget Xpath personnalisé.

  1. Cliquez sur à droite du nom de widget.

    Une fenêtre s'ouvre avec les paramètres.

  2. Cliquez sur une des parties colorées du schéma des marges et bordures pour faire apparaître ses caractéristiques :

    Le résultat du paramétrage est affiché dans la zone de prévisualisation en bas de la fenêtre.

Paramétrage du widget Xpath personnalisé

Le widget Xpath personnalisé permet de récupérer des éléments du document XML qui ne sont pas disponibles dans les widgets standard.

Le widget Xpath personnalisé est utilisé dans les en-tête et pied de page et les pages de garde.

Xpath est un langage permettant d'identifier les éléments d'une structure XML. Le paramétrage du widget consiste à composer un chemin d'accès pour l'élément du document XML. Ce chemin est constitué des nœuds (éléments, attributs, instructions de traitement, etc.) liés entre eux par des expressions de chemin.

Figure 2. Exemple du chemin d'accès

Exemple du chemin d'accès

[Note]

L'utilisation des types d'expressions de chemin est décrite dans Tableau 1, « Expressions de chemin les plus courantes ».

Le bloc Information contient des informations qui ne sont pas publiées par défaut. Le widget Xpath personnalisé permet de les publier.

Les éléments qui peuvent être récupérés dans la feuille de style via xpath, doivent également être placés dans le bloc Information du document XML :

Figure 3. Exemple du bloc Information et ses contenus

Exemple du bloc Information et ses contenus

Procédure 29. Pour composer le xpath :

  1. Dans le bloc Information, sélectionnez l'élément souhaité.

  2. Dans le Contexte, repérez le nom de cet élément.

    Figure 4. Exemple du nom d'élément dans le Contexte

    Exemple du nom d'élément dans le Contexte

    [Note]

    Ces noms font partie de la convention du nommage selon le standard DocBook et s'affichent dans l'infobulle en survolant chaque élément.

  3. Dans le studio, faites glisser le widget dans la zone de prévisualisation. Cliquez sur à droite du nom de widget.

  4. Dans le champ XPath du studio, placez les nœuds représentés par les noms des éléments. Précédez chaque nom par d: et séparez par /. Puisque les éléments sont placés dans le bloc Information, le chemin d'accès commencera par d:info/.

    [Important]

    Pour les éléments xpath dans l'en-tête ou le pied de page, le chemin d'accès doit commencer par /*/.

    Cela permet à la feuille de style de récupérer l'élément pour toutes les séquences de pages générées par les éléments de structure (chapitres, sections, préface, etc.) présents dans le document.

    Figure 5. Exemple du chemin de localisation dans l'en-tête ou le pied de page

    Exemple du chemin de localisation dans l'en-tête ou le pied de page

Paramétrage du xpath pour sélectionner des éléments particuliers du même type

Il est possible de récupérer plusieurs éléments du même type (plusieurs images, plusieurs tableaux, etc.) dans la feuille de style via xpath.

Voici l'exemple de la procédure de récupération des images.

  1. Placez toutes les images nécessaires dans le bloc Information > Couverture.

  2. Donnez à chaque image une valeur différente dans l'attribut role en sélectionnant l'élément imageobject.

    Figure 6. Attribut role pour imageobject

    Attribut role pour imageobject

  3. Composez le xpath pour chaque image comme suit dans l'exemple : d:info//d:imageobject[@role='image_produit'].

Tableau 1. Expressions de chemin les plus courantes

Syntaxe

Utilisation

Exemple

d:

indique que l'élément appartient à l'espace de nom DocBook.

d:info/d:date

/

utilisé pour sélectionner les enfants d'un élément. Il indique que l'on souhaite sélectionner un élément qui est directement sous l'élément parent.

d:info/d:date

Pour l'exemple donné, l'élément date est enfant de l'élément info.

//

utilisé pour effectuer une recherche des éléments en profondeur.

d:info//d:date

Pour l'exemple donné, on va chercher tous les éléments date qui se trouvent dans le bloc info peu importe leurs parents.

*

sélectionne tous les éléments.

d:info/d:legalnotice/d:*

[]

utilisés pour filtrer les éléments sélectionnés en fonction de leurs attributs ou de leurs valeurs. Ou pour représenter un index dans une liste.

d:info/d:legalnotice[2]

Pour l'exemple donné, le xpath sélectionne le deuxième élément legalnotice, enfant de l'élément info.

@

sélectionne des attributs.

d:info/d:date[@role='anniversaire']

Pour l'exemple donné, on sélectionne les éléments imageobject qui ont l'attribut role avec la valeur « anniversaire ».


3.2. Pages de garde

Trois modes d'édition sont disponibles pour une page de garde :

  • Par défaut : le recto et le verso sont publiés avec les modèles de feuilles de style standard.
  • Personnaliser recto : la mise en page de la page de garde pour un document à imprimer en recto.
  • Personnaliser recto - verso : la mise en page individuelle du recto et verso de la page de garde.

Il est possible de faire apparaître sur la page de garde l'en-tête et le pied de page paramétrés dans le menu En-tête et pied de page.

Cliquez sur pour afficher les options de paramétrage de l'image et couleur d'arrière plan.

Le panneau de paramétrage contient une liste de widgets paramétrables. L'édition de chaque widget suit le mode opératoire décrit dans Widgets.

La composition du contenu de la page de garde s'effectue par glisser-déposer d'un widget. Le paramétrage des widgets placés sur la page de garde comprend :

  • modification de sa hauteur et largeur ;
  • alignement entre les widgets avec les coordonnées XY.

3.3. Corps de la page

Ce menu est dédié au paramétrage des éléments qu'on peut trouver à côté du texte en paragraphes.

3.3.1. Listes et étapes de procédure

Ces menus permettent de gérer le paramétrage des listes et des étapes de procédure jusqu'à quatre niveaux.

Listes à puces

Le menu déroulant Symbole propose le choix entre les puces prédéfinies, aucune puce ou une puce personnalisée.

Pour intégrer une puce personnalisée :

  1. Sélectionnez « Personnalisé » dans le menu déroulant.

  2. Collez le symbole de puce souhaité dans le carré blanc à droite du menu.

    [Important]

    Assurez-vous que le symbole personnalisé est supporté par la police paramétrée.

3.3.2. Tableaux

Ce menu permet de paramétrer :

  • la couleur du texte ainsi que du fond d'un tableau ;
  • le style des bordures extérieures et des bordures des cellules ;
  • les marges à l'intérieur des cellules.

3.3.3. Admonitions

Ce menu permet de personnaliser les icônes des admonitions.

L'aperçu des icônes par défaut dépend du contenu présent dans votre espace de travail qui correspond à ces éléments.

Pour les espaces qui contiennent la feuille de style standard, l'aperçu par défaut est comme suit :

Pour les espaces qui contiennent la feuille de style personnalisée au niveau des admonitions, entre autres, l'aperçu va afficher les icônes personnalisées.

Il est possible de modifier les icônes :

  1. Cliquez sur l'admonition dans le panneau de paramètres.

  2. Dans la fenêtre qui s'ouvre, sélectionnez une image parmi les images présentes dans votre espace de travail.

    Ou importer une image via le bouton Importer en haut à droite de la fenêtre.

  3. Décochez la case à droite de chaque admonition pour revenir à l'icône par défaut.

Pour modifier une feuille de style créée, cliquez sur son label dans la liste de feuilles de style. Elle s'ouvre dans le studio pour l'édition.

3.3.4. Hyperliens

Ce menu permet de gérer le paramétrage des liens et références :

  • référence croisée ;
  • lien externe ;
  • lien interne ;
  • lien vers le terme de glossaire ;
  • référence bibliographique.