View source for User:Stephenj642/Sound

{{Wiki markup}}
<div style="border:1px solid #A3B1BF; background:#f5faff; padding:1em; margin:0em 1em 1em 0em; float:left; font-size:105%">
The best sound markup in most situations is

<code><nowiki>{{</nowiki>listen |filename=''FILENAME''.ogg |title=''TITLE'' |description=''DESCRIPTION'' <nowiki>}}</nowiki></code>
</div>
<br clear="left"/>

==File types==
Before a file can be used, it must be uploaded to either Wikipedia or the [[Wikimedia Commons]] sister project. Uploading to Commons is recommended as files can be used by other sister projects. Files being used under fair use provisions must be stored on Wikipedia. The markup is the same regardless of where it is uploaded.

The following sound formats may be uploaded:
* [[Ogg|ogg]]/[[Ogg|oga]] - recommended.
* [[Musical Instrument Digital Interface|mid]]

==Using templates==
===To the side===
Normally, sound files are presented on Wikipedia pages using the [[:Template:Listen]] or its related templates.

This is an example, displaying common usage:
{{listen |filename=Accordion chords-01.ogg |title=Accordion chords |description=Chords being played on an accordion }}
:<code><nowiki>{{listen |filename=Accordion chords-01.ogg |title=Accordion chords |description=Chords being played on an accordion }}
</nowiki></code>

===Inline===
====[[:Template:Audio]]====
This template links to an audio file for quick listening.  It is meant to be used inline with text, for pronunciations and the like.

<code><nowiki>{{Audio|name of sound file|text to use as link to soundfile}}</nowiki></code>

Example:

:<code><nowiki>'''Bordeaux''' ({{Audio||pronunciation}}) is a [[Seaport|port]] city in...</nowiki></code>

gives this:

:'''Bordeaux''' ({{Audio||pronunciation}}) is a [[Seaport|port]] city in...

Note that a printout of the page will remove the "help·info" bit and give:

:'''Bordeaux''' (<span class="unicode audiolink">[[:Media:Fr-Bordeaux.ogg|pronunciation]]</span>&nbsp;) is a [[Seaport|port]] city in...

Setting {{para|help|no}} disables the "help/info" links. If this is done the template {{tlx|inline audio}} ''must'' be shown on the page.

====Other inline templates====
* [[:Template:Audio-nohelp]] - No help link
* [[:Template:Pronunciation]] - A shortcut for  {{tlx|Audio|''soundfile.ogg''|pronunciation}}
* [[:Template:Audlisten]] - Simple listen link
* [[:Template:Audio-IPA]] - Include IPA information
* [[:Template:Audio-cs]] - Czech
* [[:Template:Audio-da]] - Danish
* [[:Template:Audio-de]] - German
* [[:Template:Audio-es]] - Spanish
* [[:Template:Audio-pl]] - Polish
* [[:Template:Audio-pt]] - Portuguese
* [[:Template:Audio-ru]] - Russian
* [[:Template:Audio-uk]] - Ukrainian

===In an infobox===
* [[:Template:Extra musicsample]] - This template is for adding a music sample within {{tl|Infobox song}} or {{tl|Infobox single}}.

==Directly using a file==
Normally, sound files are presented on Wikipedia pages using the [[:Template:Listen]] or its related templates. However, it is also possible to present an audio file without any template.

<code><nowiki>[[File:Accordion_chords-01.ogg]]</nowiki></code>
[[File:Accordion_chords-01.ogg]]
----
If the code <code>noicon</code>" is used the information icon is not displayed.

<code><nowiki>[[File:Accordion_chords-01.ogg|</nowiki>'''<span style="color:red;">noicon</span>'''<nowiki>]]</nowiki></code>
[[File:Accordion_chords-01.ogg|noicon]]
----
[[File:Accordion_chords-01.ogg|thumb|Caption]]
The thumb option may be used to give the file a caption

<code><nowiki>[[File:Accordion_chords-01.ogg|</nowiki>'''<span style="color:red;">thumb|Caption</span>'''<nowiki>]]</nowiki></code>

Note that none of these examples provide links to [[Wikipedia:Media help]]. Thus, whenever this method is used, the [[:Template:Inline audio]] must be shown on the page.

== Link to a file without displaying it ==

To link to a description page, put a colon before the prefix.
: <code><nowiki>[[:File:Example.ogg]]</nowiki></code>
: [[:File:Example.ogg]]

You can also link directly to the file using "<code>Media:</code>" instead of "<code>File:</code>".
: <code><nowiki>[[Media:Example.ogg]]</nowiki></code>
: [[Media:Example.ogg]]

In both cases [[Help:Piped link|piped links]] also work.