# General Translation React SDKs (gt-react, gt-next, gt-react-native): Next.js
URL: https://generaltranslation.com/fr/docs/react/nextjs.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Découvrez les fonctionnalités propres à Next.js dans General Translation, notamment les composants serveur, les fonctions serveur, le plugin de configuration, le routage par paramètre régional, l’enregistrement du paramètre régional de la requête et la navigation localisée.

`gt-next` partage les mêmes composants, hooks et la même configuration que le reste de l’écosystème React de General Translation, mais Next.js offre aussi quelques fonctionnalités qu’aucun autre framework ne propose. Ces pages couvrent les aspects qui s’appliquent uniquement à `gt-next`.

Si vous débutez, suivez le [Quickstart Next.js App Router](/docs/react/nextjs-quickstart) ou le [Quickstart Next.js Pages Router](/docs/react/nextjs-pages-router-quickstart). Les [Guides](/docs/react/guides/configuring) et la [Référence](/docs/react/reference/config) communs couvrent tout ce qui fonctionne de la même manière dans les différents frameworks ; les pages de cette section couvrent uniquement les spécificités de Next.js.

*Remarque : `gt-next` prend en charge Next.js 13.0.0 ou version ultérieure, à l’exception de Next.js 15.2.1 et 15.2.2.*

## Ce qui est spécifique à Next.js [#overview]

La majeure partie de `gt-next` repose sur l’API React partagée. Les éléments spécifiques à Next.js sont les suivants :

* **Composants serveur.** Dans l’App Router, le composant [`<T>`](/docs/react/reference/components/t) et les crochets de traduction fonctionnent dans des composants serveur de React synchrones sans directive `'use client'`. Les composants async utilisent des fonctions de `gt-next/server`. Voir [Composants serveur](/docs/react/nextjs/server-components).
* **Fonctions serveur.** Le point d’entrée `gt-next/server`, uniquement disponible avec l’App Router, expose des fonctions async comme [`getGT`](/docs/react/nextjs/reference/functions/get-gt), [`getLocale`](/docs/react/nextjs/reference/functions/get-locale) et [`getRegion`](/docs/react/nextjs/reference/functions/get-region).
* **Le plugin de configuration.** `withGTConfig` de `gt-next/config` intègre l’internationalisation à votre build dans `next.config`. Voir [Configuration](/docs/react/nextjs/config).
* **Routage par paramètre régional.** L’App Router utilise `gt-next/middleware` ; le Pages Router utilise le routage internationalisé de Next.js. Suivez le guide [Middleware de l’App Router](/docs/react/nextjs/app-router-middleware) ou [Routage par paramètre régional du Pages Router](/docs/react/nextjs/pages-router-middleware).
* **Enregistrement du paramètre régional de la requête.** Les gestionnaires de route et les images de métadonnées générées enregistrent les paramètres régionaux avant d’appeler les fonctions serveur de l’App Router. Voir [Enregistrement des paramètres régionaux de la requête](/docs/react/nextjs/registering-request-locales).

- **Cache Components.** Le contenu serveur mis en cache utilise des fonctions de requête explicites et des traductions stockées localement. Voir [Utilisation des Cache Components](/docs/react/nextjs/cache-components).
- **SEO des alias de paramètres régionaux.** Les URL basées sur des alias nécessitent des métadonnées canoniques BCP 47 et des entrées de sitemap. Voir [Gestion du SEO des alias de paramètres régionaux](/docs/react/nextjs/locale-alias-seo).

* **Navigation localisée.** Dans l’App Router, le composant `<Link>` de `gt-next/link` ajoute le préfixe du paramètre régional actif aux `href` internes. Voir [Navigation localisée](/docs/react/nextjs/link).

## Pages [#pages]

| Page                                                                                                   | Description                                                                                                                |
| ------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------- |
| [Composants serveur](/docs/react/nextjs/server-components)                                             | Traduisez dans les composants serveur de React et comprenez les différences de comportement entre le serveur et le client. |
| [`getGT`](/docs/react/nextjs/reference/functions/get-gt)                                               | Commencez par la référence de la fonction `gt-next/server`, disponible uniquement avec l’App Router.                       |
| [Configuration](/docs/react/nextjs/config)                                                             | Le plugin `withGTConfig`, ses options, et les traductions locales ou via CDN.                                              |
| [Middleware de l’App Router](/docs/react/nextjs/app-router-middleware)                                 | Routage par paramètre régional et segment `app/[locale]`.                                                                  |
| [Enregistrement des paramètres régionaux de la requête](/docs/react/nextjs/registering-request-locales) | Enregistrez le contexte du paramètre régional dans les gestionnaires de route et les métadonnées générées.                 |
| [Utilisation des Cache Components](/docs/react/nextjs/cache-components)                                | Mettez en cache le contenu serveur localisé sans API de requête dynamiques.                                                |
| [Routage par paramètre régional du Pages Router](/docs/react/nextjs/pages-router-middleware)           | Routage internationalisé de Next.js, détection du paramètre régional et navigation.                                        |
| [Génération de site statique App Router](/docs/react/nextjs/app-router-static-site-generation)         | Pré-générez une route App Router par paramètre régional.                                                                   |
| [Génération de site statique Pages Router](/docs/react/nextjs/pages-router-static-site-generation)     | Pré-générez les pages Pages Router avec `withGTStaticProps`.                                                               |
| [Gestion du SEO des alias de paramètres régionaux](/docs/react/nextjs/locale-alias-seo)      | Conservez les alias dans les URL et les codes de langue canoniques dans les métadonnées de recherche.                      |
| [Navigation localisée](/docs/react/nextjs/link)                                                        | Le composant `<Link>` de l’App Router, adapté au paramètre régional, de `gt-next/link`.                                    |

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.
