Saltar al contenido principal

Capítulo 3.1 · Parte II · El oficio

Configuración: página y disposición

El tamaño de página, los márgenes y la rejilla base; la numeración de las páginas, y las columnas y sus medianiles.

Actualizado 2026-11-1037 minEn el capítulo 3 Configuraciónenescadefritptzhjaar

En pocas palabras

Esta página reúne los ajustes de la propia hoja. Eliges el tamaño de página, los márgenes, el lado por el que se encuaderna el libro y la rejilla sobre la que se apoyan las líneas de texto. Decides cómo se cuentan y cómo se escriben los números de página. Decides cuántas columnas tiene la página y cuánto espacio las separa, y si el texto va en líneas horizontales o verticales. Las cabeceras y los pies de página se explican en otra página.

#Página

La propiedad page controla las dimensiones físicas y la apariencia de la página.

PropiedadTipoPor defectoDescripción
sizePresetPageSizePreset'17x24'Tamaño de página predefinido. Con 'custom', se usan el ancho y el alto indicados.
widthDimension17 cmAncho de la página. Si no se indica, se toma de sizePreset; un valor explícito siempre tiene prioridad (usa sizePreset: 'custom' para un tamaño totalmente personalizado).
heightDimension24 cmAlto de la página. Si no se indica, se toma de sizePreset; un valor explícito siempre tiene prioridad.
marginsPageMargins2 cm arriba y abajo, 1.5 cm a izquierda y derechaEspacio entre el borde de la página y el área de contenido. Cada lado (superior, inferior, izquierdo, derecho) se fija por separado. Con mirror: true, los márgenes son simétricos: left es el margen interior (el del lomo) y right, el exterior; las páginas impares (la página 1 es impar) los mantienen tal como se escriben y las pares los intercambian, de modo que el área de contenido (y con ella las columnas, las bandas de flotantes, los contenedores de la cabecera y el pie y las bandas de apertura) cambia de posición en cada doble página. Por defecto, false. Véase más abajo.
backgroundColorColorValuetransparentColor de fondo de la página.
dpinumber300Los píxeles por pulgada con los que trabaja la maquetación, es decir, cómo se convierten en píxeles las unidades físicas (cm, mm, in, pt). Un mapa de bits sin resolución propia ocupa un píxel de maquetación por cada píxel de la imagen, así que se imprime a esta resolución: deja 300 para imprenta, o da una resolución a las imágenes (Resource.bitmap.resolution, layout.bitmapResolution; véase Formato del documento › Tamaño de los mapas de bits). La verificación previa (preflight) comprueba la resolución efectiva de cada imagen.
cutLinesCutLinesConfigdesactivadoMuestra marcas de corte en las esquinas de la página para el guillotinado. Si se activa, el canvas se amplía para incluir la zona de sangrado y las marcas de corte. Véase más abajo.
baselineGridBaselineGridConfigdesactivadoDibuja la rejilla base sobre las páginas, para comprobar el ritmo vertical. La maquetación se ajusta a la rejilla tanto si se dibuja como si no. pdfGeneration.baselineGrid: false la deja fuera del PDF. Véase más abajo.
pageNumberingPageNumberingConfigformat: 'decimal', startAt: 1Cómo se escriben los números de página y el valor con el que empieza el contador. Véase Numeración.
binding'auto' | 'left' | 'right''auto'El borde por el que se encuaderna el libro. 'auto' equivale a 'right' cuando layout.writingMode es 'vertical-rl', cuando el documento va de derecha a izquierda (direction) o cuando su sección comics se lee de derecha a izquierda (un manga, una edición japonesa o en chino tradicional), y a 'left' en los demás casos. Un libro encuadernado por la derecha empieza en una página izquierda e invierte los márgenes simétricos. Afecta a todo el libro: el layout propio de un estilo de encabezado no lo cambia. Véase Encuadernación.

#Márgenes simétricos (espejo)

Los libros se leen por dobles páginas, y el margen interior suele ser distinto del exterior. margins.mirror convierte los cuatro márgenes en márgenes simétricos:

{
  "page": {
    "margins": {
      "top": { "value": 2, "unit": "cm" },
      "bottom": { "value": 2.5, "unit": "cm" },
      "left": { "value": 2.2, "unit": "cm" },
      "right": { "value": 1.4, "unit": "cm" },
      "mirror": true
    }
  }
}

Con esta configuración, todas las páginas impares tienen 2,2 cm de margen a la izquierda (el lomo) y 1,4 cm a la derecha (el corte), y todas las pares, 1,4 cm a la izquierda (el corte) y 2,2 cm a la derecha (el lomo). Cada página maquetada tiene su propio contentArea en la VDTPage, así que todo lo que se deriva de él (las columnas, las bandas de flotantes a todo el ancho, los contenedores de la cabecera y el pie, y las bandas de apertura con span: 'page') sigue automáticamente la geometría simétrica. Los marcos de página y de sangrado que usan los elementos de diseño anclados a 'page' / 'bleed' no cambian: describen la hoja física, no los márgenes.

#Encuadernación

«Los documentos chinos compuestos en vertical se encuadernan por el lado derecho, y los compuestos en horizontal por el izquierdo» (clreq §7.1.1.1). page.binding: 'right' compone un libro para el borde derecho:

  • La página 1 sigue siendo impar, y sigue siendo la página impar (recto), así que breakBefore.parity, :::pagebreak{parity}, los elementos de diseño con parity y todos los recuentos de páginas conservan su sentido. Lo que cambia es el lado en el que queda la página impar: la página izquierda de la doble página. Un capítulo que empieza en una página impar nueva empieza en una página izquierda (clreq §7.1.3.3).
  • Con margins.mirror, left sigue siendo el margen interior, pero son las páginas impares las que intercambian los márgenes: la página 1 tiene el margen interior a la derecha, y la 2, a la izquierda. La columna lateral de oneAndHalf en 'outer' / 'inner', un flotante girado que se apoya en el lomo, los márgenes de las páginas de parte y los iconos de esquina 'outer' / 'inner' de los recuadros siguen la misma regla.
  • El documento lo indica (VDTDocument.binding: 'right'), así que una aplicación nunca tiene que leer la configuración: el Sandbox muestra las dobles páginas como [3 | 2], con la página 1 sola a la izquierda del lomo, y su visor HTML ordena las páginas de derecha a izquierda, se abre por el extremo derecho y la flecha izquierda pasa a la página siguiente. renderToHtml, en modo múltiple, ordena la fila de derecha a izquierda.
  • El PDF incluye /ViewerPreferences << /Direction /R2L >> y /PageLayout /TwoPageRight (la página 1 sola y luego por pares), esté etiquetado o no. Acrobat y Foxit los respetan; el visor integrado de Chrome no tiene en cuenta ninguno de los dos.

Los folios y los titulillos no cambian de lado por sí solos: una plantilla que pone el número de página en la esquina exterior necesita sus elementos de página par e impar preparados para la encuadernación por la derecha (los elementos admiten parity).

