Impression et PDF

Cette page décrit les réglages communs à toutes les impressions : l'impression depuis un mobile, les pages de couverture, le CSS de l'en-tête et le générateur PDF. Pour régler une impression précise, consultez Personnaliser l'impression d'un document.

Imprimer depuis un appareil mobile

Sur un écran de moins de 992 pixels de large (tablette, téléphone), l'action Imprimer est aussi dans le menu ... du formulaire. Sur un grand écran, utilisez l'icône d'imprimante du formulaire.

1. Ouvrez le document à imprimer.
2. Appuyez sur le menu ... en haut à droite du formulaire.
3. Choisissez Imprimer.
4. Choisissez le format d'impression, puis téléchargez le PDF.

L'action Imprimer apparaît seulement dans ces conditions :

• votre rôle a l'autorisation Imprimer sur ce type de document ;
• le type de document n'est pas un document unique (« Single »), comme une page de paramètres ;
• pour un document soumettable, le document est validé. Un brouillon s'imprime si « Autoriser les impressions des documents en brouillon » est coché dans les « Paramètres d'impression ». Un document annulé s'imprime si « Autoriser les impressions des documents annulés » est coché.

Ajouter des pages de couverture à un PDF

Un format d'impression peut ajouter un PDF avant le document (page de couverture) et un PDF après le document (page de couverture arrière). Dokos les ajoute à chaque PDF généré avec ce format : téléchargement, pièce jointe d'un e-mail ou envoi automatique.

Le PDF d'une page de couverture peut contenir plusieurs pages. Une page de couverture arrière peut donc contenir des annexes, comme vos conditions générales de vente.

Exemple fictif : un cabinet de conseil crée la page de couverture « Présentation cabinet » (1 page) et la page arrière « CGV » (3 pages). Il les règle sur son format de devis. Un devis de 2 pages donne un PDF de 6 pages.

En-têtes de lettre

À l'installation, Dokos crée les en-têtes « Company Letterhead », « Company Letterhead - Grey » et « Standard ». Ils affichent le logo et les coordonnées de la société. Vous pouvez les modifier ou créer vos propres en-têtes depuis la liste En-Tête.

Styler les impressions avec le CSS de l'en-tête

L'en-tête a un champ CSS personnalisé. Dokos ajoute ces règles CSS à chaque impression qui utilise cet en-tête. Vous pouvez ainsi avoir une charte graphique par en-tête, par exemple une par société.

1. Ouvrez la liste En-Tête.
2. Ouvrez l'en-tête à styler, ou créez-en un.
3. Saisissez vos règles dans le champ CSS personnalisé.
4. Enregistrez, puis ouvrez l'aperçu d'un document pour vérifier le rendu.

/* Exemple : en-tête de tableau vert et police globale */
.print-format {
  font-family: 'Arial', sans-serif;
}
.print-format th {
  background-color: #2e7d32;
  color: #ffffff;
}

Le format d'impression a aussi un champ « CSS personnalisé ». Utilisez-le pour un style propre à un format.

Choisir le générateur PDF

Le générateur PDF transforme le document en fichier PDF. Il se règle à deux niveaux :

• Pour tout le site : champ « Générateur PDF » des « Paramètres d'impression ». Choix : wkhtmltopdf, chrome ou PlutoPrint. La valeur par défaut est chrome.
• Pour un format d'impression : champ « Générateur PDF » du format. Il remplace le réglage du site. Choix : wkhtmltopdf, chrome, PlutoPrint, Typst ou WeasyPrint. Laissez-le vide pour utiliser le réglage du site.

Un format créé avec l'éditeur de format d'impression garde PlutoPrint, Typst ou WeasyPrint s'il est choisi. Sinon, il utilise chrome.

Quand PlutoPrint imprime avec chrome

Avec PlutoPrint, Dokos imprime le PDF avec chrome dans ces cas :

• le document contient du JavaScript (un script ajouté par le format ou par l'en-tête) ;
• le document contient une grille CSS (display: grid), y compris dans l'en-tête ;
• le document contient un code-barres ;
• vous imprimez une plage de pages ;
• la bibliothèque plutoprint n'est pas installée sur le serveur. Elle est livrée pour Linux x86_64, macOS arm64 et Windows : sur une autre machine, les PDF s'impriment avec chrome.

Ces cas ne bloquent pas l'impression : le PDF est produit, avec chrome. Le serveur doit donc pouvoir lancer Chromium.

À l'enregistrement d'un format d'impression dont le champ « Générateur PDF » est PlutoPrint, Dokos vérifie son HTML, son CSS et sa mise en page :

• pour un nouveau format, il règle le générateur sur chrome et affiche « Générateur PDF défini sur Chromium : » suivi du motif (« JavaScript », « Grille CSS » ou « PlutoPrint n'est pas installé sur ce serveur ») ;
• pour un format existant, il refuse l'enregistrement avec le message « Ce format ne peut pas utiliser le moteur de rendu PlutoPrint : » suivi du motif, sous le titre « Moteur de rendu PlutoPrint indisponible ». Retirez l'élément signalé, ou choisissez chrome.

Exemple fictif : vous réglez le « Générateur PDF » des « Paramètres d'impression » sur PlutoPrint. Votre format « Devis client » est un modèle HTML simple : son PDF est produit sans navigateur. Votre format « Étiquette produit » contient un code-barres : son PDF est produit avec chrome, sans rien changer à ce format.

Si des formats d'impression sont restés sur wkhtmltopdf alors que le site utilise un autre générateur, Dokos les signale après l'enregistrement des Paramètres d'impression et permet de les basculer en une fois. Voir Basculer les formats restés sur wkhtmltopdf.

Contrôler les sauts de page

Ajoutez des règles CSS dans le champ « CSS personnalisé » du format d'impression ou de l'en-tête.

/* Garder une section entière sur la même page */
.section-break {
  page-break-inside: avoid;
}

/* Forcer un saut de page avant un bloc qui a la classe break-before */
.break-before {
  page-break-before: always;
}

/* Éviter une ligne seule en haut ou en bas de page */
p {
  orphans: 3;
  widows: 3;
}

Print Designer

L'application Print Designer propose un éditeur visuel par glisser-déposer pour créer des formats d'impression sans écrire de HTML. Elle est dépréciée : à partir de Dodock v5.50, l'éditeur de format d'impression intégré à Dodock la remplace, sans application supplémentaire (voir Modifier avec l'éditeur visuel). Pour un nouveau format, utilisez cet éditeur intégré. Les formats existants de Print Designer restent utilisables tant que l'application est installée.