Saltar al contingut principal

Capítol 3 · Part II · L'ofici

Configuració de Postext

Què és una configuració de Postext i en quina de les vint pàgines de la referència s'explica cada grup de paràmetres

Actualitzat 2026-11-105 minenescadefritptzhjaar

En poques paraules

Aquesta pàgina obre la referència de tots els paràmetres que controlen l'aspecte de les teves pàgines. Un sol grup de paràmetres recull totes les decisions: mida de la pàgina, nombre de columnes, fonts, mida del text, títols, requadres, colors i molt més. Només has d'escriure els paràmetres que vols canviar, perquè cadascun ja té un valor raonable. La referència està repartida en vint pàgines. La llista d'aquesta pàgina enllaça totes les seccions, així que pots anar directament a la part que necessites.

A Postext, totes les decisions de composició depenen d'un sol objecte de configuració.

PostextConfig controla les dimensions de la pàgina, la disposició de les columnes, la tipografia del text de cos, els estils dels encapçalaments, la llengua del document (locale) i molt més. Totes les propietats són opcionals: Postext porta valors per defecte raonables, inspirats en la tipografia tradicional del llibre. Només cal que indiquis el que vols canviar.

import { buildDocument } from 'postext';
 
const document = buildDocument(content, {
  page: { sizePreset: '21x28', dpi: 300 },
  layout: { layoutType: 'double', gutterWidth: { value: 0.5, unit: 'cm' } },
  bodyText: { fontFamily: 'EB Garamond', fontSize: { value: 9, unit: 'pt' } }, // 9 pt sobreescriu el valor per defecte de 8 pt
  headings: { fontFamily: 'Open Sans' },
});

Per veure en conjunt com processa el motor aquesta configuració, consulta la pàgina d'Arquitectura.

#Índex

La referència està repartida en vint pàgines. Cada grup d'aquesta llista correspon a una pàgina i va seguit de les seccions que conté.

Pàgina i disposició

Capçaleres i peus de pàgina

  • Capçaleres i peus: elements de text, filets, caixes i imatges de cada pàgina, amb marcadors, paritat, tipus de pàgina i posicionament.

Text de cos

Partició de mots i llengua

  • Partició de mots: patrons de partició, paraules que no es parteixen i text en bandera.
  • Llengua del document (el locale de primer nivell), que fixa la partició de mots de reserva, els tipus de recurs integrats, els textos de continuació de les taules i dels requadres partits i la llengua que s'etiqueta en un PDF accessible; les xifres (numerals) i la direcció del text (direction) que se'n desprenen; i les llengües i escriptures que Postext compon. La guia dels llibres de dreta a esquerra és Composició àrab.
  • Llengües i escriptures: els sistemes d'escriptura que compon Postext i les pàgines que expliquen cadascun.
  • Text àrab: la forma de les lletres, la caixida, els signes vocàlics i les xifres del text àrab.

Encapçalaments

  • Encapçalaments: valors comuns i valors propis de cada nivell, de H1 a H6.

Vídues, òrfenes i equilibratge

Llistes i matemàtiques

