Make syntax highlighting optional

[idleberg]

It would be nice to have an option to disable the prettify class from being added to the pre-tag. Personally, I prefer using another highlighter that doesn't rely on extra classes.

[d0ugal]

Are you adding your own highlighter with the extra css?

[idleberg]

So far, I was only running a couple of tests on an early custom theme and noticed those classes get added. Eventually, I will use extra_css to load highlight.js — but I don't see how that influences the prettify inclusion.

[d0ugal]

Just trying to fully understand the use case. I think this probably makes sense, I'm just trying to think how we best do it without adding more and more config options.

[lovelydinosaur]

Isn't the hightlighting entirely dependant on the theme - is using a custom theme the right answer here?

[d0ugal]

The problem is, we mess with peoples HTML.

https://github.com/tomchristie/mkdocs/blob/master/mkdocs/build.py#L86

[idleberg]

If you don't like adding more config options, then maybe a switch (e.g. --no-prettify) works better?

[lovelydinosaur]

Ideally we ought to tweak the default css/javascript so it doesn't require us to postprocess the html in that way.

maybe a switch (e.g. --no-prettify) works better?

Nah. Extra switches are not any better than extra config.

[d0ugal]

+1 to fixing the default css. Should just be a case of changing https://github.com/tomchristie/mkdocs/blob/master/mkdocs/themes/mkdocs/css/prettify-1.0.css

[d0ugal]

... and removing the hack in the code of course :)

[lovelydinosaur]

@d0ugal May also be some javascript that keys into that?

[d0ugal]

Oh yeah, so there is! https://github.com/tomchristie/mkdocs/blob/master/mkdocs/themes/mkdocs/js/prettify-1.0.min.js

[idleberg]

Awesome, will check it out when I get home

[idleberg]

Works, thanks a lot guys!