moonming opened a new pull request, #2024: URL: https://github.com/apache/apisix-website/pull/2024
## Summary SEO P0 fixes to address critical gaps identified in a comprehensive audit comparing apisix.apache.org vs konghq.com keyword rankings. ### Technical SEO - **Global OG meta tags**: Added `og:site_name`, `og:type`, `og:image` to `docusaurus.config.js` for consistent social sharing previews - **Hreflang plugin**: New `config/hreflang.js` Docusaurus plugin that injects `hreflang` alternate links (en/zh/x-default) and canonical URLs into all HTML pages during post-build - **Chinese homepage title localization**: Homepage title now uses `translate()` for proper i18n — Chinese locale renders "Apache APISIX - 开源云原生 API 网关与 AI 网关" - **Homepage meta**: Added `og:title`, `og:url`, and canonical link ### Learning Center (new section) - New `/learning-center/` route via Docusaurus blog plugin instance - Added "Learning Center" link to the main navigation bar (between Docs and Blog) - **"What is an API Gateway?"** — ~2,500-word authoritative article targeting `api gateway` (6,600/mo), `what is an api gateway` (720/mo), and 15+ keyword variants totaling ~10,000+ monthly searches. Currently APISIX ranks #25-88 for these keywords vs Kong's #3-9. - **"What is API Management?"** — ~2,500-word article targeting `api management` (1,900/mo), `apim` (2,400/mo), and 10+ variants totaling ~7,000+ monthly searches ### AI Gateway Page Optimization - Rewrote title to target "what is an AI gateway" keyword (880/mo search volume) - Expanded meta description with AI gateway definition and MCP protocol mention - Added FAQPage structured data (JSON-LD) with 3 AI gateway Q&As for rich SERP results - Added canonical URL and og:url ## Context Keyword gap analysis shows Kong dominates through a systematic "Learning Center" content strategy — ~70+ keywords are served by dedicated educational pages at `konghq.com/blog/learning-center/`. APISIX currently routes most of these keywords to the homepage, which cannot compete with focused content. This PR establishes the Learning Center foundation and addresses the two highest-value content gaps. ## Test plan - [ ] `yarn build` succeeds for the website package - [ ] Verify `/learning-center/` route renders with both articles - [ ] Verify "Learning Center" appears in the top navigation bar - [ ] Verify `/ai-gateway/` page has updated title and FAQPage structured data in source - [ ] Verify built HTML files contain hreflang tags (check any `.html` in build output) - [ ] Verify Chinese homepage has localized title - [ ] Verify `/learning-center/what-is-an-api-gateway/` and `/learning-center/what-is-api-management/` are accessible -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
