ABC Notation

説明

This includes the abcjs system on your WordPress site. To produce sheet music, put a valid ABC Notation string between the shortcodes [abcjs] and [/abcjs] on your page or post.

This also generates MIDI by using the shortcode [abcjs-midi].

Thanks

Special thanks to http://www.beliefmedia.com/ for the idea to load the ABC string from a file, and for the idea to conditionally load the javascript only if there is a shortcode on the page.

スクリーンショット

  • An example of a shortcode and the resultant music that is produced.

インストール

  1. /wp-content/plugins/ にフォルダごとアップロードします。
  2. 「プラグイン」メニューからプラグインを有効化します。
  3. Click ‘Settings’ in the dashboard, then ‘ABC Notation’ to customize.

FAQ

Installation Instructions
  1. /wp-content/plugins/ にフォルダごとアップロードします。
  2. 「プラグイン」メニューからプラグインを有効化します。
  3. Click ‘Settings’ in the dashboard, then ‘ABC Notation’ to customize.
Where can this be used?

Anywhere that shortcodes are accepted. That is, on pages, post, and widgets. It will not work on comments.

How does it work?

The plugin includes the abcjs JavaScript library. The string that is put in the shortcode is passed to that library, which translates it and renders it in an SVG element that it places on the page instead of the shortcode.

What can be put in the ABC string that is placed in the shortcode?

There is much written about ABC Notation around the web. You can start here

What parameters may be used?

The shortcode can take the same parameters as abcjs. See the documentation for details.

There is also an interactive way to play with the parameters: Configurator.

Here are some examples:

To make the music responsive:
[abcjs engraver="{ responsive: 'resize' }"]
... some ABC string ...
[/abcjs]

To set or override the tempo:
[abcjs-midi midi="{ qpm: 150 }"]
... some ABC string ...
[/abcjs-midi]

List of parameters to the [abcjs] shortcode:

[abcjs class="abc-paper"] etc... [/abcjs] puts the named class on the generated `<svg>` element.

[abcjs parser="{}" engraver="{}" render="{}"] etc... [/abcjs] passes the javascript objects straight through to `abcjs.renderAbc`. See the abcjs documentation for details.

[abcjs file="https://url/to/abc/file"] loads the string from the specified file instead of the embedded string. You can upload this file using Add New Media or it can reside in any publicly available place.

[abcjs number_of_tunes=2] if there are more than one tune in the ABC string, this specifies how many should be printed out. If this is set to more than the number of tunes in the string, that's ok, the additional places are ignored, so if you want to be sure you have all the tunes, then use a high number for this.

List of parameters to the [abcjs-midi] shortcode:

[abcjs-midi class="abc-paper"] etc... [/abcjs] puts the named class on the generated MIDI element.

[abcjs-midi parser="{}" midi="{}"] etc... [/abcjs] passes the javascript objects straight through to `abcjs.renderMidi`. See the abcjs documentation for details.

[abcjs file="https://url/to/abc/file"] loads the string from the specified file instead of the embedded string. You can upload this file using Add New Media or it can reside in any publicly available place.

[abcjs number_of_tunes=2] if there are more than one tune in the ABC string, this specifies how many should be printed out. If this is set to more than the number of tunes in the string, that's ok, the additional places are ignored, so if you want to be sure you have all the tunes, then use a high number for this.
Help! Some characters are not printing properly.

Try pasting the ABC string in using the “Text” editor instead of the “Visual” editor. That will help keep the quotation marks and any other interpreted characters from being changed by WordPress.

評価

Excellent plugin

This plugin is a must have for bloggers who want to display note sheets. Does exactly what I was looking for. Saves me a lot of time.

Exactly what I was looking for!

Exactly what I was looking for! There was a small problem with the rendering (only in german user interface), but the developer helped quickly!
An idea for the next version: It would be nice if the tunes could also be played.

Sehr guter Ansatz, aber nur bedingt

Das Plugin ist im Grunde genial. Es stellt Noten brilliant dar, wie man es sich nicht besser wünschen könnte. Leider mit einem kleinen Schönheitsfehler: Das Plugin, vielmehr die daraus resultierenden Notendarstellungen, sind NICHT responsive. Und damit ist das Plugin aus meiner sicht nur sehr eingeschränkt nutzbar. Schade, denn es gibt kein anderes Plugin, was das kann.

3件のレビューをすべて表示

貢献者と開発者

ABC Notation はオープンソースソフトウェアです。以下の人々がこのプラグインに貢献しています。

貢献者

“ABC Notation” をあなたの言語に翻訳しましょう。

開発に興味がありますか ?

コードを閲覧するか、SVN リポジトリをチェックするか、開発ログRSS で購読してみてください。

変更履歴

1.12

  • Initial version of this plugin. (Version numbers are in sync with the version of abcjs that is included.)

2.0

  • Upgrade abcjs version.

2.1

  • Upgrade abcjs version.

2.3

  • Upgrade abcjs version. See https://github.com/paulrosen/abcjs for details.

2.3.1

  • Added entry point for creating MIDI downloads.
  • Tested through WP 4.4.

3.1.3

  • Upgrade to use the abcjs 3.1.3 code.
  • Add „ as one of the smart quotes.

3.1.4

  • Add parameter to do responsiveness.

3.2.0

  • Add overlay feature
  • Bug fixes
  • Upgrade to use the abcjs 3.2.0 code.

3.2.1

  • Fix crash when window.performance is not available.
  • Fix placement of rests when the stem direction is forced.
  • Upgrade to use the abcjs 3.2.0 code.

3.3.0

  • Upgrade to use the abcjs 3.3.0 code.

3.3.2

  • Upgrade to use the abcjs 3.3.2 code.
  • Add “file” parameter to get the ABC from a separate file.
  • Allow files with the extension “.abc” to be uploaded in Add Media.
  • Add the “number_of_tunes” parameter to allow more than one tune to be displayed.

3.3.4

  • Upgrade to use the abcjs 3.3.4 code.

4.1.0

  • Upgrade to use the abcjs 4.1.0 code.

5.0.0

  • Upgrade to use the abcjs 5.0.0 code.