Re: RFC: Adding syntax highlighting to the official documentation

2022-01-31 Thread Werner LEMBERG
> OK, putting on my list, but I still plan to do the Scheme lexer > improvements before that (and it definitely deserves a separate > merge request anyway). Thanks. > If you want to have a go in the mean time, feel free :-) Probably not in the nearer future :-) Werner

Re: RFC: Adding syntax highlighting to the official documentation

2022-01-31 Thread Jean Abou Samra
[Me] Hi Mats, Thanks for your thoughts! Le 31/01/2022 à 09:19, Mats Bengtsson a écrit :     Thanks for your work on this! A couple of comments (sorry, I haven't     taken the time to look and comment on your proposal earlier):     - I cannot see that you explain to the user what syntax class

Re: RFC: Adding syntax highlighting to the official documentation

2022-01-31 Thread Werner LEMBERG
> My idea for this would be > > @lilypond[verbatimonly,quote] > > [...] This is an excellent suggestion! > So that is doable, but as you can see there is a fair bit of work to > invest, especially for changing many instances of @example to > @lilypond[verbatimonly,quote] ... > > $ git grep "@

Re: RFC: Adding syntax highlighting to the official documentation

2022-01-31 Thread Jean Abou Samra
Hi Mats, Thanks for your thoughts! Le 31/01/2022 à 09:19, Mats Bengtsson a écrit : Thanks for your work on this! A couple of comments (sorry, I haven't taken the time to look and comment on your proposal earlier): - I cannot see that you explain to the user what syntax classes the

Re: RFC: Adding syntax highlighting to the official documentation

2022-01-31 Thread Mats Bengtsson
Thanks for your work on this! A couple of comments (sorry, I haven't taken the time to look and comment on your proposal earlier): - I cannot see that you explain to the user what syntax classes the different colors correspond to. It could of course be seen as a pedagogical trick to

Re: RFC: Adding syntax highlighting to the official documentation

2022-01-30 Thread Werner LEMBERG
> The syntax highlighting patch is back. I have pushed the latest > version to the GitLab MR (as a reminder, this is > https://gitlab.com/lilypond/lilypond/-/merge_requests/1019). You > can find the new demo here: Congrats! Overall, it looks very nice to me. Werner

Re: RFC: Adding syntax highlighting to the official documentation

2022-01-30 Thread Jean Abou Samra
Le 30/01/2022 à 19:52, Jean Abou Samra a écrit : * Since markups are a kind of extension of strings   (or at least, strings are a special case of markups),   they are now the same color as strings (yellowish). Follow-up: I did this change on the last minute, and now that I see the stanza docum

Re: RFC: Adding syntax highlighting to the official documentation

2022-01-30 Thread Jean Abou Samra
Hello everyone, The syntax highlighting patch is back. I have pushed the latest version to the GitLab MR (as a reminder, this is https://gitlab.com/lilypond/lilypond/-/merge_requests/1019). You can find the new demo here: http://abou-samra.fr/new-highlighting-demo/notation/index.html Perhaps th

Re: RFC: Adding syntax highlighting to the official documentation

2022-01-01 Thread Jean Abou Samra
Hi, First, thank you for all the encouragements (some of them received privately). Le 30/12/2021 à 23:37, Dan Eble a écrit : On Dec 30, 2021, at 17:07, Jean Abou Samra wrote: What about the original one, I mean, the one starting this thread? As I understand it, Dan tried less colors because

Re: RFC: Adding syntax highlighting to the official documentation

2021-12-31 Thread Kieren MacMillan
Hi Jean, > The proposal changes this to > > > another bit > etc. > > > (whitespace added for readability), so now you can > inject custom CSS and have your own highlighting scheme > if you want, or disable highlighting completely. We're all after the same thing. =) This proposal is grea

Re: RFC: Adding syntax highlighting to the official documentation

2021-12-31 Thread Jean Abou Samra
Le 31/12/2021 à 14:42, Wols Lists a écrit : On 19/12/2021 10:00, Jean Abou Samra wrote: For the time being I'm only focusing on HTML output. That has the advantage that if even the contrast does not help, people can use tools to adapt or remove the color scheme if they need to. Echoing James' co

Re: RFC: Adding syntax highlighting to the official documentation

2021-12-31 Thread Kieren MacMillan
Hi Wol, > You should not be choosing colours, you should be creating a CSS with things > like and and whatever all those things are. Both things need to be done: the principal activity, as you say, should be markup/semantics… but it has to be presented in some manner by default, so that defa

Re: RFC: Adding syntax highlighting to the official documentation

2021-12-31 Thread Wols Lists
On 19/12/2021 10:00, Jean Abou Samra wrote: For the time being I'm only focusing on HTML output. That has the advantage that if even the contrast does not help, people can use tools to adapt or remove the color scheme if they need to. Echoing James' comment below, while not everyone knows how to

Re: RFC: Adding syntax highlighting to the official documentation

2021-12-30 Thread Dan Eble
On Dec 30, 2021, at 17:07, Jean Abou Samra wrote: > > What about the original one, I mean, the one > starting this thread? As I understand it, Dan > tried less colors because there was a lot of > blue and black was easier to read. Maybe it > will be better with some kind of green? I have the sam

Re: RFC: Adding syntax highlighting to the official documentation

2021-12-30 Thread Jean Abou Samra
Le 30/12/2021 à 23:07, Jean Abou Samra a écrit : I don't know if it's just me with this impression or not; a test is attached. And of course I forgot it... <>

Re: RFC: Adding syntax highlighting to the official documentation

2021-12-30 Thread Jean Abou Samra
Le 29/12/2021 à 00:39, Thomas Morley a écrit : Am Di., 28. Dez. 2021 um 22:22 Uhr schrieb Jean Abou Samra : On the merge request, Dan proposed the attached style. What do you think? Thanks, Jean Well, I use jEdit for my own work. There I use a highly customized syntax highlighting: Many differ

Re: RFC: Adding syntax highlighting to the official documentation

2021-12-28 Thread Thomas Morley
Am Di., 28. Dez. 2021 um 22:22 Uhr schrieb Jean Abou Samra : > > On the merge request, Dan proposed the attached style. What do you think? > > Thanks, > Jean Well, I use jEdit for my own work. There I use a highly customized syntax highlighting: Many different colors and apart from comments all is

Re: RFC: Adding syntax highlighting to the official documentation

2021-12-28 Thread Jean Abou Samra
On the merge request, Dan proposed the attached style. What do you think? Thanks, Jean<>

Re: RFC: Adding syntax highlighting to the official documentation

2021-12-19 Thread Jean Abou Samra
Le 19/12/2021 à 05:18, John Wheeler a écrit : Jean, My concern for color blindness stemmed from having worked on government manuals probably two decades ago.  We were taught that you should include nothing that relied solely on color to make sense of the text.  If you are working to modern we

Re: RFC: Adding syntax highlighting to the official documentation

2021-12-19 Thread James
On 19/12/2021 06:46, Aaron Hill wrote: On 2021-12-18 8:18 pm, John Wheeler wrote: The other concern is more a personal thing with me.  When I say printed text, I was referring to pdf output. I will often print a pdf file so I can better read it from paper.  When you mentioned adding color to p

Re: RFC: Adding syntax highlighting to the official documentation

2021-12-18 Thread Aaron Hill
On 2021-12-18 8:18 pm, John Wheeler wrote: The other concern is more a personal thing with me.  When I say printed text, I was referring to pdf output. I will often print a pdf file so I can better read it from paper.  When you mentioned adding color to pdf files, you caught my attention.  I have

Re: RFC: Adding syntax highlighting to the official documentation

2021-12-18 Thread John Wheeler
Jean, My concern for color blindness stemmed from having worked on government manuals probably two decades ago.  We were taught that you should include nothing that relied solely on color to make sense of the text.  If you are working to modern web accessibility guidelines you are certainly w

Re: RFC: Adding syntax highlighting to the official documentation

2021-12-18 Thread Lukas-Fabian Moser
Hi Jean, Feedback is appreciated. For what it's worth: I like that design (only having looked at the style-test.zip file) a lot. It's unobtrusive, yet makes it easier to parse the structure of a code sample at first glance. Of course, that doesn't help at all with the issues raised by John

Re: RFC: Adding syntax highlighting to the official documentation

2021-12-18 Thread Jean Abou Samra
Hi John, Le 18/12/2021 à 17:31, wheelerw...@runbox.com a écrit : When employing color in printed text, or print requivalent text, please be considerated of your readers who are color blind or have attention problems related to color. For the former you need to provide a way to completely remo

Re: RFC: Adding syntax highlighting to the official documentation

2021-12-18 Thread wheelerwjx9
because some who owned the book before had taken a hilighter to. Thank you, John Wheeler From: Jean Abou Samra Sent: Saturday, December 18, 2021 08:08 To: lilypond-devel Subject: RFC: Adding syntax highlighting to the official documentation Hi, This might not

RFC: Adding syntax highlighting to the official documentation

2021-12-18 Thread Jean Abou Samra
Hi, This might not have been very visible from the title of the thread "ANN: Pygments support for LilyPond", so here is a new thread with an appropriate subject. I'm proposing to add syntax highlighting to our documentation. The merge request is https://gitlab.com/lilypond/lilypond/-/merge_reque