Skip to content

DOC-3497 - Fix self-referencing canonical URLs on v5 pages#4118

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

DOC-3497 - Fix self-referencing canonical URLs on v5 pages#4118
kemister85 wants to merge 1 commit intotinymce/5from
hotfix/5/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 14 pages on the tinymce/5 branch that were renamed or restructured in v6+. These pages currently have self-referencing canonical URLs because Antora cannot match their page IDs to a v8 equivalent, causing Google to treat them as authoritative and rank them above the current documentation.

Framework integrations (8 pages):

  • react.adoc/latest/react-cloud/
  • vue.adoc/latest/vue-cloud/
  • svelte.adoc/latest/svelte-cloud/
  • webcomponent.adoc/latest/webcomponent-cloud/
  • rails.adoc/latest/rails-cloud/
  • django.adoc/latest/django-cloud/
  • bootstrap.adoc/latest/bootstrap-cloud/
  • laravel.adoc/latest/laravel-tiny-cloud/

Plugin/feature pages (6 pages):

  • paste.adoc/latest/copy-and-paste/
  • quick-start.adoc/latest/cloud-quick-start/
  • spellchecker.adoc/latest/spelling/
  • noneditable.adoc/latest/non-editable-content-options/
  • template.adoc/latest/advanced-templates/
  • export.adoc/latest/exportpdf/

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

Companion PR: #4119 (v6 branch — 2 pages)

…d in later versions

Pages renamed or split between v5 and v6+ have self-referencing
canonical URLs because Antora cannot match their page IDs to a
v8 equivalent. This causes Google to treat legacy pages as
authoritative, ranking them above current documentation.

Adds :page-canonical-url: attributes to 14 affected pages pointing
to their latest equivalents.
@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/5/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