Capítol 10 · 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-048 minenescazhar

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 línies de base, tipografia, obertures, cornises, 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 apareixen quan una pàgina es compon malament. La skill postext-port empaqueta aquest coneixement juntament amb les eines amb què construïm cada preset del sandbox, perquè el teu agent faci el port bé.

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 seves etiquetes: InDesign (IDML), Word (DOCX) i PDF. S'agrupen a l'esquerra, una fletxa daurada discontínua passa per una insígnia «Agent d'IA» i apareix una icona de fitxer, mi-libro.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 s'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:35

    A la pantallaPas 01, la carpeta: «Un projecte, una carpeta.» Una carpeta gran, mi-libro/, sura entre deu fitxers solts com MinionPro-Regular.otf, portada.jpg, fig-2-1.ai, capitulo-01.docx, mapa.svg, libro.idml i grafico.pdf. S'obre una finestra amb l'arbre de la carpeta i cada fitxer vola a la seva subcarpeta quan se l'anomena: referencia.pdf (com ha de quedar, pas 03), fuentes/ (Minion Pro, Myriad…, .otf .ttf .woff2), imagenes/ (fotografies, .jpg .png), ilustraciones/ (originals vectorials, .ai .svg .pdf) i textos/ (Word, InDesign IDML…).

    NarracióPas u: reuneix-ho tot en una sola carpeta al teu 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 fuentes/ 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, «Com més ordenada, 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 ordenada sigui 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 en 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, cerca 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 en ampliar-se; a la dreta, «L'original: el dibuix mateix» continua nítid. El tauler esquerre s'apaga, els rètols de l'original es reescriuen en anglès (Manuscript, Template, Pages), unes marques de tall l'emmarquen i tres marques 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:37

    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 s'ha de veure el producte final. L'ideal és un PDF.

  9. 1:47

    A la pantallaSobre la pàgina apareixen les mesures: el contorn de les columnes, un espai entre columnes 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, ficha-de-especificaciones.md, es va omplint: pàgina 210 × 280 mm; marges 24 · 20 · 22 · 20 mm, simètrics; 2 columnes, espai entre columnes 9 mm; retícula de base 13,6 pt; text Lora 9,4 / 13,6 pt, justificat; títols Fraunces 28 pt · Geist; obertures amb banda de color de 101 mm; requadres amb fons i filet esquerre. Després la paraula «Endevinar» es ratlla 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 referència, mesura.

  10. 2:03

    A la pantallaPas 04, l'agent: «Demana-ho amb les teves paraules.» S'obre una finestra titulada «Agent · ~/mi-libro» al costat de les insígnies Claude Code, Codex i «o qualsevol altre agent». A la finestra s'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 facis servir, en aquella carpeta, i demana-li que instal·li la skill de Postext. Una skill és un paquet de coneixement expert. Aquesta ensenya a l'agent a convertir una publicació a Postext, i li dona eines per revisar la seva pròpia feina.

  11. 2:24

    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 fuentes/ i les il·lustracions originals a ilustraciones/: 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, fuentes/ i ilustraciones/ 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:37

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

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

  13. 2:46

    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 mi-libro.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 · mi-libro.postext».

    NarracióL'agent et farà unes quantes 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:11

    A la pantallaPas 05, el sandbox: «Revisa-ho 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 vista Canvas.

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

  15. 3:20

    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-ho 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:31

    A la pantallaDues files de pàgines esquemàtiques, «Referència · PDF» i «Postext · fluid». A la fila fluida, una figura viatja de la primera pàgina al capdamunt de la segona i una línia discontínua uneix les seves 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 de base, Tipografia, Estil de figures i requadres, Pàgines netes: sense vídues, columnes equilibrades. Un tauler vermell amb el signe ≠ diu «Decisions artesanals fetes a mà: no són regles, no serveixen per a contingut que canvia».

    NarracióTingues en compte una cosa: les pàgines no han de ser per força 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 d'artesania que no són regles. I només amb regles es pot maquetar un contingut que canvia.

  17. 4:01

    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 hi falta la cornisa. 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 hi ajuda. Obre la nova versió, torna a revisar i repeteix. Cada volta s'hi acosta més, fins que queda perfecte.

  18. 4:20

    A la pantalla«No només una versió Postext.» El fitxer mi-libro.postext es parteix en dos per una línia daurada. A l'esquerra, Contingut (què diu): chapters/es/02-la-celula.md, amb el títol «La cèl·lula», una frase que cita la figura fig-celula i un requadre «recorda». 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 espai entre columnes de 9 mm, text Lora 9,4/13,6 justificat, títols en Fraunces numerats, requadres «recorda» amb fons i filet, i figures al capdamunt 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:35

    A la pantallaS'encenen les pastilles Corregir, Ampliar i Traduir sobre una fila de pàgines: es ressalta una línia i un esclat recorre les pàgines, entren dues pàgines més i les pàgines es giren per mostrar l'edició 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: «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), 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 lector per a la web i pàgines que es componen soles.

  20. 4:57

    A la pantallaTancament: el logotip de Postext, el lema «El tipògraf programable per a la 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.

