X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fnotation%2Fnotation-appendices.itely;h=5d4ad9769afb9a1d3f1c679dda477dc2018e1a1f;hb=23ec49df6ea90e610158a4fe1c35d1adea0c0450;hp=66a907f7096c49ddce8ae0bbb21ea7896d89f563;hpb=2f320e9722ec20d6f13ec567d007763cc912c5da;p=lilypond.git diff --git a/Documentation/notation/notation-appendices.itely b/Documentation/notation/notation-appendices.itely index 66a907f709..5d4ad9769a 100644 --- a/Documentation/notation/notation-appendices.itely +++ b/Documentation/notation/notation-appendices.itely @@ -8,7 +8,7 @@ Guide, node Updating translation committishes.. @end ignore -@c \version "2.14.0" +@c \version "2.15.17" @node Notation manual tables @appendix Notation manual tables @@ -18,18 +18,21 @@ * Common chord modifiers:: * Predefined string tunings:: * Predefined fretboard diagrams:: +* Predefined paper sizes:: * MIDI instruments:: * List of colors:: * The Feta font:: * Note head styles:: * Text markup commands:: * Text markup list commands:: +* List of special characters:: * List of articulations:: * Percussion notes:: * Technical glossary:: * All context properties:: * Layout properties:: * Available music functions:: +* Context modification identifiers:: * Predefined type predicates:: * Scheme functions:: @end menu @@ -39,10 +42,11 @@ @node Chord name chart @appendixsec Chord name chart -The following charts shows two standard systems for printing chord +The following chart shows two standard systems for printing chord names, along with the pitches they represent. -@lilypondfile{chord-names-jazz.ly} +@c The line width is a hack to allow space for instrument names +@lilypondfile[quote,line-width=15\cm]{chord-names-jazz.ly} @node Common chord modifiers @appendixsec Common chord modifiers @@ -69,7 +73,7 @@ Major third, perfect fifth @tab @code{5} or nothing @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:5 } @@ -82,7 +86,7 @@ Minor third, perfect fifth @tab @code{m} or @code{m5} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:m } @@ -95,7 +99,7 @@ Major third, augmented fifth @tab @code{aug} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:aug } @@ -108,7 +112,7 @@ Minor third, diminished fifth @tab @code{dim} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:dim } @@ -121,7 +125,7 @@ Major triad, minor seventh @tab @code{7} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:7 } @@ -134,7 +138,7 @@ Major triad, major seventh @tab @code{maj7} or @code{maj} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:maj7 } @@ -147,7 +151,7 @@ Minor triad, minor seventh @tab @code{m7} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:m7 } @@ -160,7 +164,7 @@ Diminished triad, diminished seventh @tab @code{dim7} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:dim7 } @@ -173,7 +177,7 @@ Augmented triad, minor seventh @tab @code{aug7} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:aug7 } @@ -186,7 +190,7 @@ Diminished triad, minor seventh @tab @code{m7.5-} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:m7.5- } @@ -199,7 +203,7 @@ Minor triad, major seventh @tab @code{m7+} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:m7+ } @@ -212,7 +216,7 @@ Major triad, sixth @tab @code{6} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:6 } @@ -225,7 +229,7 @@ Minor triad, sixth @tab @code{m6} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:m6 } @@ -238,7 +242,7 @@ Dominant seventh, major ninth @tab @code{9} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:9 } @@ -251,7 +255,7 @@ Major seventh, major ninth @tab @code{maj9} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:maj9 } @@ -264,7 +268,7 @@ Minor seventh, major ninth @tab @code{m9} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:m9 } @@ -277,7 +281,7 @@ Dominant ninth, perfect eleventh @tab @code{11} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:11 } @@ -290,7 +294,7 @@ Major ninth, perfect eleventh @tab @code{maj11} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:maj11 } @@ -303,7 +307,7 @@ Minor ninth, perfect eleventh @tab @code{m11} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:m11 } @@ -316,7 +320,7 @@ Dominant ninth, major thirteenth @tab @code{13} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:13 } @@ -329,7 +333,7 @@ Dominant eleventh, major thirteenth @tab @code{13.11} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:13.11 } @@ -342,7 +346,7 @@ Major eleventh, major thirteenth @tab @code{maj13.11} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:maj13.11 } @@ -355,7 +359,7 @@ Minor eleventh, major thirteenth @tab @code{m13.11} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:m13.11 } @@ -368,7 +372,7 @@ Major second, perfect fifth @tab @code{sus2} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:sus2 } @@ -381,7 +385,7 @@ Perfect fourth, perfect fifth @tab @code{sus4} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:sus4 } @@ -394,7 +398,7 @@ Perfect fifth @tab @code{1.5} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { \powerChords c1:1.5 @@ -408,7 +412,7 @@ Perfect fifth, octave @tab @code{1.5.8} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { \powerChords c1:1.5.8 @@ -429,15 +433,268 @@ The chart below shows the predefined string tunings. The chart below shows the predefined fretboard diagrams for guitar. -@lilypondfile{display-predefined-fretboards.ly} +@lilypondfile[line-width=15.5\cm]{display-predefined-fretboards.ly} The chart below shows the predefined fretboard diagrams for ukulele. -@lilypondfile{display-predefined-ukulele-fretboards.ly} +@lilypondfile[line-width=15.5\cm]{display-predefined-ukulele-fretboards.ly} The chart below shows the predefined fretboard diagrams for mandolin. -@lilypondfile{display-predefined-mandolin-fretboards.ly} +@lilypondfile[line-width=15.5\cm]{display-predefined-mandolin-fretboards.ly} + + +@node Predefined paper sizes +@appendixsec Predefined paper sizes + +Paper sizes are defined in @file{scm/paper.scm} + +@noindent +@strong{The @qq{ISO 216} A Series} +@table @code +@item "a10" +(26 x 37 mm) +@item "a9" +(37 x 52 mm) +@item "a8" +(52 x 74 mm) +@item "a7" +(74 x 105 mm) +@item "a6" +(105 x 148 mm) +@item "a5" +(148 x 210 mm) +@item "a4" +(210 x 297 mm) +@item "a3" +(297 x 420 mm) +@item "a2" +(420 x 594 mm) +@item "a1" +(594 x 841 mm) +@item "a0" +(841 x 1189 mm) +@end table + +@noindent +@strong{The @qq{ISO 216} B Series} +@table @code +@item "b10" +(31 x 44 mm) +@item "b9" +(44 x 62 mm) +@item "b8" +(62 x 88 mm) +@item "b7" +(88 x 125 mm) +@item "b6" +(125 x 176 mm) +@item "b5" +(176 x 250 mm) +@item "b4" +(250 x 353 mm) +@item "b3" +(353 x 500 mm) +@item "b2" +(500 x 707 mm) +@item "b1" +(707 x 1000 mm) +@item "b0" +(1000 x 1414 mm) +@end table + +@noindent +@strong{Two extended sizes as defined in @qq{DIN 476}} +@table @code +@item "4a0" +(1682 x 2378 mm) +@item "2a0" +(1189 x 1682 mm) +@end table + +@noindent +@strong{@qq{ISO 269} standard C series} +@table @code +@item "c10" +(28 x 40 mm) +@item "c9" +(40 x 57 mm) +@item "c8" +(57 x 81 mm) +@item "c7" +(81 x 114 mm) +@item "c6" +(114 x 162 mm) +@item "c5" +(162 x 229 mm) +@item "c4" +(229 x 324 mm) +@item "c3" +(324 x 458 mm) +@item "c2" +(458 x 648 mm) +@item "c1" +(648 x 917 mm) +@item "c0" +(917 x 1297 mm) +@end table + +@noindent +@strong{North American paper sizes} +@table @code +@item "junior-legal" +(8.0 x 5.0 in) +@item "legal" +(8.5 x 14.0 in) +@item "ledger" +(17.0 x 11.0 in) +@item "letter" +(8.5 x 11.0 in) +@item "tabloid" +(11.0 x 17.0 in) +@item "11x17" +(11.0 x 17.0 in) +@item "17x11" +(17.0 x 11.0 in) +@end table + +@noindent +@strong{Government-letter by IEEE Printer Working Group, for children's +writing} +@table @code +@item "government-letter" +(8 x 10.5 in) +@item "government-legal" +(8.5 x 13.0 in) +@item "philippine-legal" +(8.5 x 13.0 in) +@end table + +@noindent +@strong{ANSI sizes} +@table @code +@item "ansi a" +(8.5 x 11.0 in) +@item "ansi b" +(17.0 x 11.0 in) +@item "ansi c" +(17.0 x 22.0 in) +@item "ansi d" +(22.0 x 34.0 in) +@item "ansi e" +(34.0 x 44.0 in) +@item "engineering f" +(28.0 x 40.0 in) +@end table + +@noindent +@strong{North American Architectural sizes} +@table @code +@item "arch a" +(9.0 x 12.0 in) +@item "arch b" +(12.0 x 18.0 in) +@item "arch c" +(18.0 x 24.0 in) +@item "arch d" +(24.0 x 36.0 in) +@item "arch e" +(36.0 x 48.0 in) +@item "arch e1" +(30.0 x 42.0 in) +@end table + +@noindent +@strong{Antique sizes still used in the United Kingdom} +@table @code +@item "statement" +(5.5 x 8.5 in) +@item "half letter" +(5.5 x 8.5 in) +@item "quarto" +(8.0 x 10.0 in) +@item "octavo" +(6.75 x 10.5 in) +@item "executive" +(7.25 x 10.5 in) +@item "monarch" +(7.25 x 10.5 in) +@item "foolscap" +(8.27 x 13.0 in) +@item "folio" +(8.27 x 13.0 in) +@item "super-b" +(13.0 x 19.0 in) +@item "post" +(15.5 x 19.5 in) +@item "crown" +(15.0 x 20.0 in) +@item "large post" +(16.5 x 21.0 in) +@item "demy" +(17.5 x 22.5 in) +@item "medium" +(18.0 x 23.0 in) +@item "broadsheet" +(18.0 x 24.0 in) +@item "royal" +(20.0 x 25.0 in) +@item "elephant" +(23.0 x 28.0 in) +@item "double demy" +(22.5 x 35.0 in) +@item "quad demy" +(35.0 x 45.0 in) +@item "atlas" +(26.0 x 34.0 in) +@item "imperial" +(22.0 x 30.0 in) +@item "antiquarian" +(31.0 x 53.0 in) +@end table + +@noindent +@strong{PA4 based sizes} +@table @code +@item "pa0" +(840 x 1120 mm) +@item "pa1" +(560 x 840 mm) +@item "pa2" +(420 x 560 mm) +@item "pa3" +(280 x 420 mm) +@item "pa4" +(210 x 280 mm) +@item "pa5" +(140 x 210 mm) +@item "pa6" +(105 x 140 mm) +@item "pa7" +(70 x 105 mm) +@item "pa8" +(52 x 70 mm) +@item "pa9" +(35 x 52 mm) +@item "pa10" +(26 x 35 mm) +@end table + +@noindent +@strong{Used in Southeast Asia and Australia} +@table @code +@item "f4" +(210 x 330 mm) +@end table + +@noindent +@strong{Used for very small @code{@@lilypond} examples in the +documentation based on a8 landscape.} +@table @code +@item "a8landscape" +(74 x 52 mm) +@end table + @node MIDI instruments @appendixsec MIDI instruments @@ -626,6 +883,7 @@ see @ref{Formatting text}. * Bracket-tip glyphs:: * Pedal glyphs:: * Accordion glyphs:: +* Tie glyphs:: * Vaticana glyphs:: * Medicaea glyphs:: * Hufnagel glyphs:: @@ -633,6 +891,7 @@ see @ref{Formatting text}. * Neomensural glyphs:: * Petrucci glyphs:: * Solesmes glyphs:: +* Kievan Notation glyphs:: @end menu @@ -641,8 +900,8 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #clefs +\markuplist \override-lines #'(word-space . 4) + \doc-chars #clefs @end lilypond @@ -651,8 +910,8 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #timesig +\markuplist \override-lines #'(word-space . 4) + \doc-chars #timesig @end lilypond @@ -661,8 +920,8 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #numbers +\markuplist \override-lines #'(word-space . 4) + \doc-chars #numbers @end lilypond @@ -671,8 +930,8 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #accidentals +\markuplist \override-lines #'(word-space . 4) + \doc-chars #accidentals @end lilypond @@ -681,8 +940,8 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #default-noteheads +\markuplist \override-lines #'(word-space . 4) + \doc-chars #default-noteheads @end lilypond @@ -691,8 +950,8 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #special-noteheads +\markuplist \override-lines #'(word-space . 4) + \doc-chars #special-noteheads @end lilypond @@ -701,8 +960,8 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #shape-note-noteheads +\markuplist \override-lines #'(word-space . 4) + \doc-chars #shape-note-noteheads @end lilypond @@ -711,8 +970,8 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #rests +\markuplist \override-lines #'(word-space . 4) + \doc-chars #rests @end lilypond @@ -721,8 +980,8 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #flags +\markuplist \override-lines #'(word-space . 4) + \doc-chars #flags @end lilypond @@ -731,8 +990,8 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #dots +\markuplist \override-lines #'(word-space . 4) + \doc-chars #dots @end lilypond @@ -741,8 +1000,8 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #dynamics +\markuplist \override-lines #'(word-space . 4) + \doc-chars #dynamics @end lilypond @@ -751,8 +1010,8 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #scripts +\markuplist \override-lines #'(word-space . 4) + \doc-chars #scripts @end lilypond @@ -761,8 +1020,8 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #arrowheads +\markuplist \override-lines #'(word-space . 4) + \doc-chars #arrowheads @end lilypond @@ -771,8 +1030,8 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #brackettips +\markuplist \override-lines #'(word-space . 4) + \doc-chars #brackettips @end lilypond @@ -781,8 +1040,8 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #pedal +\markuplist \override-lines #'(word-space . 4) + \doc-chars #pedal @end lilypond @@ -791,8 +1050,18 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #accordion +\markuplist \override-lines #'(word-space . 4) + \doc-chars #accordion +@end lilypond + + +@node Tie glyphs +@unnumberedsubsec Tie glyphs + +@lilypond[quote] +\include "font-table.ly" +\markuplist \override-lines #'(word-space . 4) + \doc-chars #ties @end lilypond @@ -801,8 +1070,8 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #vaticana +\markuplist \override-lines #'(word-space . 4) + \doc-chars #vaticana @end lilypond @@ -811,8 +1080,8 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #medicaea +\markuplist \override-lines #'(word-space . 4) + \doc-chars #medicaea @end lilypond @@ -821,8 +1090,8 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #hufnagel +\markuplist \override-lines #'(word-space . 4) + \doc-chars #hufnagel @end lilypond @@ -831,8 +1100,8 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #mensural +\markuplist \override-lines #'(word-space . 4) + \doc-chars #mensural @end lilypond @@ -841,8 +1110,8 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #neomensural +\markuplist \override-lines #'(word-space . 4) + \doc-chars #neomensural @end lilypond @@ -851,8 +1120,8 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #petrucci +\markuplist \override-lines #'(word-space . 4) + \doc-chars #petrucci @end lilypond @@ -861,10 +1130,18 @@ see @ref{Formatting text}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #solesmes +\markuplist \override-lines #'(word-space . 4) + \doc-chars #solesmes @end lilypond +@node Kievan Notation glyphs +@unnumberedsubsec Kievan Notation glyphs + +@lilypond[quote] +\include "font-table.ly" +\markuplist \override-lines #'(word-space . 4) + \doc-chars #kievan +@end lilypond @node Note head styles @appendixsec Note head styles @@ -884,11 +1161,29 @@ The following styles may be used for note heads. @node Text markup list commands @appendixsec Text markup list commands -The following commands can all be used with @code{\markuplines}: +The following commands can all be used with @code{\markuplist}: @include markup-list-commands.tely +@node List of special characters +@appendixsec List of special characters + +The following special characters references can be used; +for more details, see @ref{ASCII aliases}. + +The HTML syntax is used and most of these references are the same as HTML. +The rest of them are inspired by @LaTeX{}. + +The characters are boxed so that you can see their size. +A small padding has been added between the character and the box +for more readability. + +@lilypond[quote] +\include "special-characters.ly" +@end lilypond + + @node List of articulations @appendixsec List of articulations @@ -1109,11 +1404,10 @@ character, or a combination of two characters formating a ligature. A set of glyphs with a single style and shape comprise a font, and a set of fonts covering several styles and sizes comprise a typeface. - @seealso Notation Reference: @ref{Fonts}, -@ref{Text encoding}. +@ref{Special characters}. @node grob @@ -1160,6 +1454,7 @@ In apparent contradiction to the name, they can be changed using Notation Reference: @ref{mutable}. + @node interface @unnumberedsubsec interface @@ -1219,6 +1514,7 @@ computations are stored in mutable properties. Notation Reference: @ref{immutable}. + @node output-def @unnumberedsubsec output-def @@ -1375,6 +1671,13 @@ Internals Reference: @include identifiers.tely +@node Context modification identifiers +@appendixsec Context modification identifiers + +The following commands are defined for use as context modifications +within a @code{\layout} or @code{\with} block. + +@include context-mod-identifiers.tely @node Predefined type predicates @appendixsec Predefined type predicates