Un libro escrito de derecha a izquierda (árabe, persa, hebreo…) también se encuaderna por la derecha: 'auto' da el borde derecho cuando la direction del documento se resuelve en 'rtl'. Un libro así, además, invierte todo su flujo: su primera columna es la de la derecha, y sus sangrías, marcas de lista, flotantes y notas quedan a la derecha; las zonas de la cabecera y del pie conservan sus lados físicos. Consulta Composición árabe.

Un cómic que se lee de derecha a izquierda también se encuaderna por la derecha: 'auto' da el borde derecho cuando la configuración tiene una sección comics cuyo sentido de lectura se resuelve en 'rtl'. Es el caso de un manga (comics.artDirection: 'rtl') y de una edición japonesa o en chino tradicional de un cómic occidental. Decide la sección, para todo el libro, y no los bloques :::page de un capítulo. Consulta Cómics.

#Tamaños de página predefinidos

PresetAnchoAltoUso habitual
'11x17'11 cm17 cmLibros de bolsillo
'12x19'12 cm19 cmRústica estándar
'17x24'17 cm24 cmLibros técnicos, manuales
'21x28'21 cm28 cmRevistas, informes (cerca de A4)
'broadsheet'375 mm597 mmPeriódicos de formato sábana
'berliner'315 mm470 mmPeriódicos de formato berlinés
'tabloid'280 mm430 mmTabloides
'compact'297 mm420 mmPeriódicos compactos (una sábana doblada por la mitad)
Tamaños de página predefinidosCuatro tamaños de página predefinidos dibujados a escala proporcional: bolsillo 11x17, rústica 12x19, técnico 17x24 y casi A4 21x28 cm.21×28 · ~A417×24 · Técnico12×19 · Rústica11×17 · Bolsillo21 cm28 cm
Tamaños predefinidos dibujados a escala proporcional.

Los cuatro formatos de periódico son nuevos en postext 1.18 y no aparecen en el dibujo: una página sábana tiene casi cuatro veces la superficie de una de 21 × 28. Suelen maquetarse con la disposición 'multiple': lo habitual son seis columnas en una sábana y cinco en un tabloide.

#Rejilla base

La rejilla base marca el ritmo del texto base: líneas separadas por el interlineado del texto base, contadas desde el borde superior del área de contenido. La maquetación la usa tanto si se dibuja como si no: los encabezados, los finales de lista, los recuadros, las figuras y las fórmulas en bloque devuelven el texto a la rejilla (salvo que tengan desactivado su propio snapToGrid), de modo que las líneas de las columnas vecinas quedan alineadas. enabled solo dibuja las líneas, en el canvas, en el PDF y en las vistas del Sandbox, para comprobar ese ritmo; activarla o desactivarla no mueve nada. Las líneas solo cubren el texto real de la página (desde la primera línea de texto hasta la última), así que las bandas de flotantes, las páginas en blanco de paridad y el espacio sobrante del final no muestran la rejilla.

PropiedadTipoPor defectoDescripción
enabledbooleanfalseSi se dibujan las líneas de la rejilla (en el canvas y en el PDF). Solo afecta al dibujo: la maquetación es la misma en ambos casos.
colorColorValue#ccccccColor de las líneas de la rejilla.
lineWidthDimension0.5 ptGrosor de las líneas de la rejilla.

Dónde empieza un bloque lo decide su estilo. Cada estilo que puede empezar en una línea de la rejilla tiene un interruptor snapTopToGrid, apagado por defecto: headings (y un nivel o un estilo de título), bodyText, paragraphStyles[], calloutStyles[], las listas, math y resourceTypes[]. Encendido, el espacio sobre el bloque se redondea hasta la siguiente línea de la rejilla, termine como termine el bloque anterior. La cabeza de una columna está siempre en la rejilla.

page: {
  baselineGrid: { enabled: true, color: { hex: '#e0e0e0', model: 'hex' } }
}

#Marcas de corte

Al activarlas, el canvas se amplía para incluir una zona de sangrado, y el motor dibuja marcas de corte en cada esquina para la producción impresa. El PDF da a cada página una TrimBox y una BleedBox; un archivo PDF/X las incluye aunque no haya marcas de corte. En el Sandbox se configuran en Exportación › Preparación para imprenta.

PropiedadTipoPor defectoDescripción
enabledbooleanfalseSi se amplía el canvas con el sangrado y se dibujan las marcas de corte.
bleedDimension3 mmZona adicional alrededor de la página que se usa como sangrado de impresión.
markLengthDimension5 mmLongitud de cada marca de corte.
markOffsetDimension3 mmSeparación entre el borde de corte y el inicio de cada marca. Una marca nunca empieza dentro del sangrado: si bleed es mayor, la marca empieza en el borde del sangrado.
markWidthDimension0.25 ptGrosor de las marcas de corte.
colorColorValue#000000Color de las marcas de corte en el canvas (la vista previa en pantalla). El PDF siempre las pinta en color de registro (véase más abajo).

La hoja crece bleed + markOffset + markLength por cada lado, y la página cortada queda en el centro. Cada esquina del corte lleva dos marcas de markLength de largo, cada una en la prolongación de uno de los bordes que se encuentran en ella. Una marca empieza a markOffset del corte, o en el borde del sangrado si bleed es el mayor de los dos, para que ninguna marca caiga sobre una imagen que llega hasta el sangrado. Con los valores por defecto (3 mm de sangrado y 3 mm de separación), las marcas van de 3 a 8 mm por fuera del corte, y alrededor de la hoja, por fuera de ellas, queda una franja en blanco de 3 mm. cropMarkSegments(page, doc.config.page, doc.trimOffset) devuelve las ocho marcas de una página en píxeles de página, las mismas que dibujan los backends de canvas y de PDF. El tercer argumento es la posición del corte dentro de la hoja, el valor a partir del cual se escribe el TrimBox del PDF; si no se indica, se calcula a partir de cutLines del mismo modo.

Fuera del sangrado solo se imprimen las marcas. Todo lo que pinta la página, incluidos los elementos de diseño anclados a 'page' o a 'bleed', se recorta a la caja de sangrado en el canvas, en el PDF y en la salida HTML, igual que lo recorta la exportación de un programa de maquetación: una banda o una imagen que se sale a propósito del sangrado se corta en su borde, donde la guillotina la cortaría de todos modos. Hasta postext 1.4, un elemento así seguía por encima de las marcas hasta el borde de la hoja.

En el PDF (postext-pdf), la MediaBox de cada página es la hoja entera. La página incluye además una TrimBox, la página cortada, y una BleedBox, el corte más el sangrado, que leen las herramientas de imposición y de verificación previa. Las marcas se pintan en color de registro, la separación /All, para que se impriman en todas las planchas. Esto se cumple sea cual sea el espacio de color en que se escriba el PDF (RGB, escala de grises o CMYK): un negro normal llegaría a la imprenta como negro enriquecido o solo en la plancha del negro. color solo se aplica al canvas.

#Numeración

