Fix README.adoc to be usable on GitHub

Asciidoctor/GitHub doesn't support (yet) conditional attribute references, so remove them and when necessary use instead conditional inclusion macros.
Fix cross reference links.