Improve faq on custom theme syntax highlighting

I was pretty confused about how to get syntax highlighting working in my own theme,
figured I'd submit a PR with some explanation that would have helped me and will
(hopefully) be helpful to others.