Boost logo

Boost :

Subject: Re: [boost] ATTENTION: Library requirements..
From: Andrey Semashev (andrey.semashev_at_[hidden])
Date: 2016-01-08 04:51:38


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.


Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk