Communitygithub.com

ComeOnOliver/skillshub

为 Next.js 网站添加多语言支持,并配置正确的 SEO,包括 hreflang 标签、本地化站点地图和特定语言内容。适用于添加新语言、设置 i18n、优化国际化 SEO,或当用户提及本地化、翻译、多语言或特定语言(如日语、韩语、中文)时。

skillshub 是什么?

该技能(ComeOnOliver/skillshub)提供了一个完整的工作流程,用于在 Next.js 网站中实现多语言支持(国际化),并遵循 SEO 最佳实践。它指导用户从准备基础语言文件、添加新语言文件、更新配置、添加翻译,到配置 SEO 元素(如 hreflang 标签和本地化站点地图)以及验证测试的完整步骤。该技能支持多种语言,包括英语、日语、中文、韩语、葡萄牙语等,并提供了使用 AI 翻译或人工翻译的选项。它适用于任何使用 Next.js 和 `next-intl` 进行路由的项目,能够帮助开发者避免常见的国际化 SEO 错误,如缺少 hreflang 标签或不一致的 URL 结构。完成后,该技能还建议提交更新后的站点地图到 Google Search Console 并监控国际流量。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/zhanlincui/internationalizing-websites

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

网站国际化

为 Next.js 网站添加多语言支持并遵循 SEO 最佳实践的完整工作流程。

何时使用此技能

  • 为现有网站添加新的语言版本
  • 为新网站设置 i18n(国际化)
  • 为多语言配置 SEO
  • 用户提及:“添加语言”、“翻译”、“本地化”、“hreflang”、“多语言”

支持的语言

常见目标市场:

  • 🇺🇸 英语 (en) - 全球市场
  • 🇯🇵 日语 (ja) - 亚洲市场
  • 🇨🇳 中文 (zh) - 中国市场

支持的其他语言:

  • 韩语 (ko)、葡萄牙语 (pt)、西班牙语 (es)、法语 (fr)、德语 (de)
  • 阿拉伯语 (ar)、越南语 (vi)、印地语 (hi)、印尼语 (id)、泰语 (th)
  • 繁体中文 (zh-hk)、意大利语 (it)、俄语 (ru)

国际化工作流程

复制此清单并跟踪进度:

i18n 进度:
- [ ] 步骤 1:准备基础语言文件
- [ ] 步骤 2:添加新的语言文件
- [ ] 步骤 3:更新配置文件
- [ ] 步骤 4:添加翻译
- [ ] 步骤 5:配置 SEO 元素
- [ ] 步骤 6:验证和测试

步骤 1:准备基础语言文件

确保 en.json 文件存在并作为模板:

必要的目录:

  • i18n/messages/en.json - 主要翻译
  • i18n/pages/landing/en.json - 着陆页翻译

验证结构:

# 检查基础文件是否存在
ls i18n/messages/en.json
ls i18n/pages/landing/en.json

如果缺少,请为你的网站创建包含完整翻译键的相应文件。

步骤 2:添加新的语言文件

运行语言添加脚本:

node scripts/i18n-add-languages.mjs

脚本功能:

  • 将 en.json 复制到所有目标语言文件
  • 更新 i18n/locale.ts 以包含新的语言环境
  • 更新 i18n/request.ts 中的语言映射
  • 更新 public/sitemap.xml 以包含新语言 URL

脚本配置(在 i18n-add-languages.mjs 中):

  • languages 数组 - 要添加的语言列表
  • languageNames 对象 - 语言的显示名称
  • targetDirs 数组 - 包含翻译文件的目录

请参阅 WORKFLOW.md 获取详细的分步指南。

步骤 3:验证配置更新

检查 i18n/locale.ts:

export const locales = ["en", "ja", "zh", "ko", ...];

export const localeNames: any = {
  en: "English",
  ja: "日本語",
  zh: "中文",
  ko: "한국어",
  ...
};

检查 i18n/request.ts:

  • 配置了语言代码映射
  • 存在 zh-CN → zh,zh-HK → zh-hk 的映射

检查 public/sitemap.xml:

  • 列出了所有语言版本
  • 每个 URL 都包含 hreflang 标签

步骤 4:添加翻译

选项 A:使用 AI 翻译(更快但需要复查):

# 添加结构化数据和定价翻译
node scripts/i18n-add-schema.js

在脚本的 translations 对象中配置翻译。

