From fcec8015634fd7665b8df57b630994ba4919b12c Mon Sep 17 00:00:00 2001 From: Yoshiki Sawada Date: Thu, 12 Apr 2012 21:20:15 +0900 Subject: [PATCH] Doc-ja: update Doc-ja Doc-ja: update files of Doc-ja. ja/web.texi ja/learning/fundamental.itely ja/usage/running.itely ja/notation/text.itely --- Documentation/ja/learning/fundamental.itely | 90 +-- Documentation/ja/notation/text.itely | 72 +-- Documentation/ja/usage/running.itely | 592 +++++++++++++------- Documentation/ja/web.texi | 2 +- 4 files changed, 469 insertions(+), 287 deletions(-) diff --git a/Documentation/ja/learning/fundamental.itely b/Documentation/ja/learning/fundamental.itely index 7d9a6b84d9..856c73328d 100644 --- a/Documentation/ja/learning/fundamental.itely +++ b/Documentation/ja/learning/fundamental.itely @@ -1,7 +1,7 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: ja -*- @ignore - Translation of GIT committish: c028761d49ac4820206806dbc58e9704a87b4a8 + Translation of GIT committish: 16ac0db39d8cca1de68ce79154386764172aca10 When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -692,7 +692,6 @@ LilyPond の楽譜の中で最も低レベルで、最も基礎的であり、 今度はもう 1 つ簡単な例を挙げてみます: - @lilypond[quote,verbatim,fragment,ragged-right,relative=2] \key d \minor % Voice "1" Voice "2" @@ -733,8 +732,12 @@ LilyPond の楽譜の中で最も低レベルで、最も基礎的であり、 付け加えることによって、3 つかそれ以上のボイスを持たせることが可能です。 ボイス コンテキストは @code{"1"}, @code{"2"} などの名前を持ちます。@c -各コンテキストの中では、スラー、符幹、タイ、強弱記号などの@c -垂直方向の向きは適切にセットされます。 +最初の 2 つのコンテキストは @emph{外側} のボイスをセットして、@c +上のボイスはコンテキスト @code{"1"}、下のボイスはコンテキスト @code{"2"} +になります。@c +内側のボイスはコンテキスト @code{"3"} と @code{"4"} になります。@c +これらの各コンテキストでは、スラー、符幹、タイ、強弱記号などの垂直方向の@c +向きは適切にセットされます。 @lilypond[quote,verbatim,fragment] \new Staff \relative c' { @@ -856,16 +859,19 @@ LilyPond の楽譜の中で最も低レベルで、最も基礎的であり、 << % Voice one { c2 aes4. bes8 } \\ % Voice two - { aes2 f4 fes } - \\ % No voice three - \\ % Voice four { % Ignore these for now - they are explained in Ch 4 - \once \override NoteColumn #'force-hshift = #0 - 2 + \once \override NoteColumn #'ignore-collision = ##t + 2 \once \override NoteColumn #'force-hshift = #0.5 des2 } + \\ % No voice three + \\ % Voice four + { + \override NoteColumn #'force-hshift = #0 + aes'2 f4 fes + } >> | 1 | } @@ -903,16 +909,17 @@ A フラットは付点 4 分音符であり、F は 4 分音符、D フラッ } \\ % Voice two { \voiceTwoStyle - aes2 f4 fes + % Ignore these for now - they are explained in Ch 4 + \once \override NoteColumn #'ignore-collision = ##t + 2 + \once \override NoteColumn #'force-hshift = #0.5 + des2 } \\ % No Voice three (we want stems down) \\ % Voice four { \voiceThreeStyle - % Ignore these for now - they are explained in Ch 4 - \once \override NoteColumn #'force-hshift = #0 - 2 - \once \override NoteColumn #'force-hshift = #0.5 - des2 + \override NoteColumn #'force-hshift = #0 + aes'2 f4 fes } >> | 1 | @@ -930,7 +937,7 @@ A フラットは付点 4 分音符であり、F は 4 分音符、D フラッ \new Staff \relative c'' { \key aes \major << - { c2 aes4. bes8 } \\ { aes2 f4 fes } \\ { 2 des2 } + { c2 aes4. bes8 } \\ { 2 des } \\ { aes'2 f4 fes } >> 1 } @@ -954,10 +961,10 @@ A フラットは付点 4 分音符であり、F は 4 分音符、D フラッ << % Voice one { c2 aes4. bes8 } \\ % Voice two - { aes2 f4 fes } + { 2 des } \\ % Omit Voice three \\ % Voice four - { 2 des2 } + { aes'2 f4 fes } >> | 1 | } @@ -965,22 +972,19 @@ A フラットは付点 4 分音符であり、F は 4 分音符、D フラッ @noindent これにより符幹の向きが修正されました。@c -しかしながら、@c -複数のボイスを持つ場合にしばしば発生する問題に遭遇してしまいました --- あるボイスの中にある音符の符幹が他のボイスの中にある符頭と衝突しています。@c -音符をレイアウトするときに、LilyPond は 2 つのボイスの符幹の向きを@c -反対にすることによって 2 つのボイスの音符や和音が@c -同じ垂直方向の音符列に位置することを可能にします。@c -しかしながら、3 番目や 4 番目のボイスは符頭の衝突を避けるために@c -必要があれば移動させられます。@c -これは普通はうまくいきますが、この例では一番下のボイスの音符は@c -デフォルトの状態では明らかにうまくいっていません。@c -LilyPond は音符の水平方向位置を調節するためにいくつかの手段を提供します。@c -我々はまだこの問題を修正するための方法を見ていく準備が整っていないので、@c -この問題は後に残しておくことにします --- @ref{表記の重なりを修正する} の @code{force-hshift} プロパティを@c -参照してください。 +しかしながら、音符の水平方向の配置が望んだとおりになっていません。@c +内側の音符の符頭や符幹が外側のボイスと衝突する場合 LilyPond は内側の@c +音符の位置をずらしますが、これはピアノ譜では不適切です。@c +他の状況でも、LilyPond が音符の位置をずらしても衝突が解決されない場合が@c +あります。@c +LilyPond は音符の水平方向の位置を調節するための手段をいくつか提供します。@c +しかしながら、我々はまだこの問題を修正するための方法を見ていく準備が@c +整っていないので、この問題は後に残しておくことにします +-- @ref{Fixing overlapping notation} の @code{force-hshift} プロパティ@c +を参照してください。 +@warning{歌詞、スパナ (スラー、タイ、強弱のヘアピン記号など) をボイスを@c +@q{またいで} 作成することはできません。} @seealso 記譜法リファレンス: @@ -1007,7 +1011,7 @@ LilyPond は音符の水平方向位置を調節するためにいくつかの 多声部音楽を作成するためにボイス コンテキストを手動で @code{<< >>} ブロックの中に作成することもできます。@c 符幹、スラーなどの向きを示すために -@code{\voiceOne} ... @code{\voiceFour} を使用します。@c +@code{\voiceOne} @dots{} @code{\voiceFour} を使用します。@c この手法は各ボイスを別々にして、より記述的な名前を与えることを可能にするため、@c 長い楽譜ではわかりやすいものになります。 @@ -1846,11 +1850,11 @@ LilyPond 入力ファイルに対する特別なサポートを持つ@c @lilypond[quote,verbatim,ragged-right] << \new Staff \relative c'' { - ais2 aes + aeses2 aes } \new Staff \relative c'' { \set Staff.extraNatural = ##f - ais2 aes + aeses2 aes } >> @end lilypond @@ -1861,11 +1865,11 @@ LilyPond 入力ファイルに対する特別なサポートを持つ@c @lilypond[quote,verbatim,ragged-right] << \new Staff \relative c'' { - ais2 aes + aeses2 aes } \new Staff \relative c'' { \set Score.extraNatural = ##f - ais2 aes + aeses2 aes } >> @end lilypond @@ -1939,12 +1943,12 @@ like this: << \new Staff { \relative c'' { - gis4 ges aes ais + gisis4 gis aeses aes } } \new Staff \with { extraNatural = ##f } { \relative c'' { - gis4 ges aes ais + gisis4 gis aeses aes } } >> @@ -1990,7 +1994,7 @@ like this: \score { \new Staff { \relative c'' { - cis4 e d ces + cisis4 e d cis } } \layout { @@ -2009,12 +2013,12 @@ like this: << \new Staff { \relative c'' { - gis4 ges aes ais + gisis4 gis aeses aes } } \new Staff { \relative c'' { - gis4 ges aes ais + gisis4 gis aeses aes } } >> diff --git a/Documentation/ja/notation/text.itely b/Documentation/ja/notation/text.itely index 16e2809821..d214c2920b 100644 --- a/Documentation/ja/notation/text.itely +++ b/Documentation/ja/notation/text.itely @@ -1,6 +1,7 @@ -@c -*- coding: utf-8; mode: texinfo; -*- +@c -*- coding: utf-8; mode: texinfo; documentlanguage: ja -*- + @ignore - Translation of GIT committish: ebe492ca408fb0d9abf80b94c56197eef8dc2f09 + Translation of GIT committish: 16ac0db39d8cca1de68ce79154386764172aca10 When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -115,7 +116,6 @@ a4_"scherzando" f 学習マニュアル: @rlearning{オブジェクトの配置} - 記譜法リファレンス: @ref{テキストをフォーマットする}, @ref{Direction and placement}, @@ -127,13 +127,11 @@ a4_"scherzando" f 内部リファレンス: @rinternals{TextScript} - @cindex text outside margin (マージンからはみ出すテキスト) @cindex margin, text running over (マージンからはみ出すテキスト) @cindex text, keeping inside margin (テキストをマージン内に収める) @cindex lyrics, keeping inside margin (歌詞をマージン内に収める) - @knownissues テキスト スクリプトと歌詞がマージンに収まることを保証するためのチェックは@c 計算量を増やします。@c @@ -206,7 +204,6 @@ LilyPond が処理できるテキスト スパナは 1 ボイスにつき、1 @lilypondfile[verbatim,quote,texidoc,doctitle] {dynamics-custom-text-spanner-postfix.ly} - @seealso 記譜法リファレンス: @ref{Line styles}, @@ -301,7 +298,6 @@ c c @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle] {printing-marks-on-every-staff.ly} - @seealso 記譜法リファレンス: @ref{リハーサル記号}, @@ -378,7 +374,6 @@ c c @code{\markuplist} @endpredefined - @snippets @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle] @@ -507,22 +502,19 @@ allegro = \markup { \bold \large Allegro } } @end lilypond - @noindent @ref{Text markup commands} に @code{\markup} 特有のコマンドの徹底したリストがあります。 - @seealso 記譜法リファレンス: @ref{Text markup commands} -コード断片集: -@rlsr{Text} - インストールされているファイル: @file{scm/markup.scm} +コード断片集: +@rlsr{Text} @knownissues マークアップ モードの構文エラーは混乱しやすいです。 @@ -693,7 +685,6 @@ d c2 r8 c bes a g1 @funindex \larger @funindex larger - @predefined @code{\teeny}, @code{\tiny}, @@ -705,7 +696,6 @@ d c2 r8 c bes a g1 @code{\larger} @endpredefined - @seealso 記譜法リファレンス: @ref{フォント}, @@ -713,15 +703,15 @@ d c2 r8 c bes a g1 @ref{手動の繰り返し記号}, @ref{フォント} +インストールされているファイル: +@file{scm/define-markup-commands.scm} + コード断片集: @rlsr{Text} 内部リファレンス: @rinternals{TextScript} -インストールされているファイル: -@file{scm/define-markup-commands.scm} - @knownissues フォントのサイズ コマンド @code{\teeny}, @code{\tiny}, @code{\small}, @code{\normalsize}, @code{\large} それに @code{\huge} を用いると、@c @@ -971,7 +961,6 @@ a'4 a g2 a @ref{Align} にテキスト揃えコマンドの徹底したリストがあります。 - @seealso 学習マニュアル: @rlearning{オブジェクトを移動させる} @@ -980,15 +969,15 @@ a'4 a g2 a @ref{Align}, @ref{テキスト マーク} +インストールされているファイル: +@file{scm/define-markup-commands.scm}. + コード断片集: @rlsr{Text} 内部リファレンス: @rinternals{TextScript} -インストールされているファイル: -@file{scm/define-markup-commands.scm}. - @node マークアップ内部でのグラフィック記譜法 @unnumberedsubsubsec マークアップ内部でのグラフィック記譜法 @@ -1160,23 +1149,22 @@ c @ref{Graphic} にグラフィック特有のコマンドの徹底したリストがあります。 - @seealso 記譜法リファレンス: @ref{Graphic}, @ref{編集者の注釈}, @ref{Align} +インストールされているファイル: +@file{scm/define-markup-commands.scm}, +@file{scm/stencil.scm} + コード断片集: @rlsr{Text} 内部リファレンス: @rinternals{TextScript} -インストールされているファイル: -@file{scm/define-markup-commands.scm}, -@file{scm/stencil.scm} - @node マークアップ内部での音楽記譜法 @unnumberedsubsubsec マークアップ内部での音楽記譜法 @@ -1295,24 +1283,23 @@ c d e f @ref{Music} に、音楽記譜法関連のコマンドの徹底したリストがあります。 - @seealso 記譜法リファレンス: @ref{Music}, @ref{The Feta font}, @ref{フォントの説明} +インストールされているファイル: +@file{scm/define-markup-commands.scm}, +@file{scm/fret-diagrams.scm}, +@file{scm/harp-pedals.scm} + コード断片集: @rlsr{Text} 内部リファレンス: @rinternals{TextScript} -インストールされているファイル: -@file{scm/define-markup-commands.scm}, -@file{scm/fret-diagrams.scm}, -@file{scm/harp-pedals.scm}. - @node 複数ページにわたるマークアップ @unnumberedsubsubsec 複数ページにわたるマークアップ @@ -1363,23 +1350,22 @@ c d e f @ref{Text markup list commands} に、@c マークアップ リスト コマンドの徹底したリストがあります。 - @seealso 記譜法リファレンス: -@ref{Text markup list commands}, - -コード断片集: -@rlsr{Text} +@ref{Text markup list commands} 拡張: @rextend{New markup list command definition} +インストールされているファイル: +@file{scm/define-markup-commands.scm} + +コード断片集: +@rlsr{Text} + 内部リファレンス: @rinternals{TextScript} -インストールされているファイル: -@file{scm/define-markup-commands.scm}. - @funindex \markuplist @funindex markuplist @@ -1387,7 +1373,6 @@ c d e f @code{\markuplist} @endpredefined - @node フォント @subsection フォント @translationof Fonts @@ -1506,7 +1491,6 @@ c4^smaller 他のフォントを使用する方法は以下のセクションで説明されています: @ref{個々に登録するフォント} と @ref{ドキュメント全体のフォント}。 - @seealso 記譜法リファレンス: @ref{The Feta font}, @@ -1550,7 +1534,6 @@ a1_\markup { lilypond -dshow-available-fonts x @end example - @seealso 記譜法リファレンス: @ref{フォントの説明}, @@ -1599,7 +1582,6 @@ lilypond -dshow-available-fonts x @c we don't do Helvetica / Courier, since GS incorrectly loads @c Apple TTF fonts - @seealso 記譜法リファレンス: @ref{フォントの説明}, diff --git a/Documentation/ja/usage/running.itely b/Documentation/ja/usage/running.itely index 7aea11c673..cebabf4fc6 100644 --- a/Documentation/ja/usage/running.itely +++ b/Documentation/ja/usage/running.itely @@ -1,7 +1,7 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: ja -*- @ignore - Translation of GIT committish: f66e6785e42f181199f6cf357434f60baba1e149 + Translation of GIT committish: 7465f4b1291f38bed8ee81e3922eb685f7e909ad When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -60,7 +60,8 @@ OS のコマンド ラインの使用方法についての説明は@c @menu * lilypond を呼び出す:: -* lilypond のコマンド ライン オプション:: +* LilyPond の基本的なコマンド ライン オプション:: +* LilyPond の高度なコマンド ライン オプション:: * 環境変数:: * chroot jail 環境で LilyPond を実行する:: @end menu @@ -130,9 +131,9 @@ lilypond は出力として @file{filename.ps} と @file{filename.pdf} を作り これらはシェル コマンドであり、lilypond とは無関係です。 -@node lilypond のコマンド ライン オプション -@unnumberedsubsec @command{lilypond} のコマンド ライン オプション -@translationof Command line options for lilypond +@node LilyPond の基本的なコマンド ライン オプション +@unnumberedsubsec @command{lilypond} の基本的なコマンド ライン オプション +@translationof Basic command line options for LilyPond @cindex Invoking @command{lilypond} (@command{lilypond} を呼び出す) @cindex command line options for @command{lilypond} (@command{lilypond} のためのコマンド ライン オプション) @@ -144,183 +145,7 @@ lilypond は出力として @file{filename.ps} と @file{filename.pdf} を作り @table @code @item -d,--define-default=@var{var}=@var{val} -これは内部プログラム オプション @var{var} に -Scheme 値 @var{val} をセットします。@c -@var{val} が提供されていない場合、@var{#t} が使用されます。@c -オプションを OFF にするには、@var{var} の接頭辞として @code{no-} を付けます。@c -つまり、 - -@cindex point and click, command line (コマンド ラインからポイント&クリックを制御する) - -@example --dno-point-and-click -@end example - -@noindent -は -@example --dpoint-and-click=#f -@end example -と同じです。 - -以下のオプションがサポートされます: - -@cindex help, command line (コマンド ライン ヘルプ) - -@table @code -@item help -@code{lilypond -dhelp} を実行すると@c -使用可能な @option{-d} オプションがすべて表示されます。 - -@cindex paper-size, command line (コマンド ラインで paper-size を指定する) - -@item paper-size -このオプションはデフォルトの用紙サイズをセットします。 -@example --dpaper-size=\"letter\" -@end example - -@noindent -文字列はエスケーブされたクォート ( @code{\"} ) で@c -囲まれていなければならないということに注意してください。 -@c Match " in previous line to help context-sensitive editors - -@item safe -@code{.ly} 入力を信用してはいけません。 - -Web サーバを通じて LilyPond フォーマットが利用可能な場合、@c -@option{--safe} オプションか @option{--jail} オプションの@c -どちらかを @b{渡さなければなりません}。@c -@option{--safe} オプションは@c -以下のようなインライン Scheme コードが大混乱をもたらすことを防ぎます: - -@quotation -@verbatim -#(system "rm -rf /") -{ - c4^$(ly:gulp-file "/etc/passwd") -} -@end verbatim -@end quotation - -訳者: #(system "rm -rf /") はルート ディレクトリ以下を削除し、@c -export (ly:gulp-file "/etc/passwd") はパスワード ファイルをエクスポートします。 - -@option{-dsafe} オプションはインライン Scheme 表記を@c -特別なセーフ モジュールの中で評価します。@c -このセーフ モジュールは GUILE @file{safe-r5rs} モジュールから派生したものですが、@c -LilyPond API 関数をいくつか追加しています。@c -これらの関数は @file{scm/safe-lily.scm} でリスト アップされています。 - -さらに、セーフ モードは @code{\include} 指示を却下し、@c -@TeX{} 文字列の中にあるバックスラッシュを無効にします。 - -セーフ モードでは、LilyPond 変数を Scheme にインポートすることはできません。 - -@option{-dsafe} はリソースの乱用を検出 @emph{しません}。@c -例えば循環データ構造体をバックエンドに食わせることで、@c -プログラムをハングさせることは可能です。@c -そのため、パブリックにアクセス可能な Web サーバ上で LilyPond を使用する場合、@c -そのプロセスの CPU とメモリの両方の使用は制限されるべきです。 - -セーフ モードは多くの有用な LilyPond 断片がコンパイルされることを妨げます。@c -@option{--jail} はより安全な代替オプションですが、@c -セット アップにより多くの作業を必要とします。 - -@cindex output format, setting (出力フォーマットを設定する) - -@item backend -バックエンドに対して使用する出力フォーマットを指定します。@c -@code{format} の選択肢には以下があります: - -@table @code -@item ps - -@cindex PostScript output (PostScript 出力) -PostScript - -Postscript ファイルは TTF, Type1, それに OTF フォントを含んでいます。@c -これらのフォントのサブセット化 -(訳者: フォント セットを使用するフォントに限定すること) は行われません。@c -東洋の文字セットを使用する場合、巨大なファイルになる可能性があります。 - -@item eps - -@cindex Postscript, encapsulated (EPS) -@cindex EPS (Encapsulated PostScript) (EPS) - -縮約された PostScript (EPS)。@c -これは各ページ (システム) を@c -フォントを持たない個別の @file{EPS} ファイルとして吐き出し、@c -フォントを含めたすべてのページ (システム) を持つ -@file{EPS} ファイルを 1 つ吐き出します。 - -このモードは @command{lilypond-book} でデフォルトで使用されます。 - -@item svg - -@cindex SVG (Scalable Vector Graphics) - -SVG (Scalable Vector Graphics)。@c -これは各ページを埋め込みフォントをフォントを持たない個別の -@file{SVG} ファイルとして吐き出します。@c -最適な描画を得るために、LilyPond インストールに含まれている -Century Schoolbook フォントをインストールすることをお勧めします。@c -UNIX では、単に LilyPond ディレクトリ -(一般には @file{/usr/share/lilypond/VERSION/fonts/otf/}) から -@file{~/.fonts/} にコピーするだけです。@c -SVG 出力は SVG エディタやユーザ エージョントと互換性があります。 - -@item scm - -@cindex Scheme dump (Scheme ダンプ) -@cindex output, Scheme dump (Scheme ダンプ出力) - -生データ -- 内部 Scheme ベース描画コマンド -- を吐き出します。 - -@item null -譜刻された楽譜を出力しません。@c -@option{-dno-print-pages} と同じ効果を持ちます。 - -@end table - -例: @code{lilypond -dbackend=svg @var{filename}.ly} - -@item preview - -@cindex preview, command line (コマンド ライン プレビュー) - -このオプションはすべてのバックエンド --- @code{scm} を除く @code{pdf}, @code{png}, +@code{ps}, @code{eps}, -それに @code{svg} -- -でサポートされます。@c -生成される出力は @code{ファイル名.preview.拡張子} という形式のファイル名で、@c -タイトルと楽譜の最初の段を保持します。@c -@code{\book} ブロックまたは @code{\bookpart} ブロックが使われている場合、@c -出力には各 @code{\book} または @code{\bookpart} のタイトルが譜刻され、@c -@code{\paper} の変数 @code{print-all-headers} が @code{#t} に@c -セットされている場合は各 @code{\score} ブロックの最初の段も譜刻されます。 - -通常の出力を抑制するには、必要に応じて @option{-dprint-pages} または -@option{-dno-print-pages} オプションを使用してください。 - -@item gui -コマンド ラインに何も出力せず、@c -すべての出力をログ ファイルにリダイレクトします。 -+ -Windows ユーザへの注意: デフォルトで、@code{lilypond.exe} は@c -すべての進捗情報をコマンド ウィンドウに出力しますが、@c -@code{lilypond-windows.exe} は出力しません。@c -出力をログ ファイルにリダイレクトさせるには、@c -@option{-dgui} オプションをを使います。 - -@item print-pages - -すべてのページを生成します。@c -デフォルトです。@option{-dno-print-pages} は -@option{-dpreview} と組み合わせて使うと有用です。 - -@end table +@ref{Advanced command line options for LilyPond} を参照してください。 @cindex Scheme, expression evaluation (Scheme 表記の評価) @cindex expression evaluation, Scheme (Scheme 表記の評価) @@ -368,7 +193,7 @@ init ファイルとして @var{file} をセットします (デフォルト: @f @cindex file searching (ファイル サーチ) @cindex search path (サーチ パス) -@item --include, -I=@var{directory} +@item -I, --include=@var{directory} @var{directory} を入力ファイルのサーチ パスに追加します。 複数の -I オプションを与えることができます。@c @@ -383,21 +208,21 @@ init ファイルとして @var{file} をセットします (デフォルト: @f カレント プロセスに対してルート ディレクトリの位置を変更すること。) @option{--jail} オプションは、@c -Web サーバを通じての LilyPond 譜刻を提供する時や -LilyPond が外部から提供されたソースを実行する時に、@c -@code{--safe} よりも自由度の高い代替手段を提供します。 +Web サーバ経由で LilyPond 譜刻を提供する時や +LilyPond が外部ソースから送られてきたコマンドを実行する時に、@c +@code{--dsafe} よりも自由度の高い代替手段を提供します。 @code{--jail} オプションはコンパイル プロセスの開始直前に -@command{lilypond} の ルートを @var{jail} に変更します。@c -それからユーザとグループを提供された環境にマッチするように変更し、@c -カレント ディレクトリは @var{dir} に変更されます。@c -このセットアップは jail (牢獄) から抜け出せないということを -(少なくとも理論的には) 保証します。@c -@code{--jail} を指定した @command{lilypond} の実行は@c -root (ユーザ名) として行われる必要があります。@c -通常、これは @command{sudo} を用いた安全な方法で行われます。 - -jail のセットアップは少々デリケートな問題です。@c +@command{lilypond} のルート ディレクトリを @var{jail} に変更します。@c +それから、ユーザとグループを @var{user} と @var{group} に変更して、@c +カレント ディレクトリを @var{dir} に変更します。@c +これにより、jail (牢獄) から抜け出せないことを (少なくとも理論上は) +保証します。@c +@code{--jail} を指定した @command{lilypond} の実行は root (ユーザ名) +として行う必要があります。@c +通常、これは @command{sudo} を用いた安全な方法で行います。 + +jail のセットアップは比較的複雑な問題です。@c LilyPond がソースをコンパイルするのに必要とされるものすべてを @emph{jail の内部} で見つけられるということを保証しなければならないからです。@c 一般的なセットアップには以下の項目が含まれます: @@ -444,9 +269,10 @@ jail モードでの LilyPond の実行はスーパーユーザ権限で行わ (もちろん、その権限はすぐに外されます)、@c たぶん @command{sudo} を使います。@c LilyPond が使用可能な CPU 時間を数秒に制限する -(例えば、@command{ulimit -t} を使って) というのは良いアイディアです。@c +(例えば、@command{ulimit -t} を使って) というのも良い方法です。@c さらに、OS がサポートしているのなら、@c -割り当て可能なメモリ容量を制限するというのも良いアイディアです。 +割り当て可能なメモリ容量を制限するというのも良い方法です。@c +@ref{LilyPond in chroot jail} も参照してください。 @end table @cindex loglevel (ログレベル) @@ -492,6 +318,10 @@ LilyPond が使用可能な CPU 時間を数秒に制限する 適切な接尾辞が追加されます (つまり、pdf ならば拡張子 @code{.pdf} が追加されます)。 +@cindex PS (Postscript), output (PS (PostScript) 出力) +@cindex Postscript (PS), output (PostScript (PS) 出力) +@cindex output, PS (Postscript) (PS (PostScript) 出力) + @item --ps PostScript を生成します。 @@ -523,9 +353,375 @@ PDF を生成します。@c @item -w,--warranty GNU LilyPond の保証責任を表示します。@c (GNU LilyPond には@strong{保証責任はありません}!) + @end table +@node LilyPond の高度なコマンド ライン オプション +@unnumberedsubsec LilyPond の高度なコマンド ライン オプション +@translationof Advanced command line options for LilyPond + +@table @code + +@item -d@var{[option-name]}=@var{[value]},--define-default=@var{[option-name]}=@var{[value]} +これは相当する内部 Scheme 関数に @var{value} をセットします。@c +@var{value} が提供されない場合、デフォルト値が使われます。@c +@var{option-name} に接頭辞 @code{no-} を付けてオプションを @q{off} に@c +することができます。例えば、 + +@cindex point and click, command line (コマンド ラインでポイント&クリックを指定する) + +@example +-dpoint-and-click=#f +@end example + +@noindent +は +@example +-dno-point-and-click +@end example +と同じです。 +@end table + +@noindent 以下にサポートされるオプションをデフォルト値とともに示します: + +@multitable @columnfractions .33 .16 .51 +@item @strong{シンボル} +@tab @strong{値} +@tab @strong{説明/オプション} + +@item @code{anti-alias-factor} +@tab @code{1} +@tab (与えられた因数を用いて) 高解像度で描画して、その結果をスケール +ダウンすることにより、@code{PNG} 画像の輪郭がギザギザになることを防ぎます。 + +@item @code{aux-files} +@tab @code{#t} +@tab @code{EPS} バックエンドの中に @code{.tex}, @code{.texi}, +@code{.count} ファイルを作成します。 + +@item @code{backend} +@tab @code{'ps} +@tab バックエンドを選択します。Postscript ファイル (デフォルト) は@c +@code{TTF}, @code{Type1}, それに @code{OTF} フォントを内包します。@c +フォントのサブセットは作成されません。@c +@q{東洋} の文字セットを用いるとファイルが非常に大きくなる可能性があります。 + +@item +@tab @code{'eps} +@tab Encapsulated PostScript。これはフォントを持たないページ (段) 毎の +@file{EPS} ファイルと、フォントを内包するすべてのページ (段) を 1 つに@c +まとめた @file{EPS} ファイルを吐き出します。@c +@command{lilypond-book} はデフォルトでこのオプションを使用します。 + +@item +@tab @code{'null} +@tab 楽譜を出力しません。@code{-dno-print-pages} と同じ効果を持ちます。 + +@item +@tab @code{'svg} +@tab Scalable Vector Graphics。これはページ毎に埋め込みフォントを持たない +@code{SVG} ファイルを作成します。@c +最適な描画を得るために、Century Schoolbook フォントをインストールすること@c +を推奨します。このフォントは LilyPond のインストールに含まれています。@c +UNIX では、このフォントを LilyPond ディレクトリ (通常は、 +@file{/usr/share/lilypond/VERSION/fonts/otf/}) から @file{~/.fonts/} に@c +コピーするだけです。この @code{SVG} 出力は任意の SVG エディタやユーザ +エージェントと互換性があります。@c +SVG バックエンドの中で woff フォント ファイルを使うためのオプション +@code{svg-woff} (この表の下にあります) もあります。 + +@item +@tab @code{'scm} +@tab 内部的な Scheme ベースの描画コマンドを吐き出します。 + +@c 未訳 +@item @code{check-internal-types} +@tab @code{#f} +@tab Check every property assignment for types. + +@item @code{clip-systems} +@tab @code{#f} +@tab Generate cut-out snippets of a score. + +@item @code{datadir} +@tab +@tab Prefix for data files (read-only). + +@item @code{debug-gc} +@tab @code{#f} +@tab Dump memory debugging statistics. + +@item @code{debug-gc-assert-parsed-dead} +@tab @code{#f} +@tab For memory debugging: Ensure that all references to parsed objects +are dead. This is an internal option, and is switched on automatically +for @code{`-ddebug-gc'}. + +@item @code{debug-lexer} +@tab @code{#f} +@tab Debug the flex lexer. + +@item @code{debug-page-breaking-scoring} +@tab @code{#f} +@tab Dump scores for many different page breaking configurations. + +@item @code{debug-parser} +@tab @code{#f} +@tab Debug the bison parser. + +@item @code{debug-property-callbacks} +@tab @code{#f} +@tab Debug cyclic callback chains. + +@item @code{debug-skylines} +@tab @code{#f} +@tab Debug skylines. + +@item @code{delete-intermediate-files} +@tab @code{#t} +@tab コンパイルの途中で作成される使用しない中間ファイル @code{.ps} を@c +削除します。 + +@item @code{dump-cpu-profile} +@tab @code{#f} +@tab CPU 時間情報を吐き出します (システムに依存します)。 + +@item @code{dump-profile} +@tab @code{#f} +@tab 各ファイルのメモリと CPU 時間情報を吐き出します。 + +@c 未訳 +@item @code{dump-signatures} +@tab @code{#f} +@tab Dump output signatures of each system. Used for regression testing. + +@item @code{eps-box-padding} +@tab @code{#f} +@tab 出力される EPS の左端に与えられた数の余白を追加します +(単位は mm です)。 + +@item @code{gs-load-fonts} +@tab @code{#f} +@tab Ghostscript 経由でフォントを読み込みます。 + +@item @code{gs-load-lily-fonts} +@tab @code{#f} +@tab Ghostscript 経由でフォントだけを読み込みます。 + +@item @code{gui} +@tab @code{#f} +@tab 出力を表示せずに処理を行い、すべての出力をログ ファイルに@c +リダイレクトします。 +@end multitable + +@noindent +@strong{Windows ユーザへの注意:} @code{lilypond.exe} がデフォルトで@c +すべての進捗情報をコマンド ウィンドウに出力するのに対して、@c +@code{lilypond-windows.exe} は進捗情報を出力しません。@c +@option{-dgui} オプションを用いることで、出力をログ ファイルに@c +リダイレクトさせることができます。 + +@multitable @columnfractions .33 .16 .51 +@item @code{help} +@tab @code{#f} +@tab このヘルプを表示します。 + +@item @code{include-book-title-preview} +@tab @code{#t} +@tab プレビュー画像にブック タイトルを含めます。 + +@item @code{include-eps-fonts} +@tab @code{#t} +@tab システム毎の EPS ファイルにフォントを含めます。 + +@item @code{include-settings} +@tab @code{#f} +@tab グローバル設定のファイルをインクルードします。このファイルは楽譜の@c +処理が開始する前にインクルードされます。 + +@item @code{job-count} +@tab @code{#f} +@tab 与えられた数のジョブで、並行して処理します。 + +@item @code{log-file} +@tab @code{#f [file]} +@tab 2 番目の引数として文字列 @code{FOO} が与えられた場合、出力を@c +ログ ファイル @code{FOO} にリダイレクトします。 + +@item @code{max-markup-depth} +@tab @code{1024} +@tab マークアップ ツリーの階層の最大値です。それよりも深い階層を持つ@c +マーックアップがある場合、そのマークアップは終了していないと見なされて、@c +警告が表示され、null マークアップが返されます。 + +@item @code{midi-extension} +@tab @code{"midi"} +@tab MIDI 出力ファイルのデフォルトのファイル拡張子を与えられた文字列に@c +設定します。 + +@c 未訳 +@item @code{music-strings-to-paths} +@tab @code{#f} +@tab Convert text strings to paths when glyphs belong to a music font. + +@item @code{old-relative} +@tab @code{#f} +@tab 同時進行する音楽のための @code{\relative} モードを和音構文と同じように@c +機能させます。 + +@item @code{paper-size} +@tab @code{\"a4\"} +@tab デフォルトの紙面サイズを設定します。文字列をエスケープ記号付の 2 重@c +引用符 @code{\"} で囲む必要があることに注意してください。 + +@item @code{pixmap-format} +@tab @code{png16m} +@tab 画像出力のための GhostScript の出力フォーマットを設定します。 + +@item @code{point-and-click} +@tab @code{#f} +@tab @code{PDF} 出力に @q{ポイント&クリック} リンクを付け加えます。@c +@ref{Point and click} を参照してください。 + +@item @code{preview} +@tab @code{#f} +@tab 通常の出力に加えてプレビュー画像を作成します。 +@end multitable + +@noindent +このオプションはすべてのバックエンド +-- @code{pdf}, @code{png}, @code{ps}, @code{eps}, それに @code{svg} -- +でサポートされますが、@code{scm} ではサポートされません。@c +このオプションはタイトルと楽譜の最初の段を保持するファイル +-- @code{myFile.preview.extension} という形式のファイル名を持ちます -- +を出力します。@c +@code{\book} ブロックや @code{\bookpart} ブロックが使われている場合、@c +@code{\book}, @code{\bookpart}, それに @code{\score} のタイトルが出力@c +に譜刻され、@code{\paper} 変数 @code{print-all-headers} が @code{#t} に@c +セットされている場合は各 @code{\score} ブロックの最初の段も譜刻されます。 + +通常の出力を抑制するには、必要に応じて @option{-dprint-pages} オプション@c +または @option{-dno-print-pages} オプションを使ってください。 + +@multitable @columnfractions .33 .16 .51 +@item @code{print-pages} +@tab @code{#t} +@tab すべてのページを生成します。これがデフォルトです。@option{-dpreview} +を使う場合は @option{-dno-print-pages} を組み合わせると有用です。 + +@item @code{profile-property-accesses} +@tab @code{#f} +@tab @code{get_property()} 関数呼び出しの統計を取ります。 + +@item @code{protected-scheme-parsing} +@tab @code{#t} +@tab パーサでインライン Scheme のエラーが発生しても処理を続けます。@c +@code{#f} に設定されている場合、エラー終了して、スタック トレースを表示@c +します。 + +@item @code{read-file-list} +@tab @code{#f [file]} +@tab 処理する入力ファイルのリストを保持するファイルを指定します。 + +@item @code{relative-includes} +@tab @code{#f} +@tab @code{\include} コマンドを処理するとき、インクルードするファイルを@c +(ルート ファイルからではなく) カレント ファイルからの相対位置で検索します。 + +@item @code{resolution} +@tab @code{101} +@tab 生成する @code{PNG} 画像の解像度を与えられた値に設定します。@c +単位は dpi です。 + +@item @code{safe} +@tab @code{#f} +@tab @code{.ly} 入力ファイルを信用しません。 +@end multitable + +@noindent +Web サーバ経由で LilyPond 譜刻が利用可能な場合、@option{--safe} +オプションか @option{--jail} オプションのどちらかを +@b{指定する必要があります}。@c +@option{--safe} オプションはインライン Scheme コードが無茶をする +-- 例えば、以下のような -- ことを防ぎます。 + +@quotation +@verbatim +#(system "rm -rf /") +{ + c4^$(ly:gulp-file "/etc/passwd") +} +@end verbatim +@end quotation + +@option{-dsafe} オプションはインライン Scheme 表記を特別なセーフ +モジュールの中で評価します。@c +これは GUILE @file{safe-r5rs} モジュールに由来しますが、@c +@file{scm/safe-lily.scm} でリスト アップされている LilyPond API 関数の@c +いくつかも追加されています。 + +さらに、セーフ モードでは @code{\include} は許可されず、@TeX{} 文字列の@c +中でバックスラッシュを使うこともできません。@c +また、セーフ モードでは LilyPond 変数を Scheme にインポートすることも@c +できません。 + +@option{-dsafe} はリソースの過使用を検出 @emph{しません} ので、@c +このオプションを指定してもプログラムをハングさせられる可能性があります +-- 例えば、サイクリック (巡回) データ構造をバックエンドに埋め込むことに@c +よってです。 +そのため、LilyPond を一般公開する Web サーバで使用する場合、プロセスの@c +CPU とメモリ使用を制限すべきです。 + +セーフ モードは多くの有用な LilyPond 楽譜断片がコンパイルすることを@c +妨げます。 + +@option{--jail} はさらに安全な代替手段ですが、セットアップにかかる手間も@c +増えます。@ref{Basic command line options for LilyPond} を参照してください。 + +@multitable @columnfractions .33 .16 .51 +@item @code{separate-log-files} +@tab @code{#f} +@tab 入力ファイル @code{FILE1.ly}, @code{FILE2.ly}, ... に対するログ +データをファイル @code{FILE1.log}, @code{FILE2.log}, ... に出力します。 + +@item @code{show-available-fonts} +@tab @code{#f} +@tab 使用可能なフォント名をリスト アップします。 + +@item @code{strict-infinity-checking} +@tab @code{#f} +@tab 浮動小数点の例外 @code{Inf} と @code{NaN} に遭遇した時、@c +強制終了します。 + +@item @code{strip-output-dir} +@tab @code{#t} +@tab 出力ファイル名を構築する時に入力ファイルのディレクトリを使用@c +しません。 + +@item @code{svg-woff} +@tab @code{#f} +@tab SVG バックエンドの中で woff フォントを使用します。 + +@item @code{trace-memory-frequency} +@tab @code{#f} +@tab Scheme セルの 1 秒毎の使用数を記録します。結果を @code{FILE.stacks} +と @code{FILE.graph} に吐き出します。 + +@item @code{trace-scheme-coverage} +@tab @code{#f} +@tab Scheme ファイルの適用範囲を @code{FILE.cov} に記録します。 + +@item @code{verbose} +@tab @code{#f} +@tab 饒舌な出力。つまり、loglevel を DEBUG に設定します。 + +@item @code{warning-as-error} +@tab @code{#f} +@tab すべての警告と @q{プログラミング エラー} をエラーに変更します。 +@end multitable + + @node 環境変数 @unnumberedsubsec 環境変数 @translationof Environment variables diff --git a/Documentation/ja/web.texi b/Documentation/ja/web.texi index 2cee7a7ce2..782a3b4619 100644 --- a/Documentation/ja/web.texi +++ b/Documentation/ja/web.texi @@ -1,6 +1,6 @@ \input texinfo @c -*- coding: utf-8; mode: texinfo; documentlanguage: ja -*- @ignore - Translation of GIT committish: 3ef893f1fe182e9f6cf5841cbff0706789bd3361 + Translation of GIT committish: 16ac0db39d8cca1de68ce79154386764172aca10 When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' -- 2.39.2