Version de développement
Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.
Utilisation

Mettre en page un format d'impression

Organisez les sections, tableaux, images et conditions d'un format d'impression Dokos, puis contrôlez le résultat sur plusieurs documents.

Mettre en page un format d'impression

Un format d'impression associe les données du document à une mise en page. Commencez par les informations nécessaires au destinataire, puis ajustez leur présentation.

Ce guide complète Créer et modifier un format d'impression pour la version next.

Organiser les sections et les colonnes

Les sections regroupent les informations qui doivent rester proches, comme les coordonnées du client ou les totaux. Déplacez les éléments dans le canevas et ajustez les colonnes avec leurs poignées.

Les marges règlent l'espace autour d'un élément. L'espacement intérieur sépare son contenu de sa bordure. Le panneau d'inspection permet aussi d'ajuster l'alignement, la couleur de fond et l'arrondi des sections.

Exemple — Bureau Moderne L'équipe place les coordonnées du fournisseur dans une section et les articles dans une autre. Elle élargit la colonne des descriptions pour limiter les retours à la ligne.

Le titre, l'étiquette et la valeur sont distincts. Masquer une étiquette ou un titre ne supprime pas les données imprimées.

Ajouter un texte ou une donnée liée

Un bloc de texte statique contient une mention commune à tous les documents qui utilisent le format. Par exemple, ajoutez « Merci de rappeler le numéro du document dans vos échanges ».

Un champ lié reprend une donnée d’un document associé. Sélectionnez le champ de lien, puis le champ à afficher dans le document lié. Vérifiez le rendu lorsque cette donnée est vide.

Les libellés et leurs deux-points se règlent séparément des valeurs. Masquer un libellé ne masque pas la donnée.

Réutiliser un élément comme extrait

Enregistrez un champ ou une section comme extrait depuis les actions de l’élément. Donnez-lui un nom explicite, puis insérez-le depuis la liste des extraits d’un autre format compatible.

Les extraits peuvent être limités à un type de document. Insérer un extrait copie sa disposition dans le format : les copies déjà insérées ne sont pas mises à jour automatiquement.

Présenter les tableaux et les répétiteurs

Un tableau présente plusieurs lignes du document sous les mêmes colonnes. Un répétiteur reprend une disposition pour chaque ligne de sa source.

  1. Ajoutez la liste à imprimer, par exemple les articles du document.
  2. Conservez les colonnes utiles au destinataire.
  3. Ajustez leurs libellés et leurs largeurs.
  4. Réglez les bordures, les couleurs et l'espacement intérieur dans l'inspecteur.
  5. Vérifiez le résultat avec une ligne courte, une description longue et plusieurs pages de lignes.

Les options disponibles dépendent de l'élément sélectionné. Les réglages des tableaux et des répétiteurs comprennent aussi le titre, les en-têtes et certaines dispositions de colonnes fusionnées.

Une condition de ligne peut exclure des lignes du rendu. Ce filtre d'impression ne modifie ni les lignes du document ni ses totaux. Vérifiez que le résultat reste compréhensible.

Ajouter une image ou un code-barres

Le bloc Image affiche un fichier choisi dans le format. Ajustez sa largeur, puis contrôlez sa netteté dans le PDF.

Le bloc Code-barres utilise une valeur fixe ou une donnée du document. Le sélecteur du constructeur propose CODE128, CODE39 et QR.

  1. Ajoutez le bloc Code-barres à la disposition.
  2. Choisissez sa source ou saisissez une valeur fixe.
  3. Sélectionnez le format du code-barres.
  4. Ajustez sa taille.
  5. Scannez le code sur un PDF ou une impression de contrôle.

Un QR code contenant le numéro du document encode ce numéro. Il ne crée pas un lien vers le portail. Pour ouvrir une page web, la valeur encodée doit être son URL complète et accessible au destinataire.

Choisir les couleurs et les polices

Les réglages du format définissent la police, la taille du texte et les couleurs des étiquettes et des valeurs. Les réglages d'un élément permettent d'adapter sa présentation.

Choisissez une police dans le sélecteur disponible sur votre site. Vérifiez le rendu PDF, notamment si la police ou une image provient d'une ressource externe.

Privilégiez les contrôles de mise en page pour les besoins courants. Les styles CSS personnalisés demandent une vérification avec le moteur PDF choisi. Ils ne sont pas pris en charge de la même manière par tous les moteurs.

Afficher un élément sous condition

Une condition détermine si un champ ou une section apparaît à l'impression. Une condition vraie affiche l'élément. Une condition fausse le masque.

Sélectionnez l'élément, puis configurez sa condition dans l'inspecteur. Le statut de visibilité aide à vérifier la règle sur le document sélectionné.

Les expressions utilisent les noms techniques des données et la syntaxe Python. Pour éviter une règle incorrecte, faites vérifier l'expression par votre administrateur. La référence technique précise la syntaxe.

Une condition de présentation ne calcule pas une remise, ne change pas une devise et ne modifie pas le statut du document. Ces opérations doivent être réalisées sur le document lui-même.

Contrôler les pages, l'en-tête et le pied de page

Les marges de page réservent l'espace autour du contenu. Utilisez un saut de page pour commencer une nouvelle partie du document.

L'en-tête de lettre et son pied de page portent les informations communes, comme le logo et les coordonnées. Leur répétition dépend des Paramètres d'impression du site et du moteur utilisé.

Vérifiez un PDF de plusieurs pages après toute modification. Contrôlez la place disponible pour les lignes, les titres de tableau, les totaux et la numérotation.

Choisir le moteur PDF

Le constructeur propose Chromium et Typst lorsque le format est compatible. Typst reste expérimental. Le sélecteur indique les éléments qui empêchent son utilisation.

Le moteur choisi doit prendre en charge le contenu du format. Un bloc Typst empêche l'utilisation de Chromium. Pour les restrictions détaillées, consultez le guide du rendu Typst.

Voir aussi