Capitolo 18 · Parte III · In pratica
InDesign: importazione, esportazione e porting
I due modi per portare un libro di InDesign in Postext, l’importatore IDML che copia ciò che il documento contiene e la skill per agenti che ne ricava le regole di impaginazione, quando usare ciascuno, e come l’esportatore IDML restituisce un libro a InDesign
In breve
Postext può accogliere in due modi un libro fatto in InDesign. L’importatore copia ciò che il file di InDesign contiene, ogni pagina, ogni cornice e ogni stile così com’è; è rapido, ma il risultato è una copia delle vecchie pagine, difficile da modificare e da tradurre. La skill per agenti invece studia il libro: il file, il PDF stampato, i font e le immagini. Trova le regole che il grafico ha seguito e ricostruisce il libro a partire da quelle, con il testo libero di scorrere. Così si ottiene un libro migliore, ed è la via che consigliamo. Questa pagina spiega i due modi, quando conviene ciascuno e come Postext restituisce a InDesign un libro finito.
Un libro fatto in InDesign può entrare in Postext copiandone le pagine o ricavandone la grafica. Consigliamo di ricavarne la grafica.
Postext legge e scrive i pacchetti InDesign Markup (.idml), il file che InDesign salva con File › Salva con nome › InDesign Markup (IDML). Li usano tre strumenti:
- l’importatore, che trasforma un
.idmlin un libro Postext; - la skill per agenti
postext-port, che porta un libro in Postext da tutte le sue fonti, tra cui il.idml; - l’esportatore, che scrive un libro Postext come
.idmlperché un grafico lo rifinisca in InDesign.
L’importatore e la skill portano entrambi un libro in Postext, ma non danno lo stesso libro. Questa pagina spiega la differenza perché tu possa scegliere.
#Due vie verso Postext
Un documento InDesign è un insieme di pagine fatte a mano da qualcuno. Il grafico ha seguito delle regole, come un corpo del testo, una griglia, il modo in cui si apre un capitolo, dove va un riquadro e come sta una didascalia sotto la sua figura. Il .idml conserva il risultato di quelle regole, cornice per cornice, e non registra le regole stesse.
L’importatore copia il risultato. Legge il pacchetto e scrive ciò che trova: ogni cornice dove stava, ogni stile con i suoi valori, ogni immagine e ogni tabella come risorsa. Niente viene indovinato, e lo stesso file dà sempre lo stesso libro. Come l’HTML di una pagina web, la copia mostra le pagine senza il ragionamento che le ha prodotte. Una cornice messa a occhio resta alle sue coordinate, un titolo spinto in basso con un paragrafo vuoto tiene il paragrafo vuoto, e una modifica locale resta una modifica locale. Il libro somiglia all’originale e ne conserva anche i ritocchi fatti a mano.
La skill ricava le regole. Un agente legge tutto il sorgente: il .idml, il PDF di stampa, i font e le illustrazioni. Misura le pagine e annota le regole che seguono, come il formato rifilato e i margini, la griglia della linea di base, i ruoli tipografici, le aperture, le testatine, le famiglie di riquadri e dove vanno gli elementi flottanti. Poi scrive il testo come Markdown che si può ricomporre, senza posizioni di pagina, e imposta la grafica nella configurazione a partire da quelle regole. Postext compone le pagine in base alle regole, così il libro si può modificare, tradurre e comporre in un altro formato, e somiglia ancora all’originale.
| Importatore | Skill per agenti | |
|---|---|---|
| Legge | Il .idml e le sue immagini collegate | Il .idml, il PDF di stampa, i font e le illustrazioni collegate (.ai, .psd, .eps, .tif) |
| Metodo | Deterministico: copia ciò che il documento contiene | Inferenza: misura le pagine e ne ricava le regole |
| Testo | Legato alle cornici del documento (--layout pages) o a testo continuo sotto i suoi stili (--layout flow) | Markdown ricomponibile con direttive, senza posizioni di pagina |
| Grafica | I valori degli stili e delle cornici del documento | Una configurazione di regole: griglia, ruoli tipografici, aperture, testatine, riquadri, elementi flottanti, modelli di pagina per le pagine composte |
| Tempo | Secondi | Ore per un libro, con un agente e controlli sul PDF |
| Risultato | Una replica, con un rapporto di ciò che è andato perso | Un libro Postext che si comporta come l’originale |
Usa la skill come scelta predefinita. È la via giusta per ogni libro da tenere: un libro che rivedrai, tradurrai, comporrai in un altro formato o pubblicherai in EPUB oltre che in stampa.
Usa l’importatore quando lo scopo è una copia:
- Un libro esportato da Postext. Un
.idmlscritto da Postext torna con le stesse righe e le stesse pagine, così le modifiche di un grafico in InDesign tornano nel libro. - Un’occhiata veloce. Il rapporto di importazione elenca in pochi secondi le pagine, i brani, gli stili, i font, le immagini e le tabelle del documento, prima di qualsiasi decisione.
- Una pagina fissa che resta com’è. Un manifesto, un modulo, un singolo spread o un breve opuscolo che non verrà modificato né ricomposto.
- Il primo passo di un porting. La skill stessa può lanciare l’importatore per avere un inventario e una prima bozza, e poi correggerla; vedi più avanti.
#L’importatore
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 stessa importazione si fa nella Sandbox, da Libri › Nuovo › Nuovo libro da un documento InDesign (IDML) (vedi Importare un documento InDesign), che apre anche un pacchetto InDesign compresso da Nuovo libro da un pacchetto InDesign (.zip) e ne prende i font e le immagini collegate, e nel codice con idmlToPostext del pacchetto postext-idml (vedi Uso programmatico › Pacchetti InDesign). Tutte le opzioni del comando sono in Riga di comando › import-idml.
#Importare un documento InDesign
Nuovo libro da un documento InDesign (IDML), nel menu Nuovo del pannello Libri, legge un file .idml nel browser e apre una finestra di dialogo. Mostra ciò che il documento contiene: le pagine e la loro misura, i brani, i font che nomina, le immagini, collegate e incorporate, e le tabelle. Layout sceglie tra Pagine composte, dove ogni pagina tiene le cornici dove le ha il documento, e Libro a testo continuo, dove il testo scorre in pagine fatte dal progetto grafico del libro; Automatico lascia la scelta all’importatore, che ne dà il motivo. Un .idml non contiene le immagini a cui rimanda: scegli i file, o la cartella in cui si trovano, e ciascuna viene abbinata in base al nome del file. Il rapporto di importazione segue ogni scelta: un verdetto, i conteggi, ciò che è andato perso, è stato approssimato o annotato, ogni volta con un numero e un esempio, i font di cui il libro ha bisogno e i collegamenti ancora mancanti. Crea il libro aggiunge il risultato ai tuoi libri e lo apre, e i libri che avevi restano come sono. Un file .indd viene rifiutato con un messaggio che dice di salvarlo come IDML da InDesign. La riga di comando fa la stessa importazione con postext import-idml. L’importazione è una copia delle pagine del documento; per un libro da tenere, la skill per agenti ricava invece le sue regole di impaginazione (vedi La skill).
Nuovo libro da un pacchetto InDesign (.zip) prende la cartella che crea File › Pacchetto di InDesign, compressa in zip, con Includi IDML spuntato. Quando il pacchetto contiene più di un documento IDML, una finestra di dialogo chiede quale diventa il libro. La finestra di importazione funziona poi come sopra, con ciò che il pacchetto aggiunge. Le immagini collegate si prendono dal pacchetto, abbinate in base al nome del file e, tra file con lo stesso nome, in base alla cartella. I file dei font di Document fonts entrano nel libro: ogni stile viene abbinato in base al nome PostScript a quello che il documento nomina, così il testo è composto negli stili originali. Il rapporto elenca i font che il pacchetto contiene e gli stili per cui non ha un file, e nomina ogni file di font che il libro non può portare con sé (Type 1, una valigia Mac, un file WOFF 1). Una raccolta di font (.ttc, .otc), il modo in cui macOS distribuisce font come PT Sans, viene divisa nei suoi stili: quelli in cui è composto il testo, con gli altri stili delle loro famiglie, entrano nel libro come file TrueType o OpenType singoli con il nome dello stile, e gli altri stili della raccolta restano fuori (da postext 1.83). Un pacchetto che contiene solo un .indd viene rifiutato con un messaggio che dice come ottenerne l’IDML.
#Pagine o testo continuo
--layout pagessegue il documento pagina per pagina. Ogni pagina diventa una pagina composta e ogni cornice mantiene posizione, misura e ordine; una catena di cornici concatenate resta una catena. Usalo per i documenti le cui pagine sono fatte a mano una per una.--layout flowscrive i brani in ordine di lettura sotto gli stili di paragrafo del documento, e Postext li compone su pagine fatte dal progetto grafico del libro. Usalo per testo corrente, come un romanzo o un saggio, dove le pagine servono solo a contenere il testo. Le pagine le cui cornici si leggono solo insieme vengono composte intere (da postext 1.83.1). Una pagina senza testo corrente suo, come una copertina o un occhiello di parte, diventa nel flusso una pagina composta, con le cornici dove le ha InDesign e forme e immagini come decorazione. Una pagina il cui testo corrente comincia sotto un titolo con una fascia, un’immagine o una cornice riempita è un’apertura: il titolo diventa un titolo che apre la pagina, e il disegno del suo stile di titolo traccia la fascia, l’occhiello e l’eventuale linguetta sul margine esterno. Il rapporto le elenca comecomposedPagesInFloweopenerDesigns.auto, il valore predefinito, sceglie in base al documento e ne dà il motivo.
#Che cosa passa
- Gli stili di paragrafo e di carattere diventano gli stili di paragrafo e di titolo del libro, con font, corpo, interlinea, rientri, spaziature, allineamento, tabulazioni e colore.
- Il testo con le sue enfasi, gli a capo forzati, le tabulazioni, le note a piè di pagina, i collegamenti ipertestuali, il ruby, i segni di enfasi e il tate-chu-yoko.
- Le tabelle con le celle unite, le righe di intestazione, i margini interni e le immagini nelle celle; le immagini, ancorate e inserite; filetti, rettangoli e campioni di colore.
- Le pagine, la loro misura e i margini, gli elementi delle pagine mastro e le sezioni.
- La contornatura del testo. Il testo gira intorno a una cornice che lo contorna. Dietro un oggetto con contornatura Salta oggetto, la cornice di testo viene tagliata in cornici concatenate sopra e sotto l’oggetto, con gli scostamenti superiore e inferiore della contornatura, così il testo si ferma sopra e riprende sotto, come in InDesign; Salta alla colonna successiva lo ferma sopra l’oggetto (da postext 1.82.2).
- I campioni di tinta piatta, come tinte piatte della palette, ognuna sulla propria lastra. Una tinta piatta con una finitura diventa una voce di
print.inks: la finitura che un’esportazione di Postext ha annotato torna così com’è, e ogni altra si ricava dal nome dell’inchiostro (PANTONE 871 Cmetallico,Verniceuna vernice) e compare sottoinkFinishGuessed, perché tu la confermi con la tipografia (da postext 1.87.0). - La linea di fustella. I tracciati di un livello con il nome di una linea di fustella (Fustella, Die line, Troquel…), o con la traccia di un campione
CutContour,DieoDieline, sulle pagine o sulle loro pagine mastro, diventano ledieCutsdel libro: ogni foro una forma posta sul primo recto che taglia, conleavesse attraversa anche i fogli seguenti, e un bordo rifilato come angoli arrotondati (corners) o come contorno (outline). Il nome del campione diventaprint.dieLine.ink. I tracciati della fustella non vengono copiati come illustrazione (da postext 1.87.0).
#Che cosa segnala il rapporto
Il .idml non contiene i font né le immagini collegate. L’importatore elenca le famiglie di font di cui il libro ha bisogno, che poi passi alla generazione con --font-dir. Legge le immagini collegate da --links o dalla cartella del file, ed elenca quelle che non trova. Un pacchetto compresso contiene entrambi: dalla riga di comando (postext import-idml package.zip), nella Sandbox e nel codice con openIdmlArchive, l’importatore prende le immagini dalla sua cartella Links e mette nel libro i file dei font della sua cartella Document fonts.
InDesign sa fare cose che in Postext non hanno un equivalente, come il testo su tracciato, una cella ruotata, una diagonale in una cella, gli stili GREP e nidificati o gli effetti di trasparenza. Ognuna diventa una voce del rapporto, con un conteggio e un esempio: una perdita quando viene tralasciata, un avviso quando viene resa in modo approssimato (le righe di piè di una tabella, una sfumatura, una contornatura sul profilo). Il rapporto finisce con un verdetto:
faithful: niente è andato perso né è stato approssimato. Un libro esportato da Postext torna fedele. Da postext 1.85.0 l’esportazione concatena il testo corrente delle pagine composte in colonne in un solo brano, una cornice per colonna, e l’importatore lo rilegge come il libro a flusso che era: i paragrafi interi, i titoli, i riquadri e le figure con le loro didascalie dove stavano. Le sue guide di colonna sono le colonne della pagina, colonna laterale compresa. Da postext 1.86.0 le sue testatine e i numeri di pagina tornano come intestazione e piè di pagina del libro, compresi quelli delle aperture di capitolo, e i riquadri spostati in una colonna laterale (glosse) tornano come elementi flottanti di quella colonna. Le forme che Postext disegna su ogni pagina restano fuori e vengono segnalate come perdita (pageArtInFlow), quindi un libro che le ha tornalossycome libro a flusso; il suo design può ridisegnarle. Esportato con--text frames(una cornice per blocco, come prima di 1.85.0), torna come pagine composte, ogni pagina con le sue cornici dove le ha messe l’esportazione, e gli stili di paragrafo, gli stili di carattere, i riquadri e le immagini del libro (da postext 1.84.0).approximate: alcune cose sono state rese in modo approssimato, e niente è stato tralasciato.lossy: qualcosa è stato tralasciato.
#Quanto è fedele la copia
IDML registra il testo e le cornici, non le righe in cui InDesign li ha spezzati. Postext ricompone le righe con il proprio compositore, quindi una riga di un documento fatto in InDesign raramente finisce sulla stessa parola. Ciò che deve coincidere è il testo che cade su ciascuna pagina. L’importatore viene provato su un corpus di documenti fatti in InDesign: un libro di 15 pagine, pagine di rivista, tabelle, collegamenti e note, giapponese e arabo, oggetti ancorati e stili. Sui sei misurati, dall’87 al 100 per cento delle parole cade sulla stessa pagina che nel PDF prodotto da InDesign (da postext 1.78).
Un libro esportato da Postext mantiene le sue righe. Ogni riga dell’esportazione finisce con un a capo forzato, e l’importatore attiva bodyText.justifyHardBreaks perché quelle righe restino giustificate.
#La skill
La skill per agenti porta un libro in Postext con i passi che quella pagina descrive: un brief, un inventario del sorgente, una scheda di dati misurati, la configurazione, i capitoli e il controllo di ogni pagina rispetto all’originale. Per un libro di InDesign, dalle tutto ciò che InDesign ha.
#La cartella del sorgente
In InDesign, File › Pacchetto raccoglie in una cartella i font e le immagini collegate del documento; attiva le opzioni che aggiungono l’IDML e il PDF di stampa (Include IDML e Include PDF (Print) in InDesign in inglese). Metti quella cartella nel progetto come source/:
my-book/
source/
Book.indd
Book.idml
Book.pdf
Document fonts/
Links/
cover.ai
map-01.ai
photo-12.psd
- Il
.idmldà il testo, gli stili, le tabelle e le immagini ancorate nell’ordine dei brani. La skill lo legge con il proprioidml_extract.py, che associa ogni stile di paragrafo a un ruolo. - Il PDF di stampa dà ciò che manca al
.idml: dove sono finite sulla pagina stampata ogni riga, ogni riquadro e ogni figura. La skill vi misura la griglia, i margini e le aperture, e alla fine confronta con esso le proprie pagine. - I font permettono a Postext di comporre il testo nei caratteri dell’originale, così le misure restano valide. Controlla che la loro licenza lo consenta; la skill lo chiede quando non riesce a capirlo.
- Le illustrazioni in
Links/diventano le figure del libro: i file di Illustrator come SVG vettoriali, i file di Photoshop e TIFF come bitmap.
Poi chiedi all’agente, per esempio: «Porta in Postext il libro InDesign che è in source/: prima i capitoli da 1 a 3, in spagnolo, per la stampa e l’EPUB.»
#Come la skill usa l’importatore
La skill può lanciare all’inizio postext import-idml source/Book.idml --report --json. Il rapporto dà un inventario in pochi secondi: gli stili usati, i brani, i font, le immagini, le tabelle e ciò che non ha un equivalente. La skill parte da lì e non consegna l’importazione così com’è. Sostituisce le cornici in posizioni fisse con regole e modelli, i paragrafi vuoti e le modifiche locali con spaziature e stili, e le posizioni pagina per pagina con elementi flottanti.
#L’esportatore
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’esportatore impagina il libro come fa il PDF e scrive le pagine come .idml perché un grafico lo rifinisca in InDesign. Funziona dalla riga di comando (postext idml, o --idml in build), dalla Sandbox (Esporta in InDesign (IDML) nell’intestazione del pannello Testo; vedi Sandbox › Libri, file Word e salvataggio) e nel codice con idmlDocument di postext-idml.
- Pagine e spread. Le pagine stanno al loro formato rifilato, in spread di pagine affiancate per un libro con margini speculari e una pagina per spread negli altri casi;
--spreads facingo--spreads singlele dispone così qualunque cosa dicano i margini. - Righe.
--lines keep, il valore predefinito, chiude ogni riga dove l’ha chiusa Postext, quindi InDesign mostra le stesse righe del PDF.--lines reflowlascia i paragrafi al compositore di InDesign, per un libro che verrà composto di nuovo lì. - Testo. Il testo corrente delle pagine composte in colonne scorre in un solo brano, concatenato attraverso una cornice di testo per colonna, come in un libro impaginato in InDesign, e i riquadri del flusso vi sono ancorati (da postext 1.85.0);
--text framesscrive invece una cornice e un brano per blocco, dove Postext lo ha dipinto. Ogni cornice di una pagina composta diventa una cornice di testo con un proprio brano, e le cornici concatenate connextne condividono uno. Gli stili di paragrafo portano i nomi degli stili del libro, i rientri, le tabulazioni e le spaziature. Passano le note a piè di pagina, i collegamenti, il ruby, i segni di enfasi e i brani da destra a sinistra e verticali. - Testatine. Con il testo concatenato, le testatine e i numeri di pagina stanno su pagine mastro, come in un libro composto in InDesign (da postext 1.86.0). Il numero di pagina è il numero di pagina corrente di InDesign,
{chapterTitle}una variabile di testo per le testatine che mostra l’ultimo titolo di capitolo della pagina, e le altre parole sono scritte come sono. Le pagine che mostrano le stesse testatine applicano la stessa pagina mastro, e le aperture di capitolo ne hanno una propria, chiamata Opener. Una testatina che InDesign non sa esprimere, come{attr.luogo}, resta sulla sua pagina. I riquadri spostati in una colonna laterale (glosse) sono ancorati nel testo corrente in una posizione personalizzata, così seguono il paragrafo che accompagnano. - Elementi di pagina. Filetti, riquadri, tracciati e immagini diventano elementi di pagina di InDesign; le tabelle diventano tabelle di InDesign, e le formule nel testo, la musica e i campioni di colore in linea diventano oggetti ancorati. I colori CMYK dell’autore diventano campioni in quadricromia, e i chip con un campo di modulo diventano campi di modulo di InDesign.
- Inchiostri speciali e linea di fustella. Ogni tinta piatta diventa un campione di tinta piatta con un inchiostro suo, e la finitura resta nell’etichetta di script del campione (
postext:finish), perché InDesign non ha un campo per essa. Gestione inchiostri riceve il tipo di inchiostro con cui la finitura si separa: Trasparente per una vernice, Opaco per un bianco, un inchiostro metallico o una lamina. Il bianco e la vernice vanno in sovrastampa, come nel PDF. Le fustelle sono disegnate su un livello bloccato chiamato Die line, come tracciati con la traccia del campione della fustella e in sovrastampa; il livello non si stampa quandoprint.dieLine.outputènone. Importato di nuovo, il pacchetto restituisce gli stessi inchiostri e le stesse fustelle (da postext 1.87.0). - Immagini e font.
--images linkscrive le immagini inLinks/accanto al pacchetto invece di incorporarle. Ogni file porta l'estensione del suo formato (.svg,.png,.jpg,.pdf…), così si apre con il suo programma una volta decompresso.--fontsscrive i file dei font inDocument fonts/, dove InDesign li trova, e lascia fuori ogni famiglia che il libro non può ridistribuire. - Avvisi. Ciò che InDesign non può mostrare come l’ha composto Postext viene segnalato con un avviso
idml.*, come la cornice arrotondata di una tabella o i punti di enfasi nel testo verticale.
Esportare non è fare il porting al contrario. Il .idml contiene le pagine che Postext ha impaginato, e le regole che le hanno impaginate restano nel libro Postext. Una modifica fatta in InDesign torna in Postext attraverso l’importatore, come copia della pagina. Le regole che cambi, come il corpo del testo, conviene cambiarle nel libro Postext ed esportare di nuovo.
#In breve, come scegliere
- Per tenere, modificare o tradurre un libro fatto in InDesign, portalo in Postext con la skill a partire da una cartella del sorgente creata con Pacchetto.
- Per vedere che cosa contiene un
.idml, o per riportare indietro un libro esportato da Postext, usa l’importatore. - Per tenere esattamente com’è una singola pagina fissa, importala con
--layout pages. - Per mandare un libro Postext a uno studio che lavora con InDesign, esportalo con
postext idml.
