Manuale d'Uso Presswork (IT)

Questo manuale descrive tutte le funzionalità di Presswork, con un percorso guidato per ogni area dell’app.

1. Panoramica

Presswork è un editor Markdown professionale per editoria e self‑publishing. Combina scrittura pulita, strumenti editoriali (stile, synopsis, versioni) e export professionali (PDF, PDF/X, EPUB, DOCX, HTML, ICML, FDX). Include Typst per PDF rapidi e supporta LaTeX + Ghostscript per PDF/X certificati.

2. Requisiti e installazione

• Inclusi: Pandoc, Typst (PDF Base), motori interni.
• Opzionali (Pro): LaTeX e Ghostscript per PDF/X certificati.

Dove controllare:

• Strumenti → Controllo Export: verifica e guida all’installazione.

3. Modalità e licenze (Base / Pro)

• Base: interfaccia semplificata, PDF rapido con Typst, meno opzioni.
• Pro: PDF/X, preflight, multi‑export, opzioni avanzate e strumenti editoriali completi.
• Cambi al volo con l'interruttore Base/Pro nell'header; il piano completo e la Licenza si gestiscono da Impostazioni → App → Vista di lavoro.

4. Interfaccia principale

• Header: accesso rapido a Documento, Strumenti, Export, Vista, licenza, manuale.
• Editor: area Markdown con toolbar e scorciatoie.
• Sidebar: Outline, Snapshot, Backlink, Scrivener.
• Status bar: parole, caratteri, linea/colonna, obiettivi.

5. Menu Documenti

• Nuovo: crea un nuovo documento.
• Salva MD / Salva come…: salva in .md.
• Importa documento: importa file supportati (PDF in sola lettura).
• Apri progetto: carica un progetto a capitoli.
• Modalità Struttura: gestione capitoli/ordine.
• Gestisci Progetto: crea/aggiorna progetti editoriali.
• Stampa: stampa il documento corrente.
• Versioni: cronologia autosalvataggi e ripristino.

Uso consigliato:

1. Crea documento o progetto.
2. Salva spesso.
3. Usa Versioni per recuperare revisioni.

6. Menu Strumenti

• Obiettivi: target parole giornalieri o per documento.
• Statistiche: andamento scrittura, ritmo, difficoltà, flow.
• Guida Utente: manuale integrato.
• Controllo Export: verifica LaTeX/Ghostscript.
• Command Palette: ricerca comandi (Ctrl/Cmd + P).
• Analisi di stile: ripetizioni, leggibilità, tono, inclusività.
• Assistente AI: riassunti, riscritture, coerenza.
• Modalità Vim: comandi Vim.
• Collab: sessioni collaborative P2P con invito rapido tramite ID sessione.
  • Avvio rapido: apri Strumenti → Collab, imposta il tuo nome, crea o incolla ID sessione (pw-...) e premi Connetti.
  • In chiamata: usa i toggle microfono e camera dal pannello flottante; se WebRTC fallisce, configura il relay WebSocket (presswork-collab-relay-url).
• Tour: percorso guidato sui formati speciali.
• Firma Digitale: firma PDF con certificato (Pro).

7. Menu Export

Formati principali

• PDF (Typst, rapido)
• PDF/X (LaTeX, certificato)
• PDF Sceneggiatura (Hollywood)
• FDX (Final Draft)
• DOCX / ODT
• EPUB
• HTML
• ICML (InCopy/InDesign)

Opzioni

• Stile PDF: selezione template PDF.
• PDF/X: profilo ICC, validazione, font incorporati.
• Crocini/Bleed: opzioni di stampa.
• Metadati EPUB + Cover.
• Preflight: checklist qualità e stampa.
• Storico export: log esportazioni.
• Esporta Multiplo: più file in uno.
• Export Multi‑formato: PDF + EPUB + HTML ecc.
• Esporta con Asset: include immagini/risorse.
• Converti Cartella: batch conversion.

8. Menu Vista

• Modalità: Scrittura, Codice, Anteprima, Pagina, Split.
• Lingua: 9 lingue UI.
• Tema: Chiaro/Scuro.
• Macchina da Scrivere: riga centrata.
• Focus Mode: nasconde UI (F11).
• Presentazione: slide fullscreen.
• Accessibilità: dimensione testo, contrasto, font dislessia.

