[{"data":1,"prerenderedAt":1290},["ShallowReactive",2],{"series-\u002Ffr\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch\u002Fgetting-started-with-vitepress-project-setup-and-essentials":3,"series-context-\u002Ffr\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch":991},{"id":4,"title":5,"body":6,"contentId":974,"date":975,"description":976,"extension":977,"github":978,"meetTheInstructor":980,"meta":981,"navigation":887,"part":298,"path":982,"rawbody":983,"robots":980,"schemaOrg":980,"seo":984,"seriesSlug":985,"sitemap":986,"stem":989,"subtitle":980,"topics":980,"__hash__":990},"series\u002Ffr\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch\u002Fgetting-started-with-vitepress-project-setup-and-essentials.md","Commencer avec VitePress : configuration et essentiels",{"type":7,"value":8,"toc":962},"minimark",[9,28,32,40,46,49,58,63,79,82,185,188,201,204,215,223,228,237,246,250,264,281,284,307,314,342,354,357,371,374,621,625,631,695,702,717,721,724,754,757,760,765,787,790,808,811,815,822,827,843,848,935,938,942,951,958],[10,11,12,13,23,24,27],"p",{},"Avant de commencer à créer notre blog, il est essentiel de comprendre ce qu'est ",[14,15,19],"a",{"href":16,"rel":17},"https:\u002F\u002Fvitepress.dev\u002F",[18],"nofollow",[20,21,22],"strong",{},"VitePress"," et ses origines. La familiarité avec les ",[20,25,26],{},"outils"," que nous utilisons pour la création de votre blog est cruciale.",[29,30,22],"h2",{"id":31},"vitepress",[10,33,34,35,39],{},"Selon la ",[14,36,38],{"href":16,"rel":37},[18],"page d'accueil"," :",[41,42,43],"blockquote",{},[10,44,45],{},"Générateur de Sites Statique alimenté par Vite & Vue, de Markdown à de Belles Documentations en Quelques Minutes",[10,47,48],{},"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.",[10,50,51,52,57],{},"La section ",[14,53,56],{"href":54,"rel":55},"https:\u002F\u002Fvitepress.dev\u002Fguide\u002Fwhat-is-vitepress",[18],"\"Qu'est-ce que VitePress ?\""," explique :",[41,59,60],{},[10,61,62],{},"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.",[10,64,65,66,69,70,73,74,78],{},"Essentiellement, VitePress se construit sur une application ",[20,67,68],{},"Vite"," et ",[20,71,72],{},"Vue",", similaire à ce que vous pourriez générer avec ",[75,76,77],"code",{},"npx create-vite --template vue",". Cependant, VitePress offre bien plus.",[10,80,81],{},"Il introduit trois fonctionnalités clés à l'application standard Vite et Vue :",[83,84,85,123,149],"ol",{},[86,87,88,91,92,95,96,99,100,103,104,99,107,110,111,114,115,122],"li",{},[20,89,90],{},"Support du Markdown"," : VitePress est livré avec un ",[20,93,94],{},"compilateur Markdown vers HTML"," préconfiguré basé sur markdown-it. Il prend en charge de manière inhérente ",[20,97,98],{},"le frontmatter",", ",[20,101,102],{},"la mise en syntaxe",", les alertes au style GitHub, ",[20,105,106],{},"les emojis",[20,108,109],{},"les composants Vue",", et plus encore. Il tire parti d'une ",[20,112,113],{},"configuration complète avec de nombreux plugins",". Vous pouvez consulter le ",[14,116,119],{"href":117,"rel":118},"https:\u002F\u002Fgithub.com\u002Fvuejs\u002Fvitepress\u002Fblob\u002Fmain\u002Fsrc\u002Fnode\u002Fmarkdown\u002Fmarkdown.ts",[18],[20,120,121],{},"code source"," pour plus d'informations.",[86,124,125,128,129,136,137,140,141,144,145,148],{},[20,126,127],{},"Chargement de Données"," : VitePress permet le ",[14,130,133],{"href":131,"rel":132},"https:\u002F\u002Fvitepress.dev\u002Fguide\u002Fdata-loading",[18],[20,134,135],{},"chargement de données"," à partir du ",[20,138,139],{},"système de fichiers",", des réseaux, ou d'autres sources. Cette fonctionnalité puissante facilite la création de ",[20,142,143],{},"sites web dynamiques"," à l'aide d'un ",[20,146,147],{},"générateur de site statique",".",[86,150,151,154,155,158,159,162,163,166,167,170,171,174,175,178,179,148],{},[20,152,153],{},"Pré-rendu au Moment de la Construction"," : VitePress fonctionne comme une ",[20,156,157],{},"Application à Page Unique (SPA)",", améliorant l'",[20,160,161],{},"Expérience Utilisateur (UX)"," mais posant des défis en matière de ",[20,164,165],{},"Référencement (SEO)",". Cependant, en raison de sa nature centrée sur le contenu ",[20,168,169],{},"statique"," en Markdown, VitePress ",[20,172,173],{},"pré-rend les pages au moment de la construction",", ce qui entraîne des ",[20,176,177],{},"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 ",[14,180,183],{"href":181,"rel":182},"https:\u002F\u002Fgithub.com\u002Fvuejs\u002Fvitepress\u002Fblob\u002Fmain\u002Fsrc\u002Fclient\u002Fapp\u002Fssr.ts#L10",[18],[20,184,121],{},[10,186,187],{},"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.",[10,189,190,191,195,196,200],{},"É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 ",[14,192,194],{"href":16,"rel":193},[18],"documentation VitePress"," et son ",[14,197,121],{"href":198,"rel":199},"https:\u002F\u002Fgithub.com\u002Fvuejs\u002Fvitepress\u002Ftree\u002Fmain\u002Fsrc\u002Fclient\u002Ftheme-default",[18],", 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.",[10,202,203],{},"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.",[205,206,207,212],"figure",{},[208,209],"img",{"alt":210,"src":211},"Architecture de VitePress","\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch\u002Fgetting-started-with-vitepress-project-setup-and-essentials\u002Fvitepress-architecture.png",[213,214,210],"figcaption",{},[216,217,220],"callout",{"color":218,"icon":219},"info","i-ph-info-duotone",[10,221,222],{},"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.",[224,225,227],"h3",{"id":226},"histoire","Histoire",[10,229,230,231,236],{},"Développé par ",[14,232,235],{"href":233,"rel":234},"https:\u002F\u002Fx.com\u002Fyouyuxi",[18],"Evan You"," 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.",[10,238,239,240,245],{},"VitePress est populaire pour créer des sites de documentation ou des blogs comme ",[14,241,244],{"href":242,"rel":243},"https:\u002F\u002Fblog.vuejs.org\u002F",[18],"The Vue Point",", 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.",[29,247,249],{"id":248},"initialisation-du-projet","Initialisation du projet",[10,251,252,253,256,257,259,260,148],{},"Armés d'une meilleure compréhension de VitePress, nous pouvons initier un nouveau projet appelé \"",[20,254,255],{},"Garabit",".\" Vous pouvez accéder au ",[20,258,121],{}," sur ",[261,262],"git-hub-link",{"repo":263},"barbapapazes\u002Fgarabit",[10,265,266,267,69,272,148],{},"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 : ",[14,268,271],{"href":269,"rel":270},"https:\u002F\u002Fgithub.com\u002Fvuejs\u002Fvitepress\u002Fpull\u002F4271",[18],"feat(cli): support des préfixes de scripts npm personnalisés",[14,273,276,277,280],{"href":274,"rel":275},"https:\u002F\u002Fgithub.com\u002Fvuejs\u002Fvitepress\u002Fpull\u002F4270",[18],"feat(cli): support du ",[75,278,279],{},"srcDir"," personnalisé",[10,282,283],{},"Tout d'abord, créons un dossier pour notre projet :",[285,286,292],"pre",{"className":287,"code":288,"filename":289,"language":290,"meta":291,"style":291},"language-bash shiki shiki-themes github-light github-light github-dark","mkdir garabit\n","terminal","bash","",[75,293,294],{"__ignoreMap":291},[295,296,299,303],"span",{"class":297,"line":298},"line",1,[295,300,302],{"class":301},"snPdu","mkdir",[295,304,306],{"class":305},"sIIMD"," garabit\n",[10,308,309,310,313],{},"Ensuite, initialisons ",[20,311,312],{},"npm"," dans ce dossier et installons VitePress :",[285,315,317],{"className":287,"code":316,"filename":289,"language":290,"meta":291,"style":291},"pnpm init\npnpm add -D vitepress\n",[75,318,319,327],{"__ignoreMap":291},[295,320,321,324],{"class":297,"line":298},[295,322,323],{"class":301},"pnpm",[295,325,326],{"class":305}," init\n",[295,328,330,332,335,339],{"class":297,"line":329},2,[295,331,323],{"class":301},[295,333,334],{"class":305}," add",[295,336,338],{"class":337},"sBjJW"," -D",[295,340,341],{"class":305}," vitepress\n",[216,343,344],{"color":218,"icon":219},[10,345,346,347,353],{},"Tout au long de cette série, j'utiliserai ",[14,348,351],{"href":349,"rel":350},"https:\u002F\u002Fpnpm.io\u002F",[18],[75,352,323],{}," comme gestionnaire de paquets, mais vous pouvez adapter les commandes à votre gestionnaire de paquets préféré.",[10,355,356],{},"Enfin, générons le projet VitePress :",[285,358,360],{"className":287,"code":359,"filename":289,"language":290,"meta":291,"style":291},"pnpm vitepress init\n",[75,361,362],{"__ignoreMap":291},[295,363,364,366,369],{"class":297,"line":298},[295,365,323],{"class":301},[295,367,368],{"class":305}," vitepress",[295,370,326],{"class":305},[10,372,373],{},"Répondons aux invites (appuyons sur entrer pour les valeurs par défaut, que nous ajusterons plus tard) :",[285,375,377],{"className":287,"code":376,"filename":289,"language":290,"meta":291,"style":291},"┌  Welcome to VitePress!\n│\n◇  Where should VitePress initialize the config?\n│  .\u002F\n│\n◇  Site title:\n│  My Awesome Project\n│\n◇  Site description:\n│  A VitePress Site\n│\n◇  Theme:\n│  Default Theme\n│\n◇  Use TypeScript for config and theme files?\n│  Yes\n│\n◇  Add VitePress npm scripts to package.json?\n│  Yes\n│\n└  Done! Now run pnpm run docs:dev and start writing.\n",[75,378,379,393,398,422,431,436,447,461,466,476,489,494,502,513,518,544,552,557,578,585,590],{"__ignoreMap":291},[295,380,381,384,387,390],{"class":297,"line":298},[295,382,383],{"class":301},"┌",[295,385,386],{"class":305},"  Welcome",[295,388,389],{"class":305}," to",[295,391,392],{"class":305}," VitePress!\n",[295,394,395],{"class":297,"line":329},[295,396,397],{"class":301},"│\n",[295,399,401,404,407,410,413,416,419],{"class":297,"line":400},3,[295,402,403],{"class":301},"◇",[295,405,406],{"class":305},"  Where",[295,408,409],{"class":305}," should",[295,411,412],{"class":305}," VitePress",[295,414,415],{"class":305}," initialize",[295,417,418],{"class":305}," the",[295,420,421],{"class":305}," config?\n",[295,423,425,428],{"class":297,"line":424},4,[295,426,427],{"class":301},"│",[295,429,430],{"class":305},"  .\u002F\n",[295,432,434],{"class":297,"line":433},5,[295,435,397],{"class":301},[295,437,439,441,444],{"class":297,"line":438},6,[295,440,403],{"class":301},[295,442,443],{"class":305},"  Site",[295,445,446],{"class":305}," title:\n",[295,448,450,452,455,458],{"class":297,"line":449},7,[295,451,427],{"class":301},[295,453,454],{"class":305},"  My",[295,456,457],{"class":305}," Awesome",[295,459,460],{"class":305}," Project\n",[295,462,464],{"class":297,"line":463},8,[295,465,397],{"class":301},[295,467,469,471,473],{"class":297,"line":468},9,[295,470,403],{"class":301},[295,472,443],{"class":305},[295,474,475],{"class":305}," description:\n",[295,477,479,481,484,486],{"class":297,"line":478},10,[295,480,427],{"class":301},[295,482,483],{"class":305},"  A",[295,485,412],{"class":305},[295,487,488],{"class":305}," Site\n",[295,490,492],{"class":297,"line":491},11,[295,493,397],{"class":301},[295,495,497,499],{"class":297,"line":496},12,[295,498,403],{"class":301},[295,500,501],{"class":305},"  Theme:\n",[295,503,505,507,510],{"class":297,"line":504},13,[295,506,427],{"class":301},[295,508,509],{"class":305},"  Default",[295,511,512],{"class":305}," Theme\n",[295,514,516],{"class":297,"line":515},14,[295,517,397],{"class":301},[295,519,521,523,526,529,532,535,538,541],{"class":297,"line":520},15,[295,522,403],{"class":301},[295,524,525],{"class":305},"  Use",[295,527,528],{"class":305}," TypeScript",[295,530,531],{"class":305}," for",[295,533,534],{"class":305}," config",[295,536,537],{"class":305}," and",[295,539,540],{"class":305}," theme",[295,542,543],{"class":305}," files?\n",[295,545,547,549],{"class":297,"line":546},16,[295,548,427],{"class":301},[295,550,551],{"class":305},"  Yes\n",[295,553,555],{"class":297,"line":554},17,[295,556,397],{"class":301},[295,558,560,562,565,567,570,573,575],{"class":297,"line":559},18,[295,561,403],{"class":301},[295,563,564],{"class":305},"  Add",[295,566,412],{"class":305},[295,568,569],{"class":305}," npm",[295,571,572],{"class":305}," scripts",[295,574,389],{"class":305},[295,576,577],{"class":305}," package.json?\n",[295,579,581,583],{"class":297,"line":580},19,[295,582,427],{"class":301},[295,584,551],{"class":305},[295,586,588],{"class":297,"line":587},20,[295,589,397],{"class":301},[295,591,593,596,599,602,605,608,610,613,615,618],{"class":297,"line":592},21,[295,594,595],{"class":301},"└",[295,597,598],{"class":305},"  Done!",[295,600,601],{"class":305}," Now",[295,603,604],{"class":305}," run",[295,606,607],{"class":305}," pnpm",[295,609,604],{"class":305},[295,611,612],{"class":305}," docs:dev",[295,614,537],{"class":305},[295,616,617],{"class":305}," start",[295,619,620],{"class":305}," writing.\n",[29,622,624],{"id":623},"explorer-le-projet","Explorer le projet",[10,626,627,628,39],{},"Nous avons maintenant un projet VitePress tout neuf. Examinons la ",[20,629,630],{},"structure du projet",[285,632,634],{"className":287,"code":633,"filename":289,"language":290,"meta":291,"style":291},".\n├── .vitepress\n│   └── config.mts\n├── api-examples.md\n├── index.md\n├── markdown-examples.md\n├── package.json\n└── pnpm-lock.yaml\n",[75,635,636,641,649,659,666,673,680,687],{"__ignoreMap":291},[295,637,638],{"class":297,"line":298},[295,639,640],{"class":337},".\n",[295,642,643,646],{"class":297,"line":329},[295,644,645],{"class":301},"├──",[295,647,648],{"class":305}," .vitepress\n",[295,650,651,653,656],{"class":297,"line":400},[295,652,427],{"class":301},[295,654,655],{"class":305},"   └──",[295,657,658],{"class":305}," config.mts\n",[295,660,661,663],{"class":297,"line":424},[295,662,645],{"class":301},[295,664,665],{"class":305}," api-examples.md\n",[295,667,668,670],{"class":297,"line":433},[295,669,645],{"class":301},[295,671,672],{"class":305}," index.md\n",[295,674,675,677],{"class":297,"line":438},[295,676,645],{"class":301},[295,678,679],{"class":305}," markdown-examples.md\n",[295,681,682,684],{"class":297,"line":449},[295,683,645],{"class":301},[295,685,686],{"class":305}," package.json\n",[295,688,689,692],{"class":297,"line":463},[295,690,691],{"class":301},"└──",[295,693,694],{"class":305}," pnpm-lock.yaml\n",[10,696,697,698,701],{},"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. ",[75,699,700],{},"index.md"," sert de page d'accueil. Bien que cette structure soit basique, nous la peaufinerons dans de futurs articles.",[10,703,704,705,708,709,712,713,716],{},"Étant centré sur le contenu, la configuration et les éléments liés au thème de VitePress se trouvent dans le répertoire ",[75,706,707],{},".vitepress",", où le fichier ",[75,710,711],{},"config.mts"," configure le thème, les plugins, le chargement de données, et plus encore, écrit en ",[20,714,715],{},"TypeScript",". Nous plongerons dans ce sujet dans les articles à venir.",[29,718,720],{"id":719},"améliorer-lexpérience-développeur-dx","Améliorer l'expérience développeur (DX)",[10,722,723],{},"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 :",[725,726,727,741],"ul",{},[86,728,729,736,737,740],{},[14,730,733],{"href":731,"rel":732},"https:\u002F\u002Ftailwindcss.com\u002F",[18],[20,734,735],{},"Tailwind CSS"," : Un ",[20,738,739],{},"framework CSS"," axé sur les utilitaires pour créer efficacement des designs personnalisés.",[86,742,743,750,751,148],{},[14,744,747],{"href":745,"rel":746},"https:\u002F\u002Fgithub.com\u002Funplugin\u002Funplugin-vue-components",[18],[20,748,749],{},"unplugin-vue-components"," : Un plugin Vite pour ",[20,752,753],{},"l'importation automatique de composants Vue",[224,755,735],{"id":756},"tailwind-css",[10,758,759],{},"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.",[10,761,762,763,39],{},"Commençons par installer ",[20,764,735],{},[285,766,768],{"className":287,"code":767,"filename":289,"language":290,"meta":291,"style":291},"pnpm add -D tailwindcss postcss autoprefixer\n",[75,769,770],{"__ignoreMap":291},[295,771,772,774,776,778,781,784],{"class":297,"line":298},[295,773,323],{"class":301},[295,775,334],{"class":305},[295,777,338],{"class":337},[295,779,780],{"class":305}," tailwindcss",[295,782,783],{"class":305}," postcss",[295,785,786],{"class":305}," autoprefixer\n",[10,788,789],{},"Créons le fichier de configuration pour Tailwind CSS :",[285,791,793],{"className":287,"code":792,"filename":289,"language":290,"meta":291,"style":291},"npx tailwindcss init -p\n",[75,794,795],{"__ignoreMap":291},[295,796,797,800,802,805],{"class":297,"line":298},[295,798,799],{"class":301},"npx",[295,801,780],{"class":305},[295,803,804],{"class":305}," init",[295,806,807],{"class":337}," -p\n",[10,809,810],{},"Nous configurerons Tailwind CSS au fur et à mesure de nos progrès.",[224,812,814],{"id":813},"importation-automatique-des-composants-vue","Importation automatique des composants Vue",[10,816,817,818,821],{},"Nous utiliserons unplugin-vue-components pour l'importation automatique des composants Vue, un ",[20,819,820],{},"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.",[10,823,824,825,39],{},"Tout d'abord, installons ",[20,826,749],{},[285,828,830],{"className":287,"code":829,"filename":289,"language":290,"meta":291,"style":291},"pnpm add -D unplugin-vue-components\n",[75,831,832],{"__ignoreMap":291},[295,833,834,836,838,840],{"class":297,"line":298},[295,835,323],{"class":301},[295,837,334],{"class":305},[295,839,338],{"class":337},[295,841,842],{"class":305}," unplugin-vue-components\n",[10,844,845,846,39],{},"Ensuite, intégrons-le dans le fichier ",[75,847,711],{},[285,849,853],{"className":850,"code":851,"filename":711,"language":852,"meta":291,"style":291},"language-typescript shiki shiki-themes github-light github-light github-dark","import Components from 'unplugin-vue-components\u002Fvite'\nimport { defineConfig } from 'vitepress'\n\nexport default defineConfig({\n  \u002F\u002F ...\n  vite: {\n    plugins: [Components()],\n  },\n})\n","typescript",[75,854,855,871,883,889,903,909,914,925,930],{"__ignoreMap":291},[295,856,857,861,865,868],{"class":297,"line":298},[295,858,860],{"class":859},"s8jYJ","import",[295,862,864],{"class":863},"sxrX7"," Components ",[295,866,867],{"class":859},"from",[295,869,870],{"class":305}," 'unplugin-vue-components\u002Fvite'\n",[295,872,873,875,878,880],{"class":297,"line":329},[295,874,860],{"class":859},[295,876,877],{"class":863}," { defineConfig } ",[295,879,867],{"class":859},[295,881,882],{"class":305}," 'vitepress'\n",[295,884,885],{"class":297,"line":400},[295,886,888],{"emptyLinePlaceholder":887},true,"\n",[295,890,891,894,897,900],{"class":297,"line":424},[295,892,893],{"class":859},"export",[295,895,896],{"class":859}," default",[295,898,899],{"class":301}," defineConfig",[295,901,902],{"class":863},"({\n",[295,904,905],{"class":297,"line":433},[295,906,908],{"class":907},"sCsY4","  \u002F\u002F ...\n",[295,910,911],{"class":297,"line":438},[295,912,913],{"class":863},"  vite: {\n",[295,915,916,919,922],{"class":297,"line":449},[295,917,918],{"class":863},"    plugins: [",[295,920,921],{"class":301},"Components",[295,923,924],{"class":863},"()],\n",[295,926,927],{"class":297,"line":463},[295,928,929],{"class":863},"  },\n",[295,931,932],{"class":297,"line":468},[295,933,934],{"class":863},"})\n",[10,936,937],{},"Nous configurerons unplugin-vue-components de manière plus complète plus tard.",[29,939,941],{"id":940},"prêts-pour-la-prochaine-étape","Prêts pour la prochaine étape",[10,943,944,945,947,948,950],{},"Avec notre projet VitePress maintenant doté de ",[20,946,735],{}," et de ",[20,949,749],{},", nous sommes prêts à commencer à développer notre blog.",[10,952,953,954,957],{},"Dans le prochain article, nous examinerons les ",[20,955,956],{},"fondamentaux de VitePress"," et créerons un thème personnalisé pour notre blog.",[959,960,961],"style",{},"html pre.shiki code .snPdu, html code.shiki .snPdu{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sIIMD, html code.shiki .sIIMD{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sBjJW, html code.shiki .sBjJW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .s8jYJ, html code.shiki .s8jYJ{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sxrX7, html code.shiki .sxrX7{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sCsY4, html code.shiki .sCsY4{--shiki-light:#6A737D;--shiki-default:#6A737D;--shiki-dark:#6A737D}",{"title":291,"searchDepth":329,"depth":329,"links":963},[964,967,968,969,973],{"id":31,"depth":329,"text":22,"children":965},[966],{"id":226,"depth":400,"text":227},{"id":248,"depth":329,"text":249},{"id":623,"depth":329,"text":624},{"id":719,"depth":329,"text":720,"children":970},[971,972],{"id":756,"depth":400,"text":735},{"id":813,"depth":400,"text":814},{"id":940,"depth":329,"text":941},"413e9430-e1c0-4ee2-89bb-af8fdadab2e0","2024-10-10","Configurez un projet VitePress avec Tailwind CSS et importez automatiquement des composants Vue pour un développement fluide.","md",{"branch":979},"01.project-initialization",null,{},"\u002Ffr\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch\u002Fgetting-started-with-vitepress-project-setup-and-essentials","---\ncontentId: 413e9430-e1c0-4ee2-89bb-af8fdadab2e0\npart: 1\ntitle: \"Commencer avec VitePress : configuration et essentiels\"\ndescription: Configurez un projet VitePress avec Tailwind CSS et importez automatiquement des composants Vue pour un développement fluide.\ngithub:\n  branch: 01.project-initialization\ndate: 2024-10-10\nseriesSlug: create-a-blog-with-vitepress-and-vue-js-from-scratch\n---\n\nAvant de commencer à créer notre blog, il est essentiel de comprendre ce qu'est [**VitePress**](https:\u002F\u002Fvitepress.dev\u002F) et ses origines. La familiarité avec les **outils** que nous utilisons pour la création de votre blog est cruciale.\n\n## VitePress\n\nSelon la [page d'accueil](https:\u002F\u002Fvitepress.dev\u002F) :\n\n> Générateur de Sites Statique alimenté par Vite & Vue, de Markdown à de Belles Documentations en Quelques Minutes\n\nBien 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.\n\nLa section [\"Qu'est-ce que VitePress ?\"](https:\u002F\u002Fvitepress.dev\u002Fguide\u002Fwhat-is-vitepress) explique :\n\n> 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.\n\nEssentiellement, 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.\n\nIl introduit trois fonctionnalités clés à l'application standard Vite et Vue :\n\n1. **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:\u002F\u002Fgithub.com\u002Fvuejs\u002Fvitepress\u002Fblob\u002Fmain\u002Fsrc\u002Fnode\u002Fmarkdown\u002Fmarkdown.ts) pour plus d'informations.\n2. **Chargement de Données** : VitePress permet le [**chargement de données**](https:\u002F\u002Fvitepress.dev\u002Fguide\u002Fdata-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**.\n3. **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:\u002F\u002Fgithub.com\u002Fvuejs\u002Fvitepress\u002Fblob\u002Fmain\u002Fsrc\u002Fclient\u002Fapp\u002Fssr.ts#L10).\n\nCes é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.\n\nÉ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:\u002F\u002Fvitepress.dev\u002F) et son [code source](https:\u002F\u002Fgithub.com\u002Fvuejs\u002Fvitepress\u002Ftree\u002Fmain\u002Fsrc\u002Fclient\u002Ftheme-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.\n\nComprendre 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.\n\n![Architecture de VitePress](\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch\u002Fgetting-started-with-vitepress-project-setup-and-essentials\u002Fvitepress-architecture.png)\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nTenter 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.\n::\n\n### Histoire\n\nDéveloppé par [Evan You](https:\u002F\u002Fx.com\u002Fyouyuxi) 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.\n\nVitePress est populaire pour créer des sites de documentation ou des blogs comme [The Vue Point](https:\u002F\u002Fblog.vuejs.org\u002F), 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.\n\n## Initialisation du projet\n\nArmés d'une meilleure compréhension de VitePress, nous pouvons initier un nouveau projet appelé \"**Garabit**.\" Vous pouvez accéder au **code source** sur \u003CGitHubLink repo=\"barbapapazes\u002Fgarabit\" \u002F>.\n\nBien 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:\u002F\u002Fgithub.com\u002Fvuejs\u002Fvitepress\u002Fpull\u002F4271) et [feat(cli): support du `srcDir` personnalisé](https:\u002F\u002Fgithub.com\u002Fvuejs\u002Fvitepress\u002Fpull\u002F4270).\n\nTout d'abord, créons un dossier pour notre projet :\n\n```bash [terminal]\nmkdir garabit\n```\n\nEnsuite, initialisons **npm** dans ce dossier et installons VitePress :\n\n```bash [terminal]\npnpm init\npnpm add -D vitepress\n```\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nTout au long de cette série, j'utiliserai [`pnpm`](https:\u002F\u002Fpnpm.io\u002F) comme gestionnaire de paquets, mais vous pouvez adapter les commandes à votre gestionnaire de paquets préféré.\n::\n\nEnfin, générons le projet VitePress :\n\n```bash [terminal]\npnpm vitepress init\n```\n\nRépondons aux invites (appuyons sur entrer pour les valeurs par défaut, que nous ajusterons plus tard) :\n\n```bash [terminal]\n┌  Welcome to VitePress!\n│\n◇  Where should VitePress initialize the config?\n│  .\u002F\n│\n◇  Site title:\n│  My Awesome Project\n│\n◇  Site description:\n│  A VitePress Site\n│\n◇  Theme:\n│  Default Theme\n│\n◇  Use TypeScript for config and theme files?\n│  Yes\n│\n◇  Add VitePress npm scripts to package.json?\n│  Yes\n│\n└  Done! Now run pnpm run docs:dev and start writing.\n```\n\n## Explorer le projet\n\nNous avons maintenant un projet VitePress tout neuf. Examinons la **structure du projet** :\n\n```bash [terminal]\n.\n├── .vitepress\n│   └── config.mts\n├── api-examples.md\n├── index.md\n├── markdown-examples.md\n├── package.json\n└── pnpm-lock.yaml\n```\n\nLe 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.\n\nÉ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.\n\n## Améliorer l'expérience développeur (DX)\n\nBien 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 :\n\n- [**Tailwind CSS**](https:\u002F\u002Ftailwindcss.com\u002F) : Un **framework CSS** axé sur les utilitaires pour créer efficacement des designs personnalisés.\n- [**unplugin-vue-components**](https:\u002F\u002Fgithub.com\u002Funplugin\u002Funplugin-vue-components) : Un plugin Vite pour **l'importation automatique de composants Vue**.\n\n### Tailwind CSS\n\nNous 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.\n\nCommençons par installer **Tailwind CSS** :\n\n```bash [terminal]\npnpm add -D tailwindcss postcss autoprefixer\n```\n\nCréons le fichier de configuration pour Tailwind CSS :\n\n```bash [terminal]\nnpx tailwindcss init -p\n```\n\nNous configurerons Tailwind CSS au fur et à mesure de nos progrès.\n\n### Importation automatique des composants Vue\n\nNous 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.\n\nTout d'abord, installons **unplugin-vue-components** :\n\n```bash [terminal]\npnpm add -D unplugin-vue-components\n```\n\nEnsuite, intégrons-le dans le fichier `config.mts` :\n\n```typescript [config.mts]\nimport Components from 'unplugin-vue-components\u002Fvite'\nimport { defineConfig } from 'vitepress'\n\nexport default defineConfig({\n  \u002F\u002F ...\n  vite: {\n    plugins: [Components()],\n  },\n})\n```\n\nNous configurerons unplugin-vue-components de manière plus complète plus tard.\n\n## Prêts pour la prochaine étape\n\nAvec notre projet VitePress maintenant doté de **Tailwind CSS** et de **unplugin-vue-components**, nous sommes prêts à commencer à développer notre blog.\n\nDans le prochain article, nous examinerons les **fondamentaux de VitePress** et créerons un thème personnalisé pour notre blog.\n",{"title":5,"description":976},"create-a-blog-with-vitepress-and-vue-js-from-scratch",{"loc":982,"images":987},[988],{"loc":211},"fr\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch\u002Fgetting-started-with-vitepress-project-setup-and-essentials","bBGX3DLXQLJYdflMiRPAAe3qzj97rHrMCogI0vsECD0",{"overview":992,"chapters":1219},{"id":993,"title":994,"body":995,"contentId":1202,"date":975,"description":1203,"extension":977,"github":1204,"meetTheInstructor":1206,"meta":1207,"navigation":887,"part":980,"path":1208,"rawbody":1209,"robots":980,"schemaOrg":980,"seo":1210,"seriesSlug":985,"sitemap":1211,"stem":1214,"subtitle":1215,"topics":1216,"__hash__":1218},"series\u002Ffr\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch.md","Créer un Blog Complet avec VitePress et Vue.js de Zéro",{"type":7,"value":996,"toc":1199},[997,1000,1013,1026,1157,1168,1176,1183,1186,1189,1193],[10,998,999],{},"Bonjour et bienvenue ! 👋",[10,1001,1002,1003,1006,1007,69,1009,1012],{},"Vous vous apprêtez à vous lancer dans la série \"Créer un ",[20,1004,1005],{},"Blog"," avec ",[20,1008,22],{},[20,1010,1011],{},"Vue.js"," de Zéro\" !",[10,1014,1015,1016,1021,1022,1025],{},"Tout au long de ce parcours, nous allons construire un blog pratique de A à Z en utilisant ",[14,1017,1019],{"href":16,"rel":1018},[18],[20,1020,22],{},". Nous explorerons de nombreux sujets allant de la configuration initiale au déploiement sur ",[20,1023,1024],{},"Cloudflare Pages"," en passant par:",[725,1027,1028,1048,1058,1064,1076,1082,1092,1102,1112,1125,1142,1148],{},[86,1029,1030,1032,1033,1036,1037,69,1042,1047],{},[20,1031,5],{}," : Apprenez à configurer un nouveau ",[20,1034,1035],{},"projet VitePress"," en intégrant ",[14,1038,1040],{"href":731,"rel":1039},[18],[20,1041,735],{},[14,1043,1045],{"href":745,"rel":1044},[18],[20,1046,749],{}," pour un processus de développement amélioré.",[86,1049,1050,1053,1054],{},[20,1051,1052],{},"Du thème par défaut au thème personnalisé avec VitePress"," : Nous allons entièrement supprimer le thème par défaut et créer un thème personnalisé. ",[1055,1056,1057],"em",{},"Vous serez surpris par sa simplicité !",[86,1059,1060,1063],{},[20,1061,1062],{},"Optimisez l'architecture de votre blog VitePress avec Vite"," : Découvrez comment organiser le code et concevoir votre blog pour une évolutivité et une maintenabilité optimales.",[86,1065,1066,1069,1070,148],{},[20,1067,1068],{},"Implémenter l'index du blog avec VitePress et Tailwind CSS"," : Créez une liste d'articles de blog. Cela introduira ",[14,1071,1073],{"href":131,"rel":1072},[18],[20,1074,1075],{},"les chargeurs de données de VitePress",[86,1077,1078,1081],{},[20,1079,1080],{},"Rendu d'un article dans VitePress avec Tailwind Typography"," : Créez une page dédiée à la lecture de chaque publication de blog.",[86,1083,1084,1087,1088,1091],{},[20,1085,1086],{},"Visibilité du site : métadonnées SEO et plan du site"," : Intégrez des ",[20,1089,1090],{},"métadonnées SEO"," pour améliorer la visibilité dans les moteurs de recherche, éliminant ainsi le besoin de mises à jour manuelles.",[86,1093,1094,1097,1098,1101],{},[20,1095,1096],{},"Présentez vos projets GitHub sur votre blog VitePress"," : Développez une page pour afficher vos projets ",[20,1099,1100],{},"GitHub",", étendant l'utilisation des chargeurs de données et démontrant leur flexibilité.",[86,1103,1104,1107,1108,1111],{},[20,1105,1106],{},"Création automatique d'images Open Graph pour le blog"," : Créez efficacement des ",[20,1109,1110],{},"images Open Graph"," pour chaque publication, vous faisant gagner du temps et améliorant l'attrait.",[86,1113,1114,1117,1118,1124],{},[20,1115,1116],{},"Déployer un blog VitePress simplement avec Cloudflare Pages"," : Déployez facilement votre blog sur ",[14,1119,1122],{"href":1120,"rel":1121},"https:\u002F\u002Fpages.cloudflare.com\u002F",[18],[20,1123,1024],{},", accomplissant cela en quelques clics !",[86,1126,1127,1130,1131,1006,1134,1141],{},[20,1128,1129],{},"Assurer la qualité du blog avec des tests Playwright"," : implémentez des ",[20,1132,1133],{},"tests de bout en bout",[14,1135,1138],{"href":1136,"rel":1137},"https:\u002F\u002Fplaywright.dev\u002F",[18],[20,1139,1140],{},"Playwright"," pour garantir que votre blog fonctionne comme prévu.",[86,1143,1144,1147],{},[20,1145,1146],{},"Un refactoring interne pour la croissance future de notre blog"," : Préparez votre blog à une croissance future en restructurant le code, garantissant ainsi sa maintenabilité et son évolutivité.",[86,1149,1150,1153,1154,1156],{},[20,1151,1152],{},"Migrer notre blog VitePress vers la version 4 de Tailwind CSS"," : Mettez à niveau notre blog vers la dernière version de ",[20,1155,735],{}," pour tirer parti de ses nouvelles fonctionnalités et améliorations.",[10,1158,1159,1160,1163,1164,1167],{},"À la fin, vous disposerez d'un ",[20,1161,1162],{},"blog"," pleinement opérationnel et captivant, vous permettant de vous concentrer exclusivement sur la production de ",[20,1165,1166],{},"contenu",", ce qui est essentiel. Écrivez et publiez simplement, car le blog gérera le reste de manière autonome.",[205,1169,1170,1174],{},[208,1171],{"alt":1172,"src":1173},"Première page de notre blog","\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch\u002Fdeploy-vitepress-blog-globally-with-cloudflare-pages\u002Fvitepress-home.png",[213,1175,1172],{},[10,1177,1178,1179,1182],{},"Cette série offre un ",[20,1180,1181],{},"guide"," détaillé étape par étape. Soyez assuré que chaque aspect sera soigneusement expliqué, depuis le choix jusqu'à la mise en œuvre de chaque fonctionnalité. Alors que chaque fonctionnalité sera minimale et axée sur l'essentiel, cela ne signifie pas que nous allons renoncer à créer un blog attrayant et fonctionnel.",[10,1184,1185],{},"Si vous avez des questions, n'hésitez pas à les poser dans la section des commentaires sous chaque article.",[10,1187,1188],{},"Nous espérons que vous trouverez cette série intéressante ! 🚀",[29,1190,1192],{"id":1191},"chapitres","Chapitres",[1194,1195],"series-chapters-list",{"className":1196},[1197,1198],"mx-auto","max-w-5xl",{"title":291,"searchDepth":329,"depth":329,"links":1200},[1201],{"id":1191,"depth":329,"text":1192},"f2681a44-f9bf-4ff7-840a-37f7729eea41","Construisez un blog dynamique avec VitePress et Vue.js de zéro. Apprenez à configurer, optimiser le SEO et déployer pour une expérience de blogging fluide.",{"name":1205,"repository":263},"garabit","J'ai créé cette série car \u003Cstrong>VitePress\u003C\u002Fstrong> est bien plus puissant qu'il n'y paraît à première vue. J'ai été impressionné par la \u003Cstrong>flexibilité\u003C\u002Fstrong> et la \u003Cstrong>simplicité\u003C\u002Fstrong> de l'outil lors de la création de mon blog et je voulais que la communauté le sache.",{},"\u002Ffr\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch","---\ncontentId: f2681a44-f9bf-4ff7-840a-37f7729eea41\ntitle: Créer un Blog Complet avec VitePress et Vue.js de Zéro\nsubtitle: Une nouvelle perspective sur le blogging avec VitePress et Vue.js\ndescription: Construisez un blog dynamique avec VitePress et Vue.js de zéro. Apprenez à configurer, optimiser le SEO et déployer pour une expérience de blogging fluide.\ndate: 2024-10-10\ntopics:\n  - vuejs\n  - vitepress\n  - blog\ngithub:\n  name: garabit\n  repository: barbapapazes\u002Fgarabit\nmeetTheInstructor: J'ai créé cette série car \u003Cstrong>VitePress\u003C\u002Fstrong> est bien plus puissant qu'il n'y paraît à première vue. J'ai été impressionné par la \u003Cstrong>flexibilité\u003C\u002Fstrong> et la \u003Cstrong>simplicité\u003C\u002Fstrong> de l'outil lors de la création de mon blog et je voulais que la communauté le sache.\nseriesSlug: create-a-blog-with-vitepress-and-vue-js-from-scratch\n---\n\nBonjour et bienvenue ! 👋\n\nVous vous apprêtez à vous lancer dans la série \"Créer un **Blog** avec **VitePress** et **Vue.js** de Zéro\" !\n\nTout au long de ce parcours, nous allons construire un blog pratique de A à Z en utilisant [**VitePress**](https:\u002F\u002Fvitepress.dev\u002F). Nous explorerons de nombreux sujets allant de la configuration initiale au déploiement sur **Cloudflare Pages** en passant par:\n\n- **Commencer avec VitePress : configuration et essentiels** : Apprenez à configurer un nouveau **projet VitePress** en intégrant [**Tailwind CSS**](https:\u002F\u002Ftailwindcss.com\u002F) et [**unplugin-vue-components**](https:\u002F\u002Fgithub.com\u002Funplugin\u002Funplugin-vue-components) pour un processus de développement amélioré.\n- **Du thème par défaut au thème personnalisé avec VitePress** : Nous allons entièrement supprimer le thème par défaut et créer un thème personnalisé. _Vous serez surpris par sa simplicité !_\n- **Optimisez l'architecture de votre blog VitePress avec Vite** : Découvrez comment organiser le code et concevoir votre blog pour une évolutivité et une maintenabilité optimales.\n- **Implémenter l'index du blog avec VitePress et Tailwind CSS** : Créez une liste d'articles de blog. Cela introduira [**les chargeurs de données de VitePress**](https:\u002F\u002Fvitepress.dev\u002Fguide\u002Fdata-loading).\n- **Rendu d'un article dans VitePress avec Tailwind Typography** : Créez une page dédiée à la lecture de chaque publication de blog.\n- **Visibilité du site : métadonnées SEO et plan du site** : Intégrez des **métadonnées SEO** pour améliorer la visibilité dans les moteurs de recherche, éliminant ainsi le besoin de mises à jour manuelles.\n- **Présentez vos projets GitHub sur votre blog VitePress** : Développez une page pour afficher vos projets **GitHub**, étendant l'utilisation des chargeurs de données et démontrant leur flexibilité.\n- **Création automatique d'images Open Graph pour le blog** : Créez efficacement des **images Open Graph** pour chaque publication, vous faisant gagner du temps et améliorant l'attrait.\n- **Déployer un blog VitePress simplement avec Cloudflare Pages** : Déployez facilement votre blog sur [**Cloudflare Pages**](https:\u002F\u002Fpages.cloudflare.com\u002F), accomplissant cela en quelques clics !\n- **Assurer la qualité du blog avec des tests Playwright** : implémentez des **tests de bout en bout** avec [**Playwright**](https:\u002F\u002Fplaywright.dev\u002F) pour garantir que votre blog fonctionne comme prévu.\n- **Un refactoring interne pour la croissance future de notre blog** : Préparez votre blog à une croissance future en restructurant le code, garantissant ainsi sa maintenabilité et son évolutivité.\n- **Migrer notre blog VitePress vers la version 4 de Tailwind CSS** : Mettez à niveau notre blog vers la dernière version de **Tailwind CSS** pour tirer parti de ses nouvelles fonctionnalités et améliorations.\n\nÀ la fin, vous disposerez d'un **blog** pleinement opérationnel et captivant, vous permettant de vous concentrer exclusivement sur la production de **contenu**, ce qui est essentiel. Écrivez et publiez simplement, car le blog gérera le reste de manière autonome.\n\n![Première page de notre blog](\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch\u002Fdeploy-vitepress-blog-globally-with-cloudflare-pages\u002Fvitepress-home.png)\n\nCette série offre un **guide** détaillé étape par étape. Soyez assuré que chaque aspect sera soigneusement expliqué, depuis le choix jusqu'à la mise en œuvre de chaque fonctionnalité. Alors que chaque fonctionnalité sera minimale et axée sur l'essentiel, cela ne signifie pas que nous allons renoncer à créer un blog attrayant et fonctionnel.\n\nSi vous avez des questions, n'hésitez pas à les poser dans la section des commentaires sous chaque article.\n\nNous espérons que vous trouverez cette série intéressante ! 🚀\n\n## Chapitres\n\n::series-chapters-list\n---\nclass: mx-auto max-w-5xl\n---\n::\n",{"title":994,"description":1203},{"loc":1208,"images":1212},[1213],{"loc":1173},"fr\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch","Une nouvelle perspective sur le blogging avec VitePress et Vue.js",[1217,31,1162],"vuejs","4cdOECPAusvYjhQgNBrWBH-zLS3bG-O1uFPB7VQRuU8",[1220,1222,1228,1234,1240,1246,1252,1258,1264,1270,1276,1283],{"contentId":974,"title":5,"description":976,"path":982,"part":298,"github":1221,"topics":980},{"branch":979},{"contentId":1223,"title":1052,"description":1224,"path":1225,"part":329,"github":1226,"topics":980},"bf3d2bc7-3224-4ccb-b98d-d46311a814b6","Créez un thème VitePress personnalisé avec des instructions étape par étape pour construire et personnaliser le design de votre site de blog.","\u002Ffr\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch\u002Ffrom-default-to-custom-building-a-vitepress-blog-theme",{"branch":1227},"02.the-basics-for-a-custom-theme",{"contentId":1229,"title":1062,"description":1230,"path":1231,"part":400,"github":1232,"topics":980},"d3784592-80d7-4601-b76b-6abb0edeb33a","Découvrez comment optimiser l'architecture de votre blog VitePress avec des solutions évolutives et une intégration efficace des plugins Vite.","\u002Ffr\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch\u002Foptimize-your-vitepress-blog-architecture-design",{"branch":1233},"03.define-the-design-of-the-blog-architecture",{"contentId":1235,"title":1068,"description":1236,"path":1237,"part":424,"github":1238,"topics":980},"5df41672-9e7d-4419-a7e2-b31df50385b5","Apprenez à créer une liste d'articles de blog en utilisant VitePress, une fonctionnalité cruciale pour tout site web centré sur le contenu.","\u002Ffr\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch\u002Fimplementing-blog-index-with-vitepress-and-tailwind-css",{"branch":1239},"04.comprehensive-guide-to-listing-blog-articles",{"contentId":1241,"title":1080,"description":1242,"path":1243,"part":433,"github":1244,"topics":980},"2dd963f7-e752-46ad-9214-9ecd5664f95f","Améliorez votre blog VitePress avec Tailwind Typography. Apprenez à rendre le markdown avec une coloration syntaxique et une typographie élégante.","\u002Ffr\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch\u002Fsingle-blog-rendering-in-vitepress-with-tailwind-typography",{"branch":1245},"05.read-a-single-blog-article",{"contentId":1247,"title":1086,"description":1248,"path":1249,"part":438,"github":1250,"topics":980},"1879487f-9325-4f02-8b70-7c2fc95e5cce","Automatisations de la génération des métadonnées pour une amélioration du référencement et de la visibilité du site web.","\u002Ffr\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch\u002Fenhance-website-visibility-seo-metadata-and-sitemap",{"branch":1251},"06.seo-metadata-and-sitemap",{"contentId":1253,"title":1096,"description":1254,"path":1255,"part":449,"github":1256,"topics":980},"a5ea4ae5-9f86-4f5e-a5ac-ed8baa434fba","Améliorez votre blog VitePress avec vos projets GitHub. Apprenez à récupérer les données de l'API de GitHub et à afficher vos projets sur votre blog.","\u002Ffr\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch\u002Fshowcase-your-github-projects-on-your-vitepress-blog",{"branch":1257},"07.showcase-your-github-projects",{"contentId":1259,"title":1106,"description":1260,"path":1261,"part":463,"github":1262,"topics":980},"5fb09b72-e0b1-4134-bced-238ef6e20f0d","Découvrons comment générer dynamiquement des images Open Graph pour le blog, afin d'améliorer l'attrait visuel lors du partage sur les réseaux sociaux.","\u002Ffr\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch\u002Fcreating-open-graph-images-automatically-for-each-blog-post",{"branch":1263},"08.automatically-generated-open-graph-images",{"contentId":1265,"title":1116,"description":1266,"path":1267,"part":468,"github":1268,"topics":980},"4944fbc5-ca12-4a03-a7ac-f1f96bc01344","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é.","\u002Ffr\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch\u002Fdeploy-vitepress-blog-globally-with-cloudflare-pages",{"branch":1269},"09.share-the-blog-globally",{"contentId":1271,"title":1129,"description":1272,"path":1273,"part":478,"github":1274,"topics":980},"17af0246-4d45-45f9-ad9a-57d10c9e883d","Améliorez le développement web avec des tests automatisés induits par Playwright. Élevez la qualité du blog grâce à des tests complets de bout en bout et SEO.","\u002Ffr\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch\u002Fensure-blog-quality-with-playwright-automated-testing",{"branch":1275},"10.automate-testing",{"contentId":1277,"title":1278,"description":1279,"path":1280,"part":491,"github":1281,"topics":980},"2a7c1ecf-74d7-408e-b8c3-263002433335","Un refactor interne pour la croissance future de notre blog","Préparez votre blog pour une croissance future en refactorisant la base de code pour garantir qu'elle reste maintenable et scalable.","\u002Ffr\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch\u002Fan-internal-refactor-for-the-future-growth-of-our-blog",{"branch":1282},"11.internal-refactor",{"contentId":1284,"title":1285,"description":1286,"path":1287,"part":496,"github":1288,"topics":980},"005bb627-29a3-4d3d-a6b6-9284afbbefa7","Migration du blog VitePress vers Tailwind CSS Version 4","Un guide étape par étape pour mettre à jour notre blog VitePress vers Tailwind CSS 4.0 afin de profiter de ses dernières fonctionnalités et améliorations.","\u002Ffr\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch\u002Fmigrating-our-vitepress-blog-to-tailwind-css-version-4",{"branch":1289},"12.migration-to-tailwind-css-4",1795016705072]