Template:Retouched picture

This is a retouched picture, which means that it has been digitally altered from its original version.

Template documentation[ view · edit · history · purge ]

This documentation is transcluded from Template:Retouched picture/doc.

Note: This template is used on a great lot of pages. In order not to put too much load on the servers, edits should be kept to a bare minimum. Please discuss proposed changes on the talk page first.

Afterwards, changes can initially be done at and tested with Template:Retouched picture/sandbox.

Editing a template causes all pages that use the template to be re-rendered. If the template is used often, this can put a lot of load on the servers since it fills up the job queue.
Keep in mind that templates that are used on file description pages also show up on other wikis.
This page is template-protected from editing to prevent vandalism. Only template editors and administrators can edit it. Get their attention by placing {{Edit protected}} at the talk page.

Used to tag alteration(s) of an image

The template automatically sets the following categories: Retouched pictures or SVG retouched pictures

Usage

Or use the shorthand

{{Retouched|… parameters as described …}}

The mere conversion of a raster image to its SVG version is not an alteration.
To display both authors – of raster and vector – use Template:AutVec.

Template parameters

Parameter	Description		Default	Status
`1`	Modifications	summary of the modifications made If this required parameter should not get a value either "-" or "none" can be used	empty	required
`editor` 2	Editor	The modifier of the image in question (with or without the "User:" prefix), for users of Commons	empty	optional
`orig` 3	Original file	The original image, if it's onwiki (i.e., can be linked to using only the filename, without [[internal link double square brackets]]; any "File:" prefix won't disturb)	empty	optional
`editoff ^{see Note}` 4	Editor(s)	The modifier(s) of the image in question, e.g. `[[User\|user1]] & {{U\|user2\|user2\|en}}` While `editor` becomes [[User:editor\|editor]], `editoff` is used as-it-is, e.g. {{U\|user\|\|en}}⇒user	empty	optional
`origoff ^{see Note}` 5	Original file (offwiki)	The original image, if it's offwiki (i.e., only linkable with [external link single square brackets]) While `orig` may display a small view of the image, `origoff` won't.	empty	optional
`topic` 6	Topic	short code or text string for a topic like e.g. c, f, m for CoA, Flag, Map	empty	optional
`origedt ^{see Note}` 7	Original editor	editor (user id) of the original file	empty	optional

Template data

Parameter text is empty

TemplateData

TemplateData is a way to store information about template parameters (the description of those and of the whole template) for both humans and machines. It is used by VisualEditor and possibly other tools like Upload Wizard.

Existing template documentation
At Wikimedia Commons, it is recommended to use {{TemplateBox}} with either ‎useTemplateData=1 or ‎useTemplateData=only on the ‎/doc subpage and transcluding it with {{Documentation}} into the template. ‎<nowiki>-tags can be wrapped around the arguments, if required, to avoid templates being expanded.

Newly created template documentation and imports
Another option, especially for imported templates, or for users with JSON experience, is placing raw ‎<templatedata>-tags into the Wikitext of the template, as described in various Wikipediae.

Discussion
There is an ongoing discussion about that matter. Feel invited to comment if you are experienced in either way, your time permits and if you like to share your opinion or to make a suggestion.

Wikipedia's help about TemplateData • Commons-specific information

Used to tag alteration<span style="font-weight:normal">(s)</span> of an image

[Edit template data]
Template parameters
This template prefers inline formatting of parameters.
Parameter		Description	Type	Status
Modifications	`1`	summary of the modifications made<br /> <small>If this ''required parameter'' should not get a value either "-" or "none" can be used</small>	String	required
Editor(s)	`editoff <sup>see [[#Note\|Note]]</sup>` `4`	The modifier(s) of the image in question, e.g. <code>[[User\|user1]] & {{U\|user2\|user2\|en}}</code><br /> While <code>editor</code> becomes [[User:editor\|editor]], <code>editoff</code> is used as-it-is, e.g. {{U\|user\|\|en}}⇒[[:en:User:User\|user]]	Unknown	optional
Editor	`editor` `2`	The modifier of the image in question (with or without the "User:" prefix), for users of [[Special:ListUsers\|Commons]]	User	optional
Original file	`orig` `3`	The original image, if it's onwiki (i.e., can be linked to using only the filename, without [[internal link double square brackets]]; any "File:" prefix won't disturb)	User	optional
Original editor	`origedt <sup>see [[#Note\|Note]]</sup>` `7`	editor (user id) of the original file	Unknown	optional
Original file (offwiki)	`origoff <sup>see [[#Note\|Note]]</sup>` `5`	The original image, if it's offwiki (i.e., only linkable with [external link single square brackets]) <br />While <code>orig</code> may display a small view of the image, <code>origoff</code> won't.	Unknown	optional
Topic	`topic` `6`	short code or text string for a topic like e.g. c, f, m for CoA, Flag, Map	Unknown	optional

Additional information

The template is intended to be used in the following namespaces: the File namespace

The template is intended to be used by the following user groups: all users

Placement:

preferably with either |other versions=,
or as subparameters of {{Image generation}},
or outside of the {{Info box}}.

Note

Due to further development, it is now possible to define editor and/or orig as complete links - when the first character is either &, <, [ or { it is automatically used as-it-is without expansion to a wikilink. Editoff and origoff can still be used, especially when no link should occur.

orig=user will become {{U|user}}

orig={{U|user}} and origoff={{U|user}} makes the same output

orig={{U|user|link=n}} and origoff={{U|user|link=n}} and origoff=user makes the same output

Example

{{Retouched picture|none}}

renders as:

This is a retouched picture, which means that it has been digitally altered from its original version.

Localization

العربية ∙ azərbaycanca ∙ беларуская (тарашкевіца) ∙ বাংলা ∙ català ∙ čeština ∙ dansk ∙ Deutsch ∙ Zazaki ∙ Ελληνικά ∙ English ∙ Esperanto ∙ español ∙ eesti ∙ فارسی ∙ suomi ∙ français ∙ galego ∙ עברית ∙ hrvatski ∙ magyar ∙ հայերեն ∙ Bahasa Indonesia ∙ italiano ∙ 日本語 ∙ ქართული ∙ ភាសាខ្មែរ ∙ 한국어 ∙ kurdî ∙ македонски ∙ മലയാളം ∙ Bahasa Melayu ∙ Plattdüütsch ∙ Nederlands ∙ polski ∙ português ∙ română ∙ русский ∙ sicilianu ∙ slovenščina ∙ српски / srpski ∙ svenska ∙ தமிழ் ∙ ไทย ∙ Türkçe ∙ українська ∙ vèneto ∙ Tiếng Việt ∙ 简体中文 ∙ 繁體中文 ∙ +/−

This template is localized through {{Autotranslate}}. The layout of the template can be found under Template:Retouched picture/layout.

To add your language to the list of languages supported by this template, please copy the code of Template:Retouched picture/en (or any other language version you prefer to translate) and replace the text strings in there (the form below can be used to create a translation, the English version is preloaded in the edit box). Please change the parameter lang from en (or whatever language you are translating) to the language code of your language.