9. Toolbar Editor

• Formattazione: grassetto, corsivo, sottolineato.
• Titoli: H1/H2/H3.
• Elementi: link, immagini, codice inline/blocco.
• Liste: puntate/ordinate.
• Citazioni.
• Tabelle.
• CriticMarkup: insert, delete, comment.
• Template: preset di impaginazione.
• Metadati: YAML front‑matter.
• Snapshot: istantanee di scena.
• Synopsis: riassunti per capitolo.

10. Pannelli Sidebar

• Outline: navigazione sezioni.
• Snapshot: gestione istantanee.
• Backlink: collegamenti tra documenti.
• Scrivener: capitoli e drag&drop.
• Scene Navigator: per sceneggiature.

11. Scrivere in Markdown

Sintassi base

• # Titolo / ## Sottotitolo
• **grassetto**, *corsivo*
• - elenco / 1. elenco numerato
• [link](url)
• ![alt](immagine)
• > citazione
• \newpage per salto pagina

Suggerimenti

• Drag & drop immagini.
• Usa Split o Anteprima per controllare il layout.

12. Template

• Template predefiniti: accesso da toolbar (Tpl).
• Template personalizzati:
  • Import file singolo o cartella (menu Template → “Importa file / Importa cartella”).
  • Classificazione automatica in tab: css→UI Kit, xlsx/xls/ods/csv→Business, altri→Documenti.
  • Badge Custom e tooltip completo su hover (nome + descrizione).
  • .md: caricabili nell’editor.
  • .tex/.pdfx/.pdft: usabili come stili di esportazione PDF.
  • .xlsx/.xls/.ods/.csv: usabili nei flussi foglio dati/report.
• Auto-pair UI↔PDF: i temi CSS possono auto-abbinarsi al template PDF (toggle + Disaccoppia).
• Libreria condivisa: salva preset tipografici condivisi.
• Dettaglio completo funzioni template: docs/template-functions-overview-it.md.

13. Metadati e front‑matter

• Editor metadati per titolo, autore, ISBN.
• Front‑matter YAML per esportazione coerente.
• EPUB: cover e metadata obbligatori consigliati.

14. Progetti e Modalità Struttura

1. Documenti → Gestisci Progetto.
2. Crea cartella progetto.
3. Aggiungi capitoli (.md).
4. Riordina con drag&drop.
5. Esporta tutto con ordine automatico.

15. Export dettagliato

15.1 PDF Base (Typst)

• Rapido, senza LaTeX.
• Ideale per bozze e revisioni.

15.2 PDF/X (LaTeX)

• Usa template certificato.
• Richiede LaTeX + Ghostscript.
• Supporta ICC, validazione e preflight.

15.3 PDF Sceneggiatura

• Layout Hollywood.
• Compatibile con Fountain.

15.4 FDX (Final Draft)

• Export per workflow cinematografici.

15.5 DOCX/ODT

• Conversione via Pandoc.

15.6 EPUB

• Metadati + cover consigliati.
• Compatibile con store digitali.

15.7 HTML

• Output web con risorse.

15.8 ICML

• Stili mappati per InDesign/InCopy.
• Titoli, liste, citazioni e sceneggiatura trasformati in stili dedicati.
• Preset di template inclusi + importazione di un .icml personalizzato.

15.9 Excel

• Export Excel con breakdown scene, personaggi e produzione.
• Supporto template: scrive nei fogli esistenti per mantenere stili di base.
• Import multi‑sheet in tabelle Markdown (con metadati tipo/cella).
• Selezione foglio e range in fase di import per evitare dati indesiderati.
• Chart Mapper: opzionale, genera grafici in anteprima da dati Excel.

16. Export avanzato

• Esporta Multiplo: unisce più documenti.
• Export Multi‑formato: genera PDF+EPUB+HTML in una cartella.
• Esporta con Asset: copia immagini e risorse.
• Storico export: log e risultati.

17. KDP (Amazon)

• Quick Export: PDF + EPUB con naming KDP.
• Calcolatore: dimensioni e margini.
• Template KDP: copertine/impaginazione dedicate.
• Validatore ePub: checklist, anteprima Kindle e report scaricabile.

18. Analisi di stile

