search

stackabletech / documentation

Stackable's central documentation repository built on Antora
https://docs.stackable.tech
Apache License 2.0
11 stars 11 forks source link

Support tab blocks #208

Closed fhennig closed 3 months ago

fhennig commented 2 years ago

I'd really like to have tabbed blocks available, for example to have install steps for linux/mac as two tabs to take up less space.

There's this extension from couchbase we could try and integrate: https://github.com/couchbase/docs-site/blob/9896e4500fa2012ca8da00d9036f5d0f1d23cdb2/lib/tabs-block.js

There's also a more "official" extension: https://gitlab.com/antora/antora-asciidoctor-extensions/-/blob/main/tabs-block/extension.js that might work

For example here is such a block, with "Enterprise" and "Community" tabs.

NickLarsenNZ commented 5 months ago

Another example (for variety): https://docs.dapr.io/getting-started/quickstarts/pubsub-quickstart/

fhennig commented 4 months ago

Another example, even more involved: https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_upgrade_before-cdp.html

In here you have multiple drop downs to select 'your environment' which is used throughout the article

fhennig commented 3 months ago

In the end I went with the official tab block extension. https://github.com/asciidoctor/asciidoctor-tabs