Manual:$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 49% complete.

Other languages:
English • ‎dansk • ‎magyar • ‎polski • ‎हिन्दी • ‎日本語
SVG: $wgSVGConverters
Scalable Vector Graphics (SVG)コンバータへのパスのリスト。
導入されたバージョン:1.4.0
除去されたバージョン:使用中
許容される値:(array) 下記参照
既定値:下記参照
その他の設定: アルファベット順 | 機能順

詳細

Scalable Vector Graphics (SVG)は画像としてアップロードすることができます。 しかし、ブラウザでのSVGのサポートは不安定です。特に、Internet Explorer 9以前では、SVG形式を全く理解できませんでした。

したがって、SVG形式の画像をPNG形式に変換してフォールバックする必要があります。 この変換を実行するには外部プログラムが必要です。

この配列にはSVG変換プログラムのリストとそれぞれのコマンドラインが含まれています。 システムで使用するものを選択するには、$wgSVGConverter 変数を設定します。

既定値

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


使用法

The following variables can be specified in the command line:

  • $path - the value of $wgSVGConverterPath , if set; otherwise $path/ (note the slash) will be stripped
  • $input - the path to the input SVG file
  • $output - the path where MediaWiki will look for the output PNG file
  • $width - the desired width
  • $height - the desired height
The exclamation mark (!)' is a meta-character in Unix shells and must be escaped with a backslash. In the code sample above, this can be seen in the command for ImageMagick. On Windows-family operating systems, the exclamation mark (!) is not a meta-character in the shell and does not need to be escaped.

A fictitious example, which assumes that an executable named mysvg2png is on the system path:

$wgSVGConverters = array(
	'mysvg2png' => '$path/mysvg2png -input $input -toFormat PNG -w $width -h $height -output $output'
);
$wgSVGConverter = 'mysvg2png';

プラットフォーム固有の注記

Windows

On Windows, where the executable path may contain spaces, you may need to quote the executable name. 例:

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

On Windows-family operating systems, the exclamation mark (!) is not a meta-character in the shell and does not need to be escaped.


Inkscape.exe does not accept command line arguments in the default release. You will need to download inkscapec.exe. Then set the $wgSVGConverters to the following.

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

The inkscapec.exe handles both long and short versions of the commandline.

On Windows-family operating systems, the exclamation mark (!) is not a meta-character in the shell and does not need to be escaped.

Linux

On some Linux installations (e.g. OpenSuSE 10.3, Debian, Ubuntu) rsvg is renamed (and might be packaged separately):

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

If the Java executable is not in the path, it must be specified to use batik, or a "Thumbnail creation failed:" message will be displayed. 例:

$wgSVGConverters['batik'] = '/usr/local/bin/java -Djava.awt.headless=true -jar $path/batik-rasterizer.jar -w $width -d $output $input';
Exclamation mark (!)' is a meta character in Unix shells and must be escaped with a backslash.

Debian Squeeze

If ImageMagick is used, then the following will be needed for SVG viewing:

apt-get install imagemagick libmagickcore3-extra php5-imagick


OpenBSDおよびFreeBSD

On OpenBSD and FreeBSD installations rsvg was renamed to rsvg-convert:

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


関連項目