Fixes #6579 - Fixing code blocks in our documentation

[daviddavis]

TL;DR: kramdown doesn't support ``` language syntax blocks so we have to use ~~~ instead. Alternatively, we could switch back to redcarpet for markdown rendering.

[waldenraines]

Why are we using this more verbose syntax? What does it provide other than non-formatted blocks on github 😄?

[daviddavis]

@waldenraines this is what I see with the backticks:

While fixed syntax:

[daviddavis]

Is this maybe due to redcarpet vs kramdown?

[waldenraines]

Not sure, but look at this: https://github.com/daviddavis/katello.org/blob/temp/20140710162045/docs/developer_guide/hammer_dev_env.md#clone-the-git-repositories

[daviddavis]

@waldenraines yea, I know. Github doesn't render liquid which is what jekyll is using.

[daviddavis]

@waldenraines updated. Apparently kramdown uses ~~~ for codeblocks which github does support. I'm still debating a little bit about switching back to redcarpet so we can use ``` as that's pretty standard. The only thing is that redcarpet doesn't use pretty ids. Thoughts?

/cc @ehelms

[waldenraines]

See also vmg/redcarpet#52

[ehelms]

@daviddavis to keep the ``` syntax just add:

kramdown:
  input: GFM

Ref: http://jekyllrb.com/docs/configuration/#kramdown
http://kramdown.gettalong.org/parser/gfm.html

[daviddavis]

@ehelms good find. Updated.

[ehelms]

ACK