Chapitre 18 · Partie III · En pratique
InDesign : import, export et portage
Les deux façons de faire entrer un livre InDesign dans Postext, l’importateur IDML qui copie ce que contient le document et le skill pour agents qui en dégage les règles de mise en page, quand utiliser chacune, et comment l’exportateur IDML rend un livre à InDesign
En bref
Postext peut faire entrer de deux façons un livre fait dans InDesign. L’importateur copie ce que contient le fichier InDesign, chaque page, chaque bloc et chaque style tels qu’ils sont ; c’est rapide, mais le résultat est une copie des anciennes pages, difficile à modifier et à traduire. Le skill pour agents étudie plutôt le livre : le fichier, le PDF imprimé, les polices et les images. Il trouve les règles que le graphiste a suivies et reconstruit le livre à partir d’elles, avec un texte libre de couler. Cela donne un meilleur livre, et c’est la voie que nous recommandons. Cette page explique les deux façons, quand chacune convient, et comment Postext renvoie un livre fini à InDesign.
Un livre fait dans InDesign peut entrer dans Postext par une copie de ses pages ou par l’analyse de sa maquette. Nous recommandons l’analyse de la maquette.
Postext lit et écrit les paquets InDesign Markup (.idml), le fichier qu’InDesign enregistre avec Fichier › Enregistrer sous › InDesign Markup (IDML). Trois outils s’en servent :
- l’importateur, qui transforme un
.idmlen livre Postext ; - le skill pour agents
postext-port, qui porte un livre à partir de toutes ses sources, dont le.idml; - l’exportateur, qui écrit un livre Postext en
.idmlpour qu’un graphiste le finisse dans InDesign.
L’importateur et le skill font tous deux entrer un livre, et ils ne donnent pas le même livre. Cette page explique la différence pour que vous puissiez choisir.
#Deux voies vers Postext
Un document InDesign est un ensemble de pages que quelqu’un a faites à la main. Le graphiste a suivi des règles, comme un corps de texte, une grille, la manière dont s’ouvre un chapitre, la place d’un encadré et la position d’une légende sous sa figure. Le .idml garde le résultat de ces règles, bloc par bloc, et n’enregistre pas les règles elles-mêmes.
L’importateur copie le résultat. Il lit le paquet et écrit ce qu’il trouve : chaque bloc là où il était, chaque style avec ses valeurs, chaque image et chaque tableau comme ressource. Rien n’est deviné, et le même fichier donne toujours le même livre. Comme le HTML d’une page web, la copie montre les pages sans le raisonnement qui les a produites. Un bloc placé à l’œil reste à ses coordonnées, un titre poussé vers le bas par un paragraphe vide garde le paragraphe vide, et un remplacement local reste un remplacement. Le livre ressemble à l’original, retouches à la main comprises.
Le skill dégage les règles. Un agent lit toute la source : le .idml, le PDF d’impression, les polices et les illustrations. Il mesure les pages et note les règles qu’elles suivent, comme le format et les marges, la grille de ligne de base, les rôles typographiques, les ouvertures, les titres courants, les familles d’encadrés et la place des flottants. Il écrit ensuite le texte en Markdown qui peut se recomposer, sans aucune position de page, et règle la maquette dans la configuration à partir de ces règles. Postext compose les pages à partir des règles : le livre peut être modifié, traduit et composé à un autre format, et il ressemble toujours à l’original.
| Importateur | Skill pour agents | |
|---|---|---|
| Lit | Le .idml et ses images liées | Le .idml, le PDF d’impression, les polices et les illustrations liées (.ai, .psd, .eps, .tif) |
| Méthode | Déterministe : copie ce que contient le document | Inférence : mesure les pages et en dégage les règles |
| Texte | Lié aux blocs du document (--layout pages) ou en texte continu sous ses styles (--layout flow) | Markdown recomposable avec directives, sans position de page |
| Maquette | Les valeurs des styles et des blocs du document | Une configuration de règles : grille, rôles typographiques, ouvertures, titres courants, encadrés, flottants, modèles de page pour les pages composées |
| Durée | Quelques secondes | Des heures pour un livre, avec un agent et des vérifications par rapport au PDF |
| Résultat | Une réplique, avec un rapport de ce qui a été perdu | Un livre Postext qui se comporte comme l’original |
Utilisez le skill par défaut. C’est la bonne voie pour tout livre que vous garderez : un livre que vous réviserez, traduirez, composerez à un autre format ou publierez en EPUB en plus de l’impression.
Utilisez l’importateur quand une copie est le but :
- Un livre exporté par Postext. Un
.idmlécrit par Postext revient avec les mêmes lignes et les mêmes pages, si bien que les modifications d’un graphiste dans InDesign reviennent au livre. - Un coup d’œil rapide. Le rapport d’importation liste en quelques secondes les pages, les articles, les styles, les polices, les images et les tableaux du document, avant toute décision.
- Une page fixe gardée telle quelle. Une affiche, un formulaire, une seule planche ou une courte brochure qui ne sera ni modifiée ni recomposée.
- La première étape d’un portage. Le skill lui-même peut lancer l’importateur pour obtenir un inventaire et un premier brouillon, puis le corriger ; voir plus bas.
#L’importateur
postext import-idml book.idml -o book/
postext import-idml book.idml -o book.postext --layout flow --links Links/
postext import-idml book.idml --report --json
postext import-idml package.zip -o book.postextLa même importation se fait dans le Sandbox, sous Livres › Nouveau › Nouveau livre à partir d’un document InDesign (IDML) (voir Importer un document InDesign), qui ouvre aussi un assemblage InDesign compressé sous Nouveau livre à partir d’un assemblage InDesign (.zip) et en prend les polices et les images liées, et dans le code avec idmlToPostext du paquet postext-idml (voir Utilisation programmatique › Paquets InDesign). Toutes les options de la commande sont dans Ligne de commande › import-idml.
#Importer un document InDesign
Nouveau livre à partir d’un document InDesign (IDML), dans le menu Nouveau du panneau Livres, lit un fichier .idml dans le navigateur et ouvre une boîte de dialogue. Elle montre ce que contient le document : ses pages et leur taille, ses articles, les polices qu’il nomme, ses images, liées et incorporées, et ses tableaux. Mise en page choisit entre Pages composées, où chaque page garde ses blocs là où le document les a, et Livre en texte continu, où le texte court dans des pages que fait la maquette du livre ; Automatique laisse le choix à l’importateur, qui donne sa raison. Un .idml ne contient pas les images qu’il lie : choisissez les fichiers, ou le dossier qui les contient, et chacune est associée par son nom de fichier. Le rapport d’importation suit chaque choix : un verdict, les décomptes, ce qui a été perdu, approché ou noté, chaque fois avec un nombre et un exemple, les polices dont le livre a besoin et les liens encore manquants. Créer le livre ajoute le résultat à vos livres et l’ouvre, et les livres que vous aviez restent tels quels. Un fichier .indd est refusé avec un message qui dit de l’enregistrer en IDML depuis InDesign. La ligne de commande fait la même importation avec postext import-idml. L’importation est une copie des pages du document ; pour un livre que vous garderez, le skill pour agents dégage plutôt ses règles de mise en page (voir Le skill).
Nouveau livre à partir d’un assemblage InDesign (.zip) prend le dossier que crée Fichier › Assemblage dans InDesign, compressé en zip, avec Inclure IDML coché. Quand l’assemblage contient plus d’un document IDML, une boîte de dialogue demande lequel devient le livre. La boîte de dialogue d’importation fonctionne ensuite comme décrit plus haut, avec ce qu’apporte l’assemblage. Ses images liées sont prises dans l’assemblage, associées par nom de fichier et, entre fichiers de même nom, par dossier. Les fichiers de police de Document fonts entrent dans le livre : chaque style est associé par son nom PostScript à celui que nomme le document, de sorte que le texte est composé dans les styles d’origine. Le rapport liste les polices que contient l’assemblage et les styles pour lesquels il n’a pas de fichier, et nomme tout fichier de police que le livre ne peut pas emporter (Type 1, une valise Mac, un fichier WOFF 1). Une collection de polices (.ttc, .otc), la forme sous laquelle macOS livre des polices comme PT Sans, est séparée en ses styles : ceux dans lesquels le texte est composé, avec les autres styles de leurs familles, entrent dans le livre comme fichiers TrueType ou OpenType isolés au nom du style, et les autres styles de la collection restent dehors (depuis postext 1.83). Un assemblage qui ne contient qu’un .indd est refusé avec un message qui dit comment obtenir son IDML.
#Pages ou texte continu
--layout pagessuit le document page pour page. Chaque page devient une page composée et chaque bloc garde sa place, sa taille et son ordre ; une chaîne de blocs liés reste une chaîne. Utilisez-le pour les documents dont chaque page est faite à la main.--layout flowécrit les articles dans l’ordre de lecture sous les styles de paragraphe du document, et Postext les compose sur des pages que fait la maquette du livre. Utilisez-le pour du texte courant, comme un roman ou un essai, où les pages ne font que porter le texte. Les pages dont les blocs ne se lisent qu’ensemble sont composées en entier (depuis postext 1.83.1). Une page sans texte courant à elle, comme une couverture ou un intercalaire de partie, devient dans le flux une page composée, ses blocs là où InDesign les a et ses formes et images en décor. Une page dont le texte courant commence sous un titre accompagné d’un bandeau, d’une image ou d’un bloc rempli est une ouverture : le titre devient un intertitre qui ouvre la page, et le dessin de son style d’intertitre trace le bandeau, le surtitre et l’onglet en marge de grand fond, s’il y en a un. Le rapport les relève commecomposedPagesInFlowetopenerDesigns.auto, la valeur par défaut, choisit l’un ou l’autre d’après le document et donne sa raison.
#Ce qui est repris
- Les styles de paragraphe et de caractère deviennent les styles de paragraphe et de titre du livre, avec leur police, leur corps, leur interlignage, leurs retraits, leurs espacements, leur alignement, leurs taquets de tabulation et leur couleur.
- Le texte avec son emphase, ses sauts de ligne forcés, ses tabulations, ses notes de bas de page, ses hyperliens, ses ruby, ses points d’emphase et le tate-chu-yoko.
- Les tableaux avec leurs cellules fusionnées, leurs rangs d’en-tête, leurs marges intérieures et les images dans les cellules ; les images, ancrées et placées ; les filets, les rectangles et les nuances.
- Les pages, leur taille et leurs marges, les éléments des gabarits et les sections.
- L’habillage. Le texte contourne un bloc qui l’habille. Derrière un objet habillé en Saut d’objet, le bloc de texte est coupé en blocs chaînés au-dessus et au-dessous de l’objet, avec les décalages haut et bas de l’habillage : le texte s’arrête au-dessus et reprend au-dessous, comme dans InDesign ; Saut à la colonne suivante l’arrête au-dessus de l’objet (depuis postext 1.82.2).
- Les nuances de ton direct, comme tons directs de la palette, chacun sur sa propre plaque. Un ton direct avec une finition devient une entrée de
print.inks: la finition qu’un export de Postext a notée revient telle quelle, et toute autre se déduit du nom de l’encre (PANTONE 871 C, métallisée ;Vernis, un vernis) et figure sousinkFinishGuessedpour que vous la confirmiez avec l’imprimeur (depuis postext 1.87.0). - Le tracé de découpe. Les tracés d’un calque nommé comme un tracé de découpe (Découpe, Die line, Troquel…), ou dont le contour est une nuance
CutContour,DieouDieline, sur les pages ou sur leurs gabarits, deviennent lesdieCutsdu livre : chaque trou, une forme placée sur le premier recto qu’il découpe, avecleavess’il traverse aussi les feuillets suivants, et un bord découpé, en coins arrondis (corners) ou en contour (outline). Le nom de la nuance devientprint.dieLine.ink. Les tracés de découpe ne sont pas recopiés comme illustration (depuis postext 1.87.0).
#Ce que signale le rapport
Le .idml ne contient ni les polices ni les images liées. L’importateur liste les familles de polices dont le livre a besoin, que vous donnez ensuite à la génération avec --font-dir. Il lit les images liées depuis --links ou depuis le dossier du fichier, et liste celles qu’il ne trouve pas. Un assemblage compressé contient les deux : en ligne de commande (postext import-idml package.zip), dans le Sandbox et dans le code avec openIdmlArchive, l’importateur prend les images de son dossier Links et met dans le livre les fichiers de police de son dossier Document fonts.
InDesign sait faire des choses qui n’ont pas d’équivalent dans Postext, comme le texte sur un tracé, une cellule pivotée, une diagonale dans une cellule, les styles GREP et imbriqués, ou les effets de transparence. Chacune devient une constatation du rapport, avec un décompte et un exemple : une perte quand elle est laissée de côté, un avertissement quand elle est rendue de façon approchée (les rangs de pied d’un tableau, un dégradé, un habillage par contour). Le rapport finit par un verdict :
faithful: rien n’a été perdu ni approché. Un livre exporté depuis Postext revient fidèle. Depuis postext 1.85.0, l’export chaîne le texte courant des pages composées en colonnes dans un seul article, un bloc par colonne, et l’import le relit comme le livre à flux qu’il était : ses paragraphes entiers, ses titres, ses encadrés et ses figures avec leurs légendes là où ils étaient. Ses repères de colonnes sont les colonnes de la page, colonne latérale comprise. Depuis postext 1.86.0, ses titres courants et ses numéros de page reviennent comme l’en-tête et le pied de page du livre, ceux des ouvertures de chapitre compris, et les encadrés flottés dans une colonne latérale (gloses) reviennent comme flottants de cette colonne. Les formes que Postext dessine sur chaque page sont laissées de côté et signalées comme perte (pageArtInFlow) : un livre qui en a revient donclossyen livre à flux, et son design peut les redessiner. Exporté avec--text frames(un bloc par élément, comme avant 1.85.0), il revient en pages composées, chaque page avec ses blocs là où l’export les a placés, et les styles de paragraphe, les styles de caractère, les encadrés et les images du livre (depuis postext 1.84.0).approximate: certaines choses ont été rendues de façon approchée, et rien n’a été laissé de côté.lossy: quelque chose a été laissé de côté.
#Fidélité de la copie
L’IDML enregistre le texte et les blocs, pas les lignes en lesquelles InDesign les a coupés. Postext recompose les lignes avec son propre compositeur, si bien qu’une ligne d’un document fait dans InDesign finit rarement sur le même mot. Ce qui doit correspondre, c’est le texte qui tombe sur chaque page. L’importateur est testé sur un corpus de documents faits dans InDesign : un livre de 15 pages, des pages de magazine, des tableaux, des liens et des notes, du japonais et de l’arabe, des objets ancrés et des styles. Sur les six qui ont été mesurés, 87 à 100 % des mots tombent sur la même page que dans le PDF d’InDesign (depuis postext 1.78).
Un livre exporté par Postext garde ses lignes. Chaque ligne de l’export finit par un saut forcé, et l’importateur active bodyText.justifyHardBreaks pour que ces lignes restent justifiées.
#Le skill
Le skill pour agents porte un livre selon les étapes que décrit cette page : un cahier des charges, un inventaire de la source, une fiche de faits mesurés, la configuration, les chapitres, et la vérification de chaque page par rapport à l’original. Pour un livre InDesign, donnez-lui tout ce qu’InDesign possède.
#Le dossier source
Dans InDesign, Fichier › Assembler réunit les polices et les images liées du document dans un seul dossier ; cochez les options qui ajoutent l’IDML et le PDF d’impression (Include IDML et Include PDF (Print) dans l’InDesign anglais). Placez ce dossier dans le projet sous le nom source/ :
my-book/
source/
Book.indd
Book.idml
Book.pdf
Document fonts/
Links/
cover.ai
map-01.ai
photo-12.psd
- Le
.idmldonne le texte, les styles, les tableaux et les images ancrées dans l’ordre des articles. Le skill le lit avec son propreidml_extract.py, qui associe chaque style de paragraphe à un rôle. - Le PDF d’impression donne ce qui manque au
.idml: la place où chaque ligne, chaque encadré et chaque figure sont tombés sur la page imprimée. Le skill y mesure la grille, les marges et les ouvertures, et il compare ses propres pages avec lui à la fin. - Les polices permettent à Postext de composer le texte dans les caractères de l’original, si bien que les mesures restent valables. Vérifiez que leur licence le permet ; le skill pose la question quand il ne peut pas le savoir.
- Les illustrations de
Links/deviennent les figures du livre : les fichiers Illustrator en SVG vectoriel, les fichiers Photoshop et TIFF en bitmaps.
Demandez ensuite à l’agent, par exemple : « Porte le livre InDesign de source/ vers Postext : d’abord les chapitres 1 à 3, en espagnol, pour l’impression et l’EPUB. »
#Comment le skill utilise l’importateur
Le skill peut lancer postext import-idml source/Book.idml --report --json au départ. Le rapport donne un inventaire en quelques secondes : les styles utilisés, les articles, les polices, les images, les tableaux et ce qui n’a pas d’équivalent. Le skill part de là et ne livre pas l’import lui-même. Il remplace les blocs à des places fixes par des règles et des modèles, les paragraphes vides et les remplacements locaux par des espacements et des styles, et les positions page par page par des flottants.
#L’exportateur
postext idml book/ -o book.idml
postext idml book.postext -o book.idml --images link --fonts
postext build book/ --pdf book.pdf --idml book.idmlL’exportateur met le livre en page comme le fait le PDF et écrit les pages en .idml pour qu’un graphiste le finisse dans InDesign. Il s’utilise en ligne de commande (postext idml, ou --idml dans build), dans le Sandbox (Exporter vers InDesign (IDML) dans l’en-tête du panneau Texte ; voir Sandbox › Livres, fichiers Word et enregistrement), et dans le code avec idmlDocument de postext-idml.
- Pages et planches. Les pages sont à leur format rogné, en planches de pages en regard pour un livre aux marges de pages en regard, et à raison d’une page par planche sinon ;
--spreads facingou--spreads singleles dispose ainsi quoi que disent les marges. - Lignes.
--lines keep, la valeur par défaut, finit chaque ligne là où Postext l’a finie, si bien qu’InDesign affiche les mêmes lignes que le PDF.--lines reflowlaisse les paragraphes au compositeur d’InDesign, pour un livre qui y sera recomposé. - Texte. Le texte courant des pages composées en colonnes court dans un seul article, chaîné à travers un bloc de texte par colonne, comme dans un livre monté dans InDesign, et les encadrés du flux y sont ancrés (depuis postext 1.85.0) ;
--text framesécrit à la place un bloc et un article par élément, là où Postext l’a peint. Chaque bloc d’une page composée devient un bloc de texte avec son propre article, et les blocs chaînés parnexten partagent un. Les styles de paragraphe portent les noms de styles du livre, ses retraits, ses taquets de tabulation et ses espacements. Les notes de bas de page, les liens, les ruby, les points d’emphase, les articles de droite à gauche et verticaux passent tels quels. - Titres courants. Avec le texte chaîné, les titres courants et les numéros de page sont posés sur des gabarits, comme dans un livre composé dans InDesign (depuis postext 1.86.0). Le numéro de page est le numéro de page actif d’InDesign,
{chapterTitle}une variable de texte de titre courant qui affiche le dernier titre de chapitre de la page, et les autres mots sont écrits tels quels. Les pages qui montrent les mêmes titres courants appliquent le même gabarit, et les ouvertures de chapitre ont le leur, nommé Opener. Un titre courant qu’InDesign ne sait pas exprimer, comme{attr.lieu}, reste sur sa page. Les encadrés flottés dans une colonne latérale (gloses) sont ancrés dans le texte courant à une position personnalisée : ils suivent le paragraphe qu’ils accompagnent. - Objets de page. Les filets, les encadrés, les tracés et les images deviennent des objets de page InDesign ; les tableaux deviennent des tableaux InDesign, et les formules en ligne, la musique et les pastilles de couleur deviennent des objets ancrés. Les couleurs CMJN définies par l’auteur deviennent des nuances quadrichromes, et les pastilles de champ de formulaire deviennent des champs de formulaire InDesign.
- Encres spéciales et tracé de découpe. Chaque ton direct devient une nuance de ton direct avec son encre à elle, et sa finition est gardée dans le libellé de script de la nuance (
postext:finish), car InDesign n’a pas de champ pour elle. Le Gestionnaire d’encres reçoit le type d’encre avec lequel la finition se sépare : Transparente pour un vernis, Opaque pour un blanc, une encre métallisée ou un marquage à chaud. Le blanc et le vernis sont en surimpression, comme dans le PDF. Les découpes sont tracées sur un calque verrouillé nommé Die line, en tracés dont le contour est la nuance de découpe, en surimpression ; le calque ne s’imprime pas quandprint.dieLine.outputvautnone. Réimporté, le paquet rend les mêmes encres et les mêmes découpes (depuis postext 1.87.0). - Images et polices.
--images linkécrit les images dansLinks/à côté du paquet au lieu de les incorporer. Chaque fichier porte l'extension de son format (.svg,.png,.jpg,.pdf…) et s'ouvre donc dans son programme une fois décompressé.--fontsécrit les fichiers de police dansDocument fonts/, où InDesign les trouve, et laisse de côté toute famille que le livre ne peut pas redistribuer. - Avertissements. Tout ce qu’InDesign ne peut pas afficher comme Postext l’a composé est signalé par un avertissement
idml.*, comme le cadre arrondi d’un tableau ou les points d’emphase du texte vertical.
Exporter n’est pas porter à l’envers. Le .idml contient les pages que Postext a mises en page, et les règles qui les ont mises en page restent dans le livre Postext. Une modification faite dans InDesign revient à Postext par l’importateur, comme une copie de la page. Les règles que vous changez, comme le corps du texte, se changent mieux dans le livre Postext, puis on exporte de nouveau.
#Choisir, en bref
- Pour garder, modifier ou traduire un livre fait dans InDesign, portez-le avec le skill à partir d’un dossier source assemblé.
- Pour voir ce que contient un
.idml, ou pour faire revenir un livre exporté par Postext, utilisez l’importateur. - Pour garder telle quelle une page fixe unique, importez-la avec
--layout pages. - Pour envoyer un livre Postext à un studio InDesign, exportez-le avec
postext idml.
