Kézikönyv:$wgSVGConverters
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 |
Egyéb beállítások: Betűrendben | Funkció szerint |
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 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 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' ;