011 Pdftk – Inserire un commento o altro testo a margine di un documento in formato PDF

11 Ottobre, 2022 (20:44) | Linux, pdftk | By: sargonsei

011 Pdftk –Inserire un commento o altro testo a margine di un documento in formato PDF.

Cose da sapere prima di procedere.
01) In questa sezione si spiega come inserire un testo in un documento PDF, cominciando dalla parte SUPERIORE SINISTRA di ciascuna pagina.
> Per FILIGRANA si intende un’immagine e/o un testo che fa da sfondo SOTTO il testo del documento; tale effetto, si ottiene quando il nome del documento da elaborare ed il nome del documento elaborato sono separati dall’opzione “background – output” (senza apici).
> Per COMMENTO si intende un testo scritto visibile SOPRA il testo del documento; tale effetto, si ottiene quando il nome del documento da elaborare ed il nome del documento elaborato sono separati dall’opzione “stamp – output” (senza apici).
> Quando occorre scrivere un commento in un numero limitato di pagine di un documento PDF, occorre prima estrarre dal documento le pagine che si desidera commentare (il procedimento è spiegato al capitolo 002), poi commentarle seguendo le istruzioni spiegate in questo capitolo della guida, infine re-inserire le pagine commentate all’interno del documento PDF (il procedimento è spiegato al capitolo 003).
> Quando occorre scrivere un commento più in basso o più a destra, occorre lavorare coi parametri
[enscript –margins=540:18:15:18] oppure spostare verso il basso il punto di inserimento del commento inserendo prima del testo dei caratteri “a capo” [\n] e può spostare verso destra il punto di inserimento del commento inserendo prima del testo dei caratteri “spazio” [ ]
> Quando occorre scrivere un commento sul margine sinistro o sul margine destro di ciascuna pagina del documento, occorre prima ruotare il documento originale (il procedimento è spiegato al capitolo 005), in modo che la parte di ogni singolo foglio del documento PDF in cui si vuole scrivere il commento, si trovi in alto.

02) Per eseguire i comandi suggeriti in questa parte della guida, occorre installare sia pdftk, sia enscript.
La cosa è fattibile tramite l’Interfaccia Grafica del Gestore delle Applicazioni, oppure da riga di comando aprendo un terminale ed impartendo i comandi
sudo apt install pdftk   # Installa PDFTK e tutte le sue dipendenze
sudo apt install enscript # Installa enscript e tutte le sue dipendenze

Per vedere cosa si può fare con ciascuno dei programmi suddetti, dopo averli installati impartire i comandi seguenti:
man pdftk   # Visualizza il manuale di PDFTK
man enscript # Visualizza il manuale di ENSCRIPT

03) ENSCRIPT consente all’utente di impostare vari parametri del FONT DI CARATTERI utilizzato.
Per i fini di questa guida, è sufficiente saper impostare: colore, tipologia, glifo, e dimensioni del carattere.
Se non si imposta nessun colore, il colore di default è il NERO, altrimenti il colore di default è l’ultimo usato, quindi basta impostare un colore all’inizio di un commento, e tutto il commento verrà scritto di quello stesso colore.
Per impostare un colore di scrittura, occorre che l’impostazione del font sia preceduta dall’opzione corrispondente al colore che si intende utilizzare; per esempio:
l’opzione @color{0 0 0} corrisponde al colore NERO
l’opzione @color{0 0 1} corrisponde al colore BLU
l’opzione @color{0 1 0} corrisponde al colore VERDE
l’opzione @color{1 0 0} corrisponde al colore ROSSO
l’opzione @color{1 1 0} corrisponde al colore GIALLO
l’opzione @color{1 0 1} corrisponde al colore MAGENTA
l’opzione @color{0 1 1} corrisponde al colore CIANO
l’opzione @color{1 1 1} corrisponde al colore BIANCO
Si precisa che la codifica del colore non ha nulla a che fare col codice binario;
ciascun numero scritto al posto del numero 1 può essere sostituito con un qualsiasi altro numero compreso fra 0 e 1;
più il numero è vicino allo 0, più il colore corrispondente è SCURO;
più il numero è vicino all’ 1, più il colore corrispondente è CHIARO;
la virgola, deve essere sostituita dal punto. Per esempio:
l’opzione @color{0.3 0.3 0.3} corrisponde al colore GRIGIO SCURO
l’opzione @color{0.6 0.6 0.6} corrisponde al colore GRIGIO CHIARO.

