Impression et PDF - Généralités
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 créer ou mettre en page un format, consultez Créer et modifier un format d'impression.
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.
- Ouvrez le document à imprimer.
- Appuyez sur le menu ... en haut à droite du formulaire.
- Choisissez Imprimer.
- 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.
- Créez une Page de couverture. Saisissez son « Nom de la page de couverture » et joignez le fichier PDF dans le champ « Page de couverture ».
- Ouvrez le Format d'impression concerné.
- Choisissez la page de début dans le champ « Page de couverture », et la page de fin dans le champ « Page de couverture arrière ».
- Enregistrez le format.
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 standards
Dokos fournit deux en-têtes de lettre standards. Ils affichent le logo, l'adresse et les coordonnées de la société.
| Nom | Utilisé pour (« En-tête de lettre pour ») |
|---|---|
| Company Letterhead | Documents (DocType) |
| Company Letterhead Report | Rapports (Report) |
Dokos choisit un en-tête par défaut pour les documents et un autre pour les rapports :
- Le premier en-tête créé pour les documents, ou pour les rapports, devient l'en-tête par défaut de ce groupe.
- À la mise à jour d'un site, si un groupe n'a pas d'en-tête par défaut, un en-tête standard actif de ce groupe le devient.
Pour changer l'en-tête par défaut, ouvrez l'en-tête voulu, cochez « En-tête par défaut », puis enregistrez.
Contenu de l'en-tête « Company Letterhead »
L'en-tête « Company Letterhead » n'affiche ni le type ni le numéro du document : le format d'impression les montre déjà. Il se présente en trois zones.
- À gauche : le logo de la société, puis le nom de la société et son adresse (rue, puis « Ville - Code postal, Région, Pays »).
- À droite : l'identifiant fiscal, le téléphone, puis l'e-mail et le site web sur une même ligne, séparés par « · ».
Règles d'affichage :
- Société : celle du document. Si le document n'a pas de société, Dokos utilise la société par défaut.
- Adresse : l'adresse de la société du document, sinon l'adresse de facturation du document, sinon une adresse active liée à la société (l'adresse principale d'abord).
- Pays : il s'affiche seulement s'il diffère du pays de la société.
- Identifiant fiscal : le « Numéro de TVA » de la société, s'il est renseigné.
- Téléphone et e-mail : ceux de l'adresse, sinon ceux de la société.
- Site web : affiché sans
http://,https://ni/final. - Lignes vides : une information non renseignée est omise, sans ligne vide.
Exemple fictif : la société Atelier des Lilas SARL a une adresse « 12 rue des Lilas, 69003 Lyon » (même pays que la société), le numéro de TVA « FR12345678901 », le téléphone « 04 78 00 00 00 », l'e-mail « contact@atelier-lilas.example » et le site « https://www.atelier-lilas.example/ ». L'en-tête imprime à gauche le logo, « Atelier des Lilas SARL », « 12 rue des Lilas » puis « Lyon - 69003 ». À droite, il imprime l'identifiant fiscal « FR12345678901 », « 04 78 00 00 00 », puis « contact@atelier-lilas.example · www.atelier-lilas.example ». Le pays n'est pas imprimé.
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é.
- Ouvrez la liste En-Tête.
- Ouvrez l'en-tête à styler, ou créez-en un.
- Saisissez vos règles dans le champ CSS personnalisé.
- 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.
À l'installation d'un nouveau site, Dokos choisit aussi un format d'impression par défaut pour 8 types de documents. Consultez Formats d'impression par défaut pour les nouveaux sites.
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 :
chromeouPlutoPrint. La valeur par défaut estPlutoPrint. - Pour un format d'impression : champ Générateur PDF du format. Il remplace le réglage du site. Choix :
chrome,PlutoPrintouTypst. Un nouveau format est créé avecPlutoPrint. Le format standard d'un type de document n'impose pas de générateur : il suit le réglage du site (PlutoPrint si le réglage est vide).
| Générateur | Usage |
|---|---|
PlutoPrint | Moteur HTML léger, par défaut. Il s'exécute dans le processus de Dokos, sans lancer de navigateur. Voir Quand PlutoPrint laisse la main à Chromium. |
chrome | Rendu d'un navigateur récent : CSS Grid, Flexbox, variables CSS, JavaScript. Dokos télécharge Chromium au premier usage s'il ne le trouve pas. |
Typst | Pour les formats créés avec l'éditeur de format d'impression. Consultez Utiliser Typst pour un format d'impression. |
Le générateur wkhtmltopdf n'existe plus dans cette version. Un format qui l'utilisait passe à chrome à son prochain enregistrement.
Quand PlutoPrint laisse la main à Chromium
PlutoPrint ne sait pas rendre tous les contenus. Dans ces cas, Dokos imprime le PDF avec chrome, sans erreur :
- le format ou la page contient du JavaScript (balise
scriptou attribut d'événement) ; - le format ou le CSS de l'en-tête de lettre utilise une grille CSS (
display: grid) ; - un format HTML personnalisé contient un code-barres dessiné dans le navigateur (balise portant l'attribut
data-barcode-value). Les codes-barres du constructeur de format d'impression ne sont pas concernés : Dokos les dessine sur le serveur et PlutoPrint les imprime ; - l'impression demande une plage de pages précise ;
- PlutoPrint n'est pas installé sur le serveur. Il est fourni pour Linux x86_64, macOS arm64 et Windows ; sur une autre machine, tous les PDF sont imprimés avec Chromium.
À l'enregistrement d'un format, les contrôles sont plus stricts :
- Pour un nouveau format réglé sur
PlutoPrint, si le format contient du JavaScript ou une grille CSS, Dokos le règle surchromeet affiche « Générateur PDF défini sur Chromium : » suivi du motif (par exemple « Grille CSS »). - Pour un format existant réglé sur
PlutoPrint, l'enregistrement est refusé avec le message « Ce format ne peut pas utiliser le moteur de rendu PlutoPrint : » suivi du motif (titre « Moteur de rendu PlutoPrint indisponible »). Les motifs possibles sont « JavaScript », « Grille CSS » et « PlutoPrint n'est pas installé sur ce serveur ». Choisissezchromeou retirez l'élément signalé.
Exemple fictif : l'atelier Maison Verte SARL crée un format de bon de livraison avec du HTML contenant une grille CSS, et laisse le générateur sur PlutoPrint. À l'enregistrement, Dokos règle le format sur chrome et indique « Grille CSS ». Le PDF est généré avec Chromium.
Différences de rendu avec Chromium
PlutoPrint est un moteur léger : certains effets CSS peuvent y être rendus autrement qu'avec Chromium, et le nombre de pages peut différer. Contrôlez le PDF d'un format important avec les deux moteurs avant de le mettre en service.
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;
}
Créer un format avec l'éditeur visuel
L'éditeur de format d'impression permet d'organiser les sections, les colonnes et les tableaux d'un format sans écrire de code. Consultez Créer et modifier un format d'impression et Mettre en page un format d'impression.
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.