Le Plugin SPIP Freepaper 2 Visualiser Les Fichiers PDF Dans Les Pages WEB
Total Page:16
File Type:pdf, Size:1020Kb
Documentation plugin FreepapeR 2 Le mardi 19 avril 2011 Le Plugin SPIP FreepapeR 2 visualiser les fichiers PDF dans les pages WEB Toutes versions de SPIP à partir de SPIP 1.9 Mise à niveau du 18 avril 2011 Version 0.9.1 Page 1 sur 29 Documentation plugin FreepapeR 2 Le mardi 19 avril 2011 Table des matières 1 Pourquoi FreepapeR....................................................................................................................................3 2 Implantation du plugin................................................................................................................................4 3 La balise #FPP2STD...................................................................................................................................5 4 La balise #FPP2SWF..................................................................................................................................6 5 Le modèle modelefppII (2 en chiffre romain)............................................................................................6 6 Installer la boîte à outils swftools...............................................................................................................8 7 Je ne peux pas installer swftools sur mon serveur......................................................................................9 8 Erreur rencontrées lors de la conversion...................................................................................................12 9 Fenêtre d'information................................................................................................................................12 10 Installation mutualisée............................................................................................................................13 11 Surcharge par un fichier de configuration...............................................................................................16 a) nœud racine du fichier XML...............................................................................................................16 b) nœud enfant de niveau 1 "<commandBar>".......................................................................................17 c) nœud enfant de niveau 1 "<buttons>".................................................................................................18 i. nœud enfant de niveau 2 "<fitToPage>"........................................................................................18 ii. nœud enfant de niveau 2 "<nextPage>"........................................................................................18 iii. nœud enfant de niveau 2 "<prevPage>".......................................................................................18 iv. nœud enfant de niveau 2 "<zoomPlus>"......................................................................................19 v. nœud enfant de niveau 2 "<zoomMinus>"....................................................................................19 vi.nœud enfant de niveau 2 "<monoPageLayout>"...........................................................................19 vii.nœud enfant de niveau 2 "<verticalListLayout>"........................................................................20 viii.nœud enfant de niveau 2 "<stackLayout>".................................................................................20 ix.nœud enfant de niveau 2 "<bookLayout>"....................................................................................20 12 Localisation (langue) de l'interface.........................................................................................................22 13 L'exemple contenu dans l'archive...........................................................................................................24 14 Forcer la détermination du chemin du document à partir de son URL (grâce au plugin CFG)..............26 15 Les nouveautés........................................................................................................................................26 De la version 0.9.1 :................................................................................................................................26 De la version 0.9.0 :................................................................................................................................27 De la version 0.8.4 :................................................................................................................................27 De la version 0.8.3 :................................................................................................................................27 De la version 0.8.2 :................................................................................................................................28 De la version 0.8.1 :................................................................................................................................28 De la version 0.8.0 :................................................................................................................................28 De la version 0.7.0 :................................................................................................................................28 De la version 0.6.0 :................................................................................................................................29 Version 0.9.1 Page 2 sur 29 Documentation plugin FreepapeR 2 Le mardi 19 avril 2011 1 Pourquoi FreepapeR Pagegangster, Motion Paper, scribd.com, myplick.com..... tous ces sites proposent la publication en ligne de vos documents PDF. Il faut pour cela au préalable uploader ses documents sur les serveurs du prestataire choisi, un peu à la manière des YouTube ou Flickr. Cela ne pose pas de problème dans la majorité des cas. Cependant, on ne souhaite parfois pas que ses documents deviennent publics, qu'ils soient analysés par des robots ou encore que de la publicité y soit inséré. FreepapeR aussi permet la visualisation en ligne de fichiers PDF, mais il s'installe sur son propre serveur et les documents que l'on affiche ne quittent jamais le domaine, ne sont jamais altérés, sont toujours disponibles... Le principe est le suivant: ● Le document à visualiser est déjà situé sur le serveur ● Il est converti grâce à la boite à outil (GPL) swftools .Ainsi, on obtient un nouveau fichier, qui est la version SWF du fichier PDF original ● On utilise un programme SWF pour naviguer dans le fichier généré Remarque : Cette méthode de présentation d'information ne permet pas, à la différence de l'écriture textuelle le référencement par les moteurs de recherche, le document étant « caché » au monde par le lecteur SWF. Il y a toujours moyen de trouver des artifices tels qu'insérer dans la page du contenu textuel caché, mais cela est néanmoins à déconseiller. Pour faire fonctionner cet outil, il faut un serveur WEB (php 4 ou 5 sont conseillés pour bénéficier de l'intégralité des fonctionnalités de FreepapeR). Bien entendu, il faut idéalement pouvoir exécuter des routines de la boite à outils swftools sur le serveur, ce qui est sans doute le point le plus délicat. Mais nous verrons par la suite des méthodes alternatives permettant de contourner ce point, notamment dans le cas des hébergements mutualisés sans accès SSH. Version 0.9.1 Page 3 sur 29 Documentation plugin FreepapeR 2 Le mardi 19 avril 2011 2 Implantation du plugin Extraire le contenu de l'archive freepaper2-spip.0.9.1.zip, dans le dossier plugins de votre installation SPIP. OU créer un sous-dossier /plugins/auto pour activer l’installation automatique de plugins. Il suffit ensuite d’indiquer l’URL du fichier zip du plugin et de suivre les indications du système (l’installation automatique est disponible à partir de SPIP 2.0). Pour le plugin freepaper2-spip.0.9.1, l’URL à indiquer est : http://lededansdubocal.net/IMG/zip/freepaper2-spip.0.9.1.zip L’activer via l’administration des plugins. (Consulter la documentation officielle pour plus de détails.) Rappel : pour charger correctement les fichiers nécessaire au fonctionnement du plugin s'assurer que la balise #INSERT_HEAD est incluse dans la partie <head> du squelette (la ligne <INCLURE{fond=inc- head}>, que l'on trouve dans les squelettes de la distribution se charge de cela). Dans ce plugin, on utilise l'utilitaire javascript d'installation d'objet Flash swfobject 2.2, disponible à l'adresse suivante : http://code.google.com/p/swfobject/ En conséquence, il conviendra d'intégrer ce fichier dans la partie « head » des pages qui doivent utiliser le plugin: <script type="text/javascript" src="#CHEMIN{javascript/swfobject.js}"></script> par exemple, si la librairie swfobject est située dans le répertoire « javascript » de votre installation SPIP. OU utiliser le plugin SPIP SWFObject 2.2, qui installe la librairie swfobject.js, version 2.2 dans l'espace publique et privé, disponible à l'adresse http://lededansdubocal.net/spip.php? article19 OU Installer la variante « Installation du plugin SPIP FreepapeR 2 0.9.1 avec swfobject » qui installe le plugin FreepapeR 2 avec une version spécifique de swfobject, qui n'écrase pas les éventuelles autres version installées de swfobject (l'installation automatique via le répertoire plugins/auto est là aussi possible). Version 0.9.1 Page 4 sur 29 Documentation plugin FreepapeR 2 Le mardi 19 avril 2011 3 La balise #FPP2STD Lorsque le plugin est activé, on dispose de la balise #FPP2STD qui liste tous les documents « pdf » joints à l'article et intègre pour chacun d'eux un