Créer et modifier un format d'impression

Le constructeur de format d'impression organise les informations d'une facture, d'un devis ou d'un autre document imprimable. Vous travaillez sur un brouillon du format, puis vous appliquez les modifications pour les utiliser lors des impressions.

Les formats HTML personnalisés et les formats de rapports suivent un autre mode d'édition : voir Formats d'impression.

Ouvrir le constructeur

Vous devez pouvoir modifier le format d'impression et consulter un document du type concerné pour vérifier son aperçu.

1. Recherchez les Formats d'impression dans Dokos.
2. Pour modifier un modèle existant, ouvrez-le. Dupliquez-le s'il est livré avec l'application.
3. Pour créer un modèle, cliquez sur Créer dans la liste.
4. Dans Format d'impression pour, gardez DocType, sélectionnez le type de document et saisissez le Nom du modèle.
5. Dans Commencer avec, gardez « Éditeur de format d'impression », puis cliquez sur Créer.

Le nouveau format s'ouvre dans le constructeur. Le choix HTML et les formats de rapports ouvrent le formulaire du format.

Le format reste associé au type de document choisi. Un format de facture ne devient pas un format de devis en changeant son titre.

Organiser le document

Le canevas représente la disposition du format. Ajoutez les informations du document depuis la liste des champs, puis déplacez-les dans les sections.

Le panneau d'inspection présente les réglages de l'élément sélectionné. Les réglages sont regroupés en sections repliables. Les libellés et les contrôles se présentent sur deux colonnes : le libellé à gauche, le contrôle à droite.

Pour le format complet (aucun élément sélectionné), les réglages sont organisés en cinq groupes :

Le moteur PDF par défaut est PlutoPrint (« PlutoPrint (léger) »). Chromium et « Typst (fast) » sont aussi proposés. PlutoPrint et Typst sont marqués Expérimental.

Pour un champ sélectionné, les réglages sont répartis entre les groupes Champ, Style, Disposition, CSS personnalisé et Visibilité. Le libellé et son commutateur d'affichage occupent une ligne : la zone de saisie du titre apparaît en dessous uniquement lorsque le commutateur est activé.

Pour une section sélectionnée, les réglages sont répartis entre les groupes Étiquette, Disposition, Style, Bordures, Impression, CSS personnalisé et Visibilité. Le groupe Style regroupe la couleur de fond, l'arrondi, l'espacement intérieur et les marges.

Le panneau des calques permet de retrouver et de réorganiser les éléments dans l'arborescence du format. Sélectionnez un élément pour afficher ses propriétés dans l'inspecteur.

Exemple fictif — Maison Verte SARL L'équipe souhaite placer les coordonnées du client au-dessus des articles de la facture. Elle déplace ces informations, puis vérifie une facture courte et une facture de plusieurs pages.

Pour les tableaux, images, codes-barres, conditions d'affichage et sauts de page, consultez Mettre en page un format d'impression.

Variables globales des blocs HTML

Un format peut contenir des variables globales Jinja, partagées par tous ses blocs HTML. Dokos les calcule une fois par document imprimé, avant les blocs HTML.

Le panneau des réglages du format ne propose plus de zone pour les modifier. Les variables déjà présentes dans un format restent calculées à l'impression. Une erreur dans ces variables affiche l'erreur Erreur de format d'impression à l'impression.

Vérifier l'aperçu PDF

L'aperçu utilise un document existant et les modifications du format en cours. Il permet de contrôler le résultat avant de l'appliquer.

1. Sélectionnez un document dans la barre d'outils du constructeur.
2. Ouvrez Aperçu.
3. Vérifiez les pages, les colonnes, les images et les totaux dans le PDF.
4. Fermez l'aperçu pour poursuivre les modifications.
5. Recommencez avec un document contenant davantage de lignes ou des valeurs différentes.

Le document choisi doit être imprimable avec vos autorisations et les paramètres du site. Un document brouillon ou annulé peut être refusé.

Le canevas aide à placer les éléments. Utilisez le PDF pour contrôler les sauts de page et le rendu final.

Imprimer avec un style et des réglages de page

La page d'impression affiche un aperçu paginé.

Choisir un style d'impression

Avec le format Standard, la section Style de la barre latérale présente les styles d'impression actifs sous forme de cartes. Les cartes Modern, Classic, Striped et Monochrome viennent en premier, dans cet ordre. TwentyTwenty et vos styles personnalisés suivent, du plus ancien au plus récent. Le style des paramètres d'impression est sélectionné par défaut (TwentyTwenty sur un nouveau site). Cliquez sur une carte pour appliquer le style à l'aperçu, au PDF et à l'email. La même section propose une Police de caractère.

Le code de la page d'impression cite aussi un style « Redesign » parmi les styles standard. Aucun style de ce nom n'est livré avec Dokos : il n'apparaît pas dans les cartes.

Régler la page

Pour un format créé avec le constructeur, la taille du papier (A4, A5, A3, Letter, Legal, Tabloid) et l'orientation se règlent dans le groupe Page des réglages du format.

La section Page de la page d'impression permet aussi de changer la taille du papier et l'orientation pour une impression. Le champ « Paper Size » (libellé non traduit) propose « Par défaut », A4, A5, A3, Letter, Legal et Tabloid. Le champ Orientation propose « Par défaut », Portrait et Paysage. Ces réglages s'appliquent à l'aperçu, au PDF, à l'impression réseau et à l'email.

