---
contentId: 4944fbc5-ca12-4a03-a7ac-f1f96bc01344
part: 9
title: Déployer un blog VitePress simplement avec Cloudflare Pages
description: Déployer le blog sur Cloudflare Pages. Découvrez comment déployer le blog sur Cloudflare Pages et le partager dans le monde entier en toute simplicité.
github:
  branch: 09.share-the-blog-globally
date: 2024-11-21
seriesSlug: create-a-blog-with-vitepress-and-vue-js-from-scratch
---

Aujourd'hui marque le jour où nous rendons notre **blog** accessible au monde via [**Cloudflare Pages**](https://pages.cloudflare.com). Ce processus est simple une fois que vous avez appris la procédure. La première tentative peut sembler intimidante, surtout si vous êtes nouveau dans le développement web, mais avec le guide d'aujourd'hui, vous pourrez partager le blog en seulement quelques clics.

## Composants essentiels

Avant de déployer notre blog, nous devons aborder quelques composants essentiels. Notre blog nécessite un en-tête et une **page d'accueil** pour être complet.

### En-tête

Pour l'en-tête, je la garde aussi minimal que possible car ce n'est pas le principal objectif de cette série. Je vais créer un composant `TheHeader.vue` dans le répertoire `.vitepress/theme/components`. Ce composant contiendra le titre de notre blog et une barre de navigation avec deux liens : **Blog** et **Projets**, qui est un modèle courant pour les blogs.

```vue [TheHeader.vue]
<script lang="ts" setup>
const { site } = useData()
</script>

<template>
  <header class="border-b-4 border-black bg-white p-8">
    <div
      class="mx-auto max-w-screen-md flex flex-col items-center justify-between gap-6 md:flex-row"
    >
      <span>
        <a href="/" class="text-2xl text-black font-semibold">
          {{ site.title }}
        </a>
      </span>

      <div class="flex items-center gap-6">
        <ButtonPrimary href="/blog">
          Blog
        </ButtonPrimary>

        <ButtonPrimary href="/projects">
          Projects
        </ButtonPrimary>
      </div>
    </div>
  </header>
</template>
```

Ensuite, nous pouvons l'inclure dans le composant `Layout.vue`.

```vue [Layout.vue]
<script lang="ts" setup>
// ...
</script>

<template>
  <div class="min-h-screen bg-[#FC88FF] py-16">
    <TheHeader /> // [!code ++]

    <!-- ... -->
  </div>
</template>
```

### Accueil

Pour la page d'accueil, nous maîtrisons déjà le processus.

1. Créons un fichier `index.md` dans le répertoire `src` avec le contenu suivant :

```md [index.md]
---
layout: home
title: Accueil
---

<img
  src="https://github.com/barbapapazes.png"
  alt="Photo de Profil"
  class="h-32 w-32 my-0 border-4 border-black rounded-full"
/>

Bonjour, je suis Estéban "[Barbapapazes](https://gh.soubiran.dev)" Soubiran.

Je suis passionné par les **technologies web**, élargissant continuellement mes connaissances
dans des domaines comme la technologie, la finance et l'entrepreneuriat. J'aime partager
mes idées et collaborer avec d'autres. C'est pourquoi je donne des conférences et écris
des articles. Je streame également sur Twitch, où je travaille sur des projets, essaie de nouveaux
outils et explique divers concepts.

Je privilégie la simplicité plutôt que la complexité lors de la création d'expériences utilisateur. Je me concentre
sur les détails pour offrir le meilleur produit possible qui plait à la fois au
client et à l'utilisateur.

Ainsi, j'ai développé une expertise en **JavaScript**, **TypeScript**, **Angular**, **Vue** ,
**Nuxt**, **Adonis**, **Laravel**, ce qui m'aide à comprendre en profondeur les
besoins du client et à proposer les meilleures solutions.
```



> [!NOTE]
> Vous devriez personnaliser le contenu pour refléter votre propre profil.



2. Créons le composant de mise en page `Home.vue` dans le répertoire `.vitepress/theme/pages` :

