first commit

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
+

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.
+
+<!--
+Se l'editore di testo, ad esempio Gedit, capisce che sto usando markdown, evidenzierà la sintassi.  Attivare il
+le funzionalità markdown.
+-->
+
+# 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à.
+
+    > <https://git.abbiamoundominio.org/dan/slidol>
+
+> <https://git.abbiamoundominio.org/dan/slidol>
+
+# 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
+
+<!--
+Per nascondere gli appunti posso usare la sintassi markdown, quando si tratta di una sola riga.
+O posso usare la classica sintassi HTML.
+
+È utile poter scrivere liberamente appunti.
+Ad esempio potrei decidere di non mostrare una slide nel PDF, ma di non cancellarla dal sorgente.
+-->
+
+<!--
+# Ultima slide
+
+Buon incontro!
+-->