Merge branch 'main' into i18n/ja-custom-img-recipe

Author: yanthomasdev

.github/PULL_REQUEST_TEMPLATE.md

@@ -21,3 +21,6 @@
 
 <!-- If you are a member of the Astro Discord, please add your username in the description so we can welcome you there! -->
 <!-- https://astro.build/chat -->
+
+<!-- TAKING PART IN HACKTOBERFEST? LET US KNOW! -->
+<!-- See https://contribute.docs.astro.build/guides/hacktoberfest/ for more details. -->

CONTRIBUTING.md

@@ -44,6 +44,8 @@ Submitting an Issue is usually the first step to making a change. After an Issue
 
 Larger contributions to the docs are encouraged after participating in Issues and Discussions, as unsolicited material may not fit into our existing plans.
 
+**Participating in Hacktoberfest?** See how you can get recognized for your translation PRs and PR reviews in our [Hacktoberfest guide](https://contribute.docs.astro.build/guides/hacktoberfest/).
+
 ### Examples of Helpful GitHub New Issues
 
 - a particular explanation is confusing (with explanation)

scripts/docgen.mjs

@@ -95,6 +95,9 @@ export async function run() {
 	// Make any links to docs relative instead of absolute.
 	result = result.replace(/https:\/\/docs\.astro\.build\//g, '/');
 
+	// Make self-referencing anchor links relative
+	result = result.replace(/\/en\/reference\/configuration-reference\/#/g, '#');
+
 	console.timeEnd(task);
 	task = 'Update configuration-reference.mdx';
 	console.time(task);

src/content/docs/de/guides/deploy/heroku.mdx

@@ -1,14 +1,25 @@
 ---
 title: Veröffentliche deine Astro-Website auf Heroku
 description: Wie du deine Astro-Website auf Heroku im Internet veröffentlichst.
+sidebar:
+  label: Heroku
 type: deploy
 i18nReady: true
 ---
 
+import { Steps } from '@astrojs/starlight/components';
+
 [Heroku](https://www.heroku.com/) ist eine Platform-as-a-Service für die Erstellung, den Betrieb und die Verwaltung moderner Apps in der Cloud. Mit dieser Anleitung kannst du eine Astro-Website auf Heroku veröffentlichen.
 
+:::danger
+Die folgenden Anweisungen nutzen [das veraltete `heroku-static-buildpack`](https://github.com/heroku/heroku-buildpack-static#warning-heroku-buildpack-static-is-deprecated).
+Schau dir stattdessen die [Heroku-Dokumentation zur Verwendung von `heroku-buildpack-nginx`](https://github.com/dokku/heroku-buildpack-nginx) an.
+:::
+
 ## So funktioniert die Veröffentlichung
 
+<Steps>
+
 1. Installiere die Kommandozeilen&shy;schnittstelle [Heroku CLI](https://devcenter.heroku.com/articles/heroku-cli).
 
 2. Erstelle ein Heroku-Konto, indem du dich [anmeldest](https://signup.heroku.com/).
@@ -21,9 +32,7 @@ i18nReady: true
 
 4. Erstelle im Stammverzeichnis deines Projekts eine Datei namens `static.json` mit dem folgenden Inhalt:
 
-   `static.json`:
-
-   ```json
+   ```json title="static.json"
    {
      "root": "./dist"
    }
@@ -55,3 +64,5 @@ i18nReady: true
    # Browser öffnen, um die Dashboard-Version von Heroku CI anzuzeigen
    $ heroku open
    ```
+
+</Steps>

src/content/docs/en/reference/cli-reference.mdx

@@ -287,13 +287,14 @@ astro info
 Example output:
 
 ```
-Astro                    v3.0.12
-Node                     v20.5.1
+Astro                    v5.14.1
+Vite                     v6.3.6
+Node                     v22.17.1
 System                   macOS (arm64)
-Package Manager          pnpm
-Output                   server
-Adapter                  @astrojs/vercel/serverless
-Integrations             none
+Package Manager          npm
+Output                   static
+Adapter                  none
+Integrations             @astrojs/starlight (v0.35.3)
 ```
 
 ## `astro preferences`

src/content/docs/en/reference/configuration-reference.mdx

@@ -100,7 +100,7 @@ Set the route matching behavior for trailing slashes in the dev server and on-de
 When redirects occur in production for GET requests, the redirect will be a 301 (permanent) redirect. For all other request methods, it will be a 308 (permanent, and preserve the request method) redirect.
 
 Trailing slashes on prerendered pages are handled by the hosting platform, and may not respect your chosen configuration.
-See your hosting platform's documentation for more information. You cannot use Astro [redirects](/en/reference/configuration-reference/#redirects) for this use case at this point.
+See your hosting platform's documentation for more information. You cannot use Astro [redirects](#redirects) for this use case at this point.
 
 ```js
 {
@@ -476,7 +476,7 @@ Setting `build.format` controls what `Astro.url` is set to during the build. Whe
 
 This means that when you create relative URLs using `new URL('./relative', Astro.url)`, you will get consistent behavior between dev and build.
 
-To prevent inconsistencies with trailing slash behaviour in dev, you can restrict the [`trailingSlash` option](/en/reference/configuration-reference/#trailingslash) to `'always'` or `'never'` depending on your build format:
+To prevent inconsistencies with trailing slash behaviour in dev, you can restrict the [`trailingSlash` option](#trailingslash) to `'always'` or `'never'` depending on your build format:
 - `directory` - Set `trailingSlash: 'always'`
 - `file` - Set `trailingSlash: 'never'`
 
@@ -957,7 +957,7 @@ Add this attribute to any `<a />` link on your page to enable prefetching for th
 ```html
 <a href="/about" data-astro-prefetch>About</a>
 ```
-Further customize the default prefetching behavior using the [`prefetch.defaultStrategy`](/en/reference/configuration-reference/#prefetchdefaultstrategy) and [`prefetch.prefetchAll`](/en/reference/configuration-reference/#prefetchprefetchall) options.
+Further customize the default prefetching behavior using the [`prefetch.defaultStrategy`](#prefetchdefaultstrategy) and [`prefetch.prefetchAll`](#prefetchprefetchall) options.
 
 See the [Prefetch guide](/en/guides/prefetch/) for more information.
 
@@ -1083,7 +1083,7 @@ Set `false` to bypass the default image size limit for the Sharp image service a
 
 Defines a list of permitted image source domains for remote image optimization. No other remote images will be optimized by Astro.
 
-This option requires an array of individual domain names as strings. Wildcards are not permitted. Instead, use [`image.remotePatterns`](/en/reference/configuration-reference/#imageremotepatterns) to define a list of allowed source URL patterns.
+This option requires an array of individual domain names as strings. Wildcards are not permitted. Instead, use [`image.remotePatterns`](#imageremotepatterns) to define a list of allowed source URL patterns.
 
 ```js
 // astro.config.mjs
@@ -1580,7 +1580,7 @@ export default defineConfig({
 <Since v="4.15.0" />
 </p>
 
-When [`i18n.fallback`](/en/reference/configuration-reference/#i18nfallback) is configured to avoid showing a 404 page for missing page routes, this option controls whether to [redirect](/en/guides/routing/#redirects) to the fallback page, or to [rewrite](/en/guides/routing/#rewrites) the fallback page's content in place.
+When [`i18n.fallback`](#i18nfallback) is configured to avoid showing a 404 page for missing page routes, this option controls whether to [redirect](/en/guides/routing/#redirects) to the fallback page, or to [rewrite](/en/guides/routing/#rewrites) the fallback page's content in place.
 
 By default, Astro's i18n routing creates pages that redirect your visitors to a new destination based on your fallback configuration. The browser will refresh and show the destination address in the URL bar.
 

src/content/docs/en/reference/container-reference.mdx

@@ -2,7 +2,7 @@
 title: Astro Container API (experimental)
 sidebar:
   label: Container API (experimental)
-i18nReady: false
+i18nReady: true
 ---
 import Since from '~/components/Since.astro'
 
@@ -20,6 +20,11 @@ This API is experimental and subject to breaking changes, even in [minor or patc
 
 ## `create()`
 
+<p>
+
+**Type:** `(options?: AstroContainerOptions) => Promise<experimental_AstroContainer>`
+</p>
+
 Creates a new instance of the container. 
 
 ```js
@@ -50,13 +55,21 @@ export type AddServerRenderer =
 
 ### `streaming` option
 
-**Type:** `boolean`
+<p>
+
+**Type:** `boolean`<br />
+**Default:** `false`
+</p>
 
 Enables rendering components using [HTML streaming](/en/guides/on-demand-rendering/#html-streaming).
 
 ### `renderers` option
 
-**Type:** `AddServerRenderer[]`
+<p>
+
+**Type:** `AddServerRenderer[]`<br />
+**Default:** `[]`
+</p>
 
 A list of loaded client renderers required by the component. Use this if your `.astro` component renders any [UI framework components](/en/guides/framework-components/) or MDX using an official Astro integration (e.g. React, Vue, etc.).
 
@@ -106,15 +119,20 @@ import vueRenderer from "@astrojs/vue/server.js";
 import mdxRenderer from "@astrojs/mdx/server.js";
 
 const container = await experimental_AstroContainer.create();
-container.addServerRenderer({renderer: vueRenderer});
-container.addServerRenderer({renderer: mdxRenderer});
+container.addServerRenderer({ renderer: vueRenderer });
+container.addServerRenderer({ renderer: mdxRenderer });
 
 container.addServerRenderer({ renderer: reactRenderer });
 container.addClientRenderer({ name: "@astrojs/react", entrypoint: "@astrojs/react/client.js" });
 ```
 
 ## `renderToString()`
 
+<p>
+
+**Type:** <code>(component: AstroComponentFactory; options?: <a href="#rendering-options">ContainerRenderOptions</a>) => Promise&lt;string&gt;</code>
+</p>
+
 This function renders a specified component inside a container. It takes an Astro component as an argument and it returns a string that represents the HTML/content rendered by the Astro component.
 
 ```js
@@ -125,12 +143,17 @@ const container = await experimental_AstroContainer.create();
 const result = await container.renderToString(Card);
 ```
 
-Under the hood, this function calls [`renderToResponse`](#rendertoresponse) and calls `Response.text()`. 
+Under the hood, this function calls [`renderToResponse()`](#rendertoresponse) and `Response.text()`. 
 
 It also accepts an object as a second argument that can contain a [number of options](#rendering-options).
 
 ## `renderToResponse()`
 
+<p>
+
+**Type:** <code>(component: AstroComponentFactory; options?: <a href="#rendering-options">ContainerRenderOptions</a>) => Promise&lt;Response&gt;</code>
+</p>
+
 It renders a component, and it returns a `Response` object.
 
 ```js
@@ -145,7 +168,7 @@ It also accepts an object as a second argument that can contain a [number of opt
 
 ## Rendering options
 
-Both [`renderToResponse`](#rendertoresponse) and [`renderToString`](#rendertostring) accept an object as their second argument:
+Both [`renderToResponse()`](#rendertoresponse) and [`renderToString()`](#rendertostring) accept an object as their second argument:
 
 ```ts
 export type ContainerRenderOptions = {
@@ -154,15 +177,19 @@ export type ContainerRenderOptions = {
 	request?: Request;
 	params?: Record<string, string | undefined>;
 	locals?: App.Locals;
-	routeType?: "page" | "endpoint";
+	routeType?: RouteType;
+	partial?: boolean;
 };
 ```
 
 These optional values can be passed to the rendering function in order to provide additional information necessary for an Astro component to properly render.
 
 ### `slots`
 
-**Type**: `Record<string, any>`;
+<p>
+
+**Type**: `Record<string, any>`
+</p>
 
 An option to pass content to be rendered with [`<slots>`](/en/basics/astro-components/#slots).
 
@@ -224,7 +251,10 @@ const result = await container.renderToString(Card, {
 
 ### `props` option
 
+<p>
+
 **Type**: `Record<string, unknown>`
+</p>
 
 An option to pass [properties](/en/basics/astro-components/#component-props) for Astro components.
 
@@ -252,7 +282,10 @@ const { name } = Astro.props;
 
 ### `request` option
 
+<p>
+
 **Type**: `Request`
+</p>
 
 An option to pass a `Request` with information about the path/URL the component will render.
 
@@ -274,7 +307,10 @@ const result = await container.renderToString(Card, {
 
 ### `params` option
 
-**Type**: `Record<string, string | undefined>`;
+<p>
+
+**Type**: `Record<string, string | undefined>`
+</p>
 
 An object to pass information about the path parameter to an Astro component responsible for [generating dynamic routes](/en/guides/routing/#dynamic-routes).
 
@@ -300,7 +336,10 @@ const result = await container.renderToString(LocaleSlug, {
 
 ### `locals` options
 
+<p>
+
 **Type**: `App.Locals`
+</p>
 
 An option to pass information from [`Astro.locals`](/en/reference/api-reference/#locals) for rendering your component.
 
@@ -341,9 +380,12 @@ test("User is out", async () => {
 
 ### `routeType` option
 
-**Type**: `"page" | "endpoint"`
+<p>
+
+**Type**: `RouteType`
+</p>
 
-An option available when using `renderToResponse` to specify that you are rendering an [endpoint](/en/guides/endpoints/):
+An option available when using `renderToResponse()` to specify that you are rendering an [endpoint](/en/guides/endpoints/):
 
 ```js
 container.renderToString(Endpoint, { routeType: "endpoint" });

src/content/docs/fr/reference/cli-reference.mdx

@@ -287,13 +287,14 @@ astro info
 Exemple de sortie :
 
 ```
-Astro                    v3.0.12
-Node                     v20.5.1
+Astro                    v5.14.1
+Vite                     v6.3.6
+Node                     v22.17.1
 System                   macOS (arm64)
-Package Manager          pnpm
-Output                   server
-Adapter                  @astrojs/vercel/serverless
-Integrations             none
+Package Manager          npm
+Output                   static
+Adapter                  none
+Integrations             @astrojs/starlight (v0.35.3)
 ```
 
 ## `astro preferences`

src/content/docs/fr/reference/configuration-reference.mdx

@@ -92,7 +92,7 @@ Définissez le comportement de correspondance de route pour les barres obliques
 Lorsque des redirections se produisent en production pour les requêtes GET, la redirection sera une redirection 301 (permanente). Pour toutes les autres méthodes de requête, il s'agira d'une redirection 308 (permanente et conservant la méthode de requête).
 
 Les barres obliques finales sur les pages pré-rendues sont gérées par la plate-forme d'hébergement et peuvent ne pas respecter la configuration que vous avez choisie.
-Consultez la documentation de votre plateforme d'hébergement pour plus d'informations. Vous ne pouvez pas utiliser [les redirections](/fr/reference/configuration-reference/#redirects) d'Astro pour ce cas d’utilisation à ce stade.
+Consultez la documentation de votre plateforme d'hébergement pour plus d'informations. Vous ne pouvez pas utiliser [les redirections](#redirects) d'Astro pour ce cas d’utilisation à ce stade.
 
 ```js
 {
@@ -461,7 +461,7 @@ La définition de `build.format` contrôle ce sur quoi `Astro.url` est défini p
 
 Cela signifie que lorsque vous créez des URL relatives à l'aide de `new URL('./relative', Astro.url)`, vous obtiendrez un comportement cohérent entre le développement et la production.
 
-Pour éviter les incohérences avec le comportement des barres obliques finales en développement, vous pouvez restreindre l'[option `trailingSlash`](/fr/reference/configuration-reference/#trailingslash) à `'always'` ou `'never'` selon votre format de compilation :
+Pour éviter les incohérences avec le comportement des barres obliques finales en développement, vous pouvez restreindre l'[option `trailingSlash`](#trailingslash) à `'always'` ou `'never'` selon votre format de compilation :
 - `directory` - Définissez `trailingSlash: 'always'`
 - `file` - Définissez `trailingSlash: 'never'`
 
@@ -931,7 +931,7 @@ Ajoutez cet attribut à n'importe quel lien `<a />` sur votre page pour activer
 ```html
 <a href="/a-propos" data-astro-prefetch>À propos</a>
 ```
-Personnalisez davantage le comportement par défaut du préchargement à l'aide des options [`prefetch.defaultStrategy`](/fr/reference/configuration-reference/#prefetchdefaultstrategy) et [`prefetch.prefetchAll`](/fr/reference/configuration-reference/#prefetchprefetchall).
+Personnalisez davantage le comportement par défaut du préchargement à l'aide des options [`prefetch.defaultStrategy`](#prefetchdefaultstrategy) et [`prefetch.prefetchAll`](#prefetchprefetchall).
 
 Consultez le [guide sur le préchargement](/fr/guides/prefetch/) pour plus d'informations.
 
@@ -1056,7 +1056,7 @@ Définissez le paramètre sur `false` pour contourner la limite de taille des im
 
 Définit une liste de domaines sources d'images autorisés pour l'optimisation des images à distance. Aucune autre image distante ne sera optimisée par Astro.
 
-Cette option nécessite un tableau de noms de domaine individuels sous forme de chaînes de caractères. Les caractères génériques ne sont pas autorisés. Utilisez plutôt [`image.remotePatterns`](/fr/reference/configuration-reference/#imageremotepatterns) pour définir une liste de modèles d'URL source autorisés.
+Cette option nécessite un tableau de noms de domaine individuels sous forme de chaînes de caractères. Les caractères génériques ne sont pas autorisés. Utilisez plutôt [`image.remotePatterns`](#imageremotepatterns) pour définir une liste de modèles d'URL source autorisés.
 
 ```js
 // astro.config.mjs
@@ -1547,7 +1547,7 @@ export default defineConfig({
 <Since v="4.15.0" />
 </p>
 
-Lorsque [`i18n.fallback`](/fr/reference/configuration-reference/#i18nfallback) est configuré pour éviter d'afficher une page 404 pour les routes de page manquantes, cette option contrôle s'il faut [rediriger](/fr/guides/routing/#redirections) vers la page de secours ou [réécrire](/fr/guides/routing/#réécritures) le contenu de la page de secours en place.
+Lorsque [`i18n.fallback`](#i18nfallback) est configuré pour éviter d'afficher une page 404 pour les routes de page manquantes, cette option contrôle s'il faut [rediriger](/fr/guides/routing/#redirections) vers la page de secours ou [réécrire](/fr/guides/routing/#réécritures) le contenu de la page de secours en place.
 
 Par défaut, le routage i18n d'Astro crée des pages qui redirigent vos visiteurs vers une nouvelle destination en fonction de votre configuration de repli. Le navigateur s'actualise et affiche l'adresse de destination dans la barre d'URL.