El bloque page.pageNumbering controla el formato de los números de página y el valor con el que empieza el contador. Solo define el valor por defecto de todo el documento; para reiniciar la numeración a mitad del documento (por ejemplo, para pasar de los números romanos de las páginas preliminares a los capítulos numerados en decimal desde 1), usa la directiva :::numbering (véase Formato del documento → Directivas).

PropiedadTipoPor defectoDescripción
format'decimal' | 'lower-roman' | 'upper-roman' | 'lower-alpha' | 'upper-alpha', o un estilo de Asia oriental'decimal'Estilo de numeración de las páginas. Los estilos de Asia oriental ('trad-chinese-informal' numera las páginas 一, 二, 三) se enumeran en Grafías de los formatos de numeración.
startAtnumber1Valor numérico que recibe la primera página, sea cual sea el formato. format: 'lower-roman', startAt: 1 da i, ii, iii, …; format: 'decimal', startAt: 17 da 17, 18, 19, ….

El número calculado se guarda en cada VDTPage como pageLabel, y es el valor por el que se sustituye el marcador {pageNumber} en las cabeceras y los pies. Los PDF incluyen un árbol /PageLabels, para que el indicador de página y la función «Ir a la página» de Vista Previa o de Acrobat coincidan exactamente con los números impresos. Un estilo que no tiene código en PDF (los numerales chinos, las cifras en círculo y las de ancho completo) se escribe página a página, así que el lector también muestra 一, 二, 三.

Grafías de los formatos de numeración

Hay tres ajustes que eligen un formato de numeración, y cada uno ha acabado con su propia grafía: las páginas (page.pageNumbering.format y :::numbering{format=…}) dicen lower-roman; las listas numeradas (orderedLists.numberFormat), arabic para el decimal, y los tipos de recurso (counterFormat), roman-lower. Todos aceptan todas las grafías de la tabla, así que un formato copiado de un ajuste funciona en los demás. Los nombres no distinguen mayúsculas de minúsculas; las formas de un solo carácter, sí (i e I son distintas).

FormatoImprimeGrafías aceptadas
Decimal1, 2, 3decimal, arabic, 1
Romano en minúsculasi, ii, iiilower-roman, roman-lower, i
Romano en mayúsculasI, II, IIIupper-roman, roman-upper, I
Alfabético en minúsculasa, b, clower-alpha, alpha-lower, lower-latin, a
Alfabético en mayúsculasA, B, Cupper-alpha, alpha-upper, upper-latin, A
Numerales chinos, simplificado一, 十二, 一百零一simp-chinese-informal, 一 en un documento en chino simplificado
Numerales chinos, tradicional一, 十二, 一萬trad-chinese-informal, cjk-ideographic, 一 en un documento en chino tradicional
Numerales chinos financieros, simplificado壹, 壹拾贰, 壹佰贰拾simp-chinese-formal, 壹 en un documento en chino simplificado
Numerales chinos financieros, tradicional壹, 壹拾貳, 壹佰貳拾trad-chinese-formal, 壹 en un documento en chino tradicional
Cifras chinas一二〇, 二〇二六cjk-decimal, 〇
Troncos celestes甲, 乙, 丙 … 癸cjk-heavenly-stem, 甲
Ramas terrestres子, 丑, 寅 … 亥cjk-earthly-branch, 子
Numerales japoneses一, 十二, 百一, 一万一japanese-informal, 一 en un documento japonés
Numerales japoneses formales壱, 壱拾弐, 壱百japanese-formal, 壱
Hiragana, orden gojūonあ, い, う … ん, ああhiragana, あ
Katakana, orden gojūonア, イ, ウ … ン, アアkatakana, ア
Hiragana, orden irohaい, ろ, は … す, いいhiragana-iroha, い
Katakana, orden irohaイ, ロ, ハ … ス, イイkatakana-iroha, イ
En círculo①, ②, ③ … ㊿circled-decimal, ①
Cifras de ancho completo1, 2, 3fullwidth-decimal, 1
Cifras arábigo-índicas١, ٢, ٣ … ١٠arabic-indic, ١
Cifras persas۱, ۲, ۳ … ۱۰persian, urdu, ۱
Letras árabes, orden abyadأ, ب, ج, د, هـ … غ, أأabjad, أبجد
Letras árabes, orden alfabéticoأ, ب, ت, ث … ي, أأhijai, arabic-alpha, arabic-alphabetic, أبتث
Numerales abyadا, ب … يا (11), غتمو (1446)arabic-abjad
Numerales abyad, valores magrebíesص (60), ض (90), ش (1000)arabic-abjad-maghrebi, maghrebi-abjad

Los estilos de Asia oriental conservan en los tres ajustes su nombre de CSS Counter Styles. Los numerales chinos informales escriben 十 para los números del 10 al 19 sin un 一 delante (十二, pero 一百一十), un solo 零 por cada serie de ceros dentro del número (一百零一, 一千零五十), y 万 o 萬 para la decena de millar, y 亿 o 億 para los cien millones (一万零一十). Solo cjk-decimal usa 〇, cifra a cifra, como se escriben los años (二〇二六, GB/T 15835—2011). Los troncos llegan hasta el 10, las ramas hasta el 12 y las cifras en círculo hasta el 50; a partir de ahí, el número se imprime en cifras. 一 y 壹 siguen la escritura del locale del documento: tradicional para zh-Hant, zh-TW o zh-HK, y simplificada en los demás casos. Algunas ediciones antiguas escriben 101 como 一百一, sin 零; Postext no imprime esa forma.

Los estilos japoneses (desde postext 1.16) también siguen CSS Counter Styles. japanese-informal escribe 十 sin 一 delante y sin 零 para una posición vacía (百一, 千十), y japanese-formal, los 大字 壱 弐 参 拾 百 阡, con 壱 delante de cada unidad (壱拾, 壱百). CSS detiene los dos en 9999; Postext sigue por grupos de cuatro cifras con 万 億 兆 (en el formal, 萬 億 兆), y cada grupo conserva su 一 delante de una unidad: 一万一 es 10 001, y 一億一万, 100 010 000. En un documento japonés (ja, ja-JP…), 一 significa japanese-informal, así que 第{1:一}章 imprime 第百一章 en ese documento y 第一百零一章 en uno chino; 壹 sigue siendo el de los numerales formales chinos. Las series de kana son las listas de CSS: 48 kana en el orden del gojūon (incluidos ゐ y ゑ) y 47 en el del poema iroha; tras el último siguen con dos kana (ああ, いい), y no tienen cero, así que un elemento numerado con 0 imprime 0. Las cifras kanji posicionales (二〇二六), la forma de los años y los folios, corresponden a cjk-decimal.

