docs: stop repeating the section prefix in generated Markdown links (#1070)

Part of apify/apify-web#6665

`@signalwire/docusaurus-plugin-llms-txt@1.2.2` prepends the site URL to
link paths that already carry the Docusaurus `baseUrl`, so the generated
Markdown points at
`https://docs.apify.com/api/client/python/api/client/python/...`, which
404s. It only happens on sites served under a sub-path.

The fix is already upstream in `2.0.0-alpha.6`, but it does not look
like it will be published soon: npm `latest` is still 1.2.2 and nothing
has shipped since `2.0.0-alpha.7` in November 2025. This patch applies
that same fix locally. Remove it once a stable 2.x lands.

Built here: `llms-full.txt` goes from 4702 doubled links to 0,
`llms.txt` stays at 352 correct links.

The same patch goes into `apify-cli`, `apify-sdk-js`, `apify-sdk-python`
and `apify-client-js`.

Author: marekh19

website/docusaurus.config.js

@@ -158,6 +158,7 @@ module.exports = {
                     includePages: true,
                     relativePaths: false,
                     excludeRoutes: [
+                        '/api/client/python/',
                         '/api/client/python/reference/[0-9]*/**',
                         '/api/client/python/reference/[0-9]*',
                         '/api/client/python/reference/next/**',

website/patches/@signalwire__docusaurus-plugin-llms-txt@1.2.2.patch

@@ -0,0 +1,37 @@
+diff --git a/lib/utils/url.js b/lib/utils/url.js
+index 0c3168c9128b6abd1a0860b222872b2332dc5ab8..303ac39b92e24c9008924c949ecf91c6746c38cc 100644
+--- a/lib/utils/url.js
++++ b/lib/utils/url.js
+@@ -56,19 +56,31 @@ export function stripBaseUrl(routePath, baseUrl) {
+  */
+ export function formatUrl(routePath, options, baseUrl = '') {
+     const { enableMarkdownFiles = true, relativePaths = true, markdownFile, } = options;
++    // routePath and markdownFile may already carry the Docusaurus baseUrl. Strip it, or the
++    // section prefix lands in the URL twice. Stripping before the .md suffix is what keeps a
++    // route that is the site root on the INDEX_MD branch instead of producing '/.md'.
++    const sitePath = relativePaths === false && baseUrl
++        ? (baseUrl.replace(/^[a-z][a-z0-9+.-]*:\/\/[^/]*/i, '') || '/')
++        : null;
+     // Ensure route path starts with /
+     let targetPath = ensureLeadingSlash(routePath);
++    if (sitePath) {
++        targetPath = stripBaseUrl(targetPath, sitePath);
++    }
+     // Use markdown file path if available and enabled
+     if (enableMarkdownFiles && markdownFile) {
+         // Ensure markdown file path starts with / for consistency
+         targetPath = ensureLeadingSlash(markdownFile);
++        if (sitePath) {
++            targetPath = stripBaseUrl(targetPath, sitePath);
++        }
+     }
+     else if (enableMarkdownFiles) {
+         // Add .md extension to route path
+         targetPath = targetPath === '/' ? INDEX_MD : `${targetPath}.md`;
+     }
+     // Handle absolute vs relative paths
+-    if (relativePaths === false && baseUrl) {
++    if (sitePath) {
+         return normalizeUrl([baseUrl, targetPath]);
+     }
+     // For relative paths, ensure we preserve the leading slash

website/pnpm-lock.yaml

@@ -13,3 +13,5 @@ allowBuilds:
   '@swc/core': true
   core-js: false
   unrs-resolver: true
+patchedDependencies:
+  '@signalwire/docusaurus-plugin-llms-txt@1.2.2': patches/@signalwire__docusaurus-plugin-llms-txt@1.2.2.patch