Saltar al contingut principal

Capítol 19 · Part III · La pràctica

Skill per a agents: portar una publicació a Postext

Instal·la la skill postext-port a Claude Code, Codex o qualsevol agent i deixa que converteixi un PDF, Word, PowerPoint, EPUB, InDesign o HTML en un projecte de Postext que segueix la maquetació original

Actualitzat 2026-10-2110 minenescadefritptzhjaar

En poques paraules

Aquesta pàgina és per a qui ja té un llibre o un document en un altre format, com ara PDF, Word o InDesign, i el vol passar a Postext. Un assistent d'intel·ligència artificial, que s'anomena agent, pot fer gairebé tota la feina si li dones un petit complement anomenat skill. La skill ensenya l'agent a copiar el text i a reconstruir el disseny de l'original. La pàgina explica com instal·lar-la, què demanar-li i com revisar el resultat. Un vídeo d'uns cinc minuts mostra cada pas.

Converteix una publicació existent en un projecte de Postext amb un agent de programació.

Molta gent arriba a Postext amb un llibre que ja existeix: un manual en PDF d'impremta, un informe en Word, un curs en PowerPoint, un catàleg en InDesign, un EPUB. Portar-lo implica dues feines:

  • El contingut: el Markdown enriquit de cada capítol, amb les seves directives i microformats.
  • El disseny: un manifest de configuració que reprodueixi les regles de maquetació de l'original (geometria de pàgina, retícula de base, tipografia, obertures, capçaleres, requadres, flotants, taules, parts).

Un LLM pot fer bona part d'aquesta feina, però només si sap com funciona Postext. El Markdown de Postext no és CommonMark, i la configuració té paranys que només es veuen quan una pàgina surt malament. La skill postext-port reuneix aquest coneixement i les eines amb què hem construït tots els presets del Sandbox, perquè el teu agent pugui fer bé l'adaptació.

Segueix el format obert Agent Skills, així que funciona amb Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode i molts altres agents.

#Mira el tutorial

Cinc minuts, sense programar: prepara la carpeta, aplega els originals vectorials, afegeix un PDF de referència, demana-ho a l'agent i revisa el resultat al Sandbox.

Transcripció

