SPIP - Contrib

SPIP - Contrib

[ar] [en] [es] [fr] [it]

101 visiteurs en ce moment

fontsizeup fontsizedown
Accueil du site > Contribs > Rédaction > Imprimer et PDF > Archives Imprimer > Articles SPIP au format PDF Nouvelle version
[90 commentaires]

Articles SPIP au format PDF Nouvelle version

dimanche 2 octobre 2005, par chag, Paul Sanches

Toutes les versions de cet article : [Español] [français] [français] [français]

1 vote

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.

PNG - 22.4 ko

Chag http://www.gaiaservice.fr

Paul http://www.netdeveloppeur.com

P.-S.

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.

Retour en haut de la page

90 Messages de forum

Voir toute la discussion

Pages 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9

  • Répondre à ce message

    7 novembre 2008 13:39 , par alinux
    Articles SPIP au format PDF Nouvelle version

    Bonjour,

    Est-ce que ce plugin est compatible avec FCKEDITOR... ?

    Merci d’avance

  • Répondre à ce message

    1er août 2007 11:01 , par Philippe abou Yann
    Articles SPIP au format PDF Nouvelle version

    pour ton probleme d’apostrophe, je te conseille d’utiliser la pokice cp1252 à la place de UTF8 en changeant dans mes_fonctions.php :

    // Convertion du codage UTF-8 (SPIP 1.9) en ANSI

    $texte = Array2charset(utf_8_to_Array($texte), "cp1252") ;

    en plus, il contient le caractère "€"

  • Répondre à ce message

    16 juillet 2007 21:13
    Sous PHP 5

    Suite au passage de notre intranet sous PHP 5, la génération des PDF ne marchait plus s’il y avait des images.

    Un petit débuggage m’a permis de corriger le code du fichier gif.php (dans le répertoire /lib/classe_pdf de SPIP) :

    - tous les appels de fonction avec initialisation lors de l’appel d’une variable passée en référence ne retourne pas la valeur modifiée (l’appel doit créer une variable anonyme en lui affectant la valeur initialisée, perdant ainsi le lien avec la variables que l’on souhaite référencer).

    ex :

    if(!$this->m_gih->load($data, $len = 0)) return false ;

    ne retourne plus la valeur attendue dans $len (reste à 0), il faut maintenant :

    $len = 0 ; if(!$this->m_gih->load($data, $len)) return false ;

    Il y en a plusieurs dans le fichier gif.php .

  • Répondre à ce message

    3 juillet 2007 15:19 , par fleg
    > Image trop grande

    Par rapport a l’ erreur FPDF error : GIF parser : unable to open file j’ai eu le meme probleme. Ca venait du passage a php5. En effet, dans la librairie gif.php il y a un certain nombre d’ appels de fonction avec une initialisation de variable dans l’ appel : ex :$this->m_img->load($this->m_lpData, $imgLen = 0) Or, ces fonctions doivent retourner une valeur de ce parametre en sortie (passage par reference). En php4, il semble que l’ affectation de la variable se fasse AVANT l’ appel de la fonction alors qu’ en php5 elle se fait APRES... conclusion, $imgLen est remise a zero. Qui plus est, ces affectations dans l’ appel sont inutiles car les fonctions appellees font deja l’ initialisation.

    Il suffit donc de supprimer l’ affectation dans l’ appel. Ca revient a modifier comme suit le fichier gif.php :

    612c614
    <                               if(!$this->skipExt($data, $len)) {
    ---
    >  
                                if(!$this->skipExt($data, $len = 0)) {
    620c622
    <                               if(!$this->m_gih->load($data, $len)) {
    ---
    >
                                  if(!$this->m_gih->load($data, $len = 0)) {
    627c629
    <                               if(!($this->m_data = $this->m_lzw->deCompress($data, $len))) {
    ---
    >                               if(!($this->m_data = $this->m_lzw->deCompress($data, $len = 0))) {

    778c780
    <               if(!$this->m_gfh->load($this->m_lpData, $len)) {
    ---
    >               if(!$this->m_gfh->load($this->m_lpData, $len = 0)) {

    784c786
    <                       if(!$this->m_img->load($this->m_lpData, $imgLen)) {
    ---
    >                       if(!$this->m_img->load($this->m_lpData, $imgLen = 0)) {

    806c808
    <               if(!$gfh->load($data, $len)) {
    ---
    >               if(!$gfh->load($data, $len = 0)) {

  • Répondre à ce message

    15 mai 2007 12:04 , par dcartron
    toujours caractères spéciaux : apostrophe ’

    chez moi les apostrophes sont remplacées par rien du tout, les mots sont collés

  • Répondre à ce message

    5 novembre 2006 13:10 , par aurelboiss
    Accent sous SPIP 1.9 + correctif pour les

    Salut, cette modife dans mon fichier mes_fontions.php me fait le même effet qu’une autre contrib pour avoir les PDF en UTF-8 c’est à dire que les pages de mon site deviennent toute blanches.

    A+

  • Répondre à ce message

    7 octobre 2006 20:06 , par vrac2005
    Articles SPIP au format PDF Nouvelle version

    Bonjour, J’ai un message d’erreur suite à l’installation de cette contrib qui me parait fort efficace. Le fichier pdf est correctement créé au bon endroit, mais le soucis c’est que j’ai un warning sur la page qui s’ouvre et je ne peux voir le fichier pdf. Que faire ?

    Message : Warning : Cannot modify header information - headers already sent by (output started at /var/www/html/etablissements/0601882v/mes_fonctions.php3:15) in /var/www/html/etablissements/0601882v/inc-public.php3(60) : eval()’d code on line 107

    Site en question

    Merci d’avance ++ Ben

  • Répondre à ce message

    28 septembre 2006 18:04 , par idonea
    Bug sur le test de GD ?

    la conversion des .gif par gif.php ne fonctionnant pas bien pour moi (il s’obstine a me dire qu’il ne trouve pas le fichier .gif alors qu’il est bien la...), j’ai parcouru le fichier fpdf.php. a la ligne 933 :

    $readgif= gd_info();
    if ($readgif[3]) {
    ...
    }

    meme si GD est bien installe, if ($readgif[3]) n’est jamais verifie, un echo gd_info(); donne dans mon cas :

    Array ( [GD Version] => 2.0 or higher [FreeType Support] => 1 [FreeType Linkage] => with freetype [T1Lib Support] => 1 [GIF Read Support] => 1 [GIF Create Support] => 1 [JPG Support] => 1 [PNG Support] => 1 [WBMP Support] => 1 [XBM Support] => [JIS-mapped Japanese Font Support] => )

    je ne sais pas bien ce que devrait verifier $readgif[3], toujours est-il qu’en supprimant ce test, ca fonctionne...

    seb

  • Répondre à ce message

    5 septembre 2006 21:36 , par petitesouris
    > Idée de développement

    Ce développement pour mettre en pdf une rubrique dans sa totalité n’a finalement jamais été fait ?

  • Répondre à ce message

    21 juin 2006 09:17 , par chag
    Articles SPIP au format PDF Nouvelle version

    la libraiie GD ne semble pas installée. creez une page nommée ’info.php’ et collez y ce code :

    <?php
    phpinfo();
    ?>

    ouvrez ensuite cette page dans votre navigateur et cherchez cette ligne

    GD Support enabled

    Si elle n’est pas presente ou si vous avez ’disabled’ a la place de ’enabled’, c’est que GD n’est pas installé. Comme c’est cette libririe qui permet de traiter les images des pdf, c’est la raison de votre message d’erreur.

    Chag

Pages 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9

Répondre à cet article

Retour en haut de la page

Dans la même rubrique

Ça discute par ici

Ça Spip par là

SPIP Blog

SPIP Party

SPIP Forums

SPIP-Zone

SPIP Svn

SPIP | Squelette | | Plan du site | Suivre la vie du site RSS 2.0