Los estilos árabes conservan el nombre de CSS cuando existe (arabic-indic, persian; urdu y maghrebi-abjad, de la nota del W3C Ready-made Counter Styles, se leen como persian y arabic-abjad-maghrebi). arabic mantiene su sentido de siempre: las cifras europeas. arabic-abjad escribe los numerales abyad aditivos del árabe clásico y de la foliación de los manuscritos, con el valor más alto primero: 11 es يا, 1446 es غتمو, y el número de millares va antes de غ (2000 بغ, 1002 غب); por encima de 999 999, el número se imprime en cifras. La nota del W3C usa ese nombre para una serie de 28 letras en la que 11 es ك; Postext llama abjad a esa serie, la que se usa para numerar con letras los elementos de una lista en orden abyad (أ، ب، ج، د، هـ), y hijai, al orden alfabético (أ، ب، ت، ث). Las dos escriben la primera letra con su hamza (أ), y una he que quedaría aislada, como هـ, con tatweel, para que ninguna se lea como las cifras ١ y ٥; pasadas las 28 letras, se duplican, como hace lower-alpha (أأ, أب). Los valores magrebíes siguen la regla mnemotécnica صعفض قرست ثخذ ظغش (ص 60, ض 90); la lista del W3C intercambia ص y ض. Una sola أ no permite distinguir las dos series de letras, así que su forma abreviada son sus cuatro primeras letras: {1:أبجد}, {1:أبتث}. Las cifras del propio documento se eligen con numerals.

Las demás grafías existen para las configuraciones cuyos tipos nadie comprueba: los presets en JSON y el JavaScript sin tipos. Los tipos de TypeScript solo incluyen la grafía propia de cada ajuste (la que escribe el Sandbox y guarda la configuración resuelta (doc.config), incluidos los nombres de Asia oriental), así que un PostextConfig tipado se ciñe a ella, y cualquier otra grafía necesita una conversión de tipo explícita.

// JavaScript o un preset en JSON (en TypeScript, la grafía propia de cada ajuste)
orderedLists: { numberFormat: 'decimal' },          // igual que 'arabic'
page: { pageNumbering: { format: 'roman-lower' } }, // igual que 'lower-roman'
resourceTypes: [{ id: 'lamina', counterFormat: 'upper-roman', … }], // igual que 'roman-upper'

La resolución de la configuración (doc.config) convierte los formatos de las listas y de las páginas a la grafía de su propio ajuste ('decimal' se resuelve como 'arabic' en orderedLists, y 'roman-lower', como 'lower-roman' en page.pageNumbering), y stripConfigDefaults elimina cualquier grafía del valor por defecto. Los paneles del Sandbox muestran cada uno de los tres ajustes con su propia grafía, sea cual sea la que use la configuración. Cualquier otro valor (roman, 01, una errata) numera en decimal en lugar de imprimir undefined, y genera un aviso de configuración. Las plantillas de numeración de los encabezados aceptan los mismos nombres tras los dos puntos ({1:roman-upper} equivale a {1:I}), además de su propio {1:01}, con cero a la izquierda.

#Disposición

La propiedad layout controla cómo se organizan las columnas dentro del área de contenido.

