Extension:Score/ja

Score 拡張機能は、LilyPond を使用して楽譜を PNG 画像としてレンダリングできるようにします. またそれらを音声ファイルや MIDI ファイルに変換することもできます.

謝辞

 * オリジナルのExtension:LilyPondはJohannes E. Schindelinによって書かれました.
 * この拡張は、Tim StarlingのExtension:LilyPondのコードレビューに基づいています.
 * オリジナルのExtension:ABCはRiver Tarnellによって書かれました.

使用法
設定の後、 タグを使って簡単なLilyPond記法をウィキテキストに埋め込むことができます. 例えば: 変換結果：

一般的な形式でscoreタグに属性を指定することもできます . 例えば: 変換結果： 使用できる属性は次の通りです. 歌詞は次のように追加することができます:

要件
この拡張機能はLilyPondを使用してスコア画像を描画するので、LilyPondをインストールする必要があります. スコアファイルをトリミングする拡張機能が必要な場合は、ImageMagickも必要です.

拡張機能は、LilyPond によって生成された MIDI ファイルから音声ファイルを作成することもできます. この機能を利用するには、Extension:TimedMediaHandlerをインストールする必要があります.

拡張機能のVersion 0.1のテストにはMediaWiki 1.18.0 および LilyPond 2.12.3 を使用しました. current git snapshot には MediaWiki と/または LilyPond の更新版が必要な場合があります.

ダウンロード手順
拡張機能のダウンロードを使用してください. GitHubからダウンロードする場合は、tarball もしくはzipファイル  形式が選べます. GitHubのScoreマスターブランチは安定バージョンのMediaWikiで動作しますが、まだ最新の機能の導入前である可能性があります.

設定
現状ではこの拡張機能に次のようなグローバルな設定パラメータがあります.

$wgScoreLilyPond
のパスを実行可能な LilyPond に設定（通常は または ）.

$wgScoreTrim
というブール値は既定で の値です. の場合、実行結果の score PNG 画像を ImageMagick でトリミング加工できます. それが不要の場合もしくは ImageMagick をインストールしたくない場合、 は に設定します.

$wgScoreAbc2Ly
ABC 記法の のパスを実行可能な LilyPond 変換機能に設定（通常は または ）.

$wgScoreFluidsynth
のパスを実行可能な FluidSynth に設定（通常は または ）.

$wgScoreSoundfont
をSoundFontファイルのパスに設定（通常は または  ）.

$wgScoreTimidity
のパスを実行可能なTiMidity++に設定（通常は または ）. もし がない場合は、TiMidity++ にフォールバックして実行します.

$wgScoreLame
のパスを実行可能なLAMEに設定（通常は または ）. 生成する音声ファイルは必ず MP3 になるという制約があります.

注記
この拡張機能はシェル上で多種のバイナリを実行します. そのためメモリ不足のエラー発生時には、$wgMaxShellMemoryの拡張が必要な場合があります.

楽譜の検索
楽譜を含むページにはページ属性に「score」というセットが備わっています. 楽譜のあるページの検索には特別:プロパティがあるページを使います. (日本語版ウィキペディアでは「プロパティ名:」欄で score を選択して実行. )

関連項目

 * Tim Starlingによるコードレビュー この拡張機能の基盤
 * ヘルプ:楽譜 ウィキソースのヘルプ
 * Help:Sheet music
 * Vexflow オープンソースの SVG/Canvas 楽譜用変換機能

外部リンク

 * LilyPond 記法
 * ABC 記法
 * vexflow github リポジトリ