#Què conté la skill

  • Un flux de treball:
    1. acordar l'encàrrec;
    2. inventariar la font;
    3. mesurar el disseny en una fitxa d'especificacions;
    4. crear l'esquelet del projecte;
    5. extreure el contingut;
    6. curar-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 (bundle);
    • 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, vers, glosses al marge, notes a peu de pàgina, índexs analítics, requadres flotants, dividits i niats, 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 retallar les fonts CJK al llibre (vegeu Composició xinesa);
    • llibres àrabs, moderns o clàssics i vocalitzats, compostos de dreta a esquerra i enquadernats per la dreta: la llengua que gira el llibre, 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 retallades amb les seves taules d'enllaç (vegeu Composició àrab);
    • l'objecte imprès: com llegir el paper, l'enquadernació, les cobertes i el llom de la font i fixar-los a la configuració folio que mostra el visor Folio, comprovats pel linter.
  • Scripts (Python i Node), descrits a la secció següent.

#Scripts

ScriptQuè fa
inventory.pyPrimera mirada a qualsevol font: geometria, fonts, estils en ús, imatges, pàgines que necessiten OCR
measure_layout.pyMarges, columnes, espai entre columnes i interlineat (la retícula de línies de base) d'un PDF
pdf_extract.pyPDF → capítols en esborrany per rol tipogràfic (font/cos/color): ordre de lectura, paràgrafs, eliminació de guionets, 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
extract_tables.pyTaules de PDF → TableModel de Postext
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
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
fonts.py, images.py, convert_assets.pyInstanciar, fer subconjunts, escalar i separar fonts (una font xinesa retallada als caràcters del llibre conserva les seves formes i 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 el projecte i el seu script generador, construeix preset.json i empaqueta el .postext
lint_project.pyDetecta tot el que el parser i el carregador fan malament en silenci i, en text xinès, japonès o coreà, els caràcters que les fonts del projecte no poden compondre; 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
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, així que l'agent mira les seves pàgines sense generar un PDF; --out escriu el PDF
compare_pages.pyPosa les pàgines de la font i de Postext l'una al costat de l'altra, a partir del PDF de la composició o de la seva carpeta de JPEG

#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
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, i poppler per a les imatges de pàgina de la font. Els paquets de Node mouen 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.

#Com fer-la servir

Deixa els fitxers d'origen a la teva carpeta de treball i demana el port. 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.»

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 la font i escriu una fitxa de dades mesurades: format, marges, columnes, interlineat, rols tipogràfics, paleta, obertures, cornises, famílies de requadres i costums de col·locació.
  3. Projecte. Crea mi-libro/ amb un generador build_preset.py que desa la fitxa com a constants i produeix preset.json.
  4. Contingut. Extreu capítols en esborrany amb l'extractor adequat i els cura 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, compon el projecte sense navegador, pinta com a JPEG les pàgines en què està treballant i les mira, i les compara amb la font pàgina a pàgina fins que coincideixen els salts de pàgina, les figures i els requadres. El PDF es genera per a les comprovacions d'impremta, no per a cada revisió.
  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…. La importació pren els capítols i textos de l'idioma del sandbox. 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 el que produeix aquest programa necessita ajustos, 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 cura. Compta amb una revisió per capítol contrastada amb les pàgines originals. Aquesta revisió és la que dona la qualitat.
  • Només configuració i Markdown. La skill mai no modifica el motor per encaixar-hi un llibre. Quan Postext no pot expressar alguna cosa, l'agent tria l'expressió més propera i l'anota com a diferència coneguda.
  • 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 un marge 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 un port es troba amb un cas que encara no cobreix, obre una incidència o una pull request que millori la skill, i el port següent el tindrà resolt.