Hai mai desiderato essere in grado di generare file PDF al volo senza dover passare ore a configurare il tuo ambiente server? HTMLDoc trasformerà Markup (HTML 3.2) correttamente formato in PostScript (PDF 1.6), in modo dinamico.
Per questo esempio, utilizzeremo FreeBSD 11.2 (x64) di Vultr con IPv4, sebbene tutto funzioni allo stesso modo con solo i server IPv6. Tieni presente che stiamo lavorando con una nuovissima installazione di FreeBSD e come tale seguiremo i passaggi della configurazione di una macchina FreeBSD per affrontare in modo corretto e sicuro nuove applicazioni come HTMLDoc.
Aggiorna FreeBSD 11.2 (x64)
Per prima cosa, su FreeBSD dobbiamo aggiornare il sistema se non l'hai già fatto. Accedi come root
ed esegui i due comandi seguenti, il primo comando cercherà e recupererà gli aggiornamenti, se disponibili, mentre il secondo comando è utile solo per installare un aggiornamento se effettivamente è stato recuperato.
freebsd-update fetch
freebsd-update install
Nota: quando vengono presentate le opzioni di installazione o configurazione, utilizzare semplicemente le opzioni predefinite. Inoltre, quando vengono poste domande S / N, è sufficiente rispondere a Y in tutte le istruzioni.
Installa e inizializza la collezione di porte
Innanzitutto, recupera gli aggiornamenti per la raccolta porte. Questo passaggio richiederà alcuni minuti.
portsnap fetch extract
Una volta fatto questo processo, vedremo il seguente output.
Building new INDEX files... done.
Ora installiamo gli aggiornamenti che abbiamo appena recuperato.
portsnap fetch update
Quindi, installiamo portmaster.
cd /usr/ports/ports-mgmt/portmaster
make install clean
Ora che abbiamo installato portmaster, un'applicazione che ci aiuta a installare applicazioni dalla collezione di porte, possiamo aggiornare tutte le porte obsolete nel nostro sistema.
portmaster -a
Si tratta di un processo molto lungo, ma come tale è sicuramente il processo migliore per aggiornare la macchina, renderla sicura e pronta per installare HTMLDoc e, a sua volta, sfornare i PDF al volo. Questo processo richiederà sicuramente alcuni minuti, fino a 30 minuti.
Se si verificano errori durante questo processo, basta aggiungere lo –f
switch, che aggiornerà e ricostruirà tutte le porte, in sostanza:
portsnap -af
L'aggiornamento viene eseguito quando viene visualizzato il seguente output.
===>>> Done displaying pkg-message files
Installazione di HTMLDoc
Ora, possiamo installare HTMLDoc dalla collezione di porte. Ti verrà chiesto se desideri aggiungere il front-end della GUI all'applicazione. Questo è del tutto facoltativo. Tutte le altre opzioni dovrebbero essere lasciate ai valori predefiniti e seguire semplicemente i movimenti di installazione di tutte le dipendenze per HTMLDoc. Noterai molte dipendenze, come il supporto PNG animato, jpeg-turbo, Babel, NASM, CMake, py27 e molto altro, incluso l'arricciatura. Questo è il motivo per cui aggiorniamo il sistema prima di installare HTMLDoc, poiché esistono numerose dipendenze che possono causare problemi di installazione se il sistema non è aggiornato. Questo passaggio richiederà più tempo.
cd /usr/ports/textproc/p5-HTML-HTMLDoc/ && make install clean
Alla fine, quando vengono visualizzate le seguenti righe, abbiamo finito di installare HTMLDoc:
===> Cleaning for p5-HTML-HTMLDoc-0.10_2
Installa Nano
Poiché il prossimo esempio usa Nano, lo installeremo e lo collegheremo ora, in questo modo.
cd /usr/ports/editors/nano && make install clean
ln -s /usr/local/bin/nano /usr/bin/nano
Generare il tuo primo documento PDF dal markup HTML
Passiamo a /tmp/
per giocare e testare HTMLDoc.
cd /tmp/
Ora creiamo un semplice documento HTML che useremo per generare un documento PDF, chiamiamolo markup-source.html
.
nano markup-source.html
Aggiungi il seguente markup HTML.
<html>
<head>
<title>My first PDF from HTML</title>
</head>
<body>
This is the body of my first PDF document made from HTML.
</body>
</html>
Salvare il file premendo CTRL+ Xper uscire dall'editor Nano, premere Yseguito da ENTERper salvare le modifiche. Ora puoi istruire HTMLDoc, tramite la riga di comando, ad analizzare un documento PDF dal tuo markup-source.html
file.
htmldoc --webpage -f postscript-output.pdf markup-source.html
Ora avrai un nuovo file chiamato postscript-output.pdf
nella /tmp/
directory, con un titolo di "Il mio primo PDF da HTML" e un corpo di "Questo è il corpo del mio primo documento PDF fatto da HTML".