DOC-3701: Migrate to official @asciidoctor/tabs extension (#5)

* Migrate to official @asciidoctor/tabs extension

* Align local/publish Antora build commands

* Update GTM and Segment site keys

Author: eric-schneider

README.adoc

@@ -1,6 +1,6 @@
 = DataStax {product} Documentation
 :toc: macro
-:product: astra-cli-docs
+:product: Astra CLI
 :product-repo-name: astra-cli-docs
 :product-repo-name-long: datastax/astra-cli-docs
 :product-repo-link: https://github.com/datastax/astra-cli-docs.git

package.json

@@ -3,7 +3,7 @@
   "scripts": {
     "build:prod:astra-cli": "npm run build:publish:astra-cli",
     "build:dev:astra-cli": "npm run build:local:astra-cli",
-    "build:publish:astra-cli": "antora --log-level error --fetch --clean playbooks/site-publish-astra-cli.yaml",
+    "build:publish:astra-cli": "antora --stacktrace --fetch --clean playbooks/site-publish-astra-cli.yaml",
     "build:local:astra-cli": "antora --stacktrace --fetch --clean playbooks/site-local-astra-cli.yaml",
     "build:linkinator:astra-cli": "npx linkinator https://docs.datastax.com/en/astra-cli/docs/ --recurse --skip ' https://localhost?'"
   },
@@ -12,10 +12,11 @@
     "url": "git+https://github.com/datastax/astra-cli-docs.git"
   },
   "dependencies": {
-    "@antora/cli": "~3.0.1",
-    "@antora/site-generator-default": "~3.0.1",
-    "linkinator": "~3.0.3",
+    "@antora/cli": "~3.1",
+    "@antora/site-generator": "~3.1",
+    "@asciidoctor/tabs": "^1.0.0-beta.5",
     "async": "~3.2.4",
+    "linkinator": "~3.0.3",
     "mobx": "~6.0.4",
     "react": "~16.8.4",
     "react-dom": "~16.8.4",

playbooks/lib/tabs-block.js

@@ -34,8 +34,8 @@ asciidoc:
     page-pagination: ''
     sectanchors: ''
     sectlinks: ''
-    id-prefix: ''
-    id-separator: '-'
+    idprefix: ''
+    idseparator: '-'
 
     company: 'DataStax'
     product: 'Product'
@@ -123,4 +123,4 @@ asciidoc:
     glossary-url: 'https://docs.datastax.com/en/glossary/docs/index.html#'
 
   extensions:
-  - ./lib/tabs-block.js
+  - '@asciidoctor/tabs'

playbooks/site-local-astra-cli.yaml

@@ -1,11 +1,12 @@
 site:
   title: DataStax Astra CLI
   url: https://docs.datastax.com/en/astra-cli
-  # The keys.segmentIo site key must be in the site-publish playbook of each
-  # docset. This loads Segment into the docset build, and is a requirement for
-  # collecting site analytics.
+  # The google_analytics and segment_io site keys must be in the release playbook
+  # of each docset. This ensures that the Google Tag Manager (GTM) and Segment
+  # scripts get loaded into the docsets that get published to docs.datastax.com.
   keys:
-    segmentIo: d24gQtyKIUu5mLdkp11xjfiXLhRqx0HH
+    google_analytics: 'GTM-5FSG7Q'
+    segment_io: 'd24gQtyKIUu5mLdkp11xjfiXLhRqx0HH'
 
 output:
   # Bsys requires the output.dir in the site-publish playbook to be specifically
@@ -38,8 +39,8 @@ asciidoc:
     page-pagination: ''
     sectanchors: ''
     sectlinks: ''
-    id-prefix: ''
-    id-separator: '-'
+    idprefix: ''
+    idseparator: '-'
 
     company: 'DataStax'
     product: 'Product'
@@ -131,4 +132,4 @@ asciidoc:
     astra-cli-docs: 'ssh://github.com/datastax/astra-cli-docs.git'
 
   extensions:
-  - ~/work/astra-cli-docs/playbooks/lib/tabs-block.js
+  - '@asciidoctor/tabs'