Kézikönyv:$wgSVGConverters

From mediawiki.org
This page is a translated version of the page Manual:$wgSVGConverters and the translation is 100% complete.
SVG: $wgSVGConverters
A Scalable Vector Graphics (SVG)-konvertálók útvonalainak listája.
Bevezetve:1.4.0
Eltávolítva:használatban
Megengedett értékek:(tömb) lásd alább
Alapértelmezett érték:lásd alább

Részletek

A változóban a Scalable Vector Graphics (SVG)-konvertálók útvonalainak listája rögzíthető. A böngészők SVG-támogatása nem egységes; például az Internet Explorer a 9-es verzió előtt egyáltalán nem támogatta a formátumot.

Emiatt fontos az SVG-állományok PNG-be konvertálása; ehhez külső szoftver szükséges.

A tömb az SVG-konvertáló programok útvonalait és a hozzárendelt parancsokat tartalmazza. A használandó szoftver kiválasztása a $wgSVGConverter változóval lehetséges.

Alapértelmezett érték

MediaWiki-verzió:
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', ],
];
MediaWiki-verziók:
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' ],
];
MediaWiki-verziók:
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' ),
);
MediaWiki-verziók:
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' ),
);
MediaWiki-verziók:
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' ),
	);
MediaWiki-verziók:
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',
	);
MediaWiki-verzió:
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',
	);
MediaWiki-verziók:
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',
	);
MediaWiki-verziók:
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',
	);
MediaWiki-verzió:
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',
	);

Használat

A következő változók adhatóak meg a parancssorban:

  • $path - a $wgSVGConverterPath értéke; ha nincs megadva, a $path/ (figyeld a perjelet) lesz megvágva
  • $input - a bemeneti SVG-fájl útvonala
  • $output - azon útvonal, ahol a MediaWiki a kimeneti PNG-fájlt fogja keresni
  • $width - kívánt szélesség
  • $height - kívánt magasság
A felkiáltójel (!) a Unix rendszerhéj metakaraktere, így backslash-sel (\) való kiemelése szükséges. A fenti mintakódban ez az ImageMagick parancsában látható. A Windows operációs rendszerekben a felkiáltójel (!) nem metakarakter, így nem szükséges kiemelni.

Példa

Egy fiktív példa, melyben a mysvg2png eszköz a rendszer könyvtárában található:

$wgSVGConverters = [
	'mysvg2png' => '$path/mysvg2png -input $input -toFormat PNG -w $width -h $height -output $output'
];
$wgSVGConverter = 'mysvg2png';

Platformspecifikus megjegyzések

Windows

Windows alatt a szóközt tartalmazó útvonalaknál írógép-idézőjel (" ") használata lehet szükséges. Például:

$wgSVGConverters = [
    'inkscape' => '"$path/Inkscape/inkscape" -z -w $width -f $input -e $output',
];

A Windows operációs rendszerekben a felkiáltójel (!) nem metakarakter, így nem szükséges kiemelni.

Az inkspace.exe alapéértelmezésben nem fogad el parancssori argumentumokat, ehhez az inkscapec.exe letöltése szükséges; ezután a $wgSVGConverters-ben az alábbi kódot kell rögzíteni:

$wgSVGConverters = [
    'inkscape' => 'inkscapec.exe --file=$input --export-png=$output --export-width=$width --without-gui',
];

Az inkspacec.exe a rövid- és hosszú verziójú parancssort is kezeli.

A Windows operációs rendszerekben a felkiáltójel (!) nem metakarakter, így nem szükséges kiemelni.

Linux

Néhány Linux-disztribúció (például OpenSuSE 10.3, Debian, Ubuntu) esetében az rsvg-t átnevezték (és esetleg külön kell letölteni):

$wgSVGConverters = [ 'rsvg' => '/usr/bin/rsvg-convert -w $width -h $height -o $output $input' ];
$wgSVGConverter = 'rsvg' ;

Ha a Java futtatható állománya nem szerepel az útvonalban megadott címen, a batik használatának kikötése szükséges, máskülönben „A bélyegkép létrehozása sikertelen:” üzenetet fogsz kapni. Például:

$wgSVGConverters['batik'] = '/usr/local/bin/java -Djava.awt.headless=true -jar $path/batik-rasterizer.jar -w $width -d $output $input';
A felkiáltójel (!) a Unix rendszerhéj metakaraktere, így backslash-sel (\) való kiemelése szükséges.

OpenBSD és FreeBSD

Az OpenBSD és FreeBSD esetén az rsvg-t rsvg-convert-re nevezték át:

$wgSVGConverterPath = "/usr/local/bin";
$wgSVGConverters = [ 'rsvg' => '$path/rsvg-convert -w $width -h $height -o $output $input' ];
$wgSVGConverter = 'rsvg' ;

Lásd még