hexo-musicxml-sheetmusic

A plugin to help display musicxml sheet in hexo blog

Usage no npm install needed!

<script type="module">
  import hexoMusicxmlSheetmusic from 'https://cdn.skypack.dev/hexo-musicxml-sheetmusic';
</script>

README

hexo-musicxml-sheetmusic

NPM VERSION LANGUAGE

Embed a sheet music form a local / online musicXML file on your Hexo article, used svg-render from osmd. According to different needs, you can choose whether to load the player.

读取musicXML文件,并在 hexo 文章中显示。使用 osmd 的渲染引擎。根据需求可以设置是否加载播放器。

Demo Musicxml: A little white boat / 小白船

More Musicxml here: Musicxml Example-Set / 更多的 MusicXML 文件范例

Demo without Player / 不带播放器的实例

Without Player

Demo with Player / 带播放器的实例

With Player

Installation / 安装

Install

npm install hexo-musicxml-sheetmusic

Usage / 使用方法

Use tags in Markdown:

在 Markdown 文件中:

Without Player / 无播放器

{% musicxml URL "false" %}

With Player / 有播放器

{% musicxml URL "true" %}

Local File Example / 本地文件:

{% musicxml C:\Flute\moon.musicxml "false" %}

Internet File Example / 网络文件:

{% musicxml https://wpmedia.musicxml.com/wp-content/uploads/2017/12/Echigo-Jishi.musicxml "false" %}

Attention / 注意

该插件正处在开发阶段,各项功能均不稳定。

The plug-in is in the development stage and all functions are unstable. You have been warned.

已知的 Bug 包括: / Known Bugs include:

  • 多行乐谱时,点击音符跳转的位置错误 / When there are multiple lines of scores, the clicked notes jump to the wrong position
  • 导出 MIDI 的 MIDI 乐器只有 0 号钢琴 / export MIDI only avaliable with Midi Instrument 0 piano
  • 导出 PDF 不能正常分页,故不能正常打印 / Exported PDF cannot be paged normally, so it cannot be printed normally

Dependencies / 依赖

依赖如下: / Dependencies as follows:

License

MIT