> ## Documentation Index
> Fetch the complete documentation index at: https://omer-914cc1c6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Vérifications CI

> Ajoutez des contrôles pour les liens cassés, le linting et la grammaire au processus de mise à jour

<Info>
  Les [offres Pro et Enterprise](https://mintlify.com/pricing?ref=docs-ci) incluent des vérifications CI pour les dépôts GitHub.
</Info>

Utilisez les vérifications CI pour analyser votre documentation, détecter les erreurs et afficher des avertissements avant le déploiement. Les vérifications CI sont configurées pour s’exécuter lors des commits sur votre branche de déploiement configurée, ou sur les pull requests (demandes de fusion) visant cette branche.

<div id="installation">
  ## Installation
</div>

Pour commencer, suivez les étapes sur la page [GitHub](/fr/settings/github).

Pour les GitHub Apps, vous pouvez choisir d’accorder des autorisations à un seul référentiel. Nous vous le recommandons vivement, car nous n’avons besoin d’accéder qu’au référentiel où votre documentation est hébergée.

<div id="configuration">
  ## Configuration
</div>

Configurez les contrôles CI activés pour un déploiement en vous rendant sur la page [Modules complémentaires](https://dashboard.mintlify.com/products/addons) de votre Dashboard. Activez les contrôles que vous souhaitez exécuter.

Lors de l’activation des contrôles, vous pouvez choisir de les exécuter avec un niveau `Avertissement` ou `Bloquant`.

* Un contrôle de niveau `Avertissement` n’affichera jamais un statut d’échec, même en cas d’erreur ou de suggestions.
* Un contrôle de niveau `Bloquant` affichera un statut d’échec s’il n’est pas réussi ou si des modifications sont suggérées.

<div id="available-ci-checks">
  ## Vérifications CI disponibles
</div>

<div id="broken-links">
  ### Liens rompus
</div>

Comme le [vérificateur de liens de l’interface en ligne de commande (CLI)](/fr/settings/broken-links#broken-links) sur votre machine locale, nous vérifions automatiquement vos docs pour détecter les liens rompus.

Pour consulter les résultats de cette vérification, rendez-vous sur la page des résultats de vérification GitHub du commit concerné.

<div id="vale">
  ### Vale
</div>

[Vale](https://vale.sh/) est un linter de prose open source, basé sur des règles, qui prend en charge un large éventail de types de documents, notamment Markdown et MDX.

Mintlify permet d’exécuter automatiquement Vale dans une vérification CI et d’afficher les résultats en tant que statut de vérification.

<div id="configuration">
  #### Configuration
</div>

Si vous avez un fichier `.vale.ini` à la racine du répertoire de contenu de votre déploiement, nous utilisons automatiquement ce fichier de configuration. Nous utilisons également automatiquement tout fichier de configuration présent dans le `stylesPath` que vous avez spécifié.

Si vous n’avez pas de fichier de configuration Vale, la configuration par défaut est chargée automatiquement.

```mdx Default vale.ini configuration expandable theme={null}
# Styles de niveau supérieur
StylesPath = /app/styles
MinAlertLevel = suggestion
IgnoredScopes = code, tt, img, url, a
SkippedScopes = script, style, pre, figure, code

# Vocabulaires
Vocab = Mintlify

# Ceci est requis car Vale ne prend pas officiellement en charge MDX
[formats]
mdx = md

# Prise en charge MDX
[*.mdx]
BasedOnStyles = Vale
Vale.Terms = NO # Applique des règles de capitalisation très strictes, laisser désactivé

# `import ...`, `export ...`
# `<Component ... />`
# `<Component>...</Component>`
# `{ ... }`
TokenIgnores = (?sm)((?:import|export) .+?$), \
(?<!`)(<\w+ ?.+ ?\/>)(?!`), \
(<[A-Z]\w+>.+?<\/[A-Z]\w+>)

# Exclure :
# `<Component \n ... />`
BlockIgnores = (?sm)^(<\w+\n .*\s\/>)$, \
(?sm)^({.+.*})

CommentDelimiters = {/*, */}
```

```text Default Vale vocabulary expandable theme={null}
Mintlify
mintlify
VSCode
openapi
OpenAPI
Github
API

repo
npm
dev

Lorem
ipsum
impsum
amet

const
myName
myObject
bearerAuth
favicon
topbar
url
borderRadius
args
modeToggle
ModeToggle
isHidden
autoplay

_italique_
Texte barré
Citations
Citation
Ligne unique
Multiligne

intégration

async
await
boolean
enum
func
impl
init
instanceof
typeof
params
stdin
stdout
stderr
stdout
stdin
var
const
let
null
undefined
struct
bool

cors
csrf
env
xhr
xhr2
JWT
OAuth
websocket
localhost
middleware
runtime
webhook
stdin
stdout

json
yaml
yml
md
txt
tsx
jsx
css
scss
html
png
jpg
svg

cdn
Interface en ligne de commande (CLI)
css
dom
dto
env
Git
gui
http
https
ide
jvm
mvc
orm
rpc
SDK
sql
ssh
ssl
tcp
tls
uri
URL
ux
ui

nodejs
npm
yarn
pnpm
eslint
pytest
golang
rustc
kubectl
mongo
postgres
redis

JavaScript
TypeScript
Python
Ruby
Rust
Go
Golang
Java
Kotlin
Swift
Node.js
NodeJS
Deno

React
Vue
Angular
Next.js
Nuxt
Express
Django
Flask
Spring
Laravel
Redux
Vuex
TensorFlow
PostgreSQL
MongoDB
Redis
PNPM

Docker
Kubernetes
AWS
Azure
GCP
Terraform
Jenkins
CircleCI
GitLab
Heroku

Git
git
GitHub
GitLab
Bitbucket
VSCode
Visual Studio Code
IntelliJ
WebStorm
ESLint
eslint
Prettier
prettier
Webpack
webpack
Vite
vite
Babel
babel
Jest
jest
Mocha
Cypress
Postman

HTTP
HTTPS
OAuth
JWT
GraphQL
REST
WebSocket
TCP/IP

NPM
Yarn
PNPM
Pip
PIP
Cargo
RubyGems

Swagger
OpenAPI
Markdown
MDX
Storybook
TypeDoc
JSDoc

MySQL
PostgreSQL
MongoDB
Redis
Elasticsearch
DynamoDB

Linux
Unix
macOS
iOS

Firefox
Chromium
WebKit

config
ctx
desc
dir
elem
err
len
msg
num
obj
prev
proc
ptr
req
res
str
tmp
val
vars

todo
href
lang
nav
prev
next
toc
```

<Avertissement>
  Pour des raisons de sécurité, nous ne pouvons pas prendre en charge un `stylesPath` absolu ni un `stylesPath` contenant des `..`. Utilisez des chemins relatifs et incluez le `stylesPath` dans votre référentiel.
</Avertissement>

<div id="packages">
  #### Paquets
</div>

Vale prend en charge un éventail de [paquets](https://vale.sh/docs/keys/packages), qui peuvent servir à vérifier l’orthographe et le style.
Tous les paquets que vous placez dans votre référentiel sous le `stylesPath` approprié sont automatiquement installés et utilisés dans votre configuration Vale.

Pour les paquets qui ne sont pas dans votre référentiel, vous pouvez indiquer n’importe quels paquets du [registre de paquets Vale](https://vale.sh/explorer) ; ils seront automatiquement téléchargés et utilisés dans votre configuration Vale.

<Avertissement>
  Pour des raisons de sécurité, nous ne pouvons pas prendre en charge le téléchargement automatique de paquets qui ne proviennent pas du [registre de paquets Vale](https://vale.sh/explorer).
</Avertissement>

<div id="vale-with-mdx">
  #### Vale avec `MDX`
</div>

Vale ne prend pas en charge nativement `MDX`, mais l’auteur de Vale a fourni une [extension personnalisée](https://github.com/errata-ai/MDX) pour l’ajouter.

Si vous préférez ne pas utiliser cette extension, nous recommandons d’ajouter les lignes suivantes à votre fichier `.vale.ini` :

```ini theme={null}
[formats]
mdx = md

[*.mdx]
CommentDelimiters = {/*, */}

TokenIgnores = (?sm)((?:import|export) .+?$), \
(?<!`)(<\w+ ?.+ ?\/>)(?!`), \
(<[A-Z]\w+>.+?<\/[A-Z]\w+>)

BlockIgnores = (?sm)^(<\w+\n .*\s\/>)$, \
(?sm)^({.+.*})
```

Pour utiliser les commentaires dans le document de Vale, utilisez des commentaires au format MDX `{/* ... */}`. Si vous utilisez le [paramètre](https://vale.sh/docs/keys/commentdelimiters) `CommentDelimiters = {/*, */}` dans votre configuration, Vale interprétera automatiquement ces commentaires lors de l’analyse (linting). Cela signifie que vous pouvez facilement utiliser les fonctionnalités intégrées de Vale, comme ignorer des lignes ou des sections.

```mdx theme={null}
{/* vale off */}

Ce texte sera ignoré par Vale

{/* vale on */}
```

Si vous choisissez de ne pas utiliser `CommentDelimiters` mais d’utiliser tout de même les commentaires de Vale, vous devez envelopper chaque commentaire Vale dans des commentaires MDX `{/* ... */}`. Par exemple :

```mdx theme={null}
{/* <!-- vale off --> */}

Ce texte sera ignoré par Vale

{/* <!-- vale on --> */}
```

Ces balises de commentaire ne sont pas prises en charge dans les composants Mintlify, mais peuvent être utilisées partout au niveau de base d’un document.
