# 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

- Version HTML: https://postext.dev/fr/docs/indesign
- Dernière mise à jour: 2026-11-14
- Temps de lecture: 10 min
- Autres langues: [en](https://postext.dev/en/docs/indesign.md), [es](https://postext.dev/es/docs/indesign.md), [ca](https://postext.dev/ca/docs/indesign.md), [de](https://postext.dev/de/docs/indesign.md), [it](https://postext.dev/it/docs/indesign.md), [pt](https://postext.dev/pt/docs/indesign.md), [zh](https://postext.dev/zh/docs/indesign.md), [ja](https://postext.dev/ja/docs/indesign.md), [ar](https://postext.dev/ar/docs/indesign.md)

## 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 `.idml` en livre Postext ;
- le **skill pour agents** [`postext-port`](https://postext.dev/fr/docs/skill.md), qui porte un livre à partir de toutes ses sources, dont le `.idml` ;
- **l’exportateur**, qui écrit un livre Postext en `.idml` pour 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.

> [InDesign, aller et retour : importer, porter et exporter des livres InDesign avec Postext](https://youtu.be/fRHJeLf-vBM) · 4:16

## 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](https://postext.dev/fr/docs/indesign.md#comment-le-skill-utilise-limportateur).

## L’importateur

```bash
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.postext
```

La même importation se fait dans le Sandbox, sous **Livres › Nouveau › Nouveau livre à partir d’un document InDesign (IDML)** (voir [Importer un document InDesign](https://postext.dev/fr/docs/indesign.md#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](https://postext.dev/fr/docs/configuration-programmatic-usage.md#paquets-indesign-postext-idml)). Toutes les options de la commande sont dans [Ligne de commande › import-idml](https://postext.dev/fr/docs/command-line.md#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`](https://postext.dev/fr/docs/command-line.md#import-idml). L’importation est une copie des pages du document ; pour un livre que vous garderez, le [skill pour agents](https://postext.dev/fr/docs/skill.md) dégage plutôt ses règles de mise en page (voir [Le skill](https://postext.dev/fr/docs/indesign.md#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 pages`** suit le document page pour page. Chaque page devient une [page composée](https://postext.dev/fr/docs/composed-pages.md) 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](https://postext.dev/fr/docs/composed-pages.md), 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 comme `composedPagesInFlow` et `openerDesigns`.
- **`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`](https://postext.dev/fr/docs/special-inks-die-cuts.md) : 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 sous `inkFinishGuessed` pour 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`, `Die` ou `Dieline`, sur les pages ou sur leurs gabarits, deviennent les [`dieCuts`](https://postext.dev/fr/docs/special-inks-die-cuts.md) du livre : chaque trou, une forme placée sur le premier recto qu’il découpe, avec `leaves` s’il traverse aussi les feuillets suivants, et un bord découpé, en coins arrondis (`corners`) ou en contour (`outline`). Le nom de la nuance devient `print.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 donc `lossy` en 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`](https://postext.dev/fr/docs/configuration-text.md) pour que ces lignes restent justifiées.

## Le skill

Le [skill pour agents](https://postext.dev/fr/docs/skill.md) 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 `.idml`** donne le texte, les styles, les tableaux et les images ancrées dans l’ordre des articles. Le skill le lit avec son propre `idml_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

```bash
postext idml book/ -o book.idml
postext idml book.postext -o book.idml --images link --fonts
postext build book/ --pdf book.pdf --idml book.idml
```

L’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`](https://postext.dev/fr/docs/command-line.md#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](https://postext.dev/fr/docs/sandbox-books-saving.md)), 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 facing` ou `--spreads single` les 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 reflow` laisse 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 par `next` en 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 quand `print.dieLine.output` vaut `none`. 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 dans `Links/` à 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 dans `Document 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`.
