docs: update recommendation for canonical urls to use transformPageData instead

docs/reference/site-config.md

@@ -645,19 +645,20 @@ export default {
 }
 ```
 
-#### Example: Adding a canonical URL `<link>`  
+#### Example: Adding a canonical URL `<link>`
 
 ```ts
 export default {
-  transformHead({ page }) {
+  transformPageData(pageData) {
-    // Skip the 404 page
+    const canonicalUrl = `https://example.com/${pageData.relativePath}`
-    if (page !== '404.md') {
+      .replace(/index\.md$/, '')
-      const canonicalUrl = `https://example.com/${page}`
+      .replace(/\.md$/, '.html')
-        .replace(/index\.md$/, '')
+
-        .replace(/\.md$/, '.html')
+    pageData.frontmatter.head ??= []
-
+    pageData.frontmatter.head.push([
-      return [['link', { rel: 'canonical', href: canonicalUrl }]]
+      'link',
-    }
+      { rel: 'canonical', href: canonicalUrl }
+    ])
   }
 }
 ```