Notes i referències

  • Notes a peu de pàgina (footnotes): on van les notes citades amb [^id], com es numeren i quin aspecte tenen.
  • Numeració de línies (lineNumbers): un número al marge cada cinc línies dels versos o del text; què es compta, on torna a començar el compte i a quin costat van els números.
  • Referències creuades (crossRefs): les paraules que s'imprimeixen al voltant del número o de la pàgina d'un :ref, i l'estil per defecte.
  • Cites (citations): l'estil de citació i l'aspecte de les cites i de la bibliografia.
  • Enllaços en paper (links): què mostra la pàgina impresa de l'adreça d'un enllaç: res, l'adreça entre parèntesis o una nota amb l'adreça i un codi QR; i el color i el subratllat dels enllaços a les sortides que triïs.
  • Índex general: el que imprimeix :::toc (tipografia de les entrades, línies de punts, números de pàgina, línies d'autors i files de les parts).
  • Índex analític: el que imprimeix :::index (tipografia de les entrades, sagnats, separadors i intervals de pàgines, grups per inicial i llengua d'ordenació).

Tipografia de l'Àsia oriental

  • Tipografia de l'Àsia oriental (cjk): les convencions regionals i el tall de línies del text xinès, japonès i coreà, com es reparteix l'espai a les línies justificades, l'amplada de la puntuació i la puntuació penjada, l'espai entre els caràcters xinesos i el text llatí, la retícula de caràcters, els números drets en el text vertical, i les marques, el ruby, les notes warichu i les marques de kanbun. Les guies de tot plegat són Composició xinesa i Composició japonesa.

Recursos i taules

  • Tipus de recurs: numeració per tipus de les figures, les taules i els tipus personalitzats.
  • Estil de taules (amb estils de taula amb nom) i Estil dels peus de recurs: tipografia i decoració de les taules que són recursos i dels seus peus.
  • Estil dels diagrames: com es tornen a pintar amb una sola tinta els diagrames SVG incrustats, per imprimir-los amb una tinta plana.
  • Estil de partitura (scoreStyle i scoreStyles): mida del pentagrama, font musical, espaiat i números de compàs de totes les partitures.
  • Estil de vídeo (videoStyle): la marca de reproducció i el codi QR que s'imprimeixen sobre el pòster d'un vídeo, i què ofereixen els reproductors al visor HTML i a l'EPUB.

Estils i parts

  • Estils de paràgraf: estils amb nom per als contenidors :::paragraphs, com ara bibliografies, glossaris o notes.
  • Estils de xip (chipStyles): estils amb nom per al xip en línia :chip[…], com ara la caixa d'un banc de paraules, una tecla o una etiqueta.
  • Estils de caràcter (characterStyles): aspectes amb nom per a un tram de paraules escrit :span[…]{style="id"}: una lletra, un cos, un color, un espaiat entre lletres, majúscules i un estil de ressaltat que els acompanyi.
  • Estils de ressaltat (markStyles): estils amb nom per al ressaltat en línia :mark[…], és a dir, la franja que hi ha darrere d'una frase ressaltada, encara que passi a la línia següent, i una línia per sota o que la travessa.
  • Llistats de codi (codeStyle): la lletra, la caixa, l'amplada del tabulador, les línies llargues, els números de línia i els colors dels elements dels llistats ```; l'acoloriment de sintaxi i el punt d'enganxament per connectar-hi un ressaltador, i el codi en línia amb una lletra de codi.
  • Parts: les pàgines que obren les parts dels contenidors :::part (paritat, àrea del cos, disseny d'obertura i tipografia del cos).
  • Estils d'encapçalament: estils amb nom per als encapçalaments {style="…"}, com ara capítols sense numerar o preliminars amb capçaleres pròpies; geometria i paleta.
  • Estils de capítol: chapterStyles, un disseny sencer (pàgina, tipografia, colors i capçaleres) que un capítol pren en anomenar-lo al seu preàmbul (chapterStyle:), o que una part dona a tots els seus capítols (:::part{style="…"}).

Requadres

  • Estils de requadre: notes, consells i objectius dins d'una caixa, per als contenidors :::callout.

Paràmetres d'exercicis

  • Estils d'exercici (exerciseStyles): el número, la lletra de l'enunciat, les etiquetes de les opcions, els buits, els espais per escriure, les graelles, la divisió i el color de les respostes dels blocs :::exercise. Paràmetres del llibre (exercises): l'edició del professorat, on s'imprimeixen les solucions, la llavor de les barreges i les edicions en pantalla. La guia és Exercicis.

Paràmetres de còmics

  • Còmics (comics): el marc i els carrers de les pàgines de còmic, els estils de vinyeta, la retolació, els estils de bafarada i el repartiment de personatges. La guia és Còmics.

Paràmetres de pàgines compostes

  • Plantilles de pàgina (pageTemplates): els marcs, els grups i la decoració d'una pàgina composta, l'herència entre plantilles i les variants per a pàgina senar i parella. Estils de rètol (labelStyles): l'aspecte dels rètols que es col·loquen a les àncores d'una imatge. Aspectes de marc (frameLooks): jocs de colors amb nom que un tros d'una pàgina composta porta amb look="…". Tots els problemes que pot tenir una plantilla són a Avisos de les plantilles de pàgina.

Fonts, colors i sortida

  • Unitats i colors + Paleta de colors: Dimension, ColorValue, colors amb nom.
  • Fonts personalitzades: com declarar les famílies de fonts que puja l'usuari, al costat de les de Google Fonts.
  • Estils de xifres: figureStyle, xifres elzevirianes, alineades, tabulars o proporcionals a cada estil de text, amb les funcions OpenType de la font.
  • Visor HTML: l'amplada de columna desitjada i el tall de línies de la sortida HTML.
  • Visor Canvas (canvasViewer): l'espai entre les dues pàgines d'una parella i entre una fila i la següent a la pestanya Canvas del Sandbox.
  • Generació de PDF (configuració): marcadors (outlines), sortida accessible (etiquetada) i espai de color forçat per a la sortida PDF.
  • Producció per a impremta (configuració) (print): PDF/X-1a i PDF/X-4, els perfils de sortida ICC, el negre (grisos només amb K, sobreimpressió, negre enriquit), els colors definits en CMYK, el preflight i la simulació de la impressió.
  • Comprovació del contrast (configuració) (contrast): el contrast del text amb el fons al nivell AA o AAA de les WCAG, en pantalla i sobre el paper del perfil de sortida, i el text calat massa fi per imprimir-lo.
  • Comprovació del contingut (configuració) (checks.contentInConfig): avisa dels textos del disseny que contenen el text del llibre en lloc de marcadors, amb una llista de frases permeses per al títol i l'editorial.
  • Visor Folio (configuració): el paper, l'enquadernació, la superfície i la llum del visor del llibre en 3D.
  • Depuració: superposicions visuals i avisos de redacció per a l'editor.

Ús programàtic

Fitxers PDF

  • Generació de PDF (postext-pdf): proveïdors de fonts, fonts CJK, workers i fitxers a punt per a la impremta.

HTML, Folio, EPUB i SCORM

  • Integrar el visor HTML i Generació de PDF: receptes completes, de principi a fi.
  • Un llibre en 3D (postext-folio): el document compost, presentat com un llibre imprès obert sobre una taula, amb fulls que el lector pot passar.
  • Llibres EPUB: fitxers EPUB 3 de maquetació fixa i de text adaptable a partir de la mateixa maquetació, i com comprovar-los amb EPUBCheck.
  • Paquets SCORM: capítols i seccions com a SCO per a un sistema de gestió de l'aprenentatge, amb exercicis que envien les seves puntuacions.

Paquets .postext