> ## Documentation Index
> Fetch the complete documentation index at: https://docs.marcodewey.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tour des composants

> Un tour des composants que vous pouvez utiliser sur n'importe quelle page Mintlify.

Chaque exemple ci-dessous est du vrai MDX. Ouvrez l'option **View as Markdown** de la page pour en copier n'importe quelle partie.

## Encadrés

> [!NOTE]
>
> Une **note** ajoute du contexte supplémentaire.

> [!TIP]
>
> Un **conseil** partage un raccourci ou une bonne pratique.

> [!NOTE]
>
> Un encadré **info** met en avant des informations de contexte utiles.

> [!TIP]
>
> Une **validation** confirme une réussite.

> [!WARNING]
>
> Un **avertissement** signale un point auquel faire attention.

> [!CAUTION]
>
> Un encadré **danger** signale quelque chose qui peut tout casser.

## Cartes

> [card] Carte simple
>
> Une carte avec une icône et du texte.

> [card] [Carte avec lien](https://docs.marcodewey.com/fr/quickstart.md)
>
> Ajoutez `href` et toute la carte devient cliquable.

> [card] [Carte avec CTA](https://docs.marcodewey.com/fr/changelog.md)
>
> Ajoutez `cta` pour personnaliser le libellé du lien.

> [card] Carte horizontale
>
> Utilisez `horizontal` pour une mise en page compacte en pleine largeur.

## Colonnes

> [card] Colonne de gauche
>
> Les colonnes organisent n'importe quel contenu dans une grille responsive.

> [card] Colonne de droite
>
> Elles s'empilent sur les petits écrans.

## Étapes

**1. Première étape**

Les étapes numérotent automatiquement une procédure.

**2. Deuxième étape**

Placez n'importe quel contenu dans une étape, y compris du code :

```bash theme={null}
echo "hello from a step"
```

**3. Troisième étape**

Terminé.

## Onglets

> [tab] Premier onglet
>
> Les onglets permettent de basculer entre des alternatives, comme des systèmes d'exploitation ou des langages.

> [tab] Deuxième onglet
>
> Le choix du lecteur est mémorisé sur les pages qui utilisent les mêmes titres d'onglets.

## Groupes de code et blocs de code

```python Python theme={null}
def greet(name: str) -> str:
    return f"Hello, {name}!"
```

```javascript JavaScript theme={null}
const greet = (name) => `Hello, ${name}!`;
```

```go Go theme={null}
func greet(name string) string { return "Hello, " + name + "!" }
```

```python title="highlight.py" lines highlight={2,3} theme={null}
def total(items):
    subtotal = sum(items)       # highlighted
    return subtotal * 1.08      # highlighted
```

## Accordéons

> [accordion] Fermé par défaut
>
> Les accordéons masquent les détails jusqu'à ce que le lecteur souhaite les voir.

> [accordion] Ouvert par défaut
>
> Définissez `defaultOpen` pour qu'il soit déplié au départ.

## Diagrammes avec Mermaid

Écrivez un bloc délimité `mermaid` et Mintlify l'affiche, en mode clair comme en mode sombre.

```mermaid theme={null}
sequenceDiagram
    participant Reader as Lecteur
    participant Docs as Documentation Mintlify
    participant API as Votre API
    Reader->>Docs: Ouvre une page d'endpoint
    Docs->>Reader: Affiche le générateur de requêtes et les exemples de code
    Reader->>API: Clique sur "Try it"
    API-->>Reader: 200 OK avec du JSON
```

Les organigrammes fonctionnent de la même manière.

```mermaid theme={null}
flowchart LR
    Idea[Idée] --> Draft[Brouillon] --> Review[Relecture] --> Publish[Publication]
    Review -- modifications demandées --> Draft
```

## Champs d'API

**user\_id** `string` *required*

L'ID de l'utilisateur. Les paramètres de chemin, les paramètres de requête, les en-têtes et les champs du corps ont chacun leur propre variante.

**limit** `integer` (default: 10)

Nombre maximal de résultats.

**user** `object` *required*

L'objet utilisateur.

**propriétés**

**name** `string`

Le nom de l'utilisateur.

**plan** `string` (default: free)

Le forfait de l'utilisateur.

## Exemples de requête et de réponse

```bash Request theme={null}
curl https://api.example.com/users/42
```

```json Response theme={null}
{ "user": { "name": "Ada", "plan": "free" } }
```

## Cadres et images

![Logo de la démo Mintlify](https://mintcdn.com/mintlify-demo/ftr7TwW1rIS6Qhdf/logo/light.svg?fit=max\&auto=format\&n=ftr7TwW1rIS6Qhdf\&q=85\&s=62ba26dbb685fbe98c75fe4055da1835)

Une image SVG dans un Frame, avec une légende.

## Badges, infobulles et icônes

StableBêtaObsolèteContourPilule

Survolez OpenAPI (Un format standard pour décrire les API HTTP. Mintlify le transforme en référence d'API interactive.) pour afficher une infobulle.

Icônes en ligne :  &#x20;

## Arborescence

**merge-sort-api**

**main.py**

**requirements.txt**

**tests**

**test\_main.py**

**docs**

**docs.json**

**index.mdx**

**openapi.json**

## Couleurs

**primary** `#0D9373`

**light** `#55D799`

**surface** `#F8FAFC` (light), `#0F172A` (dark)

## Carte de dépôt GitHub

## Prompt

Donnez ceci à votre agent de code pour qu'il rédige la documentation dans votre style.

Vous êtes rédacteur technique. Rédigez une documentation claire et concise pour les développeurs.

* Utilisez la deuxième personne (« vous ») et des verbes à la voix active.
* Commencez chaque procédure par un titre orienté vers un objectif.
* Montrez un exemple de code exécutable pour chaque endpoint.

## Vues

**Python**

```python theme={null}
print("Views switch the content for the whole page.")
```

**JavaScript**

```javascript theme={null}
console.log("Pick a language and the page changes.");
```

## Mathématiques

Des formules en ligne comme $E = mc^2$ et des formules en bloc :

$$
\sum_{i=1}^{n} i = \frac{n(n+1)}{2}
$$

## Tableaux et Markdown

| Fonctionnalité | Free | Pro | Enterprise |
| - | :-: | :-: | :-: |
| Hébergement de la documentation | Oui | Oui | Oui |
| Assistant IA | | Oui | Oui |
| Projets multi-dépôts | | | Oui |

> Les citations, le **gras**, l'*italique*, le ~~barré~~, le `code en ligne` et les [liens](https://docs.marcodewey.com/fr/quickstart.md) fonctionnent tous comme prévu.

* [x] Les listes de tâches
* [ ] fonctionnent aussi

> [!NOTE]
>
> Un **Panel** épingle du contenu sur le côté droit de la page. Utilisez-le pour des exemples, des résumés ou des liens.
