Template:Music/doc: Difference between revisions

This is a documentation subpage for Template:Music. It may contain usage information, categories and other content that is not part of the original template page.

{{Music}} renders Western music notation of various types into Wikipedia and improves cross-browser support for music symbols. Per Wikipedia:Manual of Style (music)#Accidentals this template (or the terms "flat", etc.) should be used in preference to the lowercase letter "b" and the number sign (#).

The images used here are categorized at commons:Category:Template:Music, so if you change an image used please try and remember to update the categorization.

The template correctly renders Unicode sharps (♯), flats (♭), and natural signs (♮) in Internet Explorer which would otherwise display empty squares unless a full Unicode font is chosen in its Preferences. The choice of fonts also improves the rendering in other browsers on Microsoft Windows such as Mozilla Firefox. See the tables below to compare the results in your current browser. The template makes use of SVG to display double flat (), double sharp (), and microtonal signs since the corresponding Unicode characters are not widely supported.

Symbol	Unicode entity	Unicode result	Template text	Template result
Flat	♭	♭	{{music|flat}} or {{music|b}} or {{music|♭}} or {{flat}}	♭
Natural	♮	♮	{{music|natural}} or {{music|♮}}	♮
Sharp	♯	♯	{{music|sharp}} or {{music|#}} or {{music|♯}} or {{sharp}}	♯
Double flat	𝄫	𝄫	{{music|doubleflat}} or {{music|bb}} or {{music|𝄫}}
Double sharp	𝄪	𝄪	{{music|doublesharp}} or {{music|##}} or {{music|x}} or {{music|𝄪}}
Triple flat			{{music|tripleflat}} or {{music|bbb}}
Triple sharp			{{music|triplesharp}} or {{music|###}} or {{music|#x}}
Half flat	𝄳	𝄳	{{music|halfflat}} or {{music|d}}
Half sharp	𝄲	𝄲	{{music|halfsharp}} or {{music|t}}
Flat stroke	𝄳	𝄳	{{music|flatstroke}}
Double flat stroke			{{music|doubleflatstroke}}
Three quarter flat			{{music|threequarterflat}} or {{music|db}}
Three quarter sharp			{{music|threequartersharp}} or {{music|#t}}
Septimal quarter tone (-)			{{music|7}} or {{music|septimalquartertone-}}
Septimal quarter tone (+)			{{music|L}} or {{music|septimalquartertone+}}	Error using {{music}}: unable to parse music symbol "septimalquartertone+"
Eleventh partial [53 cents] (-)			{{music|down}} or {{music|Down}}	↓
Eleventh partial [difference between 11:8 & 4:3] (+)			{{music|up}} or {{music|Up}}	↑
Thirteenth partial [26.8 cents] (-)			{{music|13upsidedown}} or {{music|thirteenupsidedown}} or {{music|13U}}	Error using {{music}}: unable to parse music symbol "13upsidedown"
Thirteenth partial [difference between 13:8 & 8:5] (+)			{{music|13}} or {{music|thirteen}}
Seventeenth partial [34.28 cents] (-)			{{music|17 upside down}}	Error using {{music}}: unable to parse music symbol "17upsidedown"
Seventeenth partial [difference between 17:16 & 25:24] (+)			{{music|17}}
Nineteenth partial [18.13 cents] (-)			{{music|19}}
Nineteenth partial [difference between 19:16 & 6:5] (+)			{{music|19 upside down}}	Error using {{music}}: unable to parse music symbol "19upsidedown"

Sample text

The C♯ crops up very early in Beethoven's Symphony No. 3 in E♭.

Symbol	Unicode entity	Unicode result	Template text	Template result
Whole note	𝅝	𝅝	{{music|wholenote}} or {{music|whole}} or {{music|semibreve}}
Half note	𝅗𝅥	𝅗𝅥	{{music|halfnote}} or {{music|half}} or {{music|minim}}
Quarter note	𝅘𝅥	𝅘𝅥	{{music|quarternote}} or {{music|quarter}} or {{music|crotchet}}
Eighth note	𝅘𝅥𝅮	𝅘𝅥𝅮	{{music|eighthnote}} or {{music|eighth}} or {{music|quaver}}
Beamed eighth notes			{{music|eighthnotebeam}} or {{music|eighthbeam}} or {{music|quaverbeam}}
Sixteenth note	𝅘𝅥𝅯	𝅘𝅥𝅯	{{music|sixteenthnote}} or {{music|sixteenth}} or {{music|semiquaver}}
Beamed sixteenth notes			{{music|sixteenthnotebeam}} or {{music|sixteenthbeam}} or {{music|semiquaverbeam}}
Thirty- second note			{{music|thirty-secondnote}} or {{music|thirty-second}} or {{music|demisemiquaver}}
Dot	.	.	{{music|dot}}	.
Dotted quarter note	𝅘𝅥𝅯.	𝅘𝅥𝅯.	{{music|dottedquarter}} or {{music|dottedcrotchet}}	.
Dotted half note	𝅗𝅥.	𝅗𝅥.	{{music|dottedhalf}} or {{music|dottedminim}}	.
Whole rest	𝄻	𝄻	{{music|wholerest}} or {{music|semibreverest}}
Half rest	𝄼	𝄼	{{music|halfrest}} or {{music|minimrest}}
Quarter rest	𝄽	𝄽	{{music|quarterrest}} or {{music|crotchetrest}}
Eighth rest	𝄾	𝄾	{{music|eighthrest}} or {{music|quaverrest}}
Sixteenth rest	𝄿	𝄿	{{music|sixteenthrest}} or {{music|semiquaverrest}}
Thirty- second rest			{{music|thirtysecondrest}} or {{music|demisemiquaverrest}}

Some browsers and typefaces support ♩ (♩) and ♪ (♪) for quarter and eighth notes, as well as ♫ (♫) and ♬ (♬) for beamed eighth-note and sixteenth-note pairs respectively, but since the display of these characters does not match any of the other (non-supported) notes and rests, this template does not use these characters.

Sample text

In place of the single whole note (), Chopin writes , completely changing the profile of the music.

Symbol	Template text	Template result
Treble clef or G-clef	{{music|treble}} or {{music|trebleclef}} or {{music|gclef}}
Alto clef	{{music|alto}} or {{music|altoclef}}
Tenor clef	{{music|tenor}} or {{music|tenorclef}}
C-clef	{{music|cclef}}
Bass clef or F-clef	{{music|bass}} or {{music|bassclef}} or {{music|fclef}}
Neutral clef	{{music|neutral}} or {{music|neutralclef}}	||

Note that there is no graphical distinction between treble clef and G-clef; alto clef, tenor clef and C-clef; bass clef and F-clef. The names preserve a difference in meaning and make the caption text (for screen readers) different.

Symbol	Template text	Template result
common-time	{{music|common-time}}
cut-time	{{music|cut-time}} or {{music|alla-breve}}
2/4	{{music|time|2|4}}	2 4
3/4	{{music|time|3|4}}	3 4
6/8	{{music|time|6|8}}	6 8
9/8	{{music|time|9|8}}	9 8
12/8	{{music|time|12|8}}	12 8

For a general time signature, use {{music|time|top number|bottom number}}. This makes use of Template:Time signature, which should not be used on its own.

Scale degrees are often represented as Arabic numerals with a hat on them and thus the root of a scale is .

Scale degree	Template text	Template result
1	{{music|scale|1}}
2	{{music|scale|2}}
3	{{music|scale|3}}
4	{{music|scale|4}}
5	{{music|scale|5}}
6	{{music|scale|6}}
7	{{music|scale|7}}
8	{{music|scale|8}}
9	{{music|scale|9}}

Sample text

A descending tetrachord could be written as ---.

Sample text

vii^o becomes vii^ø in B♭ minor by raising the G♭ to G♮.

III becomes III⁺ in G♯ minor by raising the F♯ to F.

The F♯Δ⁷ is used to great effect in the last measure of the piece.

Key signatures must be typed in using the names of the articles themselves on keys. Note that there is no visual difference between the major and minor key signatures, but the alt text is different.

Sharps/Flats	Key signature (major)	Template text	Template result	Key signature (minor)	Template text	Template result
7♯	C♯ major	{{music|c-sharp major}}		A♯ minor	{{music|a-sharp minor}}
6♯	F♯ major	{{music|f-sharp major}}		D♯ minor	{{music|d-sharp minor}}
5♯	B major	{{music|b major}}		G♯ minor	{{music|g-sharp minor}}
4♯	E major	{{music|e major}}		C♯ minor	{{music|c-sharp minor}}
3♯	A major	{{music|a major}}		F♯ minor	{{music|f-sharp minor}}
2♯	D major	{{music|d major}}		B minor	{{music|b minor}}
1♯	G major	{{music|g major}}		E minor	{{music|e minor}}
0	C major	{{music|c major}}		A minor	{{music|a minor}}
1♭	F major	{{music|f major}}		D minor	{{music|d minor}}
2♭	B♭ major	{{music|b-flat major}}		G minor	{{music|g minor}}
3♭	E♭ major	{{music|e-flat major}}		C minor	{{music|c minor}}
4♭	A♭ major	{{music|a-flat major}}		F minor	{{music|f minor}}
5♭	D♭ major	{{music|d-flat major}}		B♭ minor	{{music|b-flat minor}}
6♭	G♭ major	{{music|g-flat major}}		E♭ minor	{{music|e-flat minor}}
7♭	C♭ major	{{music|c-flat major}}		A♭ minor	{{music|a-flat minor}}

Symbol	Unicode entity	Unicode result	Template text	Template result
Left repeat	𝄆	𝄆	{{Music|left repeat}}
Right repeat	𝄇	𝄇	{{Music|right repeat}}

Most symbols generated by this template, including double flats and sharps, notes, rests and key signatures, use images, as corresponding Unicode characters either don't exist or are not supported by all browsers. Unlike characters, images don't scale along with the surrounding text. To change the size of an image, to match the font size of the text in which it is placed, use the {{{size}}} parameter. Example:

• <big><big>G{{music|bb|size=x16px}}</big></big> → G

• Template:MusicScore
• commons:Template:Music
• Help:Score and mw:Extension:Score