La tipologia è il tipo di carattere (es. Times, Courier, ecc.)
I glifi corrispondono al modo di scrivere il carattere (es. Grassetto, Inclinato, Sottolineato, ecc)
Con ENSCRIPT, l’opzione FONT è la somma di Tipologia + Glifo + Dimensioni, e deve precedere il testo del commento;
Per esempio: l’opzione Times-Italic24 corrisponde a “il testo che segue, deve essere scritto col colore di default, carattere TIMES-INCLINATO, altezza 24

Seguono alcuni esempi di impostazione del colore e font, con commento che ne spiega l’effetto.
@color{1 1 0} @font{Times-Italic12} Colore{giallo}, Font{Times-Inclinato alto 12}
@color{1 0 0} @font{Courier-Bold10} Colore{rosso}, Font{Times-Grassetto alto 10}
@color{0 1 0} Colore{verde}, Font{Tipo + Glifo + Altezza invariati rispetto all’ultimo usato}
@color{0.6 0.6 0.6} @font{Courier-Italic24} Colore{grigio chiaro}, Font{Courier-Inclinato alto 24}
@color{0 0.5 0} @font{Times-Italic9} Colore{verde scuro}, Font{Times-Inclinato alto 9}

Di default, ENSCRIPT assume che il documento di lavoro sia VERTICALE, e che il font di caratteri sia Courier10,
a meno che non sia selezionata la modalità di stampa orizzontale a più colonne, nel qual caso il carattere predefinito è Courier7.
Le opzioni di default, funzionano abbastanza bene anche se si lavora su un documento ORIZZONTALE.
L’opzione [r] adatta i comandi per funzionare bene su un documento ORIZZONTALE, ma fornisce pessimi risultati su documenti verticali.

Procedimento.
A1) Inserire un commento nella parte ALTA di un documento con opzioni di DEFAULT
Aprire un terminale all’interno della cartella in cui si trova il documento da commentare ed impartire il comando seguente:
echo -e 'Scrive questo testo con le Opzioni di default' | enscript -B -e@ -p - | ps2pdf - | pdftk Prova01.pdf stamp - output Prova01A1-default.pdf # Commenta un documento applicando opzioni di default

A2) Inserire un commento nella parte ALTA di un documento ORIZZONTALE + opzioni di DEFAULT.
Aprire un terminale all’interno della cartella in cui si trova il documento da commentare ed impartire il comando seguente:
echo -e 'Scrive questo testo su un PDF orizzontale, con le Opzioni di default' | enscript -Br -e@ -p - | ps2pdf - | pdftk Prova01.pdf stamp - output Prova01A2-ORIZ+default.pdf # Commenta un documento ORIZZONTALE applicando opzioni di default

B1) Inserire un commento nella parte BASSA di un documento con opzioni di DEFAULT
Aprire un terminale all’interno della cartella in cui si trova il documento da commentare ed impartire il comando seguente:
echo -e 'Scrive questo testo con le Opzioni di default' | enscript --margins=18:18:790:15 -B -e@ -p - | ps2pdf - | pdftk Prova01.pdf stamp - output Prova01B1-default.pdf # Commenta un documento applicando opzioni di default

B2) Inserire un commento nella parte BASSA di un documento ORIZZONTALE + opzioni di DEFAULT.
Aprire un terminale all’interno della cartella in cui si trova il documento da commentare ed impartire il comando seguente:
echo -e 'Scrive questo testo su un PDF orizzontale, con le Opzioni di default' | enscript --margins=540:18:15:18 -Br -e@ -p - | ps2pdf - | pdftk Prova01.pdf stamp - output Prova01B2-ORIZ+default.pdf # Commenta un documento ORIZZONTALE applicando opzioni di default

C1) Inserire un COMMENTO in ROSSO, usando il font{Times-Italic72} SOPRA il testo di un documento VERTICALE (DEFAULT)
Aprire un terminale all’interno della cartella in cui si trova il documento da commentare ed impartire il comando seguente:
echo -e '@color{1 0 0}@font{Times-Italic72}Scrive questo testo in ROSSO + font{Times-Italic72} + Opzioni di default' | enscript -B -e@ -p - | ps2pdf - | pdftk Prova01.pdf stamp - output Prova01C1-VERT+rosso+default.pdf # Commenta in ROSSO, usando il font{Times-Italic72}, un documento VERTICALE (DEFAULT)

