Esportare Markdown in PDF dal browser
Ci sono due modi in cui un browser può produrre un PDF da una pagina web, e non sono altrettanto buoni.
Il primo è rendere la pagina come immagine e avvolgere l’immagine in un PDF. Le librerie che lo fanno sono facili da aggiungere, e il risultato è un file in cui il testo non è più testo: non puoi selezionarlo, cercarlo o copiarne una riga, e il file pesa parecchie volte più del necessario.
Il secondo è stampare la pagina e scegliere «Salva come PDF» come destinazione. Il browser impagina il documento per la carta, rispetta il foglio di stile di stampa e scrive vero testo vettoriale. Costa un clic in più e produce un file davvero migliore, quindi è quello che succede qui quando premi Salva come PDF.
Le quattro impostazioni che contano
Tutto quel che segue sta nella finestra di stampa, non nella pagina, perché nessun foglio di stile può impostarlo.
Destinazione: Salva come PDF. Non una stampante fisica.
Grafica di sfondo: attiva. Sta sotto Altre impostazioni ed è quella che sfugge a tutti. Se è disattivata il browser scarta ogni riempimento di sfondo: i blocchi di codice perdono la loro sfumatura, le intestazioni delle tabelle diventano bianche e un PDF con tema scuro esce come carta bianca con sopra testo bianco, che sembra un’esportazione rotta e non un’impostazione.
Intestazioni e piè di pagina: disattivati. Quell’opzione è il browser che aggiunge di sua iniziativa l’URL della pagina e la data. Se hai impostato una tua intestazione o un tuo piè di pagina, i due si scontrano. Disattiva quelli del browser e tieni i tuoi, oppure fai il contrario se vuoi i numeri di pagina, di cui si parla più sotto.
Scala: 100% o Predefinita. «Adatta alla pagina» riscala il carattere e manda fuori posto i margini, e sono i margini a determinare lo spazio di intestazione e piè di pagina.
Perché a volte sparisce il controllo della scala
Se un documento dichiara un formato carta fisso, Chrome considera la carta già decisa dall’autore e nasconde del tutto il controllo della scala. Non è un difetto del browser né della pagina: è la conseguenza del fatto che il documento si sia sbilanciato.
Quindi la carta è una scelta: A4, Letter o Predefinita della stampante. Le prime due chiedono un formato e perdi la scala. La terza non chiede nulla e la scala torna. I margini sono impostati dal documento in tutti e tre i casi, quindi un’intestazione o un piè di pagina mantiene il suo spazio comunque.
Intestazioni e piè di pagina ripetuti
Un’intestazione ripetuta torna su ogni pagina. In un browser questo si fa con un elemento a posizione fissa, che secondo la specifica si ripete su ogni foglio di un supporto impaginato.
La sottigliezza è riservargli spazio. L’approccio ovvio — spaziatura interna in cima al corpo del documento — riserva lo spazio una volta sola, perché il corpo è un’unica scatola per quante pagine occupi in stampa. Funziona a pagina uno e dalla due in poi l’intestazione si siede sopra il testo.
La soluzione è riservare lo spazio nel margine di @page, che si applica per pagina, e
collocare la barra dentro quel margine con uno scostamento negativo. È quello che fa la zona
di timbratura, e allarga il margine solo sul bordo che porta davvero una barra.
Ciascuno dei quattro campi — intestazione sinistra, intestazione destra, piè sinistro, piè destro — accetta il testo che vuoi, più segnaposto riempiti al momento della stampa:
{title}— il primo titolo o la prima riga del documento{date},{time},{datetime}— quando è stato fatto il PDF
Niente numeri di pagina, e perché
Deliberatamente non c’è un segnaposto {page}. Contare le pagine dentro un elemento ripetuto
non è qualcosa che un browser sappia fare: counter(page) si risolve solo dentro le caselle
di margine di @page, e nessun browser importante le implementa. Un segnaposto che stampasse
silenziosamente nulla sarebbe peggio di nessun segnaposto.
Se ti servono i numeri di pagina, li aggiunge l’opzione di intestazioni e piè di pagina del browser. Usa quella al posto di un timbro, oppure accettali entrambi e lasciali su bordi opposti.
PDF scuri
L’opzione scura inverte la pagina — carta nera, inchiostro bianco — e lascia in pace gli altri colori. Un’eccezione voluta: il colore dei link viene schiarito, perché il blu del tema chiaro sta a circa 2,5:1 contro il nero ed è illeggibile. Mantiene la sua tinta e guadagna contrasto.
Ricordati della grafica di sfondo. Un PDF scuro stampato senza è una pagina bianca.