LilyPond 記譜法リファレンス: 3.1.3 ファイル構造

[ << 入出力全般 ]	[トップ][目次][インデックス][ ? ]			[ スペースの問題 >> ]
[ < ブックの中にある複数の score ]		[ 上へ : 入力の構造 ]	[ タイトルとヘッダ > ]

3.1.3 ファイル構造

.ly ファイルは最上位の表記を任意の数だけ保持することができます – ここで、最上位の表記とは以下の中の 1 つです:

\paper, \midi, \layout などの出力定義。最上位にある出力定義はブック全体のデフォルト設定を変更します。最上位に同じタイプの出力定義が複数ある場合、後ろの方にある出力定義が優先されます。
#(set-default-paper-size "a7" 'landscape) や #(ly:set-option 'point-and-click #f) などの Scheme 表記。
\header ブロック。これはグローバルヘッダブロックになります。このブロックは、作曲者、曲名などのブック全体の設定定義を保持します。
\score ブロック。この score は他の最上位の score とともに単一の \book にまとめられます。この振る舞いは、変数 toplevel-score-handler を最上位の階層で設定することによって、変更することができます。デフォルトのハンドラは初期化ファイル ‘../scm/lily.scm’ で定義されています。
\book ブロックは複数の楽章 (すなわち、複数の \score ブロック) を論理的に 1 つのドキュメントにまとめます。複数の \score が存在する場合、それぞれの \book ブロックに対して 1 つずつ出力ファイルが作成され、それぞれの出力ファイルの中では該当するすべての楽章が連結されます。.ly ファイルの中で明示的に \book ブロックを指定する必要があるケースはただ 1 つ、単一の入力ファイルから複数の出力ファイルを作成することを望む場合です。例外の 1 つに lilypond-book ドキュメントがあります – そこでは、同じ例の中に複数の \socre あるいは \markup を配置したければ、明示的に \book ブロックを追加する必要があります。この振る舞いは、変数 toplevel-score-handler を最上位の階層で設定することによって、変更することができます。デフォルトのハンドラは初期化ファイル ‘../scm/lily.scm’ で定義されています。
\bookpart ブロック。改ページを簡単にするため、あるいは異なるパートで別々の \paper 設定を使用するために、book は – \bookpart を用いて – いくつかのパートに分割される可能性があります。
以下のような複合音楽表記:
```
{ c'4 d' e'2 }
```
これは楽節を \score に付け加え、その楽節を他のすべての最上位 \score や音楽表記とともに単一のブックにフォーマットにします。言い換えると、上記の音楽表記だけを保持しているファイルは以下のように翻訳されます:
```
\book {
  \score {
    \new Staff {
      \new Voice {
        { c'4 d' e'2 }
      }
    }
  }
	\layout { }
	\header { }
}
```
この振る舞いは、変数 toplevel-score-handler を最上位の階層で設定することによって、変更することができます。デフォルトのハンドラは初期化ファイル ‘../scm/lily.scm’ で定義されています。
マークアップテキスト。例として以下の歌詞を挙げます:
```
\markup {
   2.  The first line verse two.
}
```
マークアップテキストは、それが出現した場所で、score あるいは音楽表記の上、間、あるいは下に描かれます。
以下のような変数:
```
foo = { c4 d e d }
```
これは後で使用することができます。使用するには、入力ファイルの中で \foo と入力します。変数の名前はアルファベットだけで構成すべきです。数字、アンダスコアあるいはダッシュを使うことができません。

以下の例は最上位の階層で入力される可能性がある 3 つのものを示しています:

\layout {
  % Don't justify the output
  ragged-right = ##t
}

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

{ c'4 d' e2 }

ファイルの任意の場所で、以下の編集指示のいずれかが入力される可能性があります:

\version
\include
\sourcefilename
\sourcefileline
% 記号で始まる単一行コメント。
%{ .. %} で囲まれる複数行コメント。

参照

学習マニュアル: LilyPond 入力ファイルの仕組み

[ << 入出力全般 ]	[トップ][目次][インデックス][ ? ]			[ スペースの問題 >> ]
[ < ブックの中にある複数の score ]		[ 上へ : 入力の構造 ]	[ タイトルとヘッダ > ]

他の言語: English, deutsch, español, français

3.1.3 ファイル構造

参照

LilyPond — 記譜法リファレンス