npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@gouvfr-anct/cartographie-nationale

v5.22.0

Published

💻 Client pour l'affichage de la cartographie nationale de l’offre de médiation numérique dans un navigateur web.

Downloads

208

Readme

Client pour la cartographie nationale de l’offre de médiation numérique

Ă€ propos

Ce client permet l'affichage de la cartographie nationale de l’offre de médiation numérique dans un navigateur web, il est construit à partir des éléments présents dans la bibliothèque pour la cartographie de l’offre de médiation numérique.

Table des matières

Prérequis

  • Git : Système de contrĂ´le de versions distribuĂ© d'un ensemble de fichiers
  • Node : Environnement d'exĂ©cution pour Javascript
  • Yarn : Gestionnaire de paquets pour les produits dĂ©veloppĂ©s dans des environnements Node

Node et Yarn peuvent être installés via nvm qui permet d'obtenir et d'utiliser rapidement différentes versions de Node via la ligne de commande.

Installation

Mise en place des sources

Ce projet a été construit dans un espace de travail Angular, pour fonctionner correctement, il est nécessaire de le cloner dans l'environnement prévu à cet effet :

  • Suivre la procĂ©dure d'installation du projet Client Base
  • Puis cloner le dĂ©pĂ´t en local dans le dossier projects : git clone [email protected]:anct-cartographie-nationale/client-application.git

Installer Husky

Husky est un outil de gestion des hooks git pour effectuer des tâches automatiques

Mise en place de Husky dans le dossier du projet projects/client-application :

npx husky install

Rendre exécutable les fichiers qui contiennent les hooks :

chmod a+x .husky/commit-msg
chmod a+x .husky/pre-commit

Utilisation

Ces commandes servent dans un contexte de développement de l'application et doivent être exécutées depuis la racine de l'espace de travail, c'est-à-dire depuis le dossier parent du dossier projects.

Lancement

Exécuter yarn start, puis naviguer vers http://localhost:4200/.

Construction

Exécuter yarn build client-application pour construire le projet. Les fichiers de sortie sont écrits dans le dossier dist/.

Test

Exécuter yarn test client-application pour tester le projet.

ESLint

Exécuter yarn lint client-application pour une analyse statique des fichiers .ts du projet.

StyleLint

Exécuter yarn stylelint "projects/client-application/**/*.scss" pour une analyse statique des fichiers .scss du projet.

Commit lint

Exécuter yarn commitlint --from HEAD~1 pour valider la syntaxe du dernier commit.

Prettier

Exécuter yarn prettier pour mettre à niveau la syntaxe de l'ensemble des fichiers du projet.

Ajouter des icĂ´nes au projet

  • Aller sur Remixicon
  • Cliquer sur le dossier Ă  droite de la barre de recherche, puis importer la collection du projet en cliquant sur la flèche vers le bas dans la modale.
  • Rechercher et sĂ©lectionner les icĂ´nes Ă  ajouter
  • Une fois les ajouts terminĂ©s
    • Cliquer sur le dossier Ă  droite de la barre de recherche pour tĂ©lĂ©charger le nouveau fichier de collection en cliquant sur la flèche vers le haut, le renommer collection.remixicon, puis remplacer l'ancienne version dans le dossier des fonts
    • Sans quitter la modale qui affiche la collection, tĂ©lĂ©charger les fonts en cliquant sur le bouton correspondant en bas Ă  droite, puis extraire les fichiers de l'archive pour les copier dans le dossier des fonts exceptĂ© les fichiers remixicon.css et remixicon.less
    • Ajouter les nouveaux codepoint Ă  la fin du fichier icons.scss disponibles dans le fichier remixicon.css
    • Relancer le serveur pour appliquer les changements

Contribution

Nommage des branches

  • Avant de crĂ©er une nouvelle branche de travail, rĂ©cupĂ©rer les dernières modifications disponibles sur la branche main
  • La nouvelle branche de travail doit ĂŞte prĂ©fixĂ©e par build/, chore/, ci/, docs/, feat/, fix/, perf/, refactor/, revert/, style/ ou test/ en fonction du type de modification prĂ©vu, pour plus de dĂ©tails Ă  ce sujet, consulter Conventional Commits cheat sheet
  • La branche portant la version Ă  publier est publish aucun commit ne doit ĂŞtre fait sur cette branche.

