Saltar al contingut principal

Documentació de Postext

Índex

Tres parts: què és Postext i com està construït, l'ofici tipogràfic que automatitza i les eines amb què es fa servir.

Part I · Fonaments

  1. 1IntroduccióTemps de lectura: 7 minQuè és Postext, per què existeix i quin problema resol
  2. 2ArquitecturaTemps de lectura: 30 minCom és per dins el motor de composició tipogràfica Postext: els conceptes bàsics, l'arbre del document, el ritme vertical, els backends i el rendiment
  3. 2.1El pipeline de composicióTemps de lectura: 30 minLa passada de col·locació i les rondes que la repeteixen: com col·loca el motor les línies, els flotants, les notes i les columnes, i com torna a començar fins que la composició queda estable

Part II · L'ofici

  1. 3ConfiguracióTemps de lectura: 5 minQuè és una configuració de Postext i en quina de les vint pàgines de la referència s'explica cada grup de paràmetres
  2. 3.1Pàgina i disposicióTemps de lectura: 37 minLa mida de pàgina, els marges i la retícula de base, la numeració de les pàgines, i les columnes i l'espai que les separa
  3. 3.2Capçaleres i peus de pàginaTemps de lectura: 33 minQuè s'imprimeix a dalt i a baix de cada pàgina (text amb marcadors, filets, caixes, imatges i traçats vectorials), com canvia segons si la pàgina és parella o senar, i on es col·loca cada element
  4. 3.3Text de cosTemps de lectura: 29 minLa tipografia del text corregut: la font, la mida i l'interlineat, els colors, els sagnats, les cites, el vers, les tabulacions i les caplletres
  5. 3.4Partició de mots i llenguaTemps de lectura: 25 minCom es parteixen els mots (patrons i excepcions), com es compon el text en bandera, què fixa la llengua del document (les xifres i la direcció del text, entre altres coses) i quines escriptures sap compondre Postext
  6. 3.5EncapçalamentsTemps de lectura: 35 minEls valors per defecte dels encapçalaments, la configuració de cada nivell, els salts de pàgina abans d'un encapçalament, les obertures de capítol a tota l'amplada de la pàgina i els nombres escrits en lletres
  7. 3.6Vídues, òrfenes i equilibratgeTemps de lectura: 24 minLes regles que mantenen juntes les línies i els blocs quan una columna s’acaba, i les palanques que fan que totes les columnes acabin a la mateixa altura
  8. 3.7Llistes i matemàtiquesTemps de lectura: 19 minLes llistes amb pics i les numerades (marques, sagnats i llistes imbricades), les llistes de tasques, i la mida, el color i l'espaiat de les fórmules matemàtiques
  9. 3.8Notes i referènciesTemps de lectura: 29 minCom es configuren les notes a peu de pàgina, la numeració de línies, les referències creuades i les cites, l'índex general i l'índex analític
  10. 3.9Tipografia de l'Àsia orientalTemps de lectura: 37 minCom es configura el text xinès, japonès i coreà amb cjk: on es tallen les línies, quina amplada ocupa la puntuació, quin espai hi ha amb el text llatí, la retícula de caràcters, el ruby i les marques
  11. 3.10Recursos i taulesTemps de lectura: 47 minEls tipus de recurs i la seva numeració, els estils de taules i de peus de recurs, els diagrames a una tinta i els vídeos impresos
  12. 3.11Estils i partsTemps de lectura: 49 minCom es defineixen estils amb nom per a paràgrafs, xips, ressaltats, llistats de codi i encapçalaments, i com es dissenyen les pàgines que obren cada part del llibre
  13. 3.12RequadresTemps de lectura: 29 minCom es defineixen estils amb nom per als requadres :::callout: el marc, el fons, la franja, el títol, la icona, el marcador i la pestanya d'etiqueta; formes de caixa amb un radi per cantonada, vores per costat i pestanyes unides; els enunciats numerats; la tipografia de dins del requadre; què passa quan un requadre es parteix entre pàgines, i els dissenys dibuixats dins d'un requadre
  14. 3.13Paràmetres d'exercicisTemps de lectura: 12 minEls estils d'exercici (exerciseStyles) i els paràmetres d'exercicis del llibre (exercises): el número, la lletra de l'enunciat, les etiquetes i les caselles de les opcions, els buits, les respostes de vertader o fals, les parelles per relacionar, els bancs de paraules, els espais per escriure, les graelles, la divisió, les marques de dificultat, les icones, el color de les respostes, on s'imprimeixen les solucions, l'edició del professorat i les edicions en pantalla
  15. 3.14Paràmetres de còmicsTemps de lectura: 8 minCom es configuren els còmics: el marc i els carrers de les pàgines, els estils de vinyeta i de bafarada, la retolació i el repartiment de personatges
  16. 3.15Paràmetres de pàgines compostesTemps de lectura: 10 minLes plantilles de les pàgines compostes (marcs, grups, graelles que repeteixen un joc de marcs, mòduls, decoració i connectors, herència i variants per a pàgina senar i parella), els estils dels rètols que es posen sobre les àncores d'una imatge i els avisos que pot donar una plantilla
  17. 3.16Fonts, colors i sortidaTemps de lectura: 42 minCom s’escriuen les unitats i els colors, la paleta, les fonts personalitzades, el visor HTML, el PDF i la producció per a impremta, el visor Folio i les ajudes de depuració
  18. 3.17Ús programàticTemps de lectura: 32 minCom es fa servir Postext des del codi: buildDocument i els avisos que retorna, els valors per defecte, la càrrega de fonts, les memòries cau i el Web Worker
  19. 3.18Fitxers PDFTemps de lectura: 31 minpostext-pdf des del codi: instal·lació, l'API, els proveïdors de fonts al navegador i a Node, les fonts CJK, els bytes de recursos, el text vertical, els workers i els fitxers a punt per a impremta
  20. 3.19HTML, Folio, EPUB, SCORMTemps de lectura: 18 minCom es mostra el llibre compost dins d'una pàgina web, com es presenta com un llibre en 3D amb postext-folio, com se'n fa un EPUB 3, de maquetació fixa o fluida, amb postext-epub i com se'n fa un paquet SCORM per a un LMS amb postext-scorm
  21. 3.20Paquets .postextTemps de lectura: 30 minCom s'obren, es maqueten, es renderitzen i es creen fitxers .postext des del codi; com funcionen els paquets bilingües; com es llegeixen els fitxers de versions anteriors, i l'API de baix nivell
  22. 4Partició de mots i justificacióTemps de lectura: 45 minCom talla Postext les línies, com justifica el text i com controla l’espai entre paraules amb l’algorisme de Knuth-Plass
  23. 5Format del documentTemps de lectura: 16 minQuina part del Markdown llegeix Postext: el frontmatter, els encapçalaments, les llistes i els blocs de codi; què hi ignora, i les normes per redactar els documents font
  24. 5.1DirectivesTemps de lectura: 38 minLes directives que comencen amb ::: (contenidors, columnes, paper, salts de pàgina, numeració, espai, vers, índex general i índex analític, salts de línia) i el marcatge de les pàgines de còmic
  25. 5.2Format en línia i fórmulesTemps de lectura: 32 minCom es marca el text dins d'una línia: èmfasi, enllaços, xips, versaletes, tabuladors, text vertical, marques xineses i japoneses, direcció del text i fórmules LaTeX
  26. 5.3Notes i referènciesTemps de lectura: 15 minLes notes a peu de pàgina, les referències creuades i les àncores, les citacions i la bibliografia, i les marques de l'índex analític
  27. 5.4Imatges i taulesTemps de lectura: 48 minCom s'afegeixen imatges i taules al text: referències i insercions, numeració, col·locació i lloc on va a parar un flotant, text al voltant de les imatges, mida dels mapes de bits, zones segures, àncores de còmic i símbols als peus
  28. 5.5VídeosTemps de lectura: 10 minEls recursos de vídeo: YouTube, Vimeo, fitxers propis i fluxos HLS, què mostra cada sortida, els camps d'un vídeo, la portada i l'adreça, els reproductors, el VDT i els paquets, i els vídeos que es reprodueixen a les pàgines de Folio
  29. 6Composició xinesaTemps de lectura: 36 minCom compon Postext el xinès, en horitzontal i en vertical: regions, tall de línies, amplada de la puntuació, justificació entre caràcters, la retícula de caràcters, llibres enquadernats per la dreta, números en una casella, marques, ruby, warichu, numerals xinesos i fonts
  30. 7Composició àrabTemps de lectura: 33 minCom compon Postext l'àrab: direcció del text i algorisme bidireccional, llibres enquadernats per la dreta, paraules enllaçades que no es tallen ni s'espaien mai, justificació amb caixida, signes vocàlics, èmfasi, xifres i estils de numeració, ordinals en lletres, notes a peu de pàgina, vers clàssic, índex general, índex analític, cites i fonts
  31. 8Composició japonesaTemps de lectura: 38 minCom compon Postext el japonès, en vertical i en horitzontal: la regió Japó, kinsoku, espaiat dels yakumono, parèntesis al principi de paràgraf, formes verticals, furigana, marques d'èmfasi i línies laterals, kanbun, comptadors, títols amb gyōdori, notes, un índex en ordre gojūon, citacions, fonts i textos d'Aozora Bunko
  32. 9CòmicsTemps de lectura: 43 minCom compon Postext còmics i manga a partir de Markdown: pàgines de còmic dividides en vinyetes amb un arbre de talls, dibuixos retallats sense perdre la zona segura, retolació generada a partir d’un guió (diàleg, pensament, xiuxiueig, crit, ràdio, cartel·les, onomatopeies), estils de bafarada, àncores dels personatges sobre els dibuixos, tires dins del text, dobles pàgines, lectura de dreta a esquerra i retolació vertical, traduccions, i les sortides en canvas, PDF, HTML i EPUB
  33. 10Notació musicalTemps de lectura: 12 minCom compon Postext música dins d'un llibre: notació escrita com a text en ABC, MusicXML, MEI o Humdrum, gravada a l'amplada de la columna i dividida en sistemes que continuen per columnes i pàgines, exemples musicals numerats com a recursos, l'estil de partitura, les sortides i com hi porta les partitures una editorial de música
  34. 11ExercicisTemps de lectura: 16 minCom compon Postext els exercicis d'un llibre de text o d'un quadern d'activitats: el bloc :::exercise i els seus dotze tipus, de l'opció múltiple a la divisió, les respostes escrites al Markdown, la numeració, les solucions després de l'exercici, capgirades, al final del capítol o al final del llibre, l'edició del professorat, les comprovacions, els exercicis que es responen en pantalla en HTML i EPUB, els límits per a un examen i els resultats que s'envien a un LMS en un paquet SCORM
  35. 12Pàgines compostesTemps de lectura: 46 minCom s’escriu una pàgina composta en Markdown: el bloc de pàgina, delimitat per quatre signes de dos punts, que indica quina plantilla fa servir; els marcs i l’atribut slot, que reparteixen el contingut entre els marcs de la plantilla; les ranures repetides i els mòduls, i els avisos que surten quan el contingut no lliga amb la plantilla o tapa un altre marc
  36. 12.1Figures amb rètolsTemps de lectura: 9 minFigures que posen paraules sobre una imatge: rètols als ancoratges d'un recurs, el text alternatiu, el peu i la nota propis d'una figura, com es compon un rètol, rètols apartats del seu punt amb línies de referència, llegendes i símbols en línia, i els avisos dels rètols
  37. 13Tintes especials i troquelsTemps de lectura: 14 minCinquenes tintes, tintes metàl·liques i fluorescents, estampació en calent, blanc opac i vernís com a tintes planes amb un acabat, i troquels: forats que travessen un o més fulls, cantonades arrodonides i llibres amb forma, la línia de troquel al PDF, el preflight i com els mostra cada visor