Columnas, medianil y margenUna página dividida en tres columnas: cada columna es el área de contenido del texto; los medianiles, los huecos verticales entre columnas, y el margen, el blanco que queda entre el borde de la página y la primera columna.PáginaMargenColumnaMedianil
Las columnas contienen el texto. Los medianiles las separan. Los márgenes enmarcan el contenido.
Sistema de márgenesUna página con márgenes superior, derecho, inferior e izquierdo independientes alrededor del área de contenido.PáginaÁrea de contenidosup.1cminf.2cmizq.2.5cmder.1.5cm
Cada lado de la página puede tener su propio margen.
PropiedadTipoPor defectoDescripción
layoutType'single' | 'double' | 'oneAndHalf' | 'multiple''double'Disposición de las columnas. Los tipos se describen más abajo.
columnCountnumber3En cuántas columnas iguales divide el texto una disposición 'multiple': un número entero de 3 a 8. Un valor fuera de ese intervalo, o que no sea entero, se ajusta al intervalo y genera un aviso (véase Tipos de disposición). La disposición 'multiple' propia de un estilo de encabezado usa el número de columnas del documento, salvo que fije el suyo. Desde postext 1.18.
gutterWidthDimension0.75 cmEspacio horizontal entre las columnas (medianil). Solo se aplica a las disposiciones de varias columnas.
sideColumnPercentnumber33Ancho de la columna lateral, como porcentaje del área de contenido. Cualquier valor que deje algo de ancho a las dos columnas se usa tal cual; si no, se ajusta, y la compilación genera un aviso (véase Tipos de disposición). Solo se aplica a la disposición 'oneAndHalf'.
sideColumnRole'text' | 'floats''text'Qué contiene la columna lateral: texto corrido (que pasa a ella tras llenar la columna principal) o solo los recursos y los recuadros colocados con span: 'side', es decir, una columna de margen solo para flotantes. Solo en 'oneAndHalf'. Con 'text', un párrafo que pasa de una columna a la otra se vuelve a cortar para el ancho de la columna en la que continúa; hasta postext 1.4 conservaba las líneas de la columna en la que empezaba, y una línea compuesta para la columna principal se salía de la lateral, que la recortaba.
sideColumnSide'right' | 'left' | 'outer' | 'inner''right'Borde del área de contenido en el que se sitúa la columna lateral. Con márgenes simétricos, 'outer' / 'inner' dependen de si la página es par o impar (el borde exterior de una página impar es el derecho, y el de una par, el izquierdo). Solo en 'oneAndHalf'.
columnRuleColumnRuleConfigdesactivadoFilete opcional trazado entre las columnas. Véase más abajo.
fitFiguresToPagebooleanfalseReduce una figura (mapa de bits o SVG) cuya imagen, pie y nota serían más altos que el área de contenido hasta que quepan en ella (una imagen con zona segura, Resource.safeArea, primero se recorta dentro de esa zona a todo su ancho, y solo se reduce si sigue sin caber), y reduce una figura en línea que es un poco más alta que el espacio que queda en su columna (hasta la mitad de su ancho, con el pie a la medida de la columna) para que siga junto a su texto. La imagen reducida se coloca en su hueco según placement.align. El visor HTML activa este ajuste, porque sus páginas solo son tan altas como la pantalla; las páginas impresas se dimensionan teniendo en cuenta sus figuras.
bitmapResolution'document' | 'file' | number'document'Cómo obtiene su tamaño natural de impresión un mapa de bits sin bitmap.resolution propia. 'document' lee sus píxeles a page.dpi; un número es la resolución en ppp de todos esos mapas de bits (con 300, una imagen de 2400 px mide 203,2 mm de ancho, sean cuales sean los dpi de la página); 'file' usa la resolución que declara su archivo (bitmap.fileResolution), salvo 72 y 96, que se consideran no indicadas, y si no, page.dpi. La columna sigue limitando el tamaño de la imagen, y una imagen más pequeña nunca se amplía. Véase Formato del documento › Tamaño de los mapas de bits. Desde postext 1.24.
floatShrinkFloatShrinkConfigmode: 'never'El valor por defecto del documento para el placement.shrink (mode: 'never', 'page' o 'slot') y el placement.minScale (minScale, 0.7 si no se indica) de una imagen flotante: reducirla, sin cambiar sus proporciones, al espacio de su hueco en lugar de llevarla más adelante (véase Formato del documento › Colocación). La colocación del recurso, y después la defaultPlacement de su tipo, tienen prioridad sobre él. fitFiguresToPage limita todas las figuras al área de contenido; floatShrink tiene en cuenta la banda que el flotante ocuparía realmente, bajo una apertura, junto a otros flotantes o encima de las notas al pie. Desde postext 1.24.
wrapTextWrapConfigminTextWidth: 12em, minLinesBeside: 2, defaultWidth: 0.45Texto que rodea una imagen o un recuadro más estrecho que su columna (placement.wrap, el wrap de un recuadro): gap, el espacio entre el elemento y el texto (una línea del texto base si no se indica); minTextWidth, la medida mínima que puede tener el texto de al lado, como longitud o como fracción de la columna (si el espacio es más estrecho, el elemento ocupa su banda entera y se genera un aviso textWrap); minLinesBeside, el número mínimo de líneas que merece la pena componer a su lado; defaultWidth, la fracción de la columna que ocupa un elemento rodeado de texto que no fija su width. Véase Formato del documento › Ajuste del texto. Desde postext 1.24.
floatsAtCitingPagebooleanfalseEl valor por defecto del documento para placement.citingPage: un flotante 'top' o 'auto' puede ocupar la cabeza de la página (si es un flotante a ancho de página) o de la columna (si es un flotante de columna) donde cae la línea que lo cita por primera vez, en lugar del primer hueco libre después de esa línea; el texto que hay encima de la cita baja y queda debajo del flotante (véase Formato del documento › Colocación). La colocación del recurso, y después la defaultPlacement de su tipo, tienen prioridad sobre él. Desde postext 1.25.
maxTopFractionnumber0.7La fracción máxima de la altura de la columna, de 0 a 1, que puede ocupar un flotante en la cabeza de la página o de la columna que lo cita, contando los flotantes que ya están allí, para que la página conserve sitio para su texto (el \topfraction de LaTeX). Un flotante que ocuparía más va a su hueco habitual. Desde postext 1.25.
hugClosingFloatsbooleantrueEn la última página de un capítulo (y del documento), las figuras y tablas a ancho de página que quedan por debajo de la última banda de texto suben hasta quedar a un hueco de flotante de ella, apiladas por orden: allí no las sigue nada. Con false, se quedan donde las puso su colocación, de modo que un flotante position: 'bottom' termina al pie de la última página igual que en todas las demás; por ejemplo, en una ficha técnica cuyo contorno termina a la misma altura en todas las páginas. En las páginas con columna lateral nunca se mueven.
footFloatRowbooleanfalseColoca en fila las figuras al pie de una página de varias columnas: una figura o tabla citada donde su columna ya tiene otra al pie ocupa el pie de la siguiente columna vacía, con la primera línea de su pie a la altura de la de su vecina, en lugar de apilarse encima (el faldón del compositor). Una imagen con zona segura se recorta dentro de ella hacia la altura de su vecina. Cada recorte se señala en Comprobaciones. Un flotante en fila conserva su sitio: el que llega después al pie de una de sus columnas se coloca encima. Con tres columnas o más, la fila sigue en la siguiente columna que no tiene nada al pie. En el Sandbox, Figuras al pie en fila, en Maquetación.
alignFloatsAcrossColumnsbooleanfalseAlinea entre columnas las figuras que comparten una franja de la página: al pie de columnas vecinas, la primera línea de sus pies (el pie más corto deja el blanco debajo); en lo alto, el borde inferior de sus imágenes (la imagen más corta deja el blanco encima). Una imagen que llena su columna desde lo alto, sin texto debajo, alinea su pie con los pies de las figuras al pie de las columnas de al lado. Solo se alinea una figura sola en su columna, derecha y entera: la que ocupa varias columnas, la girada, la que lleva el pie al lado, un tramo de tabla y la colocada a mano (placement.pin) conservan su sitio. El blanco se lee de la posición que tomó cada figura y se vuelve a leer tras la última pasada de la maquetación, de modo que una figura que pasó a otra página no guarda blanco para una vecina que ya no tiene. La maquetación hace hasta dos pasadas más al principio y dos al final. Funciona junto con footFloatRow, que ya alinea un flotante que se une al pie de la columna siguiente. En el Sandbox, Alinear las figuras entre columnas, en Maquetación.
pullFloatsToCitationbooleanfalseNo se recomienda. Devuelve a la página que lo cita por primera vez un flotante que se ha quedado fuera de ella por cuatro líneas de texto o menos (medidas con su ancho en su mejor hueco de esa página). Lo hace en dos pasos, y cada uno se conserva solo si el flotante cae entonces en la página de su cita, sin una página más, sin retrasar otro flotante, sin perder ninguna igualación de columnas ya conseguida y sin perder ningún flotante que encabeza la página de su cita (floatsAtCitingPage): primero, a los párrafos de la página de la cita que están por encima de ella se les ofrece una línea menos (espaciado entre palabras más apretado, nunca entre letras), solo tantas líneas como le faltan al flotante, y el cambio se queda solo en las páginas cuyo flotante ha vuelto; después, una imagen con zona segura que sigue fuera de su página se recorta dentro de ella, no más de lo que pide el hueco, y cada recorte se avisa con floatCropped. Las pasadas posteriores, como el equilibrado de columnas, mantienen en su página los flotantes atraídos. La opción va en contra de la colocación por reglas: donde las reglas llevan el flotante al hueco siguiente, esta opción se queda con la página de la cita a la fuerza, compone párrafos más apretados de lo que eligió el corte de líneas y recorta imágenes. Para tener los flotantes junto a su cita según las reglas, usa floatsAtCitingPage o placement.citingPage (el flotante encabeza la página en la que cae la línea que lo cita, y el texto que hay encima de la referencia baja por debajo de él) y placement.shrink: 'slot' (la imagen se compone más pequeña, sin cambiar sus proporciones, para quedarse en la página que la cita). En el Sandbox, Atraer las figuras a la página de su cita, en Maquetación.
inlineResourceGap'around' | 'above''around'Dónde conserva el hueco de los flotantes (una línea) un recurso en línea (placement.position: 'here', insertado con ::resource). 'around' lo conserva encima y debajo del recurso, y el texto que sigue vuelve a la rejilla base bajo ese hueco; un encabezado, una lista, un recuadro u otro recurso en línea situado justo después comparte el hueco inferior con su propio espacio superior, y se aplica el mayor de los dos. 'above' solo lo conserva encima: el texto que sigue al recurso continúa en la siguiente línea de la rejilla, por cerca que esté (entre nada y una línea), como hasta postext 1.4. Las configuraciones guardadas por versiones anteriores cuyos capítulos insertan un recurso se leen con 'above', para que sus páginas no cambien (véase Paquetes escritos por postext 1.4 o anterior). Una configuración escrita en código para la 1.4 conserva el espacio antiguo si fija ella misma 'above', o mediante pinLegacyInlineGap, de postext/bundle.
inlineResourceGapInBoxesbooleantrueSi un recurso en línea dentro de un recuadro (:::callout) conserva el hueco que fija inlineResourceGap (una línea del texto del propio recuadro): encima del recurso y, con 'around', también debajo, en cuyo caso se aplica el mayor entre ese hueco y el espacio propio del bloque siguiente. Al principio o al final del recuadro, o de un fragmento de un recuadro partido, el relleno ya separa el recurso y no se añade ningún hueco. Con false, el recurso queda justo debajo del texto anterior, y el texto siguiente, justo debajo del recurso, como hasta postext 1.4. Las configuraciones guardadas por versiones anteriores cuyos capítulos insertan un recurso dentro de un recuadro se leen con false (véase Paquetes escritos por postext 1.4 o anterior); en código, pinLegacyBoxResourceGap, de postext/bundle, hace lo mismo.
inlineCaptionSidebooleantrueSi un recurso colocado en el texto (position: 'here') admite placement.captionSide igual que un flotante de columna. En una disposición de columna y media con la columna lateral reservada a los flotantes (sideColumnRole: 'floats'), su pie y su nota van a la columna lateral, a la altura del borde superior de la imagen, allí donde esa columna está libre a su lado; el bloque de la columna de texto mide entonces lo mismo que la imagen sola. Donde la columna lateral está ocupada, y en una página sin columna lateral, el pie se queda debajo de la imagen. Con false, los pies laterales solo se aplican a los flotantes de columna, como hasta postext 1.27. Desde postext 1.28. Las configuraciones guardadas por versiones anteriores con una disposición 'oneAndHalf' cuyos capítulos insertan un recurso se leen con false; en código, pinLegacyInlineCaptionSide, de postext/bundle, hace lo mismo.
boxChildSplitMinLinesnumber2Número mínimo de líneas de un párrafo o de un elemento de lista que un corte dentro de ellos deja a cada lado cuando un recuadro se parte (splitMinLines, en Estilos de recuadro, sigue contando todas las líneas del recuadro a cada lado del corte). Un número entero, como mínimo 1. Con el valor por defecto, un corte nunca deja sola una línea de un párrafo o de un elemento al pie de una columna ni en la cabeza de la siguiente; si el splitMinLines del estilo del recuadro es menor, el límite lo fija ese valor. Con 1, un corte puede dejar una línea del párrafo o del elemento a un lado, como hasta postext 1.4. Las configuraciones guardadas por versiones anteriores cuyos capítulos contienen algún :::callout se leen con 1 (véase Paquetes escritos por postext 1.4 o anterior); en código, pinLegacyBoxChildCut, de postext/bundle, hace lo mismo.
flowColumnsbooleantrueUn bloque :::columns fuera de un recuadro compone sus bloques en subcolumnas de la columna de texto (o a lo ancho de la página, con span="page"), y un grupo, dentro de un recuadro o en el texto, se corta entre sus subcolumnas cuando no cabe y continúa en la columna o la página siguiente (véase Formato del documento › :::columns). Con false, se ignora el bloque fuera de un recuadro y nunca se corta dentro de un grupo, como hasta postext 1.24; las configuraciones guardadas por versiones anteriores cuyos capítulos contienen algún bloque :::columns se leen con false; en código, pinLegacyFlowColumns, de postext/bundle, hace lo mismo. Una sección con estilo conserva el valor del documento. Desde postext 1.25.
floatsUnderOpenerbooleantrueBajo una apertura a ancho de página (un nivel o un estilo de encabezado con span: 'page') compuesta sobre dos o más columnas de texto, la cabeza de la columna de la propia apertura, justo debajo de su banda, es un hueco para un flotante 'top' o 'auto', a la altura de las cabezas de las demás columnas: un recuadro flotante escrito justo después de la apertura, o un recurso insertado allí, queda bajo la apertura en la primera columna (o en varias, a partir de ella, con columns), y el texto de la columna empieza debajo. Un flotante citado en el texto corrido sigue colocándose después de la línea que lo cita. Con false, no se ofrece ese hueco, y el flotante se coloca a partir de la segunda columna, como hasta postext 1.24; las configuraciones guardadas por versiones anteriores que definen un encabezado a ancho de página se leen con false; en código, pinLegacyOpenerHeadFloats, de postext/bundle, hace lo mismo. Una sección con estilo conserva el valor del documento. Desde postext 1.25.
openerFloats'allow' | 'warn' | 'avoid''allow'Flotantes en una página de apertura: la página que abre una parte, la que abre un encabezado con su propio salto (breakBefore, o un encabezado span: 'page' que abre página) y la primera página de un documento que empieza con un encabezado. Un flotante es una figura, una tabla o una tira de cómic con colocación flotante, o un :::callout que flota en la cabeza o al pie de una página, tanto si ocupa una columna como el ancho de la página o la columna lateral; un recurso insertado en línea ('here'), un recuadro 'fixed' y un recuadro span: 'side' no lo son. 'allow' compone ahí los flotantes como en cualquier otra página. 'warn' compone la página igual y avisa de cada flotante que hay en ella (un aviso openerFloat; véase Avisos del documento). 'avoid' deja libre la página de apertura: un flotante que fuera a caer en ella ocupa el primer hueco libre posterior, así que la página solo contiene su apertura y su texto. Una sección con estilo conserva el valor del documento. Desde postext 1.28.
writingMode'horizontal-tb' | 'vertical-rl''horizontal-tb'Dirección de las líneas. 'vertical-rl' compone en vertical el texto chino o japonés: los caracteres de arriba abajo, y cada línea a la izquierda de la anterior. El layout de un estilo de encabezado lo hereda, salvo que fije el suyo, así que un apéndice horizontal puede seguir a un libro vertical. Véase Escritura vertical.