Commits

Convention

Les commits de ce repository doivent respecter la syntaxe décrite par la spécification des Commits Conventionnels

Signature

La branche main, ainsi que l'ensemble des branches de travail avec un préfixe valide requièrent que les commits soient signés :

Publier sur la branche principale

  • La branche principale est main, il n'est pas possible de publier en faisant un push depuis un dĂ©pĂ´t local
  • Il faut forcĂ©ment crĂ©er une nouvelle branche de travail avec l'un prĂ©fixe autorisĂ©
  • Ă€ chaque publication sur une branche de travail, le workflow Validate feature sur github actions vĂ©rifie
    • Qu'il est possible de crĂ©er un build sans erreur
    • Que la syntaxe correspond bien Ă  ce qui est dĂ©fini par Prettier
    • Que le code Ă©crit en TypeScript respecte les conventions dĂ©crites par les règles ESLint
    • Que le style Ă©crit en SCSS respecte les conventions dĂ©crites par les règles Standard
    • Que les messages des commits suivent le standard Ă©tabli par Conventional Commits
  • Une fois les dĂ©veloppements terminĂ©s, il faut crĂ©er une pull request avec la banche de travail comme origin et la branche main comme destination.
  • La pull request ne peut ĂŞtre fusionnĂ© que si :
    • Les Ă©tapes du workflow Validate feature sont valides
    • Les fichiers modifiĂ©s ont Ă©tĂ© revus par au moins une personne
    • Les commits ajoutĂ©s sont signĂ©s
  • La branche de travail est supprimĂ©e automatiquement une fois qu'elle a Ă©tĂ© fusionnĂ©e

DĂ©ployer

Sur l'environnement de production

Lorsqu'une branche est fusionnée avec main, cela déclenche automatiquement la publication du build sur l'espace dédié à la production ainsi que l'invalidation du cache sur le CDN.

Sur le registre npm

Pour publier une nouvelle version sur le registre npm, il faut que le numéro de version cible soit mis à jour dans le fichier package.json, que le commit de la version à publier porte un tag de la forme vX.Y.Z correspondant au numéro de version présent dans package.json, et que le changlog soit publier dans une release associé au tag de la version avant de procéder à la publication sur le registre @gouvfr-anct/cartographie-nationale.

Ce processus est automatisé par l'utilitaire semantic-release exécuté par le workflow release-and-publish, pour le déclencher avec la bonne version à publier, il faut :

  • RĂ©cupĂ©rer la version Ă  publier depuis la branche main
  • RĂ©cupĂ©rer ou crĂ©er la branche publish
  • Faire un merge de main dans publish : ceci permet de mettre Ă  jour la branche publish tout en concervant les tags qui ont Ă©tĂ© produits sur la branche publish lors du processus de publication.
  • Pousser la branche publish git push origin publish conduit Ă  l'exĂ©cution du workflow release-and-publish et donc Ă  la publication d'une nouvelle version via l'utilitaire semantic-release

Construit avec

langages & Frameworks

  • TypeScript est un langage open source construit Ă  partir de JavaScript
  • Angular est une boĂ®te Ă  outils open source pour construire des clients web
  • Remixicon est un ensemble de symboles open-source Ă©laborĂ©s pour les designers et les dĂ©veloppeurs.

Outils

CLI

  • Jest est une boĂ®te Ă  outils pour Ă©crire des tests automatisĂ©s en JavaScript
  • Eslint est un analyseur statique de JavaScript
  • Stylelint est un analyseur statique de fichiers de style (css, scss, etc.)
  • Prettier est un magnificateur de code source en JavaScript