C2) Inserire una FILIGRANA in ROSSO, usando il font{Times-Italic72} SOTTO il testo di un documento VERTICALE (DEFAULT)
Aprire un terminale all’interno della cartella in cui si trova il documento da commentare ed impartire il comando seguente:
echo -e '@color{1 0 0}@font{Times-Italic72}Scrive questo testo in ROSSO + font{Times-Italic72} + Opzioni di default' | enscript -B -e@ -p - | ps2pdf - | pdftk Prova01.pdf background - output Prova01C2F-VERT+rosso+default.pdf # Filigrana in ROSSO, usando il font{Times-Italic72}, un documento VERTICALE (DEFAULT)

D1) Inserire, SOTTO il testo di un documento PDF, una FILIGRANA consistente anch’essa in una pagina di un documento PDF.
Aprire un terminale nella medesima cartella in cui si trovano documento e filigrana, ed impartire il comando
pdftk Prova01.pdf background FiligranaP.pdf output Prova01D1filigranatoP.pdf

E1) Inserire un commento nella parte ALTA di un documento ORIZZONTALE usando il font Times-Italic12 + opzioni di default
Aprire un terminale all’interno della cartella in cui si trova il documento da commentare ed impartire il comando seguente:
echo -e '@font{Times-Italic12}Scrive questo testo su un documento ORIZZONTALE usando il font Times-Italic12 + Opzioni di default' | enscript -Br -e@ -p - | ps2pdf - | pdftk Prova01.pdf stamp - output Prova01E1-ORIZ+font+default.pdf # Commenta un documento ORIZZONTALE usando il font Times-Italic12 + opzioni di default

E2) Inserire un commento in GRIGIO CHIARO, usando il font Courier-Bold10, nella parte ALTA di un documento VERTICALE (DEFAULT)
Aprire un terminale all’interno della cartella in cui si trova il documento da commentare ed impartire il comando seguente:
echo -e '@color{0.7 0.7 0.7} @font{Courier-Bold10}Scrive questo testo su un documento VERTICALE (DEFAULT) in GRIGIO CHIARO, usando il font Courier-Bold10' | enscript -B -e@ -p - | ps2pdf - | pdftk Prova01.pdf stamp - output Prova01E2-VERT+Gri+font.pdf # Commenta in GRIGIO CHIARO, usando il font Courier-Bold10, nella parte ALTA di un documento VERTICALE (DEFAULT)

F) Inserire un commento in GRIGIO CHIARO, usando il font Courier-Bold10, nella parte ALTA di un documento ORIZZONTALE
Aprire un terminale all’interno della cartella in cui si trova il documento da commentare ed impartire il comando seguente:
echo -e '@color{0.7 0.7 0.7} @font{Courier-Bold10}Scrive questo testo su un documento ORIZZONTALE in GRIGIO CHIARO, usando il font Courier-Bold10' | enscript -Br -e@ -p - | ps2pdf - | pdftk Prova01.pdf stamp - output Prova01F-ORIZ+Gri+font.pdf # Commenta in GRIGIO CHIARO, usando il font Courier-Bold10, nella parte ALTA di un documento ORIZZONTALE

G) Inserire due righe di commento, nella parte ALTA di un documento VERTICALE (DEFAULT), usando colori e font diversi.
Aprire un terminale all’interno della cartella in cui si trova il documento da commentare ed impartire il comando seguente:
echo -e '@color{0 0 1} @font{Courier-Bold12}Scrive questo testo su un documento VERTICALE (DEFAULT) in BLU, usando il font Courier-Bold12,\n@color{0 1 0} @font{Arial-Italic14}Mentre questo è scritto in VERDE, usando il font Arial-Italic14' | enscript -B -e@ -p - | ps2pdf - | pdftk Prova01.pdf stamp - output Prova01G-VERT+2righe.pdf # Inserire due righe di commento, nella parte ALTA di un documento VERTICALE (DEFAULT), usando colori e font diversi.

H) Inserire due righe di commento, nella parte ALTA di un documento ORIZZONTALE, usando colori e font diversi.
Aprire un terminale all’interno della cartella in cui si trova il documento da commentare ed impartire il comando seguente:
echo -e '@color{0 0 1} @font{Courier-Bold12}Scrive questo testo su un documento ORIZZONTALE in BLU, usando il font Courier-Bold12,\n@color{0 1 0} @font{Arial-Italic14}Mentre questo è scritto in VERDE, usando il font Arial-Italic14' | enscript -Br -e@ -p - | ps2pdf - | pdftk Prova01.pdf stamp - output Prova01H-ORIZ+2righe.pdf # Inserire due righe di commento, nella parte ALTA di un documento ORIZZONTALE, usando colori e font diversi.

