Documentación de Postext

Índice

Tres partes: qué es Postext y cómo está construido, el oficio tipográfico que automatiza y las herramientas con las que se usa.

Parte I · Fundamentos

  1. 1IntroducciónTiempo de lectura: 7 minQué es Postext, por qué existe y el problema que resuelve
  2. 2ArquitecturaTiempo de lectura: 29 minArquitectura técnica del motor de composición tipográfica Postext: sus conceptos, el árbol del documento, el ritmo vertical, los backends y el rendimiento
  3. 2.1El pipeline de composiciónTiempo de lectura: 30 minLa pasada de colocación y sus rondas: cómo coloca el motor las líneas, los flotantes, las notas y las columnas, y cómo repite la pasada hasta que la maquetación se estabiliza.

Parte II · El oficio

  1. 3ConfiguraciónTiempo de lectura: 5 minQué es una configuración de Postext y en cuál de las veinte páginas de la referencia se explica cada grupo de ajustes
  2. 3.1Página y disposiciónTiempo de lectura: 36 minEl 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.
  3. 3.2Cabeceras y pies de páginaTiempo de lectura: 33 minQué se imprime en la cabecera y al pie de cada página: textos con marcadores, filetes, cajas, imágenes y trazados vectoriales, según la página sea par o impar, y dónde se coloca cada elemento.
  4. 3.3Texto baseTiempo de lectura: 27 minCómo se configura la tipografía del texto corrido: la fuente, el cuerpo y el interlineado, los colores, las sangrías, las citas, la poesía, las tabulaciones y las letras capitulares
  5. 3.4Separación silábica e idiomaTiempo de lectura: 23 minCómo se configuran los patrones y las excepciones de la separación silábica y el texto en bandera; el idioma del documento, con sus cifras y su dirección, y qué escrituras compone Postext.
  6. 3.5EncabezadosTiempo de lectura: 35 minCómo se configuran los encabezados: los valores por defecto y los de cada nivel, los saltos de página antes de un encabezado, las aperturas de capítulo a todo el ancho de la página y los números escritos con letras
  7. 3.6Viudas, huérfanas y equilibradoTiempo de lectura: 24 minLas reglas que mantienen juntas las líneas y los bloques cuando cambian de columna, y los recursos con los que el motor consigue que todas las columnas terminen a la misma altura.
  8. 3.7Listas y matemáticasTiempo de lectura: 19 minCómo se configuran las listas con viñetas y las numeradas (sus marcas, sus sangrías y su anidamiento) y las listas de tareas, y qué cuerpo, color y espaciado tienen las fórmulas matemáticas
  9. 3.8Notas y referenciasTiempo de lectura: 30 minLas notas al pie, la numeración de líneas, las referencias cruzadas, las citas bibliográficas, el índice general y el índice analítico
  10. 3.9Tipografía de Asia orientalTiempo de lectura: 37 minLos ajustes de cjk para el texto chino, japonés y coreano: dónde se cortan las líneas, el ancho de la puntuación, el espaciado, la retícula de caracteres, el ruby y las marcas
  11. 3.10Recursos y tablasTiempo de lectura: 46 minCómo se configuran los tipos de recurso y su numeración, el estilo de las tablas y de los pies de recurso, los diagramas a una sola tinta y la forma en que se imprimen los vídeos
  12. 3.11Estilos y partesTiempo de lectura: 38 minLos estilos con nombre de párrafos, chips, resaltados, listados de código y encabezados, y las páginas que abren cada parte
  13. 3.12RecuadrosTiempo de lectura: 28 minLos estilos con nombre de los recuadros :::callout (borde, fondo, franja, título, icono, marcador y pestaña de etiqueta), las formas del recuadro con un radio por esquina, bordes por lado y pestañas unidas, los enunciados numerados, la tipografía dentro del recuadro, los recuadros partidos entre páginas y los diseños dibujados en un recuadro
  14. 3.13Ajustes de ejerciciosTiempo de lectura: 13 minLos estilos de ejercicio (exerciseStyles) y los ajustes de ejercicios del libro (exercises): el número, la letra del enunciado, las letras y las casillas de las opciones, los huecos, las respuestas de verdadero o falso, relacionar, el banco de palabras, los espacios para escribir, las cuadrículas, la división, las marcas de dificultad, los iconos, el color de las respuestas, dónde se imprimen las soluciones, la edición del profesor y las ediciones en pantalla
  15. 3.14Ajustes de cómicsTiempo de lectura: 8 minLos ajustes de los cómics: el marco y las calles de las páginas de cómic, los estilos de viñeta, la rotulación, los estilos de bocadillo y el reparto
  16. 3.15Ajustes de páginas compuestasTiempo de lectura: 10 minCómo se define una plantilla de página: sus marcos, grupos, rejillas que repiten un juego de marcos, módulos, decoración y conectores, la herencia entre plantillas y las variantes para páginas pares e impares; los estilos de los rótulos que se ponen sobre una imagen, y los avisos que puede dar una plantilla
  17. 3.16Fuentes, colores y salidaTiempo de lectura: 41 minLas unidades, los colores y la paleta; las fuentes personalizadas; el visor HTML, el PDF y la producción para imprenta; el visor Folio, y las ayudas de depuración.
  18. 3.17Uso programáticoTiempo de lectura: 32 minCómo usar Postext desde el código: buildDocument y sus avisos, los valores por defecto, las fuentes, las cachés y el Web Worker.
  19. 3.18Archivos PDFTiempo de lectura: 22 minCómo se usa postext-pdf desde el código: la instalación y la API; los proveedores de fuentes en el navegador y en Node; las fuentes CJK, los bytes de los recursos y el texto vertical, y los workers y los archivos listos para imprenta
  20. 3.19HTML, Folio, EPUB, SCORMTiempo de lectura: 18 minCómo mostrar el libro maquetado en una página web, como libro en 3D con postext-folio, como EPUB 3 de maquetación fija o fluida con postext-epub y como paquete SCORM para un LMS con postext-scorm
  21. 3.20Paquetes .postextTiempo de lectura: 30 minCómo abrir, maquetar, renderizar y crear archivos .postext desde el código; los paquetes bilingües; los archivos escritos por versiones anteriores, y la API de bajo nivel.
  22. 4Separación silábica y justificaciónTiempo de lectura: 45 minCómo corta Postext las líneas, cómo justifica el texto y cómo controla el espacio entre palabras con el algoritmo de Knuth-Plass.
  23. 5Formato del documentoTiempo de lectura: 16 minQué parte de Markdown lee Postext: el frontmatter, los encabezados, las listas y los bloques de código; lo que ignora, y las normas para escribir los documentos.
  24. 5.1DirectivasTiempo de lectura: 38 minLas directivas que empiezan con ::: (contenedores, columnas, papel, saltos de página, numeración, espacio, verso, índice e índice analítico, saltos de línea) y las marcas de las páginas de cómic.
  25. 5.2Formato en línea y fórmulasTiempo de lectura: 29 minLas marcas dentro de la línea: énfasis, enlaces, chips, versalitas, tabuladores, texto vertical, marcas chinas y japonesas, dirección del texto y fórmulas LaTeX
  26. 5.3Notas y referenciasTiempo de lectura: 15 minCómo se escriben las notas al pie, las referencias cruzadas y sus anclas, las citas y la bibliografía, y las marcas del índice analítico
  27. 5.4Imágenes, tablas y vídeosTiempo de lectura: 44 minCómo se usan los recursos en el texto: referencias e inserciones, numeración, colocación y dónde cae cada flotante; el texto que rodea las imágenes, el tamaño de los mapas de bits, las zonas seguras, las anclas de cómic y los vídeos
  28. 6Composición chinaTiempo de lectura: 37 minCómo compone Postext el chino, en horizontal y en vertical: las regiones, el corte de líneas y el ancho de la puntuación; la justificación entre caracteres y la retícula de caracteres; los libros encuadernados por la derecha y los números en una casilla; las marcas, el ruby y el warichu, los numerales chinos y las fuentes
  29. 7Composición árabeTiempo de lectura: 33 minCómo compone Postext el árabe: la dirección del texto y el algoritmo bidireccional; la encuadernación por la derecha; las palabras enlazadas, que nunca se cortan ni se espacian, y la justificación con cachida; los signos vocálicos, el énfasis, las cifras, la numeración, los ordinales con letras y las notas; el verso clásico, los índices, las citas y las fuentes
  30. 8Composición japonesaTiempo de lectura: 39 minCómo compone Postext el japonés, en vertical y en horizontal: la región Japón, el kinsoku y el espaciado de los yakumono; los paréntesis al principio de párrafo y las formas verticales; los furigana, las marcas de énfasis, las líneas laterales y el kanbun; los contadores, los encabezados con gyōdori y las notas; el índice en orden gojūon, las citas, las fuentes y los textos de Aozora Bunko
  31. 9CómicsTiempo de lectura: 43 minCómo compone Postext cómics y manga a partir de Markdown: las páginas divididas en viñetas y las imágenes recortadas alrededor de su zona segura; la rotulación generada a partir de un guion (diálogo, pensamiento, susurro, grito, radio, cartelas, onomatopeyas), los estilos de bocadillo y las anclas de los personajes; las tiras dentro del texto, las dobles páginas, la lectura de derecha a izquierda y la rotulación vertical; las traducciones y las salidas en canvas, PDF, HTML y EPUB
  32. 10Notación musicalTiempo de lectura: 12 minCómo compone Postext música dentro de un libro: notación escrita como texto en ABC, MusicXML, MEI o Humdrum, grabada al ancho de la columna y dividida en sistemas que siguen por columnas y páginas, ejemplos musicales numerados como recursos, el estilo de partitura, las salidas y cómo trae sus partituras una editorial de música
  33. 11EjerciciosTiempo de lectura: 17 minCómo compone Postext los ejercicios de un libro de texto o de un cuaderno: el contenedor :::exercise y sus doce tipos, de la opción múltiple a la división, las respuestas escritas en el Markdown, la numeración, las soluciones detrás del ejercicio, invertidas, al final del capítulo o del libro, la edición del profesor, los avisos, los ejercicios que se responden en pantalla en HTML y EPUB, los límites para un examen y los resultados que se envían a un LMS en un paquete SCORM
  34. 12Páginas compuestasTiempo de lectura: 47 minCómo se escribe una página compuesta en Markdown: el bloque de página, delimitado por cuatro signos de dos puntos, que indica la plantilla; los marcos y el atributo slot, que reparten el contenido entre los marcos de la plantilla; las ranuras repetidas y los módulos, y los avisos que saltan cuando el contenido no encaja con la plantilla o tapa otro marco
  35. 12.1Figuras con rótulosTiempo de lectura: 9 minFiguras que ponen palabras sobre una imagen: rótulos en los anclajes de un recurso, el texto alternativo, el pie y la nota propios de una figura, cómo se compone un rótulo, rótulos apartados de su punto con líneas de referencia, leyendas y símbolos en línea, y los avisos de los rótulos