选项 B:手动翻译(推荐以保证质量):

使用正确的翻译编辑每个语言文件:

# 打开语言文件
code i18n/messages/ja.json

翻译最佳实践:

  • 尽量使用母语者
  • 在目标语言中保持 SEO 关键词
  • 使内容适应当地文化,不要仅做直译
  • 保持格式一致(占位符、变量)

请参阅 reference/locale-codes.md 了解语言代码参考。

步骤 5:配置 SEO 元素

hreflang 标签 - 通过站点地图自动生成,但需验证:

请参阅 reference/hreflang-guide.md 获取完整指南。

本地化元标签 - 在每个语言文件中翻译:

{
  "metadata": {
    "title": "您的网站标题",
    "description": "您的 SEO 描述"
  }
}

URL 结构 - 验证正确格式:

  • 英语:https://example.com/ 或 https://example.com/en/
  • 日语:https://example.com/ja/
  • 中文:https://example.com/zh/

步骤 6:验证和测试

构建项目:

npm run build

关键:在继续之前修复所有错误。

手动测试:

  1. 语言切换器:

    • 访问每个语言版本
    • 验证语言切换器显示所有语言
    • 点击每个语言链接,验证正确的页面加载
  2. 内容显示:

    • 检查所有页面在每种语言中正确渲染
    • 验证没有未翻译的文本(检查非英语页面中是否有英语内容)
    • 测试特殊字符显示是否正确(日语、中文、阿拉伯语)
  3. SEO 元素:

    • 检查 <html lang="..."> 属性与页面语言匹配
    • 验证存在 <link rel="alternate" hreflang="..."> 标签
    • 检查元标签是否使用正确的语言

自动验证:

# 检查站点地图
curl https://your-site.com/sitemap.xml | grep hreflang

# 验证 hreflang(使用在线工具)
# Google Search Console > 国际化 > hreflang

SEO 清单 - 请参阅 reference/seo-checklist.md。

如果验证失败:

  • 仔细检查错误信息
  • 检查配置文件中是否有拼写错误
  • 验证语言代码是否正确
  • 返回步骤 3 并修复问题

只有在所有验证通过后才能继续。

重要说明

语言代码标准

使用 ISO 639-1(双字母代码),可带有可选区域变体:

  • en - 英语
  • ja - 日语
  • zh - 简体中文
  • zh-hk - 繁体中文(香港)
  • pt - 葡萄牙语
  • pt-br - 巴西葡萄牙语

请参阅 reference/locale-codes.md 获取完整列表。

SEO 影响

正确的 i18n 能改善 SEO,原因如下:

  • 以用户母语定位目标用户
  • 避免重复内容惩罚
  • 帮助搜索引擎提供正确的语言版本

需要避免的常见 SEO 错误:

  • ❌ 基于 IP 自动重定向(阻止搜索引擎抓取所有版本)
  • ❌ 缺少 hreflang 标签(导致重复内容问题)
  • ❌ 跨语言的 URL 结构不一致
  • ❌ 未翻译的元标签

翻译质量

AI 翻译与人工翻译:

  • ✅ AI:快速、经济高效,适合初稿
  • ⚠️ AI:可能遗漏文化细微差别,需要复查
  • ✅ 人工:质量更高,文化适应好
  • ⚠️ 人工:较慢、成本较高

推荐方法:

  1. 使用 AI 生成初始翻译
  2. 请母语者审查和完善
  3. 与目标市场用户进行测试
  4. 根据反馈进行迭代

Next.js i18n 路由

系统使用 next-intl 进行路由:

  • 从 URL 自动检测语言环境
  • 语言切换器组件
  • 本地化导航

配置位于 i18n/locale.ts 和 i18n/request.ts。

国际化后的任务

添加语言后:

  1. 提交更新后的站点地图到 Google Search Console
  2. 为每种语言/区域创建单独的 Search Console 属性
  3. 在 Analytics 中监控国际自然流量
  4. 如果不同语言的转化率不同,A/B 测试翻译
  5. 设置国际抓取错误的警报

脚本位置

所有 i18n 脚本都在 scripts/ 目录中:

  • i18n-add-languages.mjs - 添加新的语言文件
  • i18n-add-schema.js - 添加结构化数据翻译

参考资料

如需故障排除,请参阅 WORKFLOW.md 的故障排除部分。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

相关技能