Documentazione di Postext

Indice

Tre parti: che cos’è Postext e come è costruito, il mestiere tipografico che automatizza e gli strumenti con cui lo usi.

Parte I · Fondamenti

  1. 1IntroduzioneTempo di lettura: 7 minChe cos’è Postext, perché esiste e quale problema risolve
  2. 2ArchitetturaTempo di lettura: 45 minArchitettura tecnica del motore di impaginazione Postext

Parte II · Il mestiere

  1. 3ConfigurazioneTempo di lettura: 2 minChe cos’è una configurazione di Postext e in quale delle nove pagine del riferimento è spiegato ogni gruppo di impostazioni
  2. 4Pagina e impaginazioneTempo di lettura: 6 minIl formato della pagina, i margini e la griglia della linea di base, le colonne con i loro intercolonni, e le intestazioni e i piè di pagina
  3. 5Testo e titoliTempo di lettura: 11 minTipografia del testo corrente, sillabazione e lingua del documento; titoli, elenchi puntati e numerati, e formule matematiche
  4. 6Note e riferimentiTempo di lettura: 4 minNote a piè di pagina, numeri di riga, rimandi e citazioni, l’indice dei contenuti e l’indice analitico
  5. 7Tipografia dell’Asia orientaleTempo di lettura: 2 minLe impostazioni cjk: divisione in righe, larghezza della punteggiatura, spaziatura, griglia di caratteri, ruby e segni del testo cinese, giapponese e coreano
  6. 8Risorse e tabelleTempo di lettura: 5 minI tipi di risorsa e la loro numerazione, gli stili di tabelle e didascalie, i diagrammi a inchiostro unico e i video in stampa
  7. 9Stili e partiTempo di lettura: 7 minStili con nome per paragrafi, chip, listati di codice, riquadri e titoli, e le pagine che aprono ogni parte
  8. 10Impostazioni dei fumettiTempo di lettura: 3 minLe impostazioni dei fumetti: cornice e spazi tra le vignette delle tavole, stili delle vignette, lettering, stili delle nuvolette e personaggi
  9. 11Font, colori e outputTempo di lettura: 6 minUnità, colori e tavolozza, font personalizzati, visualizzatore HTML, PDF e produzione di stampa, visualizzatore Folio e sovrimpressioni di debug
  10. 12Uso programmaticoTempo di lettura: 8 minChiamare Postext dal codice: buildDocument, i Web Worker, il visualizzatore HTML, i file PDF, il libro 3D, l’EPUB e i pacchetti .postext
  11. 13Sillabazione e giustificazioneTempo di lettura: 14 minCome Postext divide le righe, giustifica il testo e controlla la spaziatura tra le parole con l’algoritmo di Knuth-Plass
  12. 14Formato del documentoTempo di lettura: 10 minIl sottoinsieme di markdown che Postext analizza e le regole per scrivere i documenti sorgente
  13. 15Composizione del cineseTempo di lettura: 26 minCome Postext compone il cinese, in orizzontale e in verticale: regioni, divisione in righe, larghezza della punteggiatura, giustificazione tra i caratteri, griglia dei caratteri, libri rilegati a destra, numeri in piedi, segni, ruby, warichu, numeri cinesi e font
  14. 16Impaginazione arabaTempo di lettura: 24 minCome Postext compone l’arabo: direzione del testo e algoritmo bidirezionale, libri rilegati a destra, parole legate che non si dividono né si spaziano, giustificazione con kashida, segni vocalici, enfasi, cifre e stili di numerazione, ordinali in lettere, note a piè di pagina, versi classici, indice, indice analitico, citazioni e font
  15. 17Composizione giapponeseTempo di lettura: 30 minCome Postext compone il giapponese in verticale e in orizzontale: la regione Giappone, il kinsoku, la spaziatura degli yakumono, le parentesi a inizio paragrafo, le forme verticali, i furigana, i segni di enfasi e le linee laterali, il kanbun, i numerali, i titoli in gyōdori, le note, un indice in ordine gojūon, le citazioni, i font e i testi dell’Aozora Bunko
  16. 18FumettiTempo di lettura: 25 minCome Postext compone fumetti e manga dal Markdown: tavole tagliate da un albero di divisione, immagini delle vignette ritagliate attorno alla loro zona sicura, lettering generato da una sceneggiatura (parlato, pensiero, sussurro, urlo, radio, didascalie, onomatopee), stili delle nuvolette, ancore dei personaggi sulle immagini, strisce nel testo, doppie pagine, lettura da destra a sinistra e lettering verticale, traduzioni, e gli output canvas, PDF, HTML ed EPUB

Parte III · In pratica

  1. 19ContribuireTempo di lettura: 5 minCome entrare nella comunità di Postext e contribuire al progetto
  2. 20SandboxTempo di lettura: 16 minAmbiente interattivo per sperimentare con il motore di impaginazione Postext
  3. 21SkillTempo di lettura: 8 minInstalla la skill postext-port in Claude Code, Codex o in qualunque agente e lasciale trasformare un sorgente PDF, Word, PowerPoint, EPUB, InDesign o HTML in un progetto Postext che segue l’impaginazione originale
  4. 22Riga di comandoTempo di lettura: 10 minUn unico eseguibile autonomo per macOS, Linux e Windows che trasforma un libro .postext, una cartella di libro o file Markdown sparsi in PDF, HTML, EPUB, immagini delle pagine e Word, crea pacchetti e verifica i libri, con output JSON per script e agenti
  5. 23WebMCPTempo di lettura: 14 minChe cosa può fare con la Sandbox un agente di IA nel browser tramite i suoi 36 strumenti WebMCP (guardare le pagine, cambiare qualunque impostazione, modificare il testo, aggiungere immagini, tabelle e font, eseguire le verifiche, esportare) e come chiamare ciascuno, con argomenti e risposte reali