Tot el que diu el narrador, amb una descripció del que apareix a la pantalla.

  1. 0:00

    A la pantallaCapçalera: el logotip de Postext, el rètol «Tutorial · 5 passos» i el títol «Converteix la teva publicació a Postext amb un agent d’IA. Sense programar.»

  2. 0:03

    A la pantalla«La teva publicació ja existeix.» Tres pàgines compostes amb Postext, un llibre, un manual i una revista, cauen l’una rere l’altra amb les etiquetes InDesign (IDML), Word (DOCX) i PDF. S’apleguen a l’esquerra, una fletxa daurada discontínua passa per una insígnia «Agent d’IA» i apareix una icona de fitxer, el-meu-llibre.postext, sota «Un agent la converteix a Postext. Cinc passos. Unes quantes peticions ben escrites.»

    NarracióJa tens una publicació: un llibre, un manual, una revista. Viu a InDesign, a Word o en un PDF. En aquest tutorial, un agent d’intel·ligència artificial la convertirà a Postext per tu. Sense programar: cinc passos i unes quantes peticions ben escrites.

  3. 0:23

    A la pantalla«El pla»: cinc targetes numerades apareixen a mesura que la veu anomena cada pas: 01 Prepara la carpeta, 02 Reuneix els originals vectorials, 03 Afegeix una referència, 04 Demana-ho a l’agent, 05 Revisa-ho al sandbox.

    NarracióEl pla: preparar la carpeta, reunir els originals vectorials, afegir una referència, demanar-ho a l’agent i revisar el resultat.

  4. 0:34

    A la pantallaPas 01, la carpeta: «Un projecte, una carpeta.» Una carpeta gran, el-meu-llibre/, sura entre deu fitxers solts, com MinionPro-Regular.otf, portada.jpg, fig-2-1.ai, capitol-01.docx, mapa.svg, llibre.idml i grafic.pdf. S’obre una finestra amb l’arbre de la carpeta i cada fitxer vola a la seva subcarpeta quan la veu l’anomena: referencia.pdf (com ha de quedar, pas 03), fonts/ (Minion Pro, Myriad…, .otf .ttf .woff2), imatges/ (fotografies, .jpg .png), il·lustracions/ (originals vectorials, .ai .svg .pdf) i textos/ (Word, InDesign IDML…).

    NarracióPas u: reuneix-ho tot en una sola carpeta a l’ordinador. Un projecte, una carpeta. A dins, dona a cada tipus de material la seva pròpia subcarpeta: les tipografies, les imatges, les il·lustracions i els textos.

  5. 0:51

    A la pantallaLa fila fonts/ es ressalta i una targeta titulada «Tipografies» mostra una «Aa» gran, els estils Rodona, Cursiva i Negreta, els formats OTF, TTF i WOFF2 i la nota «Només es poden fer servir les que incloguis.» Després apareix «Com més endreçada, menys endevina.», mentre cada subcarpeta de l’arbre rep una marca.

    NarracióNo t’oblidis de les tipografies: són la veu del disseny, i l’agent només pot fer servir les que incloguis. Com més endreçada estigui la carpeta, menys haurà d’endevinar l’agent.

  6. 1:04

    A la pantallaPas 02, originals vectorials: «Reuneix els originals.» Un diagrama, un gràfic i un mapa es dibuixen a traç, amb els punts d’ancoratge a la vista, i apareixen tres icones de fitxer: .ai Illustrator, .svg SVG i .pdf PDF.

    NarracióPas dos: si les teves il·lustracions són vectorials, com diagrames, gràfics o mapes, busca els fitxers originals: Illustrator, SVG o PDF.

  7. 1:15

    A la pantallaDos taulers mostren la mateixa figura, un diagrama en què Manuscrit i Plantilla apunten a Pàgines, amb el peu «Fig. 2.1 Contingut i disseny es troben.» A l’esquerra, «Retallada del PDF: una foto del dibuix» es torna borrosa i pixelada quan s’amplia; a la dreta, «L’original: el dibuix mateix» es manté nítid. El tauler de l’esquerra s’apaga, els rètols de l’original es reescriuen en anglès (Manuscript, Template, Pages), unes marques de tall l’emmarquen i tres etiquetes diuen «Nítida a qualsevol mida», «Rètols com a text real» i «Original → impremta».

    NarracióUna figura retallada del PDF final és poca cosa més que una foto del dibuix. L’original és el dibuix mateix. Amb l’original, l’agent recompon cada figura: nítida a qualsevol mida, amb els rètols com a text real, a punt per traduir. I a impremta, l’original hi va tal com és.

  8. 1:36

    A la pantallaPas 03, la referència: «Mostra com ha de quedar.» A l’arbre de la carpeta es ressalta referencia.pdf amb l’etiqueta «A l’arrel». En surt una pàgina que es converteix en una pàgina de llibre gran, a dues columnes, marcada referencia.pdf.

    NarracióEl pas tres és essencial: a l’arrel de la carpeta, posa-hi un fitxer que mostri amb claredat com ha de quedar el producte final. L’ideal és un PDF.

  9. 1:45

    A la pantallaSobre la pàgina apareixen les mesures: el contorn de les columnes, una separació de 9 mm, un marge de 20 mm, etiquetes per al títol (Fraunces 28 pt), el text (Lora 9,4/13,6 pt) i un requadre (fons, 1 filet), i les línies de base amb un interlineat de 13,6 pt. Un fitxer, fitxa-especificacions.md, es va omplint: pàgina 210 × 280 mm; marges 24 · 20 · 22 · 20 mm, simètrics; 2 columnes, separació 9 mm; retícula base 13,6 pt; text Lora 9,4 / 13,6 pt, justificat; títols Fraunces 28 pt · Geist; obertures amb banda de color, 101 mm; requadres amb fons i filet esquerre. Després la paraula «Endevinar» queda ratllada i «Mesurar.» s’encén en daurat.

    NarracióL’agent llegeix el disseny en aquestes pàgines: mesura marges, columnes, tipografies i espais, i els anota com a regles de maquetació. Sense referència, hauria d’endevinar. Amb ella, mesura.

  10. 2:00

    A la pantallaPas 04, l’agent: «Demana-ho amb les teves paraules.» S’obre una finestra titulada «Agent · ~/el-meu-llibre» al costat de les insígnies Claude Code, Codex i «o qualsevol altre agent». S’hi escriu un missatge signat TU: «Instal·la la skill de Postext: `npx skills add drnachio/postext --skill postext-port`», i l’agent respon «✓ Skill instal·lada: postext-port». Una targeta de la skill postext-port enumera «Un mètode provat», «Tot sobre Postext» i «Eines per revisar la seva feina».

    NarracióPas quatre: obre el teu agent, Claude Code, Codex o el que tinguis, en aquesta carpeta, i demana-li que instal·li la skill de Postext. Una skill és un paquet de coneixement expert. Aquesta ensenya l’agent a convertir una publicació a Postext, i li dona eines per revisar la seva pròpia feina.

  11. 2:20

    A la pantallaS’escriu la petició següent: «Fes servir la skill postext-port per convertir aquest llibre a Postext. El disseny és a referencia.pdf, les tipografies a fonts/ i les il·lustracions originals a il·lustracions/: fes-les servir en lloc de retallar les figures del PDF. Comença només pel capítol 1 i ensenya’m la fitxa d’especificacions abans de construir-lo.» Al costat, referencia.pdf, fonts/ i il·lustracions/ s’il·luminen a l’arbre de la carpeta a mesura que el missatge les anomena, i apareix una targeta amb «Cap. 1».

    NarracióDesprés, demana-li el que vols amb les teves paraules. Digues-li on són la referència, les tipografies i els originals, i que comenci per un sol capítol.

  12. 2:33

    A la pantallaUna quadrícula de dotze pàgines atenuades; la primera s’emmarca en daurat. Una fletxa circular hi compta les voltes de polit fins que apareix una marca, i llavors s’il·luminen les altres onze. A sota: Capítol de mostra → Polir → Estendre.

    NarracióSi el contingut és llarg, comença per un capítol de mostra. Poleix-lo fins que sigui perfecte, i només llavors estén-lo a la resta.

  13. 2:42

    A la pantallaL’agent pregunta «Còpia fidel o redisseny?», «Quines llengües?» i «Paper, pantalla o tots dos?». Una llista de tasques avança per Fer inventari, Mesurar el disseny, Extreure el text, Tipografies i imatges, Comparar pàgina a pàgina i Empaquetar el fitxer, i apareix el fitxer el-meu-llibre.postext. S’escriu una tercera petició: «El capítol 1 està aprovat. Converteix la resta de capítols amb el mateix disseny, compara cadascun amb referencia.pdf i empaqueta-ho tot en un únic fitxer .postext.» L’agent respon «✓ 12 capítols · 0 avisos · el-meu-llibre.postext».

    NarracióL’agent et farà unes preguntes: còpia fidel o redisseny, quines llengües, paper o pantalla. Després mesura, extreu, munta i comprova, i et lliura un fitxer Postext. Quan la mostra estigui bé, estendre-la al llibre sencer és només una petició més.

  14. 3:06

    A la pantallaPas 05, el sandbox: «Revisa’l pàgina a pàgina.» En una finestra de navegador s’escriu l’adreça postext.dev/ca/sandbox. El punter prem Llibres a la barra lateral, després Nou i després «Obrir un fitxer .postext…». El fitxer hi entra volant, «El meu llibre, 12 capítols · 184 pàgines» apareix a dalt de la llista i les primeres pàgines s’obren a la pestanya Canvas, al costat d’HTML, PDF, Folio i EPUB 3.

    NarracióPas cinc: obre el sandbox de Postext, a postext.dev. A Llibres, tria Nou i obre el teu fitxer.

  15. 3:14

    A la pantallaLa pàgina de referència i la de Postext queden l’una al costat de l’altra, retolades Referència i Postext, i una línia daurada les recorre de dalt a baix. S’obre el tauler Revisió amb un comptador de 3 i la llista Vídua (p. 4), Línia oberta (p. 7) i La figura no hi cap (p. 9); uns requadres vermells marquen cada problema a la pàgina de Postext.

    NarracióRevisa’l pàgina a pàgina al costat de la teva referència. El tauler Revisió t’assenyala els problemes: vídues, línies obertes, figures que no hi caben.

  16. 3:26

    A la pantallaDues files de pàgines esquemàtiques, «Referència · PDF» i «Postext · fluid». A la fila fluida, una figura passa de la primera pàgina a dalt de la segona i una línia discontínua uneix les dues posicions. Text: «Les mateixes regles, no les mateixes pàgines. El contingut flueix: una figura o un salt de pàgina poden caure en un altre lloc.» Després, un signe igual uneix cada parella de pàgines sota «El que ha de coincidir»: Marges i retícula base, Tipografia, Estil de figures i requadres, Pàgines netes: sense vídues, columnes equilibrades. Un tauler vermell amb el signe ≠ diu «Decisions artesanes a mà», amb la nota «no són regles: no serveixen per a un contingut que canvia».

    NarracióTingues en compte una cosa: les pàgines no han de ser idèntiques a les del PDF. Postext ha entès les regles de maquetació i ara el teu contingut és fluid, així que una figura o un salt de pàgina poden caure en un altre lloc. El que ha de coincidir és la qualitat: els mateixos valors de producció. Quan maquetem a mà, prenem petites decisions artesanes que no són regles. I només amb regles es pot maquetar un contingut que canvia.

  17. 3:54

    A la pantallaTorna la finestra de l’agent amb una quarta petició: «Al sandbox, capítol 2, pàgina 7: el requadre “Recorda” es parteix en dues columnes i falta el titolet. Revisió marca 3 línies obertes. Corregeix-ho i torna a empaquetar el fitxer.» S’hi adjunta una captura, captura-cap2-p7.png. Després, un bucle entre Sandbox (revisar) i Agent (corregir) fa les voltes 1 a 3 mentre el nombre d’avisos baixa de 3 a 0, i acaba amb una marca i «Perfecte.»

    NarracióDesprés explica a l’agent el que veus, amb la màxima precisió possible: el capítol, la pàgina i què falla. Una captura de pantalla ajuda. Obre la versió nova, torna a revisar i repeteix. Cada volta s’hi acosta més, fins que queda perfecte.

  18. 4:14

    A la pantalla«No només una versió Postext.» El fitxer el-meu-llibre.postext es parteix en dos per una línia daurada. A l’esquerra, Contingut (què diu): chapters/ca/02-la-cellula.md, amb el títol «La cèl·lula», una frase que cita la figura fig-celula i un requadre de tipus «recorda» que diu «La cèl·lula és la unitat mínima de vida.» A la dreta, Forma (com es veu): una plantilla deduïda del teu original, amb pàgina de 210 × 280 mm simètrica, 2 columnes amb una separació de 9 mm, text Lora 9,4/13,6 justificat, títols en Fraunces numerats, requadres «recorda» amb fons i filet, i figures a dalt de la columna.

    NarracióI això és el millor: no només tens el teu contingut a Postext. Has separat el contingut de la forma. El text viu en capítols nets; el disseny, en una plantilla amb les regles de maquetació deduïdes del teu original.

  19. 4:28

    A la pantallaS’encenen les pastilles Corregir, Ampliar i Traduir sobre una filera de pàgines: es ressalta una línia i una lluïssor recorre les pàgines, n’entren dues més i les pàgines es giren i mostren la mateixa guia en anglès. S’escriu una petició: «Afegeix una edició en anglès: tradueix els capítols, els peus de figura i els rètols dels diagrames, i mantén el mateix disseny.» Peu: «Les mateixes regles. Contingut nou. Les pàgines es componen soles.» Després, «Un fitxer, tot el llibre.»: una icona .postext es ramifica cap a una pàgina amb marques de tall (PDF per a impremta), un lector de llibres electrònics amb el text recompost a la mida de la pantalla (Llibre EPUB), una finestra de navegador (Lector web) i una parella de pàgines (Cada pàgina, composta).

    NarracióAixí, quan el teu contingut canviï, quan el corregeixis, l’ampliïs o el tradueixis, no t’hauràs de preocupar pel format. Postext el torna a compondre amb les mateixes regles. Un sol fitxer per a tot el llibre: un PDF a punt per a impremta, un llibre electrònic EPUB, un lector per al web i pàgines que es componen soles.

  20. 4:52

    A la pantallaTancament: el logotip de Postext, el lema «El tipògraf programable per al web», postext.dev, una pastilla amb «Els prompts d’aquest vídeo són a la descripció ↓» i el peu «Codi obert · MIT · github.com/drnachio/postext».

    NarracióPostext. Codi obert, a postext.dev. Tens els prompts d’exemple a la descripció.

