Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 26 additions & 5 deletions src/content/docs/fr/guides/integrations-guide/db.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -129,6 +129,11 @@ export default defineConfig({

### `columns`

<p>

**Type :** `ColumnsConfig`
</p>

Les colonnes de la table sont configurées à l'aide de l'objet `columns` :

```ts
Expand Down Expand Up @@ -184,6 +189,11 @@ type UserTableInferInsert = {

### `indexes`

<p>

**Type :** `{ on: string | string[]; unique?: boolean | undefined; name?: string | undefined; }[]`
</p>

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 :

```ts title="db/config.ts" {9-11}
Expand All @@ -205,12 +215,17 @@ Cela générera un index unique sur les colonnes `authorId` et `published` avec

Les options de configuration suivantes sont disponibles pour chaque index :

- `on` : `string | string[]` - Une seule colonne ou un tableau de noms de colonnes à indexer.
- `unique` : `boolean` - Définir sur `true` pour imposer des valeurs uniques à travers les colonnes indexées.
- `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.
- `on` - Une seule colonne ou un tableau de noms de colonnes à indexer.
- `unique` - Définir sur `true` pour imposer des valeurs uniques à travers les colonnes indexées.
- `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.

### `foreignKeys`

<p>

**Type :** `{ columns: string | string[]; references: () => Column | Column[]; }[]`
</p>

:::tip

`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).
Expand Down Expand Up @@ -246,8 +261,8 @@ const Comment = defineTable({

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

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

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

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

### `isDbError()`

<p>

**Type :** `(err: unknown) => boolean`<br />
<Since v="0.9.1" pkg="@astrojs/db" />
</p>

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 :

```ts title="src/pages/api/comment/[id].ts" "idDbError"
Expand Down
18 changes: 16 additions & 2 deletions src/content/docs/fr/guides/integrations-guide/markdoc.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,10 +8,10 @@ githubIntegrationURL: 'https://github.com/withastro/astro/tree/main/packages/int
category: other
i18nReady: true
---
import { FileTree } from '@astrojs/starlight/components';
import { FileTree, Steps } from '@astrojs/starlight/components';
import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
import { Steps } from '@astrojs/starlight/components';
import ReadMore from '~/components/ReadMore.astro';
import Since from '~/components/Since.astro';

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.

Expand Down Expand Up @@ -593,6 +593,13 @@ L'intégration Astro Markdoc gère la configuration des options et des capacité

### `allowHTML`

<p>

**Type :** `boolean`<br />
**Par défaut :** `false`<br />
<Since v="0.4.4" pkg="@astrojs/markdoc" />
</p>

Permet d'écrire des balises HTML à côté des balises et des nœuds Markdoc.

Par défaut, Markdoc ne reconnaît pas les balises HTML comme du contenu sémantique.
Expand All @@ -615,6 +622,13 @@ Lorsque l'option `allowHTML` est activée, le balisage HTML à l'intérieur des

### `ignoreIndentation`

<p>

**Type :** `boolean`<br />
**Par défaut :** `false`<br />
<Since v="0.7.0" pkg="@astrojs/markdoc" />
</p>

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.

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.
Expand Down
29 changes: 24 additions & 5 deletions src/content/docs/fr/guides/integrations-guide/mdx.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -271,8 +271,12 @@ MDX ne prend pas en charge la transmission de modules d'extension remark et rehy

### `extendMarkdownConfig`

* **Type :** `boolean`
* **Par défaut :** `true`
<p>

**Type :** `boolean`<br />
**Par défaut :** `true`<br />
<Since v="0.15.0" pkg="@astrojs/mdx" />
</p>

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.

Expand Down Expand Up @@ -326,13 +330,25 @@ export default defineConfig({

### `recmaPlugins`

<p>

**Type :** `PluggableList`<br />
**Par défaut :** `[]`<br />
<Since v="0.11.5" pkg="@astrojs/mdx" />
</p>

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.

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.

### `optimize`

* **Type :** `boolean | { ignoreElementNames?: string[] }`
<p>

**Type :** `boolean | { ignoreElementNames?: string[] }`<br />
**Par défaut :** `false`<br />
<Since v="0.19.5" pkg="@astrojs/mdx" />
</p>

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.

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

#### `ignoreElementNames`

* **Type :** `string[]`
<p>

**Type :** `string[]`<br />
<Since v="3.0.0" pkg="@astrojs/mdx" />
</p>

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

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é).
Expand Down
9 changes: 5 additions & 4 deletions src/content/docs/fr/guides/integrations-guide/partytown.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -107,9 +107,10 @@ export default defineConfig({
});
```

Cela reflète l'[objet de configuration Partytown](https://partytown.qwik.dev/configuration/).
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.

### config.debug

### Activation du mode débogage

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.

Expand All @@ -127,7 +128,7 @@ export default defineConfig({
});
```

### config.forward
### Transfert des variables

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`.

Expand All @@ -149,7 +150,7 @@ export default defineConfig({
});
```

### config.resolveUrl
### Proxy pour les requêtes

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 :

Expand Down
12 changes: 11 additions & 1 deletion src/content/docs/fr/guides/integrations-guide/preact.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -135,6 +135,12 @@ Pour une utilisation basique, vous n'avez pas besoin de configurer l'intégratio

### compat

<p>

**Type :** `boolean`<br />
<Since pkg="@astrojs/preact" v="0.3.0" />
</p>

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.

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

### devtools

<p><Since pkg="@astrojs/preact" v="3.3.0" /></p>
<p>

**Type :** `boolean`<br />
<Since pkg="@astrojs/preact" v="3.3.0" />
</p>

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()` :

Expand Down
6 changes: 5 additions & 1 deletion src/content/docs/fr/guides/integrations-guide/solid-js.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -119,7 +119,11 @@ Pour utiliser votre premier composant SolidJS dans Astro, consultez notre [docum

### devtools

<p><Since pkg="@astrojs/solid-js" v="4.2.0" /></p>
<p>

**Type :** `boolean`<br />
<Since pkg="@astrojs/solid-js" v="4.2.0" />
</p>

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 :

Expand Down
18 changes: 17 additions & 1 deletion src/content/docs/fr/guides/integrations-guide/vue.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -142,6 +142,12 @@ export default defineConfig({

### appEntrypoint

<p>

**Type :** `string`<br />
<Since pkg="@astrojs/vue" v="1.2.0" />
</p>

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"`).

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.
Expand All @@ -167,6 +173,12 @@ export default (app: App) => {

### jsx

<p>

**Type :** `boolean | object`<br />
<Since pkg="@astrojs/vue" v="1.2.0" />
</p>

Vous pouvez utiliser Vue JSX en définissant `jsx: true`.

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

### devtools

<p><Since pkg="@astrojs/vue" v="4.2.0" /></p>
<p>

**Type :** `boolean | object`<br />
<Since pkg="@astrojs/vue" v="4.2.0" />
</p>

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()` :

Expand Down