This is an automated email from the ASF dual-hosted git repository. Yilialinn pushed a commit to branch fix/navbar-broken-links-proper in repository https://gitbox.apache.org/repos/asf/apisix-website.git
commit 6c535dcd75df6e1524bc699c4ba4ecf55fd13a62 Author: Yilia Lin <[email protected]> AuthorDate: Wed May 13 15:36:11 2026 +0800 fix: use absolute URLs for cross-workspace navigation links Fix doc workspace build failures by converting relative links to absolute URLs for paths that exist in the website workspace but not in the doc workspace. Changes: - config/navbar.js: Convert blog, learning-center, downloads, help, team, showcase, and plugins links from relative paths to absolute URLs - doc/src/theme/Footer/index.tsx: Convert blog, showcase, and plugins links to absolute URLs - doc/src/theme/NotFound/index.tsx: Convert homepage link to absolute URL This prevents Docusaurus from treating cross-workspace links as internal broken links during isolated doc workspace builds, while maintaining the same user experience (links still work correctly with target='_parent'). Fixes build failures seen in CI runs starting from May 13, 2026. Related: https://github.com/apache/apisix-website/actions/runs/25147485898 --- config/navbar.js | 16 ++++++++-------- doc/src/theme/Footer/index.tsx | 6 +++--- doc/src/theme/NotFound/index.tsx | 2 +- 3 files changed, 12 insertions(+), 12 deletions(-) diff --git a/config/navbar.js b/config/navbar.js index 44c6defd7ff..a55a1e8d9d9 100644 --- a/config/navbar.js +++ b/config/navbar.js @@ -53,37 +53,37 @@ module.exports = [ ], }, { - to: '/learning-center', + href: 'https://apisix.apache.org/learning-center/', label: 'Learning Center', position: 'right', target: '_parent', }, { - to: '/blog', + href: 'https://apisix.apache.org/blog/', label: 'Blog', position: 'right', target: '_parent', }, { - to: '/blog/tags/case-studies', + href: 'https://apisix.apache.org/blog/tags/case-studies/', label: 'Case Studies', position: 'right', target: '_parent', }, { - to: '/downloads', + href: 'https://apisix.apache.org/downloads/', label: 'Downloads', position: 'right', target: '_parent', }, { - to: '/help', + href: 'https://apisix.apache.org/help/', label: 'Help', position: 'right', target: '_parent', }, { - to: 'team', + href: 'https://apisix.apache.org/team/', label: 'Team', position: 'right', target: '_parent', @@ -93,7 +93,7 @@ module.exports = [ position: 'right', items: [ { - to: '/showcase', + href: 'https://apisix.apache.org/showcase/', label: 'Showcase', target: '_parent', }, @@ -103,7 +103,7 @@ module.exports = [ target: '_parent', }, { - to: '/plugins', + href: 'https://apisix.apache.org/plugins/', label: 'PluginHub', target: '_parent', }, diff --git a/doc/src/theme/Footer/index.tsx b/doc/src/theme/Footer/index.tsx index 6227874c5c7..301fcce0a2b 100644 --- a/doc/src/theme/Footer/index.tsx +++ b/doc/src/theme/Footer/index.tsx @@ -78,15 +78,15 @@ const footer = { items: [ { label: 'Blog', - to: '/blog/', + href: 'https://apisix.apache.org/blog/', target: '_parent', }, { label: 'Showcase', - to: '/showcase', + href: 'https://apisix.apache.org/showcase/', target: '_parent', }, { label: 'Plugin Hub', - to: '/plugins', + href: 'https://apisix.apache.org/plugins/', target: '_parent', }, { diff --git a/doc/src/theme/NotFound/index.tsx b/doc/src/theme/NotFound/index.tsx index f8c6490bf6d..e582c560689 100644 --- a/doc/src/theme/NotFound/index.tsx +++ b/doc/src/theme/NotFound/index.tsx @@ -33,7 +33,7 @@ const NotFound: FC = () => ( <p> You can also return to {' '} - <Link href="/"> + <Link href="https://apisix.apache.org/";> the home page </Link> . Or, return to
