Chapitre 3 · Partie II · Le métier

Configuration de Postext

Ce qu’est une configuration Postext, et dans laquelle des neuf pages de la référence chaque groupe de réglages est expliqué

Mis à jour 2026-10-102 minenescafrptzhjaar

En bref

Cette page ouvre la référence de tous les réglages qui décident de l’aspect de vos pages. Un seul groupe de réglages réunit tous les choix : format de la page, nombre de colonnes, polices, taille du texte, titres, encadrés, couleurs et bien plus. Vous n’écrivez que les réglages que vous voulez changer, car chacun part d’une valeur raisonnable. La référence est répartie sur neuf pages. La liste de cette page renvoie à chaque section : allez directement à la partie qui vous intéresse.

Chaque décision de mise en page dans Postext dépend d’un seul objet de configuration.

PostextConfig règle les dimensions de la page, la disposition des colonnes, la typographie du texte courant, les styles de titre, la langue du document (locale), et plus encore. Toutes les propriétés sont facultatives : Postext fournit des valeurs par défaut raisonnables, inspirées de la typographie traditionnelle du livre. Vous n’indiquez que ce que vous voulez changer.

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 overrides the 8 pt default
  headings: { fontFamily: 'Open Sans' },
});

Pour une vue d’ensemble de la façon dont le moteur traite cette configuration, consultez la page Architecture.

#Index

La référence est répartie sur neuf pages. Chaque groupe ci-dessous correspond à une page, suivie des sections qu’elle contient.

Page et disposition

Texte et titres

Notes et renvois

  • Notes de bas de page — footnotes : où vont les notes appelées par [^id], comment elles sont numérotées et quel aspect elles ont.
  • Numéros de ligne — lineNumbers : le numéro d’une ligne sur cinq, de vers ou de texte, dans la marge ; ce qui est compté, où le compte reprend, de quel côté se placent les numéros.
  • Renvois — crossRefs : les mots imprimés autour du numéro ou de la page d’un :ref, et son style par défaut.
  • Citations — citations : le style de citation, et l’aspect des citations et de la bibliographie.
  • Table des matières — ce qu’imprime :::toc : typographie des entrées, points de conduite, numéros de page, lignes d’auteur, lignes de partie.
  • Index — ce qu’imprime :::index : typographie des entrées, retraits, séparateurs et intervalles de numéros de page, groupes de lettres, langue de tri.

Typographie d’Asie de l’Est

  • Typographie d’Asie de l’Est — cjk : les conventions régionales et la coupure des lignes du chinois, du japonais et du coréen, la façon dont leurs lignes justifiées sont espacées, la chasse et le débord de la ponctuation, l’espace entre caractères han et latins, la grille de caractères, les nombres debout en texte vertical, ainsi que les signes, le ruby, les notes warichu et les signes kanbun. Les guides de tout cela sont Mise en page chinoise et Mise en page japonaise.

Ressources et tableaux

  • Types de ressources — numérotation par type des figures, des tableaux et des types personnalisés.
  • Style de tableau (avec les styles de tableau nommés) et Style de légende — typographie et décor des ressources de type tableau et de leurs légendes.
  • Style des diagrammes — recoloration en une seule encre des diagrammes SVG intégrés, pour l’impression en ton direct.
  • Style des vidéos — videoStyle : le signe de lecture et le code QR imprimés sur l’image d’aperçu d’une vidéo, et ce que proposent ses lecteurs dans la visionneuse HTML et en EPUB.

Styles et parties

  • Styles de paragraphe — styles nommés pour les conteneurs :::paragraphs : bibliographies, glossaires, notes.
  • Styles de pastille — chipStyles : styles nommés pour la pastille en ligne :chip[…] : le cadre d’une banque de mots, une touche de clavier, une étiquette.
  • Listings de code — codeStyle : la police, le cadre, la largeur de tabulation, les lignes longues, les numéros de ligne et les couleurs des jetons des listings ```, la coloration syntaxique et son crochet de surligneur, et le code en ligne dans une police de code.
  • Styles d’encadré — notes, astuces et objectifs encadrés pour les conteneurs :::callout.
  • Parties — pages de partie pour les conteneurs :::part : parité, zone de texte, maquette d’ouverture, typographie du texte.
  • Styles de titre — styles nommés pour les titres {style="…"} : chapitres non numérotés, pages liminaires avec leurs propres titres courants, géométrie et palette.

Réglages de bande dessinée

  • Bande dessinée — comics : le cadre et les gouttières des planches, les styles de case, le lettrage, les styles de bulle et les personnages. Le guide est Bande dessinée.

Polices, couleurs et sortie

Utilisation par programme