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..
13 @c Translators: Yoshiki Sawada
14 @c Translation status: post-GDP
19 @translationof External programs
21 LilyPond は様々な方法で他のプログラムと連携することができます。
27 * LilyPond 出力を他のプログラムで使用する::
33 @translationof Point and click
35 ポイント&クリックは PDF ドキュメントに音楽要素へのリンクを追加します。
43 @unnumberedsubsec ポイント&クリックを有効にする
44 @translationof Enabling point and click
46 @cindex point and click (ポイント&クリック)
48 ポイント&クリックは PDF ビューアの中で表記をクリックすることで@c
49 入力の中の表記を見つけ出すことを可能にします。@c
50 これは楽譜の中でエラーを引き起こす入力を見つけ出すことより容易にします。
53 LilyPond は PDF ファイルにハイパーリンクを付け加えます。@c
54 これらのハイパーリンクは Web ブラウザに送られ、@c
55 Web ブラウザはカーソルを持つテキスト エディタを適切な位置に開きます。
58 PDF ビューアが LilyPond で提供される @file{lilypond-invoke-editor}
59 スクリプトを使ってハイパーリンクを追うように設定変更する必要があります。
62 @file{xpdfrc}@footnote{UNIXでは、このファイルは @file{/etc/xpdfrc} か@c
63 ホーム ディレクトリの中の @file{.xpdfrc} としてのどちらかです。}
66 以下の記述が @file{xpdfrc} の中に存在している必要があります。
67 UNIX において、このファイルは @file{/etc/xpdfrc} の中または
68 @file{$HOME/.xpdfrc} として存在します。
71 urlCommand "lilypond-invoke-editor %s"
74 プログラム @file{lilypond-invoke-editor} は小さな支援プログラムです。@c
75 これは特別な @code{textedit} URI に対してエディタを呼び出し、@c
76 それ以外に対しては Web ブラウザを呼び出します。@c
77 このプログラムは環境変数 @code{EDITOR} を調べて、@c
84 emacsclient --no-wait +@var{line}:@var{column} @var{file}
89 gvim --remote +:@var{line}:norm@var{column} @var{file}
94 nc -noask +@var{line} @var{file}'
98 環境変数 @code{LYEDITOR} はこの動作をオーバライドするために使用されます。@c
99 これにはエディタを起動するためのコマンド ラインを保持し、@c
100 @code{%(column)s}, @code{%(line)s} は@c
101 それぞれファイル、列、行に置き換えられます。
102 以下の @code{LYEDITOR} 設定は標準の emacsclient 呼び出しと等価です。
105 emacsclient --no-wait +%(line)s:%(column)s %(file)s
109 @cindex file size, output (出力のファイル サイズ)
111 ポイント&クリックのリンクは出力ファイルを肥大化させます。@c
112 PDF ファイルと PS ファイルのサイズを小さくするには、@c
113 @file{.ly} ファイルの中に以下を記述してポイント&クリックを OFF にします:
120 以下を用いて、ポイント&クリックを明示的に ON にすることができます:
126 @file{.ly} ファイルの中でポイント&クリックを OFF にする代わりに@c
127 コマンド ライン オプションで OFF にすることができます:
130 lilypond -dno-point-and-click file.ly
133 @warning{配布する LilyPond ファイルでは常にポイント&クリックを OFF にして、@c
134 .pdf ファイルにあなたのコンピュータの Path 情報が含まれないようにすべきです。@c
135 配布する .pdf ファイルに Path 情報が含まれていると@c
140 @unnumberedsubsec 選択的なポイント&クリック
142 インタラクティブなアプリケーションでは、@c
143 ある特定のポイント&クリック要素だけを含むことが望ましい場合もあります。@c
144 例えば、誰かがある特定の音符から演奏を開始できるアプリケーションを作りたいと@c
146 音符をクリックした場合にその音符の上にある臨時記号やスラーの@c
147 ポイント&クリックが開いてしまったのでは不便です。
149 どのイベントをポイント&クリックに含めるか指定することで、これを制御できます:
153 @file{.ly} ファイルにハード コードする:
156 \pointAndClickTypes #'note-event
165 #(ly:set-option 'point-and-click 'note-event)
175 lilypond -dpoint-and-click=note-event example.ly
184 @file{.ly} ファイルにハード コードする:
187 \pointAndClickTypes #'(note-event dynamic-event)
196 #(ly:set-option 'point-and-click '(note-event dynamic-event))
207 -e"(ly:set-option 'point-and-click '(note-event dynamic-event))" \
215 @section テキスト エディタ サポート
216 @translationof Text editor support
218 @cindex editors (エディタ)
221 @cindex modes, editor (エディタのモード)
222 @cindex syntax coloring (カラーリング構文)
223 @cindex coloring, syntax (カラーリング構文)
225 いくつかのテキスト エディタの LilyPond サポート機能があります。
234 @unnumberedsubsec Emacs モード
235 @translationof Emacs mode
237 Emacs は @file{lilypond-mode} を持ちます。@c
238 これはキーワード自動補完、インデント挿入、LilyPond 特有の括弧一致、@c
239 構文カラーリング、コンパイルへのショートカット、@c
240 それに Info を用いての LilyPond マニュアル参照といった機能を持ちます。@c
241 @file{lilypond-mode} があなたのプラットフォームにインストールされて@c
242 いないのであれば、以下を参照してください。
244 楽譜を記述して、LilyPond を実行するための Emacs モードは
245 @file{elisp} ディレクトリの中にあるソース アーカイブに保持されています。@c
246 @command{make install} を実行して、@c
247 これを @var{elispdir} にインストールします。@c
248 ファイル @file{lilypond-init.el} を @var{load-path}@file{/sites-start.d/} に@c
249 配置するか、@file{~/.emacs} または @file{~/.emacs.el} に追記する必要があります。
251 @file{~/.emacs} に以下の行を追記 (あるいは修正) して、@c
252 ソース パス (例えば @file{~/site-lisp/) を @var{load-path} に@c
255 @c any reason we do not advise: (push "~/site-lisp" load-path)
257 (setq load-path (append (list (expand-file-name "~/site-lisp")) load-path))
262 @unnumberedsubsec Vim モード
263 @translationof Vim mode
265 @uref{http://@/www@/.vim@/.org,Vim} のために
266 LilyPond 用のファイルタイプ プラグイン、インデント モード、@c
267 それに構文ハイライト モードが用意されています。@c
269 @file{$HOME/.vimrc} が以下の 3 行を順序に従って保持するよう追記
274 set runtimepath+=/usr/local/share/lilypond/current/vim/
279 LilyPond が @file{/usr/local} にインストールされていない場合は@c
281 このトピックは @rlearning{その他の情報源} で議論されています。
285 @unnumberedsubsec その他のエディタ
286 @translationof Other editors
288 他にも LilyPond をサポートするエディタ
289 (テキスト ベースとグラフィカル ベースの両方) がありますが、@c
290 それらの特殊な設定ファイルは LilyPond では配布されません。@c
291 更なる情報はそれらのエディタのドキュメントを参照してください。@c
292 LilyPond をサポートするエディタは
293 @rweb{より簡単な編集手段} でリストアップされています。
297 @section 他のフォーマットから変換する
298 @translationof Converting from other formats
300 楽譜の記述を他のフォーマットからインポートするもできます。@c
301 この章では、配布プログラムに含まれるインポート ツールについて説明します。
302 LilyPond 入力を作り出すツールは他にもあります。@c
303 例えば GUI シーケンスと XML コンバータです。@c
304 詳細は @uref{http://@/lilypond@/.org,website} を参照してください。
306 上で述べたツールは @command{lilypond} とは別のプログラムであり、@c
308 詳細は @ref{コマンド ラインの使用方法} を参照してください。@c
309 あなたが MacOS 10.3 や 10.4 を使っていて、@c
310 これらのスクリプト (例えば @code{convert-ly}) を実行する際に問題が@c
311 発生した場合は、@rweb{MacOS X} を参照してください。
315 残念なことに我々にはこれらのプログラムを維持していくだけの余力はありません。@c
316 @qq{これからの課題} になっていると考えてください。@c
317 パッチは適用されていますが、バグ レポートはほとんど解決されていません。
320 * midi2ly を呼び出す:: MIDI をインポートする
321 * musicxml2ly を呼び出す:: MusicXML をインポートする
322 * abc2ly を呼び出す:: ABC をインポートする
323 * etf2ly を呼び出す:: Finale をインポートする
329 @subsection @command{midi2ly} を呼び出す
330 @translationof Invoking @command{midi2ly}
334 @command{midi2ly} は Type@tie{}1 MIDI ファイルを
335 LilyPond ソース ファイルに変換します。
337 MIDI (Music Instrument Digital Interface) は電子楽器の標準です:
338 これはケーブル、シリアル プロトコル、それにファイル フォーマットを指定します。@c
339 MIDI ファイル フォーマットは音楽を他のプログラムにエクスポートするための@c
340 デファクトスタンダードなフォーマットです。@c
341 そのため、MIDI ファイルを扱う機能を持つことは、@c
342 独自フォーマットを MIDI に変換できるプログラムのファイルを@c
345 @command{midi2ly} はトラックを @rinternals{Staff} コンテキストに変換し、@c
346 チャネルを @rinternals{Voice} コンテキストに変換します。@c
347 ピッチには相対モードが使用され、演奏時間は必要がある場合にだけ記述されます。
349 デジタル キーボードを使って MIDI ファイルを録音し、@c
350 それを @file{.ly} ファイルに変換することが可能です。@c
351 しかしながら、人間の演奏者のリズムは LilyPond コンバータにかけられる
352 MIDI を作り出せるほど正確ではありません。@c
353 量子化オプション (@option{-s} と @option{-d} オプション) を指定して
354 @command{midi2ly} を呼び出すと、リズムの誤りを訂正しようとしますが、@c
356 このため、人間の演奏で生成された MIDI ファイルを @command{midi2ly} で@c
360 @command{midi2ly} は以下のようにコマンド ラインから呼び出します:
362 midi2ly [@var{option}]@dots{} @var{midi-file}
365 @q{コマンド ライン} とは、OS のコマンド ラインを意味しているということに@c
367 このことについての更なる情報は @ref{他のフォーマットから変換する}
370 @command{midi2ly} には以下のオプションがあります。
373 @item -a, --absolute-pitches
376 @item -d, --duration-quant=@var{DUR}
377 音符の演奏時間を @var{DUR} で量子化します。
379 @item -e, --explicit-durations
385 @item -k, --key=@var{acc}[:@var{minor}]
387 @math{@var{acc} > 0} はシャープの数をセットし、@c
388 @math{@var{acc} < 0} はフラットの数をセットします。@c
389 短調は @code{:1} で指定します。
391 @item -o, --output=@var{file}
394 @item -s, --start-quant=@var{DUR}
395 音符の始まりを @var{DUR} で量子化します。
397 @item -t, --allow-tuplet=@var{DUR}*@var{NUM}/@var{DEN}
398 連符の演奏時間 @var{DUR}*@var{NUM}/@var{DEN} を許可します。
401 Verbose モード (ログ等が詳細) で実行します。
409 @item -x, --text-lyrics
416 アルペジオでの音符のオーバラップは正しく変換されません。@c
417 最初の音符は読み込まれますが、他の音符は無視されます。@c
418 すべての音符を同時に開始させ、同じ演奏にして、@c
419 フレーズ記号かペダル指示記号を追加してください。
422 @node musicxml2ly を呼び出す
423 @subsection @code{musicxml2ly} を呼び出す
424 @translationof Invoking @code{musicxml2ly}
428 @uref{http://@/www.@/musicxml@/.org/,MusicXML} は音楽記譜を表すための
431 @command{musicxml2ly} は Part-wise (時間軸優先ではなくパート優先の) MusicXML
432 から、音符、アーティキュレーション、楽譜構造、歌詞等を抽出し、@c
433 それらを @file{.ly} ファイルに記述します。@c
435 このプログラムはコマンド ラインから以下のように呼び出します:
437 musicxml2ly [@var{option}]@dots{} @var{xml-file}
440 @q{コマンド ライン} とは、OS のコマンド ラインを意味しているということに@c
442 このことについての更なる情報は @ref{他のフォーマットから変換する}
445 ファイル名に @file{-} を指定すると、@c
446 @command{musicxml2ly} はコマンド ラインから入力を受け付けます。
448 @command{musicxml2ly} には以下のオプションがあります。
457 @item -l, --language=LANG
459 例えば、ピッチ名にドイツ語を使用するには 'deutsch' を指定します。
461 @item --loglevel=@var{loglevel}
462 出力の饒舌さを @var{loglevel} にセットします。@c
463 取り得る値は @code{NONE}, @code{ERROR}, @code{WARNING},
464 @code{PROGRESS} (デフォルト), それに @code{DEBUG} です。
467 XML 解析に lxml.etree Python パッケージを使用します。@c
468 これはより少ないメモリと CPU 時間で実行されます。
473 @item -nd --no-articulation-directions
474 アーティキュレーションや強弱等の指示 (@code{^}, @code{_} あるいは @code{-})
478 連桁情報を変換せず、LilyPond の自動連桁機能を使用します。
480 @item -o, --output=@var{file}
481 出力ファイル名を @var{file} とします。@c
482 @var{file} に @file{-} を指定すると、出力は stdout に表示されます。@c
483 指定が無い場合、出力は @var{xml-file}@file{.ly} となります。
486 ピッチを相対モードに変換します。(デフォルト)
489 Verbose モード (ログ等が詳細) で実行します。
494 @item -z, --compressed
495 入力ファイルが ZIP で圧縮された MusicXML ファイルであることを示します。
500 @subsection @code{abc2ly} を呼び出す
501 @translationof Invoking @code{abc2ly}
503 @warning{このプログラムはサポートされていません。@c
504 LilyPond 将来のバージョンからは削除される可能性があります。}
508 ABC は ASCII ベースの非常にシンプルなフォーマットです。@c
509 このファイル形式について ABC のサイトで説明されています:
512 @uref{http://@/www@/.walshaw@/.plus@/.com/@/abc/@/learn@/.html}.
515 @command{abc2ly} は ABC から LilyPond に変換を行います。@c
519 abc2ly [@var{option}]@dots{} @var{abc-file}
522 @command{abc2ly} には以下のオプションがあります。
525 @item -b, --beams=None
531 @item -o, --output=@var{file}
532 出力ファイル名を @var{file} とします。
536 be strict about success
542 LilyPond コードを ABC ソース ファイルに付け加えるための簡単な機能があります。@c
546 %%LY voices \set autoBeaming = ##f
549 キーワード @q{voices} の後に続くテキストが
550 LilyPond 出力ファイルのカレントのボイスに挿入されます。
555 %%LY slyrics more words
558 これは、キーワード @q{slyrics} の後に続くテキストを@c
564 ABC の標準はあくまでも @q{標準} でしかありません。@c
565 機能拡張 (例えば、多声音楽) のために、異なる書式があります。
567 1 つのファイルに複数の旋律を持つものは変換できません。
569 ABC は行の先頭で単語と音符との同期をとりますが、@c
570 @command{abc2ly} は同期をとりません。
572 @command{abc2ly} は ABC の連桁を無視します。
576 @subsection @command{etf2ly} を呼び出す
577 @translationof Invoking @command{etf2ly}
579 @warning{このプログラムはサポートされていません。@c
580 LilyPond 将来のバージョンからは削除される可能性があります。}
586 @cindex Coda Technology
588 ETF (Enigma Transport Format) is a format used by Coda Music
589 Technology's Finale product. @command{etf2ly} will convert part of an ETF
590 file to a ready-to-use LilyPond file.
592 It is invoked from the command-line as follows.
595 etf2ly [@var{option}]@dots{} @var{etf-file}
598 Note that by @q{command-line}, we mean the command line of the
599 operating system. See @ref{Converting from other formats}, for
600 more information about this.
602 The following options are supported by @command{etf2ly}:
607 @item -o, --output=@var{FILE}
608 set output filename to @var{FILE}
616 The list of articulation scripts is incomplete. Empty measures
617 confuse @command{etf2ly}. Sequences of grace notes are ended improperly.
621 @subsection その他のフォーマット
622 @translationof Other formats
624 @cindex External programs, generating LilyPond files (LilyPond ファイルを生成する外部プログラム)
626 LilyPond 自体は他のフォーマットを一切サポートしませんが、@c
627 外部ツールで LilyPond ファイルを生成することができます。@c
628 それらのツールは @rweb{より簡単な編集手段} でリストアップされています。
631 @node LilyPond 出力を他のプログラムで使用する
632 @section LilyPond 出力を他のプログラムで使用する
633 @translationof LilyPond output in other programs
635 このセクションでは、@command{lilypond-book} を用いた自動手法ではない、@c
640 * LilyPond 出力を OpenOffice.org に挿入する::
641 * LilyPond 出力を他のプログラムに挿入する::
644 @node 大きな楽譜から多くの引用を行う
645 @unnumberedsubsec 大きな楽譜から多くの引用を行う
646 @translationof Many quotes from a large score
648 大きな楽譜から多くの断片を引用する必要がある場合、@c
649 システムをクリップする機能を使うことができます。@c
650 @c @ruser{音楽の断片を抽出する}
651 @ruser{Extracting fragments of music} を参照してください。
653 @node LilyPond 出力を OpenOffice.org に挿入する
654 @unnumberedsubsec LilyPond 出力を OpenOffice.org に挿入する
655 @translationof Inserting LilyPond output into OpenOffice.org
657 @cindex OpenOffice.org
659 @uref{http://@/ooolilypond@/.sourceforge@/.net@/,OOoLilyPond} を用いて
660 LilyPond 記譜を OpenOffice.org に付け加えることができます。
663 @node LilyPond 出力を他のプログラムに挿入する
664 @unnumberedsubsec LilyPond 出力を他のプログラムに挿入する
665 @translationof Inserting LilyPond output into other programs
667 LilyPond 出力を他のプログラムに挿入するには、@c
668 @code{lilypond-book} ではなく、@code{lilypond} を使用します。@c
669 それぞれの例を個々に作成してドキュメントに付け加えます。@c
670 大抵のプログラムに @file{PNG}, @file{EPS}, あるいは @file{PDF} フォーマットの
671 LilyPond 出力を挿入することができます。
673 LilyPond 楽譜の周りの空白を減らすには、以下のオプションを使用します:
674 the following options
682 bookTitleMarkup = ##f
683 scoreTitleMarkup = ##f
689 有用な画像ファイルを作り出すには、以下のようにします:
694 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts myfile.ly
698 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png myfile.ly
702 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts \
703 -dpixmap-format=pngalpha --png myfile.ly
708 @section 独立した @code{include}
709 @translationof Independent @code{include}s
711 共有可能な大きな (そして有用な!) コードを記述している人がいます。@c
712 これらのコードは独自のやり方で LilyPond を include してい場合があります。@c
713 include が行われない場合、include されるファイルをダウンロードして@c
714 手動でそれらを include する必要があります。
722 @node MIDI アーティキュレーション
723 @subsection MIDI アーティキュレーション
724 @translationof MIDI articulation
726 LilyPond は @qq{校閲} のために MIDI 出力を作り出すことができます。@c
727 しかしながら MIDI に出力されるのは、強弱記号、明示的なテンポ記号、@c
730 @emph{アーティキュレーション} プロジェクトは、@c
731 楽譜の情報をより多く MIDI に組み込もうとしている試みの 1 つです。@c
732 音符に @q{アーティキュレーション} を加えるため、@c
734 縮める長さは音符に付いているアーティキュレーション記号に基づいてが決まります:
735 例えば、スタッカートは音価を半分にし、@c
736 テヌートは音符を演奏時間いっぱい鳴らします。@c
737 さらに、このスクリプトはトリルとターンを理解し、@c
738 モルデントなど他の装飾を理解するよう拡張することができます。
741 @uref{http://@/www@/.nicta@/.com@/.au/@/people/@/chubbp/@/articulate}
746 この機能は理解できるものにしか効果を持ちません:
747 (音符のプロパティの代わりの) テキスト マークアップは無視されます。