Help:Image Administration - Revision history

Admin at 12:56, 8 February 2010

2010-02-08T12:56:27Z

← Older revision		Revision as of 12:56, 8 February 2010
Line 1:		Line 1:
-	~~{{move\|FORwiki:Manual/Image_Administration}}~~
-
	This article describes how FORwiki handles and stores files, and gives some information on configuring.		This article describes how FORwiki handles and stores files, and gives some information on configuring.

Admin: moved Manual:Image Administration to Help:Image Administration

2010-02-08T12:55:34Z

moved Manual:Image Administration to Help:Image Administration

← Older revision

Revision as of 12:55, 8 February 2010

Admin: move

2009-12-09T10:21:52Z

move

← Older revision		Revision as of 10:21, 9 December 2009
Line 1:		Line 1:
		+	{{move\|FORwiki:Manual/Image_Administration}}
		+
	This article describes how FORwiki handles and stores files, and gives some information on configuring.		This article describes how FORwiki handles and stores files, and gives some information on configuring.

Admin at 10:07, 9 December 2009

2009-12-09T10:07:28Z

← Older revision		Revision as of 10:07, 9 December 2009
Line 118:		Line 118:

	In all cases, one would be able to embed files into a page using ordinary [[Help:Images\|image]] syntax and specifying the name of the file in the foreign repository. Note that some of the above implementations are still experimental, and might not be suitable for production sites.		In all cases, one would be able to embed files into a page using ordinary [[Help:Images\|image]] syntax and specifying the name of the file in the foreign repository. Note that some of the above implementations are still experimental, and might not be suitable for production sites.
-
-	~~{{Languages}}~~

Admin at 12:34, 14 October 2009

2009-10-14T12:34:54Z

← Older revision		Revision as of 12:34, 14 October 2009
Line 96:		Line 96:
	== Licensing ==		== Licensing ==

-	A feature of ~~MediaWiki~~ allows the Special:Upload Page to streamline licensing of images. ~~Wikipedia~~'s Upload Page has a Licensing drop down box below image summary. ~~This feature is turned off in default MediaWiki. To turn this feature on a sysop needs to edit Licenses in the MediaWiki namespace. Example:~~	+	A feature of Foresight Wiki allows the Special:Upload Page to streamline licensing of images. Foresight Wiki's Upload Page has a Licensing drop down box below image summary.
-	~~[[MediaWiki:Licenses]]~~	+

	Licenses expects a certain format in a wiki list.		Licenses expects a certain format in a wiki list.

Admin: /* Image thumbnailing */

2009-10-14T11:10:19Z

Image thumbnailing

← Older revision		Revision as of 11:10, 14 October 2009
Line 18:		Line 18:
	== Image thumbnailing ==		== Image thumbnailing ==

