Skip to content

Commit d17b323

Browse files
i18n(fr): update integrations-guide/* with API references (#12411)
Co-authored-by: Yan <[email protected]>
1 parent b9d6ccf commit d17b323

File tree

7 files changed

+104
-19
lines changed

7 files changed

+104
-19
lines changed

src/content/docs/fr/guides/integrations-guide/db.mdx

Lines changed: 26 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -129,6 +129,11 @@ export default defineConfig({
129129

130130
### `columns`
131131

132+
<p>
133+
134+
**Type :** `ColumnsConfig`
135+
</p>
136+
132137
Les colonnes de la table sont configurées à l'aide de l'objet `columns` :
133138

134139
```ts
@@ -184,6 +189,11 @@ type UserTableInferInsert = {
184189
185190
### `indexes`
186191
192+
<p>
193+
194+
**Type :** `{ on: string | string[]; unique?: boolean | undefined; name?: string | undefined; }[]`
195+
</p>
196+
187197
Les index de table sont utilisés pour améliorer la vitesse de recherche sur une colonne donnée ou une combinaison de colonnes. La propriété `indexes` accepte un tableau d'objets de configuration spécifiant les colonnes à indexer :
188198
189199
```ts title="db/config.ts" {9-11}
@@ -205,12 +215,17 @@ Cela générera un index unique sur les colonnes `authorId` et `published` avec
205215

206216
Les options de configuration suivantes sont disponibles pour chaque index :
207217

208-
- `on` : `string | string[]` - Une seule colonne ou un tableau de noms de colonnes à indexer.
209-
- `unique` : `boolean` - Définir sur `true` pour imposer des valeurs uniques à travers les colonnes indexées.
210-
- `name` : `string` (Optionnel) - Un nom personnalisé pour l'index unique. Il remplacera le nom généré par Astro basé sur les noms de la table et de la colonne indexée (par exemple `Comment_authorId_published_idx`). Les noms personnalisés sont globaux, il faut donc s'assurer que les noms d'index n'entrent pas en conflit entre les tables.
218+
- `on` - Une seule colonne ou un tableau de noms de colonnes à indexer.
219+
- `unique` - Définir sur `true` pour imposer des valeurs uniques à travers les colonnes indexées.
220+
- `name` (Optionnel) - Un nom personnalisé pour l'index unique. Il remplacera le nom généré par Astro basé sur les noms de la table et de la colonne indexée (par exemple `Comment_authorId_published_idx`). Les noms personnalisés sont globaux, il faut donc s'assurer que les noms d'index n'entrent pas en conflit entre les tables.
211221

212222
### `foreignKeys`
213223

224+
<p>
225+
226+
**Type :** `{ columns: string | string[]; references: () => Column | Column[]; }[]`
227+
</p>
228+
214229
:::tip
215230

216231
`foreignKeys` est une API avancée pour relier plusieurs colonnes d'une table. Si vous n'avez besoin de référencer qu'une seule colonne, essayez d'utiliser [la propriété `references` de la colonne](#columns).
@@ -246,8 +261,8 @@ const Comment = defineTable({
246261

247262
Chaque objet de configuration de clé étrangère accepte les propriétés suivantes :
248263

249-
- `columns` : `string[]` - Un tableau de noms de colonnes à associer à la table référencée.
250-
- `references` : `() => Column[]` - Une fonction qui renvoie un tableau de colonnes de la table référencée.
264+
- `columns` - Un tableau de noms de colonnes à associer à la table référencée.
265+
- `references` - Une fonction qui renvoie un tableau de colonnes de la table référencée.
251266

252267
## Référence de la CLI d'Astro DB
253268

@@ -288,6 +303,12 @@ Exécute une requête SQL brute sur votre base de données. Utilisez l'option `-
288303

289304
### `isDbError()`
290305

306+
<p>
307+
308+
**Type :** `(err: unknown) => boolean`<br />
309+
<Since v="0.9.1" pkg="@astrojs/db" />
310+
</p>
311+
291312
La fonction `isDbError()` vérifie si une erreur est une exception de la base de données libSQL. Il peut s'agir d'une erreur de contrainte de clé étrangère lors de l'utilisation de références, ou de champs manquants lors de l'insertion de données. Vous pouvez combiner `isDbError()` avec un bloc try/catch pour gérer les erreurs de base de données dans votre application :
292313

293314
```ts title="src/pages/api/comment/[id].ts" "idDbError"

src/content/docs/fr/guides/integrations-guide/markdoc.mdx

Lines changed: 16 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,10 +8,10 @@ githubIntegrationURL: 'https://github.com/withastro/astro/tree/main/packages/int
88
category: other
99
i18nReady: true
1010
---
11-
import { FileTree } from '@astrojs/starlight/components';
11+
import { FileTree, Steps } from '@astrojs/starlight/components';
1212
import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
13-
import { Steps } from '@astrojs/starlight/components';
1413
import ReadMore from '~/components/ReadMore.astro';
14+
import Since from '~/components/Since.astro';
1515

1616
Cette **[intégration Astro][astro-integration]** permet d'utiliser [Markdoc](https://markdoc.dev/) pour créer des composants, des pages et des entrées de collection de contenu.
1717

@@ -593,6 +593,13 @@ L'intégration Astro Markdoc gère la configuration des options et des capacité
593593
594594
### `allowHTML`
595595
596+
<p>
597+
598+
**Type :** `boolean`<br />
599+
**Par défaut :** `false`<br />
600+
<Since v="0.4.4" pkg="@astrojs/markdoc" />
601+
</p>
602+
596603
Permet d'écrire des balises HTML à côté des balises et des nœuds Markdoc.
597604
598605
Par défaut, Markdoc ne reconnaît pas les balises HTML comme du contenu sémantique.
@@ -615,6 +622,13 @@ Lorsque l'option `allowHTML` est activée, le balisage HTML à l'intérieur des
615622
616623
### `ignoreIndentation`
617624
625+
<p>
626+
627+
**Type :** `boolean`<br />
628+
**Par défaut :** `false`<br />
629+
<Since v="0.7.0" pkg="@astrojs/markdoc" />
630+
</p>
631+
618632
Par défaut, tout contenu indenté de quatre espaces est traité comme un bloc de code. Malheureusement, ce comportement rend difficile l'utilisation de niveaux d'indentation arbitraires pour améliorer la lisibilité des documents à la structure complexe.
619633
620634
Lors de l'utilisation de balises imbriquées dans Markdoc, il peut être utile d'indenter le contenu à l'intérieur des balises afin que le niveau de profondeur soit clair. Pour prendre en charge l'indentation arbitraire, nous devons désactiver les blocs de code basés sur l'indentation et modifier plusieurs autres règles d'analyse markdown-it qui prennent en compte les blocs de code basés sur l'indentation. Ces modifications peuvent être appliquées en activant l'option ignoreIndentation.

src/content/docs/fr/guides/integrations-guide/mdx.mdx

Lines changed: 24 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -271,8 +271,12 @@ MDX ne prend pas en charge la transmission de modules d'extension remark et rehy
271271

272272
### `extendMarkdownConfig`
273273

274-
* **Type :** `boolean`
275-
* **Par défaut :** `true`
274+
<p>
275+
276+
**Type :** `boolean`<br />
277+
**Par défaut :** `true`<br />
278+
<Since v="0.15.0" pkg="@astrojs/mdx" />
279+
</p>
276280

277281
MDX étend par défaut [la configuration Markdown existante de votre projet](/fr/reference/configuration-reference/#options-de-markdown). Pour remplacer certaines options, vous pouvez spécifier leur équivalent dans votre configuration MDX.
278282

@@ -326,13 +330,25 @@ export default defineConfig({
326330

327331
### `recmaPlugins`
328332

333+
<p>
334+
335+
**Type :** `PluggableList`<br />
336+
**Par défaut :** `[]`<br />
337+
<Since v="0.11.5" pkg="@astrojs/mdx" />
338+
</p>
339+
329340
Il s'agit de modules d'extension qui modifient directement la sortie [estree](https://github.com/estree/estree). Ceci est utile pour modifier ou injecter des variables JavaScript dans vos fichiers MDX.
330341

331342
Nous vous suggérons [d'utiliser AST Explorer](https://astexplorer.net/) pour jouer avec les sorties d'estree, et d'essayer [`estree-util-visit`](https://unifiedjs.com/explore/package/estree-util-visit/) pour effectuer des recherches dans les nœuds JavaScript.
332343

333344
### `optimize`
334345

335-
* **Type :** `boolean | { ignoreElementNames?: string[] }`
346+
<p>
347+
348+
**Type :** `boolean | { ignoreElementNames?: string[] }`<br />
349+
**Par défaut :** `false`<br />
350+
<Since v="0.19.5" pkg="@astrojs/mdx" />
351+
</p>
336352

337353
Il s'agit d'un paramètre de configuration facultatif qui permet d'optimiser la sortie MDX pour une compilation et un rendu plus rapides grâce à un module d'extension rehype interne. Cela peut être utile si vous avez beaucoup de fichiers MDX et que vous constatez des lenteurs lors de la compilation. Cependant, cette option peut générer du HTML non échappé, assurez-vous donc que les parties interactives de votre site fonctionnent toujours correctement après l'avoir activée.
338354

@@ -354,9 +370,12 @@ export default defineConfig({
354370

355371
#### `ignoreElementNames`
356372

357-
* **Type :** `string[]`
373+
<p>
374+
375+
**Type :** `string[]`<br />
376+
<Since v="3.0.0" pkg="@astrojs/mdx" />
377+
</p>
358378

359-
<p><Since pkg="@astrojs/mdx" v="3.0.0" /></p>
360379
Précédemment connu sous le nom de `customComponentNames`.
361380

362381
Une propriété optionnelle de `optimize` pour empêcher l'optimiseur MDX de gérer certains noms d'éléments, comme [les composants personnalisés passés au contenu MDX importé via la propriété components](/fr/guides/integrations-guide/mdx/#composants-personnalisés-avec-mdx-importé).

src/content/docs/fr/guides/integrations-guide/partytown.mdx

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -107,9 +107,10 @@ export default defineConfig({
107107
});
108108
```
109109

110-
Cela reflète l'[objet de configuration Partytown](https://partytown.qwik.dev/configuration/).
110+
Cela reproduit l'[objet de configuration Partytown](https://partytown.qwik.dev/configuration/) et toutes les options peuvent être définies dans `partytown.config`. Certaines options de configuration courantes pour les projets Astro sont décrites sur cette page.
111111

112-
### config.debug
112+
113+
### Activation du mode débogage
113114

114115
Partytown est livré avec un mode `debug` ; activez-le ou désactivez-le en passant `true` ou `false` à `config.debug`. Si le [mode `debug`](https://partytown.qwik.dev/debugging) est activé, il produira des journaux détaillés dans la console du navigateur.
115116

@@ -127,7 +128,7 @@ export default defineConfig({
127128
});
128129
```
129130

130-
### config.forward
131+
### Transfert des variables
131132

132133
Les scripts tiers ajoutent généralement des variables à l'objet `window` afin que vous puissiez communiquer avec eux à travers votre site. Mais lorsqu'un script est chargé dans un web-worker, il n'a pas accès à l'objet global `window`.
133134

@@ -149,7 +150,7 @@ export default defineConfig({
149150
});
150151
```
151152

152-
### config.resolveUrl
153+
### Proxy pour les requêtes
153154

154155
Certains scripts tiers peuvent nécessiter un proxy (https://partytown.qwik.dev/proxying-requests/) via `config.resolveUrl()`, exécuté dans le service worker. Vous pouvez configurer cette option pour rechercher une URL spécifique et éventuellement renvoyer une URL de proxy à la place :
155156

src/content/docs/fr/guides/integrations-guide/preact.mdx

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -135,6 +135,12 @@ Pour une utilisation basique, vous n'avez pas besoin de configurer l'intégratio
135135

136136
### compat
137137

138+
<p>
139+
140+
**Type :** `boolean`<br />
141+
<Since pkg="@astrojs/preact" v="0.3.0" />
142+
</p>
143+
138144
Vous pouvez activer `preact/compat`, la couche de compatibilité de Preact pour le rendu des composants React sans avoir besoin d'installer ou de livrer les grandes bibliothèques de React aux navigateurs web de vos utilisateurs.
139145

140146
Pour ce faire, passez un objet à l'intégration Preact et mettez `compat: true`.
@@ -169,7 +175,11 @@ Actuellement, l'option `compat` ne fonctionne que pour les bibliothèques React
169175

170176
### devtools
171177

172-
<p><Since pkg="@astrojs/preact" v="3.3.0" /></p>
178+
<p>
179+
180+
**Type :** `boolean`<br />
181+
<Since pkg="@astrojs/preact" v="3.3.0" />
182+
</p>
173183

174184
Vous pouvez activer les [outils de développement Preact](https://preactjs.github.io/preact-devtools/) durant le développement en passant un objet avec `devtools: true` à votre configuration d'intégration `preact()` :
175185

src/content/docs/fr/guides/integrations-guide/solid-js.mdx

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -119,7 +119,11 @@ Pour utiliser votre premier composant SolidJS dans Astro, consultez notre [docum
119119

120120
### devtools
121121

122-
<p><Since pkg="@astrojs/solid-js" v="4.2.0" /></p>
122+
<p>
123+
124+
**Type :** `boolean`<br />
125+
<Since pkg="@astrojs/solid-js" v="4.2.0" />
126+
</p>
123127

124128
Vous pouvez activer les [outils de développement de Solid](https://github.com/thetarnav/solid-devtools) durant le développement en transmettant un objet avec `devtools: true` à votre configuration d'intégration `solid()` et en ajoutant `solid-devtools` aux dépendances de votre projet :
125129

src/content/docs/fr/guides/integrations-guide/vue.mdx

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -142,6 +142,12 @@ export default defineConfig({
142142

143143
### appEntrypoint
144144

145+
<p>
146+
147+
**Type :** `string`<br />
148+
<Since pkg="@astrojs/vue" v="1.2.0" />
149+
</p>
150+
145151
Vous pouvez étendre l'instance d'`app` Vue en fixant l'option `appEntrypoint` à un spécificateur d'importation relatif à la racine (par exemple, `appEntrypoint: "/src/pages/_app"`).
146152

147153
L'exportation par défaut de ce fichier devrait être une fonction qui accepte une instance d'`App` Vue avant le rendu, permettant l'utilisation de [modules d'extension Vue personnalisés](https://vuejs.org/guide/reusability/plugins.html), `app.use`, et d'autres personnalisations pour des cas d'utilisation avancés.
@@ -167,6 +173,12 @@ export default (app: App) => {
167173

168174
### jsx
169175

176+
<p>
177+
178+
**Type :** `boolean | object`<br />
179+
<Since pkg="@astrojs/vue" v="1.2.0" />
180+
</p>
181+
170182
Vous pouvez utiliser Vue JSX en définissant `jsx: true`.
171183

172184
```js title="astro.config.mjs"
@@ -200,7 +212,11 @@ export default defineConfig({
200212

201213
### devtools
202214

203-
<p><Since pkg="@astrojs/vue" v="4.2.0" /></p>
215+
<p>
216+
217+
**Type :** `boolean | object`<br />
218+
<Since pkg="@astrojs/vue" v="4.2.0" />
219+
</p>
204220

205221
Vous pouvez activer les [outils de développement de Vue](https://devtools-next.vuejs.org/) durant le développement en passant un objet avec `devtools: true` à votre configuration d'intégration `vue()` :
206222

0 commit comments

Comments
 (0)