CI

  • Github Actions est l'outil d'intĂ©gration et de dĂ©ploiement continu intĂ©grĂ© Ă  GitHub
  • Secrets du dĂ©pĂ´t :
    • AWS_ACCESS_KEY_ID : ClĂ© d'accès AWS du compte cartographie-nationale.client.ci
    • AWS_SECRET_ACCESS_KEY : Secret associĂ© Ă  la clĂ© d'accès Ă  AWS du compte cartographie-nationale.client.ci
    • AWS_S3_BUCKET : Identifiant de l'espace sur AWS S3 dans lequel est publiĂ© le build du projet pour un accès public
    • AWS_CLOUDFRONT_DISTRIBUTION_ID : Identifiant de la distribution CloudFront qui est le CDN par lequel le site est exposĂ© sur internet
    • NODE_AUTH_TOKEN : ClĂ© d'accès NPM pour publier sur l'organisation @gouvfr-anct
    • TF_API_TOKEN : ClĂ© d'accès Terraform (Team API Token) pour publier les environments Ă©phĂ©mères gĂ©rĂ©s par Terraform

DĂ©ploiement

Sur l'environnement de production
  • L'infrastructure de dĂ©ploiement est dĂ©crite avec Terraform dans les dĂ©pĂ´ts :
  • AWS est la plateforme de services Cloud proposĂ©e par Amazon.
    • Compte de dĂ©ploiement : cartographie-nationale.client.ci
    • Groupe : publisher.client
    • Environnement cible : https://cartographie.societenumerique.gouv.fr
Sur le registre npm

Documentation

Table des matières

Intégration dans une page HTML

La Cartographie Nationale intègre dès le début de sa conception la possibilité d'être intégrée dans n'importe quelle page HTML en 4 étapes.

L'Ă©diteur en ligne de w3schools permet de tester cela facilement :

  1. Mise en place du chemin de référence
...
<head>
  <title>Page Title</title>
  <base href="/" />
</head>
...
  1. Lien vers le style css pour la mise en forme
...
<head>
  <title>Page Title</title>
  <base href="/" />
  <link href="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/styles.css" rel="stylesheet" />
</head>
...
  1. Liens vers les scripts js pour l'interactivité
...
<body>
  <h1>My First Heading</h1>
  <p>My first paragraph.</p>

  <script
    src="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/mediation-numerique.js"
    type="module"></script>
</body>
...
  1. Affichage avec les éléments <fr-mediation-numerique-conteneur> et <fr-mediation-numerique>
...
<body>
  <fr-mediation-numerique-conteneur>
    <fr-mediation-numerique></fr-mediation-numerique>
  </fr-mediation-numerique-conteneur>

  <script
    src="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/mediation-numerique.js"
    type="module"></script>
</body>
...

La version finale devrait ressembler Ă  celĂ  :

<!DOCTYPE html>
<html>
  <head>
    <title>Page Title</title>
    <base href="/" />
    <link href="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/styles.css" rel="stylesheet" />
  </head>
  <body>
    <fr-mediation-numerique-conteneur>
      <fr-mediation-numerique></fr-mediation-numerique>
    </fr-mediation-numerique-conteneur>

    <script
      src="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/mediation-numerique.js"
      type="module"></script>
  </body>
</html>

Cliquez sur Run > pour voir la cartographie s'afficher.

Personnalisation

Titre et logo

Exemple :

<fr-mediation-numerique-conteneur titre="Hub B" logo="https://getbootstrap.com/docs/5.2/assets/brand/bootstrap-logo.svg">
  <fr-mediation-numerique></fr-mediation-numerique>
</fr-mediation-numerique-conteneur>

Illustration svg orientation

Il est possible d'afficher l'illustration correspondante à sa région.

Les valeurs disponibles sont :

  • antille-guyane
  • auvergne-rhone-alpe
  • bourgogne-franche-conte
  • bretagne
  • centre-val-de-loire
  • corse
  • france-et-outremer
  • grand-ouest
  • hauts-de-france
  • ile-de-france
  • normandie
  • nouvelle-aquitaine
  • occitanie
  • paca
  • pays-de-la-loire
  • st-martin-guadeloupe-martinique

La valeur par défaut est france-et-outremer.

Exemple:

<fr-mediation-numerique-conteneur>
  <fr-mediation-numerique illustration="france-et-outremer"></fr-mediation-numerique>
</fr-mediation-numerique-conteneur>

Source de données