I) Inserire 3 righe di commento COLORATO nella parte ALTA di un documento VERTICALE (DEFAULT)
Aprire un terminale all’interno della cartella in cui si trova il documento da commentare ed impartire il comando seguente:
echo -e '@color{1 1 0} @font{Times-Italic12}(1 1 0) Riga 1 giallo, @color{1 0 1} @font{Times-Italic12}(1 0 1) Riga 1 Magenta, @color{0 1 1} @font{Times-Italic12}(0 1 1) Riga 1 Ciano, @color{0 0 0} @font{Times-Italic12}(0 0 0) Riga 1 Nero,\n@font{Courier-Bold10} @color{1 0 0} (1 0 0) Riga 2 rosso, @color{0 1 0} (0 1 0) Riga 2 Verde, @color{0 0 1} (0 0 1) Riga 2 Blu, @color{1 1 1} (1 1 1) Riga 2 Bianco, @color{0.5 0.5 0.5} (0.5 0.5 0.5) Riga 2 grigio, \n@font{Times-Bold10} @color{0.5 0 0} (0.5 0 0) Riga 3 rosso sc., @color{0 0.5 0} (0 0.5 0) Riga 3 Verde sc., @color{0 0 0.5} (0 0 0.5) Riga 3 Blu sc, @color{0.3 0.3 0.3} (0.3 0.3 0.3) Riga 3 Grigio sc., @color{0.7 0.7 0.7} (0.7 0.7 0.7) Riga 3 Grigio ch..' | enscript -B -e@ -p - | ps2pdf - | pdftk Prova01.pdf stamp - output Prova01I-Vert3righe.pdf

J) Inserire 3 righe di commento COLORATO nella parte ALTA di un documento ORIZZONTALE
Aprire un terminale all’interno della cartella in cui si trova il documento da commentare ed impartire il comando seguente:
echo -e '@color{1 1 0} @font{Times-Italic12}(1 1 0) Riga 1 giallo, @color{1 0 1} @font{Times-Italic12}(1 0 1) Riga 1 Magenta, @color{0 1 1} @font{Times-Italic12}(0 1 1) Riga 1 Ciano, @color{0 0 0} @font{Times-Italic12}(0 0 0) Riga 1 Nero,\n@font{Courier-Bold10} @color{1 0 0} (1 0 0) Riga 2 rosso, @color{0 1 0} (0 1 0) Riga 2 Verde, @color{0 0 1} (0 0 1) Riga 2 Blu, @color{1 1 1} (1 1 1) Riga 2 Bianco, @color{0.5 0.5 0.5} (0.5 0.5 0.5) Riga 2 grigio, \n@font{Times-Bold10} @color{0.5 0 0} (0.5 0 0) Riga 3 rosso sc., @color{0 0.5 0} (0 0.5 0) Riga 3 Verde sc., @color{0 0 0.5} (0 0 0.5) Riga 3 Blu sc, @color{0.3 0.3 0.3} (0.3 0.3 0.3) Riga 3 Grigio sc., @color{0.7 0.7 0.7} (0.7 0.7 0.7) Riga 3 Grigio ch..' | enscript -Br -e@ -p - | ps2pdf - | pdftk Prova01.pdf stamp - output Prova01J-orizz3righe.pdf

K) Inserire 2 righe di commento contenute in variabili.
Aprire un terminale all’interno della cartella in cui si trova il documento da commentare ed impartire il comando seguente:
ALFA='Commento scritto su 2 righe'; ACAPO='\n'; BETA='unendo 3 variabili'; GAMMA=$ALFA$ACAPO$BETA; echo $GAMMA; echo -e $GAMMA | enscript -B -e@ -p - | ps2pdf - | pdftk Prova01.pdf stamp - output Prova01K-var.pdf # Commenta un documento usando delle variabili e applicando opzioni di default

#
# 011s01 pdftk – SCRIPT in grado di distinguere se la pagina è orizzontale o verticale, e commentarla di conseguenza.
http://sargonsei.altervista.org/011s01-pdftk/
#
# 011s02 pdftk – SCRIPT in grado di distinguere se la pagina è orizzontale o verticale, e commentarla di conseguenza mediante VARIABILI.
http://sargonsei.altervista.org/011s02-pdftk/