Banri at 06:22, 2 June 2020

2020-06-02T06:22:01Z

← Older revision		Revision as of 06:22, 2 June 2020
Line 59:		Line 59:
	\|-		\|-
	\| Clean + link		\| Clean + link
	\| <pre>{{clean image\|file={{{image}}}\|link=~~Weird gloop~~}}</pre>		\| <pre>{{clean image\|file={{{image}}}\|link=Earth}}</pre>
	\| {{clean image\|file=[[File:Earth Icon.png\|100px\|link=Earth]]\|link=~~Weird gloop~~}}		\| {{clean image\|file=[[File:Earth Icon.png\|100px\|link=Earth]]\|link=Earth}}
	\| Should result in		\| Should result in
	<pre>[[File:{FILENAME}\|link={LINK}]]</pre>		<pre>[[File:{FILENAME}\|link={LINK}]]</pre>

Banri: Created page with "{{Documentation}} Cleans and formats an input image. This removes the following things if present: * `File:` * *..."

2020-06-02T06:12:36Z

Created page with "{{Documentation}} Cleans and formats an input image. This removes the following things if present: * <code><nowiki>[[File:</nowiki></code> * <code><nowiki>]]</nowiki></code> *..."

New page

{{Documentation}}
Cleans and formats an input image. This removes the following things if present:
* <code><nowiki>[[File:</nowiki></code>
* <code><nowiki>]]</nowiki></code>
* <code><nowiki>|</nowiki></code> and <code><nowiki>{{!}}</nowiki></code>, and everything following the first of these until the end

Then it re-packages the image into a new file container, with specified height, width, and link. The <code>frameless</code> modifier is used, which prevents the image being resized larger than its actual dimensions.

==Usage==
<pre>{{clean image
|file = wikitext to be cleaned; this should usually be a template parameter (e.g. |file={{{image}}}); required
|width = width of image; no default; exclude 'px'
|height = height of image; no default; exclude 'px'; can be combined with width
|link = link to apply to image; no default (will link to file page); setting to no will suppress normal link
}}</pre>

===Examples===
To be practical the results will be as if <code><nowiki>|image=[[File:Earth Icon.png|100px|link=Earth]]</nowiki></code> as the input.

{| class="wikitable"
! Example
! Code
! Result
! Notes
|
|-
| Just clean
| <pre>{{clean image|file={{{image}}}}}</pre>
| {{clean image|file=[[File:Earth Icon.png|100px|link=Earth]]}}
| Should result in
<pre>[[File:{FILENAME}]]</pre>
Note that it links to the file page as a normal image does.
|-
| Clean + width
| <pre>{{clean image|file={{{image}}}|width=50}}</pre>
| {{clean image|file=[[File:Earth Icon.png|100px|link=Earth]]|width=50}}
| Should result in
<pre>[[File:{FILENAME}|{WIDTH}px]]</pre>
|-
| Clean + height
| <pre>{{clean image|file={{{image}}}|height=20}}</pre>
| {{clean image|file=[[File:Earth Icon.png|100px|link=Earth]]|height=20}}
| Should result in
<pre>[[File:{FILENAME}|x{HEIGHT}px]]</pre>
Remember that height parameters on images are maximum height limits and won't make an image bigger (without a width set).
|-
| Clean + width + height
| <pre>{{clean image|file={{{image}}}|width=44|height=20}}
{{clean image|file={{{image}}}|width=11|height=50}}
{{clean image|file={{{image}}}|width=66|height=66}}</pre>
|<poem>{{clean image|file=[[File:Earth Icon.png|100px|link=Earth]]|width=44|height=20}}
{{clean image|file=[[File:Earth Icon.png|100px|link=Earth]]|width=11|height=50}}
{{clean image|file=[[File:Earth Icon.png|100px|link=Earth]]|width=66|height=60}}</poem>
| Should result in
<pre>[[File:{FILENAME}|{WIDTH}x{HEIGHT}px]]</pre>
Remember that height is still a maximum limit here. The size will be {WIDTH}px wide unless this makes the height more than {HEIGHT}px, in which case it is sized down to {HEIGHT}px tall. Aspect ratio is always kept.

Earth Icon.png is 22px wide and 30px tall. In the first use it is trying to resize to twice as wide but the maximum height of 20px forces it to resize down to 15x20px. The second use it successfully resizes down to half as wide, 11x15px. The third use is trying to go thrice as wide but the height limit only allows it to go twice as tall, so is 44x60px.
|-
| Clean + link
| <pre>{{clean image|file={{{image}}}|link=Weird gloop}}</pre>
| {{clean image|file=[[File:Earth Icon.png|100px|link=Earth]]|link=Weird gloop}}
| Should result in
<pre>[[File:{FILENAME}|link={LINK}]]</pre>
|-
| Clean + link suppress
| <pre>{{clean image|file={{{image}}}|link=no}}</pre>
| {{clean image|file=[[File:Earth Icon.png|100px|link=Earth]]|link=no}}
| Should result in
<pre>[[File:{FILENAME}|link=]]</pre>
|}

<includeonly>[[Category:Formatting templates]]</includeonly>

Template:Clean image/doc - Revision history

Banri at 06:22, 2 June 2020

Banri: Created page with "{{Documentation}} Cleans and formats an input image. This removes the following things if present: * File: * *..."

Banri: Created page with "{{Documentation}} Cleans and formats an input image. This removes the following things if present: * `File:` * *..."