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
!
)' 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';
!
) 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' ;