3.1 Estructura del codi d’entrada

@translationof Input structure

El format principal d’entrada per al Lilypond són fitxers de text. Per convenció, el nom d’aquests fitxers acaba en ‘.ly’.

3.1.1 Estructura d’una partitura

@translationof Structure of a score

Un bloc \score ha de contenir una expressió musical única delimitada per un parell de claus:

\score {
  …
}

Aquesta expressió musical única pot tenir qualsevol mida, i pot contenir altres expressions musicals fins qualsevol grau de complexitat. Tots els exemples següents són expressions musicals:

{ c'4 c' c' c' }

{ { c'4 c' c' c' } { d'4 d' d' d' } }

<< \new Staff { c'4 c' c' c' } \new Staff { d'4 d' d' d' } >>

{
  \new GrandStaff <<
    \new StaffGroup <<
      \new Staff { \flute }
      \new Staff { \oboe }
    >>
    \new StaffGroup <<
      \new Staff { \violinI }
      \new Staff { \violinII }
    >>
  >>
}

Els comentaris són una excepció a aquesta regla generals (per veure altres excepcions, consulteu Estructura del fitxer). Tant els comentaris d’una línia com els que estan delimitat per %{ … %} es poden escriure en qualsevol lloc dins del fitxer d’entrada. Es poden escriure dins o fora del bloc \score, i dins o fora de l’expressió musical única dins del bloc \score.

Recordeu que fins i tot dins d’un fitxer que contengui sols un bloc \score, aquest bloc es trob inclòs implícitament dins d’un bloc \book. Un bloc \book dins d’un fitxer font produeix almenys un fitxer de sortida, i de forma predeterminada el nom del fitxer de sortida que es produeix es deriva del nom del fitxer d’entrada, de forma que ‘sardanaperaelefants.ly’ dóna com a resultat ‘sardanaperaelefants.pdf’.

(Per veure més detalls sobre els blocs \book, consulteu Diverses partitures a un llibre, Diversos fitxers de sortida a partir d’un d’entrada i Estructura del fitxer.)

Vegeu també

Manual d’aprenentatge: (learning)Treball sobre els fitxers d’entrada section ‘Treball sobre els fitxers d'entrada’ in Manual d’aprenentatge, (learning)Explicació de les expressions musicals section ‘Explicació de les expressions musicals’ in Manual d’aprenentatge, (learning)La partitura és una (única) expressió musical composta section ‘La partitura és una (única) expressió musical composta’ in Manual d’aprenentatge.

3.1.2 Diverses partitures a un llibre

@translationof Multiple scores in a book

Un document pot contenir diverses peces de música i text, com per exemple un llibre d’estudis o una part orquestral amb diversos moviments. Cada moviment s’introdueix com un bloc \score:

\score {
  …música…
}

i els textos s’introdueixen amb un bloc \markup:

\markup {
  …text…
}

Tots els moviments i els textos que apareixen en el mateix fitxer ‘.ly’ es graven normalment en la forma d’un sol fitxer de sortida.

\score {
  …
}
\markup {
  …
}
\score {
  …
}

Una excepció important es dóna dins dels documents del lilypond-book, en els quals hem d’escriure explícitament un bloc \book, perquè en cas contrari sola apareixerà a la sortida el primer \score o \markup.

L’encapçalament de cada peça es pot posar dins del bloc \score. Abans de cada moviment, s’imprimeix el nom de la peça (piece) extret de l’encapçalament. El títol del llibre sencer es pot posar dins del bloc \book, però si no hi és present s’insereix a l’encapçalament \header que està al principi del fitxer.

\header {
  title = "Vuit miniatures"
  composer = "Igor Stravinsky"
}
\score {
  …
  \header { piece = "Romanze" }
}
\markup {
   …text de la segona estrofa…
}
\markup {
   …text de la tercera estrofa…
}
\score {
  …
  \header { piece = "Menuetto" }
}

Es poden agrupar diferents peces de música en parts d’una llibre utilitzant blocs \bookpart. Les parts de llibre se separen per mitjà de salts de pàgina, i poden donar començament amb un títol, com el llibre pròpiament dit, mitjançant l’especificació del bloc \header.