• Frasi lunghe, ripetizioni, voce passiva.
• Suggerimenti inline.
• Metriche di leggibilità.

19. Assistente AI

• Riassunti, riscrittura, coerenza, titoli.
• Configurazione tramite endpoint o chiave.
• Supporto modelli locali compatibili.

20. Collaborazione (P2P)

• Sessioni condivise con cursori remoti colorati, commenti inline e sincronizzazione live.
• Chiamate voce/video integrate durante la sessione.
• ID sessione condivisibile (pw-...) per invitare rapidamente altri utenti.

Come usarla (step-by-step)

1. Apri Strumenti → Collab e scegli un nome riconoscibile.
2. Crea una nuova sessione oppure incolla l’ID ricevuto da un collega.
3. Attendi stato Online e verifica i partecipanti nel dock collaborazione.
4. Se serve voce/video, avvia la chiamata dal pannello Collab e usa i pulsanti mute/camera.
5. In reti aziendali restrittive, imposta il relay WebSocket (localStorage key: presswork-collab-relay-url).

21. Firma digitale

• Firma PDF con certificato PAdES‑T.
• Timestamp RFC 3161 (richiede rete).

22. Presentazione

• Trasforma documenti in slide.
• Layout e palette configurabili.

23. Accessibilità

• Dimensione testo 12–18px.
• Alto contrasto.
• Font dislessia.

24. Scorciatoie principali

• Ctrl/Cmd + S → Salva
• Ctrl/Cmd + N → Nuovo
• Ctrl/Cmd + P → Command Palette
• Ctrl/Cmd + Shift + P → Presentazione
• F11 → Focus Mode
• Ctrl/Cmd + B/I/U → Grassetto/Corsivo/Sottolineato
• Ctrl + Alt + V → Vim

25. Risoluzione problemi

• PDF/X non disponibile: installa LaTeX + Ghostscript e riavvia.
• Template non visibili: usa “Apri cartella template” e verifica estensioni.
• Export lento: disattiva validazione in bozza.

26. Percorsi utili

• Template personalizzati: cartella presswork/templates dentro la directory di configurazione utente.
• PDF/X ICC: cartella presswork/pdfx.

Presswork unisce semplicità e strumenti editoriali professionali: scrivi veloce in Base, pubblica in Pro.

Aggiornamenti recenti (Data Hub / Grafici)

• L’inserimento del grafico dall’Excel Data Hub ora mostra subito un’anteprima immagine anche nell’editor, non solo nel pannello di anteprima.
• L’anteprima inline è stata ridotta (circa 50%) per essere meno invasiva durante la scrittura.
• Toggle bidirezionale: 📝 Mostra codice apre il blocco chart-data, 🖼️ Torna al grafico ripristina la vista immagine.
• Il blocco chart-data resta comunque nel Markdown per garantire compatibilità con preview/render/export.
• Inserire una tabella o un grafico come immagine ora salva il file negli asset del documento (nomedoc.assets/images/) e nell'editor entra solo il riferimento Markdown: funziona anche con fogli molto grandi.
• Se il documento non è ancora salvato, l'app propone di salvarlo al volo (come per il trascinamento immagini); rifiutando, la tabella entra come testo Markdown e il grafico resta nel foglio.
• Alla scelta testo/immagine vengono capite anche risposte come "png", "jpg", "immagine", "foto"; una risposta non riconosciuta fa ripetere la domanda.
• La griglia dati segue il tema chiaro/scuro attivo.
• Salva come Template: finestra ridisegnata nello stile dell'app e tradotta. Richiede dati nella griglia e un modello nell'editor con segnaposto {{NomeColonna}}; "Genera Markdown" ripete il modello per ogni riga.
• Export Excel (breakdown): legge il testo dell'editor (scene INT./EXT. o capitoli #); se non trova scene ora avvisa invece di generare un file vuoto.
• Menu Tables semplificato: rimossa la voce doppia "Importa come template" (identica ad "Apri foglio Tables").
• Pannello Import/Export: nuova scheda Multipli (accanto a Formato base / Stampa pro / Sceneggiatura / Editoria) con le azioni batch: Converti Cartella, Genera Multiplo, Genera più formati, Genera con Asset. Le Opzioni avanzate mostrano solo ciò che riguarda il formato scelto.
• 🧪 Verifica ICML: nel pannello export (formato ICML) controlla il documento generato — gerarchia, front matter, escape, paragrafi vuoti — senza scrivere nulla su disco; i dettagli compaiono in una finestra dentro l'app. La stessa verifica gira comunque a ogni export ICML.
• Export FDX più sicuro: il Markdown generico (liste, tabelle, note) diventa sempre Azione — mai Personaggio/Dialogo per caso; le sceneggiature vere restano interpretate (scene, personaggi, battute, transizioni). \newpage diventa una vera interruzione di pagina (anche in ICML, con stile "Interruzione Pagina" rimappabile).
• Stampa via PDF: il pulsante Stampa genera un PDF temporaneo (Typst, stessa tipografia degli export) e lo apre nel visualizzatore di sistema — si stampa dal dialogo nativo con anteprima fedele.
• Impostazioni riordinate: sezione Installazioni (LaTeX in un click, stato Ghostscript), lingua in vista compatta, tema con chip Scuro/Chiaro. I prompt rapidi del pannello AI sono richiudibili.

