Manuel:$wgSVGConverters
SVG: $wgSVGConverters | |
---|---|
Liste des chemins des convertisseurs SVG (Scalable Vector Graphics). |
|
Introduit dans la version : | 1.4.0 |
Retiré dans la version : | Encore utilisé |
Valeurs autorisées : | (tableau) voir ci-dessous |
Valeur par défaut : | voir ci-dessous |
Autres paramètres : Alphabétique | Par fonction |
Détails
Les fichiers SVG (Scalable Vector Graphics) peuvent être téléversés comme des fichiers d'image. Néanmoins la prise en charge de SVG par les navigateurs n'est pas universelle – en particulier Internet Explorer avant la version 9 ne comprenait pas du tout le format SVG.
C'est pourquoi il faut convertir les images SVG au format PNG par mesure de repli. Un programme externe est nécessaire pour réaliser cette conversion.
Ce tableau contient une liste de programmes de conversion SVG avec leur ligne de commande correspondante. Pour indiquer celui à utiliser sur votre système, initialisez la variable $wgSVGConverter .
Valeurs par défaut
Version de MediaWiki : | ≥ 1.39 |
$wgSVGConverters = [
'ImageMagick' => '$path/convert -background "#ffffff00" -thumbnail $widthx$height\\! $input PNG:$output',
'sodipodi' => '$path/sodipodi -z -w $width -f $input -e $output',
'inkscape' => '$path/inkscape -z -w $width -f $input -e $output',
'batik' => 'java -Djava.awt.headless=true -jar $path/batik-rasterizer.jar -w $width -d $output $input',
'rsvg' => '$path/rsvg-convert -w $width -h $height -o $output $input',
'imgserv' => '$path/imgserv-wrapper -i svg -o png -w$width $input $output',
'ImagickExt' => [ 'SvgHandler::rasterizeImagickExt', ],
];
Versions de MediaWiki : | 1.25 – 1.38 |
$wgSVGConverters = [
'ImageMagick' =>
'$path/convert -background "#ffffff00" -thumbnail $widthx$height\! $input PNG:$output',
'sodipodi' => '$path/sodipodi -z -w $width -f $input -e $output',
'inkscape' => '$path/inkscape -z -w $width -f $input -e $output',
'batik' => 'java -Djava.awt.headless=true -jar $path/batik-rasterizer.jar -w $width -d '
. '$output $input',
'rsvg' => '$path/rsvg-convert -w $width -h $height -o $output $input',
'imgserv' => '$path/imgserv-wrapper -i svg -o png -w$width $input $output',
'ImagickExt' => [ 'SvgHandler::rasterizeImagickExt' ],
];
Versions de MediaWiki : | 1.23 – 1.24 |
$wgSVGConverters = array(
'ImageMagick' => '$path/convert -background white -thumbnail $widthx$height\! $input PNG:$output',
'sodipodi' => '$path/sodipodi -z -w $width -f $input -e $output',
'inkscape' => '$path/inkscape -z -w $width -f $input -e $output',
'batik' => 'java -Djava.awt.headless=true -jar $path/batik-rasterizer.jar -w $width -d '
. '$output $input',
'rsvg' => '$path/rsvg -w $width -h $height $input $output',
'imgserv' => '$path/imgserv-wrapper -i svg -o png -w$width $input $output',
'ImagickExt' => array( 'SvgHandler::rasterizeImagickExt' ),
);
Versions de MediaWiki : | 1.21 – 1.22 |
$wgSVGConverters = array(
'ImageMagick' => '$path/convert -background white -thumbnail $widthx$height\! $input PNG:$output',
'sodipodi' => '$path/sodipodi -z -w $width -f $input -e $output',
'inkscape' => '$path/inkscape -z -w $width -f $input -e $output',
'batik' => 'java -Djava.awt.headless=true -jar $path/batik-rasterizer.jar -w $width -d $output $input',
'rsvg' => '$path/rsvg -w $width -h $height $input $output',
'imgserv' => '$path/imgserv-wrapper -i svg -o png -w$width $input $output',
'ImagickExt' => array( 'SvgHandler::rasterizeImagickExt' ),
);
Versions de MediaWiki : | 1.18 – 1.20 |
$wgSVGConverters = array(
'ImageMagick' => '$path/convert -background white -thumbnail $widthx$height\! $input PNG:$output',
'sodipodi' => '$path/sodipodi -z -w $width -f $input -e $output',
'inkscape' => '$path/inkscape -z -w $width -f $input -e $output',
'batik' => 'java -Djava.awt.headless=true -jar $path/batik-rasterizer.jar -w $width -d $output $input',
'rsvg' => '$path/rsvg -w$width -h$height $input $output',
'imgserv' => '$path/imgserv-wrapper -i svg -o png -w$width $input $output',
'ImagickExt' => array( 'SvgHandler::rasterizeImagickExt' ),
);
Versions de MediaWiki : | 1.14 – 1.17 |
$wgSVGConverters = array(
'ImageMagick' => '$path/convert -background white -thumbnail $widthx$height\! $input PNG:$output',
'sodipodi' => '$path/sodipodi -z -w $width -f $input -e $output',
'inkscape' => '$path/inkscape -z -w $width -f $input -e $output',
'batik' => 'java -Djava.awt.headless=true -jar $path/batik-rasterizer.jar -w $width -d $output $input',
'rsvg' => '$path/rsvg -w$width -h$height $input $output',
'imgserv' => '$path/imgserv-wrapper -i svg -o png -w$width $input $output',
);
Version de MediaWiki : | 1.13 |
1.13
$wgSVGConverters = array(
'ImageMagick' => '$path/convert -background white -geometry $width $input PNG:$output',
'sodipodi' => '$path/sodipodi -z -w $width -f $input -e $output',
'inkscape' => '$path/inkscape -z -w $width -f $input -e $output',
'batik' => 'java -Djava.awt.headless=true -jar $path/batik-rasterizer.jar -w $width -d $output $input',
'rsvg' => '$path/rsvg -w$width -h$height $input $output',
'imgserv' => '$path/imgserv-wrapper -i svg -o png -w$width $input $output',
);
Versions de MediaWiki : | 1.10 – 1.12 |
$wgSVGConverters = array(
'ImageMagick' => '$path/convert -background white -geometry $width $input PNG:$output',
'sodipodi' => '$path/sodipodi -z -w $width -f $input -e $output',
'inkscape' => '$path/inkscape -z -w $width -f $input -e $output',
'batik' => 'java -Djava.awt.headless=true -jar $path/batik-rasterizer.jar -w $width -d $output $input',
'rsvg' => '$path/rsvg -w$width -h$height $input $output',
);
Versions de MediaWiki : | 1.5 – 1.9 |
$wgSVGConverters = array(
'ImageMagick' => '$path/convert -background white -geometry $width $input $output',
'sodipodi' => '$path/sodipodi -z -w $width -f $input -e $output',
'inkscape' => '$path/inkscape -z -w $width -f $input -e $output',
'batik' => 'java -Djava.awt.headless=true -jar $path/batik-rasterizer.jar -w $width -d $output $input',
'rsvg' => '$path/rsvg -w$width -h$height $input $output',
);
Version de MediaWiki : | 1.4 |
$wgSVGConverters = array(
'ImageMagick' => '$path/convert -background white -geometry $width $input $output',
'sodipodi' => '$path/sodipodi -z -w $width -f $input -e $output',
'inkscape' => '$path/inkscape -z -w $width -f $input -e $output',
'batik' => 'java -Djava.awt.headless=true -jar $path/batik-rasterizer.jar -w $width -d $output $input',
);
Utilisation
Les variables suivantes peuvent être spécifiées sur la ligne de commande :
$path
- la valeur de $wgSVGConverterPath , si elle est définie ; sinon$path/
(notez la barre oblique) sera supprimé$input
- chemin vers le fichier SVG d'entrée$output
- le chemin où MediaWiki recherchera le fichier PNG de sortie$width
- largeur souhaitée$height
- hauteur souhaitée
!
)' est un méta-caractère dans les shells Unix et en doit être échappé avec une barre oblique inverse. Dans l'exemple de code ci-dessus, cela peut être vu dans la commande pour ImageMagick.. Sur les systèmes d'exploitation de la famille Windows, le point d'exclamation (!
) n'est pas un méta-caractère dans le shell et n'a pas besoin d'être échappé.
Exemple
Un exemple fictif, qui suppose qu'un exécutable nommé mysvg2png
se trouve sur le chemin système :
$wgSVGConverters = [
'mysvg2png' => '$path/mysvg2png -input $input -toFormat PNG -w $width -h $height -output $output'
];
$wgSVGConverter = 'mysvg2png';
Notes spécifiques à la plateforme
Windows
Sous Windows, où le chemin de l'exécutable peut contenir des espaces, vous devrez peut-être citer le nom de l'exécutable. Par exemple:
$wgSVGConverters = [
'inkscape' => '"$path/Inkscape/inkscape" -z -w $width -f $input -e $output',
];
Sur les systèmes d'exploitation de la famille Windows, le point d'exclamation (!
) n'est pas un méta-caractère dans le shell et n'a pas besoin d'être échappé.
Inkscape.exe n'accepte pas les arguments de ligne de commande dans la version par défaut. Vous devrez télécharger inkscapec.exe. Définir ensuite $wgSVGConverters sur ce qui suit.
$wgSVGConverters = [
'inkscape' => 'inkscapec.exe --file=$input --export-png=$output --export-width=$width --without-gui',
];
Le inkscapec.exe gère les versions longues et courtes de la ligne de commande.
Sur les systèmes d'exploitation de la famille Windows, le point d'exclamation (!
) n'est pas un méta-caractère dans le shell et n'a pas besoin d'être échappé.
Linux
Sur certaines installations Linux (par exemple OpenSuSE 10.3, Debian, Ubuntu) rsvg est renommé (et peut être empaqueté séparément) :
$wgSVGConverters = [ 'rsvg' => '/usr/bin/rsvg-convert -w $width -h $height -o $output $input' ];
$wgSVGConverter = 'rsvg' ;
Si l'exécutable Java n'est pas dans le chemin, il doit être spécifié pour utiliser batik, ou un message "Thumbnail creation failed:" s'affichera. Par exemple:
$wgSVGConverters['batik'] = '/usr/local/bin/java -Djava.awt.headless=true -jar $path/batik-rasterizer.jar -w $width -d $output $input';
!
)' est un caractère méta dans Shells Unix et doit être échappé avec une barre oblique inverse.
OpenBSD et FreeBSD
Sur les installations OpenBSD et FreeBSD, rsvg a été renommé en rsvg-convert :
$wgSVGConverterPath = "/usr/local/bin";
$wgSVGConverters = [ 'rsvg' => '$path/rsvg-convert -w $width -h $height -o $output $input' ];
$wgSVGConverter = 'rsvg' ;