Ce guide d'installation se concentre sur l'utilisation de Carte Facile avec MapLibre GL JS, qui est la bibliothèque recommandée pour tirer pleinement parti des fonctionnalités de Carte facile.


Méthode 1 : Installation via npm (recommandé) #

Prérequis : avoir Node.js installé sur votre ordinateur (npm est inclus avec Node.js).

Cette méthode est recommandée pour les projets professionnels ou les applications complexes. Lancez cette commande dans le terminal de votre projet pour installer les librairies Carte Facile et MapLibre :

npm install carte-facile maplibre-gl

Puis passez à l'étape suivante.

Si vous n'utilisez pas de bundler (outil qui gère les imports entre fichiers JavaScript), utilisez plutôt la méthode d'installation via CDN.



Méthode 2 : Installation via CDN #

Cette méthode est adaptée pour les projets simples, les prototypes ou les tests rapides. Elle ne nécessite pas Node.js.

Pour utiliser cette méthode, ajoutez simplement ces lignes dans le <head> de votre page HTML :

  <!-- Importation des bibliothèques MapLibre GL JS -->
  <link href="https://unpkg.com/maplibre-gl@^5.2.0/dist/maplibre-gl.css" rel="stylesheet" />
  <script src="https://unpkg.com/maplibre-gl@^5.2.0/dist/maplibre-gl.js"></script>

  <!-- Importation des bibliothèques Carte Facile -->
  <link href="https://unpkg.com/carte-facile@^0.5.18/dist/carte-facile.css" rel="stylesheet" />
  <script src="https://unpkg.com/carte-facile@^0.5.18/dist/carte-facile.js"></script> 

Prochaine étape #

Ajouter une carte

Paramètres d'affichage

Choisissez un thème pour personnaliser l’apparence du site.