#Escritura vertical

Con writingMode: 'vertical-rl', una página se maqueta como una página horizontal girada un cuarto de vuelta en el sentido de las agujas del reloj. El flujo se compone en un marco tan ancho como alta es la hoja; sus líneas son las columnas del texto vertical, que se leen desde la derecha, y todo lo que hace el motor con las líneas (cortes, justificación, flotantes, notas al pie, reglas de cohesión) funciona en ese marco. Por tanto, en la hoja:

  • Una columna de la disposición es un piso (栏): layoutType: 'double' da dos pisos apilados de arriba abajo, que se llenan empezando por arriba a la derecha; gutterWidth es el espacio entre ellos, y el filete entre columnas, un filete horizontal entre ambos. Los pisos no se igualan al final de un capítulo (clreq §7.1.3.4): en un documento vertical, el equilibrado de columnas está desactivado salvo que se fije headings.balancing.enabled.
  • Lo que el flujo llama «arriba» es el borde derecho de la hoja, donde empieza la lectura: un flotante superior queda a la derecha de la página, y uno inferior, a la izquierda; una apertura a ancho de página es una franja a lo largo del borde derecho, y las notas al pie van al extremo izquierdo de cada piso. Un elemento de diseño anclado a la parte superior de la página (el diseño de un encabezado, un recuadro fijo) se ancla al borde derecho. En sideColumnSide, 'left' es el piso de arriba y 'right', el de abajo; 'outer' e 'inner' se leen como 'right' y 'left'.
  • Los márgenes del flujo son los de la hoja, girados: el margen derecho es la parte superior del flujo, y el superior, su lado izquierdo. page.margins conservan sus nombres en la hoja.
  • Los titulillos, los folios, las marcas de corte y el fondo de la página se quedan en la hoja, en horizontal, como describe clreq para los libros verticales.
  • Las figuras y las tablas se mantienen derechas. Una figura ocupa la altura de su piso hasta donde lo permite su pie, y como mucho el ancho de la página; el ancho que toma es el espacio que ocupa en el flujo. Su pie se compone en horizontal debajo de ella, igual que las celdas de una tabla: ambos se miden como texto horizontal. Una tabla se compone derecha, a lo ancho de la página, y, si es más alta que el piso, sus filas se cortan a la medida del piso. placement.align coloca la figura en la parte de arriba ('left'), en medio o al pie de su piso. Un placement.rotate no se aplica si la figura se cita por primera vez en un texto vertical: la compilación genera el aviso de contenido rotateIgnoredVertical. Una sección horizontal del libro (un estilo de encabezado cuyo layout fija 'horizontal-tb') gira sus figuras como se le pide.
  • Las imágenes de un diseño (la ilustración de una apertura o de una página de parte) también quedan derechas. Su caja en el flujo se dimensiona con el ancho y el alto de la imagen intercambiados, de modo que size.width es lo que la imagen ocupa a lo largo de la columna, y su ancho en la hoja se deduce de sus proporciones.
  • Caracteres: los caracteres han, los kana y las formas de ancho completo quedan derechos, a un cuadratín cada uno; las palabras latinas y los números se tumban, con su ancho horizontal; la puntuación toma la forma vertical de la fuente. Los signos de pausa y de final nunca se giran: una fuente de China continental pone 、。,. en la esquina superior derecha de la celda y !?:; en su mitad derecha, y una de Taiwán o de Hong Kong los centra (cjk.region). Los paréntesis y las comillas toman su forma vertical, y “ ” ‘ ’ se leen como 『』「」 en un texto de China continental. Las rayas, los puntos suspensivos y la tilde de onda toman la forma vertical de la fuente si la tiene (Noto CJK asocia la de — a vert junto con fwid: un filete por el centro de la celda); si no, se giran con la tinta centrada en el eje de la columna. El 破折号 (——) de un texto chino es un único filete a lo largo de la columna: sus formas verticales dejarían un blanco en los dos extremos de cada celda, así que cada raya se gira con la línea y se estira como en el texto horizontal (véase Anchos de la puntuación). Un número de dos cifras como máximo queda de pie en una sola celda, salvo dentro de una frase en alfabeto latino, cuyas palabras sigue (véase Números en texto vertical). El punto medio (·) ocupa media celda en un texto de China continental y una celda entera en uno de Taiwán o de Hong Kong. Los signos que Unicode coloca derechos (× © ± § ℃ ① y similares) ocupan una celda propia, también dentro de un número: 3×4 son el 3 y el 4 tumbados, con el × derecho entre ellos. Un apóstrofo o un punto medio entre dos letras de una palabra latina (don’t, l·l) se queda en la palabra, tumbado. Un párrafo en alfabeto latino dentro de un flujo vertical sigue las mismas reglas. Las fórmulas en línea, los chips y las muestras de color se tumban con la línea.
  • Cada carácter se mide tal como se pinta: un carácter en una celda avanza una celda a lo largo de la línea, y un tramo tumbado, su ancho horizontal. El texto que queda en horizontal en la hoja (titulillos, folios, pies, celdas de tabla) se mide en horizontal.
  • Los anchos de la puntuación, la puntuación colgada y el espacio entre chino y latín se aplican a lo largo de la línea vertical igual que en la horizontal. El blanco anterior a un glifo queda encima de él, y el posterior, debajo: un 、 kaiming ocupa media celda, 」「 se comprimen a celda y media, un paréntesis de apertura recortado en la cabeza de una línea empieza media celda más arriba, un 。 colgado queda bajo el pie de su línea, y el espacio entre caracteres han y latinos es un cuarto de cuadratín de la columna, encima y debajo de una palabra tumbada. :;?! conservan la celda entera en el texto vertical en todas las regiones.
  • La retícula de caracteres cuenta los caracteres a lo largo de la línea y las líneas a lo ancho de la página: charsPerLine fija la longitud de un piso; linesPerPage, cuántas líneas tiene una página, y layoutType: 'double' da dos pisos de caracteres enteros, con un medianil de cuadratines enteros entre ellos.