També a YouTube: mira'l allà o a la llista de Postext.

Edita un llibre Postext amb un agent d’IA: capítols, noves edicions, adaptacions — tutorial 2Mira’l a YouTube (s'obre en una pestanya nova) · El reproductor es carrega des de YouTube quan prems reproduir.

#Què conté la skill

  • Un flux de treball:
    1. acordar l'encàrrec;
    2. inventariar l'original;
    3. mesurar el disseny en una fitxa d'especificacions;
    4. crear l'esquelet del projecte;
    5. extreure el contingut;
    6. revisar-lo i polir-lo com a Markdown de Postext;
    7. preparar fonts i imatges;
    8. verificar pàgina a pàgina;
    9. empaquetar.
  • Referències:
    • el format de document i el manifest de configuració, tots dos contrastats amb el motor;
    • el format de projecte (paquet);
    • una guia per format d'origen;
    • un mètode d'anàlisi del disseny;
    • un catàleg de casos de maquetació ja resolts: parts amb color propi, obertures de capítol, poesia, glosses al marge, notes a peu de pàgina, índexs analítics, requadres flotants, partits i imbricats, originals vectorials per a impremta, figures amb text viu, imatges en cel·les, taules apaïsades, edicions bilingües i més;
    • llibres xinesos, en horitzontal o en vertical i enquadernats per la dreta: què preguntar a l'encàrrec (escriptura, regió, direcció, enquadernació), com mesurar una retícula de caràcters, com llegir PDF verticals, el ruby i el warichu d'InDesign, la maquetació d'Àsia oriental de Word i els EPUB de dreta a esquerra, i com reduir les fonts CJK als caràcters del llibre (vegeu Composició xinesa);
    • llibres japonesos, novel·les de bunko i tankōbon en vertical i enquadernades per la dreta o llibres tècnics en horitzontal: la llengua que activa les regles japoneses (ja, mai una etiqueta xinesa), què preguntar (direcció, retícula, furigana, notes, l'ortografia de l'edició), com mesurar la caixa en caràcters i línies, el marcatge de furigana i bōten, els textos d'Aozora Bunko convertits amb aozora.py, els escanejos d'edicions de domini públic de la Biblioteca Nacional de la Dieta i les fonts japoneses reduïdes sense perdre els kana ni les formes verticals (vegeu Composició japonesa);
    • llibres àrabs, moderns o clàssics i vocalitzats, compostos de dreta a esquerra i enquadernats per la dreta: la llengua que posa tot el llibre de dreta a esquerra, què preguntar (regió i xifres, vocalització, vers, índex al final), com mesurar una pàgina emmirallada, com llegir l'àrab de PDF, Word i Wikisource, els poemes com a :::verse, les notes «(١)» per pàgina i les fonts àrabs reduïdes sense perdre les taules d'enllaç (vegeu Composició àrab);
    • còmics, manga i tires de premsa: la divisió que talla una pàgina en vinyetes, les imatges de les vinyetes amb les àncores dels personatges i les zones segures, un guió per llengua que el motor retola (bafarades, cartel·les, onomatopeies), el manga de dreta a esquerra i les edicions àrabs, i com adaptar-los a partir de dibuixos sense text i les traduccions, des de pàgines escanejades amb text o des d'un guió amb imatges generades (vegeu Còmics);
    • les tintes especials i els troquels: les planxes de tinta plana i les planxes i capes del troquelador d'un PDF o d'un IDML, l'acabat que suggereix el nom de cada tinta (metàl·lica, estampació, fluorescent, blanc opac, vernís), que es confirma amb les especificacions de la impremta, i els troquels mesurats sobre la línia de troquel (vegeu Tintes especials i troquels);
    • les pàgines compostes: les pàgines fixes de llibres de text, quaderns i revistes portades com a plantilles de pàgina amb marcs que s'omplen des del Markdown, quina ronda de port admet el Postext instal·lat i les comprovacions que ha de passar cada edició (consulta Pàgines compostes);
    • l'objecte imprès: com llegir el paper, l'enquadernació, les cobertes i el llom de l'original i traduir-los als paràmetres folio que mostra el visor Folio i que el linter comprova.
  • Scripts (Python i Node), descrits a la secció següent.

#Scripts

ScriptQuè fa
inventory.pyPrimera mirada a qualsevol original: geometria, fonts, estils en ús, imatges, pàgines que necessiten OCR; en un PDF imprès com a PDF/X, la condició de sortida i la sang, amb els paràmetres print que les reprodueixen. També enumera les planxes de tinta plana d'un PDF o d'un IDML, amb l'acabat que suggereix cada nom, i les planxes i capes del troquelador.
measure_layout.pyMarges, columnes, espai entre columnes i interlineat (la retícula de base) d'un PDF
pdf_extract.pyPDF → capítols en esborrany per rol tipogràfic (font/mida/color): ordre de lectura, paràgrafs, unió de mots partits, negretes/cursives, superíndexs i subíndexs, llistes, peus
pdf_figures.pyRetalla figures d'un PDF: fotos a resolució nativa, previsualitzacions SVG, originals vectorials en PDF per a impremta
pdf_regions.py, template_dedupe.py, anchors.pyConverteix les pàgines fixes d'un PDF (llibres de text, quaderns, revistes) en pàgines compostes: plantilles de pàgina amb marcs en mm; estils de caixa, de pestanya i de ressaltat; un fons de pàgina sense text; les imatges retallades sense el text, i un Markdown amb un bloc de pàgina (el bloc ::::page) per pàgina i una ranura per caixa, en ordre de lectura. El text amagat sota altres elements pintats es descarta. template_dedupe.py reuneix en una sola biblioteca les plantilles i els estils de les pàgines d'un mateix tipus, posa als marcs un nom segons la funció (box-light-blue, caption-of-picture) en lloc del tipus i l'ordre, i actualitza els blocs de pàgina perquè hi coincideixin. anchors.py converteix les paraules d'un mapa en àncores del recurs i línies ::label per a cada edició. Quan una passada té una sola pàgina i, per tant, no hi ha res a fusionar, el mateix pdf_regions.py extract posa nom als marcs segons la funció (--name-frames, des de postext 1.43). Des de postext 1.48 dibuixa com a vectors les línies, les targetes i les formes de la pàgina (connectors entre marcs, línies que assenyalen un punt d'una imatge, traçats) en lloc d'una imatge per pàgina, i template_dedupe.py converteix les targetes disposades en files i columnes en quadrícules que es repeteixen i cada franja de la pàgina en un mòdul. Des de postext 1.50 col·loca a més en una fila de mòduls els blocs que són l'un al costat de l'altre, deixa en una sola quadrícula les targetes que només canvien de color, cadascuna amb un aspecte amb nom, i dona als preliminars i a les pàgines del cos una sola plantilla base, el foli i el color de pàgina de la qual es dibuixen quan el bloc ::::page ho indica. Des de postext 1.51 l'esborrany demana menys retocs: cada imatge es retalla sense res més que la imatge (en queden fora les lletres amagades, els farciments veïns i els marges en blanc), la placa que la pàgina pinta sobre una foto hi queda a sobre, el text d'un requadre arriba fins a la vora del requadre, els ornaments al costat d'un titolet es mouen amb ell, els peus compostos en columnes sota les imatges tenen un marc cadascun, un color al qual el llibre ja dona nom el presta a l'aspecte que el fa servir, i els blocs que l'esborrany encadena l'un sota l'altre poden continuar formant una fila de mòduls. Les correccions a mà van a curation.json, que extract escriu buit i manifest aplica després de cada compilació, de manera que no es perden en refer: marcs corregits, eliminats o afegits, decoració eliminada, encavalcaments permesos, estils canviats i recursos afegits, cadascun amb el seu motiu; una correcció la plantilla, el marc o l'estil de la qual no existeix atura la compilació.
extract_tables.pyTaules de PDF → TableModel de Postext: les cel·les conserven l'alineació, la negreta i l'emplenament, les cel·les combinades la seva extensió, una fila de títol passa a ser el peu i l'etiqueta de la taula, una fila que travessa totes les columnes una banda de grup centrada, les files de capçalera es compten per la negreta o l'emplenament, i dues files llegides com una es tornen a separar. pdf_extract.py ja converteix les taules amb filets en recursos de taula.
pandoc_to_postext.pyDOCX, PPTX, ODT, EPUB, HTML, LaTeX, Markdown, JATS, DocBook → capítols en esborrany, amb els estils de Word assignats a requadres i estils de paràgraf
idml_extract.pyIDML d'InDesign → capítols en esborrany per estil de paràgraf, taules i imatges ancorades; el ruby, el tate-chu-yoko, els punts d'èmfasi i el warichu passen a :ruby, :tcy, :dots i :warichu, i avisa de les històries verticals i de l'enquadernació de dreta a esquerra
aozora.pyText d'Aozora Bunko (un zip o un .txt en CP932) → Markdown de Postext: furigana, bōten i línies laterals, títols amb el seu sagnat, blocs 字下げ i 地付き com a estils de paràgraf, salts de pàgina, 外字 resolts amb JIS X 0213, marques de kanbun; retorna el bloc de crèdits i un informe del que no ha pogut expressar
index_marks.pyReconstrueix un índex analític imprès com a marques :index: llegeix les pàgines de l'índex al PDF, cerca cada terme a la seva pàgina i marca les mateixes paraules als capítols
comic_panels.pyMesura pàgines de còmic: troba les vinyetes pel paper que les separa, escriu l'expressió split (d'esquerra a dreta o de dreta a esquerra, carrers inclinats inclosos), els carrers i el marc, retalla una imatge per vinyeta i imprimeix els esquelets :::page; superposa una retícula a les imatges per llegir les àncores de personatge i les zones segures, i les torna a dibuixar per comprovar-les
fonts.py, images.py, convert_assets.pyInstanciar, fer subconjunts, escalar i separar fonts (una font xinesa o japonesa retallada als caràcters del llibre conserva les formes i les mètriques verticals, i una d'àrab, les formes d'enllaç i el tatweel); passar imatges a sRGB, retallar-les i unir-les; convertir il·lustracions .ai/.pdf en SVG
preset_kit.pyCrea l'esquelet del projecte i l'script generador, construeix preset.json, empaqueta el fitxer .postext i revisa la configuració: avisa del text del llibre escrit en elements de disseny (la configuració només ha de contenir el disseny) i d'una configuració massa gran per al Sandbox
lint_project.pyDetecta tot el que l'analitzador i el carregador fan malament sense avisar i, en text xinès, japonès o coreà, els caràcters que les fonts del projecte no poden compondre; en text japonès, els kana sota una llengua xinesa, les fonts o els paràmetres xinesos, la notació d'Aozora que ha quedat als capítols i les entrades d'índex amb kanji sense lectura; en text àrab, la manca d'una llengua àrab, les fonts només llatines o sense enllaços, l'espaiat entre lletres, la partició de mots forçada i l'èmfasi en cursiva; en còmics, les expressions split que no es poden llegir, les vinyetes que no coincideixen amb les cel·les, les imatges i els estils de bafarada o de vinyeta desconeguts, les àncores de personatge mal formades, les fonts de retolació que falten al projecte i les edicions amb pàgines diferents. També assenyala el que deixa un agent: marques en línia en un text de disseny sense inlineMarks, un espai normal escrit al costat d'un espai fix, un xip en un títol amb un motor anterior a 1.52, majúscules escrites en un xip petit en lloc de :smallcaps[…] i un ::: després d'una directiva d'una línia com :::toc; la seva llista de paràmetres de configuració surt dels tipus del mateix motor
render.mjsCompon el projecte (una carpeta o un fitxer .postext) sense navegador amb el motor real, llegint-ne la configuració igual que el Sandbox, i mostra els avisos. Amb --jpeg pinta les pàgines que li demanis (--pages 12-15) com a fitxers JPEG amb el renderitzador de canvas del mateix motor, en un o dos segons, perquè l'agent pugui veure les pàgines sense generar un PDF; --out escriu el PDF. Un llibre preparat per a impremta rep línies PREFLIGHT (imatges de baixa resolució, filets fins, text petit en diverses tintes, tinta per sobre del límit, text a prop del tall), i el PDF se separa en tintes amb el perfil ICC de sortida. Una pàgina troquelada mostra les pàgines de sota dels seus forats, com a la mà.
compare_pages.pyPosa les pàgines de l'original i les de Postext l'una al costat de l'altra, a partir del PDF de la composició o de la carpeta de JPEG; amb --score mesura com s'assemblen, i amb --check la puntuació falla mentre les comprovacions encara mostrin un marc damunt d'un altre; amb --watch DIR, al costat de postext build … --images DIR --watch, torna a escriure el parell i la puntuació d'una pàgina cada vegada que aquella pàgina canvia
port_audit.pyCompara el PDF d'origen amb el PDF de l'adaptació atribut per atribut, aparellant les paraules pel seu contingut: espais especials, cursiva (inclosa una rodona inclinada), negreta, versaletes, mida i pes de les vinyetes, alineació i pes de les cel·les de taula, i els colors de folis, capçaleres i text. Escriu un informe JSON i un altre de Markdown amb un recompte per atribut i pàgina; executa'l abans de lliurar
composed_check.pyPàgines compostes: round llegeix la versió del motor instal·lat i diu quina ronda de port admet i quines funcions de les pàgines compostes li falten; check executa postext check i postext html a cada edició i falla si un marc es desborda, si hi ha plantilles o ranures desconegudes, etiquetes que no caben a la seva àncora, text escrit a la configuració o marcs que l'HTML llegeix en un ordre diferent del que segueix el Markdown en omplir-los. Des de postext 1.48 també falla si un marc queda sota un altre o surt de la seva caixa (frameCovered, frameOutsideArea) i acaba amb el nombre de solapaments; un solapament que l'original imprimeix expressament s'anota, amb el motiu, al composed-check.json del projecte. També fallen els paràmetres mal escrits i els valors que el motor no accepta (unknownConfigKey, unknownConfigValue), i s'imprimeixen tots els altres avisos. --json-out FILE desa el resultat sense perdre l'informe ni el codi de sortida, i preset_kit.py pack es nega a empaquetar mentre la revisió desada hagi fallat
postext_md.pyEl mòdul auxiliar que importen els altres scripts per escriure text en el dialecte Markdown de Postext: trams plans de marques en línia, caràcters actius escapats i paràgrafs que es llegirien com a llista, títol o bloc conservats com a text

#Instal·lació

#Qualsevol agent (skills.sh)

La CLI skills detecta els teus agents i hi instal·la la skill:

npx skills add drnachio/postext --skill postext-port

Tria agents concrets amb -a i instal·la-la per a tots els teus projectes amb -g:

npx skills add drnachio/postext --skill postext-port -a codex -a claude-code -g

El web publica la mateixa skill, així que això també funciona:

npx skills add https://postext.dev

#Plugin de Claude Code

El repositori de Postext també és un marketplace de plugins de Claude Code. Dins de Claude Code:

/plugin marketplace add drnachio/postext
/plugin install postext@postext

O des del terminal:

claude plugin marketplace add drnachio/postext
claude plugin install postext@postext

#Que la instal·li l'agent

Pots demanar-ho al teu agent, per exemple: «Instal·la la skill de Postext per portar publicacions (npx skills add drnachio/postext --skill postext-port) i fes-la servir per portar aquest PDF». Els agents que llegeixen https://postext.dev/llms.txt hi troben aquesta pàgina i l'ordre d'instal·lació.

#Eines que fan servir els scripts

python3 -m pip install pymupdf pillow fonttools brotli numpy
brew install pandoc poppler
mkdir -p ~/.cache/postext-tools && cd ~/.cache/postext-tools && npm init -y && npm i postext postext-pdf postext-citeproc react @pdf-lib/fontkit @napi-rs/canvas

Cal Pandoc per a fonts en Word, PowerPoint, EPUB i HTML, poppler per a les imatges de pàgina de la font, i numpy per a comic_panels.py. Els paquets de Node fan funcionar el renderitzador sense navegador (Node 22.15 o posterior); @napi-rs/canvas és un canvas precompilat amb què pinta les pàgines del llibre directament en JPEG. Eines opcionals: ocrmypdf per a escanejos, ImageMagick, i veraPDF per comprovar PDF/UA.

mkdir -p ~/.local/bin && curl -fL -o ~/.local/bin/postext https://github.com/drnachio/postext/releases/latest/download/postext-macos-arm64 && chmod +x ~/.local/bin/postext

Tria el fitxer del teu sistema (postext-macos-arm64, postext-macos-x64, postext-linux-x64, postext-linux-arm64, postext-linux-x64-musl, postext-windows-x64.exe); amb Node, també funciona npx postext-cli.

El cicle de treball funciona amb la línia d'ordres, un executable autònom que no cal instal·lar: l'agent manté el projecte descomprimit i deixa postext build --watch en marxa sobre les pàgines en què treballa, de manera que cada canvi apareix com a JPEG al voltant d'un segon després, fins i tot en un llibre llarg. Els paquets de Node són opcionals: executen render.mjs, que afegeix les comprovacions addicionals del Sandbox. Tots dos maqueten el llibre amb bodyText.shapingLanguage: 'host', digui el que digui la configuració, de manera que una línia pot acabar en una paraula diferent que al Sandbox (vegeu Diferències amb el Sandbox).

#Com fer-la servir

Deixa els fitxers d'origen a la teva carpeta de treball i demana l'adaptació. Per exemple:

  • «Porta els capítols 1 a 3 de manual.pdf a Postext, reproduint-ne la maquetació a dues columnes, les obertures de capítol i els requadres.»
  • «Converteix curso.docx en un llibre de Postext. Els estils "Nota" i "Actividad" són requadres.»
  • «Converteix presentacion.pptx en un dossier de Postext: les diapositives són seccions i les notes de l'orador, el text.»
  • «Tenim el paquet d'InDesign (IDML + PDF d'impremta) d'aquest manual. Construeix el preset de Postext del capítol 1 en castellà i anglès.»

