Articles SPIP au format PDF Nouvelle version

All contributions published for previous SPIP versions

Cette contribution est largement inspirée de celle-ci : Génération améliorée de fichiers PDF
et de celle-ci :Génération de PDF pour SPIP - Drop Zone City

Je vous invite donc à lire ces contributions avant la mienne.

Installation

Vous trouverez en pièce-jointe (prenez l’archive intitulée PDF Nouvelle Version), les fichiers nécessaires à la génération des articles au format PDF.
N’oubliez pas de créer un dossier nommé : _article_PDF dans le répertoire IMG et de lui attribuer les permissions à 777 (comme vous l’aviez fait lors de l’installation de SPIP pour le répertoire IMG par exemple).

Ensuite, vous installez les fichiers joints à la racine de votre site SPIP.

Attention : Si vous utilisez déjà un fichier mes _fonctions.php3, recopiez le code contenu dans notre fichier mes_fonctions.php3 entre les balises <?php et ?> dans votre fichier mes_fonctions.php3.

Puis, faîtes un lien dans votre squelette article.html vers article_pdf.php3 comme ceci :

<a href="article_pdf.php3?id_article=#ID_ARTICLE" target="_blank">Voir au format PDF</a>

Démo articles SPIP au format PDF

Voici un récapitulatif des fonctionnalités ajoutées aux PDF :

-  Les PDF se régénèrent automatiquement quand vous modifiez un article, alors qu’avec les contrib. proposées vous devez effacer à la main les pdf dans votre dossier IMG/_article_PDF à chaque fois que vous modifiez un article.

-  Le problème de titre trop long qui était coupé et donc qui ne revenait pas à la ligne a été corrigé.

-  Amélioration de la génération de certains caractères spéciaux.

-  Les logos d’articles apparaissent correctement, par contre il faut que je règle le problème de liens sur les logos, pour l’instant, j’ai tout simplement retiré les liens qui finalement ne servent à rien.

-  Les images insérées dans les articles apparaissent correctement.

-  Cette contribution est compatible avec la contribution : Découper un article en plusieurs pages et lui ajouter un sommaire, ainsi les <hr> générés n’apparaissent pas dans le pdf.

-  Les fichiers au format GIF sont gérés de 2 façons. Soit en pur PHP et le résultat n’est pas terrible bien qu’il reste utilisable. Soit, avec utilisation de la librairie GD dans une version capable de manipuler les GIF, et la, vous aurez un resultat parfait.

-  Les fichiers PNG avec couche Alpha sont gérés mais le fichier PNG généré dans le PDF aura forcément un fond blanc ### On peut peut être ressortir la couleur dans une variable en tête de fichier si qq1 veut pouvoir la changer facilement ###

-  Nous utilisons la dernière version de FPDF qui est à l’heure où parait cet article la 1.53. Pour plus d’infos sur l’historique des versions, il faut se rendre ici.

Un PDF simplifié sans page de garde

Vous trouverez aussi en pièce-jointe le fichier permettant de générer un article au format PDF, de présentation plus simple, sans page de garde.

Installation :

Pour cela, vous installez comme décrit précédemment le “package PDF Nouvelle Version”, puis il suffit de remplacer le fichier lib_pdf_spip.php qui se situe
dans le répertoire : lib/class_pdf
par celui fourni en pièce jointe (dont le titre du zip est PDF simple sans page de garde).

Vous obtiendrez alors un fichier simple sans page de garde, avec un footer (pied de page) où l’on retrouve l’auteur, le nombre de pages, la date de publication et le nom du site.

Vous pourrez facilement modifier la taille et le type de police et les espaces entre chaque balise surtitre, titre sous-titre et texte.

Exemple :

//Titre
$this->SetFont(’helvetica’,’B’,12);
$this->WriteHTML($titre);
$this->Ln(12);

-  SetFont permet de définir la police B=Gras 12=Taille (comme d’habitude)
-  WriteHTML sert à transformer les balises html en codes interprétables par le PDF
-  Ln(12) = Effectue un saut de ligne, et 12 = amplitude du saut de ligne.

Pour plus d’infos, aller sur http://www.fpdf.org

Pour aller plus loin : ajouter des champs extra dans la génération des PDF

Pour ce qui est des champs extras, il faut les déclarer dans le fichier : lib_pdf_spip.php comme ceci :

