This is an automated email from the ASF dual-hosted git repository. moonming pushed a commit to branch feat/seo-technical-fixes in repository https://gitbox.apache.org/repos/asf/apisix-website.git
commit 4b7c95423eb5676f93541a7b4d3183506efcf85e Author: Ming Wen <[email protected]> AuthorDate: Mon Jun 22 11:34:49 2026 +0800 fix(seo): remove redundant hreflang plugin Docusaurus already emits canonical and hreflang alternate links natively (via react-helmet) on every page. The custom postBuild plugin in config/hreflang.js (loaded only by the website/ instance) merely re-added a second, duplicate set of hreflang tags. Remove it to keep one source of truth. --- config/hreflang.js | 82 -------------------------------------------- website/docusaurus.config.js | 1 - 2 files changed, 83 deletions(-) diff --git a/config/hreflang.js b/config/hreflang.js deleted file mode 100644 index a0ef7d88dd0..00000000000 --- a/config/hreflang.js +++ /dev/null @@ -1,82 +0,0 @@ -const SITE_URL = 'https://apisix.apache.org'; - -/** - * Docusaurus plugin that injects hreflang <link> tags and canonical URLs - * into every HTML page during the post-build phase. - * - * For each page, it generates: - * <link rel="alternate" hreflang="en" href="https://apisix.apache.org/..."; /> - * <link rel="alternate" hreflang="zh" href="https://apisix.apache.org/zh/..."; /> - * <link rel="alternate" hreflang="x-default" href="https://apisix.apache.org/..."; /> - * <link rel="canonical" href="..." /> (if not already present) - */ -module.exports = function hreflangPlugin() { - return { - name: 'hreflang', - - async postBuild({ outDir }) { - const fs = require('fs'); - const path = require('path'); - - function findHtmlFiles(dir) { - const results = []; - const entries = fs.readdirSync(dir, { withFileTypes: true }); - for (const entry of entries) { - const fullPath = path.join(dir, entry.name); - if (entry.isDirectory()) { - results.push(...findHtmlFiles(fullPath)); - } else if (entry.name.endsWith('.html')) { - results.push(fullPath); - } - } - return results; - } - - const htmlFiles = findHtmlFiles(outDir); - - for (const filePath of htmlFiles) { - let html = fs.readFileSync(filePath, 'utf-8'); - - // Determine relative path from outDir - const relativePath = path.relative(outDir, filePath); - - // Determine the current locale based on file path - const isZh = relativePath.startsWith('zh' + path.sep); - - // Compute the path without locale prefix - const pathWithoutLocale = isZh - ? relativePath.slice(3) // remove "zh/" - : relativePath; - - // Normalize path separators for URL - const urlPath = pathWithoutLocale.split(path.sep).join('/'); - - // Build URLs - const enUrl = `${SITE_URL}/${urlPath}`.replace(/\/index\.html$/, '/'); - const zhUrl = `${SITE_URL}/zh/${urlPath}`.replace(/\/index\.html$/, '/'); - const currentUrl = isZh ? zhUrl : enUrl; - - // Build hreflang tags - const hreflangTags = [ - `<link rel="alternate" hreflang="en" href="${enUrl}" />`, - `<link rel="alternate" hreflang="zh" href="${zhUrl}" />`, - `<link rel="alternate" hreflang="x-default" href="${enUrl}" />`, - ].join('\n '); - - // Add canonical tag if not already present - const hasCanonical = html.includes('rel="canonical"'); - const canonicalTag = hasCanonical - ? '' - : `<link rel="canonical" href="${currentUrl}" />`; - - // Inject before </head> - const injection = [hreflangTags, canonicalTag] - .filter(Boolean) - .join('\n '); - html = html.replace('</head>', ` ${injection}\n </head>`); - - fs.writeFileSync(filePath, html, 'utf-8'); - } - }, - }; -}; diff --git a/website/docusaurus.config.js b/website/docusaurus.config.js index 0cb370dfac7..ec15903c283 100644 --- a/website/docusaurus.config.js +++ b/website/docusaurus.config.js @@ -109,7 +109,6 @@ module.exports = { ], ['docusaurus-plugin-sass', {}], require.resolve('../config/schema-org'), - require.resolve('../config/hreflang'), ], themeConfig: { navbar: {