Para las aplicaciones que leen la maquetación: una página vertical incluye VDTPage.flow. Su contentArea, sus columnas, bloques, líneas, flotantes, zonas de notas al pie, banda de apertura y elementos de diseño superpuestos a los bloques están en coordenadas del flujo; width, height, header y footer están en la hoja. flowToPage, pageToFlow, flowRectToPage y pageRectToFlow convierten unas coordenadas en otras, y verticalOrientation(char, region) indica cómo se coloca un carácter. flow.centralBaselines da, para cada familia tipográfica, el eje sobre el que la maquetación ha centrado los caracteres derechos: el centro de la tinta de 中, cuyo trazo largo ocupa toda la altura del cuadratín (0,38 em por encima de la línea base en Noto Serif y en Noto Sans, tanto en SC como en TC), un carácter que tienen todas las fuentes chinas, japonesas y coreanas. Cada línea se centra en ese eje: la línea base de una línea vertical queda, por debajo del borde superior de su caja de línea, a la mitad de su interlineado más la línea base central de la familia (la de una línea horizontal, a 0,8 de su interlineado), así que una columna de caracteres queda en el centro de su paso, y un filete trazado entre dos columnas a un paso entero cae justo a medio camino entre ellas. Un texto de diseño vertical se compone igual en sus propias líneas.

