Ce projet vise à migrer le projet DemoKGViz existant vers le framework Angular, en ajoutant également de nouvelles fonctionnalités et améliorations. Le but ultime est d'améliorer la maintenance, la scalabilité et la convivialité du projet grâce à l'utilisation d'Angular.
- AZEBAZE Nadine
- BELHASSEN Mohamed
- SAMY Mokhtar
- Migration vers Angular :
- Convertir progressivement le code JavaScript existant en TypeScript.
- Structurer le projet en utilisant les concepts modulaires d'Angular.
- Réorganiser les fichiers et dossiers selon les meilleures pratiques d'Angular.
- Utiliser les directives, les composants et les services Angular pour améliorer la lisibilité et la maintenabilité du code.
- Ajout de nouvelles fonctionnalités :
- Analyser les besoins du projet et identifier les fonctionnalités à ajouter.
- Implémenter de nouvelles fonctionnalités en utilisant Angular et TypeScript.
- Intégrer des bibliothèques ou des modules supplémentaires si nécessaire pour faciliter le développement.
- Améliorations générales :
- Optimiser les performances de l'application en utilisant les meilleures pratiques d'Angular.
- Améliorer l'expérience utilisateur en utilisant les fonctionnalités d'Angular.
Avant de commencer le projet, assurez-vous d'avoir les éléments suivants :
- Node.js (version 18.15.0 ou supérieure) installé sur votre machine. Vous pouvez télécharger Node.js à partir du site officiel : https://nodejs.org
- Angular CLI (version 15.2.5) installé globalement. Vous pouvez l'installer en exécutant la commande suivante dans votre terminal :
npm install -g @angular/[email protected]
Assurez-vous de disposer des versions spécifiées de Node.js et d'Angular CLI pour garantir la compatibilité avec le projet.
- Clonez le dépôt du projet depuis lien du dépôt.
- Ouvrez une invite de commande et accédez au répertoire du projet.
- Exécutez la commande
npm install
pour installer les dépendances du projet.
- Utilisez la commande
ng serve
pour exécuter le projet en mode développement. - Ouvrez votre navigateur et accédez à
http://localhost:4200
pour voir l'application en cours d'exécution.
Pour gérer le cache dans l'application , vous pouvez configurer le fichier ngsw-config.json
qui se trouve à la racine de votre projet.
Dans la configuration actuelle, nous avons défini deux groupes d'actifs (assetGroups). Le groupe "app" utilise le mode d'installation "prefetch" et précharge les fichiers essentiels de l'application tels que index.html, les fichiers CSS et JavaScript, et manifest.webmanifest.
Le groupe "assets" utilise le mode d'installation "lazy" et met en cache les fichiers du répertoire /assets ainsi que les fichiers d'images courants tels que les formats SVG, PNG, JPEG, etc.
ous avons également défini deux groupes de données (dataGroups). Le groupe "map" met en cache des ressources provenant de différentes URL liées aux cartes, avec une taille maximale de cache de 50 et une durée de vie maximale de 24 heures. Le groupe "queries" met en cache les requêtes SPARQL provenant du serveur i3s.unice, avec une taille maximale de cache de 30 et une durée de vie maximale de 12 heures.
Vous pouvez personnaliser cette configuration en fonction des besoins de votre application. Les paramètres tels que maxSize, maxAge et strategy peuvent être ajustés en fonction de vos préférences et des exigences
N'oubliez pas de générer à nouveau votre application pour prendre en compte les modifications de configuration des Service Workers.
Pour en savoir plus sur la configuration des Service Workers en Angular, vous pouvez consulter la documentation officielle.
Avant de pouvoir déployer votre projet sur GitHub Pages, vous devez effectuer une configuration initiale dans les paramètres de votre référentiel. Voici les étapes à suivre :
- Accédez aux paramètres (Settings) de votre référentiel GitHub.
- Faites défiler jusqu'à la section "GitHub Pages".
- Sélectionnez la branche principale (main) comme source de votre site web.
- Choisissez le dossier racine (docs) comme source si votre fichier index.html se trouve à la racine de votre référentiel.
- Enregistrez les modifications. Cette configuration initiale n'a besoin d'être effectuée qu'une seule fois.
Une fois que vous avez terminé cette étape initiale, vous pouvez passer au déploiement du projet . Nous avons ajouté un script personnalisé dans le fichier package.json
. Vous pouvez exécuter ce script en utilisant la commande suivante :
npm run deploy
Assurez-vous d'avoir configuré correctement les paramètres de déploiement dans le fichier angular.json
. Vous devrez spécifier le nom du référentiel GitHub dans la propriété "outputPath"
du "deploy"
dans "architect"
. Dans notre cas, pour ce projet, le dossier de sortie est configuré sur Docs
.
Une fois que le script a été exécuté avec succès et que le code a été poussé, votre projet sera déployé sur GitHub Pages. Vous pourrez y accéder en utilisant le lien suivant : https://votre-utilisateur-github.github.io/votre-repo/
. Dans le cas spécifique de ce projet, le lien de déploiement est : https://mohamedlouay.github.io/kg-viz/
.
Si vous rencontrez des problèmes lors de l'exécution de la commande npm install
, notamment liés au module @angular/[email protected]
, vous pouvez essayer la solution suivante :
npm install --force
Cette commande permet une installation forcée du module, ce qui peut aider à résoudre les problèmes liés à cette version spécifique du module.
- Créez une branche (
git checkout -b ma-branche
) - Effectuez les modifications nécessaires et commit (
git commit -m 'Ajouter une fonctionnalité'
) - Poussez les modifications vers la branche (
git push origin ma-branche
) - Soumettez une demande d'extraction (Pull Request).
Veuillez vous assurer de respecter les normes de codage, les conventions de dénomination et d'inclure la documentation appropriée pour toutes les modifications apportées.
N'hésitez pas à nous contacter en cas de questions ou de problèmes.