Skip to content

DOC-3497 - Fix self-referencing canonical URLs on v6 pages#4119

Closed
kemister85 wants to merge 1 commit intotinymce/6from
hotfix/6/DOC-3497
Closed

DOC-3497 - Fix self-referencing canonical URLs on v6 pages#4119
kemister85 wants to merge 1 commit intotinymce/6from
hotfix/6/DOC-3497

Conversation

@kemister85
Copy link
Copy Markdown
Contributor

@kemister85 kemister85 commented Apr 27, 2026

Ticket

DOC-3497 / TINY-14151

Site

Changes

Adds :page-canonical-url: attributes to 2 pages on the tinymce/6 branch that were renamed in v8. These pages currently have self-referencing canonical URLs because Antora cannot match their page IDs to a v8 equivalent.

  • template.adoc/latest/advanced-templates/
  • export.adoc/latest/exportpdf/

Each change is a single metadata line addition; no content changes.

Companion PR: #4118 (v5 branch — 14 pages)

…d in v8

The template and export pages were renamed in v8 (to advanced-templates
and exportpdf respectively). Without explicit canonical URLs, Antora
falls back to self-referencing canonicals on these v6 pages.

Adds :page-canonical-url: attributes to 2 affected pages.
@kemister85
Copy link
Copy Markdown
Contributor Author

Closing in favour of #4126, which uses :page-aliases: on the tinymce/8 branch instead.

The :page-canonical-url: attribute used here sets page.attributes.canonical-url in the Antora UI model, but the template reads from page.canonicalUrl (Antora's computed value) — so the attribute doesn't reach the <link rel="canonical"> tag.

The correct Antora mechanism is page-aliases on the latest version pages to claim the old page IDs. This fixes canonicals for both v5 and v6 from a single change on v8. See Antora canonical URL docs.

@kemister85 kemister85 closed this Apr 28, 2026
@kemister85 kemister85 deleted the hotfix/6/DOC-3497 branch April 28, 2026 05:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant