Cards: provide a way to simplify the syntax

[tbouffard]

Currently, cards can only be created by using a mix of AsciiDoc markup and HTML. This makes the syntax hard to write and read.

We may introduce an asciidoctor extension to better handle this. The /asciidoctor-tabs/ extension could be use as a starting point: https://github.com/asciidoctor/asciidoctor-tabs/tree/main/js Notice that we included an old version of this extension in the past without using it 😄 https://github.com/bonitasoft/bonita-documentation-site/pull/296

We should evaluate if this extension can be included in the theme to be able to test and evaluate it, or if it must be in the site repository. Check https://github.com/asciidoctor/asciidoctor-tabs/blob/main/docs/use-with-antora.adoc for example.

Resources

• usage of the asciidoctor-tabs extension (an old version): https://github.com/OpenNMS/docs.opennms.com/tree/master
• https://docs.couchbase.com/tutorials/tutorial-template/sample.html#add-a-tutorial-card and https://docs.couchbase.com/tutorials/index.html but the AsciiDoc source contains a lot of HTML markdup, so the extension my not be used correctly