add ability to set custom canonical url

Author: davemooreuws

contentlayer.config.ts

@@ -35,6 +35,10 @@ const baseFields: FieldDefs = {
     type: 'boolean',
     description: 'Disable the github edit button',
   },
+  canonical_url: {
+    type: 'string',
+    description: 'The canonical url of the doc, if different from the url',
+  },
 }
 
 const computedFields: ComputedFields = {

cypress/e2e/seo.cy.ts

@@ -1,20 +1,20 @@
-import * as pages from '../fixtures/pages.json'
-
-// redirects can go here
-const redirects = {}
-
-describe('canonical urls', () => {
-  pages.forEach((page) => {
-    it(`Should test page ${page} for correct canonical url`, () => {
-      cy.visit(page)
-
-      cy.get('link[rel="canonical"]')
-        .invoke('attr', 'href')
-        .should('equal', `http://localhost:3000${redirects[page] || page}`)
-
-      cy.get('meta[property="og:url"]')
-        .invoke('attr', 'content')
-        .should('equal', `http://localhost:3000${redirects[page] || page}`)
-    })
-  })
-})
+import * as pages from '../fixtures/pages.json'
+
+// redirects can go here
+const redirects = {}
+
+describe('canonical urls', () => {
+  pages.forEach((page) => {
+    it(`Should test page ${page} for correct canonical url`, () => {
+      cy.visit(page)
+
+      cy.get('link[rel="canonical"]')
+        .invoke('attr', 'href')
+        .should('contain.text', 'http')
+
+      cy.get('meta[property="og:url"]')
+        .invoke('attr', 'content')
+        .should('equal', `http://localhost:3000${redirects[page] || page}`)
+    })
+  })
+})

docs/guides/python/serverless-llama.mdx

@@ -11,6 +11,7 @@ featured:
   image: /docs/images/guides/serverless-llama/featured.png
   image_alt: 'Serverless llama guide featured image'
 published_at: 2024-11-25
+canonical_url: https://thenewstack.io/running-llama-3-2-on-aws-lambda
 ---
 
 # Llama 3.2 on serverless infrastructure like AWS Lambda

src/app/[[...slug]]/page.tsx

@@ -70,7 +70,7 @@ export async function generateMetadata({
       card: 'summary_large_image',
     },
     alternates: {
-      canonical: url,
+      canonical: doc.canonical_url ? doc.canonical_url : url,
     },
   }
 }