Use Rouge syntax highlighting in User Guide

[sbrannen]

Overview

#770 introduced support for generating a PDF version of the User Guide and initially attempted to use Rouge syntax highlighting but stopped short of doing so for the HTML version since Rouge is not yet supported for the html5 backend in Asciidoctor.

The reason we say "initially" is that we have now stopped using Rouge due to a bug that prevents it from being used on MS Windows. See rouge-ruby/rouge#661 for details.

Related Issues

• Publish PDF version of User Guide #770
• Update Asciidoctor PDF backend of the user-guide #1099

Deliverables

• Upgrade to Asciidoctor 1.5.7 once Integrate Rouge for source highlighting asciidoctor/asciidoctor#1040 has been resolved.
• Change from coderay to rouge for syntax highlighting in the HTML and PDF versions of the User Guide once Rouge fails to load using JRuby on Windows rouge-ruby/rouge#661 has been resolved.

[sbrannen]

Changed the scope of this issue to both versions of the User Guide due to rouge-ruby/rouge#661.

[mojavelinux]

I think you should plan to use Rouge 2.0.8 (the next release at the time of this comment). Until then, just stick with CodeRay (which gets the job done).