Per a un llibre d'InDesign, dona a l'agent la carpeta que crea File › Package a InDesign (l'.idml, el PDF d'impremta, les fonts i les il·lustracions enllaçades). La skill en dedueix les regles de maquetació, cosa que l'importador d'IDML no fa: InDesign: importar, exportar i portar compara totes dues vies.

L'agent segueix el flux de treball:

  1. Encàrrec. Pregunta el que no pot deduir: reproducció fidel o redisseny, un capítol de mostra o el llibre sencer, llengües, impressió o pantalla, i els drets sobre textos, imatges i fonts.
  2. Inventari i mesurament. Llegeix l'original i escriu una fitxa amb les dades mesurades: format, marges, columnes, interlineat, rols tipogràfics, paleta, obertures, capçaleres, famílies de requadres i hàbits de col·locació. Classifica cada pàgina com a text corregut o com a pàgina composta (requadres, rètols i mapes en llocs fixos). Amb Postext 1.35 o posterior, agrupa les pàgines compostes per tipus i compon cada tipus a partir d'una plantilla de pàgina, de manera que la maquetació es manté idèntica i el text continua sent editable i traduïble. Amb una versió anterior, si més d'un terç de les pàgines són compostes, et pregunta si prefereixes una maquetació idèntica o un text que puguis editar i traduir.
  3. Projecte. Crea mi-libro/ amb un generador build_preset.py que conté la fitxa en forma de constants i genera preset.json.
  4. Contingut. Extreu capítols en esborrany amb l'extractor adequat i els revisa i els poleix com a Markdown de Postext: requadres, estils de paràgraf, parts, atributs d'encapçalament per a les obertures, citacions :ref, recursos de taules i figures.
  5. Verificació. Passa el linter i deixa postext build --watch en marxa sobre el projecte descomprimit: canvia un capítol o un paràmetre, mira el JPEG de la pàgina, repintat al voltant d'un segon després, i torna a canviar fins que els salts de pàgina, les figures i els requadres coincideixen amb la font pàgina a pàgina. A cada fita passa les comprovacions completes (postext check i el linter). El PDF només es genera per a les comprovacions d'impremta, no cada vegada que mira les pàgines.
  6. Lliurament. Fixa el paper, l'enquadernació i les cobertes del llibre per al visor Folio i empaqueta mi-libro.postext.

