tools/2xep improvements

[mwild1]

Tagging @Zash for review (who wrote most of this).

This PR fixes/adds:

• Support for entities (including defining custom entities)
• Fixes the encoding of <dependencies> in the metadata
• Adds support for captions in examples:

```{.example caption="Client requests list of clients from server"}