Template:audio
| (file) |
- The following documentation is located at Template:audio/documentation. [edit]
- Useful links: subpage list • links • redirects • transclusions • errors (parser/module) • sandbox (diff)
This template links to an audio file of spoken language, typically in the "Pronunciation" section of an entry to indicate how a term is pronounced.
To link to an audio file connected to the meaning of the entry (for example, a recording of a klaxon sound in the klaxon entry), use {{listen}}.
Parameters
|1=(required)- The language code (see Wiktionary:List of languages) for the current language section. The parameter
|lang=is a deprecated synonym; please do not use. If this is used, all numbered parameters move down by one. |2=(required)- The name of the audio file.
|3=- The caption to use, in place of "Audio". In most cases, don't override this, but use one of the following parameters instead.
|q=- Specifies a qualifier to be placed before the audio box, after the "Audio" caption. This is formatted with the
{{q}}/{{qualifier}}template. |a=- Specifies one or more comma-separated accent qualifiers to be placed before the audio box, after the "Audio" caption, and are useful for specifying the accent found in the audio file. These are formatted with the
{{a}}/{{accent}}template. To be recognized as a separator, there must be no space following the comma; otherwise, the comma is treated as an embedded comma within the accent qualifier. |qq=- Specifies a qualifier to be placed at the end, after the audio box. Normally, use
|q=instead of this, unless the qualifier is particularly long. This is formatted with the{{q}}/{{qualifier}}template. |aa=- Specifies one or more comma-separated accent qualifiers to be placed at the end, after the audio box. Normally, use
|a=instead of this, unless the qualifier is particularly long. These are formatted with the{{a}}/{{accent}}template. To be recognized as a separator, there must be no space following the comma; otherwise, the comma is treated as an embedded comma within the accent qualifier. |ref=- Specifies one or more reference notes to be placed directly after the audio box. The reference is placed in the
===References===section at the bottom of the language's entry. See below for the format of this parameter. |text=- Specifies the text of the audio snippet, if it isn't the same as the term being illustrated. This can be used, for example, when the audio snippet contains extra words in it (e.g. articles).
|IPA=- Specifies the IPA pronunciation of the audio snippet. This can be used, for example, when the audio snippet contains extra words in it, to make it easier to pick out the relevant term. The IPA should be enclosed in brackets or slashes, like the parameters of
{{IPA}}. |t=- Specifies the meaning (gloss) of the text in
|text=, if that text is in a foreign language and its meaning isn't obvious. |lit=- Specifies the literal meaning of the text in
|text=, if needed. |tr=- Specifies the manual transliteration of the text in
|text=, for text in non-Latin scripts where either the automatic transliteration isn't correct or there is no automatic transliteration (e.g. in Persian and Hebrew). |ts=- Specifies the transcription of the text in
|text=, for text in non-Latin scripts where the transliteration is radically different from the actual pronunciation. To be used sparingly and only for certain languages; see the description of this parameter in{{l}}for more information. |pos=- Specifies the part of speech of the text in
|text=. Included mostly for completeness; rarely needed. |nocat=1- Turns off categorization.
|sort=- Manual sortkey. Use sparingly; the
makeSortKeymethod in Module:languages can usually generate the correct sortkey. |bad=- To formulate a warning to the reader about quality problems of the audio.
Examples
- The file name should be formatted as [language code]-[dialect if any]-[term].
- Wikitext:
{{audio|fr|LL-Q150 (fra)-WikiLucas00-avoir un nom à coucher dehors.wav|IPA=/a.vwaʁ œ̃ nɔ̃ a ku.ʃe də.ɔʁ/|a=Lyon|lit=to have a noun to hide behind|t=to have a jawbreaker/mouthful|text=avoir un nom à coucher dehors}} - Result:
(file)
References
The |refN= parameter is used to specify one or more references for a given pronunciation and works similarly to the <ref> tag. For example, specifying |ref={{R:it:DiPI|bendo}} is similar to placing <ref>{{R:it:DiPI|bendo}}</ref> after the call to {{IPA}}, except that it can be used to insert references directly after a given pronunciation when there are several.
To specify multiple references, separate them with !!! (optionally with spaces around it). For example, the following:
{{audio|it|It-bendo.ogg|ref={{R:it:DiPI|bendo}} !!! {{R:it:Olivetti}}}}
is similar to the following:
{{audio|it|It-bendo.ogg}}<ref>{{R:it:DiPI|bendo}}</ref><ref>{{R:it:Olivetti}}</ref>
To specify the equivalent of the <ref name="NAME" group="GROUP">...</ref>, use <<name:NAME>> and/or <<group:GROUP>> directly following the reference text. For example, the following:
{{audio|it|It-bendo.ogg|ref={{R:it:DiPI|bendo}}<<name:bendo>> !!! {{R:it:Olivetti}}}}
is similar to the following:
{{audio|it|It-bendo.ogg}}<ref name="bendo">{{R:it:DiPI|bendo}}</ref><ref>{{R:it:Olivetti}}</ref>
Similarly, the following:
{{audio|it|It-bendo.ogg|ref={{R:it:DiPI|bendo}}<<name:bendo>><<group:pron>>}}
is similar to the following:
{{audio|it|It-bendo.ogg}}<ref name="bendo" group="pron">{{R:it:DiPI|bendo}}</ref>
To reference a prior name, as in <ref name="bendo"/>, leave the reference text blank:
{{audio|it|It-bendo.ogg|ref=<<name:bendo>>}}
Similarly, to reference a prior name in a particular group, as in <ref name="bendo" group="pron"/>, use:
{{audio|it|It-bendo.ogg|ref=<<name:bendo>><<group:pron>>}}
See also
{{listen}}– for relevant sound samples (not spoken language)
TemplateData
TemplateData for audio
An audio file to assist readers pronouncing the word. Labeled with language and possibly dialect.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Language | 1 | The language (see [[Wiktionary:Languages]]) the recording is in.
| String | required |
| Audio file | 2 | The sound file to play.
| File | required |
| Caption | 3 | Text displayed before the audio box. Defaults to 'Audio'; rarely needs to be specified.
| String | optional |
| Left accent qualifier(s) | a | Specifies one or more comma-separated accent qualifiers to be placed before the audio box. These are formatted with the {{a}}/{{accent}} template. | String | optional |
| Left qualifier | q | Specifies a qualifier to be placed before the audio box. This is formatted with the {{q}}/{{qualifier}} template. | String | optional |
| Right accent qualifier(s) | aa | Specifies one or more comma-separated accent qualifiers to be placed after the audio box. These are formatted with the {{a}}/{{accent}} template. | String | optional |
| Right qualifier | qq | Specifies a qualifier to be placed after the audio box. This is formatted with the {{q}}/{{qualifier}} template. | String | optional |
| Reference | ref | Specifies a reference note to be placed directly after the audio box. The reference is placed in the ===References=== section at the bottom of the language's entry. | String | optional |
| Text of audio snippet | text | Specifies the text of the audio snippet, used especially when it contains additional words. | String | optional |
| IPA of audio snippet | IPA | Specifies the IPA pronunciation of the audio snippet, used especially when it contains additional words. | String | optional |