syntax highlighting in the docs (issue 1005)

[Federico Bruni]

Hi,

I've finished the draft of the lilypond language file for 
source-highlight (task 1 of issue 1005):

http://code.google.com/p/lilypond/issues/detail?id=1005

I need some feedback and tips from you, please test it.


How-to
======

You must install the source-highlight package.
You don't need to recompile it: just put the attached files 
(lilypond.lang, lilypond.style and lang.map) in the current working 
directory.  Then launch this command:

source-highlight -s lilypond.lang --style-file=lilypond.style -i test.ly 
-o test.html

HTML is the default output format.  A list of all the output format
available can be obtained with:

source-highlight --outlang-list



Feedback
========

Please let me know:

1) which colours you prefer for each element. source-highlight is very 
flexible: 
http://www.gnu.org/software/src-highlite/source-highlight.html#Colors

2) the numbers regexp may be improved, I guess. Any idea?

3) I tried to use mainly regexp instead of lists of words. Do you think 
it's ok? Grouping the music functions and styling them differently as 
Frescobaldi does would be nice but not easy to maintain. I chose the 
easiest way so far.

4) I tried to choose source-highlight elements (function, cbracket, 
code) which are as close as possible to the meaning of the lilypond 
element. But sometimes it was almost impossible or difficult for a 
non-developer like me. I don't know even if it's that important (after 
all I just have to tie a regexp to an element that I can style as I wish).
Anyway any feedback on this regard is much appreciated. A list of all 
elements is available - I think - in 
/usr/share/source-highlight/default.style, where you can see that there 
are some elements specific of each language, so maybe we can even create 
them. I tried to ask on the source-highlight mailing list but I haven't 
received any reply so far.

Thanks,
Federico

lang.map
Description: Text document

lilypond.lang
Description: Text document

lilypond.style
Description: Text document

test.ly
Description: Text document