Module de génération d'aperçus
Description
Ce module permet d'améliorer l'ergonomie du site en générant des aperçus de documents (dans les résultats des recherche, les fiches documentaires, l'explorateur de media, etc).
Pour générer les aperçus, le module s'insère dans la la mécanique du tag <jalios:thumbnail> et utilise des applications natives du serveur (c'est à dire du code non Java, spécifique à l'OS hébergeant JCMS).
On peut notamment générer les aperçus de fichiers :
- PDF via le programme ImageMagick couplé avec Ghostscript.
- à noter que le support des documents PDF permet également la génération d'aperçus pour tous les documents capables d'être convertis par le module de conversion PDF. comme les documents bureautiques Microsoft Office (Word, Excel, PowerPoint) et Open Office, textes (txt, rtf, ...)
- vidéos via ffmpeg
- audio via SoX
- ...
Les possibilités de conversions dépendent uniquement des programmes disponibles sur l'OS et de la variété des formats supportés par ces programmes.
Installation
- Installez le/les programmes approprié(s) sur votre OS (eg. ImageMagick+Ghostscript, ffmpeg, SoX, ...).
- Éditez les propriétés du module (dans l'administration du module) et ajoutez une commande de génération d'aperçu (conversion d'un document vers une image). Vous pouvez pour cela utilisez les variables suivantes qui seront remplacées automatiquement lors du traitement :
{webapp-root}: le chemin racine de la webapp (sans slah de fin). e.g :C:\tomcat\webapps\jcms-x.y{src.path}: le chemin absolu du fichier source à convertir. e.g :C:\tomcat\webapps\jcms-x.y\upload\docs\application\pdf\2009-04\mydocument.pdf
{dest.path}: le chemin absolu du fichier de destination, cad l'aperçu à générer. e.g :C:\tomcat\webapps\jcms-x.y\upload\docs\application\pdf\2009-04\th-320x240-mydocument.pdf.jpg
{format.ext}: l'extension du format d'image à générer. e.g :jpg{format.mime-type}: le type mime de format d''image à générer. e.g :image/jpeg{width}: la largeur de l'aperçu à générer (en pixel). e.g :320{height}: la hauteur de l'aperçu à générer (en pixel). e.g :240
"{webapp-root}\WEB-INF\plugins\ThumbnailGeneratorPlugin\programs\ImageMagick-6.5.0-9\convert.exe" "{src.path}[0]" -resize {width}x{height} "{dest.path}"Exemple pour la conversion de fichiers vidéos sur un système unix (Important: veillez à ne pas avoir d'espace dans le chemin de la webapp) :/usr/bin/ffmpeg -y -i {src.path} -f mjpeg -ss 1 -vframes 1 -s {width}x{height} -an {dest.path} - Optionnellement, vous pouvez éditer le fichier
custom.proppour y spécifier n'importe quel programme pour tous les types mime autre que vidéo, image et pdf.
Changements
Thumbnail Generator plugin v1.0.1
- Added compatibility with JCMS 6.1.1
Thumbnail Generator plugin v1.0
- Initial release