Part III · La pràctica

  1. 14ContribuirTemps de lectura: 6 minCom unir-se a la comunitat Postext i contribuir al projecte
  2. 15SandboxTemps de lectura: 34 minCom és la interfície del Sandbox: la barra d'activitats; els taulers Text, Llibres, Capítols, Recursos i Fonts, i la disposició de la pantalla als mòbils
  3. 15.1Taulers de disseny i de revisióTemps de lectura: 45 minEl tauler Disseny (el resum, els grups, les pàgines i la cerca) i el tauler Revisió, amb els avisos en viu agrupats per tipus
  4. 15.2Pàgines compostesTemps de lectura: 21 minCom s'editen les plantilles de pàgina i els marcs directament sobre la pàgina, els connectors i les formes, les línies guia, els assenyaladors i les llegendes, les graelles, els mòduls i la seva biblioteca, com es reorganitzen els marcs, les revisions de superposició i els glifs a la pestanya, com s'ordena la biblioteca d'estils de marc, com es revisen les pàgines compostes en totes les edicions, com es passa el text al Markdown i com s'arregla un marc amb un clic
  5. 15.3PrevisualitzacionsTemps de lectura: 16 minLes pestanyes Canvas, PDF, Folio, HTML, EPUB 3 i SCORM de l'àrea de previsualització: què mostra cadascuna i què s'hi pot fer
  6. 15.4Llibres, fitxers de Word i desamentTemps de lectura: 43 minCom s'organitza un llibre en capítols, com s'editen les pàgines de còmic, com s'importen i s'exporten documents de Word, i com el Sandbox desa, exporta i importa la teva feina
  7. 15.5Agents, incrustació i presetsTemps de lectura: 13 minLes eines WebMCP per a agents d'IA; com s'integra el component PostextSandbox a la teva aplicació, amb les props i el CSS que necessita, i el format dels paquets de preset
  8. 16Llibres de pàgines compostesTemps de lectura: 22 minUn recorregut pel Sandbox amb un llibre de text escolar fet de pàgines compostes: crees una plantilla de pàgina, l’omples des del Markdown, retoles un mapa, tradueixes la pàgina, arregles el text que no hi cap i aprens a seleccionar tant a la pàgina com al text; després dibuixes un arbre amb connectors, notes sobre un mapa amb assenyaladors i una llegenda, una graella de targetes de fotos i una biblioteca de mòduls per a una col·lecció
  9. 17Passar a pàgines compostesTemps de lectura: 13 minCom passar a plantilles de pàgina i a Markdown un llibre que té el text de les pàgines dins dels estils de títol, amb l'assistent «Passar el text al Markdown» del Sandbox o a mà, què cal comprovar després i com se substitueixen per connectors les línies fixades en una imatge i per graelles i mòduls els marcs dibuixats un per un
  10. 18InDesignTemps de lectura: 9 minLes dues vies per portar un llibre d'InDesign a Postext, l'importador d'IDML, que copia el que conté el document, i la skill per a agents, que en dedueix les regles de maquetació; quan fer servir cadascuna, i com l'exportador d'IDML torna un llibre a InDesign
  11. 19SkillTemps de lectura: 10 minInstal·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
  12. 20Línia d'ordresTemps de lectura: 14 minUn sol executable autònom, per a macOS, Linux i Windows, que converteix un llibre .postext, una carpeta de llibre o fitxers Markdown solts en PDF, HTML, EPUB, imatges de pàgina i Word. També crea paquets i revisa llibres, i pot respondre en JSON per a scripts i agents, i paquets de Python i Rust el fan servir des del codi
  13. 21WebMCPTemps de lectura: 13 minQuè pot fer un agent d'IA al navegador amb les 64 eines WebMCP del Sandbox (mirar les pàgines, canviar qualsevol paràmetre, editar el text, afegir imatges, taules i fonts, fer les revisions, exportar) i com es crida cadascuna, amb arguments i respostes reals