search

asciidoctor / asciidoctor.org

:globe_with_meridians: Asciidoctor project site. Composed in AsciiDoc. Baked with Awestruct.
https://asciidoctor.org
Other
323 stars 805 forks source link

use rouge with site examples #838

Closed ghost closed 5 years ago

ghost commented 5 years ago

i noticed here that the example with syntax highlighting are using coderay:

https://asciidoctor.org/docs/asciidoc-syntax-quick-reference#source-code

i was concerned as i noticed coderay is no longer being actively developed:

https://github.com/rubychan/coderay

but then i notice that Rouge is also supported:

https://asciidoctor.org/docs/user-manual#available-source-highlighters

so perhaps it would make sense to redo the highlighting with rouge?

mojavelinux commented 5 years ago

Yes, we can make this change once Asciidoctor 2.0 is released (which features support for Rouge out of the box).

mojavelinux commented 5 years ago

I've gone ahead and added information about Rouge wherever CodeRay is covered.

CodeRay is still being maintained, but our recommendation is still Rouge.

Since we're migrating the documentation to Antora, I won't change the syntax highlighter being used for the docs since that will change anyway.