El canvas pinta la página vertical por su cuenta; para pintar la puntuación con las formas verticales propias de la fuente, una aplicación en el navegador carga, una vez por familia, una fuente gemela que las tiene activadas: loadVerticalAlternates(family, faces), donde faces son los orígenes de la familia (URL o bytes) y sus descriptores. La gemela solo se conserva si el navegador aplica esa función OpenType al texto del canvas (Chrome 140 y posteriores): para comprobarlo, dibuja 「(《 con la gemela y con una copia de los mismos estilos cargada sin la función, con el peso y el estilo de los estilos recibidos, y se queda con la gemela si la tinta es distinta. Una llamada posterior con otros estilos de una familia cuya gemela ya está en uso (la negrita después de la redonda) los añade a la gemela. El Sandbox lo hace con todas las familias de un documento vertical. Sin gemela, los paréntesis se giran sobre el centro de su cuadratín, y los signos de pausa y de final de China continental se desplazan dentro de su celda hasta donde los colocan las formas verticales de la fuente: 、。,. a la esquina superior derecha (a menos de 0,07 em de las formas verticales de Noto Serif SC) y !?:; medio cuadratín a la derecha y un poco hacia arriba (a menos de 0,02 em). El PDF y el HTML componen la misma página: véanse Texto vertical en el PDF y la tabla de En qué se diferencia la salida HTML del canvas y del PDF.

Comparados celda a celda con HarfBuzz (composición vertical con vert) en Noto Serif TC y SC, todos los caracteres de 「賈雨村」云云,宜乎?故曰!;:、。“引”‘單’…… quedan a menos de 0,02 em de su posición en el canvas y en el PDF, y a menos de 0,05 em en el HTML (Chrome centra un glifo girado en el punto medio entre el ascendente y el descendente de la fuente, que en Noto queda 0,05 em por encima del centro del cuadratín). flow.dashAdvances da, para cada familia, el avance horizontal en em de cada raya que la página estira hasta llenar su celda (— – ― ⸺ ⸻ -), para los programas que pintan sin métricas de fuente propias: el HTML estira la raya según ese valor, igual que el canvas y el PDF lo hacen según las suyas. Los titulillos y los folios también pueden ir en vertical: véase Elementos de texto verticales.

#Filete de columna

Dibuja un filete vertical fino en el medianil para separar visualmente las columnas.

PropiedadTipoPor defectoDescripción
enabledbooleanfalseSi se dibuja el filete de columna.
colorColorValue#ccccccColor del filete.
lineWidthDimension0.5 ptGrosor del filete.

Bajo un encabezado a ancho de página (span: 'page'), el filete empieza donde empieza el texto de las columnas, debajo de la banda del encabezado, tanto si la pinta la apertura por defecto como si la pinta un diseño propio. Hasta postext 1.4 bajaba desde el principio de la caja de texto y atravesaba la banda.

Un estilo de encabezado puede fijar su propio filete en su layout (véase Estilos de encabezado), y las páginas de su sección dibujan ese filete. Un campo que el estilo no fija toma el valor del documento, así que una sección que solo cambia sus columnas conserva el filete del documento. Hasta postext 1.4, el filete de un estilo no se dibujaba nunca: todas las páginas dibujaban el del documento.

#Tipos de disposición

  • 'single': una sola columna que ocupa todo el ancho del área de contenido. Es la mejor opción para páginas estrechas o para textos densos con párrafos largos.

  • 'double': dos columnas del mismo ancho. Es la disposición editorial clásica, que mantiene la medida (el ancho de línea) en el intervalo óptimo de 40 a 50 caracteres para una lectura cómoda.

  • 'oneAndHalf': una disposición asimétrica con una columna principal y una columna lateral más estrecha. La columna lateral (que controla sideColumnPercent) es ideal para notas al margen, figuras pequeñas o contenido complementario. Los valores entre el 25 % y el 40 % funcionan bien, y un canal estrecho para numerar líneas o poner marcas al margen ocupa entre el 10 % y el 15 %, aproximadamente. La columna lateral mide el sideColumnPercent % del ancho del área de contenido, y la principal, lo que queda después del medianil; así, con el 50 %, la lateral es un medianil más ancha que la principal. Cualquier valor se aplica tal cual mientras las dos columnas conserven al menos el 1 % del ancho del área de contenido; uno que dejaría alguna más estrecha (0 o menos, o uno tan grande que la columna principal desaparecería detrás del medianil) se ajusta al valor más cercano que respete las dos, y un valor que no sea un número toma el valor por defecto, 33. En ese caso, los configWarnings del documento incluyen { kind: 'sideColumnPercentClamped', path: 'layout.sideColumnPercent', value, used }, que el Sandbox muestra en su panel Revisión (en el layout propio de un estilo de encabezado, la ruta indica el estilo, como en headingStyles[2].layout.sideColumnPercent, y el valor se mide con los márgenes de ese estilo); collectConfigWarnings(config) devuelve la misma lista sin maquetar nada. Una disposición que no sea 'oneAndHalf' nunca lee el valor ni avisa de él. Con sideColumnRole: 'floats', el texto corrido nunca entra en la columna lateral, que se convierte en un canal para las figuras, las tablas y los recuadros colocados con span: 'side'. Una figura o una tabla lateral se apila desde la cabeza del canal en la página que la cita por primera vez (la figura al margen de un libro de texto queda en lo alto de su página aunque el texto la cite más abajo); si no cabe en lo que queda del canal, espera al canal de la página siguiente. Un recuadro lateral se apila junto al texto que interrumpe y, si lo que queda del canal no puede contenerlo ahí, sube a la posición más baja en la que cabe (con su pie en el pie del canal) o espera a la página siguiente. Cuando el texto que sigue a la línea de apertura de un recuadro continúa en la página siguiente (porque la columna está llena o porque las reglas de corte llevan ese texto más adelante), el recuadro se queda donde está su línea de apertura, junto al texto anterior; un estilo con sideAtColumnEnd: 'after' lo coloca, en cambio, a la altura de la primera línea del texto que sigue a la línea de apertura, en el canal de la página siguiente, como necesitan los números de línea y los ladillos escritos antes de su línea. Un elemento del diseño de un encabezado que cae en el canal (por ejemplo, el número de un capítulo anclado en el margen exterior) también queda fuera de la pila (véase Altura reservada). Los flotantes y los recuadros span: 'page' siguen ocupando las dos columnas, y un flotante de columna con placement.captionSide pone su pie en el canal, a la altura de la figura. Con márgenes simétricos y sideColumnSide: 'outer', el canal queda en el borde exterior de todas las páginas: la columna al margen de un libro de texto. Desde postext 1.28, una figura o una tabla colocada en el texto (position: 'here') con captionSide también lleva su pie al canal (inlineCaptionSide).

  • 'multiple': de tres a ocho columnas iguales, tantas como indique columnCount (3 por defecto); es la retícula de los periódicos y de muchas revistas (desde postext 1.18). Cada columna mide (ancho del contenido − (n − 1) × gutterWidth) / n. El texto pasa de una columna a la siguiente como en una disposición de dos columnas; el filete se dibuja en todos los medianiles, el equilibrado de columnas iguala todas las columnas en la última página de un capítulo y antes de un recuadro a ancho de página, las notas al pie funcionan en todas las columnas, y las figuras, los recuadros y los encabezados a ancho de página atraviesan toda la página. Una figura o un recuadro flotante pueden ocupar solo algunas columnas: placement.columns (véase Tipos de recurso) y el columns de un estilo de recuadro. Un columnCount fuera del intervalo 3–8, o que no sea entero, se redondea y se ajusta al número válido más cercano (un valor que no sea un número toma 3), y los configWarnings del documento incluyen { kind: 'columnCountClamped', path: 'layout.columnCount', value, used } (en el layout propio de un estilo de encabezado, la ruta indica el estilo, como en headingStyles[1].layout.columnCount). Una disposición de otro tipo nunca lee el valor. Un estilo de encabezado cuyo layout es 'multiple' toma el columnCount del documento salvo que fije el suyo, así que un periódico a cinco columnas puede componer sus páginas de opinión a cuatro.