Nota SPIP-Contrib : un plugin encore en développement, la présente documentation doit servir de support à celui-ci. N’hésitez pas à vous servir de ce forum pour remonter vos essais et avis à l’auteur.
Nota auteur : ce plugin se cherche aussi un petit nom , n’hesitez pas à proposer vos idées dans le forum
Nota auteur : ATTENTION ce plugin subit une refonte conséquente de son code.
Par conséquent, la documentation qui suit va évoluer et ne correspondra plus à la version actuellement dite stable.
Présentation
Ce plugin a pour vocation de transformer les documents multipages (pdf, tiff, gif , ...) en autant d’images.
Par exemple, nous pouvons prendre le cas d’un journal papier, dont une version pdf existe. Il est ainsi possible :
d’importer ce document dans un article dédié ;
de lancer la conversion ;
de proposer une consultation en ligne des différentes pages.
Prérequis
Ce plugin s’appuie sur la bibliothèque ImageMagick (plus de détail). Cet outil est un couteau suisse du traitement d’images.
Pour supporter le pdf, il faut aussi ghost script
Pour plus de détail sur les formats supportés à la lecture, je vous invite à consulter cette page
Il faut noter que le plugin necessite CFG.
Avertissement Depuis la version 0.5, le support pour SPIP 192 n’est plus supporté. Le developpement s’oriente uniquement sur la version 193 et 2.0 Beta
Installation
Selon vos besoins et votre serveur, installez ou faites installer les logiciels nécessaire. C’est à dire :
- php-imagick
- ghost script (8.62)
Debian Stable (Etch)
Pour utiliser la derniere version de Ghostscript, nous devons jongler avec les paquets de la version instable (Lenny)
Mettre à jour sa liste de depot /etc/apt/sources.list :
Proteger son installation pour ne pas avoir de mise à jour non voulue en version lenny, /etc/apt/apt.conf (à créer si besoin) :
Installer la derniere version de ghostscript :
apt-get install -t lenny gs-gpl
Il est conseillé d’utiliser les paquets des polices suivantes :
apt-get install gsfonts gsfonts-other gsfonts-x11 msttcorefonts
Ressources :
Le plugin
Attention il n’y a pas de contrôle sur la présence ou non de ghost script. Pour le moment c’est à vous de vous assurer de la bonne présence des logiciels.
Telechargez le plugin sur le dépot de la zone
Suivez la procédure normale d’installation http://www.spip.net/fr_article3396.html
Attention
L’utilisation de CFG et l’activation d’une configuration par défaut impose de desinstaller complétement toute version précédent la 0.4.
Configuration
Depuis la version 0.4, une configuration par défaut est proposée.
- Configuration par défaut
- Le panneau de configuration et ses paramétres par défaut
format des documents On peut spécifier les documents convertibles, par défaut ce sont les formats tiff et pdf.
Repertoire de stockage
Par défaut l’ensemble des documents est sauvegardé dans le repertoire /IMG/doc2img/. Ce repertoire est créé automatiquement lors de l’installation.
Vous pouvez spécifier un autre repertoire, toutefois ce sera à vous de vérifier l’existence du dit repertoire. De plus il faut des droits d’écriture dessus au même titre que ceux de /IMG/
Format de sauvegarde Le format par défaut pour les images générées est le PNG. Vous pouvez préciser un autre format dans la liste déroulante. Cette liste s’appuie sur les formats supportés par SPIP.
Rédimension
Par défaut les images ne sont pas redimensionnées. Elle auront donc la meme taille et resolution que celle du document original.
Vous pouvez indiquer :
soit une largeur
soit une hauteur
soit les 2
Proportion Si l’option proportion est cochée, le document sera redimensionné selon le plus faible ratio. C’est à dire qui si le rapport largeur réelle / largeur demandée est supérieure à hauteur réelle / hauteur demandée, l’image sera redimensionné selon le rapport defini par le ratio hauteur.
Agrandissement
Dans certains cas le pdf est sauvegardé dans un format d’impression petit (A5 ou autre), le script ne peux pas par lui meme determiner si c’est le format réel du document ou juste le format d’impression.
Pour palier à ce point, il est possible de forcer le script à prendre les tailles définies meme si celles ci sont inférieures à celle detectées par le plugin.
Convertir à la volée SI cette option est activée, lorsqu’un document est téléchargé depuis l’espace privée celui est directement convertit en succession d’images.
Utilisation
Si l’option "Convertir à la volée" n’est pas activé, il est nécessaire de sélectionner le document à convertir. Ceci se fait depuis la partie privée.
Choissisez un article pour lequel un document de type pdf ou tiff a été importé. Dans la colone de gauche, une liste déroulant est présente.
Sélectionnez le document voulu et cliquez sur le bouton convertir. Patientez un peu, en fonction du document le temps de conversion est plus ou moins long.
Espace public
Un squelette par défaut minimaliste est disponible. Saisissez l’adresse suivante dans la barre de votre navigateur : http://votresite/?fond=doc2img
(c) Calvin et Hobbes
Le squelette
L’idée est d’être au plus proche de la logique SPIP. Ainsi les images générées sont accessibles par un squelette quelconque.
- [(#REM) On liste les documents ayant été convertis]
- <B_listed2c>
- Liste des documents
- <BOUCLE_listed2c(DOC2IMG) >
- [(#ID_DOCUMENT|unique|?{' ',''})
- <a href=#URL_PAGE{doc2img,id_document=#ID_DOCUMENT}> #ID_DOCUMENT </a>
- ]
- </BOUCLE_listed2c>
- [(#REM) On navigue parmi les images d'un document]
- <B_d2c>
- #ANCRE_PAGINATION
- <BOUCLE_d2c(DOC2IMG) {id_document} {pagination 1} >
- <img src="#FICHIER" />
- </BOUCLE_d2c>
- <p>
- Ce document posséde #GRAND_TOTAL page(s)
- </p>
- #PAGINATION{page_precedent_suivant}
- </B_d2c>
- table vide
- <//B_d2c>
Comme vous pouvez le constatez le code est simple. C’est un squelette des plus basiques qui utilise la #PAGINATION pour se déplacer dans les images.
A faire
Les traductions
Support de la configuration (version 0.4)
lLa génération automatique lors d’un chargement d’un doc
suppression des images lors de la suppression du document maître
cacher les documents deja converti dans la liste de selection de convestion
mettre une progressbar
tester avec php5
support complet de l’api sql_*
controler automatiquement les prérequis (imagick, gs, ...)
depuis l’espace privé
RSS 2.0