1 @c -*- coding: utf-8; mode: texinfo; -*-
3 Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. See TRANSLATION for details.
13 @cindex guitar tablature
20 @subsection Guitar sections
23 * String number indications::
25 * Non-guitar tablatures::
28 * Right hand fingerings::
29 * Other guitar issues::
32 @node String number indications
33 @subsubsection String number indications
35 @cindex String numbers
37 String numbers can be added to chords, by indicating the string number
38 with @code{\}@var{number},
40 @lilypond[relative,relative=1,ragged-right,fragment]
47 Internals Reference: @internalsref{StringNumber},
48 @c @lsr{guitar/,string-number.ly}.
51 @node Tablatures basic
52 @subsubsection Tablatures basic
53 @cindex Tablatures basic
55 Tablature notation is used for notating music for plucked string
56 instruments. Pitches are not denoted with note heads, but by
57 numbers indicating on which string and fret a note must be played. LilyPond
58 offers limited support for tablature.
60 The string number associated to a note is given as a backslash
61 followed by a number, e.g., @code{c4\3} for a C quarter on the third
62 string. By default, string 1 is the highest one, and the tuning
63 defaults to the standard guitar tuning (with 6 strings). The notes
64 are printed as tablature, by using @internalsref{TabStaff} and
65 @internalsref{TabVoice} contexts
67 @lilypond[quote,ragged-right,fragment,verbatim]
77 When no string is specified, the first string that does not give a
78 fret number less than @code{minimumFret} is selected. The default
79 value for @code{minimumFret} is 0
84 \set TabStaff.minimumFret = #8
87 @lilypond[quote,ragged-right]
91 \set TabStaff.minimumFret = #8
95 \new Staff { \clef "G_8" \frag }
96 \new TabStaff { \frag }
103 To print tablatures with stems down and horizontal beams,
104 initialize the @code{TabStaff} with this code:
108 \override Beam #'damping = #100000
113 Internals Reference: @internalsref{TabNoteHead}, @internalsref{TabStaff}, @internalsref{TabVoice}.
117 Chords are not handled in a special way, and hence the automatic
118 string selector may easily select the same string to two notes in a
121 In order to handle @code{\partcombine}, a @code{TabStaff} must use
122 specially-created voices:
124 @lilypond[quote,ragged-right,verbatim]
125 melodia = \partcombine { e4 g g g }{ e4 e e e }
128 \new TabVoice = "one" s1
129 \new TabVoice = "two" s1
130 \new TabVoice = "shared" s1
131 \new TabVoice = "solo" s1
138 @node Non-guitar tablatures
139 @subsubsection Non-guitar tablatures
140 @cindex Non-guitar tablatures
142 You can change the tuning of the strings. A string tuning is given as
143 a Scheme list with one integer number for each string, the number
144 being the pitch (measured in semitones relative to middle C) of an
145 open string. The numbers specified for @code{stringTunings} are the
146 numbers of semitones to subtract or add, starting the specified pitch
147 by default middle C, in string order. LilyPond automatically calculates
148 the number of strings by looking at @code{stringTunings}.
151 @code{stringTunings} is set for the pitches e, a, d, and g
153 @lilypond[quote,ragged-right,fragment,verbatim]
155 \set TabStaff.stringTunings = #'(-5 -10 -15 -20)
157 a,4 c' a e' e c' a e'
162 LilyPond comes with predefined string tunings for banjo, mandolin, guitar
166 \set TabStaff.stringTunings = #bass-tuning
169 The default string tuning is @code{guitar-tuning} (the standard EADGBE
171 Some other predefined tunings are @code{guitar-open-g-tuning},
172 @code{mandolin-tuning} and @code{banjo-open-g-tuning}.
176 The file @file{scm/@/output@/-lib@/.scm} contains the predefined string
178 Internals Reference: @internalsref{Tab_note_heads_engraver}.
182 No guitar special effects have been implemented.
186 @node Banjo tablatures
187 @subsubsection Banjo tablatures
188 @cindex Banjo tablatures
190 LilyPond has basic support for five stringed banjo. When making tablatures
191 for five stringed banjo, use the banjo tablature format function to get
193 fret numbers for the fifth string:
195 @lilypond[quote,ragged-right,fragment,verbatim]
197 \set TabStaff.tablatureFormat = #fret-number-tablature-format-banjo
198 \set TabStaff.stringTunings = #banjo-open-g-tuning
201 g8 d' g'\5 a b g e d' |
202 g4 d''8\5 b' a'\2 g'\5 e'\2 d' |
208 A number of common tunings for banjo are predefined in LilyPond:
209 @code{banjo-c-tuning} (gCGBD), @code{banjo-modal-tuning} (gDGCD),
210 @code{banjo-open-d-tuning} (aDF#AD) and @code{banjo-open-dm-tuning}
213 These tunings may be converted to four string banjo tunings using the
214 @code{four-string-banjo} function:
217 \set TabStaff.stringTunings = #(four-string-banjo banjo-c-tuning)
222 The file @file{scm/@/output@/-lib@/.scm} contains predefined banjo tunings.
226 @subsubsection Fret diagrams
227 @cindex fret diagrams
228 @cindex chord diagrams
230 Fret diagrams can be added to music as a markup to the desired note. The
231 markup contains information about the desired fret diagram, as shown in the
234 @lilypond[verbatim, ragged-right, quote]
236 d'^\markup \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-2;"
238 fis'^\markup \override #'(size . 0.75) {
239 \override #'(finger-code . below-string) {
240 \fret-diagram-verbose #'((place-fret 6 2 1) (barre 6 1 2)
241 (place-fret 5 4 3) (place-fret 4 4 4)
242 (place-fret 3 3 2) (place-fret 2 2 1)
247 c'^\markup \override #'(dot-radius . 0.35) {
248 \override #'(finger-code . in-dot) {
249 \override #'(dot-color . white) {
250 \fret-diagram-terse #"x;3-1-(;5-2;5-3;5-4;3-1-);"
259 There are three different fret-diagram markup interfaces: standard, terse,
260 and verbose. The three interfaces produce equivalent markups, but have
261 varying amounts of information in the markup string. Details about the
262 markup interfaces are found at @ref{Overview of text markup commands}.
264 You can set a number of graphical properties according to your preference.
265 Details about the property interface to fret diagrams are found at
266 @internalsref{fret-diagram-interface}.
271 Examples: @c @lsrdir{guitar}
274 @node Right hand fingerings
275 @subsubsection Right hand fingerings
277 Right hand fingerings in chords can be entered using
278 @code{@var{note}-\rightHandFinger @var{finger}}
280 @lilypond[verbatim,fragment,relative=2]
281 <c-\rightHandFinger #1 e-\rightHandFinger #2 >
284 for brevity, you can abbreviate @code{\rightHandFinger} to something
285 short, for example @code{RH},
288 #(define RH rightHandFinger)
291 @cindex fingerings, right hand, for guitar
292 @cindex right hand fingerings for guitar
296 You may exercise greater control over right handing fingerings by
297 setting @code{strokeFingerOrientations},
299 @lilypond[quote,verbatim,ragged-right,fragment,relative=1]
300 #(define RH rightHandFinger)
302 \set strokeFingerOrientations = #'(up down)
303 <c-\RH #1 es-\RH #2 g-\RH #4 > 4
304 \set strokeFingerOrientations = #'(up right down)
305 <c-\RH #1 es-\RH #2 g-\RH #4 > 4
309 The letters used for the fingerings are contained in the property
310 @code{digit-names}, but they can also be set individually by supplying
311 @code{\rightHandFinger} with a string argument, as in the following example
314 @lilypond[quote,verbatim,ragged-right,fragment,relative=1]
315 #(define RH rightHandFinger)
317 \set strokeFingerOrientations = #'(right)
318 \override StrokeFinger #'digit-names = ##("x" "y" "z" "!" "@")
326 Internals Reference: @internalsref{StrokeFinger}
330 @node Other guitar issues
331 @subsubsection Other guitar issues
333 This example demonstrates how to include guitar position and
336 @lilypond[quote,ragged-right,fragment,verbatim,relative=0]
340 \override TextSpanner #'bound-details #'left #'text = #"XII "
342 b16 e16 g16 e16 b16 g16\stopTextSpan
347 Stopped (X) note heads are used in guitar music to signal a place where the
348 guitarist must play a certain note or chord, with its fingers just
349 touching the strings instead of fully pressing them. This gives the sound a
350 percussive noise-like sound that still maintains part of the original
351 pitch. It is notated with cross note heads; this is
352 demonstrated in @ref{Special note heads}.