Documentation de l’application Météo (v1.6.0)

Bienvenue dans la documentation de l’application Météo ! Cette application fournit des informations météorologiques en temps réel et des prévisions de plusieurs fournisseurs de données météorologiques.

Fonctionnalités

Mises à jour récentes

Pour une liste détaillée des modifications, consultez le fichier CHANGELOG.md.

Pour commencer

  1. Guide d’installation - Comment installer et configurer l’application
  2. Guide d’utilisation - Comment utiliser l’application
  3. Configuration - Comment configurer l’application

Sujets avancés

Support

Pour obtenir de l’aide, veuillez ouvrir un problème sur notre dépôt GitHub.

Licence

Ce projet est sous licence GPLv3 - voir le fichier LICENCE pour plus de détails.

Guide d’utilisation

Pour commencer

  1. Lancer l’application
  2. Rechercher un emplacement

Interface principale

Affichage météorologique

Cartes météo et radar

La fonction Cartes météo et radar fournit des visualisations interactives des conditions météorologiques.

Accès aux cartes météo

  1. Cliquez sur Affichage dans la barre de menu
  2. Sélectionnez Cartes météo et radar
  3. La boîte de dialogue des cartes météo s’ouvrira avec plusieurs onglets

Fonctionnalités

Onglet Radar

Onglet Température

Onglet Précipitations

Onglet Vent

Utilisation de la carte

Astuces

Fonctionnalités

Favoris

Paramètres

  1. Cliquez sur l’icône d’engrenage (⚙️) ou allez dans Menu > Paramètres
  2. Configurez des options comme :
  3. Cliquez sur “Enregistrer” pour appliquer les modifications

Interface en ligne de commande

# Utilisation de base
weather-app [emplacement] [options]

# Exemples
weather-app "Paris, FR"
weather-app --provider openweathermap --units metric
weather-app --config ~/.config/weather/config.ini

# Options
  -h, --help            Afficher le message d'aide et quitter
  -v, --version         Afficher les informations de version
  -c, --config FICHIER  Spécifier le fichier de configuration
  -d, --debug           Activer le mode débogage
  --provider FOURNISSEUR   Définir le fournisseur météo
  --units {metric,imperial}
                        Définir le système d'unités
  --lang LANGUE         Définir le code de langue
  --theme {clair,sombre,systeme}
                        Définir le thème de couleur
  --no-gui              Exécuter en mode console

Raccourcis clavier

Raccourcis globaux

Raccourci Action
Ctrl + F Placer le curseur dans la barre de recherche
Ctrl + , Ouvrir les paramètres
Ctrl + Q Quitter l’application
F1 Afficher l’aide
Échap Fermer les boîtes de dialogue ou effacer la recherche
F5 Actualiser les données météo
Ctrl + R Actualiser toutes les données
Ctrl + W Fermer la fenêtre actuelle
Ctrl + N Nouvelle fenêtre

Raccourcis de navigation

Raccourci Action
Ctrl + Tab Basculer entre les emplacements
Ctrl + F Basculer les favoris
Ctrl + L Basculer la liste des emplacements
Ctrl + M Basculer la vue carte

Astuces et conseils

Visionneuse de documentation

Visionneuse de journaux

Cartes météo

Dépannage

Si vous rencontrez des problèmes :

  1. Vérifiez votre connexion Internet
  2. Vérifiez vos clés API dans les Paramètres
  3. Essayez de passer à un autre fournisseur météo
  4. Vérifiez les journaux de l’application pour les erreurs
  5. Redémarrez l’application
  6. Réinitialisez les paramètres si nécessaire

Pour une aide supplémentaire, veuillez visiter notre dépôt GitHub ou consulter le Guide de dépannage.

Commentaires

Nous apprécions vos commentaires ! N’hésitez pas à nous faire savoir :

Vous pouvez soumettre vos commentaires via l’application (Aide > Envoyer des commentaires) ou sur notre page GitHub Issues.

Guide de dépannage

Ce guide vous aide à résoudre les problèmes courants que vous pourriez rencontrer lors de l’utilisation de l’application Météo.

Table des matières

Problèmes courants

1. L’application ne démarre pas

Symptômes :

Solutions :

  1. Vérifiez les exigences système :
  2. Réinstallez les dépendances : 
    # Activez d'abord votre environnement virtuel
pip install --upgrade -r requirements.txt
  3. Vérifiez les logiciels conflictuels :
  4. Réinitialisez la configuration : 
    # Sauvegardez d'abord votre configuration
mv ~/.config/WeatherApp/config.ini ~/.config/WeatherApp/config.ini.bak

2. Aucune donnée météo affichée

Symptômes :

Solutions :

  1. Vérifiez votre connexion Internet :
  2. Vérifiez les clés API :
  3. État du fournisseur :
  4. Services de localisation :

3. Utilisation élevée du processeur ou de la mémoire

Symptômes :

Solutions :

  1. Réduisez la fréquence de mise à jour :
  2. Désactivez les animations :
  3. Effacez le cache : 
    # Linux/macOS
rm -rf ~/.cache/WeatherApp
   
# Windows
rmdir /s /q %LOCALAPPDATA%\WeatherApp\Cache
  4. Vérifiez les fuites de mémoire :

Fichiers journaux

Les fichiers journaux contiennent des informations détaillées sur les événements et les erreurs de l’application. Ils sont essentiels pour le dépannage.

Emplacements des journaux

Niveaux de journalisation

Consultation des journaux

  1. Depuis l’application :
  2. Depuis la ligne de commande : 
    # Linux/macOS
tail -f ~/.local/share/WeatherApp/logs/app.log

Questions fréquemment posées

Comment changer d’unités métriques/impériales ?

  1. Allez dans Paramètres > Général
  2. Sélectionnez votre système d’unités préféré
  3. Cliquez sur “Enregistrer”

Comment signaler un bug ?

  1. Vérifiez d’abord si le bug n’a pas déjà été signalé
  2. Rassemblez les informations suivantes :
  3. Créez un nouveau problème sur GitHub

Obtenir de l’aide

Si vous ne trouvez pas de solution à votre problème :

  1. Consultez la documentation :
  2. Recherchez dans les problèmes existants :
  3. Demandez de l’aide :

Traduction

L’application prend en charge plusieurs langues. Pour ajouter une nouvelle langue :

  1. Créez un nouveau fichier de traduction dans le dossier translations/
  2. Ajoutez des traductions pour toutes les chaînes dans le fichier translations/en.json
  3. Ajoutez la langue au menu des langues en incluant ces clés :

Exemple pour le français (fr.json) :

{
  "language_menu": "Langue",
  "language_tip": "Sélectionner la langue de l'application",
  "settings": "Paramètres",
  "weather": "Météo",
  "forecast": "Prévisions",
  "map": "Carte",
  "favorites": "Favoris",
  "help": "Aide"
}