Skip to content

infra-geo-ouverte/igo2

Repository files navigation

Angular Style Guide join chat https://gitter.im/igo2/Lobby Known Vulnerabilities

Infrastructure géomatique ouverte 2.0 (IGO2) / Open GIS Infrastructure 2.0


Qu'est-ce qu'IGO?

IGO2 est une solution Web gratuite en géomatique basée sur Angular - Material, OpenLayers et IGO2lib. IGO2 permet de tirer profit d’une multitude de données géographiques grâce à une interface cartographique accessible par un navigateur Web sur un poste de travail et par un appareil mobile. IGO2 a été initié par l'administration publique du Québec (Canada) et issu d’un travail collaboratif basé sur la philosophie des logiciels libres et ouverts (« open source »). Les membres du public en géomatique et du Web qui soumettent des contributions conservent leurs droits d'auteur s'ils partagent leur code source selon la LICENCE LiLiQ-R de type LGPL.


What is IGO?

IGO2 (for Open GIS Infrastructure - version 2.0) is a free open source Web Geospatial solution developed at first in Quebec, Canada based on Angular - Material, OpenLayers and IGO2lib. IGO2 is having multiple features, such as Web GIS viewer adapted to Desktop and Mobile and many more available at https://igo2.readthedocs.io/fr/latest/english.html. Since this project is open source, anyone can contribute as long as they share their work on the same open source LICENCE LGPL-Style. All contributors in IGO keep their property rights.



Table des matières (Français)



Table of content (English)


Téléchargement

Installation (pour déploiement serveur)

  1. Télécharger la version désirée.
  2. Décompresser le fichier télécharger
  3. Déploier l'application sur un serveur Web (NGinx, Apache HTTPD, IIS ...)
  4. Servir le fichier index.html
  5. Personnaliser le contenu cartogtaphique (contexts.json et _default.json ou ...)

Installation et démarrage (pour développeurs)

Requis:

IGO2 version Node version
>= 16.x >= 18.10.0
> 1.15.x >= 16.19.0
> 1.5.x >= 12, <= 16
< 1.5.x >= 8, <= 11
0.x.x >= 6, <= 10
$ git clone --depth 1 https://github.com/infra-geo-ouverte/igo2.git
$ cd igo2

# Installer les dépendances
$ npm install

# Surveiller les fichiers et lancer une instance pour le développement
# Il est possible que vos changements de librairies ne soient pas appliqués.
# Webpack (suite au npm start) ne surveille plus les changement de node_modules. Il observe seulement la version des dépendances. De ce fait, les
# changements de code ne sont pas recompilées.
# Pour corriger ceci, désactiver la cache avec la variable d'environnement NG_BUILD_CACHE = "false"
$ npm start
# Ouvrir un navigateur http://localhost:4201/

# Build prod
$ npm run build.prod
$ npm run serve.prod
# Ouvrir un navigateur http://localhost:4201/

# Générer l'api de documentation
$ npm run doc
# Ouvrir un navigateur http://localhost:4220/

Si vous voulez développer en même temps ce projet ainsi que la librairie associée, référez vous à la procédure suivante:
https://github.com/infra-geo-ouverte/igo2-lib#for-developers

Tests

$ npm test

# Tests après chaque changement
$ npm run test.watch

# code coverage (istanbul)
$ npm run coverage

# e2e (end-to-end intégration)
$ npm start
$ npm run e2e

Contribuer

Nous sommes bien heureux que vous pensiez contribuer à IGO! Avant de le faire, nous vous encourageons à lire le guide de contribution, la LICENCE et le WIKI. Si vous avez d'autres questions, n'hésitez pas à communiquer avec nous à l'adresse suivante info(a)igouverte.org ou par Gitter.



Download

Installation (for server deployment)

  1. Download the desired version.
  2. Unzip the download file
  3. Deploy the application on a web server (NGinx, Apache HTTPD, IIS...)
  4. Serve the index.html file
  5. Customize map content (contexts.json and _default.json)

Installation (for developpers)

Require:

IGO2 version Node version
>= 16.x >= 18.10.0
> 1.15.x >= 16.19.0
> 1.5.x >= 12, <= 16
< 1.5.x >= 8, <= 11
0.x.x >= 6, <= 10
$ git clone https://github.com/infra-geo-ouverte/igo2.git
$ cd igo2

# Install dépendencies
$ npm install

# Check files and launch dev instance
# Your library changes may not be applied.
# Webpack (following npm start) no longer monitors node_modules changes. It only observes the version of the dependencies. Therefore, the
# code changes are not recompiled.
# To fix this, disable the cache with the environment variable NG_BUILD_CACHE = "false"
$ npm start
# Open your browser at http://localhost:4201/

# Build prod
$ npm run build.prod
$ npm run serve.prod
# Open your browser at http://localhost:4201/

# Doc API generation
$ npm run doc
# Open your browser at http://localhost:4220/

If you want to develop this project and the associated library at the same time, refer to the following procedure:
https://github.com/infra-geo-ouverte/igo2-lib#for-developers

Tests-en

$ npm test

# Check by karma
# Tests after each change
$ npm run test.watch

# code coverage (istanbul)
$ npm run coverage

# e2e (end-to-end intégration)
$ npm start
$ npm run e2e

Contribution

Before contributing, please read the guidelines, the LICENCE and the WIKI. If you have any question and want to contribute, contact the main email of IGO info(a)igouverte.org or on Gitter