> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/skill/build-integration.md). # Créer une intégration Créez, développez et publiez des intégrations GitBook — des applications qui s’exécutent dans GitBook pour ajouter des blocs personnalisés, réagir aux événements, se connecter à des services externes via OAuth et étendre l’éditeur. Utilisez cette compétence lors de Une compétence pour créer des intégrations sur la plateforme développeur de GitBook : des applications qui s’exécutent à l’intérieur même de GitBook. Une intégration peut afficher des blocs personnalisés dans l’éditeur, montrer une interface de configuration, écouter des événements (contenu mis à jour, synchronisation Git terminée, espace consulté), s’authentifier auprès de services externes avec OAuth, et communiquer avec n’importe quoi via HTTP. Cette compétence couvre le cycle de vie de l’intégration — créer le squelette, coder, développer, publier. Pour créer ou restructurer la documentation *site* une intégration peut être installée dans, se référer à `configure-site`; pour rédiger le contenu des pages, se référer à `write-docs`. ## Ce qu’est une intégration (modèle mental) Une intégration est une petite application TypeScript exécutée par l’environnement d’exécution de GitBook — pas un script injecté dans les pages, et pas du code exécuté sur le serveur de l’utilisateur. Trois conséquences structurent tout le reste : 1. **Le rendu s’effectue sur le backend de GitBook.** Le `render` fonction s’exécute côté serveur à chaque interaction et renvoie du markup ContentKit (une description d’interface de type JSX). Il n’y a pas d’arbre React côté client que vous contrôlez, pas d’accès au DOM, et les mises à jour de l’UI passent par la boucle action → nouvel état → re-rendu. 2. **Vous ne pouvez pas injecter de JavaScript dans un site.** La `site:script:inject` et `site:script:cookies` portées que vous verrez dans les intégrations appartenant à GitBook sont réservées à un usage interne. Si le plan de l’utilisateur revient à « ajouter une balise script à sa documentation », arrêtez-vous et dites-le tôt — les voies prises en charge sont les blocs personnalisés, les webframes et les événements. 3. **Le développement local est un proxy, pas un serveur que vous visitez.** `gitbook dev` redirige *installée* Le trafic de l’intégration va vers votre machine. Vous n’ouvrez jamais le port du serveur de développement dans un navigateur ; vous interagissez avec l’intégration dans app.gitbook.com. ## Le projet `gitbook new` génère cette structure : ``` my-integration/ ├── gitbook-manifest.yaml # identité, portées, blocs, schéma de configuration ├── .gitbook-dev.yaml # config locale de développement (générée par `gitbook dev`) ├── package.json └── src/ └── index.tsx # fichier d’entrée — exportation par défaut createIntegration() ``` Le fichier d’entrée (quel que soit `script:` dans le manifeste pointe vers) exporte par défaut `createIntegration({ fetch, components, events })`: ```tsx import { createIntegration, createComponent } from '@gitbook/runtime'; const helloBlock = createComponent({ componentId: 'hello-world', // doit correspondre à l’id d’un bloc dans le manifeste initialState: { message: 'Say hello!' }, action: async (element, action, context) => { switch (action.action) { case 'say': return { state: { message: 'Bonjour le monde' } }; default: return {}; } }, render: async (element, context) => (