Pour utiliser une autre source il faut préciser une url qui fournit les données conformes au schéma de données des lieux de médiation numérique, nous publions régulièrement des données compatibles sur data.gouv, dans l'organisation Cartographie Nationale des lieux de médiation numérique. N'hésitez pas à nous contacter pour faire apparaître vos données dans cette liste.

Exemple avec les données du hub Hinaura :

<fr-mediation-numerique-conteneur>
  <fr-mediation-numerique
    source="https://www.data.gouv.fr/fr/datasets/r/55eea24c-be8c-47f9-9c4a-77399d346fbd"></fr-mediation-numerique>
</fr-mediation-numerique-conteneur>

Localisation initiale

Par défaut la carte est centrée sur le milieu de la France avec un niveau de zoom qui permet d'afficher le territoire métropolitain, il est possible de préciser la latitude et la longitude sur laquelle la carte doit être centrée ainsi que le niveau de zoom.

Exemple :

<fr-mediation-numerique-conteneur>
  <fr-mediation-numerique latitude="45.515833" longitude="4.538056" zoom="8"></fr-mediation-numerique>
</fr-mediation-numerique-conteneur>
  • Il est possible de rĂ©cupĂ©rer la latitude et la longitude sur openStreetMap en recherchant une localitĂ©
  • Le zoom doit ĂŞtre une valeur entière comprise entre 0 et 20
  • AussitĂ´t affichĂ©e, la carte part de cette position initiale pour encadrer les marqueurs affichĂ©s issue de la source de donnĂ©e

Couleur

Il est possible de changer certaines couleurs utilisées par la cartographie, pour cela il faut remplacer le style par une alternative comprenant les modifications des couleurs, notre outil disponible sur GitHub permet de faire cela :

  • CrĂ©er un compte GitHub si besoin
  • RĂ©cupĂ©rer les sources de la cartographie avec l'aide d'un Fork puis cliquer sur le bouton vert pour crĂ©er le Fork
  • Une fois l'opĂ©ration terminĂ©e, cliquer sur l'onglet Actions en haut de la page
  • Autoriser l'utilisation des Workflows, c'est cela qui va permettre de modifier le fichier de style
  • Cliquer sur Generate custom style dans la liste Ă  gauche
  • Cliquer sur le bouton Run workflow Ă  droite, vous devez entrer une valeur pour Primary Color avant de cliquer sur le bouton Run workflow vert, la valeur de la couleur doit avoir cette forme : #712cf9, sans oublier le #
  • Patienter quelques instants puis cliquer sur la tâche nommĂ©e Generate custom style dès qu'elle apparaĂ®t
  • Le fichier est gĂ©nĂ©rĂ© au bout de quelques minutes, lorsque c'est terminĂ©, un Artifact nommĂ© build apparaĂ®t dans la liste en bas, cliquer dessus pour le tĂ©lĂ©charger puis dĂ©compresser l'archive build.zip, qui contient uniquement le fichier style.css
  • IdĂ©alement il faudrait hĂ©berger correctement le fichier style.css avec le reste des fichiers du site, par exemple dans un dossier assets/, il faudrait alors remplacer le contenu de <link /> vers ce chemin :
    <head>
      <title>Page Title</title>
      <base href="/" />
      <link href="/assets/style.css" rel="stylesheet" />
    </head>
    Mais pour aller au bout de cet exemple, une autre méthode permet de renseigner directement le style dans la page html que nous sommes en train d'éditer, pour cela il faut ouvrir le fichier style.css avec le programme notepad sur Windows, copier l'intégralité du contenu et le coller dans l'emplacement <style></style>
    <head>
      <title>Page Title</title>
      <base href="/" />
      <style>
        Remplacer ce texte par le contenu du fichier style.css (@charset "UTF-8" etc.)
      </style>
    </head>

Exemple complet de personnalisation

