From d296253b4b7d28adf710c1da3f49f378d5e79bc4 Mon Sep 17 00:00:00 2001 From: Armand Philippot Date: Thu, 19 Mar 2026 15:27:39 +0100 Subject: [PATCH 1/2] i18n(fr): add `modules/astro-static-paths.mdx` See #12322 --- .../reference/modules/astro-static-paths.mdx | 74 +++++++++++++++++++ 1 file changed, 74 insertions(+) create mode 100644 src/content/docs/fr/reference/modules/astro-static-paths.mdx diff --git a/src/content/docs/fr/reference/modules/astro-static-paths.mdx b/src/content/docs/fr/reference/modules/astro-static-paths.mdx new file mode 100644 index 0000000000000..0bb08ccc4764e --- /dev/null +++ b/src/content/docs/fr/reference/modules/astro-static-paths.mdx @@ -0,0 +1,74 @@ +--- +title: Référence de l'API des chemins statiques +sidebar: + label: 'astro:static-paths' +i18nReady: true +tableOfContents: + minHeadingLevel: 2 + maxHeadingLevel: 6 +--- +import ReadMore from '~/components/ReadMore.astro'; +import Since from '~/components/Since.astro'; + +

+ +Ce module fournit des utilitaires pour aider les adaptateurs à collecter les chemins statiques depuis leur environnement d'exécution cible (par exemple, `workerd`). Il n'offre une implémentation fonctionnelle que dans l'environnement `prerender` de Vite. Dans les autres environnements, il renvoie une implémentation sans opération. + +## Importations depuis `astro:static-paths` + +```js +import { + StaticPaths, +} from 'astro:static-paths'; +``` + +### `StaticPaths` + +Permet aux adaptateurs de collecter tous les chemins qui doivent être pré-rendus à partir de leur environnement d'exécution cible. Ceci est utile lors de la [mise en œuvre d'un pré-rendu personnalisé](/fr/reference/adapter-reference/#custom-prerenderer) exécuté dans un environnement non-Node : + +Le constructeur `StaticPaths` accepte un [manifeste SSR](/en/reference/integrations-reference/#ssrmanifest) obligatoire et un objet décrivant le cache de routes et fournissant une méthode d'accès au composant utilisé pour le rendu de la route. La méthode préférée pour initialiser une instance `StaticPaths` consiste à lui passer une [instance d'application](/fr/reference/modules/astro-app/#linstance-app). + +L'exemple suivant initialise une instance `StaticPaths` à partir d'une application dans un point d'entrée de serveur d'adaptateur : + +```js title="my-adapter/server.js" +import { createApp } from 'astro/app/entrypoint'; +import { StaticPaths } from 'astro:static-paths'; + +const app = createApp(); +const staticPaths = new StaticPaths(app); + +export const handler = (event, context) => { + // faire quelque chose avec `staticPaths` +}; +``` + +#### `StaticPaths.getAll()` + +

+ +**Type :** () => Promise\RouteData \}\>\> +

+ +Récupère tous les chemins qui doivent être pré-rendus. Cette fonction renvoie une promesse qui se résout en un tableau d'objets décrivant le chemin de la route et ses données. + +L'exemple suivant collecte tous les chemins statiques à pré-générer avant de les renvoyer en tant que `Response` dans un gestionnaire d'adaptateur : + +```js title="my-adapter/handler.js" +import { StaticPaths } from 'astro:static-paths'; + +export function createHandler(app) { + return async (request) => { + const { pathname } = new URL(request.url); + + // Point de terminaison pour collecter les chemins statiques lors de la compilation + if (pathname === '/__astro_static_paths') { + const staticPaths = new StaticPaths(app); + const paths = await staticPaths.getAll(); + // Renvoie un tableau de { pathname: string, route: RouteData } + return new Response(JSON.stringify({ paths })); + } + + // ... traiter d'autres requêtes + }; +} +``` From 1ab57e0c882755b57a88f34c1c80bf1fc0b3f966 Mon Sep 17 00:00:00 2001 From: Armand Philippot Date: Thu, 26 Mar 2026 18:51:01 +0100 Subject: [PATCH 2/2] fix links --- src/content/docs/fr/reference/modules/astro-static-paths.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/docs/fr/reference/modules/astro-static-paths.mdx b/src/content/docs/fr/reference/modules/astro-static-paths.mdx index 0bb08ccc4764e..0efc413cd72ff 100644 --- a/src/content/docs/fr/reference/modules/astro-static-paths.mdx +++ b/src/content/docs/fr/reference/modules/astro-static-paths.mdx @@ -24,9 +24,9 @@ import { ### `StaticPaths` -Permet aux adaptateurs de collecter tous les chemins qui doivent être pré-rendus à partir de leur environnement d'exécution cible. Ceci est utile lors de la [mise en œuvre d'un pré-rendu personnalisé](/fr/reference/adapter-reference/#custom-prerenderer) exécuté dans un environnement non-Node : +Permet aux adaptateurs de collecter tous les chemins qui doivent être pré-rendus à partir de leur environnement d'exécution cible. Ceci est utile lors de la [mise en œuvre d'un pré-rendu personnalisé](/fr/reference/adapter-reference/#moteur-de-prérendu-personnalisé) exécuté dans un environnement non-Node : -Le constructeur `StaticPaths` accepte un [manifeste SSR](/en/reference/integrations-reference/#ssrmanifest) obligatoire et un objet décrivant le cache de routes et fournissant une méthode d'accès au composant utilisé pour le rendu de la route. La méthode préférée pour initialiser une instance `StaticPaths` consiste à lui passer une [instance d'application](/fr/reference/modules/astro-app/#linstance-app). +Le constructeur `StaticPaths` accepte un [manifeste SSR](/fr/reference/integrations-reference/#ssrmanifest) obligatoire et un objet décrivant le cache de routes et fournissant une méthode d'accès au composant utilisé pour le rendu de la route. La méthode préférée pour initialiser une instance `StaticPaths` consiste à lui passer une [instance d'application](/fr/reference/modules/astro-app/#linstance-app). L'exemple suivant initialise une instance `StaticPaths` à partir d'une application dans un point d'entrée de serveur d'adaptateur :