Obre el resultat al Sandbox: Llibres → Nou → Obrir un fitxer .postext…. En importar-lo, el Sandbox agafa els capítols i els textos de l'idioma en què el tens. Per treballar amb una carpeta de projectes en una còpia local de Postext, defineix POSTEXT_PRIVATE_PRESETS_DIR (consulta Sandbox).

#Carregar el resultat des del codi

El fitxer lliurat no depèn del Sandbox. El paquet postext l'obre amb openBundle, compon el llibre amb buildBundle i el renderitza en canvas, HTML o PDF (consulta Paquets). Així, una adaptació pot alimentar directament un programa. Quan cal retocar el que produeix aquest programa, torna a exportar-lo a un .postext amb createBundle, retoca'l al Sandbox i torna a carregar el fitxer corregit. El render.mjs de la skill, que compon sense navegador, accepta tant un .postext empaquetat com una carpeta de projecte.

#Què cal esperar

  • Els extractors produeixen esborranys; l'agent els revisa i els poleix. Compta que caldrà revisar cada capítol amb les pàgines originals al costat. D'aquesta revisió depèn la qualitat.
  • El text es queda al Markdown. La configuració guarda el disseny i cada paraula del llibre és als capítols, de manera que una correcció o una traducció és una edició del Markdown. Amb Postext 1.35 o posterior, les pàgines compostes són plantilles de pàgina a la configuració amb marcs que s'omplen amb el Markdown de cada capítol: un requadre creix amb una traducció més llarga i empeny els que té a sota, i des de la 1.37 els noms d'un mapa són rètols escrits al Markdown. Amb una versió anterior es munten amb requadres fixats al seu lloc, imatges de pàgina sense text i figures SVG amb rètols vius. L'informe diu quina de les dues vies ha fet servir l'agent i amb quina versió. Quan Postext no pot expressar alguna cosa sense escriure text a la configuració, l'agent s'atura, descriu el que falta en un esborrany d'incidència i t'ho pregunta. La skill no modifica mai el motor per adaptar-lo a un llibre.
  • Un sol fitxer per a tots els idiomes. Una traducció és un joc de capítols dins del mateix .postext, amb els peus i els rètols de figura propis, comprovat amb postext check en cada idioma.
  • Els drets els decideixes tu. L'agent pregunta abans de reproduir imatges o fonts amb llicències dubtoses. Les fonts amb llicència es marquen redistributable: false, així que els projectes exportats les deixen fora.
  • Fidelitat on importa. L'objectiu és la mateixa retícula, tipografia, obertures, requadres, col·locació de figures i salts de pàgina a la majoria de les pàgines (amb una diferència màxima d'una pàgina per capítol), no talls de línia idèntics.

#On és

La skill és al repositori a plugins/postext/skills/postext-port. Cobreix tots els casos que van sorgir en construir els presets del Sandbox, públics i privats. Si una adaptació es troba amb un cas que encara no cobreix, obre una incidència o una pull request que millori la skill, i la pròxima adaptació el tindrà resolt.