Aller au contenu principal

Documentation de Postext

Sommaire

Trois parties : ce qu’est Postext et comment il est construit, le métier typographique qu’il automatise, et les outils avec lesquels vous l’utilisez.

Partie I · Fondements

  1. 1IntroductionTemps de lecture: 7 minCe qu’est Postext, pourquoi il existe et le problème qu’il résout
  2. 2ArchitectureTemps de lecture: 45 minArchitecture technique du moteur de mise en page Postext

Partie II · Le métier

  1. 3ConfigurationTemps de lecture: 2 minCe qu’est une configuration Postext, et dans laquelle des neuf pages de la référence chaque groupe de réglages est expliqué
  2. 4Page et mise en pageTemps de lecture: 6 minLe format de la page, les marges et la grille de ligne de base, les colonnes et leurs gouttières, les en-têtes et pieds de page
  3. 5Texte et titresTemps de lecture: 11 minLa typographie du texte courant, la césure et la langue du document ; les titres, les listes à puces et numérotées, et les mathématiques
  4. 6Notes et référencesTemps de lecture: 4 minLes notes de bas de page, les numéros de ligne, les renvois et les citations, la table des matières et l’index
  5. 7Typographie d’Asie de l’EstTemps de lecture: 2 minLes réglages cjk : coupure des lignes, chasse de la ponctuation, espacement, grille de caractères, ruby et signes du chinois, du japonais et du coréen
  6. 8Ressources et tableauxTemps de lecture: 5 minLes types de ressources et leur numérotation, les styles de tableau et de légende, les diagrammes en une seule encre et les vidéos imprimées
  7. 9Styles et partiesTemps de lecture: 7 minLes styles nommés des paragraphes, des pastilles, des listings de code, des encadrés et des titres, et les pages qui ouvrent chaque partie
  8. 10Réglages de bande dessinéeTemps de lecture: 3 minLes réglages de bande dessinée : cadre et gouttières des planches, styles de case, lettrage, styles de bulles et distribution
  9. 11Polices, couleurs et sortieTemps de lecture: 6 minUnités, couleurs et palette, polices personnalisées, visionneuse HTML, PDF et production pour l’impression, visionneuse Folio et calques de débogage
  10. 12Utilisation programmatiqueTemps de lecture: 8 minAppeler Postext depuis le code : buildDocument, Web Workers, la visionneuse HTML, les fichiers PDF, le livre en 3D, l’EPUB et les paquets .postext
  11. 13Césure et justificationTemps de lecture: 14 minComment Postext coupe les lignes, justifie le texte et règle l’espacement des mots avec l’algorithme de Knuth-Plass
  12. 14Format du documentTemps de lecture: 10 minLe sous-ensemble de Markdown que lit Postext, et les règles pour rédiger les documents source
  13. 15Composition du chinoisTemps de lecture: 26 minComment Postext compose le chinois, horizontalement et verticalement : régions, coupure des lignes, chasse de la ponctuation, justification entre les caractères, grille de caractères, livres reliés à droite, nombres debout, marques, ruby, warichu, chiffres chinois et polices
  14. 16Mise en page de l’arabeTemps de lecture: 24 minComment Postext compose l’arabe : sens d’écriture et algorithme bidirectionnel, livres reliés à droite, mots liés jamais coupés ni espacés, justification par kashida, signes vocaliques, mise en valeur, chiffres et styles de numérotation, ordinaux en toutes lettres, notes de bas de page, poésie classique, table des matières, index, citations et polices
  15. 17Mise en page japonaiseTemps de lecture: 30 minComment Postext compose le japonais, verticalement et horizontalement : la région Japon, le kinsoku, l’espacement des yakumono, les crochets en début de paragraphe, les formes verticales, les furigana, les points d’insistance et les traits latéraux, le kanbun, les compteurs, les titres en gyōdori, les notes, un index en ordre gojūon, les citations, les polices et les sources de l’Aozora Bunko
  16. 18Bande dessinéeTemps de lecture: 25 minComment Postext compose la bande dessinée et le manga à partir de Markdown : planches découpées par un arbre de découpage, dessins des cases recadrés autour de leur zone de sécurité, lettrage produit à partir d’un script (paroles, pensées, chuchotements, cris, radio, récitatifs, onomatopées), styles de bulles, ancres des personnages sur les dessins, strips dans le texte, doubles pages, lecture de droite à gauche et lettrage vertical, traductions, et sorties canvas, PDF, HTML et EPUB

Partie III · En pratique

  1. 19ContribuerTemps de lecture: 5 minComment rejoindre la communauté Postext et contribuer au projet
  2. 20SandboxTemps de lecture: 16 minTerrain de jeu interactif pour expérimenter avec le moteur de mise en page Postext
  3. 21SkillTemps de lecture: 8 minInstallez le skill postext-port dans Claude Code, Codex ou tout autre agent, et laissez-le transformer une source PDF, Word, PowerPoint, EPUB, InDesign ou HTML en un projet Postext qui suit la mise en page de l’original
  4. 22Ligne de commandeTemps de lecture: 10 minUn exécutable autonome pour macOS, Linux et Windows qui transforme un livre .postext, un dossier de livre ou des fichiers Markdown isolés en PDF, HTML, EPUB, images de pages et Word, crée des paquets et vérifie des livres, avec une sortie JSON pour les scripts et les agents
  5. 23WebMCPTemps de lecture: 14 minCe qu’un agent IA dans le navigateur peut faire avec le Sandbox grâce à ses 36 outils WebMCP (regarder les pages, changer n’importe quel réglage, modifier le texte, ajouter images, tableaux et polices, lancer les vérifications, exporter) et comment appeler chacun d’eux, avec de vrais arguments et de vraies réponses