The preferred source highlighter for accuracy is Pygments. As I understand
it (and in my experience), it does a respectable job for all major
languages.

The downside of Pygments that it requires Python, though maybe that's not
such a problem for anyone coming from AsciiDoc Python. In the future, we're
planning on replacing CodeRay with Rouge. Rouge is written in Ruby and
takes a similar approach as Pygments (the themes are also compatible).

We choose not to support source-highlighter because it requires a system
call, which means it's both non-portable and an increased security risk.
Additionally, we can only support so many highlighters because the number
of permutations of languages and styles just gets too hard to support.

Long story short, I recommend giving Pygments a try.

-Dan

On Sat, Mar 19, 2016 at 5:36 PM, Britton Kerin <[email protected]>
wrote:

> asciidoc just applied source-highlight without my having to do
> anything which was nice
> source-highlight does a decent job on C by default
>
> asciidoctor needs an attribute, ok I can understand that, however.
> It looks like asciidoctor doesn't support source-hightlight at all it
> only mentions coderay, highlightjs, prettify, and pygments.
>
> I don't care about the details of syntax highlighting provide they are
> vaguely sane, but
> prettify and higlights.js both do horrible things to C:
>
> prettify renders comments and preprocess directives exactly the same.
> This is nuts
>
> highlight.js is slightly better but the non-directive part of
> preprocessor arguments is still the same color as comment
>
> I haven't tried coderay or pygments yet
>
> --
> You received this message because you are subscribed to the Google Groups
> "asciidoc" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to [email protected].
> To post to this group, send email to [email protected].
> Visit this group at https://groups.google.com/group/asciidoc.
> For more options, visit https://groups.google.com/d/optout.
>



-- 
Dan Allen | @mojavelinux | http://google.com/profiles/dan.j.allen

-- 
You received this message because you are subscribed to the Google Groups 
"asciidoc" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/asciidoc.
For more options, visit https://groups.google.com/d/optout.

Reply via email to