Details
-
Task
-
Resolution: Done
-
Major
-
None
-
None
-
False
-
False
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
- is related to
-
DBZ-4638 Broken link in https://debezium.io/documentation/reference/stable/connectors/sqlserver.html
-
- Closed
-