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.