This repository has been archived by the owner on Jul 11, 2019. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 3
/
readme.txt
172 lines (110 loc) · 8.17 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
=== ScoreRender ===
Contributors: abelcheung
Tags: music, music notation, music typesetting, score, abc, mup, lilypond, guido, pmw
Requires at least: 2.6
Tested up to: 2.9.2
Stable tag: 0.3.3
Renders inline sheet music fragments in excerpts, posts, pages and comments.
== Description ==
ScoreRender is a Wordpress plugin for rendering sheet music fragments into images. It supports converting fragments in excerpts, posts, pages and (optionally) comments. Currently it supports 5 music notations: ABC, Guido, Lilypond, Mup and Philip's Music Writer.
For latest version, detailed usage instructions and demo cases, please visit [ScoreRender official site](http://scorerender.abelcheung.org/). Requires PHP5 with GD extension, ImageMagick and various programs to generate music score.
== Installation ==
###Prerequisite###
1. **WordPress 2.6.x** (due to usage of `plugins_url()`, `admin_url()` etc which do not exist before 2.6)
1. **PHP 5.x with GD extension** (Please visit [offical site](http://scorerender.abelcheung.org/) if ancient version using PHP4 is needed)
1. **ImageMagick >= 6.3.5-7** (due to usage of `-alpha` option). Version later than 6.3.9-6 is preferred, since a bug about detecting PostScript transparency is fixed.
1. **GhostScript** (Usually pre-installed on Linux. Under Windows, download prepackaged installer from [official site](http://pages.cs.wisc.edu/~ghost/doc/GPL/index.htm]) )
1. **Music rendering programs** must also be installed on the same machine web server is running. For example, to support Lilypond fragments, Lilypond >= 2.8.1 must be installed in web server. Most notations require explicit program to render, except GUIDO notation which fetches remote images instead. Refer to [installation page](http://scorerender.abelcheung.org/installation/) for more detail.
###New install###
1. Install any prerequisite programs as noted above.
1. Extract archive, and copy 'scorerender' folder to `wp-content/plugins/`, keeping the folder structure intact.
1. Login to WordPress and enable the plugin in admin interface.
1. Configure ScoreRender under the ScoreRender tab of the Options page.
1. In Option -> Writing, check if this option is turned on:
"WordPress should correct invalidly nested XHTML automatically"
It must be turned off if you intent to render Lilypond and Mup fragments,
since this option will convert "<<" and ">>" into "< <" and "> >"
correspondingly, thus destroying the music content and cause render error.
###Upgrade###
1. Deactivate the plugin in WordPress admin page.
1. Remove the whole plugin folder.
1. Upload new plugin and activate again.
== Frequently Asked Questions ==
= It just complains about some obscure error! =
The error code indicates the kind of error in some degree. There are comments inside wp-scorerender.php indicating what kind of error it is. If you can't make any heads and tails out of PHP code, feel free to [contact the author](http://me.abelcheung.org/aboutme/).
= Why music score fragments are not rendered at all? =
* Check if the beginning tag and ending tag of your music score fragment are correct.
* It will only be rendered if logged in user has *unfiltered_html* capability, i.e. the user has *Administrator* or *Editor* role in WordPress. User can ask blog admin to boost their capabilities if needed.
* Some programs required for certain notation may be not working or missing.
= Is any ABC notation compatible program also supported? =
Since 0.2, [abcm2ps](http://moinejf.free.fr/) will be the only one supported. This is a design decision. If you **REALLY** want to use other similar programs, you are on your own, though modifying the code to support others is not very hard for those who can write program in PHP. Take a look at `notation/abc.php`.
= I want to remove some specific cached image and re-render, but how can I determine which is which? =
Right now this is still impossible. Management of cache is planned in future, but can't say when it would be finished.
= How to debug my fragment when posting? =
Simply answer: don't do that if possible. The best way is render it privately in your computer first, then post the content, rather than needlessly spending lots of time on trial and error.
Long answer: There is no easy method for debugging a fragment yet. If there is no choice but perform trial and error, you can search for this line in `wp-scorerender.php`:
` define (SR_DEBUG, FALSE);`
Change `FALSE` to `TRUE`, then resubmit the content again. It has a few purposes:
1. Erraneous fragments are not deleted from server temp folder, and you can try manually rendering the fragment using command line to see what's wrong.
1. Full command line for rendering is now shown on blog, so that you can check out if command line argument is wrong.
1. Full content of `$_POST` is shown in admin page upon settings update.
= How can I install Philip's Music Writer? =
Only by downloading source from its official website and compile the program yourself. The author failed to notice any binary package for Windows or Linux as of Feb 2010, except an outdated RPM package for Mandriva Linux.
Please refer to the documents inside PMW tarball on how to compile its source code.
= I discovered a bug or want to have ____ feature implemented. How can I tell the author? =
You can either [submit bug report to Googlecode](http://code.google.com/p/scorerender/issues/list) or [contact the author](http://me.abelcheung.org/aboutme/).
== Screenshots ==
Please visit [ScoreRender official site](http://scorerender.abelcheung.org/) for screenshots.
== License ==
* This plugin is licensed under GNU AGPL v3.
* IE Alpha Fix is licensed under LGPL v2.1 or later.
* Zero Clipboard is licensed under LGPL.
* jscolor is licensed under LGPL.
== Upgrade Notice ==
= 0.3.3 =
* Safe mode for Lilypond notation is once again usable.
* Users of more recent ImageMagick version will find that transparency for certain notations are fixed.
* Also fix a bug prevented disabling of notation.
= 0.3.2 =
* Users of Lilypond 2.12.x should upgrade due to broken command line invocation.
== Changelog ==
= 0.3.3 =
* CHG: Change license to AGPL v3.
* CHG: 'Show source' setting is moved to 'Contents' admin section.
* BUG: Admin form html tags incorrectly nested.
* BUG: Notation was not deactivated even when program name is not filled.
* BUG: Restore safe mode for Lilypond, use precise version detection to determine command line argument.
* BUG: PostScript transparency shall be properly detected for PMW and Mup on recent ImageMagick versions.
* BUG: Prevents PMW from reading config file.
* FEAT: Add icon for admin form title (on recent WP versions).
= 0.3.2 =
* BUG: Fix invocation for LilyPond 2.12.x
= 0.3.1 =
* FEAT: Show image dimension in output.
* BUG: Fix line break when showing score source code under Windows.
* FEAT: Better autodetection of program.
* BUG: program availability checking.
= 0.3.0 =
* FEAT: Philip's Music Writer notation support.
* FEAT: IE Alpha fix has been incorporated, which provides translucent PNG support for IE 5.5 / 6.x. Thus drop IE PNG transparency warning altogether.
* FEAT: Zero Clipboard has been incorporated, which provides cross platform copy and paste via flash. Warning about non-IE browser during copy and paste is removed.
* FEAT: Better support of installation on web hosting, where disabling certain PHP functions is common practise.
* Rendering or not also depends on 'unfiltered_html' WordPress capability.
* Refactor functions and files, so admin page is only included when needed, and PHP class no longer access global variables.
= 0.2.1 =
* BUG: Toggling IE PNG transparency warning option was ineffective.
= 0.2.0 =
* CHG: Revamp admin page and simplify options.
* FEAT: Allows limiting number of score fragments and length of fragment.
* FEAT: Allows showing music source code when image is clicked.
* FEAT: Better Windows support.
* CHG: Mandates abcm2ps must be used for ABC notation support.
= 0.1.3 =
* FEAT: Add WordPress nonce protection.
= 0.1.2 =
* BUG: Fix image rendering during ImageMagick conversion process.
= 0.1.1 =
* BUG: Fix transparency of images generated by Lilypond.
* CHG: Issue warning if *correct invalidly nested XHTML automatically* option is checked, instead of turning the option off.
= 0.1.0 =
* Initial release.