Subject: Re: [boost] ATTENTION: Library requirements..
From: Sam Kellett (samkellett_at_[hidden])
Date: 2016-01-08 05:11:56
On 8 January 2016 at 09:51, Andrey Semashev <andrey.semashev_at_[hidden]>
wrote:
> On 2016-01-08 12:40, Sam Kellett wrote:
>
>> On 8 January 2016 at 09:32, Rainer Deyke <rainerd_at_[hidden]> wrote:
>>
>> On 07.01.2016 18:11, Robert Ramey wrote:
>>>
>>> Useful applications of javascript that occur to me are:
>>>>
>>>> b) syntax coloring for code examples
>>>>
>>>
>>> I disagree that this is a valid use of Javascript. Code examples are
>>> static, so they can and should be statically colored. This means that
>>> the syntax highlighting exists even if Javascript is disabled.
>>>
>>
>> that's massively open to human error and adds a substantial workload on
>> the
>> dev which could be better spent (re)writing the actual documentation
>> content to a better level.
>>
>
> Coloring is done automatically by QuickBook/BoostBook and doesn't require
> human intervention. I believe other source formats should also have this
> capability without involving JS.
>
> If you're writing plain HTML then yes, you would have to do this yourself,
> but that's just one of your problems as writing HTML is a pain in general.
> Probably, this is the reason why noone does this nowdays.
fair. sorry no experience with quickbook so didn't realise!