{"_id":"@descartes/d-geoplateforme","name":"@descartes/d-geoplateforme","dist-tags":{"latest":"6.0.0-RC2"},"versions":{"6.0.0-RC2":{"name":"@descartes/d-geoplateforme","version":"6.0.0-RC2","description":"D-GeoPlateforme - Module Descartes utilisant les services de le GéoPlateforme de l'IGN'","main":"dist/d-geoplateforme.js","scripts":{"build":"node build/build.js","dev":"node build/dev.js --ui=bootstrap4","test":"mocha --colors -r jsdom-global/register.js -w test/*.test.js","test:html":"webpack-dev-server --config build/webpack.test.js --hot --inline","prepublishOnly":"npm run build -- --ui=bootstrap4","get-version":"echo $npm_package_version"},"repository":{"type":"git","url":"git+https://gitlab-forge.din.developpement-durable.gouv.fr/pub/geomatique/descartes/d-geoplateforme.git"},"author":{"name":"Ministère - MTE"},"contributors":[{"name":"Gaëlle Barris"}],"license":"SEE LICENSE IN LICENSE.txt","bugs":{"url":"https://gitlab-forge.din.developpement-durable.gouv.fr/pub/geomatique/descartes/d-geoplateforme/-/issues"},"homepage":"https://gitlab-forge.din.developpement-durable.gouv.fr/pub/geomatique/descartes/d-geoplateforme#readme","devDependencies":{"bootstrap":"4.1.3","clean-webpack-plugin":"0.1.16","ejs-loader":"0.3.0","eslint":"3.18.0","eslint-loader":"1.6.3","extract-text-webpack-plugin":"3.0.0","file-loader":"0.11.2","fs-extra":"4.0.2","jquery":"3.3.1","jquery-ui-dist":"1.12.1","lodash":"4.14.0","loglevel":"1.4.1","mocha":"3.4.2","mocha-loader":"1.1.1","multistream":"^4.0.1","ora":"1.1.0","popper.js":"1.14.4","qrcode":"^1.4.4","shelljs":"0.7.7","uglifyjs-webpack-plugin":"^1.3.0","webpack":"3.6.0","webpack-bundle-analyzer":"^2.9.1","webpack-dev-server":"2.8.2","yargs":"^15.4.1","yuidocjs":"0.10.2"},"dependencies":{"@descartes/d-map":"6.0.0","@descartes/d-editmap":"6.0.0","@descartes/d-inkmap":"6.0.0","geoportal-access-lib":"3.4.2","chart.js":"4.4.3"},"gitHead":"4f6348d775ec1e5e2217d569c7db5e8b3d26d0b4","_id":"@descartes/d-geoplateforme@6.0.0-RC2","_nodeVersion":"16.14.0","_npmVersion":"8.5.2","dist":{"integrity":"sha512-vXl0bip6kWnU9f/a+j3IbkGWHouaZLoVmzwRKc5+GMrNIiEy4wJPSXsBW84H0+EZO7tIg8dyO7abiF/dGK5nEg==","shasum":"2e9be77ff761bdaf1bb072005aaca6ada04fdcf3","tarball":"https://registry.npmjs.org/@descartes/d-geoplateforme/-/d-geoplateforme-6.0.0-RC2.tgz","fileCount":44,"unpackedSize":941217,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCx8gEnHus++3Qyw7uoczEvXF+C9YNVQ9VuTXgpF85rOwIgWPsgW3rzY8x2eu69t7AqWry0Q8RMHdQa5nILe110CIc="}]},"_npmUser":{"name":"gbarris","email":"gaelle.barris@developpement-durable.gouv.fr"},"directories":{},"maintainers":[{"name":"gbarris","email":"gaelle.barris@developpement-durable.gouv.fr"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/d-geoplateforme_6.0.0-RC2_1721209748703_0.1487536215912948"},"_hasShrinkwrap":false}},"time":{"created":"2024-07-17T09:49:08.604Z","6.0.0-RC2":"2024-07-17T09:49:08.924Z","modified":"2024-07-17T09:49:09.200Z"},"maintainers":[{"name":"gbarris","email":"gaelle.barris@developpement-durable.gouv.fr"}],"description":"D-GeoPlateforme - Module Descartes utilisant les services de le GéoPlateforme de l'IGN'","homepage":"https://gitlab-forge.din.developpement-durable.gouv.fr/pub/geomatique/descartes/d-geoplateforme#readme","repository":{"type":"git","url":"git+https://gitlab-forge.din.developpement-durable.gouv.fr/pub/geomatique/descartes/d-geoplateforme.git"},"contributors":[{"name":"Gaëlle Barris"}],"author":{"name":"Ministère - MTE"},"bugs":{"url":"https://gitlab-forge.din.developpement-durable.gouv.fr/pub/geomatique/descartes/d-geoplateforme/-/issues"},"license":"SEE LICENSE IN LICENSE.txt","readme":"# D-GeoPlateforme, composant Javascript\n\nLe composant Javascript D-geoplateforme est un module Descartes utilisant les sercvices de la Géoplateforme de l'IGN.\n\nCe composant est basé sur les librairies geoportal-access-lib (IGN) et chart.js\n \n## Exemples de démonstration\n\nhttps://pub.gitlab-pages.din.developpement-durable.gouv.fr/geomatique/descartes/d-geoplateforme\n \n## Paquet NPM\n\nLe composant Javascript D-GeoPlateforme est disponible sous forme de paquet NPM sous l'appellation `@descartes/d-geoplateforme`.\n\n### Utilisation dans une application tierce\n\n#### Utilisation via NPM\n\n##### Installation\n\nPour installer le composant JS D-GeoPlateforme dans un projet NPM :\n```bash\n$ npm install @descartes/d-geoplateforme\n```\n\nNote : le paquet est disponible sur différents dépôts, il faut donc faire pointer le scope `@descartes` sur le dépôt souhaité:\n- dépôt public gitlab-forge (pour les versions diffusées au sein du ministère MTE) :  \n  https://gitlab-forge.din.developpement-durable.gouv.fr/api/v4/projects/17127/packages/npm \n- dépôt privé (pour les versions en cours de développement) :  \n  https://gitlab-forge.din.developpement-durable.gouv.fr/api/v4/projects/XXXX/packages/npm \n- dépôts public NPM (pour les versions diffusées \"grand public\" à accès CDN)\n  https://registry.npmjs.org\n\nPour que NPM puisse se connecter aux dépôts, il faut renseigner le fichier `.npmrc` :\n```\n@descartes:registry=https://gitlab-forge.din.developpement-durable.gouv.fr/api/v4/projects/17127/packages/npm\n...\n```\n\n##### Inclusion du composant\n\nTout d'abord, le chargement de la librairie principale Descartes est nécessaire:\nle paquet `@descartes/d-map` doit être inclus dans l'application. \n\nPour utiliser le composant JS D-GeoPlateforme, il suffit d'inclure les fichiers suivants dans la page HTML de l'application (les chemins relatifs doivent être respectés) :\n* `vendor/d-geoplateforme-required.css`\n* `vendor/d-geoplateforme-required.js`\n* `css/d-geoplateforme.css`\n* `d-geoplateforme.js`\n\n#### Utilisation via CDN\n\nTout d'abord, le chargement de la librairie principale Descartes est nécessaire:\nles urls CDN de `@descartes/d-map` doit être incluses dans l'application. \n\nPour utiliser le composant JS D-GeoPlateforme, il suffit d'inclure ensuite les fichiers suivants dans la page HTML de l'application  :\n* `https://cdn.jsdelivr.net/npm/@descartes/d-geoplateforme@X.X.X/dist/vendor/d-geoplateforme-required.css`\n* `https://cdn.jsdelivr.net/npm/@descartes/d-geoplateforme@X.X.X/dist/vendor/d-geoplateforme-required.js`\n* `https://cdn.jsdelivr.net/npm/@descartes/d-geoplateforme@X.X.X/dist/css/d-geoplateforme.css`\n* `https://cdn.jsdelivr.net/npm/@descartes/d-geoplateforme@X.X.X/dist/d-geoplateforme.js`\n\nNote : l'utilisation via CDN n'est pas recommandé en production.\n\n\n\n### Utilisation du composant en cours de développement\n\n#### Pre-requis\n\nInstallation sur son poste:\n* NODE 16.14.0\n* NPM 8.5.2\n\n#### Utilisation de link\n\nIl est possible de travailler simultanément sur le composant d-geoplateforme et sur une application tierce, afin de vérifier\npar exemple le bon comportement d'une évolution de d-geoplateforme.\n\nPour cela, on commence par demander à npm de créer une référence locale globale du paquet, en se positionnant à la racine du projet d-geoplateforme :\n```\nnpm link\n```\n\nEnsuite, il faut indiquer à NPM que le paquet `@descartes/d-geoplateforme` doit être résolu localement, en se positionnant dans le projet tierce :\n```\n$ npm link @descartes/d-geoplateforme\n```\n\nUne fois les développements terminés, pour revenir à un état normal, en se positionnant dans le projet tierce :\n```\nnpm unlink --no-save @descartes/d-geoplateforme\nnpm install\n```\n\nFinalement, on peut demander à npm de nettoyer la référence locale globale, en se positionnant à la racine du projet d-geoplateforme :\n```\nnpm unlink\n```\n\n#### Compilation\n\nLa compilation du composant JS de D-GeoPlateforme se fait à l'aide de Webpack. Par ailleurs le composant possède les dépendances suivantes :\n* XXX\n\nPour compiler le composant :\n```bash\n$ npm run build\n```\n\nLors de la compilation, les fichiers suivants sont générés dans le répertoire `dist` à la racine de ce module :\n* `d-geoplateforme.js` et `d-geoplateforme.css` : contiennent le code source et les feuilles de style utilisées par D-GeoPlateforme\n  > ces fichiers sont générés par Webpack\n* le répertoire `vendor` contient les fichiers `d-geoplateforme-required.js` et `d-geoplateforme-required.css`; ces deux fichiers contiennent l'intégralité des dépendances requises par D-GeoPlateforme\n  > ces fichiers sont générés par le script `build/build.js`\n* tous les autre fichiers (images, polices, ...) sont des ressources requises pour le bon fonctionnement du composant\n\n#### Développement du composant\n\nPour lancer les exemples D-Geoplateforme :\n```bash\n$ npm run dev\n```\n\nSi besoin, pour spécifier un port : `npm run dev -- --port=XXXX`. \nLe port par défaut est `4203`.\n\nL'index des exemples est accessible sur http://localhost:4203. Les exemples se rafraichissent automatiquement en cas de changement dans les fichiers source.\n\n> Note : Le répertoire `dist` ainsi que les répertoires `/demo` et `/node_modules` sont rendus accessibles à la racine du serveur.\n\n#### Publication\n\nLa publication du paquet NPM se fait via GITLAB-CI à la création d'un TAG.\n","readmeFilename":"README.md"}