5.2.4 Convenzioni sui nomi
È importante conoscere le convenzioni sui nomi. Ecco una panoramica:
- funzioni Scheme: minuscolo-con-trattini (inclusi i nomi di una-parola)
- funzioni Scheme specifiche di LilyPond: ly:plus-scheme-style
- eventi, classi e proprietà musicali: come-le-funzioni-scheme
- interfacce Grob: stile-scheme
- proprietà del backend: stile-scheme (ma ammette X e Y!)
- contesti (e EspressioniMusicali e grob): Maiuscolo o CamelCase
- proprietà di contesto: minuscoloSeguitoDaCamelCase
- incisori: Maiuscolo_seguito_da_minuscolo_e_con_trattini_bassi
Domande che aspettano una risposta:
- Quali di queste sono convenzioni e quali sono regole?
- Quali sono regole del linguaggio sottostante e quali sono specifiche di LilyPond?
A.22 Convenzioni per i nomi
Si usano delle convenzioni per i nomi in modo che sia più facile avere in mente la natura di un oggetto.
| Object/property type | Convenzione del nome | Esempi |
|---|---|---|
| Parole chiave | aaaa | \score, \addlyrics |
| Funzioni musicali e scorciatoie | aaaa o aaaaAaaaAaaa | \time, \stemUp |
| Funzioni di markup | aaaa o aaaa-aaaa-aaaa | \bold, \with-dimensions |
| Variabili del foglio | aaaa o aaaa-aaaa-aaaa | indent, page-breaking |
| Espressioni musicali | Aaaa o AaaaAaaaAaaa | NoteEvent, SequentialMusic |
| Classi musicali | aaaa o aaaa-aaaa-aaaa | note-event, rhythmic-event |
| Proprietà musicali | aaaa o aaaa-aaaa-aaaa | force-accidental, iterator-ctor |
| Contesti | Aaaa o AaaaAaaaAaaa | Staff, GrandStaff |
| Proprietà di contesto | aaaa o aaaaAaaaAaaa | stanza, instrumentName |
| Incisori | Aaaa_engraver o Aaaa_aaaa_aaaa_engraver | Clef_engraver, Note_heads_engraver |
| Oggetti di formattazione | Aaaa o AaaaAaaaAaaa | Slur, NoteHead |
| Proprietà degli oggetti di formattazione | aaa o aaa-aaa-aaa | direction, beam-thickness |
| Interfacce | aaa-aaa-interface | grob-interface, break-aligned-interface |
| Funzioni Scheme definite in Guile | aaaa o aaaa-aaaa-aaaa | map, for-each |
| Funzioni Scheme definite in LilyPond | ly:aaaa o ly:aaaa-aaaa-aaaa o
aaaa o aaaa-aaaa-aaaa
1 | ly:round-filled-box, music-map |
Note a piè di pagina
[1] Per ragioni storiche, alcune ma non tutte le funzioni
definite da LilyPond iniziano col prefisso ly:.