<!DOCTYPE html>
<html>
  <head>
    <title>Page Title</title>
    <base href="/" />
    <style>
      @charset "UTF-8";:root{...
    </style>
  </head>
  <body>
    <fr-mediation-numerique-conteneur
      titre="Médiation numérique à Bessenay"
      logo="https://getbootstrap.com/docs/5.2/assets/brand/bootstrap-logo.svg">
      <fr-mediation-numerique
        source="https://api.conseiller-numerique.gouv.fr/permanences"
        latitude="45.77647396140311"
        longitude="4.55431157343317"
        zoom="12"></fr-mediation-numerique>
    </fr-mediation-numerique-conteneur>

    <script
      src="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/mediation-numerique.js"
      type="module"></script>
  </body>
</html>

Utilisation partielle

Il est également possible de n'utiliser que certains sous-ensembles : en enlevant la barre de navigation et le pied de page, en utilisant seulement la cartographie ou seulement l'orientation. Cela peut demander un effort technique supplémentaire, mais permet une meilleure intégration dans un environnement déjà existant.

Enlever la barre de navigation et le pied de page

L'élément <fr-mediation-numerique-conteneur> gère l'affichage de la barre de navigation et du pied de page, mais également l'affichage en plein écran. En enlevant cet élément la barre de navigation et le pied de page disparaissent, mais il faut compenser le plein écran en ajoutant class="vh-100" sur l'élément <body> :

<!DOCTYPE html>
<html>
  <head>
    <title>Page Title</title>
    <base href="/" />
    <link href="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/styles.css" rel="stylesheet" />
  </head>
  <body class="vh-100">
    <fr-mediation-numerique
      titre="Médiation numérique à Bessenay"
      logo="https://getbootstrap.com/docs/5.2/assets/brand/bootstrap-logo.svg"></fr-mediation-numerique>

    <script
      src="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/mediation-numerique.js"
      type="module"></script>
  </body>
</html>

En l'absence de l'élément <fr-mediation-numerique-conteneur>, les configurations titre et logo peuvent être reportées sur l'élément <fr-mediation-numerique> (ces informations apparaissent dans le parcours d'orientation) :

<!DOCTYPE html>
<html>
  <head>
    <title>Page Title</title>
    <base href="/" />
    <link href="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/styles.css" rel="stylesheet" />
  </head>
  <body class="vh-100">
    <fr-mediation-numerique></fr-mediation-numerique>

    <script
      src="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/mediation-numerique.js"
      type="module"></script>
  </body>
</html>

Utiliser seulement la cartographie

Pour n'importer que les sources strictement nécessaires à ce mode, il faut remplacer le script mediation-numerique.js par cartographie.js :

<!DOCTYPE html>
<html>
  <head>
    <title>Page Title</title>
    <base href="/" />
    <link href="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/styles.css" rel="stylesheet" />
  </head>
  <body class="vh-100">
    <script
      src="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/cartographie.js"
      type="module"></script>
  </body>
</html>

Il est alors possible d'utiliser l'élément <fr-mediation-numerique-cartographie></fr-mediation-numerique-cartographie> :

<!DOCTYPE html>
<html>
  <head>
    <title>Page Title</title>
    <base href="/" />
    <link href="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/styles.css" rel="stylesheet" />
  </head>
  <body class="vh-100">
    <fr-mediation-numerique-cartographie></fr-mediation-numerique-cartographie>
    <script
      src="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/cartographie.js"
      type="module"></script>
  </body>
</html>

Les attributs de personnalisations suivants, présentés dans la section précédente sont disponibles : zoom, latitude, longitude, source :

<!DOCTYPE html>
<html>
  <head>
    <title>Page Title</title>
    <base href="/" />
    <link href="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/styles.css" rel="stylesheet" />
  </head>
  <body class="vh-100">
    <fr-mediation-numerique-cartographie
      source="https://api.conseiller-numerique.gouv.fr/permanences"
      latitude="45.77647396140311"
      longitude="4.55431157343317"
      zoom="12"></fr-mediation-numerique-cartographie>
    <script
      src="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/cartographie.js"
      type="module"></script>
  </body>
</html>

S'il existe une autre page dans laquelle un outil capable d'effectuer un parcours d'orientation est disponible, il est possible d'activer le bouton Modifier les critères d'orientation en fournissant un lien avec l'attribut lien-orientation :

