Příručka:$wgSVGConverters

SVG: $wgSVGConverters
Seznam cest k převodníkům Scalable Vector Graphics (SVG).
Zavedeno od verze:	1.4.0
Odstraněno od verze:	stále se používá
Povolené hodnoty:	(pole) viz níže
Výchozí hodnota:	viz níže
Další nastavení: Podle abecedy | Podle funkce

Podrobnosti

Škálovatelnou vektorovou grafiku (SVG) lze nahrát jako obrázky. Podpora SVG v prohlížečích je však nejednotná – konkrétně Internet Explorer před verzí 9 vůbec nerozuměl formátu SVG.

Proto je nutné převést obrázky ve formátu SVG do formátu PNG jako záložní. K provedení této konverze je nutný externí program.

Toto pole obsahuje seznam programů pro převod SVG a příkazový řádek pro každý z nich. Chcete-li vybrat, kterou z nich chcete ve svém systému použít, nastavte proměnnou $wgSVGConverter .

Výchozí hodnoty

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

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

Verze 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' ),
);

Verze 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' ),
);

Verze 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' ),
	);

Verze 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',
	);

Verze 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',
	);

Verze 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',
	);

Verze 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',
	);

Verze 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',
	);

Použití

V příkazovém řádku lze zadat následující proměnné:

• $path - hodnota $wgSVGConverterPath , je-li nastavena; jinak bude $path/ (všimněte si lomítka) odstraněn
• $input - cestu ke vstupnímu souboru SVG
• $output - cestu, kde bude MediaWiki hledat výstupní soubor PNG
• $width - požadovanou šířku
• $height - požadovanou výšku

Vykřičník (!)' je metaznak v Unix shell a musí být ukončen zpětným lomítkem. Ve výše uvedené ukázce kódu je to vidět v příkazu pro ImageMagick. V operačních systémech řady Windows není vykřičník (!) metaznakem v shellu a není třeba jej escapovat.

Příklad

Fiktivní příklad, který předpokládá, že spustitelný soubor s názvem mysvg2png je na systémové cestě:

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

Poznámky specifické pro platformu

Windows

V systému Windows, kde cesta ke spustitelnému souboru může obsahovat mezery, budete možná muset uvést název spustitelného souboru. Například:

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

V operačních systémech řady Windows není vykřičník (!) metaznakem v shellu a není třeba jej escapovat.

Inkscape.exe nepřijímá argumenty příkazového řádku ve výchozí verzi. Budete si muset stáhnout inkscapec.exe. Poté nastavte $wgSVGConverters na následující.

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

Inkscapec.exe zpracovává dlouhé i krátké verze příkazového řádku.

V operačních systémech řady Windows není vykřičník (!) metaznakem v shellu a není třeba jej escapovat.

Linux

Na některých instalacích Linuxu (např. OpenSuSE 10.3, Debian, Ubuntu) je rsvg přejmenováno (a může být zabaleno samostatně):

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

Pokud v cestě není spustitelný soubor Java, je nutné zadat použití batikování, jinak se zobrazí zpráva "Vytvoření miniatury se nezdařilo:". Například:

$wgSVGConverters['batik'] = '/usr/local/bin/java -Djava.awt.headless=true -jar $path/batik-rasterizer.jar -w $width -d $output $input';

Vykřičník (!) je meta znak v Unixových shellech a musí být escapovány zpětným lomítkem.

OpenBSD a FreeBSD

Na instalacích OpenBSD a FreeBSD byl rsvg přejmenován na rsvg-convert:

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

Související odkazy

• $wgSVGConverter
• $wgSVGConverterPath