ligne 137 remplacer : global $texte, $chapo, $ps, $notes ; par : global $texte, $chapo, $extra, $ps, $notes ;

ligne 146 environ, ajoutez en dessous de ce code :

//Texte - justifie $this->SetFont('helvetica','',10) ; $this->WriteHTML($texte) ; $this->Ln(12) ;

le code suivant :

if ($extra) // extra $this->SetFont('helvetica','',10) ; $this->WriteHTML($extra) ; $this->Ln(12) ; 

Dans cet exemple, les champs extra apparaitront dans vos pdf sous le texte de l’article et avant le Post-scriptum de l’article.
Vous pouvez donc positionner le code ci-dessous ailleurs, avant le texte de l’article, avant le chapo, après le PS...

et dans article_pdf.html : ligne 11 : insérez en dessous de :

$conf_nom_site = "[(#NOM_SITE_SPIP|pdf_first_clean)]" ;

Les champs extras que vous voulez faire apparaitre, ici un exemple avec 2 champs extra (Mission, Competences) :

$extra = "Missions : "."[(#EXTRA|Mission|pdf_first_clean)]"."
"."Compétences : "."[(#EXTRA|Competences|pdf_first_clean)] ;

Vous ajoutez ainsi autant de champs extra que vous le souhaitez.

Pour plus d’infos sur les champs extra, allez dans la partie privé de spip-contrib.net et faites une recherche sur extra, vous trouverez toute la doc sur les champs extra et leur utilisation.

Voilà, je crois que je n’ai rien oublié, à part vous dire que cette contribution n’est qu’une collecte d’infos glanées sur spip-contrib et ses forums.
Donc je ne suis qu’un assembleur de ce que j’ai trouvé et non le créateur (juste des petits bouts ici et là). Merci à Chag qui a complété cette contrib. en améliorant la gestion des images, des tableaux et en intégrant la dernière version de FPDF.

Intégration des images dans les PDF grâce à la librairie GD

Commençons par rendre à César ce qui appartient à César. Ces modifications sont inspirées de ce commentaire.Cette librairie de manipulation d’images permet d’améliorer la qualité de certaines images intégrées dans les PDF. Les formats de fichiers concernés sont :

-  GIF (Graphics Interchange Format). Ce format d’image était soumis à licence. Afin de ne pas risquer de poursuites et pour ne pas payer, la librairie GD ne manipulait plus les fichiers GIF entre sa version 1.6.0 (correspondant à la date à laquelle UNISYS a commencé à vouloir faire payer les utilisateurs) et la version 2.0.28 (date à laquelle son algorithme principal est passé dans le domaine public). L’avantage de la librairie GD est qu’elle manipule très bien les images au format GIF. Pour savoir si vous pouvez l’utiliser, utilisez la commande <?PHP phpinfo(); ?>dans une page. Vous devriez obtenir plusieurs rubriques dont une qui concerne GD et qui pourrait ressembler à ca :

GD Support enabled
GD Version bundled (2.0.28 compatible)
FreeType Support enabled
FreeType Linkage with freetype
GIF Read Support enabled
GIF Create Support enabled
JPG Support enabled
PNG Support enabled
WBMP Support enabled
XBM Support enabled

Il faut au moins que le support des GIF en lecture soit possible pour pouvoir utiliser la librairie GD.

Que ce soit le cas ou pas, notre modification pourra inclure dans le fichier PDF une image au format GIF. Mais elle sera plus belle avec l’utilisation de GD :)

-  PNG (Portable Network Graphics) : Quand UNISYS a commencé à vouloir faire payer des licences pour le format GIF, le format PNG a émmergé. La librairie FPDF utilisée pour créer les PDF de cette contribution sait déjà gérer les fichier PNG. Mais pas les PNG avec couche alpha. Pour résumer, la couche Alpha, c’est une méthode de transparence sur les images qui permet d’avoir des parties plus ou moins transparentes. Notre modification dans la librairie permet de gérer les fichiers PNG avec couche Alpha. le fichier sera obligatoirement replacé sur un fond blanc.

Même si vous n’avez pas l’impression/l’intention d’utiliser d’images PNG avec canal alpha, sachez par exemple que, si vous ajoutez un document PDF à un article, son icône est un PNG avec canal Alpha.

Sur l’image suivante, vous pouvez comparer 2 captures d’écran de PDF générés à partir de SPIP. Le premier ne gère pas correctement le canal alpha. Le second, si.

Chag http://www.gaiaservice.fr

Paul http://www.netdeveloppeur.com

En pièces-jointes se trouvent 3 archives, utilisez celle intitulée : PDF Nouvelle Version, si elle ne fonctionne pas chez vous, testez celle intitulée PDF Ancienne Version.

updated on 11 February 2007

Discussion

32 discussions

  • François Coulier

    Un truc qui serait bien, ce serait de pouvoir récupérer cet article au format PDF..
    (la nouvelle mise en page me pose des problèmes pour imprimer....)

    François

    Reply to this message

  • 6

    Cela donne un bon résultat sur SPIP 1.7.2, mais les photos insérées dans l’article d’origine n’apparaissent dans la version PDF

    • Salut,

      Je trouve ça bizarre, cette contrib. a été testée par pas mal de personnes et je n’ai eu aucun retour de ce genre, tu peux voir un exemple ici et tu cliques sur l’icone pdf qui se trouve à droite juste au dessus du titre de l’article :

      http://paul.1formatik.com/emploi/article.php3?id_article=269

      Envois-moi une adresse pour voir et/ou tes fichiers.

      Est-ce que tu inséres tes images dans les articles avec la méthode de SPIP ou utilises-tu un éditeur (type FckEditor, HtmlArea) ?

    • Je viens de voir le lien vers ton site.
      Tu es sur que tu as mis le zip qui est fourni avec cette contrib.?

      Parceque j’ai ouvert sur ton site le fichier article_pdf.html, et ce n’est pas le même que celui du zip.

    • Bonjour,

      Pour ce qui est de l’insertion des photos, j’utilise le système de SPIP, donc de ce coté, normalement, pas de problème.

      Une petite phrase me fait bondir, c’est lorsque l’ont me dit que ma page article_pdf n’est pas la bonne ! C’est étonnant ! C’est celle que j’ai trouvée dans le lien tout en haut de la page. Voici d’ailleur le début de vottre article = “Cette contribution est largement inspirée de celle-ci : Génération améliorée de fichiers PDF et de celle-ci : Génération de PDF pour SPIP - Drop Zone City” => j’ai cliqué là et j’ai eu mes fichiers !

    • Je vien d’apporter les modifs en mettant les fichiers des icones de téléchargement du bas de page.

      Pour ce qui concerne ma rubrique Jules VERNE, le Logo de Jules VERNE apparait en PDF, mes les photos d’autres articles, toujours pas. Je soupçonne que mon serveur me fait de superbes misères.

      Je vais voir à l’occasion si il y a un moyen de résoudre le problème

    • Francis,

      Tu as bien pris le zip en bas à gauche, tu suis les instructions d’install. de la contrib à la lettre et ça devrait fonctionner.

      Surtout, effaces avant de faire l’install tes anciens fichiers et vérifie que tu as bien le fichier mes_fonctions.php3 avec le code correct que je fourni aussi dans le zip.

      Si malgré tout, ça ne fonctionne pas, faudrai que je puisse jeter un oeil à ton install. si tu es d’accord bien sûr.

      @+

    • C’est ce que j’ai fait ce matin, est c’était la catastrophe ! Des erreurs pleins pot ! Lors de l’affichage d’un article, pris au hasard, le système me mettait une belle erreurs en ce qui concerne le logo de l’article (*.png), mais avec cette subtilité = cette anomalie ne se faisait pas avec tous les articles ! De toute façon, cela vient principalement de ce foutu serveur Wanadoo Premium qui est particulierement mal paramétré par Wanadoo. Un exemple concret = le portail Guppy, qui fonctionne très bien sur FREE, est une véritable catastrophe sur wanadoo premium ! C’est une vrai galère, ce serveur !

      C’est pour cela que j’ai désactiver cette option PDF qui est pourtant quelque chose de bien.

      Au passage, connait-tu un lien où je pourrait trouvait un squelette pour imprimer un article SPIP ? J’ai veinement cherché, j’ai rien trouvé. Ce serait une option super pratique ! Peut-être ai-je mal cherché ?

    Reply to this message

Comment on this article

Who are you?
  • [Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom