4.1.1 システムを設定する

この機能がアクティブな場合、LilyPond は PDF ファイルや SVG ファイルにハイパーリンクを付け加えます。これらのハイパーリンクは ‘URI ヘルパー’や Web ブラウザに送られ、テキスト エディタを開きカーソルを適切な位置に置きます。

この一連の動作を有効にするには、PDF ビューアが LilyPond で提供される lilypond-invoke-editor スクリプトを使ってハイパーリンクを追うように設定変更する必要があります。

プログラム lilypond-invoke-editor は小さな支援プログラムです。これは特別な textedit URI に対してエディタを呼び出し、それ以外に対しては Web ブラウザを呼び出します。このプログラムは環境変数 EDITOR と LYEDITOR を調べて、ユーザの使用しているエディタを呼び出します。LYEDITOR は EDITOR よりも優先されるため、前者を使用することを推奨します。特に、ターミナル上で常用しているエディタとは別に、LilyPond のポイント アンド クリックのためのエディタを指定したい場合には、前者を使用してください。

エディタによって、行位置と列位置を指定してファイルを開くための引数の記法は異なります。ユーザの便宜のために、LilyPond にはいくつかのエディタに対するコマンドが予め登録されており、それは scm/editor.scm にリストアップされています。そのため、単にエディタのバイナリ名を変数に登録すれば動作します。例えば:

export LYEDITOR=atom

は以下を呼び出します:

atom %(file)s:%(line)s:%(column)s

%(file)s, %(line)s, %(column)s はそれぞれファイル名、行、列で置き換えられます。

scm/editor.scm にリストアップされていないエディタを使用するには、LYEDITOR に特定の記法でコマンド全体を登録します。以下は Visual Studio Code を使用する場合の例です:

export LYEDITOR="code --goto %(file)s:%(line)s:%(column)s"