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

Fix links to connector incremental snapshots topic

    XMLWordPrintable

Details

    Description

      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).

      Attachments

        Issue Links

          Activity

            People

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

              Dates

                Created:
                Updated:
                Resolved: