commit f3dc1b5d4941a6fa9df833e2aed07e8840d2f1cf Author: dan Date: Sun Mar 17 00:08:43 2019 +0100 first commit diff --git a/README.md b/README.md new file mode 100644 index 0000000..e225f75 --- /dev/null +++ b/README.md @@ -0,0 +1,89 @@ +# Slidol + +Lo Slidol è un template per una semplice presentazione (slide) in Markdown da convertire in PDF. + +Uso: `pandoc -t beamer slidol.md -o slidol.pdf` + +Slidol permette di potersi concentrare alla scrittura dei contenuti, senza impazzire tentando di spostare quel +quadrotto: "un pò più in basso.. perché non ci va?".. distraendosi dai contenuti. È minimo, veloce, essenziale e +liberante. Per persone pigre. + +Perché fare le slide? Non lo so. Forse per fare una presentazione. Forse per una festa. + +Perché non usare Libre Office Impress Presentation? Per scrivere e conservare il testo in formato text. Libero, leggero +e strutturabile (dunque anche condivisibile e collaborabile), facile da conservare e da aggiornare. Separando produzione +da pubblicazione. Scrivere in formato text con la semplice sintassi markdown permette di prescindere da quale sarà il +formato di pubblicazione, che potrebbe essere un libro, un sito, un volantino, una presentazione o un .norm + +Slidol vuole essere uno strumento utile e veloce per chi ha già fatto slide in precedenza, ma anche per chi volesse +cominciare ora a usare Markdown. + +## Contenuti + +[slidol](slidol.md) + +## Descrizione + +Markdown è il linguaggio di marcatura leggero ideato da Aaron Swartz e John Gruber per dare una struttura logica a un +documento di testo. Anche HTML e LaTeX sono linguaggi di marcatura, ma non sono leggeri. + +Nel template slidol.md vengono mischiate marcature markdown, commonmark, HTML e LaTeX accettate da Beamer per comporre +una slide di presentazione in PDF. Slidol usa poche stringhe tra le quali: inserire immagini centrate e non, dotarle o +meno di una descrizione, fare elenchi numerati o incrementali, avere link cliccabili ed evidenziare il testo. + +## Requisiti + +Pandoc e LaTeX + + apt install pandoc texlive-latex-base + + apt install texlive-latex-recommended texlive-fonts-recommended texlive-latex-extra + +## Uso + +* Copiare localmente il template [slidol.md][]. + +* Scriverci sopra usando un editor di testo puro, come: gedit, geany, emacs o vim. + +* Convertire slidol.md in PDF tramite pandoc. + + pandoc -t beamer slidol.md -o slidol.pdf + +## Temi + +Beamer dispone di diversi [temi][] ed alcuni sono già inclusi, ad esempio *Singapore*, *AnnArbor* e +*Warsaw*. + +Creare una slide.pdf usando il tema Singapore: + + pandoc -t beamer -V theme:Singapore slide.md -o slide.pdf + +## Divagazioni + +Fare un Pdf da proiettare è un esigenza di gruppi, relatori e fomentatori vari che ancora credono che l'educazione sia +utile a rompere i rapporti di potere. Per divulgare a volte ci vuole un PDF per la proiezione. Si potrebbe usare +reveal.js con quei bellissimi colori, quei font così d'impatto e quelle transisioni così fluide. Primo è tanto lavoro +perché alla fine sempre ci si ritrova a correggere il file HTML, il che distrae dai contenuti. Ti chiederanno poi di +farglielo avere.. "L'ho messo sul sito". Eh, ma non si riesce a scaricare.. Node.js non si usa più.. Che browser hai +usato? Non funziona internet.. Si è rotto.. Il PDF nella pennina alla fine vince. E il sorgente in markdown è leggibile. + +È sufficiente usare un editore di testo e qualche stringa contenuta nello slidol per ottenere una slide PDF senza usare +le suite Office/s o Keynote/s e mantenere così un sorgente leggero e leggibile del proprio lavorato, eventualmente +convertibile anche in altri formati di pubblicazione. Le stringhe sono poche ed essenziali e mirate all'ottenimento di +una slide Pdf da usare per proiezioni. [^Nota][] Il formato testo markdown si presta ad essere usato come codice e ad +essere condiviso per essere lavorato collettivamente usando ad esempio uno strumento di controllo versione come Git. Il +Pdf ottenuto con lo slidol, anche nel suo tema default semplice e bianco di nome *boxes*, ha i requisiti sufficienti per +essere una presentazione dignitosa: immagini scalabili, elenchi a scomparsa, link ed evidenziatori. E nessuno è mai stato +criticato né licenziato per essersi presentato con una slide fatta in LaTeX. + +A word to the LaTeX people: non viene richiesto di definire un preambolo tex allo scopo di poter usare LaTeX senza +conoscere LaTeX. + +A song: Usate più LaTeX, il LaTeX fa bene.. a tutti conviene, a tutte le età! + +[^Nota]: Per un template da usare per ottenere invece un libretto pieghevole da stampare, vedere il [criptolibretto][]. + +[temi]: https://hartwork.org/beamer-theme-matrix/ +[criptolibretto]: https://git.abbiamoundominio.org/unit/criptolibretto +[slidol.md]: slidol.md + diff --git a/immagine.png b/immagine.png new file mode 100644 index 0000000..57b586d Binary files /dev/null and b/immagine.png differ diff --git a/slidol.md b/slidol.md new file mode 100644 index 0000000..11b649d --- /dev/null +++ b/slidol.md @@ -0,0 +1,134 @@ +# Titolo, Autore, Data + +Prima slide con titolo della presentazione e nome e data (opzionali). + +Una riga che inizia con cancelletto dà il titolo alla pagina. + + # Titolo, Autore, Data + +# Uso + +Si può variare il testo e convertire in PDF per vedere l'effetto che fa. + + pandoc -t beamer slidol.md -o slidol.pdf + +# Elenchi + +Gli elenchi vengono creati con un asterisco e spazio a inizio riga. + + * Questo è il primo punto + +* Questo è il primo punto +* Questo è il secondo punto + +# Elenchi numerati + +Gli elenchi numerati da: numero e punto e spazio a inizio riga. + +1. Questo è il primo punto +2. Questo è il secondo punto + +# Testo su blocco separato + +Un blocco separato si ottiene usando un apice destro a inizio linea. + + > Questo è un blocco di testo. + +> Questo è un blocco di testo. + +Per andare a capo +come +in questo +esempio +usare due spazi a fine di ogni riga. + + + +# Testo evidenziato e centrato + +Usare la parola o la frase tra uno o due asterischi per ottenere rispettivamente *italico* e **grassetto**. + + *italico* + + **grassetto** + +Per centrare del testo posso usare la stringa `\centering`. + +\centering + +LaTeX to the people! + +Right now! + +# Elenchi a scomparsa + +Gli elenchi incrementali vengono creati da: apice destro, spazio, trattino e spazio a inizio riga. + + > - Questo è il primo punto + +> - Questo è il primo punto +> - Ed ecco il secondo punto +> - Finalmente il terzo punto + +# Immagine inserita in automatico + +![il pinguino e il musicista](immagine.png) + +# Immagine centrata con descrizione (opzionale). + +\centering +\includegraphics[width=2in]{immagine.png} +\ Un pinguino e un musicista. + +*Cambiare 2in con la dimensione desiderata: 1, 2, 3, 4 inches.* + +# + +![il pinguino e il musicista](immagine.png){ width=05% }\ +![il pinguino e il musicista](immagine.png){ width=10% }\ +![il pinguino e il musicista](immagine.png){ width=12% }\ +![il pinguino e il musicista](immagine.png){ width=15% }\ +![il pinguino e il musicista](immagine.png){ width=20% }\ +![il pinguino e il musicista](immagine.png){ width=30% }\ + +# Link + +[Questo è un LINK al sorgente](https://git.abbiamoundominio.org/dan/slidol). + +In una slide è opportuno indicare i link per esteso, visto che chi assiste alla presentazione non può +cliccare sul proiettore. + +Inserire un link (tra due apici) in un blocco di testo, per migliore visibilità. + + > + +> + +# Testo e codice + +*Il codice viene rappresentato usando una TAB a inizio riga.* + +> Per convertire il file di testo **slidol.md** nel PDF **slidol.pdf**: + + pandoc -t beamer slidol.md -o slidol.pdf + +È necessario installare Pandoc e LaTeX. Vedere la parte requisiti nel README. + +[x]: Questa è una nota di una riga che non apparirà nel PDF + + + + diff --git a/slidol.pdf b/slidol.pdf new file mode 100644 index 0000000..06041fe Binary files /dev/null and b/slidol.pdf differ