Next.js 极速上手

我们来速通创建一个新应用,并用 GT 实现国际化。

概览

在本指南中,我们将介绍两项内容:

  • 创建一个新的 Next.js 应用
  • 使用 General Translation 为其添加国际化

整体用时应少于 10 分钟。

前提条件

我们假设你具备一定的 React 使用经验,并且熟悉 TypeScript。


步骤 1:创建新的 Next.js 应用

首先,在终端中进入任意目录并运行以下命令:

npx create-next-app next-quickstart --ts --tailwind --eslint --app --use-npm --src-dir

会出现一个设置向导,您可以直接为每个选项选择默认值。

步骤 2:安装库

进入你的 Next.js 项目根目录并运行:

cd next-quickstart
npm i gt-next
npm i gtx-cli

步骤 3:添加环境变量

前往 Dashboard。 通过导航栏进入 Dev API Keys 页面,创建新的 API key 和 Project ID。 然后将它们添加到 .env 文件中。

GT_API_KEY="YOUR_GT_API_KEY"
GT_PROJECT_ID="YOUR_GT_PROJECT_ID"

步骤 4:运行 CLI 工具

运行 CLI 工具,为代码库启用翻译支持。

npx gtx-cli setup

步骤 5:修改根布局

src/app/layout.tsx 文件中,修改 <html> 标签的 lang 属性。

应使用 await getLocale() 获取当前 locale。

src/app/layout.tsx
import { GTProvider, getLocale } from "gt-next"; 
...
export default async function RootLayout({
  children,
}: Readonly<{
  children: React.ReactNode;
}>) {
  const locale = await getLocale(); 
  return (
    <html lang={locale}> // [!code highlight]
      <GTProvider>
        <body
          className={`${geistSans.variable} ${geistMono.variable} antialiased`}
        >
        {children}
        </body>
      </GTProvider>
    </html>
  );
}

第 6 步:启动你的应用

你的应用已完成国际化!🎉 来测试一下吧!

先更改浏览器的语言设置。

启动你的 Next.js 应用。

npm run dev

在你常用的浏览器中打开应用(通常为 http://localhost:3000)。 如果一切配置无误,你应该会看到应用按照你在浏览器中设置的语言显示。


疑难解答


备注

  • 使用 <T> 组件翻译任意 JSX。
  • 如果切换语言后翻译未生效,请检查浏览器的 cookies。

下一步

这份指南怎么样?

Next.js 极速上手