Immaginate di dover scrivere un documento molto lungo: un libro, una tesi, un paper universitario. Con Word o con LibreOffice Writer basta inserire qualche immagine o un grafico e l'impaginazione si complica.

LaTeX, invece, è uno strumento ottimo, ma è difficile da imparare e non tutti hanno voglia di farlo. E se ci lavorate in più persone, resta una domanda: il merito a chi va davvero? Quanto di quel documento ha scritto ciascuno?

Allora qual è la via di mezzo? Per me è Markdown, ed è da qui che nasce Pecie, lo studio editoriale che ho sviluppato per i documenti lunghi. In questo articolo vi spiego come funziona e perché, secondo me, cambia il modo di scrivere una tesi o un libro. Nel video ve lo mostro passo per passo.

Indice

Che cos'è Pecie e da dove viene il nome

Pecie è uno studio editoriale per i documenti lunghi e strutturati: quelli che richiedono tanti dati, tante fonti e tanto tempo per essere scritti. Tutto il lavoro sta in un unico progetto in un formato che ho creato apposta, il formato .pe: dentro ci sono il manoscritto, la struttura, le note, le fonti, le citazioni e la cronologia.

Il nome viene dalle pecie, i fascicoli che un tempo venivano uniti e rilegati per formare un libro intero. Ed è proprio così che Pecie costruisce il vostro documento: tanti pezzi separati che, messi insieme, diventano l'opera finale.

Si scrive in Markdown, un modo di formattare il testo con pochi simboli, per esempio un cancelletto davanti a un titolo. Per me è il giusto compromesso tra Word e LaTeX: più semplice di LaTeX, ma vi permette comunque di fare tantissimo.

Il primo avvio

Al primo avvio si sceglie la lingua: Pecie è disponibile in italiano, inglese, tedesco, spagnolo, francese e portoghese. Poi la cartella del workspace, il tema chiaro, scuro o quello di sistema, e il font. Oltre a quello classico c'è OpenDyslexic, un font pensato per le persone con dislessia. Infine si crea il profilo, cioè il vostro nome di autore.

Nelle impostazioni vedete anche i componenti che servono per l'export: Pandoc, WeasyPrint, XeLaTeX, PDFLaTeX e LuaLaTeX. Sono già inclusi nel pacchetto, perché l'applicazione è pensata per non dipendere da niente di esterno. E tutto resta in locale, sul vostro computer.

C'è poi una guida rapida, con un tour dell'interfaccia e una guida a Markdown, così non dovete uscire dal programma per imparare a usarlo.

Il binder: un documento fatto di pezzi

Quando create un progetto, scegliete un modello: vuoto, tesi, paper universitario, libro, saggio, manuale, giornale, articolo, script video o sceneggiatura.

Il cuore è il binder, il raccoglitore del progetto. Con il modello libro, per esempio, il manoscritto parte da quattro nodi separati, cioè pagina del titolo, indice, prefazione e capitolo 1. Ogni nodo è un pezzo a sé, proprio come una pecia, e potete aggiungerne di nuovi o importare un documento esistente.

Accanto al manoscritto ci sono le sezioni di supporto: le note di lavoro, gli appunti rapidi, le fonti e i riferimenti, e i documenti caricati. Potete trascinare lì PDF, ebook o documenti di testo e importarli nel progetto.

Lo stato del progetto, poi, vi dice quante parole avete scritto nella sessione, quanti documenti avete toccato e tutte le altre statistiche.

L'editor e gli strumenti di ricerca

Nell'editor potete impostare un obiettivo di parole e mostrare o nascondere il fine pagina. Lavorate in tre modi: solo scrittura, solo anteprima, oppure con lo schermo diviso, il testo da una parte e il risultato dall'altra. C'è anche la modalità focus, che nasconde i pannelli, e la modalità macchina da scrivere, che tiene la riga su cui scrivete in una posizione più comoda.

Nella parte di ricerca create note, importate i PDF e collegate i materiali tra loro con backlink e relazioni.

Per avere una visione d'insieme ci sono altre tre viste. L'outliner mostra i documenti in una tabella, con parole, tag e stato. Il corkboard li trasforma in schede, come foglietti su una bacheca di sughero, ognuna con la sua sintesi. E la vista in stile scrivenings vi fa leggere di seguito più pezzi, come se fossero un testo unico.

La timeline: chi ha scritto che cosa

Questa è la parte che risponde alla domanda da cui siamo partiti, ed è davvero importante.

Quando consegnate il documento a qualcun altro, Pecie aggiunge in automatico il nuovo autore. Poi misura il contributo di ciascuno, in base al tempo, alle parole scritte e al lavoro fatto, e calcola un indice di autorialità: il primo autore diventa chi ci ha lavorato di più. È un criterio imparziale, perché si basa su quello che si può misurare.

La timeline fa anche un'altra cosa molto importante: usa Git, il sistema che gli sviluppatori usano per tenere traccia delle versioni del codice. Ogni volta che salvate, Pecie crea un checkpoint, cioè un punto a cui potete tornare. Se qualcuno vi cancella una parte del lavoro, dalla timeline la ripristinate.

Pensate a tutte le volte che un'immagine inserita in Word ha devastato un documento lungo: con i checkpoint tornate alla versione di prima.

L'export: dal Markdown al PDF

Quando il lavoro è pronto, lo esportate. Scegliete il modello, per esempio libro o saggio, e il formato: PDF, ma anche DOCX e ODT, i formati di Word e LibreOffice, RTF, EPUB per gli ebook, HTML per il web, LaTeX, Markdown o testo semplice. Ci sono anche due formati per l'editoria accademica, JATS e TEI.

Prima di salvare potete vedere l'anteprima, tornare indietro a correggere o confermare. Nel video ho esportato un libro in PDF: Pecie ha assemblato i pezzi del binder e ha ricostruito un documento impaginato come se fosse stato scritto in LaTeX.

Per che cosa usarlo, e per che cosa no

Io uso Pecie tantissimo per la documentazione tecnica, e funziona molto bene per i documenti lunghi, anche quelli operativi. È pensato per la tesi, il libro, il manuale, il giornale, l'articolo: cose lunghe.

Per gli appunti veloci, invece, non lo userei: su un documento piccolo tutta questa struttura non serve, e vanifichereste il vantaggio. Per gli appunti io uso Doku, il mio editor Markdown.

Dove scaricarlo

Se usate Ufficio Zero Linux OS, la distribuzione italiana con cui collaboro, Pecie lo trovate nella sezione Office, sottosezione Enterprise.

Altrimenti potete agganciare il mio repository AppRelease con APT o DNF, i gestori di pacchetti delle distribuzioni basate su Debian e su Red Hat, oppure scaricare l'AppImage. Nel repository di Pecie su GitHub trovate anche il file .exe per Windows e il .dmg per macOS. La licenza è la AGPL 3.0, la GNU Affero General Public License.

La regola da portarvi via

Insomma, la regola è questa: un documento lungo non si scrive in un unico blocco. Dividetelo in pezzi, tenete fonti e note accanto al testo e salvate checkpoint frequenti; l'impaginazione lasciatela all'export, alla fine.

Un'opera lunga raramente muore per mancanza di idee: molto più spesso muore per disordine. Pecie nasce proprio per evitarlo.

Per approfondire

Una precisazione: Pecie è un mio progetto, che sviluppo per hobby e distribuisco gratuitamente come software libero. Se vi serve una funzione in più, potete chiedermela e sostenere il progetto con una piccola donazione.

E voi con che cosa avete scritto, o state scrivendo, la vostra tesi? Scrivetelo nei commenti del video.

Fonti