Extension:Score/ko

Score 확장 기능은 릴리폰드를 사용해서 악보를 PNG 이지지로 렌더링합니다. 또 음성 파일이나 MIDI 파일로 변환할 수도 있습니다.

Acknowledgements

 * 오리지널 Extension:LilyPond는 Johannes E. Schindelin에 의해서 만들어졌습니다.
 * 이 확장은 Tim Starling의 Extension:LilyPond의코드 리뷰를 기초로 하고 있습니다.
 * 오리지널 Extension:ABC는 River Tarnell에 의해서 작성됐습니다.

사용법
설정 후에  태그를 사용해서 간단한 LilyPond 기법을 당신의 위키텍스트로 넣을 수가 있습니다. 예를들면:

yields:

일반적인 형식으로 score 태그에 속성을 지정할 수도 있습니다.

.

예를들면:

yields:

다음 속성을 사용할 수 있습니다.

The LilyPond language
가사는 다음과 같이 추가할 수가 있씁니다:

For advanced users, the command can be used to change the MIDI instrument for the sound.

Prerequisites
The following packages are recommended:


 * LilyPond
 * Ghostscript
 * ImageMagick
 * FluidSynth
 * Firejail

이 확장 기능은 LilyPond를 사용해서 악보 이미지를 묘사하는 것으로 LilyPond를 설치할 필요가 있습니다. 악보 파일을 트리밍하는 확장 기능이 필요할 경우에는 이미지매직도 필요합니다. If you install LilyPond from a package, Ghostscript will also be installed, since LilyPond depends on Ghostscript. ImageMagick should be installed to trim the images, otherwise they will contain an excessive amount of whitespace.

For security reasons, it is highly recommended to install firejail to further restrict what LilyPond and Ghostscript can do if untrusted users are allowed to edit your wiki.

확장 기능은 LilyPond에 의해 생성된 MIDI 파일에서 음성 파일을 작성할 수도 있습니다. 이 기능을 이용하려면 Extension:TimedMediaHandler를 설치할 필요가 있습니다.

FluidSynth is the preferred method to convert MIDI files to audio files, however TiMidity++ is also supported.

Security concerns
Score uses LilyPond in safe mode, however there are known unfixed safe mode escape vulnerabilities leading to arbitrary execution.

If you don't absolutely trust everyone who has editing privileges on your wiki, it is strongly recommended to set up containment of lilypond using. See Shellbox#Server setup for details on how to set up the contained server, and below for configuring MediaWiki to use it. Also, ensure you're using a recent version of LilyPond (2.22.0+) or a distribution package (e.g. from Debian) that has security fixes. Keep safe mode enabled, even with containment as an extra layer of defense. Certain functionality will not work in safe mode, the fix for that is to modify LilyPond to allow that functionality in safe mode.

설치

 * See the extension's  for detailed installation instructions.

설정
Here are some of the extension's global configuration parameters.

$wgScoreLilyPond
Set  to the path to your LilyPond executable (typically   or  ).

$wgScoreTrim
The  is a boolean which defaults to the value of. If, the resulting score PNG images are trimmed with ImageMagick. If you don't want trimming, or don't want to install ImageMagick, set  to.

$wgScoreAbc2Ly
Set  to the path of your ABC to LilyPond converter executable (typically   or  ).

$wgScoreFluidsynth
Set  to the path of your Fluidsynth executable (typically   or  ).

$wgScoreSoundfont
Set  to the path of your soundfont file (typically   or  ).

$wgScoreLame
Set  to the path of your Lame executable (typically   or  ). Required if the generated audio file should be a MP3.

Remarks
This extension runs various binaries in a Shellbox to provide some security. You may have to increase if you get out of memory errors.

Finding scores
Pages with scores on them will have the "score" page property set. Using Special:PagesWithProp, you can find pages that have scores. ([//en.wikipedia.org/wiki/Special:PagesWithProp?propname=score&propname-other= Example query for the English Wikipedia].)

같이보기

 * Tim Starling에 의한 코드 리뷰; 이 확장 기능은 그것에 기초로 하고 있습니다.
 * https://en.wikisource.org/wiki/Help:Sheet_music


 * Help:Score on English Wikipedia and Help:Sheet music on Wikisource have more examples of LilyPond syntax.
 * Vexflow Open source SVG/Canvas music renderer
 * LilyPond notation
 * ABC notation
 * vexflow github repository