Extension:Score/vi

Tiện ích mở rộng Score cho phép kết xuất các khuông nhạc dưới dạng hình ảnh PNG bằng cách sử dụng LilyPond và cũng có thể chuyển đổi chúng thành các tập tin âm thanh và MIDI.

Nhìn nhận

 * ban đầu được viết bởi Johannes E. Schindelin.
 * Tiện ích mở rộng này dựa trên code review của bởi Tim Starling.
 * ban đầu được viết bởi River Tarnell.

Cách sử dụng
Sau khi cài đặt và thiết lập, bạn có thể nhúng một ký hiệu LilyPond đơn giản thành mã wiki của bạn bên trong thẻ . Ví dụ:

yields:

Bạn cũng có thể chỉ định các thuộc tính cho thẻ khuông nhạc ở dạng chung

.

Ví dụ:

yields:

Các thuộc tính sau có sẵn



Ngôn ngữ LilyPond
Lyrics may be added like this:

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

Điều kiện
The following packages are recommended:


 * LilyPond
 * Ghostscript
 * ImageMagick
 * FluidSynth
 * Firejail

This extension uses LilyPond to render score images, so you need a working LilyPond installation (Special:Version displays the LilyPond version). 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.

The extension is also capable of creating audio files from the MIDI files generated by LilyPond. If you want to make use of this functionality, you need to have installed.

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.

Cài đặt

 * See the extension's  for detailed installation instructions.

Cấu hình
Dưới đây là một số tham số cấu hình chung của tiện ích mở rộng.

$wgScoreLilyPond
Đặt  thành đường dẫn của tệp thực thi LilyPond của bạn (thường là   hoặc  ).

$wgScoreTrim
là một giá trị boolean mặc định của. Nếu kết quả là, kết quả Hình ảnh PNG của khuông nhạc được cắt bằng ImageMagick. Nếu bạn khuông muốn cắt ảnh hoặc không muốn cài đặt ImageMagick, hãy đặt giá trị  thành.

$wgScoreAbc2Ly
Đặt  sang đường dẫn từ ABC sang trình chuyển đổi LilyPond có thể thực thi của bạn (thường là   hoặc  ).

$wgScoreFluidsynth
Đặt  thành đường dẫn của tệp thực thi Fluidsynth của bạn (thường là   hoặc  ).

$wgScoreSoundfont
Đặt  thành đường dẫn của tệp soundfont của bạn (thường là   hoặc  ).

$wgScoreLame
Đặt  thành đường dẫn của tệp thực thi Lame của bạn (thường là   hoặc  ). Điều này là bắt buộc nếu tệp âm thanh được tạo phải có định dạng MP3.

Nhận xét
Tiện ích mở rộng này chạy các tệp nhị phân khác nhau trong Shellbox để cung cấp một số bảo mật. Bạn có thể phải tăng nếu gặp lỗi "hết bộ nhớ".



Tìm bản nhạc
Các trang có khuông nhạc sẽ được đặt thuộc tính trang "khuông nhạc". Sử dụng Special:PagesWithProp, bạn có thể tìm các trang có khuông nhạc. ([//en.wikipedia.org/wiki/Special:PagesWithProp?propname=score&propname-other= Truy vấn ví dụ cho Wikipedia tiếng Anh].



Xem thêm

 * Trợ giúp:Khuông nhạc trên Wikipedia tiếng Việt và Trợ giúp:Bản nhạc trên Wikisource có thêm ví dụ về cú pháp LilyPond
 * Vexflow Trình kết xuất âm nhạc sang SVG/Canvas mã nguồn mở
 * Ký hiệu LilyPond
 * Ký hiệu ABC
 * kho lưu trữ vexflow trên github