docs update

Author: TencentCloudADP-DevRel

.github/workflows/deploy.yml

@@ -2,7 +2,7 @@ name: Deploy to GitHub Pages
 
 on:
   push:
-    branches: [ docs/plan-b ]
+    branches: [ main, docs/plan-b ]
   workflow_dispatch:
 
 permissions:
@@ -24,7 +24,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '18'
+          node-version: '20'
           cache: 'npm'
 
       - name: Setup Pages
@@ -35,8 +35,13 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
+      - name: Generate Fumadocs MDX files
+        run: npm run postinstall
+
       - name: Build with Next.js
         run: npm run build
+        env:
+          NODE_ENV: production
 
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3

app/[lang]/(home)/page.tsx

@@ -1,4 +1,12 @@
 import { redirect } from 'next/navigation';
+import { i18n } from '@/lib/i18n';
+
+// 生成静态参数，用于静态导出
+export function generateStaticParams() {
+  return i18n.languages.map((lang) => ({
+    lang,
+  }));
+}
 
 export default async function HomePage({
   params,

app/[lang]/docs/layout.tsx

@@ -1,8 +1,16 @@
 import { source } from '@/lib/source';
 import { DocsLayout } from 'fumadocs-ui/layouts/docs';
 import { baseOptions } from '@/app/layout.config';
+import { i18n } from '@/lib/i18n';
 import type { ReactNode } from 'react';
 
+// 生成静态参数，用于静态导出
+export function generateStaticParams() {
+  return i18n.languages.map((lang) => ({
+    lang,
+  }));
+}
+
 export default async function Layout({
   children,
   params

app/[lang]/layout.tsx

@@ -6,6 +6,7 @@ import { use } from 'react';
 import type { ReactNode } from 'react';
 import type { Translations } from 'fumadocs-ui/i18n';
 import type { Metadata } from 'next';
+import { i18n } from '@/lib/i18n';
 
 const inter = Inter({
   subsets: ['latin'],
@@ -16,6 +17,12 @@ const zh: Partial<Translations> = {
   search: '搜索'
 };
 
+// 生成静态参数，用于静态导出
+export function generateStaticParams() {
+  return i18n.languages.map((lang) => ({
+    lang,
+  }));
+}
 
 // 可用语言配置
 const locales = [

app/api/search/route.ts

@@ -1,8 +1,11 @@
 import type { MetadataRoute } from 'next';
 import { i18n } from '@/lib/i18n';
 
-// 获取基本URL，根据环境变量设置或默认为本地开发URL
-const BASE_URL = process.env.NEXT_PUBLIC_BASE_URL || 'https://hellodify.com';
+// 强制静态生成，用于静态导出
+export const dynamic = 'force-static';
+
+// 获取基本URL，根据环境变量设置或默认为 GitHub Pages URL
+const BASE_URL = process.env.NEXT_PUBLIC_BASE_URL || 'https://tencentcloudadp-devrel.github.io/hello-adp-docs';
 
 // 确保 BASE_URL 包含协议前缀
 function formatBaseUrl(url: string): string {

app/sitemap.ts

@@ -3,7 +3,25 @@
 import { useEffect, useState } from 'react';
 import Link from 'next/link';
 import Image from 'next/image';
-import type { ArticleCardView, CategoryLink } from '@/app/[lang]/(home)/page';
+
+// 定义本地类型
+export interface ArticleCardView {
+  id: string;
+  title: string;
+  description?: string;
+  href: string;
+  categoryLabel: string;
+  author?: string;
+  avatar?: string;
+  updatedLabel: string;
+  demoUrl?: string;
+}
+
+export interface CategoryLink {
+  key?: string;
+  label: string;
+  href: string;
+}
 
 interface LandingCopy {
   heroTitle: string;

components/home/LandingShowcase.tsx

@@ -6,7 +6,15 @@ const withMDX = createMDX();
 const config = {
   reactStrictMode: true,
   turbopack: false,
+  
+  // GitHub Pages 静态导出配置
+  output: 'export',
+  trailingSlash: true,
+  basePath: '/hello-adp-docs',
+  assetPrefix: '/hello-adp-docs/',
+  
   images: {
+    unoptimized: true, // 静态导出必需
     remotePatterns: [
       {
         protocol: 'https',
@@ -30,7 +38,7 @@ config.headers = async () => [
     headers: [
       {
         key: 'Content-Security-Policy',
-        value: "frame-ancestors 'self' *.hellodify.com; frame-src 'self' *.hellodify.com http://*.hellodify.com https://*.hellodify.com https://giscus.app https://www.youtube.com https://*.youtube.com https://*.vercel.app https://vercel.com; child-src 'self' *.hellodify.com http://*.hellodify.com https://*.hellodify.com https://giscus.app https://www.youtube.com https://*.youtube.com https://*.vercel.app https://vercel.com; img-src 'self' data: *.hellodify.com http://*.hellodify.com https://*.hellodify.com s2.loli.net https://avatars.githubusercontent.com https://twimg.com https://pbs.twimg.com https://*.github.io https://*.youtube.com https://*.ytimg.com https://*.vercel.app https://vercel.com; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://giscus.app https://www.googletagmanager.com https://www.google-analytics.com; connect-src 'self' https://api.github.com https://www.google-analytics.com https://www.googletagmanager.com https://analytics.google.com;"
+        value: "frame-ancestors 'self' *.tencentcloud.com *.hellodify.com; frame-src 'self' *.tencentcloud.com *.hellodify.com https://giscus.app https://www.youtube.com/embed/ https://*.youtube.com https://*.vercel.app; child-src 'self' *.tencentcloud.com *.hellodify.com https://giscus.app https://www.youtube.com/embed/ https://*.youtube.com https://*.vercel.app; img-src 'self' data: *.tencentcloud.com *.hellodify.com https://avatars.githubusercontent.com https://twimg.com https://pbs.twimg.com https://*.github.io https://*.youtube.com https://*.ytimg.com https://*.vercel.app; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://giscus.app https://www.googletagmanager.com https://www.google-analytics.com; connect-src 'self' https://api.github.com https://www.google-analytics.com https://www.googletagmanager.com https://analytics.google.com;"
       }
     ]
   }

next.config.js

@@ -9,7 +9,7 @@ import { z } from 'zod';
 // You can customise Zod schemas for frontmatter and `meta.json` here
 // see https://fumadocs.vercel.app/docs/mdx/collections#define-docs
 export const docs = defineDocs({
-  dir: 'docs',
+  dir: 'content/docs',
   docs: {
     schema: frontmatterSchema.extend({
       author: z.string().optional(),