Add YAML syntax highlighting

[ebkalderon]

It seems that with highlightjs/highlight.js#119, the Highlight.js library now supports syntax highlighting for YAML. However, when I annotate some YAML with ````yaml`, no syntax highlighting appears.

[ebkalderon]

@azerupi Could you perhaps explain why this is happening? Does mdBook use an older version of Highlight.js that lacks YAML support for syntax highlighting?

[azerupi]

Yes, I haven't updates highlight.js since August, I think.

I am rewriting mdBook to have a sort of plugin api and will extract the
code that manages the syntax highlighting into a more isolated plugin. When
that is done I will probably switch to a dependency manager like Bower to
update dependencies on a regular basis.

Also I have disabled auto-detect, because in my experience it doesn't
always work like it is supposed too. When it's a plugin I will probably add
an option in the config file to indicate a default language.

But.. at the moment I am on vacation ;)
On Feb 10, 2016 3:53 PM, "Eyal Kalderon" [email protected] wrote:

@azerupi https://github.com/azerupi Could you perhaps explain why this
is happening? Does mdBook use an older version of Highlight.js for syntax
highlighting?

—
Reply to this email directly or view it on GitHub
https://github.com/azerupi/mdBook/issues/103#issuecomment-182406368.

[ebkalderon]

@azerupi Sounds good. Until then, please relax and enjoy your vacation!

[Luthaf]

YAML support is not activated by default in highlight.js code. As a temporary workaround, you could download highlight.js (Custom package section) from there website, activating all the languages you need, and then putting the file in src/theme/highlight.js.

[azerupi]

Yes, @ebkalderon you can do like @Luthaf suggests until I update the in tree version. You can read more about the process of overriding default theme files in the documentation.

If you do, let me know if it fixes the issue