Utiliser Typst pour un format d'impression
Utiliser Typst pour un format d'impression
Typst est un moteur PDF proposé dans le constructeur, sous le nom « Typst (fast) ». Il est marqué Expérimental et se choisit par format. Le moteur par défaut d'un format est PlutoPrint.
Typst utilise la disposition du constructeur. Il ne convertit pas un format HTML personnalisé en un format compatible.
Vérifier la compatibilité
Le constructeur signale les éléments incompatibles avec Typst. Les mêmes contrôles s'appliquent à l'enregistrement du format et à la génération du PDF.
| Élément bloquant | Action possible |
|---|---|
| Format HTML personnalisé ou bloc HTML | Conserver Chromium ou PlutoPrint, ou refaire le contenu avec des blocs compatibles. |
| Modèle Jinja de champ | Utiliser un champ standard, ou faire adapter le contenu par un développeur. |
| CSS global personnalisé | Retirer ces règles et utiliser les contrôles du constructeur, ou conserver Chromium ou PlutoPrint. |
| Style d'élément non pris en charge | Corriger les propriétés signalées. |
| Couleur non reconnue | Choisir une couleur hexadécimale dans le sélecteur. |
| Code-barres linéaire | Conserver Chromium ou PlutoPrint si le code linéaire est nécessaire. Typst prend en charge les QR codes. |
| En-tête ou pied de page HTML | Utiliser une version compatible, notamment une image enregistrée sur le site. |
| Image provenant d'une adresse web externe | Importer l'image sur le site. |
Un blocage ne signifie pas que Dokos ignorera simplement l'élément. Il peut empêcher l'enregistrement ou la génération du PDF. Le message désigne les éléments à corriger.
Activer Typst
- Ouvrez le format dans le constructeur.
- Cliquez sur le canevas en dehors de tout élément pour afficher les réglages du format.
- Dans le groupe Résultat, choisissez « Typst (fast) » dans « Moteur de rendu PDF ». L'option est grisée si le format contient un élément bloquant. L'icône d'information à côté du sélecteur liste ces éléments.
- Corrigez les éléments incompatibles signalés.
- Sélectionnez un document existant et ouvrez l'aperçu PDF.
- Contrôlez le contenu et la mise en page.
- Cliquez sur Enregistrer et appliquer pour utiliser ce moteur avec le format.
Contrôler le résultat
Testez plusieurs documents représentatifs : un document court, un document de plusieurs pages et un document contenant des images. Comparez les informations imprimées, les polices, les totaux et les sauts de page.
La durée de génération dépend du document, des images, des polices et du serveur. Mesurez vos propres formats si le temps de génération motive le changement de moteur.
Un en-tête de lettre reste un document partagé. Sa compatibilité est vérifiée au moment du rendu. Modifier cet en-tête peut donc rendre un format existant incompatible avec Typst.
Utiliser un bloc Typst
Un bloc Typst contient du code de mise en page. Sa création demande une connaissance de Typst et, pour les données dynamiques, de Jinja.
Confiez ce bloc à un développeur si les éléments standard ne suffisent pas. Les données dynamiques doivent utiliser les noms techniques du document. Le constructeur vérifie la compilation des blocs lors de l'enregistrement.
Un format contenant un bloc Typst doit utiliser ce moteur. Pour revenir à Chromium ou PlutoPrint, retirez ou remplacez d'abord les blocs Typst.
Résoudre un problème
| Problème | Vérification |
|---|---|
| Typst ne peut pas être sélectionné | Consultez la liste des éléments bloquants dans l'icône d'information du sélecteur. |
| Le PDF ne se génère plus | Lisez le message, puis vérifiez le format et l'en-tête réellement utilisés. |
| Une police diffère | Vérifiez sa disponibilité avec votre administrateur et contrôlez le PDF après chargement. |
| Une donnée liée est vide | Contrôlez la donnée source, les autorisations et la condition d'affichage. |
| Un QR code est vide | Vérifiez que la source choisie contient une valeur. |
| Un bloc Typst provoque une erreur | Faites corriger sa syntaxe et ses données dynamiques par son auteur. |