@c -*- coding: utf-8; mode: texinfo; documentlanguage: ja -*-
@ignore
- Translation of GIT committish: b3e632849e6cc825c77eca4287c619d23e7f5057
+ Translation of GIT committish: d5647c5fd1c38d4124d2374725b923f4901f3661
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
Guide, node Updating translation committishes..
@end ignore
-@c \version "2.15.17"
+@c \version "2.19.2"
@c Translators: Yoshiki Sawada
@end example
この一般規則の例外の 1 つにコメントがあります。@c
-(他の例外は、@ref{ファイル構造} を参照してください。)@c
+(他の例外は、@ref{File structure} を参照してください。)@c
単一行コメントと複数行コメント (@code{%@{ .. %@}} で囲まれます) は@c
どちらも入力ファイルの任意の場所に配置することができます。@c
コメントは @code{\score} ブロックの内側あるいは外側に@c
作り出します。
(@code{\book} ブロックについての詳細は、@c
-@ref{book の中にある複数の score}、@c
-@ref{1 つの入力ファイルから複数の出力ファイルを生成する}、@c
-@ref{ファイル構造} を参照してください。)
+@ref{Multiple scores in a book}、@c
+@ref{Multiple output files from one input file}、@c
+@ref{File structure} を参照してください。)
@seealso
学習マニュアル:
-@rlearning{入力ファイルに取り組む},
-@rlearning{音楽表記についての説明},
-@rlearning{Score は (単一の) 複合的な音楽表記}
+@rlearning{Working on input files},
+@rlearning{Music expressions explained},
+@rlearning{Score is a (single) compound musical expression}
@node book の中にある複数の score
各 @code{\book} ブロックが個々に出力ファイルになります。@c
入力ファイルで @code{\book} ブロックを記述しなければ、@c
LilyPond は暗黙的にファイル全体を単一の @code{\book} として扱います。@c
-@ref{ファイル構造} を参照してください。
+@ref{File structure} を参照してください。
単一のソース ファイルから複数のファイルを作り出す時、@c
LilyPond は、@code{\book} ブロックが作り出す出力ファイルが@c
@item
@code{\paper}, @code{\midi}, @code{\layout} などの出力定義。@c
最上位にある出力定義はブック全体のデフォルト設定を変更します。@c
-最上位に同じタイプの出力定義が複数ある場合、@c
-後ろの方にある出力定義が優先されます。
+最上位に同じタイプの出力定義が複数ある場合は組み合わされますが、@c
+衝突した場合は後ろの方にある出力定義が優先されます。@c
+出力定義が @code{\layout} ブロックにどのような影響を与えるかの詳細は
+@ref{The \layout block} を参照してください。
+
@item
@code{#(set-default-paper-size "a7" 'landscape)} や
@{ c'4 d' e'2 @}
@}
@}
+ \layout @{ @}
@}
- \layout @{ @}
- \header @{ @}
+ \paper @{ @}
+ \header @{ @}
@}
@end example
@item Scheme 表記要素を区切る空白。
@item @code{lyricmode} モードの @code{\override} と @code{\set} コマンドの@c
中にある単語を区切る空白。@c
-特に、@code{\override Score . LyricText #'font-size = #5} のように、@c
+特に、@code{\override Score.LyricText.font-size = #5} のように、@c
コマンドの中のドットとイコール記号の前後、コマンド全体の前後に@c
空白を挿入することを忘れないで下さい。
@seealso
学習マニュアル:
-@rlearning{LilyPond 入力ファイルの仕組み}
+@rlearning{How LilyPond input files work}
+
+記譜法リファレンス:
+@ref{The \layout block}
@node タイトルとヘッダ
@menu
* タイトル、ヘッダ、フッタを作成する::
* カスタム ヘッダ、フッタ、タイトル::
+* 脚注を作成する::
* ページ番号の参照::
* 目次::
@end menu
@node タイトル、ヘッダ、フッタを作成する
@subsection タイトル、ヘッダ、フッタを作成する
-@translationof Creating titles, headers, and footers
+@translationof Creating titles headers and footers
@menu
* タイトル ブロックの説明::
@seealso
記譜法リファレンス:
-@ref{ファイル構造},
-@ref{タイトル ブロックのカスタム レイアウト}
+@ref{File structure},
+@ref{Custom layout for title blocks}
@node book と score のタイトル ブロックのデフォルト レイアウト
@code{\score} 内部の個々の @code{\header} ブロックのための
@code{scoreTitleMarkup} です。
-@c KEEP LY
-@lilypond[papersize=a6,quote,verbatim,noragged-right]
-\header {
- % 以下のフィールドは中央揃えされます。
- dedication = "Dedication"
- title = "Title"
- subtitle = "Subtitle"
- subsubtitle = "Subsubtitle"
- instrument = "Instrument"
-
- % 以下のフィールドは左端に左揃えされます。
- poet = "Poet"
- meter = "Meter"
-
- % 以下のフィールドは右端に右揃えされます。
- composer = "Composer"
- arranger = "Arranger"
-}
+以下の例は @code{\header} のすべての変数の使用例です:
-\score {
- { s1 }
+@c KEEP LY
+@lilypond[papersize=a7,quote,verbatim,noragged-right]
+\book {
\header {
- % 以下のフィールドは同一行の両端に配置されます。
- piece = "Piece"
- opus = "Opus"
+ % 以下のフィールドは中央揃えされます。
+ dedication = "Dedication"
+ title = "Title"
+ subtitle = "Subtitle"
+ subsubtitle = "Subsubtitle"
+ % 以下のフィールドは 1 行に配置されます
+ % フィールド "instrument" は 2 ページ以降にも表示されます
+ instrument = \markup \with-color #green "Instrument"
+ poet = "Poet"
+ composer = "Composer"
+ % 以下のフィールドは同一行の両端に配置されます
+ meter = "Meter"
+ arranger = "Arranger"
+ % 以下のフィールドは最下段の中央に配置されます
+ tagline = "tagline goes at the bottom of the last page"
+ copyright = "copyright goes at the bottom of the first page"
+ }
+ \score {
+ { s1 }
+ \header {
+ % 以下のフィールドは同一行の両端に配置されます
+ piece = "Piece 1"
+ opus = "Opus 1"
+ }
+ }
+ \score {
+ { s1 }
+ \header {
+ % 以下のフィールドは同一行の両端に配置されます
+ piece = "Piece 2 on the same page"
+ opus = "Opus 2"
+ }
+ }
+ \pageBreak
+ \score {
+ { s1 }
+ \header {
+ % 以下のフィールドは同一行の両端に配置されます
+ piece = "Piece 3 on a new page"
+ opus = "Opus 3"
+ }
}
}
@end lilypond
-@c Is the bit about \null markups true? -mp
+以下に注意してください:
+
+@itemize
+@item
+楽器名は各ページに繰り返し表示されます。
+
+@item
+紙面変数 @code{print-all-headers} に @code{##f} がセットされている場合
+(デフォルトの設定です)、@code{\score} には @code{piece} と @code{opus}
+だけが表示されます。
+@item
+@c Is the bit about \null markups true? -mp
@code{\header} ブロックでセットされなかったテキスト フィールドには@c
@code{\null} マークアップがセットされ、スペースを無駄にしません。
+@item
デフォルト設定では、@code{scoreTitleMarkup} は
@code{piece} テキスト フィールドと @code{opus} テキスト フィールドを@c
同一行の両端に配置します。
+@end itemize
+
+デフォルトのレイアウトを変更するには @ref{Custom layout for title blocks}
+を参照してください。
+
@cindex breakbefore
最上位の @code{\header} ブロックのタイトルを最初のページに配置して、@c
@seealso
学習マニュアル:
-@rlearning{LilyPond 入力ファイルの仕組み}
+@rlearning{How LilyPond input files work}
記譜法リファレンス:
-@ref{ファイル構造}
+@ref{Custom layout for title blocks},
+@ref{File structure}
インストールされているファイル:
@file{ly/titling-init.ly}
@seealso
記譜法リファレンス:
-@ref{テキストをフォーマットする}
+@ref{Formatting text}
@node タイトル ブロックのカスタム レイアウト
@unnumberedsubsubsec タイトル ブロックのカスタム レイアウト
@translationof Custom layout for title blocks
+@cindex bookTitleMarkup
+@cindex scoreTitleMarkup
+@funindex bookTitleMarkup
+@funindex scoreTitleMarkup
+
@code{\header} ブロックの中に @code{\markup} コマンドを配置することにより、@c
シンプルなテキストをフォーマットすることができます。@c
しかしながら、タイトルの配置を精密に制御することはできません。@c
-ã\83\86ã\82ã\82¹ã\83\88 ã\83\95ã\82£ã\83¼ã\83«ã\83\89ã\81®é\85\8dç½®ã\82\92ã\82«ã\82¹ã\82¿ã\83\9eã\82¤ã\82ºã\81\99ã\82\8bã\81\9fã\82\81ã\81«ã\80\81@c
-以下の @code{\paper} 変数のどちらか、あるいは両方を使用します:
+ã\83\86ã\82ã\82¹ã\83\88 ã\83\95ã\82£ã\83¼ã\83«ã\83\89ã\81®é\85\8dç½®ã\82\92ã\82«ã\82¹ã\82¿ã\83\9eã\82¤ã\82ºã\81\99ã\82\8bã\81«ã\81¯ã\80\81以ä¸\8bã\81® @code{\paper}
+変数のどちらか、あるいは両方を変更します:
@itemize
@item @code{bookTitleMarkup}
@item @code{scoreTitleMarkup}
@end itemize
-これらのマークアップ変数は
-@ref{book と score のタイトル ブロックのデフォルト レイアウト}
-で説明しています。
+これらの @code{\markup} のデフォルト値を用いた場合のタイトルの配置は
+@ref{Default layout of book and score title blocks} の中にある例で@c
+示しています。
@file{ly/titling-init.ly} で定義されている @code{scoreTitleMarkup}
のデフォルト設定は以下のとおりです:
この方法の欠点は、個々の @code{\score} ブロックで、@c
最上位の @code{\header} ブロックだけに表示させるテキスト フィールドを@c
手動で抑制する必要があることです。@c
-@ref{タイトル ブロックの説明} を参照してください。
+@ref{Title blocks explained} を参照してください。
この欠点を回避するには、個々の @code{\score} ブロックに表示させたい@c
テキスト フィールドを @code{scoreTitleMarkup} 定義に追加します。@c
@seealso
記譜法リファレンス:
-@ref{タイトル ブロックの説明}
+@ref{Title blocks explained}
@node ヘッダとフッタのカスタム レイアウト
@item @code{evenFooterMarkup}
@end itemize
+@cindex markup, conditional (条件付マークアップ)
+@cindex on-the-fly (オンザフライ)
+@funindex \on-the-fly
+
+@code{\markup} コマンド @code{\on-the-fly} を用いて、@code{\paper}
+ブロック内部で定義されたヘッダ テキストとフッタ テキストに条件付でマーク@c
+アップを追加することができます。@c
+以下の構文を用います:
+
+@example
+@code{variable} = @code{\markup} @{
+ ...
+ @code{\on-the-fly} #@var{procedure} @var{markup}
+ ...
+@}
+@end example
+
+@var{procedure} は、それを保持している @code{\markdup} コマンドが評価@c
+される度に呼び出されます。@c
+@var{procedure} はある特定の条件をテストして、条件が真である場合にのみ@c
+@var{markup} 引数を解釈します (つまり、表示します)。
+
+様々な条件をテストするためのプロシージャがあらかじめ用意されています:
+
+@quotation
+@multitable {print-page-number-check-first-----} {should this page be printed-----}
+
+@headitem Procedure name @tab Condition tested
+
+@item print-page-number-check-first @tab このページ番号は表示されるか?
+@item create-page-number-stencil @tab 'print-page-numbers は真か?
+@item print-all-headers @tab 'print-all-headers は真か?
+@item first-page @tab ブックの最初のページか?
+@item (on-page nmbr) @tab ページ番号 = nmbr か?
+@item last-page @tab ブックの最後のページか?
+@item not-first-page @tab ブックの最初ではないページか?
+@item part-first-page @tab ブック パートの最初のページか?
+@item part-last-page @tab ブック パートの最後のページか?
+@item not-single-page @tab ブック パートのページ数 > 1 か?
+
+@end multitable
+@end quotation
+
以下の例では、ページ番号を各ページの最下段中央に配置しています。@c
まず、@code{oddHeaderMarkup} と @code{evenHeaderMarkup} に
@emph{null} を定義することにより、デフォルト設定を削除します。@c
}
@end lilypond
+複数の @code{\on-the-fly} 条件を @q{and} 演算子で組み合わせることが@c
+できます。例えば、
+
+@example
+ @code{\on-the-fly #first-page}
+ @code{\on-the-fly #last-page}
+ @code{@{ \markup ... \fromproperty #'header: ... @}}
+@end example
+
+これは、出力が単一のページかどうかを判断します。
+
+@seealso
+記譜法リファレンス:
+@ref{Title blocks explained},
+@ref{Default layout of book and score title blocks}
+
+インストールされているファイル:
+@file{../ly/titling-init.ly}
+
+
+@node 脚注を作成する
+@subsection 脚注を作成する
+@translationof Creating footnotes
+
+作成できる脚注には 2 つのタイプがあります。@c
+自動脚注と手動脚注です。
+
+@menu
+* 脚注の概要::
+* 自動脚注::
+* 手動脚注::
+@end menu
+
+@node 脚注の概要
+@unnumberedsubsubsec 脚注の概要
+@translationof Footnotes overview
+
+自動脚注は繰り上がっていくページ番号を作り出し、@c
+手動脚注はページ番号をカスタマイズすることができます。@c
+通常、脚注は @code{\tweak} のように適用されるので、多くの音楽要素や@c
+ポスト-イベントによって作成されるグラフィカル オブジェクト上に直接配置@c
+することができます。@c
+これがうまくいかない場合 (小節線や拍の変更のように、プロパティの変更の結果@c
+として作り出されるグラフィカル オブジェクトの場合)、脚注を独立した音楽@c
+イベントとして入力することである特定のタイミングにある指定したタイプの@c
+すべてのグラフィカルに影響を与えることもできます。
+
+脚注コマンドの完全な形式は以下のようなものです:
+
+@example
+\footnote @var{mark} @var{offset} @var{grob-name} @var{footnote}
+@var{music}
+@end example
+
+要素は以下の通りです:
+
+@table @var
+@item mark
+これは脚注を指定するマークアップや文字列で、参照ポイントとページ下の@c
+脚注自体を指すマークになります。@c
+これは省略することができ (@code{\default} で置き換えられます)、省略した@c
+場合は連続した数字が生成されます。
+@item offset
+脚注マークを配置する参照ポイントからの X と Y オフセットを指定する
+@samp{#(2 . 1)} のような数字のペアです。
+@item grob-name
+脚注マークを付けるグラフィカル オブジェクトのタイプを指定します (例えば
+@samp{#'Flag} です)。@c
+これが指定された場合、対応するグラフィカル オブジェクトが参照される
+@var{music} 自体にあるものでなくても、そこから作成されたものであれば@c
+参照ポイントになります。@c
+これは省略するができ (@code{\default} で置き換えられます)、その場合は@c
+直接作成されたグラフィカル オブジェクトだけに脚注が付けられます。
+@item footnote
+このマークアップあるいは文字列はページ下の脚注テキストになります。
+@item music
+これは脚注を付ける要素 -- 音楽イベント、和音構成要素、あるいは@c
+ポスト-イベントです。@c
+これを省略することはできませんが、@code{\default} で置き換えることで@c
+脚注をある特定の音楽表記ではなく音楽タイミングに付けることができます。@c
+@code{\default} を用いた場合、影響を与えるグラフィカル オブジェクトの@c
+タイプを指定する @var{grob-name} 引数を指定する必要があります。
+@end table
+
+@code{\tweak} と同様に、@code{\footnote} をポスト-イベントや@c
+アーティキュレーションに適用する場合、それ自体の前に @code{-} を配置@c
+して、構文解析の結果を前にある音符や休符にくっつけさせる必要があります。
+
+
+@node 自動脚注
+@unnumberedsubsubsec 自動脚注
+@translationof Automatic footnotes
+
+自動脚注は 4 つの引数を取ります: 脚注マークの位置 @samp{(x . y)}、@c
+脚注を付ける @var{レイアウト オブジェクト} を指定するオプションの
+@var{grob-name}、ページ下の脚注に表示される @var{footnote} マークアップ、@c
+それに脚注を付ける @var{music} です。
+
+
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \relative c' {
+ \footnote #'(0.5 . -2)
+ \markup { The first note }
+ a'4 b8
+ \single\footnote #'(0.5 . 1)
+ \markup { The third note } Flag
+ e\noBeam c4 d4
+ }
+}
+@end lilypond
+
+和音の音符でも難しいことはありません:
+
+@c KEEP LY
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \relative c' {
+ <
+ \footnote #'(1 . -1.25) "これは C です" c
+ \footnote #'(2 . -0.25) \markup { \italic "E-flat です" } es
+ \footnote #'(2 . 3) \markup { \bold "これは G です" } g
+ >1
+ }
+}
+@end lilypond
+
+@warning {
+脚注の垂直方向の位置が同じになる場合、下方向に並べられます。@c
+高い位置にある脚注は、リストでも上に来ます。
+}
+
+ここで、グラフィカル オブジェクト動脚注を付ける例をいくつか挙げ、@c
+さらに脚注とタグラインやコピーライトとの位置関係を示します。
+
+@c KEEP LY
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { copyright = \markup { "Copyright 1970" } }
+ \relative c' {
+ a'4-\footnote #'(-3 . 0) \markup { \bold Forte } \f
+ -\footnote #'(0 . 1.5) \markup { スラー } (
+ b8)-\footnote #'(0 . -2) \markup { 連桁 } [ e]
+ \single\footnote #'(1 . -1)
+ \markup { \teeny { これは符幹です } } Stem
+ c4
+ \single\footnote #'(0 . 0.5)
+ \markup \italic { 忠告の臨時記号 } AccidentalCautionary
+ \footnote #'(1 . 1) "音符自体"
+ dis?4-\footnote #'(0.5 . -0.5) \markup \italic { スロー ダウン }
+ _"rit."
+ }
+}
+@end lilypond
+
+最上位の @code{\markup} に脚注を付ける場合、@c
+@code{\auto-footnote} コマンドを使う必要があります:
+
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \markup { \auto-footnote "A simple tune" \italic "By me" }
+ \relative c' {
+ a'4 b8 e c4 d
+ }
+}
+@end lilypond
+
+
+@node 手動脚注
+@unnumberedsubsubsec 手動脚注
+@translationof Manual footnotes
+
+@cindex footnotes, manual (手動の脚注
+
+手動で付ける脚注は追加で最初の引数として参照マークとなる @var{mark} を@c
+取ります。@c
+自動的に生成される脚注マークとは対照的に、ページ下の @var{footnote}
+マークアップの前には表示されません: 見た目のつながりはユーザ自身で作成@c
+する必要があります。@c
+LilyPond は対応するマークアップを同じページの下に表示するだけです。
+
+上記のことを除けば、手動脚注は自動的に付番される脚注と同じです。
+
+@c KEEP LY
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \relative c' {
+ \footnote
+ "1" #'(0.5 . -2)
+ \markup { \italic "1. 最初の音符" }
+ a'4
+ b8
+ \footnote
+ \markup { \bold "2" } #'(0.5 . 1)
+ "2. 2 番目の音符"
+ e
+ c4
+ d-\footnote "3" #'(0.5 . -1) "3. ピアノ" \p
+ }
+}
+@end lilypond
+
+和音に手動脚注を付ける場合、以下のようにします:
+
+@c KEEP LY
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \relative c' {
+ <
+ \footnote "1" #'(1 . -1.25) "1. C" c
+ \footnote
+ \markup { \bold "b" } #'(2 . -0.25) "b. E-フラット" es
+ \footnote "3" #'(2 . 3) \markup { \italic "iii. G" } g
+ >1
+ }
+}
+@end lilypond
+
+@warning {
+脚注の垂直方向の位置が同じになる場合、下方向に並べられます。@c
+高い位置にある脚注は、リストでも上に来ます。
+}
+
+ここで、グラフィカル オブジェクトに手動脚注を付ける例をいくつか挙げ、@c
+脚注とタグラインやコピーライトとの位置関係を示します。
+
+@c KEEP LY
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \relative c' {
+ a'4-\footnote
+ \markup { \teeny 1 } #'(-3 . 0)
+ \markup { 1. \bold フォルテ } \f
+ -\footnote
+ \markup { \teeny b } #'(0 . 1.5)
+ \markup { b. スラー } (
+ b8)-\footnote
+ \markup { \teeny 3 } #'(0 . -2)
+ \markup { 3. 連桁 } [
+ e]
+ \single\footnote
+ \markup { 4 } #'(1 . -1)
+ \markup { \bold 4. { これは符幹です } } Stem
+ c4
+ \single\footnote
+ \markup \concat \teeny { "sharp (v)" }
+ #'(0 . 0.5)
+ \markup \italic { v. 忠告の臨時記号 } AccidentalCautionary
+ dis?4-\footnote
+ \markup \concat \teeny { "a" } #'(0.5 . -0.5)
+ \markup \italic { a. スローダウン } _"rit."
+ \footnote
+ \markup { \teeny \musicglyph #"rests.4" }
+ #'(1.5 . -0.25)
+ \markup { \null } \breathe
+ }
+}
+@end lilypond
+
+最上位の @code{\markup} に脚注を付ける場合、下記のようにします:
+
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \markup { "A simple tune" \footnote "*" \italic "* By me" }
+ \relative c' {
+ a'4 b8 e c4 d4
+ }
+}
+@end lilypond
+
@seealso
+学習マニュアル:
+@rlearning{Objects and interfaces}
+
記譜法リファレンス:
-@ref{タイトル ブロックの説明},
-@ref{book と score のタイトル ブロックのデフォルト レイアウト}
+@ref{Balloon help},
+@ref{Page layout},
+@ref{Text marks},
+@ref{Text scripts},
+@ref{Titles and headers}
+
+内部リファレンス:
+@rinternals{FootnoteEvent},
+@rinternals{FootnoteItem},
+@rinternals{FootnoteSpanner},
+@rinternals{Footnote_engraver}
+
+@knownissues
+同じページにある複数の脚注は上下にしか配置できません。@c
+ある脚注が他の脚注の上に配置され、同じ行に配置することはできません。@c
+@code{MultiMeasureRests} に脚注を付けることはできず、@c
+@code{Staff}、@code{\markup} オブジェクト、それに他の @code{footnote} と@c
+衝突する可能性があります。@c
+手動の @code{footnote} コマンドを使う場合、@c
+containing @code{footnote-auto-number = ##f} を保持している
+@code{\paper} ブロックが必要です。
@ignore
ラベルを付けられた場所のページ番号を取得するには、@c
@code{\page-ref} マークアップ コマンドを使います。
-@lilypond[verbatim]
+@lilypond[verbatim,papersize=a8landscape]
\header { tagline = ##f }
\book {
\label #'firstScore
(add-toc-item! 'tocActMarkup text))
@end verbatim
-@lilypond[line-width=11.0\cm]
+@lilypond[line-width=10.0\cm]
\header { tagline = ##f }
\paper {
tocActMarkup = \markup \large \column {
要素とページ番号の間をドットで埋めることができます:
-@lilypond[verbatim,quote]
+@lilypond[verbatim,line-width=10.0\cm]
\header { tagline = ##f }
\paper {
tocItemMarkup = \tocItemWithDotsMarkup
}
@end lilypond
-
@seealso
-初期化ファイル: @file{../ly/toc-init.ly}
-
+インストールされているファイル:
+@file{ly/toc-init.ly}
@predefined
@funindex \table-of-contents
@menu
* LilyPond ファイルをインクルードする::
* 1 つのソースから異なる版を生成する::
-* テキスト エンコーディング::
-@c * LilyPond 記譜法を表示する::
+* 特殊文字::
@end menu
それらの変数は総譜ファイルの中で使用されます。@c
インクルードされるファイルの中でタグ付きセクションにマークを付けて、@c
それを楽譜の他の場所で使うことができます
--- @ref{1 つのソースから異なる版を生成する} を参照してください。
+-- @ref{Different editions from one source} を参照してください。
カレントのワーキング ディレクトリの中にあるファイルは
@code{\include} コマンドに後にファイル名を指定するだけで@c
すべてメイン ファイルを保持しているディレクトリからの相対参照で@c
指定しなければなりません
-- インクルード ファイルを保持しているディレクトリからではありません。@c
-しかしながら、この振る舞いは、オプション @code{-drelative-includes} を@c
+しかしながら、この振る舞いは、オプション @option{-drelative-includes} を@c
コマンド ラインで渡すことによって
(あるいは、メイン入力ファイルの先頭に
@code{#(ly:set-option 'relative-includes #t)} を付け加えることによって)
いくつもの楽譜でインクルードされるファイルは
LilyPond ディレクトリ @file{../ly} の中に置くことになるかもしれません
(このディレクトリが存在する場所はインストールの仕方に依存します
--- @rlearning{その他の情報源} を参照してください)。@c
+-- @rlearning{Other sources of information} を参照してください)。@c
このディレクトリの中にあるファイルは、@code{\include} 文で@c
ファイル名を指定するだけでインクルードすることができます。@c
この方法で @file{english.ly} のような言語依存のファイルを@c
@code{--verbose} オプションは、他の多くの情報とともに、@c
LilyPond が使用するパスとファイルのリストを表示します。@c
また、デフォルトでインクルードされるファイルのうち、@c
-より重要なファイルについて @rlearning{その他の情報源} で議論されています。@c
+より重要なファイルについて @rlearning{Other sources of information}
+で議論されています。@c
これらのファイルを編集することができますが、@c
これらのファイルに加えられた変更は@c
新しいバージョンの LilyPond をインストールすると失われます。
@code{\include} を使用している簡単な例がいくつか
-@rlearning{楽譜とパート} で示されています。
+@rlearning{Scores and parts} で示されています。
@seealso
学習マニュアル:
-@rlearning{その他の情報源},
-@rlearning{楽譜とパート}
+@rlearning{Other sources of information},
+@rlearning{Scores and parts}
@knownissues
いくつかの方法が用意されています。@c
長い音楽や注記のセクションをさまざまなやり方で組み合わせる場合には、@c
おそらく変数が最も役に立つでしょう。@c
-一方、差し替え用の短い音楽セクションの中から 1 つを選択する場合には、@c
-タグが役に立ちます。@c
+差し替え用の短い音楽セクションの中から 1 つを選択する場合にはタグが役に立ち、@c
+楽曲の一部をいろいろな箇所で組み合わせることもできます。
+
どのような方法をとるにしても、楽譜構造から音楽表記を分離しておくと、@c
音楽表記に手を触れずに楽譜構造を変更することが簡単に行えます。
音楽のセクションが変数の中で定義されている場合、@c
そのセクションを楽譜の異なる部分で再利用することができます
--- @rlearning{変数を用いて楽曲を編成する} を参照してください。@c
+-- @rlearning{Organizing pieces with variables} を参照してください。@c
例えば、@notation{アカペラ} のボーカル譜はリハーサル目的で@c
すべてのパートをまとめたピアノ譜を持つことがよくあります。@c
これは声楽全般で言えることです。@c
その場合、音楽を入力する必要があるのは 1 回だけです。@c
2 つの変数からの音楽を 1 つの譜に組み込むことができます
--- @ref{自動パート結合} を参照してください。@c
+-- @ref{Automatic part combining} を参照してください。@c
ここに例を挙げます:
@lilypond[verbatim,quote]
長い楽譜では、変数定義をそれぞれ別々のファイルの中に置いて、@c
それらのファイルをインクルードすることになるかもしれません
--- @ref{LilyPond ファイルをインクルードする} を参照してください。
+-- @ref{Including LilyPond files} を参照してください。
@node タグを使用する
@unnumberedsubsubsec タグを使用する
@funindex \tag
@funindex \keepWithTag
@funindex \removeWithTag
+@funindex \pushToTag
+@funindex \appendToTag
@cindex tag (タグ)
@cindex keep tagged music (タグの付いた音楽を保持する)
@cindex remove tagged music (タグの付いた音楽を排除する)
+@cindex splice into tagged music (タグの付いた音楽を組み合わせる)
@code{\tag #'@var{partA}} コマンドは音楽表記に
@var{partA} という名前を付けます。@c
なぜなら、最初のフィルタはあるタグ名以外を持つセクションを排除し、@c
2 番目のフィルタがそのタグ名を持つセクションを排除するからです。
+既存の音楽表記のある特定の場所にいくつか音を組み込みたいことがあります。@c
+@code{\pushToTag} と @code{\appendToTag} を使って、@c
+既存の音楽構造の @code{要素} の前または後に素材を追加することができます。@c
+すべての音楽構造が @code{要素} を持つわけではありませんが、@c
+連続するか同時進行する音楽構造はまず間違いなく @code{要素} を持ちます:
+
+@lilypond[verbatim,quote]
+test = { \tag #'here { \tag #'here <<c''>> } }
+
+{
+ \pushToTag #'here c'
+ \pushToTag #'here e'
+ \pushToTag #'here g' \test
+ \appendToTag #'here c'
+ \appendToTag #'here e'
+ \appendToTag #'here g' \test
+}
+@end lilypond
+
+どちらのコマンドもタグ、組み込む素材、それにタグ付けされた音楽表記を
+取り、タグが出現するたびに素材を組み込みます。@c
+これらのコマンドは変更するものを全てコピーするので、@c
+オリジナルの @code{\test} が元の意味を保持し続けることを保証します。
@seealso
学習マニュアル:
-@rlearning{変数を用いて楽曲を編成する}
+@rlearning{Organizing pieces with variables}
記譜法リファレンス:
-@ref{自動パート結合},
-@ref{LilyPond ファイルをインクルードする}
+@ref{Automatic part combining},
+@ref{Including LilyPond files}
@ignore
@c This warning is more general than this placement implies.
@c Should be deleted? -td
@knownissues
-
Multiple rests are not merged if you create a score with more
than one tagged section at the same place.
同じ楽譜から異なる版を作り出すことができます。
このテクニックはスタイル シートでも使えます。@c
-@rlearning{スタイル シート} を参照してください。
+@rlearning{Style sheets} を参照してください。
@seealso
学習マニュアル:
-@rlearning{変数を用いて楽曲を編成する},
-@rlearning{スタイル シート}.
+@rlearning{Organizing pieces with variables},
+@rlearning{Style sheets}
記譜法リファレンス:
-@ref{LilyPond ファイルをインクルードする}
+@ref{Including LilyPond files}
+
+
+@node 特殊文字
+@subsection 特殊文字
+@translationof Special characters
+
+@cindex special characters (特殊文字)
+@cindex non-ASCII characters (非 ASCII 文字)
+
+@menu
+* テキスト エンコーディング::
+* Unicode::
+* ASCII エイリアス::
+@end menu
@node テキスト エンコーディング
-@subsection テキスト エンコーディング
+@unnumberedsubsubsec テキスト エンコーディング
@translationof Text encoding
-@cindex Unicode
@cindex UTF-8
-@cindex non-ASCII characters (非 ASCII 文字)
LilyPond は Unicode 協会と ISO/IEC 10646 によって定義された@c
文字レパートリを使用します。@c
à vo -- cê uma can -- ção legal
}
-\relative {
+\relative c' {
c2 d e f g f e
}
\addlyrics { \bulgarian }
\addlyrics { \portuguese }
@end lilypond
+
+@node Unicode
+@unnumberedsubsubsec Unicode
+@translationof Unicode
+
+@cindex Unicode (ユニコード)
+
単一の文字 -- その文字に対する Unicode コード ポイントを知っているが、@c
使用しているエディタではその文字を使用できない -- を入力するには、@c
@code{\markup} ブロック内部で @code{\char ##xhhhh} あるいは
}
\addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
}
-\markup { "Copyright 2008--2011" \char ##x00A9 }
+\markup { "Copyright 2008--2014" \char ##x00A9 }
@end lilypond
@cindex copyright sign (著作権記号)
@end example
+@node ASCII エイリアス
+@unnumberedsubsubsec ASCII エイリアス
+@translationof ASCII aliases
+
+特殊文字の ASCII エイリアスのリストを含めることができます:
+
+@c KEEP LY
+@lilypond[quote,verbatim]
+\paper {
+ #(include-special-characters)
+}
+
+\markup "&flqq; – &OE;uvre incomplète… &frqq;"
+
+\score {
+ \new Staff { \repeat unfold 9 a'4 }
+ \addlyrics {
+ This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
+ }
+}
+
+\markup \column {
+ "特殊文字への置換を無効にすることができます:"
+ "– &OE; …"
+ \override #'(replacement-alist . ()) "– &OE; …"
+}
+@end lilypond
+
+また、エイリアスを作ることもできます。@c
+グローバルに作るか:
+
+@lilypond[quote,verbatim]
+\paper {
+ #(add-text-replacements!
+ '(("100" . "hundred")
+ ("dpi" . "dots per inch")))
+}
+\markup "A 100 dpi."
+@end lilypond
+
+ローカルで作ります:
+
+@lilypond[quote,verbatim]
+\markup \replace #'(("100" . "hundred")
+ ("dpi" . "dots per inch")) "A 100 dpi."
+@end lilypond
+
+@seealso
+記譜法リファレンス:
+@ref{List of special characters}
+
+インストールされているファイル:
+@file{ly/text-replacements.ly}
+
+
@node 出力を制御する
@section 出力を制御する
@translationof Controlling output
更に多くの切り抜き範囲を定義することができます。
この機能を使用するには、@c
-LilyPond を @code{-dclip-systems} を付けて呼び出す必要があります。@c
+LilyPond を @option{-dclip-systems} を付けて呼び出す必要があります。@c
切り抜きは EPS ファイルとして出力され、@c
更にフォーマットが指定されている場合には PDF や PNG に変換されます。
コマンド ライン オプションを指定することにより、@c
Scalable Vector Graphics (SVG), Encapsulated PostScript (EPS) それに
Portable Network Graphics (PNG) 出力フォーマットが利用可能です。@c
-@rprogram{lilypond のコマンド ライン オプション} を参照してください。
+@rprogram{Basic command line options for LilyPond} を参照してください。
@node 記譜フォントを置換する
ZIP ファイルをダウンロードして、伸張します。@c
@code{lilyfonts} ディレクトリを @file{@var{SHARE_DIR}/lilypond/current} に@c
コピーします
--- 更なる情報は、@rlearning{その他の情報源} を参照してください。@c
-既存の @code{fonts} ディレクトリを @code{fonts_orig} に変更して、@c
-@code{lilyfonts} ディレクトリを @code{fonts} に変更します。@c
-Feta フォントに戻すには、@code{fonts_orig} を @code{fonts} に変更します。
+-- 更なる情報は、@rlearning{Other sources of information} を参照してください。@c
+既存の @code{fonts} ディレクトリを @code{fonts_orig} にリネームして、@c
+@code{lilyfonts} ディレクトリを @code{fonts} にリネームします。@c
+Feta フォントに戻すには、@code{fonts_orig} を @code{fonts} に戻します。
@seealso
-学習マニュアル: @rlearning{その他の情報源}
+学習マニュアル:
+@rlearning{Other sources of information}
@knownissues
-
Gonville では @q{古代の音楽} を記譜することはできません。@c
+Gonville フォント ファミリーでは、@c
+これからリリースされる LilyPond の新しい図柄は提供されないかもしれません。@c
ライセンス条件等を含む Gonville の更なる情報は、@c
製作者の Web サイトを参照してください。
MIDI 出力を聴いたときに際立ちます。
標準 MIDI 出力には粗雑さがあります。@c
-オプションで @ref{奏法スクリプト} を用いることにより、@c
+オプションで @ref{The Articulate script} を用いることにより、@c
強化されたリアルな MIDI 出力を得ることができます。
-@c TODO Check this
-MIDI 出力はそれぞれの譜とグローバル設定に対して 1 つずつチャンネルを@c
-割り当てます。@c
-そのため、MIDI ファイルに持たせる譜の数は 15 まで
-(ドラムを使用しない場合は 14 まで) にするべきです。@c
-それを越えた譜は演奏されません。
+MIDI 出力は譜毎に 1 つのチャンネルを割り当て、@c
+ドラムのためにチャンネル 10 を予約します。@c
+デバイス 1 つにつき MIDI チャンネルは 16 しかないため、@c
+楽譜が 16 以上の譜を保持している場合、MIDI チャンネルは再利用されます。
@menu
* MIDI ファイルを作り出す::
クレッシェンドとデクレッシェンドはそれらの開始点と終了点の間でボリュームを@c
線形に変化させます。@c
MIDI 出力における強弱記号の効果を完全に削除することができます
- -- @ref{MIDI ブロック} を参照してください。
+ -- @ref{MIDI block} を参照してください。
初期のテンポと後のテンポ変化は、音楽記譜内部の @code{\tempo} コマンドで@c
指定することができます。@c
通常このコマンドはメトロノーム記号を表示させますが、@c
表示を抑制することができます
--- @ref{メトロノーム記号} を参照してください。@c
+-- @ref{Metronome marks} を参照してください。@c
初期 MIDI テンポあるいは MIDI 全体のテンポを指定するための代替手段が@c
-この後で記述されています -- @ref{MIDI ブロック} を参照してください。
+この後で記述されています -- @ref{MIDI block} を参照してください。
Windows の制限により、Windows での MIDI ファイルのデフォルトの拡張子は
@code{.mid} です。@c
\score @{
@var{...music...}
\midi @{
- \context @{
- \Score
- tempoWholesPerMinute = #(ly:make-moment 72 4)
- @}
+ \tempo 4 = 72
@}
@}
@end example
この例では、テンポは 1 分間あたり 72 個の 4 分音符にセットされています。@c
-この種のテンポ指定では引数として付点音符の長さをとることはできません。@c
-付点音符の長さを指定する必要がある場合、@c
-その付点音符をより小さな単位に分解します。@c
-例えば、1 分間に 90 個の付点 4 分音符のテンポは、@c
-1 分間に 270 個の 8 分音符として指定することができます:
-
-@example
-tempoWholesPerMinute = #(ly:make-moment 270 8)
-@end example
+@code{\tempo} は実際、コンパイルの最中にプロパティを設定する音楽コマンドです:
+@code{\midi} ブロックのような出力定義コンテキストの中にある @code{\tempo} は@c
+当然のこととして、コンテキストを変更するものとして解釈されます。
@cindex MIDI context definitions (MIDI コンテキスト定義)
サウンドのモジュールへの翻訳は performer と呼ばれます。@c
MIDI 出力のためのコンテキストは
@file{../ly/performer-init.ly} で定義されています
--- @rlearning{その他の情報源} を参照してください。@c
+-- @rlearning{Other sources of information} を参照してください。@c
例えば、MIDI 出力から強弱記号の効果を削除するには、@c
@code{\midi@{ @}} ブロックの中に以下のコードを挿入します。
@itemize
@item ピッチ
-@item 微分音 (@ref{臨時記号} を参照してください。@c
+@item 微分音 (@ref{Accidentals} を参照してください。@c
演奏にはピッチ ベンドをサポートするプレイヤが必要になります。)
@item コード名で入力された和音
@item 音符の演奏時間として入力されたリズム -- 連符を含みます
@item 歌詞
@end itemize
-@ref{奏法スクリプト} を用いることで、@c
+@ref{The Articulate script} を用いることで、@c
上記のリストにいくつかの要素が追加されます:
@itemize
@notation{fffff} に対する 0.95 までです。@c
強弱記号とそれに対応する分数のセットを @file{../scm/midi.scm} で@c
調べることができます
--- @rlearning{その他の情報源} を参照してください。@c
+-- @rlearning{Other sources of information} を参照してください。@c
引数として強弱記号をとり、それに対する分数を返す関数を作成し、@c
その関数を @code{Score.dynamicAbsoluteVolumeFunction} に@c
セットすることによって、分数のセットを変更あるいは拡張することができます。
\set Staff.midiInstrument = #"flute"
\new Voice \relative c''' {
r2 g\mp g fis~
- fis4 g8 fis e2~
- e4 d8 cis d2
+ 4 g8 fis e2~
+ 4 d8 cis d2
}
}
\new Staff {
>>
\layout {}
\midi {
+ \tempo 2 = 72
\context {
\Score
- tempoWholesPerMinute = #(ly:make-moment 72 2)
midiMinimumVolume = #0.2
midiMaximumVolume = #0.5
}
}
@end lilypond
-
@unnumberedsubsubsec 楽器の音の強さを均一化する (i)
@c @unnumberedsubsubsec Equalizing different instruments (i)
\set Staff.midiMaximumVolume = #0.9
\new Voice \relative c''' {
r2 g\mp g fis~
- fis4 g8 fis e2~
- e4 d8 cis d2
+ 4 g8 fis e2~
+ 4 d8 cis d2
}
}
\new Staff {
>>
\layout {}
\midi {
- \context {
- \Score
- tempoWholesPerMinute = #(ly:make-moment 72 2)
- }
+ \tempo 2 = 72
}
}
@end lilypond
\set Staff.midiInstrument = #"flute"
\new Voice \relative c''' {
r2 g\mp g fis ~
- fis4 g8 fis e2 ~
- e4 d8 cis d2
+ 4 g8 fis e2 ~
+ 4 d8 cis d2
}
}
\new Staff {
>>
\layout { }
\midi {
- \context {
- \Score
- tempoWholesPerMinute = #(ly:make-moment 72 2)
- }
+ \tempo 2 = 72
}
}
@end lilypond
半シャープと半フラットからなる微分音は MIDI ファイルにエクスポートされ、@c
ピッチ ベンドをサポートする MIDI プレーヤで正しく演奏されます。@c
-@ref{他の言語での音符名} を参照してください。@c
+@ref{Note names in other languages} を参照してください。@c
以下の例は 1 オクターブの中にあるすべての半シャープと半フラットの音を@c
示しています。@c
この例をコピーしてコンパイルすることで、@c
@funindex \displayLilyMusic
-音楽関数 @code{\displayLilyMusic} でLilyPond 記譜法で書かれた音楽表記を@c
-表示することが可能ですが、@c
-コマンド ラインを使っている場合にのみ可能です。@c
+LilyPond 記譜法で書かれた音楽表記を@c
+音楽関数 @code{\displayLilyMusic} で表示することが可能です。@c
+出力を見るには、通常、コマンド ラインで LilyPond を実行します。@c
例えば、
@example
lilypond file.ly >display.txt
@end example
+@funindex \void
+
+LilyPond は音楽表記を表示するだけでなく、それを解釈します
+(なぜなら、@code{\displayLilyMusic} は追加で音楽表記を表示するために@c
+返すだけだからです)。@c
+既存の音楽に @code{\displayLilyMusic} を挿入するだけで@c
+その音楽の情報を得るられるので便利です。@c
+本当に LilyPond に音楽を解釈させたくないのであれば、@c
+@code{\void} を使ってその音楽を無視させます:
+
+@example
+@{
+ \void \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
+@}
+@end example
+
@node Scheme 音楽表記を表示する
@subsection Scheme 音楽表記を表示する