La section Page est masquée pour l'impression brute. Elle est aussi masquée pour les formats personnalisés (HTML/Jinja ou JS). Pour ces formats, utilisez le champ « Format du papier » du formulaire (voir plus bas).

La barre d'aperçu indique le nombre de pages et propose des contrôles de zoom et d'ajustement. Les raccourcis clavier sont : Ctrl+P pour imprimer, Ctrl+Shift+P pour télécharger le PDF et Ctrl+Shift+E pour ouvrir l'email.

Menu de la page d'impression

Le menu de la page d'impression propose :

Exemple fictif : Julie, gestionnaire système, veut que ses factures s'impriment toujours avec le format « Facture Atelier Bois ». Elle choisit ce format dans la barre latérale, puis clique sur Menu > Set as Default Format.

Envoyer par email

Le bouton Email ouvre l'éditeur d'email avec le format, l'en-tête, le style et les réglages de page choisis. Si vous choisissez Sans en-tête dans le champ En-tête de lettre, le PDF joint n'a pas d'en-tête.

Définir la taille du papier d'un format HTML

Un format HTML ou Jinja a un champ « Format du papier » dans son formulaire. Ce champ n'est pas proposé pour les formats du constructeur ni pour l'impression brute.

1. Ouvrez le format d'impression dans son formulaire.
2. Renseignez « Format du papier » : A4, A5, A3, Letter, Legal, « Ticket 80 mm », « Ticket 58 mm » ou « Custom ».
3. Avec « Custom », renseignez « Largeur du papier (en mm) » et « Hauteur du papier (en mm) ». Les deux valeurs doivent être supérieures à 0, sinon l'enregistrement est refusé (« Format de papier non valide »).
4. Enregistrez le format.

Vide, le champ garde la taille des Paramètres d'impression. Une valeur renseignée remplace cette taille pour les impressions avec ce format, avec les moteurs chrome et PlutoPrint.

Exemple fictif : une étiquette de lot de 101,6 × 38,1 mm. Réglez « Format du papier » sur « Custom », la largeur sur 101.6 et la hauteur sur 38.1. Le PDF contient une page de 101,6 × 38,1 mm.

Les très petites pages demandent de petites marges. La description du champ conseille par exemple @page { margin: 2mm; } dans le CSS personnalisé du format.

Les tailles « Ticket 80 mm » et « Ticket 58 mm » impriment une seule page, aussi haute que le contenu. Elles permettent d'imprimer des reçus sur une imprimante thermique sans changer les paramètres du site, par exemple des factures en A4 et des reçus sur le même site.

Enregistrer le brouillon et appliquer les modifications

L'enregistrement automatique conserve le brouillon du format. Le brouillon ne remplace pas à lui seul le format utilisé pour les impressions.

Cliquez sur Enregistrer et appliquer après avoir vérifié l'aperçu. Cette action applique la mise en page et crée une entrée dans l'historique des versions.

      
flowchart LR
    A[Modifier le brouillon] --> B[Vérifier le PDF]
    B --> C[Enregistrer et appliquer]
    C --> D[Utiliser le format pour imprimer]
    B --> A

    

Si l'enregistrement échoue, conservez la page ouverte et lisez le message affiché. Une erreur d'enregistrement signifie que les dernières modifications ne sont pas conservées.

L'en-tête de lettre est un document partagé, enregistré séparément du brouillon du format. Sa modification peut concerner d'autres formats qui l'utilisent. Dupliquez l'en-tête pour préparer une variante indépendante.

Retrouver une version précédente

L'historique contient les versions appliquées et les versions nommées que vous avez enregistrées. Une version nommée permet de conserver une étape avant de poursuivre une modification.

1. Ouvrez l'historique du constructeur.
2. Sélectionnez une version pour la consulter sans modifier le format publié.
3. Restaurez la version retenue dans le brouillon.
4. Vérifiez le résultat avec un document réel.
5. Cliquez sur Enregistrer et appliquer pour utiliser cette version lors des impressions.

Restaurer une version ne supprime pas les versions plus récentes. Abandonner le brouillon revient au format publié.

Les actions Annuler et Rétablir concernent les modifications de la session d'édition. Elles ne remplacent pas l'historique des versions conservées.

Distinguer les réglages du format et ceux du site

Les réglages du format concernent sa mise en page. La fenêtre Paramètres d'impression, même ouverte depuis le constructeur, modifie les paramètres généraux du site.

Utilisez les réglages du format pour changer ses marges, sa police ou ses couleurs. Pour un format HTML, le champ « Format du papier » remplace la taille de page des paramètres généraux lors de l'impression avec ce format. Vérifiez la portée des paramètres généraux avant de les modifier, notamment pour l'impression des brouillons et la répétition des en-têtes.

Reprendre un ancien format

Les formats de l'ancien constructeur sont convertis vers la nouvelle disposition lors de la mise à jour du site. La conversion conserve les données d'origine dans le format. Les champs qui n'existent plus dans le type de document sont retirés et signalés dans le Journal des erreurs.

Après conversion, vérifiez les tableaux, les blocs HTML, les conditions et les sauts de page. La conservation des données d'origine ne garantit pas un rendu identique. Contactez votre administrateur si un élément manque.

Résoudre un problème d'impression

Voir aussi

• Mettre en page un format d'impression
• Imprimer et produire un PDF
• Référence technique du constructeur