(apisix-website) 04/05: feat(seo): add an H1 heading to the blog list page

[we...@apache.org]

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 49ba121b261c117f3aafab870b6718f5fb3a4c04
Author: Ming Wen <mo...@gmail.com>
AuthorDate: Mon Jun 22 11:34:49 2026 +0800

    feat(seo): add an H1 heading to the blog list page
    
    The default Docusaurus blog index renders no H1, an on-page SEO gap.
---
 blog/src/theme/BlogListPage/index.tsx | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/blog/src/theme/BlogListPage/index.tsx b/blog/src/theme/BlogListPage/index.tsx
index 531ae9cf479..6b850461ec1 100644
--- a/blog/src/theme/BlogListPage/index.tsx
+++ b/blog/src/theme/BlogListPage/index.tsx
@@ -22,6 +22,9 @@ const BlogListPage: FC<Props> = (props) => {
   const { blogDescription, blogTitle, permalink } = metadata;
   const isBlogOnlyMode = permalink === '/';
   const title = isBlogOnlyMode ? siteTitle : blogTitle;
+  // Visible H1 for the blog list page. The default Docusaurus blog index ships
+  // without one, which is an on-page SEO gap (every indexable page needs an H1).
+  const headingTitle = isBlogOnlyMode ? siteTitle : `${siteTitle} ${blogTitle}`;
 
   return (
     <BlogLayout
@@ -34,6 +37,7 @@ const BlogListPage: FC<Props> = (props) => {
       sidebar={sidebar}
       toc={false}
     >
+      <h1 className="margin-bottom--lg">{headingTitle}</h1>
       <BlogPosts
         itemType="http://schema.org/Blog"
         items={items}