```vue [Home.vue]
<template>
  <section>
    <h1 class="text-6xl text-black font-semibold">
      Bienvenue!
    </h1>

    <div
      class="mt-16 border-4 border-black bg-[#4FFFAF] p-12 shadow-[8px_8px_0_black]"
    >
      <Content
        class="prose-xl text-black prose prose-zinc [&>div>:first-child]:mt-0 [&>div>:last-child]:mb-0"
      />
    </div>
  </section>

  <section class="mt-16">
    <h2 class="text-4xl text-black font-semibold">
      Trouvez-moi en ligne
    </h2>

    <div class="mt-8 flex flex-wrap justify-center gap-8 md:justify-start">
      <ButtonSecondary href="https://x.soubiran.dev" target="_blank">
        Twitter
      </ButtonSecondary>

      <ButtonSecondary href="https://gh.soubiran.dev" target="_blank">
        GitHub
      </ButtonSecondary>

      <ButtonSecondary href="https://linkedin.soubiran.dev" target="_blank">
        LinkedIn
      </ButtonSecondary>

      <ButtonSecondary href="https://tv.soubiran.dev" target="_blank">
        Twitch
      </ButtonSecondary>
    </div>
  </section>
</template>
```

3. Créons un composant `ButtonSecondary` dans le répertoire `.vitepress/theme/components` :

```vue [Exemple]
<script lang="ts" setup>
defineProps<{
  href: string
}>()
</script>

<template>
  <a
    :href
    class="inline-block border-4 border-black bg-[var(--color-purple)] px-8 py-4 text-white shadow-[4px_4px_0_black] transition duration-150 ease-linear hover:bg-[#828cd2] hover:shadow-[6px_6px_0_black] hover:-translate-x-[0.125rem] hover:-translate-y-[0.125rem]"
  >
    <slot />
  </a>
</template>
```

4. Mettez à jour les fichiers `app.css` et `alerts.css` pour inclure la nouvelle couleur `--color-purple` :

```css [alerts.css]
@tailwind base;
@tailwind components;
@tailwind utilities;

:root {
  --color-yellow: #ffbf00;
  --color-purple: #6c71c4; /* [!code ++] */
  --color-sand: #fdf6e3;
}
```

```css [Exemple]
:root {
  --color-note: #3a85ff;
  --color-tip: #00ddb3;
  --color-warning: var(--color-yellow);
  --color-severe: #ff7002;
  --color-caution: #f34720;
  --color-important: var(--color-purple); /* [!code ++] */
}
```

5. Routons la page d'accueil en mettant à jour le composant `Layout.vue` :

```vue [Layout.vue]
<script lang="ts" setup>
const { frontmatter } = useData()
</script>

<template>
  <div class="min-h-screen bg-[#FC88FF] py-16">
    <main class="mx-auto max-w-screen-md">
      <Home v-if="frontmatter.layout === 'home'" /> // [!code ++]

      <BlogIndex v-else-if="frontmatter.layout === 'blog'" />
      <BlogShow v-else-if="frontmatter.layout === 'blog-show'" />

      <ProjectsIndex v-else-if="frontmatter.layout === 'projects'" />
    </main>
  </div>
</template>
```

### Refactorisation de `ButtonPrimary`

J'ai également affiné le composant `ButtonPrimary` pour supprimer l'attribut `href` par défaut et utiliser une prop à la place.

```vue [Exemple]
<script lang="ts" setup>
defineProps<{
  href: string
}>()
</script>

<template>
  <a
    :href
    class="..."
  >
    <slot />
  </a>
</template>
```

### Design responsif

J'ai ajouté quelques classes pour améliorer la **responsivité** du blog. Dans le composant `BlogShow.vue`, j'ai supprimé la classe `mx-4` du conteneur `article`. Au lieu de cela, la marge est gérée dans le composant `Layout.vue`.

```vue [Layout.vue]
<script lang="ts" setup>
const { frontmatter } = useData()
</script>

<template>
  <div class="min-h-screen bg-[#FC88FF]">
    <TheHeader />

    <div class="px-4 py-16">
      <main class="mx-auto max-w-screen-md">
        <Home v-if="frontmatter.layout === 'home'" />

        <BlogIndex v-else-if="frontmatter.layout === 'blog'" />
        <BlogShow v-else-if="frontmatter.layout === 'blog-show'" />

        <ProjectsIndex v-else-if="frontmatter.layout === 'projects'" />
      </main>
    </div>
  </div>
</template>
```

Sur le premier `div`, j'ai supprimé la classe `py-16`. Autour du `main`, j'ai ajouté `px-4 py-16`. Cela permet de s'assurer que le contenu reste éloigné des bords de l'écran sur les appareils mobiles, améliorant ainsi la **lisibilité**.

## Déployer sur Cloudflare Pages

Maintenant que notre blog est complètement développé, nous pouvons le déployer sur **Cloudflare Pages**.

**Cloudflare** est une entreprise qui propose de nombreux services pour améliorer la vitesse et la sécurité du web, tels qu'une solution zero-trust, un **WAF**, un **CDN**, **DNS**, une protection **DDoS**, et plus encore pour les entreprises et les particuliers.