27. Analisi approfondita delle funzioni (gap colmati)

Questa sezione integra le funzioni avanzate che spesso non vengono usate perché poco visibili nei menu.

27.1 AI: configurazione, diagnostica e qualità risposta

• Endpoint configurabili cloud/local (OpenAI‑compatible, Ollama, LM Studio) via variabili PRESSWORK_AI_ENDPOINT, PRESSWORK_AI_MODEL, PRESSWORK_AI_API_KEY.
• Diagnostica connessione AI con report JSON esportabile (utile per supporto tecnico/team IT).
• Controllo stile risposta (sintetica/bilanciata/dettagliata), anteprima prompt tecnico e retry ultimo prompt.
• Pin endpoint/modello per progetto: mantiene coerenza editoriale tra documenti diversi.

27.2 Statistiche: metodo di calcolo (operativo)

• Produttività media: calcolata su storico giornaliero (7 giorni / 30 giorni).
• Velocità scrittura: parole totali divise per finestra sessioni (parole/ora e parole/min).
• TTR (Type‑Token Ratio): parole uniche / parole totali.
• MSTTR: media TTR su finestre da 50 parole (riduce la distorsione su testi lunghi).
• Flow state realtime: intervallo medio battiture + rapporto cancellazioni recenti.
• Forecast completamento: stima ottimistica/pessimistica usando medie 7d vs 30d.

27.3 Export avanzati mancanti dalla guida rapida

• Final Draft (.fdx): mappa heading in Scene Heading reali, supporta note/page break/numerazione scena e genera sidecar .breakdown.json.
• ICML: mapping tipografico avanzato (titoli/liste/citazioni/sceneggiatura) + preset + import .icml custom.
• Wizard EPUB/ICML: blocca l’export finché metadati minimi (titolo/autore/ISBN) e cover non sono impostati.
• Firma PDF: PKCS#7 detached + timestamp RFC 3161.

27.4 Modalità Bundle (.pwk)

• Azione principale: Esporta con scelta destinazione.
• Target output automatici per ridurre errori manuali di percorso.
• Toggle in header per mostrare temporaneamente i quick-export classici.

27.5 Collaborazione (P2P) in contesti reali

• Session ID condivisibile pw-..., cursori remoti colorati, commenti inline, live sync.
• Chiamata voce/video integrata nella stessa sessione editoriale.
• Fallback relay WebSocket se WebRTC non passa (reti aziendali/firewall), tramite chiave presswork-collab-relay-url.

27.6 Template system (uso professionale)

• Import file/cartella con classificazione automatica (Business / Documenti / UI Kit).
• Supporto template binari e spreadsheet per flussi report.
• Auto-pair UI↔PDF per collegare tema editor e stile export, con opzione Disaccoppia.

27.7 Checklist operativa consigliata

1. Imposta modalità Base/Pro in base al deliverable.
2. Verifica prerequisites in Controllo Export (LaTeX/Ghostscript solo se serve PDF/X).
3. Esegui Preflight prima della consegna.
4. Per EPUB/ICML completa wizard metadati + cover.
5. Per documenti firmati abilita firma PKCS#7 + timestamp.
6. In team, salva Session ID Collab e relay fallback in policy interna.