-	~~MediaWiki~~'s ~~[[w:Wikipedia:Extended image syntax\|~~extended image syntax]] allows images to be automatically '''thumbnailed''' ~~(see ''[[Manual:Configuring file uploads]]'' for general help on file uploads).~~	+	FORwiki's extended image syntax allows images to be automatically '''thumbnailed'''.
-		+
-	Image thumbnailing requires either [[w:ImageMagick\|ImageMagick]] or [[w:GD Graphics Library\|GD library]]. ImageMagick is recommended since it produces better quality thumbnails; it can be downloaded from [http://www.imagemagick.org/ imagemagick.org]. GD can be downloaded from [http://www.libgd.org/Main_Page libgd.org]. Neither of these are part of the default MediaWiki installation, although PHP can come with GD.	+
-		+
-	~~For older versions of MediaWiki (prior to 1.10.0) set '''[[Manual:$wgUseImageResize\|$wgUseImageResize]]''' to true to enable thumbnailing. In newer versions this is not needed anymore.~~	+
-		+
-	If you use ImageMagick, set '''[[Manual:$wgUseImageMagick\|$wgUseImageMagick]]''' to true in LocalSettings.php. Make sure the [[Manual:$wgImageMagickConvertCommand\|$wgImageMagickConvertCommand]] variable points to the (absolute) location of the convert command of your installation and that the command is executable by the web server process.	+
-		+
-	~~To re-create old thumbnail files before you used ImageMagick you can use [[Manual:$wgThumbnailEpoch\|$wgThumbnailEpoch]]~~.	+

	=== GIF ===		=== GIF ===

Admin: /* SVG */

2009-10-14T11:09:41Z

SVG

← Older revision		Revision as of 11:09, 14 October 2009
Line 33:		Line 33:
	=== SVG ===		=== SVG ===
	FORwiki supports SVG image rendering: if enabled, SVG images can be used like other image files: they will automatically be rendered as a PNG file and thumbnailed as needed on the fly.		FORwiki supports SVG image rendering: if enabled, SVG images can be used like other image files: they will automatically be rendered as a PNG file and thumbnailed as needed on the fly.
-
-	~~To enable SVG support:~~
-
-	# Allow upload of SVG files in the LocalSettings.php file: <tt>[[Manual:$wgFileExtensions\|$wgFileExtensions]][] = 'svg';</tt> Note that MediaWiki will refuse SVG files containing JavaScript, for security reasons.
-	~~#:To avoid a false positive, add <tt>[[Manual:$wgAllowTitlesInSVG\|$wgAllowTitlesInSVG]] = true;</tt> to the [[Manual:LocalSettings.php\|LocalSettings.php]] file.~~
-	~~#:If you get an error saying the file is corrupt, make sure [[Manual:mime type detection\|mime type detection]] is working properly.~~
-	~~# Add <tt>[[Manual:$wgSVGConverter\|$wgSVGConverter]]</tt> to [[Manual:LocalSettings.php\|LocalSettings.php]] and set the renderer you want to use.~~
-	~~#:Available options are ''[[w:ImageMagick\|ImageMagick]]'', ''[[w:sodipodi\|sodipodi]]'', ''[[w:inkscape\|inkscape]]'', ''[[w:batik (software)\|batik]]'', ''[[w:rsvg\|rsvg]]'', and ''[[imgserv]]''.~~
-	~~#*{{note}} '''If the converter program is not in the system path, you have to specify the ''directory'' that contains the program using <tt>[[Manual:$wgSVGConverterPath\|$wgSVGConverterPath]]</tt>'''.~~
-	#* [[w:librsvg\|librsvg]] is fast but not very accurate. It has a ridiculously large chain of dependencies, so you may not want to bother unless you have a repository that includes it and resolves the dependencies for you. The Wikimedia projects use rsvg 2.14. '''Note:''' As of version 2.22.3, there is a bug in locale handling (see [https://bugzilla.wikimedia.org/show_bug.cgi?id=16014 Wikimedia bug report] and [http://bugzilla.gnome.org/show_bug.cgi?id=557036 GNOME bug report]). A [http://svn.wikimedia.org/viewvc/mediawiki/trunk/debs/librsvg2/debian/patches/cmdline-bugfixes.patch?revision=42255&view=markup patch is available] for the <code>rsvg-convert</code> tool.
-	#* [[w:Batik (software)\|Batik]] is the most accurate SVG renderer available. It relies on Java. It is also much slower than rsvg, though this may not be a huge issue unless you're constantly adding SVG files. See [[SVG benchmarks]]. Requires a lot of work to get running.
-	#* [[w:Inkscape\|Inkscape]] also does an accurate job of SVGs, half the speed of rsvg, but was designed for interactive graphical use - it requires a writable home directory for the user it's run as. Since it will be running as user <tt>www</tt> or something similar, it will try to create <tt>.inkscape/</tt> and <tt>.gnome2/</tt> directories in the corresponding home directory, and will fail silently if it is not able to. Inkscape is preferable to rsvg (a) on Windows (it comes as a standalone package) or (b) if you have important SVGs drawn in Inkscape that do not render correctly in rsvg. Inkscape has as complicated a dependency chain as librsvg — use only if it's in your distribution or available as a complete standalone package.
-	~~#* [[w:Sodipodi\|Sodipodi]] is the program Inkscape was forked from. The same considerations apply. Sodipod is no longer under active development.~~
-	~~#* [[w:ImageMagick\|ImageMagick]] renders SVGs, but very buggily, also slow. This is the default, but avoid it if possible. However, it does work.~~
-	#* The [[w:GD Graphics Library\|GD library]] is not capable of converting SVG images to the PNG format, at least according to Joen Asmussen's June 2008 [http://noscope.com/journal/2008/06/converting-svg-to-png-on-the-fly-how NoScope] blog.
-	#* Most current web browsers ''except'' [[w:Internet Explorer\|Internet Explorer]] can display SVGs directly. Using librsvg to render SVGs to a PNG will give much more accurate results. Direct SVG display is not supported in MediaWiki by default.
-
-

	== Deletion of images ==		== Deletion of images ==

Admin: /* Deletion of individual revision */

2009-10-14T11:09:23Z

Deletion of individual revision

← Older revision		Revision as of 11:09, 14 October 2009
Line 61:		Line 61:
	{{Note}} The versions of files are separate from the page history of the file description page.		{{Note}} The versions of files are separate from the page history of the file description page.

-	Information about old revisions of files are stored in the [[oldimage table]].	+	Information about old revisions of files are stored in the oldimage table.
-		+
-		+

	== Data storage ==		== Data storage ==

Admin: /* Undeleting files */

2009-10-14T11:08:53Z

Undeleting files

← Older revision		Revision as of 11:08, 14 October 2009
Line 63:		Line 63:
	Information about old revisions of files are stored in the [[oldimage table]].		Information about old revisions of files are stored in the [[oldimage table]].

-	~~=== Undeleting files ===~~
-	~~{{warning}} Before MediaWiki version 1.8, deleted images/files ''can not be undeleted'' (only the associated description page can be restored).~~

-	From MediaWiki version 1.8 up to 1.10, archiving deleted images/files (and thus undeleting them) is disabled per default, but can be enabled by setting [[Manual:$wgSaveDeletedFiles\|$wgSaveDeletedFiles]] = true.
-
-	~~Since MediaWiki version 1.11, this is enabled per default, and $wgSaveDeletedFiles is deprecated. Instead, the behavior is controlled by [[Manual:$wgFileStore\|$wgFileStore]].~~
-
-	~~Information about deleted images are stored in the [[filearchive table]].~~

	== Data storage ==		== Data storage ==

Admin: /* Data storage */

2009-10-14T11:08:38Z

Data storage

← Older revision		Revision as of 11:08, 14 October 2009
Line 80:		Line 80:
	# If necessary and thumbnailing is available, thumbnailed versions of the file will be created when necessary (such as for the usage on the file description page. These are stored in the thumb directory of the image directory, in a separate directory for each main file.		# If necessary and thumbnailing is available, thumbnailed versions of the file will be created when necessary (such as for the usage on the file description page. These are stored in the thumb directory of the image directory, in a separate directory for each main file.

-	If ~~[[Manual:~~$wgHashedUploadDirectory~~\|$wgHashedUploadDirectory]]~~ is enabled (by default), ~~MediaWiki~~ creates several subdirectories in the images directory.	+	If $wgHashedUploadDirectory is enabled (by default), FORwiki creates several subdirectories in the images directory.

	The directory names are from the first two characters of the md5 hash of the final filename.		The directory names are from the first two characters of the md5 hash of the final filename.

← Older revision		Revision as of 11:09, 14 October 2009
Line 33:		Line 33:
	=== SVG ===		=== SVG ===
	FORwiki supports SVG image rendering: if enabled, SVG images can be used like other image files: they will automatically be rendered as a PNG file and thumbnailed as needed on the fly.		FORwiki supports SVG image rendering: if enabled, SVG images can be used like other image files: they will automatically be rendered as a PNG file and thumbnailed as needed on the fly.
-
-	~~To enable SVG support:~~
-
-	# Allow upload of SVG files in the LocalSettings.php file: <tt>[[Manual:$wgFileExtensions\|$wgFileExtensions]][] = 'svg';</tt> Note that MediaWiki will refuse SVG files containing JavaScript, for security reasons.
-	~~#:To avoid a false positive, add <tt>[[Manual:$wgAllowTitlesInSVG\|$wgAllowTitlesInSVG]] = true;</tt> to the [[Manual:LocalSettings.php\|LocalSettings.php]] file.~~
-	~~#:If you get an error saying the file is corrupt, make sure [[Manual:mime type detection\|mime type detection]] is working properly.~~
-	~~# Add <tt>[[Manual:$wgSVGConverter\|$wgSVGConverter]]</tt> to [[Manual:LocalSettings.php\|LocalSettings.php]] and set the renderer you want to use.~~
-	~~#:Available options are ''[[w:ImageMagick\|ImageMagick]]'', ''[[w:sodipodi\|sodipodi]]'', ''[[w:inkscape\|inkscape]]'', ''[[w:batik (software)\|batik]]'', ''[[w:rsvg\|rsvg]]'', and ''[[imgserv]]''.~~
-	~~#*{{note}} '''If the converter program is not in the system path, you have to specify the ''directory'' that contains the program using <tt>[[Manual:$wgSVGConverterPath\|$wgSVGConverterPath]]</tt>'''.~~
-	#* [[w:librsvg\|librsvg]] is fast but not very accurate. It has a ridiculously large chain of dependencies, so you may not want to bother unless you have a repository that includes it and resolves the dependencies for you. The Wikimedia projects use rsvg 2.14. '''Note:''' As of version 2.22.3, there is a bug in locale handling (see [https://bugzilla.wikimedia.org/show_bug.cgi?id=16014 Wikimedia bug report] and [http://bugzilla.gnome.org/show_bug.cgi?id=557036 GNOME bug report]). A [http://svn.wikimedia.org/viewvc/mediawiki/trunk/debs/librsvg2/debian/patches/cmdline-bugfixes.patch?revision=42255&view=markup patch is available] for the <code>rsvg-convert</code> tool.
-	#* [[w:Batik (software)\|Batik]] is the most accurate SVG renderer available. It relies on Java. It is also much slower than rsvg, though this may not be a huge issue unless you're constantly adding SVG files. See [[SVG benchmarks]]. Requires a lot of work to get running.
-	#* [[w:Inkscape\|Inkscape]] also does an accurate job of SVGs, half the speed of rsvg, but was designed for interactive graphical use - it requires a writable home directory for the user it's run as. Since it will be running as user <tt>www</tt> or something similar, it will try to create <tt>.inkscape/</tt> and <tt>.gnome2/</tt> directories in the corresponding home directory, and will fail silently if it is not able to. Inkscape is preferable to rsvg (a) on Windows (it comes as a standalone package) or (b) if you have important SVGs drawn in Inkscape that do not render correctly in rsvg. Inkscape has as complicated a dependency chain as librsvg — use only if it's in your distribution or available as a complete standalone package.
-	~~#* [[w:Sodipodi\|Sodipodi]] is the program Inkscape was forked from. The same considerations apply. Sodipod is no longer under active development.~~
-	~~#* [[w:ImageMagick\|ImageMagick]] renders SVGs, but very buggily, also slow. This is the default, but avoid it if possible. However, it does work.~~
-	#* The [[w:GD Graphics Library\|GD library]] is not capable of converting SVG images to the PNG format, at least according to Joen Asmussen's June 2008 [http://noscope.com/journal/2008/06/converting-svg-to-png-on-the-fly-how NoScope] blog.
-	#* Most current web browsers ''except'' [[w:Internet Explorer\|Internet Explorer]] can display SVGs directly. Using librsvg to render SVGs to a PNG will give much more accurate results. Direct SVG display is not supported in MediaWiki by default.
-
-

	== Deletion of images ==		== Deletion of images ==