add syntax highlighting, fix tags, update examples

- add syntax highlighting using by CodeRay
- preprocess {@literal *} tags before sending to Asciidoctor
- don't use Asciidoctor on tag content (the output breaks Javadoc)
- reorg the examples as a definition list
- add Eclipse project files to gitignore