Parte III · La práctica

  1. 13ContribuirTiempo de lectura: 6 minCómo unirte a la comunidad de Postext y colaborar en el proyecto.
  2. 14SandboxTiempo de lectura: 32 minLa interfaz del Sandbox: la barra de actividades; los paneles Texto, Libros, Capítulos, Recursos y Fuentes, y cómo se organiza la pantalla en un móvil.
  3. 14.1Paneles de diseño y de revisiónTiempo de lectura: 44 minQué hay en el panel Diseño (el resumen, los grupos con sus páginas y la búsqueda) y en el panel Revisión, con sus avisos en vivo agrupados por tipo
  4. 14.2Páginas compuestasTiempo de lectura: 21 minLo que ofrece el Sandbox para las páginas compuestas: editar las plantillas y sus marcos sobre la propia página, los conectores y las formas, las líneas guía, los señaladores y las leyendas, las rejillas, los módulos y su biblioteca, reorganizar marcos, los avisos de solapamiento y los glifos en la pestaña, ordenar los estilos de marco en una biblioteca, revisar las páginas compuestas en todas las ediciones, pasar al Markdown el texto de un libro y arreglar un marco con un clic
  5. 14.3Vistas previasTiempo de lectura: 16 minLas pestañas Canvas, PDF, Folio, HTML, EPUB 3 y SCORM de la zona de vista previa: qué muestra cada una y qué se puede hacer en ella
  6. 14.4Libros, archivos de Word y guardadoTiempo de lectura: 43 minCómo se organizan los libros y sus capítulos, cómo se editan las páginas de cómic, cómo se importan y exportan documentos de Word, y cómo guarda, exporta e importa el Sandbox tu trabajo
  7. 14.5Agentes, incrustación y presetsTiempo de lectura: 13 minQué herramientas WebMCP ofrece el Sandbox a los agentes de IA, cómo integrar el componente PostextSandbox en tu propia aplicación (sus props y su CSS) y cómo es el formato de los paquetes de preset.
  8. 15Libros de páginas compuestasTiempo de lectura: 22 minRecorrido por el Sandbox con un libro de texto escolar hecho de páginas compuestas: cómo crear una plantilla de página, rellenarla desde el Markdown, rotular un mapa, traducir la página, arreglar el texto que no cabe y seleccionar tanto en la página como en el texto; después, dibujar un árbol con conectores, notas sobre un mapa con señaladores y leyenda, una rejilla de tarjetas con fotos y una biblioteca de módulos para una colección
  9. 16Pasar a páginas compuestasTiempo de lectura: 13 minCómo pasar a plantillas de página y Markdown un libro que guarda el texto de sus páginas en estilos de encabezado, con el asistente Pasar el texto al Markdown del Sandbox o a mano, qué comprobar después y cómo sustituir las líneas pintadas en una imagen por conectores, y los marcos sueltos por rejillas y módulos
  10. 17SkillTiempo de lectura: 10 minInstala la skill postext-port en Claude Code, Codex o cualquier otro agente y deja que convierta un PDF, un documento de Word o de PowerPoint, un EPUB, un archivo de InDesign o una página HTML en un proyecto de Postext que reproduce la maquetación original
  11. 18Línea de comandosTiempo de lectura: 14 minUn único ejecutable autónomo para macOS, Linux y Windows. Convierte un libro .postext, una carpeta de libro o archivos Markdown sueltos en PDF, HTML, EPUB, imágenes de las páginas y Word; además, crea paquetes, revisa libros y devuelve resultados en JSON para scripts y agentes
  12. 19WebMCPTiempo de lectura: 13 minQué puede hacer un agente de IA en el navegador con el Sandbox gracias a sus 53 herramientas WebMCP (mirar las páginas, cambiar cualquier ajuste, editar el texto, añadir imágenes, tablas y fuentes, pasar las comprobaciones, exportar) y cómo se invoca cada una, con argumentos y respuestas reales