Aller au contenu principal

Un site Web en Markdown

Notions théoriques

Nous avons vu que VuePress offre plusieurs avantages :

  • Prix : Les hébergements de sites Web en statique sont peu chers et beaucoup sont même gratuits.
  • Facilité d'utilisation: Si vous êtes déjà familier le langage Markdown, l'adoption de VuePress est facile.
  • Performance : Les pages chargent rapidement car elles sont pré-générées.
  • Sécurité : Moins de vulnérabilités par rapport aux sites dynamiques car il n'y a pas de base de données.
Site statique vs site dynamique

Les sites statiques sont des sites web où tout le contenu est fixe sans utiliser une base de données.

Les fichiers HTML, qui sont stockés sur le serveur, seront envoyés tels quels au navigateur Web.

Cela rend le site Web extrêmement rapide, car le serveur envoie simplement les fichiers au navigateur, sans avoir besoin de traitement côté serveur pour générer dynamiquement les pages à chaque requête.

Exemple pratique

Pour commencer avec VuePress, il suffit de suivre ces étapes :

  1. Créez un nouveau dépôt sur GitHub.
  2. Clonez le dépôt sur votre machine locale avec git clone.
  3. Assurez-vous d'avoir Node.js installé, sinon veuillez l'installer
Comment installer Node.js ?

Pour installer Node.js sur votre ordinateur, il suffit de télécharger l'installateur de Node.js à partir du site Web officiel de Node.js (https://nodejs.org/).

Choisissez la version qui convient à votre système d'exploitation et suivez les instructions pour l'installer.

  • Vous pouvez vérifier que Node.js est bien installé avec la commande : npm --version.
  1. Créer le dépôt portfolio-vuepress sur GitHub.

  2. Dans le dossier de vos Documents, créez le dossier portfolio-vuepress.

  3. Ouvrez un Terminal dans le dossier portfolio-vuepress (vous pouvez taper cmd dans la Barre d'adresses de l'Explorateur de fichiers suivi par la touche Entrée).

  4. Dans le Terminal, exécuter la commande : npm init vuepress my-blog.

    A la question Ok to proceed? (y), tapez la touche Entrée pour choisir yes.

  5. A la question Would you like to preview template now?, tapez la touche Entrée pour choisir yes.

  6. Ouvrez votre navigateur à localhost:8080 pour voir votre site VuePress.

  7. Cliquez sur le bouton Introduction pour vous guider dans les premières étapes de création des pages.

  8. Ouvrez le dossier portfolio-vuepress avec Visual Studio Code.

  9. Faites des modifications dans votre fichier my-blog\docs\README.md et observez les changements en temps réel.

    Par exemple, remplacez "Quick Start" par "Ma formation" :

    ---
    home: true
    title: Home
    heroImage: https://vuejs.press/images/hero.png
    actions:
    - text: Ma formation
    link: /getting-started.html
    type: primary

astuce

Pour maitriser VuePress, n'hésitez pas à consulter sa documentation : https://vuepress.github.io/.

Versionning

Pensez à envoyer vos modifications vers GitHub : git add ., git commit -m "Installation VuePress" puis git push.

Test de mémorisation/compréhension


Quel est l'un des principaux avantages de l'hébergement de sites Web statiques en termes de coût ?


Pourquoi les sites statiques chargent-ils rapidement ?


Quelle est la différence principale entre un site statique et un site dynamique ?