Kézikönyv:$wgSVGConverters

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:$wgSVGConverters and the translation is 100% complete.

Other languages:
English • ‎dansk • ‎magyar • ‎polski • ‎हिन्दी • ‎日本語
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 funkciók: Berű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

$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' ],
];


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 = array(
	'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 = array(
    '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 = array(
    '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 = array( '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.

Debian Squeeze

Az ImageMagick használata esetén az SVG-k megtekintéséhez a következő kód használata szükséges:

apt-get install imagemagick libmagickcore3-extra php5-imagick


OpenBSD és FreeBSD

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

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


Lásd még