Отображение цифровых нот с помощью редактора блоков WordPress

Вывод плагина OSMD на передней панели.

PhonicScore, компания из Вены, недавно выпустила плагин OpenSheetMusicDisplay (OSMD) . Это блок WordPress, созданный для рендеринга цифровых нот в браузере.

Плагин OSMD построен на основе одноименной библиотеки JavaScript команды, проекта, официально выпущенного в 2016 году. Это мост между VexFlow и MusicXML . VexFlow – это API JavaScript для рендеринга нот, а MusicXML – стандартный открытый формат для обмена цифровыми нотами.

«Поскольку WordPress является одной из самых популярных CMS», мы решили создать готовое решение, которое пользователи могли бы легко подключить к своим WP-сайтам », – написал Марин Юрчич в объявлении . «Это была непростая сборка, к счастью для нас, OSMD предоставила все инструменты для работы. Чтобы это произошло, мы сильно полагались на последнюю версию OSMD и включили ее в плагин. Чтобы добавить «готовые функции» и заставить его работать, мы использовали фреймворк / библиотеку WordPress – Javascript и PHP ».

Это тип плагина, который позволяет раскрыть красоту редактора блоков. Несколько лет назад такой подвиг был возможен только с помощью системы шорткодов. Пользователям пришлось бы вручную вводить все аргументы шорткода – при условии, что они могут их все запомнить – и предварительно просмотреть сообщение, чтобы увидеть, как он будет выглядеть. Сегодня они могут взаимодействовать и вносить изменения непосредственно в отображение нот из редактора.

OSMD никогда не был первым проектом WordPress. Это была отдельная библиотека, которую компания решила сделать доступной для WordPress. Благодаря мощи блочной системы они смогли это сделать. Остается только надеяться, что мы видим вложения в наше сообщество из подобных проектов теперь, когда редактор блоков стал более стабильным.

Мы почти не копаем того, что станет возможным со временем. Такие блоки, как OSMD, основаны на оптимизме, который у меня был, когда система была впервые представлена.

Чтобы использовать плагин, пользователи должны просто вставить блок OpenSheetMusicDisplay в свой холст контента. Он находится в категории «Встроить». С этого момента, они должны выбрать или загрузить файл XML с помощью боковой панели параметров блока ( .xml, .musicxmlи .mxlфайлы не поддерживаются). Перетаскивание файла не работает в этой версии – может быть, запрос функции для 2.0?

На вкладке «Основные параметры» есть несколько настроек ширины и соотношения сторон. По большей части, вероятно, лучше оставить их по умолчанию. Однако это будет зависеть от вашей темы и от того, сколько места она предоставляет.

Блок в настоящее время не поддерживает стандартную систему широкого выравнивания. Вместо этого у него есть опция ширины, позволяющая пользователям определять внешний вид вывода. Поскольку это нестандартный вариант, он может не работать со всеми темами. В зависимости от того, как активная тема пользователя обрабатывает ширину содержимого, они могут получить совершенно разные результаты.

Вкладка «Параметры чертежа» – это то место, где у пользователей больше контроля над настройкой вывода. Эти настройки позволяют пользователям определять, что «нарисовано» в цифровых нотах. Один из вариантов – рисовать ли имя композитора. Другой – вывод временных размеров. Всего 10 настроек, есть над чем повозиться.

Самая большая проблема, с которой я столкнулся с плагином, заключалась в том, что редактор время от времени зависал. Оказалось, что блок пытался перезагрузиться, даже когда я работал вне его. Это произошло, несмотря на снятие флажка «Автоматически повторять рендеринг при изменении».

В целом этот плагин должен обслуживать пользователей, которые хотят хорошо отображать ноты. Он прост в использовании и предлагает множество вариантов настройки. У команды есть демонстрация библиотеки OSMD в действии на их сайте.