Jump to content

Manuel:$wgSVGConverters

From mediawiki.org
This page is a translated version of the page Manual:$wgSVGConverters and the translation is 100% complete.
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

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
Le point d'exclamation (!)' 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';
Le point d'exclamation (!)' 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' ;

Voir aussi