add Antora xref

Author: tech-comm-team-couchbase

lib/markdown-for-llm.js

@@ -41,18 +41,28 @@ function markdownify(page, pubDate) {
     `[View original HTML](${orig})\n\n` +
     `# ${title}\n\n${markdown}`
 
+  const link = antoraLink(page)
+
   const frontmatter = {
     title,
     description: page.asciidoc.attributes.description,
     editUrl: page.src.editUrl,
     pubDate,
+    link,
   }
 
   output = `---\n${YAML.stringify(frontmatter)}---\n\n${output}`
 
   page.contents = Buffer.from(output)
 }
 
+function antoraLink({src, asciidoc}) {
+  const { relative, version, component, module } = src
+  const vpart = 'page-component-version-is-latest' in asciidoc.attributes ? '' : `${version}@`
+  const coordpart = `${component}:${module}:${relative}`.replace(':ROOT:', '::')
+  return `xref:${vpart}${coordpart}[]`
+}
+
 module.exports.register = function ({ playbook, config }) {
   this.once('contextStarted', () => {
     const { createPageComposer: _delegate } = this.getFunctions()