Uploaded image for project: 'Debezium'
  1. Debezium
  2. DBZ-4552

Fix links to connector incremental snapshots topic

XMLWordPrintable

      In the documentation for each of the connectors, the link from the Ad hoc snapshots topic to the Incremental snapshots topic was generating errors in the upstream build Antora build:

      Generating Antora documentation using configuration: playbook_author.yml
      [19:18:04.786] ERROR (asciidoctor): target of xref not found:

      Unknown macro: {link-db2-connector}

      .adoc#db2-incremental-snapshots
      file: /debezium/documentation/modules/ROOT/pages/connectors/db2.adoc
      source: /debezium (refname: main <worktree>, start path: documentation)
      [19:18:05.285] ERROR (asciidoctor): target of xref not found:

      Unknown macro: {link-mongodb-connector}

      .adoc#mongodb-incremental-snapshots
      file: /debezium/documentation/modules/ROOT/pages/connectors/mongodb.adoc
      source: /debezium (refname: main <worktree>, start path: documentation)
      [19:18:06.008] ERROR (asciidoctor): target of xref not found:

      Unknown macro: {link-mysql-connector}

      .adoc#mysql-incremental-snapshots
      file: /debezium/documentation/modules/ROOT/pages/connectors/mysql.adoc
      source: /debezium (refname: main <worktree>, start path: documentation)
      [19:18:06.945] ERROR (asciidoctor): target of xref not found:

      Unknown macro: {link-oracle-connector}

      .adoc#oracle-incremental-snapshots
      file: /debezium/documentation/modules/ROOT/pages/connectors/oracle.adoc
      source: /debezium (refname: main <worktree>, start path: documentation)
      [19:18:07.820] ERROR (asciidoctor): target of xref not found:

      Unknown macro: {link-postgresql-connector}

      .adoc#postgresql-incremental-snapshots
      file: /debezium/documentation/modules/ROOT/pages/connectors/postgresql.adoc
      source: /debezium (refname: main <worktree>, start path: documentation)
      [19:18:08.597] ERROR (asciidoctor): target of xref not found:

      Unknown macro: {link-sqlserver-connector}

      .adoc#sqlserver-incremental-snapshots
      file: /debezium/documentation/modules/ROOT/pages/connectors/sqlserver.adoc
      source: /debezium (refname: main <worktree>, start path: documentation)
      [19:18:08.684] ERROR (asciidoctor): target of xref not found: configuration/signalling.adocdebezium-signaling-enabling-signaling
      file: /debezium/documentation/modules/ROOT/pages/connectors/sqlserver.adoc
      source: /debezium (refname: main <worktree>, start path: documentation)

      Modify the existing link format in the shared partial file con-connector-ad-hoc-snapshots.adoc

      from:
      xref:{link-{context}-connector}#{context}-incremental-snapshots[Incremental snapshots]

      to:
      xref:#{context}-incremental-snapshots[Incremental snapshots]

      Also, insert a "#" that is missing in the properties table link in sqlserver.adoc (last item in the preceding error report).

            broldan@redhat.com Robert Roldan
            broldan@redhat.com Robert Roldan
            Votes:
            0 Vote for this issue
            Watchers:
            5 Start watching this issue

              Created:
              Updated:
              Resolved: