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

* Migrate to official @asciidoctor/tabs extension

* Fix attributes in README

* Remove CODEOWNERS file

* Align local/publish Antora build commands

* Update GTM and Segment site keys

Author: eric-schneider

README.adoc

@@ -1,6 +1,7 @@
-= {company} Zero Downtime Migration (ZDM) Documentation
+= {company} {product} Documentation
 :toc: macro
-:product: Zero Downtime Migration
+:company: DataStax
+:product: Zero Downtime Migration (ZDM)
 :product-repo-name: migration-docs
 :product-repo-name-long: datastax/migration-docs
 :product-repo-link: https://github.com/datastax/migration-docs.git
@@ -16,7 +17,7 @@
 :contributor-docs-link: https://docs.google.com/presentation/d/10RjxURHpJ8gwac0dCZ02pKo31nGhem29Z8-xERApyWU/edit?usp=sharing
 :web-server-link: https://www.npmjs.com/package/serve
 
-This repo contains the documentation source files for the {company} {zdm-product} documentation.
+This repo contains the documentation source files for the {company} {product} documentation.
 
 The docs are written in {asciidoctor-link}[AsciiDoc] and use {antora-link}[Antora] to generate the HTML output.
 
@@ -26,7 +27,7 @@ toc::[]
 
 Although this repo is maintained by the {company} Docs team, contributions from the community are gratefully accepted, and encouraged.
 
-_Why should you contribute to the {zdm-product} docs?_::
+_Why should you contribute to the {product} docs?_::
 * It makes the Docs team's job easier.
 * It makes your job easier.
 * It helps {company} and Cassandra users more quickly.
@@ -38,7 +39,7 @@ You can contribute to the documentation by adding content to, or editing, the As
 For instructions, see <<writing-asciidoc>> below.
 
 [[writing-asciidoc]]
-== Working with {zdm-product} docs
+== Working with {product} docs
 
 Before following the steps below, first make sure that you have {install-git-link}[git] installed on your computer.
 

docs-src/.DS_Store

@@ -3,7 +3,7 @@
   "scripts": {
     "build:prod:zdm": "npm run build:publish:zdm",
     "build:dev:zdm": "npm run build:local:zdm",
-    "build:publish:zdm": "antora --log-level error --fetch --clean playbooks/site-publish-zdm.yaml",
+    "build:publish:zdm": "antora --stacktrace --fetch --clean playbooks/site-publish-zdm.yaml",
     "build:local:zdm": "antora --stacktrace --fetch --clean playbooks/site-local-zdm.yaml",
     "build:linkinator:zdm": "npx linkinator https://docs.datastax.com/en/zdm/docs/ --recurse --skip ' https://localhost?'"
   },
@@ -12,10 +12,11 @@
     "url": "git+https://github.com/datastax/migration-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",

package.json

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

playbooks/lib/tabs-block.js

@@ -1,11 +1,12 @@
 site:
   title: DataStax Zero Downtime Migration
   url: https://docs.datastax.com/en/zdm/docs
-  # 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'
     zdm-product: 'Zero Downtime Migration'
@@ -136,5 +137,5 @@ asciidoc:
     # "<repo-name>: 'ssh://github.com/<org-name>/<repo-name>.git'".
     migration-docs: 'ssh://github.com/datastax/migration-docs.git'
 
-    extensions:
-    - '~/work/migration-docs/playbooks/lib/tabs-block.js'
+  extensions:
+  - '@asciidoctor/tabs'