\bookpart {
  \header {
    title = "Títol del llibre"
    subtitle = "Primera part"
  }
  \score { … }
  …
}
\bookpart {
  \header {
    subtitle = "Segona part"
  }
  \score { … }
  …
}

3.1.3 Diversos fitxers de sortida a partir d’un d’entrada

@translationof Multiple output files from one input file

Si volem diversos fitxers de sortida a partir del mateix fitxer ‘.ly’, podem escriure diversos blocs \book, on cadascú d’aquests blocs \book donarà com a resulta un fitxer de sortida diferent. Si no especifiquem cap bloc \book al fitxer, el LilyPond processa implícitament tot el fitxer com un sol bloc \book, vegeu Estructura del fitxer.

En produir diversos fitxers a partir d’un únic fitxer font, el LilyPond s’assegura que cap dels fitxers de sortida de cap bloc \book sobreescriu el fitxer de sortida produït per un \book anterior del mateix fitxer d’entrada.

Ho fa afegint un sufix al nom de la sortida per a cada llibre \book que utilitza el nom del fitxer de sortida predeterminat, derivat del fitxer font d’entrada.

El comportament predeterminat és afegir un sufix amb el número de versió per a cada nom que pugui coincidir; així:

\book {
  \score { … }
  \paper { … }
}
\book {
  \score { … }
  \paper { … }
}
\book {
  \score { … }
  \paper { … }
}

al fitxer font ‘eightminiatures.ly’, produeix

• ‘eightminiatures.pdf’,
• ‘eightminiatures-1.pdf’ y
• ‘eightminiatures-2.pdf’.

3.1.4 Noms dels fitxers de sortida

@translationof Output file names

El LilyPond us ofereix uns mecanismes que us permeten controlar els noms de fitxer que s’utilitzen per part dels diversos motors finals en produir els fitxers de sortida.

A la secció anterior havíem vist com el LilyPond evita les coincidències de noms en produir diverses sortides a partir d’un únic fitxer font d’entrada. També podem especificar els nostres propis sufixos per a cada bloc \book, de manera que podem produir, per exemple, fitxers amb els noms ‘eightminiatures-Romanze.pdf’, ‘eightminiatures-Menuetto.pdf’ y ‘eightminiatures-Nocturne.pdf’ afegint una declaració \bookOutputSuffix dins de cada bloc \book.

\book {
  \bookOutputSuffix "Romanze"
  \score { … }
  \paper { … }
}
\book {
  \bookOutputSuffix "Menuetto"
  \score { … }
  \paper { … }
}
\book {
  \bookOutputSuffix "Nocturne"
  \score { … }
  \paper { … }
}

També podem especificar un nom de fitxer de sortida diferent per a cada bloc book, mitjançant la utilització de declaracions \bookOutputName:

\book {
  \bookOutputName "Romanze"
  \score { … }
  \paper { … }
}
\book {
  \bookOutputName "Menuetto"
  \score { … }
  \paper { … }
}
\book {
  \bookOutputName "Nocturne"
  \score { … }
  \paper { … }
}

El codi anterior produeix els següents fitxers de sortida:

• ‘Romanze.pdf’,
• ‘Menuetto.pdf’ i
• ‘Nocturne.pdf’.

3.1.5 Estructura del fitxer

@translationof File structure

Un fitxer ‘.ly’ pot contenir qualsevol nombre d’expressions del nivell superior, on una expressió del nivell superior és una de les possibilitats següents:

• Una definició de sortida, com \paper, \midi i \layout. Una definició d’aquest tipus la nivell més alta canvia els ajustos predeterminats per a tot el llibre. Si s’introdueix més d’una d’aquestes definicions del mateix tipus al nivell més alt, les definicions es combinen, però en situacions de conflicte les definicions més tardanes tenen preferència. Per veure els detalls sobre com afecta al bloc \layout, consulteu El bloc \layout.
• Una expressió directa de l’Scheme, com #(set-default-paper-size "a7" 'landscape) o #(ly:set-option 'point-and-click #f).
• Un bloc \header. Això estableix l’encapçalament global (és a dir, al principi del fitxer). És el bloc que conté els ajustos predeterminats dels camps d’encapçalament com el compositor, el títol, etc per a tots els llibres que estan dins del fitxer (vegeu Explicació dels títols).
• Un bloc \score. Aquesta partitura es reuneix amb altres partitures del nivell superior, i es combina amb elles formant un \book (llibre) únic. Aquest comportament es pot canviar establint el valor de la variable toplevel-score-handler al nivell superior (el handler predeterminat es defineix al fitxer ‘../scm/lily-library.scm’ i el seu valor s’estableix al fitxer ‘../ly/declarations-init.ly’.)
• Un bloc \book combina lògicament diversos moviments (és a dir, diversos blocs \score) en un sol document. Si hi ha diverses partitures \score, es crea un sols fitxer de sortida per a cada bloc \book, en el qual es concatenen tots els moviments corresponents. L’única raó per especificar explícitament blocs \book en un fitxer d’entrada ‘.ly’ és si volem crear diversos fitxers de sortida a partir d’un únic fitxer d’entrada. Una excepció es dóna dins dels documents de lilypond-book, en els quals hem d’escriure explícitament un bloc \book si volem tenir més d’una única partitura \score o marcatge \markup al mateix exemple. Es pot canviar aquest comportament establint el valor de la variable toplevel-book-handler al nivell superior. El handler predeterminat es defineix al fitxer d’inici ‘../scm/lily.scm’.
• Un bloc \bookpart. Un llibre pot dividir-se en diverses parts, utilitzant blocs \bookpart, amb l’objectiu de facilitar la inserció de salts de pàtina o suar diferents ajustos de \paper en les diferents parts.
• Una expressió musical composta, com

  { c'4 d' e'2 }

  Això afegeix la peça al \score i la conforma dins d’un llibre únic junt a totes les altres partitures \score i expressions musicals del nivell superior. En altres paraules, un fitxer que conté sols l’expressió musical anterior es tradueix a

  \book { \score { \new Staff { \new Voice { { c'4 d' e'2 } } } \layout { } } \paper { } \header { } }

  Es pot canviar aquest comportament establint el valor de la variable toplevel-music-handler al nivell més alt. E. handler predeterminat es defineix al fitxer d’inici ‘../scm/lily.scm’.

• Un text de marcatge, per exemple una estrofa

  \markup { 2. Estrofa dos, línia u }

  Els textos de marcatge es col·loquen a sobre, en mig o a sota de les partitures o expressions musicals, segons on apareguin escrits.

• Una variable, com

  pepet = { c4 d e d }

  Això es pot utilitzar més tard al fitxer escrivint \pepet. El nom de les variables ha de ser exclusivament alfabètic; sense números, guions ni barres baixes.

L’exemple següent mostra tres coses que se poden introduir al nivell superior:

\layout {
  % No justificar la sortida
  ragged-right = ##t
}

\header {
   title = "Do-re-mi"
}

{ c'4 d' e2 }

En qualsevol punt del fitxer es poden introduir qualssevol de les instruccions lèxiques següents:

• \version
• \include
• \sourcefilename
• \sourcefileline
• Un comentari d’una línia, determinat per un símbol % al principi.
• Un comentari de diverses línies, delimita per %{ … %}.

En general s’ignoren els espais entre elements del flux d’entrada, i es poden ometre o augmentar tranquil·lament per millorar la llegibilitat. Tanmateix, els espais s’han d’utilitzar sempre per evitar errors, en les situacions següents:

• Al voltant de totes i cadascuna de les claus i parèntesis d’obertura i tancament.
• A continuació de les ordres i variables, és a dir, tots els elements que comencen amb signe \ de barra invertida.
• A continuació de tot element que s’hagi d’interpretar com a expressió de l’Scheme, és a dir, tot element que comenci per un signe #.
• Per separar els elements d’una expressió de l’Scheme.
• Dins de lyricmode abans i després de les ordres \set i \override.

Vegeu també

Manual d’aprenentatge: (learning)Com funcionen els fitxers d’entrada del LilyPond section ‘Com funcionen els fitxers d'entrada del LilyPond’ in Manual d’aprenentatge

Referència de la notació: Explicació dels títols, El bloc \layout.

This document was generated by gub on Juliol 13, 2020 using texi2html 1.82.

Altres idiomes: English, deutsch, español, français, italiano, 日本語.
Quant a la selecció automàtica de la llengua.