feat: Fix markdown alternate & add absolute links

HonzaTuron · HonzaTuron · commit 270256e47128 · 2025-08-13T15:37:16.000+02:00
diff --git a/apify-docs-theme/src/theme/Layout/index.jsx b/apify-docs-theme/src/theme/Layout/index.jsx
@@ -16,7 +16,7 @@ export default function LayoutWrapper(props) {
     return (
         <>
             <Head>
-                <link rel="alternate" type="text/markdown" href={`${siteConfig.url}/${currentPath}.md`}/>
+                {currentPath && <link rel="alternate" type="text/markdown" href={`${siteConfig.url}/${currentPath}.md`}/>}
             </Head>
             <div
                 style={{
diff --git a/docusaurus.config.js b/docusaurus.config.js
@@ -5,7 +5,7 @@ const { createApiPageMD } = require('docusaurus-plugin-openapi-docs/lib/markdown
 
 const { config } = require('./apify-docs-theme');
 const { collectSlugs } = require('./tools/utils/collectSlugs');
-const { externalLinkProcessor } = require('./tools/utils/externalLink');
+const { externalLinkProcessor, isInternal } = require('./tools/utils/externalLink');
 
 /** @type {Partial<import('@docusaurus/types').DocusaurusConfig>} */
 module.exports = {
@@ -264,14 +264,23 @@ module.exports = {
         }),
         [
             '@signalwire/docusaurus-plugin-llms-txt',
-            {
+            /** @type {import('@signalwire/docusaurus-plugin-llms-txt').PluginOptions} */
+            ({
                 content: {
                     includeVersionedDocs: false,
                     enableLlmsFullTxt: true,
                     includeBlog: true,
                     includeGeneratedIndex: false,
                     includePages: true,
                     relativePaths: false,
+                    remarkStringify: {
+                        handlers: {
+                            link: (node) => {
+                                const isUrlInternal = isInternal(node.url);
+                                return `[${node.title}](${isUrlInternal ? `${config.absoluteUrl}${node.url}` : node.url})`;
+                            },
+                        },
+                    },
                     excludeRoutes: [
                         '/',
                     ],
@@ -294,7 +303,7 @@ module.exports = {
                         },
                     ],
                 },
-            },
+            }),
         ],
         // TODO this should be somehow computed from all the external sources
         // [
diff --git a/tools/utils/externalLink.js b/tools/utils/externalLink.js
@@ -7,12 +7,12 @@ const internalUrls = ['sdk.apify.com'];
 /**
  * @param {import('url').UrlWithStringQuery} href
  */
-function isInternal(href) {
+exports.isInternal = (href) => {
     return internalUrls.some(
         (internalUrl) => href.host === internalUrl
             || (!href.protocol && !href.host && (href.pathname || href.hash)),
     );
-}
+};
 
 /**
  * @type {import('unified').Plugin}
@@ -27,7 +27,7 @@ exports.externalLinkProcessor = () => {
             ) {
                 const href = parse(node.properties.href);
 
-                if (!isInternal(href)) {
+                if (!exports.isInternal(href)) {
                     node.properties.target = '_blank';
                     node.properties.rel = 'noopener';
                 } else {