Leur service le plus renommé est le **proxy inverse**. Cloudflare agit comme la passerelle principale pour notre trafic, le redirigeant ensuite en interne vers le serveur correct via DNS. Cela nous permet de masquer l'IP de notre serveur, de mettre en cache des actifs statiques et de protéger notre serveur contre les attaques DDoS.

**Cloudflare Pages** est l'une de leurs offres. C'est une plateforme d'hébergement pour des sites web statiques et [JAMstack](https://jamstack.wtf/), avec un généreux niveau gratuit parfait pour des projets personnels.



> [!IMPORTANT]
> Des plateformes comme [Vercel](https://vercel.com/) ou [Netlify](https://www.netlify.com/) auraient pu être utilisées pour déployer notre blog. Ce sont d'excellentes plateformes pour des sites web statiques. J'ai choisi Cloudflare Pages car elle est devenue ma plateforme préférée car elle combine de nombreux services : **DNS**, **CDN**, protection **DDoS**, hébergement, Registrar, **Workers**, et plus encore.



En utilisant **Cloudflare Pages**, nous avons deux choix pour le déploiement de notre site web :

1. **CLI** : Utiliser le **CLI** de Cloudflare pour pousser les fichiers générés vers Cloudflare Pages, qui déploie ensuite automatiquement le site sur leur réseau.
2. **Dépôt Git** : Connecter notre dépôt **GitHub** ou **GitLab** à Cloudflare Pages. Tous les commits sur la branche `main` déclenchera Cloudflare pour construire et déployer automatiquement le site. Nous allons utiliser cette option pour sa commodité. Il suffit de pousser et le site est en ligne. De plus, Cloudflare déploie un aperçu pour chaque pull request afin de vérifier les modifications avant qu'elles ne soient fusionnées.



> [!NOTE]
> Vous avez besoin d'un compte **Cloudflare** pour continuer. Si vous n'en avez pas, vous pouvez créer un compte gratuit et vous connecter.



Dans la barre latérale gauche, cliquons sur "Workers & Pages". Nous verrons le tableau de bord "Aperçu". Cliquons sur le bouton "Créer" pour démarrer un nouveau projet.

Par défaut, le panneau de création est réglé sur "Workers". Cliquons sur l'onglet "Pages" pour passer au panneau de création "Pages". Ensuite, cliquons sur "Connecter à Git".

Sélectionnons le dépôt hébergeant le blog. Une fois sélectionné, cliquons sur "Commencer la configuration".

![Connecter à Git Page](/series/create-a-blog-with-vitepress-and-vue-js-from-scratch/deploy-vitepress-blog-globally-with-cloudflare-pages/vitepress-cloudflare-connect-to-git.png)

La partie cruciale est les "Paramètres de construction". Réglons la "Commande de construction" sur `npm run build` et le "Répertoire de sortie de construction" sur `.vitepress/dist`. Ces paramètres sont spécifiques aux projets VitePress et à la configuration de notre blog.

Enfin, cliquons sur "Sauvegarder et Déployer". Cloudflare construira et déploiera notre blog. Une fois le déploiement terminé, l'**URL** de notre blog s'affichera. Cliquons sur celle-ci pour voir notre blog en direct. 🚀

Partageons l'**URL** avec vos amis et votre famille. Nous pouvons également la publier sur les réseaux sociaux pour atteindre un public plus large. Profitons de votre nouveau blog! 🎉



> [!TIP]
> Ajoutez un **domaine personnalisé** à votre blog sous l'onglet "Domaines personnalisés". C'est simple à configurer et rend votre blog plus **professionnel**.



![Page d'accueil](/series/create-a-blog-with-vitepress-and-vue-js-from-scratch/deploy-vitepress-blog-globally-with-cloudflare-pages/vitepress-home.png)

## Conclusion

Félicitations! Vous avez réussi à créer un **blog** avec **VitePress** et **Vue.js** depuis zéro. Vous avez appris à établir un nouveau projet VitePress, à configurer des thèmes de base personnalisés, à concevoir l'architecture du blog, à compiler et à lire des articles de blog, à enrichir automatiquement les métadonnées **SEO** et les sitemaps, à présenter des projets GitHub, à générer automatiquement des images Open Graph, et à partager votre blog à l'échelle mondiale.

Votre parcours s'est culminé dans un blog entièrement opérationnel et engageant, vous permettant de vous concentrer uniquement sur la production de contenu. Il vous suffit d'écrire et de publier, car le blog gérera tout le reste de manière autonome.

J'espère sincèrement que vous avez trouvé cette série éclairante. Si vous avez des **questions** ou des commentaires, n'hésitez pas à partager vos idées dans la section des **commentaires** sous chaque article.
