1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: ja -*-
4 Translation of GIT committish: fabcd22c8f88ea9a87241597f1e48c0a9adbfc6e
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
11 @include included/generating-output.itexi
15 @c Translators: Yoshiki Sawada
16 @c Translation status: post-GDP
21 @translationof Tutorial
23 この章は LilyPond に取り組むための基本的な入門書です。
35 @translationof Compiling a file
37 このセクションでは @qq{コンパイル}---出力ファイルを作り出すために
38 (あなたが記述した) LilyPond 入力ファイルを処理すること---について説明します。
50 @translationof Entering input
52 @cindex compiling (コンパイルする)
53 @cindex first example (最初の例)
54 @cindex example, first (最初の例)
55 @cindex case sensitive (大文字と小文字を区別する)
57 @qq{コンパイル} は LilyPond フォーマットで書かれた入力ファイルから@c
58 出力ファイルを作り出す処理を意味する用語です。
59 出力ファイルは一般に PDF (印刷や閲覧用)、MIDI (演奏用)、それに PNG
63 ため、そして (オプションとして) 演奏可能な MIDI ファイルを@c
64 作り出すために処理することを意味する用語です。@c
65 LilyPond 入力ファイルはシンプルなテキストファイルです。@c
66 最初の例ではシンプルな入力ファイルがどのようなものかを示します。
68 楽譜を作成するために、我々は記譜法を指定する入力ファイルを書きます。@c
72 \version "@w{@version{}}"
81 @c in this case we don't want verbatim
88 @c !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
89 @c strong内で {} を使用しようとした場合、なぜか下記のような表記にしなければ
91 @c !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
92 @warning{LilyPond 入力の音符と歌詞は、
93 @strong{@code{@{}} @strong{波括弧} @strong{@code{@}}}
95 さらに、あいまいさを避けるために、波括弧は行の最初か最後でない限りは@c
97 波括弧はこのマニュアルのいくつかの例では省略されているかもしれませんが、@c
98 あなた自身が作成する楽譜では忘れないでください!@c
99 マニュアルの中にある例を表示する方法についての更なる情報については、@c
100 @ref{このマニュアルの読み方} を参照してください。}
102 さらに、LilyPond 入力は@strong{大文字/小文字}の区別 があります。@c
103 @w{@code{@{ c d e @}}} は有効な入力ですが、@c
104 @w{@code{@{ C D E @}}} はエラーになります。
113 @cindex PDF file (PDF ファイル)
114 @cindex viewing music (楽譜を閲覧する)
115 @cindex text editors (テキストエディタ)
117 出力を作り出す方法はあなたが使用している OS とプログラムに依存します。
122 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
123 @ref{MacOS X, MacOS X} (グラフィカルな方法)
126 @ref{Windows, @sourceimage{logo-windows,,,}}
127 @ref{Windows, Microsoft Windows} (グラフィカルな方法)
130 @ref{Command-line, @sourceimage{logo-linux,,,}
131 @sourceimage{logo-freebsd,,,}
132 @sourceimage{logo-macosx,,,}
133 @sourceimage{logo-windows,,,}
135 @ref{Command-line, すべての OS} (コマンドライン)
139 LilyPond 用のサポートを有するテキストエディタが他にもいくつかあります。@c
140 更なる情報は、@rweb{より簡単な編集手段} を参照してください。
142 @warning{あなたが初めて LilyPond を実行した場合、1, 2 分かかるかもしれません。@c
143 なぜなら、まず最初にすべてのシステム フォントが分析されるからです。@c
144 それから後は、LilyPond はずっと早く実行されます!}
149 @translationof MacOS X
151 @cindex running LilyPond under MacOS X (MacOS X で LilyPond を実行する)
152 @cindex MacOS X, running LilyPond (MacOS X で LilyPond を実行する)
159 @translationof Windows
161 @cindex running LilyPond under Windows (Windows で LilyPond を実行する)
162 @cindex Windows, running LilyPond (Windows で LilyPond を実行する)
169 @translationof Command-line
171 @cindex running LilyPond under Unix (Unix で LilyPond を実行する)
172 @cindex Unix, running LilyPond (Unix で LilyPond を実行する)
179 @translationof How to write input files
181 このセクションでは、あなたが入力ファイルを書き始めるのを手助けするために
182 LilyPond の基本的な構文をいくつか紹介します。
192 @translationof Simple notation
194 @cindex simple notation (簡単な記譜法)
195 @cindex notation, simple (簡単な記譜法)
197 LilyPond はいくつかの記譜要素を自動的に追加します。@c
198 次の例では、我々は 4 つのピッチを指定しただけですが、LilyPond が音部記号、@c
201 @lilypond[verbatim,quote]
208 この挙動は変更されるかもしれませんが、たいていのケースではこれらの自動値は@c
215 @cindex pitches (ピッチ)
216 @cindex relative mode (相対モード)
217 @cindex quote, single (シングル クォート)
219 @cindex accidentals and relative mode (臨時記号と相対モード)
220 @cindex relative mode, and accidentals (臨時記号と相対モード)
227 音楽用語集: @rglos{pitch}, @rglos{interval},
228 @rglos{scale}, @rglos{middle C}, @rglos{octave},
231 音符を入力するための最も簡単な方法は @code{\relative} モードを@c
233 このモードでは、後に続く音符は常に前の音符に最も近い場所になるという@c
234 仮定によって自動的にオクターブが選択されます。@c
235 つまり、音符は前の音符から 3 譜表スペース (訳者: 1 譜表スペースとは同じ音階の@c
236 ド→レ、レ→ミ、~の間隔のこと) 以内に置かれます。@c
237 我々はまず音楽の最も基本的な要素 -- @notation{音階} (ここでは各音符は@c
238 前の音符からちょうど 1 譜表スペースの位置にきます) -- からはじめます。
240 @lilypond[verbatim,quote]
241 % set the starting point to middle C
248 最初の音符は@notation{ミドル C} です。@c
249 一連の音符はそれぞれ前の音符と最も近い場所に置かれています --
250 言い換えると、最初の @code{c} はミドル C に最も近い C です。@c
251 これに前の音符に最も近い D が続きます。@c
252 我々は @code{\relative} モードだけを使って@c
253 より大きな音程を持つ旋律を作ることができます:
255 @lilypond[verbatim,quote]
263 旋律の最初の音符が開始ピッチを指定している音符である必要はありません。@c
264 前の例では、最初の音符 -- @code{d} -- はミドル C に最も近い D です。
266 @code{@w{\relative c' @{}} コマンドにクォート @code{'} やカンマ @code{,} を@c
267 付け加える (あるいは取り除く) ことによって、@c
270 @lilypond[verbatim,quote]
271 % one octave above middle C
277 相対モードは最初のうちは混乱を引き起こす可能性がありますが、@c
278 たいていの旋律を入力するのに最も容易な方法です。@c
279 相対計算が実際にどのように行われるのか見てみましょう。@c
280 B -- ト音記号の譜面の真ん中の譜線上にあります -- から開始すると、C, D, E は@c
281 上方向に 3 譜表スペース以内にあり、A, G, F は下方向に 3 譜表スペース以内に@c
283 そのため、B の後に続く音符が C, D, E である場合、その音符は B の上に置かれ、@c
284 A, G, F である場合は B の下に置かれます。
287 @lilypond[verbatim,quote]
289 b c % c は b よりも 1 譜表スペース上なので、c は b の上になります
290 b d % d は 2 つ上または 5 つ下なので、d は上になります
291 b e % e は 3 つ上または 4 つ下なので、e は上になります
292 b a % a は 6 つ上または 1 つ下なので、a は下になります
293 b g % g は 5 つ上または 2 つ下なので、g は下になります
294 b f % f は 4 つ上または 3 つ下なので、f は下になります
298 これらの音符のいずれかにシャープやフラットが付いたとしても@c
300 相対位置の算出時に@notation{臨時記号}は@strong{完全に無視}されます。@c
301 譜表上の他のいずれかの位置にある音符からの譜表スペース数もまったく同じです。
303 3 譜表スペースよりも大きな音程を加えるために、シングル クォート @code{'}
304 (あるいはアポストロフィ) を音符名に付け加えることによって@c
305 @notation{オクターブ}を上げることができます。@c
306 音符名にカンマ @code{,} を付け加えることによってオクターブを@c
309 @lilypond[verbatim,quote]
317 音符を 2 オクターブ (あるいはそれ以上) 変えるには、複数化した @code{''} や
318 @code{,,} を使用します -- しかしながら、1 つのダブル クォート @code{"}
319 ではなく、2 つのシングル クォートを使用するよう注意してください!@c
320 また、@code{@w{\relative c'}} の中の最初の値もこのように@c
322 @c " - keeps quotes in order for context-sensitive editor -td
325 @subheading 演奏時間 (リズム)
326 @c Durations (rhythms)
327 @c 演奏時間 (原語: Durations, リズム)
329 @cindex note durations (音符の演奏時間)
330 @cindex durations (演奏時間)
331 @cindex rhythms (リズム)
332 @cindex whole note (全音符)
333 @cindex half note (半音符)
334 @cindex quarter note (4 分音符)
335 @cindex dotted note (付点音符)
336 @cindex notating durations (演奏時間を記譜する)
338 音楽用語集: @rglos{beam}, @rglos{duration},
339 @rglos{whole note}, @rglos{half note}, @rglos{quarter note},
341 @c 連桁 (beam), 演奏時間 (duration), 全音符 (whole note), 半音符 (half note),
342 @c 4 分音符 (quarter note), 付点音符 (dotted note)
344 音符の@notation{演奏時間}は音符名の後の番号によって指定されます。@c
345 @notation{全音符}には @code{1} を、@notation{半音符}には @code{2} を、@c
346 @notation{4 分音符}には @code{4} を、などです。@c
348 (符幹と符幹をつなぐ横棒。符幹は符頭から上下にでる縦棒。符頭は音符の玉)
351 あなたが演奏時間を指定しなかった場合、@c
352 前の音符の演奏時間が次の音符の演奏時間に対しても使用されます。@c
353 最初の音符のデフォルトの演奏時間は 4 分音符です。
355 @lilypond[verbatim,quote]
359 a16 a a a a32 a a a a64 a a a a a a a a2
363 @notation{付点音符}を作成するには、@c
364 演奏時間数にドット @code{.} を付け加えます。@c
365 付点音符の演奏時間は明記されなければなりません (つまり、数字で)。
367 @lilypond[verbatim,quote]
379 @cindex notating rests (休符を記譜する)
384 @notation{休符}は @code{r} という名前の音符のような形で入力されます:
386 @lilypond[verbatim,quote]
397 @cindex time signature (拍子記号)
402 音楽用語集: @rglos{time signature}
403 @c 拍子記号 (time signature)
405 @notation{拍子記号}は @code{\time} コマンドでセットすることができます:
407 @lilypond[verbatim,quote]
422 @cindex tempo marks (テンポ記号)
423 @cindex metronome marks (メトロノーム記号)
428 音楽用語集: @rglos{tempo indication}, @rglos{metronome}
430 @notation{テンポ指示} と @notation{メトロノーム記号} は
431 @code{\tempo} コマンドでセットすることができます:
433 @lilypond[verbatim,quote]
442 \tempo "Presto" 4 = 120
452 @cindex treble (ト音記号、高音部記号)
463 @notation{音部記号}は @code{\clef} コマンドを使ってセットすることができます:
465 @lilypond[verbatim,quote]
482 以上の要素をすべて集めたちょっとした例をお見せします:
484 @lilypond[verbatim,quote]
488 \tempo "Andante" 4 = 120
507 @subsection 入力ファイルに取り組む
508 @translationof Working on input files
510 @cindex curly braces (波括弧)
511 @cindex braces, curly (波括弧)
512 @cindex comments (コメント)
513 @cindex line comment (行コメント)
514 @cindex comment, line (行コメント)
515 @cindex block comment (ブロック コメント)
516 @cindex comment, block (ブロック コメント)
517 @cindex case sensitive (大文字と小文字を区別する)
518 @cindex whitespace insensitive (空白を無視する)
519 @cindex expressions (表記)
520 @cindex versioning (バージョンを付ける)
521 @cindex version (バージョン)
522 @cindex version number (バージョン番号)
527 @funindex %@{ ... %@}
529 LilyPond 入力ファイルは多くの一般的なプログラミング言語のソース ファイルと@c
531 それらは大文字/小文字の区別があり、空白はたいてい無視されます。@c
532 表記は波括弧 @{ @} で囲まれ、@code{%} または @w{@code{%@{ .. %@}}} で@c
535 上の文章があなたにとって意味不明だとしても、心配ありません!@c
542 すべての LilyPond ファイルにはバージョン宣言を持たせるべきです。@c
543 バージョン宣言は、そのファイルが LilyPond のどのバージョン用に@c
545 バージョン宣言は以下の例のように記述します:
548 \version "@w{@version{}}"
551 規則上、バージョン宣言は LilyPond ファイルの先頭に配置します。
553 バージョン宣言は少なくとも 2 つの理由で重要です。@c
554 1 つ目の理由は、LilyPond 構文が変更された場合に、@c
555 入力ファイルを自動アップデートすることを可能にします。@c
556 2 つ目の理由は、そのファイルをコンパイルするのに必要な LilyPond の@c
559 入力ファイルでバージョン宣言を省略した場合、@c
560 ファイルのコンパイル中に LilyPond は警告を表示します。
565 あなたが小文字 (つまり、@w{@code{a, b, s, t)}} で入力するか、@c
566 大文字 (つまり、@w{@code{A, B, S, T}}) で入力するかの違いです:
567 @w{@code{@{ c d e @}}} は有効な入力ですが、@c
568 @w{@code{@{ C D E @}}} ではエラーになります。
572 あなたがどれくらい多くのスペース (または新しい行) を追加しても@c
574 @w{@code{@{ c d e @}}} は @w{@code{@{ c @tie{} @tie{} @tie{} d e @}}} や@c
583 もちろん、このような書き方をすると読みにくいです。@c
585 コード ブロックにタブか 2 つのスペースでインデントを付けることです:
593 しかしながら、多くの構文要素を他の要素と区切るために必要とされます。@c
594 言い換えると、常に空白を @emph{付け加える} ことは可能ですが、@c
595 常に空白を @emph{削除} できるわけではありません。@c
596 空白が足りないためにエラーが発生することあり、@c
597 すべての構文要素の前後に空白を入れることは有用なことです。
601 LilyPond 入力の各部分は @strong{@{ 波括弧 @}} で囲まれている必要があります。@c
602 これらの波括弧は LilyPond に入力が単一の音楽表記であることを教えます。@c
603 これはちょうど数学での括弧 @code{()} のようなものです。@c
604 あいまいさを避けるために、波括弧は行の先頭か終端にないかぎりスペースで@c
607 波括弧で囲まれた表記が後に続く LilyPond コマンド
608 (@q{@w{@code{@bs{}relative c' @{ @dots{} @}}}} など)
609 もまた単一の音楽表記としてカウントされます。
611 @cindex comments (コメント)
612 @cindex line comment (行コメント)
613 @cindex block comment (ブロック コメント)
617 コメントは音楽入力を読む人間のための注釈です。@c
618 これは構文解析中には無視されるため、譜刻される出力には影響を与えません。@c
619 コメントには 2 つのタイプがあります。@c
620 パーセント記号 @code{%} は行コメントになります。@code{%} の後の文字は@c
622 慣習上、行コメントはそのコメントが参照するコードの上に置かれます。
626 % このコメントは B を持つ行を参照します
630 ブロック コメントは音楽入力のある部分全体をコメントにします。@c
631 @code{%@{} と @code{%@}} で囲まれた部分は無視されます。@c
632 しかしながら、ブロック コメントを @q{ネスト} させることはできません。@c
633 このことはあるブロック コメントを他のブロック コメントの中に@c
634 置くことはできないということを意味します。@c
635 そうした場合、最初の @code{%@}} は両方のブロック コメントを@c
637 以下のコード断片はコメントの使用例を示しています:
645 なぜなら、これらはブロック コメントの中にあるからです
656 @translationof Dealing with errors
658 @cindex troubleshooting (トラブルシュート)
660 時には LilyPond はあなたが予期したような出力を作り出さないことがあります。@c
661 このセクションでは、あなたが遭遇するかもしれない問題を解決するのに@c
665 * 一般的なトラブルシュート Tips::
670 @node 一般的なトラブルシュート Tips
671 @subsection 一般的なトラブルシュート Tips
672 @translationof General troubleshooting tips
674 LilyPond で発生する問題をトラブルシュートすることは、@c
675 グラフィカルインターフェイスに慣れ親しんだ人々にとっては@c
677 なぜなら無効な入力ファイルが生成される可能性があるからです。@c
678 問題が発生した時は、論理的なアプローチが問題を特定して解決する最善の方法です。@c
679 トラブルシュートの仕方を学ぶのに役立つガイドラインが
680 @rprogram{トラブルシュート} で提供されています。
684 @subsection いくつかの一般的なエラー
685 @translationof Some common errors
687 @cindex common errors (一般的なエラー)
688 @cindex errors, common (一般的なエラー)
690 表示されるエラーメッセージだけでは解決が難しい一般的なエラーがいくつかあります。@c
691 それらのエラーについて @rprogram{一般的なエラー} で記述されています。
696 @translationof How to read the manuals
698 このセクションではドキュメントを効率的に読む方法を示し、@c
699 さらに、オンライン版で利用できる有用な対話的機能をいくつか紹介します。
709 @subsection 省略された構成要素
710 @translationof Omitted material
713 @cindex how to read the manual (このマニュアルの読み方)
714 @cindex manual, reading (マニュアルを読む)
715 @cindex reading the manual (このマニュアルを読む)
716 @cindex examples, clickable (クリック可能な例)
717 @cindex clickable examples (クリック可能な例)
718 @cindex tips for constructing files (ファイルを構築するための Tips)
719 @cindex templates (テンプレート)
720 @cindex constructing files, tips (ファイルを構築するための Tips)
721 @cindex files, tips for constructing (ファイルを構築するための Tips)
723 @c @ref{Working on input files}
724 @ref{入力ファイルに取り組む} で見てきたように、LilyPond 入力は @{ @} マークか
725 @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}}
727 このマニュアルの残りの部分では、たいていの例はこのことを省略しています。@c
728 このマニュアルにある例を複製するためにあなたは表示されている入力を@c
729 コピーするかもしれませんが、あなたは以下のように
730 @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}}
735 @dots{}例がここに来ます@dots{}
740 このマニュアルの中のたいていの例はより大きな音楽の途中に@c
742 これらの例に対して @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}}
744 -- あなたはある @code{\relative} を他の @code{\relative} の
747 @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}}
749 あなたは小さな例をコピーして、それをより大きなあなた自身の音楽の中に@c
750 ペーストすることができなくなってしまいます。@c
751 たいていの人は資料を既存の楽曲に付け加えようとしますので、@c
752 我々はそのようにマニュアルを形作っています。
754 さらに、すべての LilyPond ファイルは @code{\version} 宣言を持つべきである@c
756 マニュアルの中の例はコードの断片であり、ファイルではないため、@c
757 @code{\version} 宣言は省略されています。@c
758 しかしながら、あなたは入力ファイルの中にバージョン宣言を記述すべきです。
763 @translationof Clickable examples
765 @warning{この機能は HTML マニュアルでのみ利用可能です。}
767 多くの人々はすでにあるプログラムを試したり、いじったりすることで@c
769 これは LilyPond でも可能です。@c
770 このマニュアルの HTML バージョンの中にある画像をクリックすると、@c
771 画像を生成するために使用された正確な LilyPond 入力を見ることができます。@c
777 c-\markup { \bold \huge { ここをクリックしてください } }
781 @q{ly コード断片} セクションにある記述をカット&ペーストすることによって、@c
782 あなたは LilyPond を経験するための開始テンプレートを入手できます。@c
783 まったく同じもの (線の太さなどもすべて同じ) を出力させるには、@c
784 @qq{Start cut-&-pastable section} からファイルの最後までをコピーしてください。
789 @u nnumberedsubsec キーボード ナビゲーション
790 @t ranslationof Keyboard navigation
796 @translationof Overview of manuals
798 LilyPond にはたくさんのドキュメントがあります。@c
799 新しいユーザは時々ドキュメントのどこを読むべきなのか混乱し、@c
800 時には必須の部分を読み飛ばしてしまいます。
802 @warning{ドキュメントの重要な部分を読み飛ばさないでください。@c
803 その後のセクションを理解することがはるかに難しくなります。}
808 @strong{LilyPond に取り組もうとする前}: 学習マニュアルの @ref{チュートリアル}
809 と @ref{一般的な記譜法} を読んでください。@c
810 理解できない音楽用語に遭遇した場合は、@rglosnamed{Top, 音楽用語集} で調べてください。
813 @strong{楽譜全体を記述しようとする前}: 学習マニュアルの
814 @ref{基礎となるコンセプト} を読んでください。@c
815 読み終わった時、@rusernamed{Top, 記譜法リファレンス} の関係のあるセクションを@c
819 @strong{デフォルトの出力を変更しようとする前}: 学習マニュアルの
820 @ref{出力を調整する} を読んでください。
823 @strong{大きなプロジェクトに取りかかる前}: 使用方法の
824 @rprogram{LilyPond 入力ファイルの記述に対する提案} を読んでください。