From 887c9cf1caa112d0efef0c9e8109f854338fb50d Mon Sep 17 00:00:00 2001
From: crudo <crudo@canaglie.net>
Date: Thu, 19 Apr 2018 16:14:34 +0200
Subject: [PATCH] Refactor README

---
 README.md | 81 +++++++++++++------------------------------------------
 TODO.md   |  5 ++++
 2 files changed, 23 insertions(+), 63 deletions(-)
 create mode 100644 TODO.md

diff --git a/README.md b/README.md
index a3e7edb..e28a310 100644
--- a/README.md
+++ b/README.md
@@ -3,89 +3,44 @@
 Il criptolibretto nasce il 15 aprile 2018 per avere un pieghevole da
 portare al cryptoparty organizzato da Unit hacklab presso Macao.
 
-## Imposition
-
-In stampa si dice "imposition" l'azione di stampare un testo in forma di libro.
+## Ottenere il PDF
 
 ### Requisiti
 
 Assicurati di avere i seguenti programmi:
 
+* make
 * pandoc
 * pdflatex
 * psutils
 
-### Scrivere in markdown
+### Generazione
 
-Guarda il raw, si dovrebbe spiegare da sé
-Per fare un capitolo si usa cominciare la riga con un cancelletto
-i sottocapitoli usano due, tre, quattro cancelletti
-una parola o frase tra asterischi è *italic*, tra due asterischi è **grassetto**
+Principali comandi:
 
-https://stackoverflow.com/editing-help
+* `make book-a4.pdf` -- Genera un PDF in formato A4
+* `make book-a5-signature.pdf` -- Genera un PDF in formato A5 adatto alla stampa
+* `make clean` -- Pulisce la directory rimuovendo tutti i file generati
 
-### Mettere YALM in testa
-
-    ---
-    title: "Cripto libretto"
-    author: Unit hacklab - unit@paranoici.org
-    date: 15 Aprile 2018
-    documentclass: extarticle
-    papersize: A4
-    output: pdf_document
-    fontsize: 14pt
-    geometry: top=2.5cm, bottom=2.6cm, left=2.8cm, right=2.8cm
-    toc: true
-    number_sections: true
-    toc_depth: 2
-    highlight: zenburn
-    lang: italian
-    ---
-
-https://rmarkdown.rstudio.com/pdf_document_format.html
-
-### Conversione da markdown a pdf usando pandoc
-
-    pandoc --toc -s criptolibretto.md -o criptolibretto.pdf
-
-### Conversione in postscript
-
-    pdf2ps criptolibretto.pdf
-
-### Make a signature
-
-Riordinare le pagine nell'ordine giusto in modo che quando le stampi su di un A4 e le
-pieghi risultino un libretto
-
-    psbook criptolibretto.ps signature.ps
-
-### Scalare le pagine da A4 a A5
-
-    psnup -2 signature.ps criptolibretto-stampabile.ps
-
-### Riconversione in PDF
-
- (opzionale)
-
-    ps2pdf criptolibretto-stampabile.ps
+Per ottenere una lista completa dei comandi disponibili esegui `make help`.
 
 ## Stampa
 
-Stampa il file: criptolibretto-stampabile.pdf
+Stampa il file: `book-a5-signature.pdf`
 
-Selfprint: stampa normale in portait mode, ma imbocca le pagine a mano (lato da stampare UP) e quando
-le ricevi (le ricevi lato bianco in alto) non le girare ma solo abbassa e imbocca di nuovo.
+Selfprint: stampa normale in portait mode, ma imbocca le pagine a mano
+(lato da stampare UP) e quando le ricevi (le ricevi lato bianco in alto)
+non le girare ma solo abbassa e imbocca di nuovo.
 
-Se invece vai in copisteria allora potresti dover fare un duplex in quanto le pagine sono
-una dritta e una storta.
+Se invece vai in copisteria allora potresti dover fare un duplex in quanto
+le pagine sono una dritta e una storta.
 
 È la stampa, baby!
 
-## Binding
+### Binding
 
-L'azione di pinzare o cucire il libretto si dice "binding"
+L'azione di pinzare o cucire il libretto si dice "binding".
 
-## TODO
-
-aggiungere parti selfhosting
+## Markdown
 
+* Guida di riferimento: [Pandoc's Markdown](https://pandoc.org/MANUAL.html#pandocs-markdown)
diff --git a/TODO.md b/TODO.md
new file mode 100644
index 0000000..b17c24e
--- /dev/null
+++ b/TODO.md
@@ -0,0 +1,5 @@
+# Criptolibretto
+
+## TODO
+
+* selfhosting