ଛାଞ୍ଚ:Media/doc ନିମନ୍ତେ ଆଧାର ଦେଖିବେ

{{documentation subpage}}

This template is a typing aid that adds multimedia icons to any page.  It is intended to identify which works have multimedia elements attached to them (such as audio files, spoken word versions, film clips and music).  The template has two uses, both to create the icons and to provide a key for those icons.

==Usage==
<pre>
{{Media
 | type     = 
 | multi    = 
 <!--The following only apply if "multi" is selected-->
 | audio    = 
 | music    = 
 | video    = 
 <!--The following is only for use to create a key-->
 | key      = 
 | nobreak  = 
 | parts    = 
 | category = 
}}
</pre>

If no parameters are set, the template will display the default "speaker" icon as used with audio files and spoken word versions of texts.

This template has two fuctions: '''Icon''' or '''Key'''.
===Icon only===
Icon only is the default setting of this template. Size can be adjusted (in pixels).  Default size is 20px in the Author: namespace and 15px in the Main namespace.  To adjust the size, use the number of pixels with no named parameter.

{{parameter|Multi}} can be used to display multiple icons.  This overrides the {{parameter|type}}.

===Key text===
By setting the {{parameter|key}} parameter to yes, the template will display text to explain the icon.  This will override the creation of icons. When using this fuction, the template should be placed in the appropriate page header.

The key will automatically include an opening line break, which is often but not always useful for displaying correctly.  This line break can be deactivated by setting the {{parameter|nobreak}} parameter to yes.

The text of the key depends on the namespace combined with the {{parameter|type}} and {{parameter|parts}} parameters.

In the Author and Wikisource namespaces, this template inserts one of the following icons and text:<br /><blockquote>''The icon [[File:Speaker Icon.svg|20px]] identifies that the work includes a spoken word version.''</blockquote><blockquote>''The icon [[File:Musical note nicu bucule 01.svg|20px]] identifies that the work includes a musical version.''</blockquote><blockquote>''The icon [[File:Film icon.svg|20px]] identifies that the work includes a video version.''</blockquote>

In the main namespace (and any other namespace not mentioned), this template instead inserts one of the following icons and text:<br /><blockquote>''[[File:Speaker Icon.svg|20px]] one or more chapters are available in a spoken word format.''</blockquote><blockquote>''[[File:Musical note nicu bucule 01.svg|20px]] one or more chapters are available in a musical format.''</blockquote><blockquote>''[[File:Film icon.svg|20px]] one or more chapters are available in a video format.''</blockquote>

The {{parameter|parts}} parameter can override the use of the word "chapters" in the text.  This can be used in situations where the work is subdivided in a different manner.  Possibilities include "parts" or "sections."

'''Note #1:''' When used as a key, this template adds '''[[:Category:Spoken works]]''' (audio, including music) or '''[[:Category:Works with videos]]''' (video). To omit addition of the '''Category''' add the code <code><nowiki>{{Media| category = }}</nowiki></code>

==Placement==
===Icon===
On author pages, place the icon after the name of the text that has multimedia elements.

If a single chapter or other subsection of a work has multimedia elements, this template can be placed on the contents page of the work to indicate which contain the multimedia element(s).  In these cases, place the icon after the name of the chapter or subsection (in this situation, the size should be 15px.)

===Key===
The key should be placed in the page header.  This appropriate place depends on the namespace:

{| class="wikitable" style="border: 1px solid black; margin: 1em auto 1em auto;"
!Namespace
!Placement
|-
|Author
|In the {{tl|Author}} Description field
|-
|Main
|In the {{tl|Header}} Notes field
|-
|Wikisource
|In the {{tl|Process header}} Notes field
|}

==Multimedia==
This template displays icons for three types of media, as shown in this table.  Any one of the keywords can be used with {{parameter|type}} to set the appropriate icon.  To set more than one icon, set {{parameter|multi}} to "y" and set any of {{parameter|audio}}, {{parameter|music}} and {{parameter|video}} to "y" to display the icons.

{| class="wikitable" style="border: 1px solid black; margin: 1em auto 1em auto;"
!Media type
!Keyword(s)
!Icon
|-
| Spoken word version (audiobook) || audio, spoken, speaker '''(default)''' || [[File:Speaker Icon.svg|20px]]
|-
| Music || music, song, note || [[File:Musical note nicu bucule 01.svg|20px]]
|-
| Video || video, film || [[File:Film icon.svg|20px]]
|}

'''Note:''' {{parameter|multi}} does not currently work with {{parameter|key}}

==Speaker & Spoken==
The previous version of this template was {{tl|Speaker}}, which originally displayed only the speaker icon.  {{tl|Speaker}} is still in use and can still be used, as it redirects to this template.

The template {{tl|Spoken}}, which originally provided a key for the speaker icon, has also been merged into this template. {{tl|Spoken}} is still in use and can still be used, as it redirects to this template.

==Examples==
===Basic icon examples===
<pre>{{Media}}</pre>
{{Media}}
<pre>{{Media|15}}</pre>
{{Media|15}}
<pre>{{Media|type=music}}</pre>
{{Media|type=music}}
<pre>{{Media|type=music|30}}</pre>
{{Media|type=music|30}}
<pre>{{Media|type=film}}</pre>
{{Media|type=film}}
<pre>{{Media|15|type=note}}</pre>
{{Media|15|type=note}}
<pre> {{media|type = spoken}}</pre>
 {{media|type = spoken}}
<pre> {{media|15|type = spoken}}</pre>
 {{media|15|type = spoken}}
<pre>{{Speaker|type=film|15}}</pre>
{{Speaker|type=film|15}}

===Complicated icon examples===
<pre>{{Media
 | multi = y
 | audio = 
 | music = y
 | video = y
}}</pre>
{{Media
 | multi = y
 | audio = 
 | music = y
 | video = y
}}
<pre>{{Media
 | multi = y
 | audio = y
 | video = y
}}</pre>
{{Media
 | multi = y
 | audio = y
 | video = y
}}
<pre>{{Media
 | multi = y
 | audio = y
 | music = y
 | video = y
 | 15
}}</pre>
{{Media
 | multi = y
 | audio = y
 | music = y
 | video = y
 | 15
}}

===Key examples===
<pre>{{Media|key=y}}</pre>
{{Media|key=y}}
<pre>{{Media
 | key  = y
 | type = music
}}</pre>
{{Media
 | key = y
 | type = music
}}
<pre>{{Media
 | key  = y
 | type = film
}}</pre>
{{Media
 | key  = y
 | type = film
}}
<pre>{{Media|key=y|nobreak=y}}</pre>
{{Media|key=y|nobreak=y}}
<pre>{{Media
 | key   = y
 | parts = sections
}}</pre>
{{Media
 | key   = y
 | parts = sections
}}

==Related templates==
*{{tl|Listen}} - to add audio files to a text
*{{tl|Watch}} - to add video files to a text

<!-- template categories and interwiki links -->
<includeonly>
[[Category:Typing-aid templates]]
</includeonly>