HTMLDoc: PDF à partir du balisage HTML (UNIX FreeBSD)

• Mettre à jour FreeBSD 11.2 (x64)
• Installer et initialiser la collection de ports
• Installer HTMLDoc
• Installer Nano
• Génération de votre premier document PDF à partir du balisage HTML

Avez-vous déjà voulu pouvoir générer des fichiers PDF à la volée sans avoir à passer des heures à configurer votre environnement de serveur? HTMLDoc transformera dynamiquement le balisage correctement formé (HTML 3.2) en PostScript (PDF 1.6).

Pour cet exemple, nous utiliserons FreeBSD 11.2 (x64) de Vultr avec IPv4, bien que tout fonctionne de la même manière avec des serveurs IPv6 uniquement. Gardez à l'esprit que nous travaillons avec une toute nouvelle installation de FreeBSD, et en tant que telle, nous passerons par les étapes de configuration d'une machine FreeBSD pour prendre correctement et en toute sécurité de nouvelles applications telles que HTMLDoc.

Mettre à jour FreeBSD 11.2 (x64)

Tout d'abord, sur FreeBSD, nous devons mettre à jour le système si vous ne l'avez pas déjà fait. Connectez-vous en tant que rootet exécutez les deux commandes suivantes, la première commande recherchera et récupérera les mises à jour, si elles sont disponibles, tandis que la deuxième commande n'est utile que pour installer une mise à jour si en effet une a été récupérée.

freebsd-update fetch
freebsd-update install

Remarque: Lorsque vous voyez des options d'installation ou de configuration, utilisez simplement les choix par défaut. De plus, lorsque vous posez des questions O / N, répondez simplement Y à toutes les invites.

Installer et initialiser la collection de ports

Tout d'abord, récupérez les mises à jour pour la collection de ports. Cette étape prendra plusieurs minutes.

portsnap fetch extract

Une fois ce processus terminé, nous verrons la sortie suivante.

Building new INDEX files... done.

Maintenant, nous installons les mises à jour que nous venons de récupérer.

portsnap fetch update

Ensuite, nous installons portmaster.

cd /usr/ports/ports-mgmt/portmaster
make install clean

Maintenant que nous avons installé portmaster, une application qui nous aide à installer des applications de la collection de ports, nous pouvons mettre à jour tous les ports obsolètes de notre système.

portmaster -a

C'est un processus très long, mais en tant que tel, c'est en effet le meilleur processus pour mettre votre machine à jour, sécurisée et prête à installer HTMLDoc et, à son tour, produire des PDF à la volée. Ce processus prendra certainement plusieurs minutes, jusqu'à 30 minutes.

Si des erreurs sont rencontrées au cours de ce processus, ajoutez simplement le –fcommutateur, qui mettra à niveau et reconstruira tous les ports, essentiellement:

portsnap -af

La mise à jour est effectuée lorsque vous voyez la sortie suivante.

===>>> Done displaying pkg-message files

Installer HTMLDoc

Maintenant, nous pouvons installer HTMLDoc à partir de la collection de ports. Il vous sera demandé si vous souhaitez ajouter l'interface graphique à l'application. Ceci est entièrement facultatif. Toutes les autres options devraient être laissées par défaut, et passer simplement par les mouvements d'installation de toutes les dépendances pour HTMLDoc. Vous remarquerez de nombreuses dépendances, telles que le support PNG animé, jpeg-turbo, Babel, NASM, CMake, py27 et bien plus encore, y compris curl. C'est pourquoi nous mettons à jour le système avant d'installer HTMLDoc, car il existe un certain nombre de dépendances qui peuvent entraîner des problèmes d'installation si le système n'est pas à jour. Cette étape prendra le plus de temps.

cd /usr/ports/textproc/p5-HTML-HTMLDoc/ && make install clean

Enfin, lorsque vous voyez les lignes suivantes affichées, nous avons terminé d'installer HTMLDoc:

===>  Cleaning for p5-HTML-HTMLDoc-0.10_2

Installer Nano

Puisque l'exemple suivant utilise Nano, nous allons l'installer et le lier maintenant, comme ça.

cd /usr/ports/editors/nano && make install clean
ln -s /usr/local/bin/nano /usr/bin/nano

Génération de votre premier document PDF à partir du balisage HTML

Passons à /tmp/pour jouer et tester HTMLDoc.

cd /tmp/

Maintenant, créons un simple document HTML que nous utiliserons pour générer un document PDF, appelons-le markup-source.html.

nano markup-source.html

Ajoutez le balisage HTML suivant.

<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>

Enregistrez le fichier en appuyant sur CTRL+ Xpour quitter l'éditeur Nano, appuyez sur Ypuis sur ENTERpour enregistrer vos modifications. Vous pouvez maintenant demander à HTMLDoc, via la ligne de commande, d'analyser un document PDF à partir de votre markup-source.htmlfichier.

htmldoc --webpage -f postscript-output.pdf markup-source.html

Vous aurez maintenant un nouveau fichier nommé postscript-output.pdfdans le /tmp/répertoire, avec un titre de "Mon premier PDF à partir de HTML" et un corps de "Ceci est le corps de mon premier document PDF à partir de HTML".