---
contentId: 413e9430-e1c0-4ee2-89bb-af8fdadab2e0
part: 1
title: "Commencer avec VitePress : configuration et essentiels"
description: Configurez un projet VitePress avec Tailwind CSS et importez automatiquement des composants Vue pour un développement fluide.
github:
  branch: 01.project-initialization
date: 2024-10-10
seriesSlug: create-a-blog-with-vitepress-and-vue-js-from-scratch
---

Avant de commencer à créer notre blog, il est essentiel de comprendre ce qu'est [**VitePress**](https://vitepress.dev/) et ses origines. La familiarité avec les **outils** que nous utilisons pour la création de votre blog est cruciale.

## VitePress

Selon la [page d'accueil](https://vitepress.dev/) :

> Générateur de Sites Statique alimenté par Vite & Vue, de Markdown à de Belles Documentations en Quelques Minutes

Bien que l'utilisation du terme "documentations" dans le sous-titre puisse suggérer que VitePress est exclusivement destiné aux sites de documentation, il peut créer tout type de site centré sur le contenu.

La section ["Qu'est-ce que VitePress ?"](https://vitepress.dev/guide/what-is-vitepress) explique :

> VitePress est un Générateur de Site Statique (SSG) conçu pour créer des sites web rapides et centrés sur le contenu. En résumé, VitePress prend votre contenu source écrit en Markdown, applique un thème, et génère des pages HTML statiques qui peuvent être facilement déployées partout.

Essentiellement, VitePress se construit sur une application **Vite** et **Vue**, similaire à ce que vous pourriez générer avec `npx create-vite --template vue`. Cependant, VitePress offre bien plus.

Il introduit trois fonctionnalités clés à l'application standard Vite et Vue :

1. **Support du Markdown** : VitePress est livré avec un **compilateur Markdown vers HTML** préconfiguré basé sur markdown-it. Il prend en charge de manière inhérente **le frontmatter**, **la mise en syntaxe**, les alertes au style GitHub, **les emojis**, **les composants Vue**, et plus encore. Il tire parti d'une **configuration complète avec de nombreux plugins**. Vous pouvez consulter le [**code source**](https://github.com/vuejs/vitepress/blob/main/src/node/markdown/markdown.ts) pour plus d'informations.
2. **Chargement de Données** : VitePress permet le [**chargement de données**](https://vitepress.dev/guide/data-loading) à partir du **système de fichiers**, des réseaux, ou d'autres sources. Cette fonctionnalité puissante facilite la création de **sites web dynamiques** à l'aide d'un **générateur de site statique**.
3. **Pré-rendu au Moment de la Construction** : VitePress fonctionne comme une **Application à Page Unique (SPA)**, améliorant l'**Expérience Utilisateur (UX)** mais posant des défis en matière de **Référencement (SEO)**. Cependant, en raison de sa nature centrée sur le contenu **statique** en Markdown, VitePress **pré-rend les pages au moment de la construction**, ce qui entraîne des **fichiers HTML statiques**. Cette approche est excellente pour le SEO tout en maintenant les avantages SPA pour l'UX. Elle exploite habilement les capacités de Rendu Côté Serveur (SSR) de Vue, que vous pouvez observer dans le [**code source**](https://github.com/vuejs/vitepress/blob/main/src/client/app/ssr.ts#L10).

Ces éléments constituent la fondation de VitePress, le rendant idéal pour créer des blogs, de la documentation et d'autres sites web axés sur le contenu. Bien qu'il supporte des données dynamiques, cet aspect sera exploré dans une autre série.

Équipé d'un thème par défaut, VitePress facilite la création de sites de documentation attrayants. Le thème par défaut, disponible pour exploration dans la [documentation VitePress](https://vitepress.dev/) et son [code source](https://github.com/vuejs/vitepress/tree/main/src/client/theme-default), est simplement une bibliothèque Vue intégrée composée de composants, de composables et de CSS, facile à remplacer pour créer des thèmes personnalisés.

Comprendre l'implication réelle du sous-titre clarifie pourquoi VitePress est choisi pour développer un blog ; c'est un outil polyvalent pour les sites web centrés sur le contenu au-delà de la simple documentation.

![Architecture de VitePress](/series/create-a-blog-with-vitepress-and-vue-js-from-scratch/getting-started-with-vitepress-project-setup-and-essentials/vitepress-architecture.png)



> [!NOTE]
> Tenter d'utiliser une application Vite et Vue personnalisée est déconseillé. La complexité de VitePress et la gestion de la configuration vous font économiser un temps considérable, tant maintenant que lors des futures mises à jour du blog.



### Histoire

Développé par [Evan You](https://x.com/youyuxi) aux côtés de Vite, VitePress a testé Vite dans un cadre réel, garantissant sa praticité et sa convivialité. VitePress a évolué à partir de son prédécesseur VuePress, en faisant la transition de Webpack et Vue 2 à Vite et Vue 3, offrant des améliorations significatives en matière de performance et d'expérience développeur.

VitePress est populaire pour créer des sites de documentation ou des blogs comme [The Vue Point](https://blog.vuejs.org/), le blog officiel de Vue.js. Sa fine couche au-dessus de Vite garantit qu'il reste hautement extensible et personnalisable, avec des assurances de support continu.

## Initialisation du projet

Armés d'une meilleure compréhension de VitePress, nous pouvons initier un nouveau projet appelé "**Garabit**." Vous pouvez accéder au **code source** sur [barbapapazes/garabit](<https://github.com/barbapapazes/garabit>).

Bien qu'il soit initialement conçu pour les sites de documentation au sein de projets existants, le processus d'installation pourrait être plus fluide. J'ai souligné cela dans deux demandes de tirage sur le dépôt VitePress : [feat(cli): support des préfixes de scripts npm personnalisés](https://github.com/vuejs/vitepress/pull/4271) et [feat(cli): support du `srcDir` personnalisé](https://github.com/vuejs/vitepress/pull/4270).

Tout d'abord, créons un dossier pour notre projet :

```bash [terminal]
mkdir garabit
```

Ensuite, initialisons **npm** dans ce dossier et installons VitePress :

```bash [terminal]
pnpm init
pnpm add -D vitepress
```



> [!NOTE]
> Tout au long de cette série, j'utiliserai [`pnpm`](https://pnpm.io/) comme gestionnaire de paquets, mais vous pouvez adapter les commandes à votre gestionnaire de paquets préféré.



Enfin, générons le projet VitePress :

```bash [terminal]
pnpm vitepress init
```

Répondons aux invites (appuyons sur entrer pour les valeurs par défaut, que nous ajusterons plus tard) :

```bash [terminal]
┌  Welcome to VitePress!
│
◇  Where should VitePress initialize the config?
│  ./
│
◇  Site title:
│  My Awesome Project
│
◇  Site description:
│  A VitePress Site
│
◇  Theme:
│  Default Theme
│
◇  Use TypeScript for config and theme files?
│  Yes
│
◇  Add VitePress npm scripts to package.json?
│  Yes
│
└  Done! Now run pnpm run docs:dev and start writing.
```

## Explorer le projet

Nous avons maintenant un projet VitePress tout neuf. Examinons la **structure du projet** :

```bash [terminal]
.
├── .vitepress
│   └── config.mts
├── api-examples.md
├── index.md
├── markdown-examples.md
├── package.json
└── pnpm-lock.yaml
```

Le niveau racine contient nos fichiers Markdown, représentant les pages de notre blog, avec des noms de fichiers (et des répertoires) correspondant aux URL des pages. `index.md` sert de page d'accueil. Bien que cette structure soit basique, nous la peaufinerons dans de futurs articles.

Étant centré sur le contenu, la configuration et les éléments liés au thème de VitePress se trouvent dans le répertoire `.vitepress`, où le fichier `config.mts` configure le thème, les plugins, le chargement de données, et plus encore, écrit en **TypeScript**. Nous plongerons dans ce sujet dans les articles à venir.

## Améliorer l'expérience développeur (DX)

Bien qu'adéquate pour les sites de documentation, notre blog personnalisé nécessite des dépendances supplémentaires pour améliorer l'expérience développeur (DX). Nous allons incorporer deux dépendances :

- [**Tailwind CSS**](https://tailwindcss.com/) : Un **framework CSS** axé sur les utilitaires pour créer efficacement des designs personnalisés.
- [**unplugin-vue-components**](https://github.com/unplugin/unplugin-vue-components) : Un plugin Vite pour **l'importation automatique de composants Vue**.

### Tailwind CSS

Nous allons tirer parti de Tailwind CSS pour styliser notre thème personnalisé. Ce framework CSS axé sur les utilitaires offre de puissantes capacités de design conviviales.

Commençons par installer **Tailwind CSS** :

```bash [terminal]
pnpm add -D tailwindcss postcss autoprefixer
```

Créons le fichier de configuration pour Tailwind CSS :

```bash [terminal]
npx tailwindcss init -p
```

Nous configurerons Tailwind CSS au fur et à mesure de nos progrès.

### Importation automatique des composants Vue

Nous utiliserons unplugin-vue-components pour l'importation automatique des composants Vue, un **plugin Vite** permettant l'importation de composants à la demande. Ce processus automatisé permet de gagner un temps considérable en éliminant l'importation manuelle par fichier. Les composants ne sont pas disponibles globalement, minimisant ainsi l'impact sur les performances, car nos fichiers sont transformés via un plugin Rollup, ajoutant un import en haut du fichier uniquement si le composant est utilisé – un témoignage de la philosophie à la demande.

Tout d'abord, installons **unplugin-vue-components** :

```bash [terminal]
pnpm add -D unplugin-vue-components
```

Ensuite, intégrons-le dans le fichier `config.mts` :

```typescript [config.mts]
import Components from 'unplugin-vue-components/vite'
import { defineConfig } from 'vitepress'

export default defineConfig({
  // ...
  vite: {
    plugins: [Components()],
  },
})
```

Nous configurerons unplugin-vue-components de manière plus complète plus tard.

## Prêts pour la prochaine étape

Avec notre projet VitePress maintenant doté de **Tailwind CSS** et de **unplugin-vue-components**, nous sommes prêts à commencer à développer notre blog.

Dans le prochain article, nous examinerons les **fondamentaux de VitePress** et créerons un thème personnalisé pour notre blog.