<!DOCTYPE html>
<html>
  <head>
    <title>Page Title</title>
    <base href="/" />
    <link href="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/styles.css" rel="stylesheet" />
  </head>
  <body class="vh-100">
    <fr-mediation-numerique-cartographie
      source="https://api.conseiller-numerique.gouv.fr/permanences"
      latitude="45.77647396140311"
      longitude="4.55431157343317"
      zoom="12"
      lien-orientation="https://cartographie.societenumerique.gouv.fr/orientation"></fr-mediation-numerique-cartographie>
    <script
      src="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/cartographie.js"
      type="module"></script>
  </body>
</html>

Les paramètres sélectionnés lors du parcours d'orientation sont fournis sous forme de paramètre d'url, par exemple ?date_ouverture=2022-08-17&ouvert_actuellement=true.

Il n'est pas possible d'utiliser la barre de navigation dans ce mode

Utiliser seulement l'orientation

Pour n'importer que les sources strictement nécessaires à ce mode, il faut remplacer le script mediation-numerique.js par orientation.js :

<!DOCTYPE html>
<html>
  <head>
    <title>Page Title</title>
    <base href="/" />
    <link href="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/styles.css" rel="stylesheet" />
  </head>
  <body class="vh-100">
    <script src="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/orientation.js" type="module"></script>
  </body>
</html>

Il est alors possible d'utiliser l'élément <fr-mediation-numerique-orientation></fr-mediation-numerique-orientation> :

<!DOCTYPE html>
<html>
  <head>
    <title>Page Title</title>
    <base href="/" />
    <link href="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/styles.css" rel="stylesheet" />
  </head>
  <body class="vh-100">
    <fr-mediation-numerique-orientation></fr-mediation-numerique-orientation>
    <script src="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/orientation.js" type="module"></script>
  </body>
</html>

Les attributs de personnalisations suivants, présentés dans la section précédente sont disponibles : logo, titre, source, illustration :

<!DOCTYPE html>
<html>
  <head>
    <title>Page Title</title>
    <base href="/" />
    <link href="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/styles.css" rel="stylesheet" />
  </head>
  <body class="vh-100">
    <fr-mediation-numerique-orientation
      source="https://api.conseiller-numerique.gouv.fr/permanences"
      titre="Médiation numérique à Bessenay"
      logo="https://getbootstrap.com/docs/5.2/assets/brand/bootstrap-logo.svg"
      illustration="grand-ouest"></fr-mediation-numerique-orientation>
    <script src="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/orientation.js" type="module"></script>
  </body>
</html>

S'il existe une autre page dans laquelle un outil capable d'effectuer un parcours d'orientation est disponible, il est possible d'activer le bouton Afficher les résultats sur la cartographie en fournissant un lien avec l'attribut lien-cartographie :

<!DOCTYPE html>
<html>
  <head>
    <title>Page Title</title>
    <base href="/" />
    <link href="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/styles.css" rel="stylesheet" />
  </head>
  <body class="vh-100">
    <fr-mediation-numerique-orientation
      source="https://api.conseiller-numerique.gouv.fr/permanences"
      titre="Médiation numérique à Bessenay"
      logo="https://getbootstrap.com/docs/5.2/assets/brand/bootstrap-logo.svg"
      lien-cartographie="https://cartographie.societenumerique.gouv.fr/cartographie"></fr-mediation-numerique-orientation>
    <script src="https://cdn.jsdelivr.net/npm/@gouvfr-anct/[email protected]/orientation.js" type="module"></script>
  </body>
</html>

Les paramètres sélectionnés lors du parcours d'orientation sont fournis sous forme de paramètre d'url, par exemple ?date_ouverture=2022-08-17&ouvert_actuellement=true.

Il n'est pas possible d'utiliser la barre de navigation dans ce mode

Gestion des versions

Afin de maintenir un cycle de publication clair et de favoriser la rétrocompatibilité, la dénomination des versions suit la spécification décrite par la Gestion sémantique de version

Les versions disponibles ainsi que les journaux décrivant les changements apportés sont disponibles depuis la page des Releases.

Licence

Voir le fichier LICENSE.md du dépôt.