HTTP code snippets

[garethsb]

We use triple-backtick blocks to render code snippets in the specs. We've recently checked that these all use format hints like json appropriately, which gets us syntax highlighting. I notice that the http ones, e.g. on the APIs - Server Side Implementation Notes pages in the IS-04 v1.3.x and IS-05 v1.1.x branches, render nicely on GitHub, but in red on specs.amwa.tv, which looks a bit odd. Is this something which could be resolved with just a CSS tweak, or does it indicate something else?

[garethsb]

Hmm, even the JSON snippets render with reddish text, but they only use the light red background to indicate syntax errors, e.g. where snippets have ... to indicate elision. The HTTP snippets in the server implementation notes have the light red background throughout.

[garethsb]

As discussed on Slack, the issue is that (unlike the GitHub one) the lexer for ruby-rouge http expects the snippet to begin with a whole HTTP request or response line.

• https://github.com/rouge-ruby/rouge/issues/1704
• https://github.com/rouge-ruby/rouge/blob/master/lib/rouge/lexers/http.rb
• https://rouge-ruby.github.io/docs/file.LexerDevelopment.html