Comment signaler des problèmes

Si, malgré l'étude de la documentation et des tutoriels, vous rencontrez un comportement étrange, cette page est là pour vous dire ce qu'il faut faire dans une telle situation. Tout d'abord, si vous pensez qu'il y a un problème, le simple fait de dire que cela ne fonctionne pas ne nous aidera pas à trouver une solution. Nous ne sommes pas des devins et nous avons besoin d'informations pour identifier le problème et trouver une solution. Il est donc important que vous nous disiez ce que vous faisiez au moment où le problème s'est produit, quel système d'exploitation vous utilisez, quelle version de Siril vous utilisez et surtout les logs !

Vérifier les listes de modifications et de bugs

Tout d'abord, si vous trouvez un bug dans Siril, il se peut qu'il ait déjà été signalé (parfois littéralement des dizaines de fois). Nous vous demandons donc de vérifier d'abord, par exemple en regardant les changelogs, ou les tickets qui ont déjà été ouverts, et même fermés.

Envoyez-nous des informations utiles

Comme indiqué dans l'introduction, nous avons besoin d'informations utiles pour résoudre le problème :

1. Quel système d'exploitation utilisez-vous ? Siril peut se comporter très différemment sous Windows, Linux ou macOS, c'est pourquoi nous avons besoin de cette information. Soyez aussi précis que possible.

2. Quelle version de Siril utilisez-vous ? Et comment l'avez-vous obtenue ? Paquet téléchargé sur le site web ? Par l'intermédiaire d'un tiers ? Compilé par vous-même ? Là encore, soyez le plus précis possible.

3. Il est parfois utile de partager des captures d'écran. Cependant, s'il vous plaît NE PRENEZ PAS VOS CAPTURES D'ÉCRAN AVEC VOTRE SMARTPHONE - c'est illisible. Votre système d'exploitation est capable de faire des captures d'écran très facilement (Google peut vous aider) et Siril offre également une telle fonctionnalité (le bouton avec l'appareil photo). Enfin, les formats souhaités sont des formats d'images : jpg, bmp ou png, mais absolument pas pdf.

4. Envoyez-nous des billes. Idéalement, nous préférons les logs en anglais ! Il suffit d'aller dans les préférences du Siril et de changer la langue en anglais dans l'onglet Interface utilisateur. Par ailleurs, il existe deux types de logs : celui affiché dans la console Siril, qui décrit les étapes effectuées par le logiciel et peut nous aider à déboguer, et les logs internes qui sont visibles lorsque Siril est exécuté à partir de la ligne de commande :

   • Les premiers sont très utiles dans la plupart des cas et peuvent être exportés très facilement à l'aide du bouton situé en bas à droite de ceux-ci. Cela crée un fichier qui peut facilement nous être envoyé.

   • Cependant, lorsque le logiciel crash (c'est-à-dire qu'il se ferme soudainement sans avertissement), vous devez lancer Siril à partir de la ligne de commande, en essayant de reproduire le crash et de récupérer les logs. Ici, la méthode dépend du système d'exploitation.

     • Microsoft Windows : Ouvrez une fenêtre cmd (tapez cmd dans la barre de recherche de Windows) et tapez ce qui suit :

       "C:\Program Files\Siril\bin\siril.exe" 2>&1 >output.log
       

       Ceci sauvegardera le fichier output.log dans le dossier où le terminal a été démarré (dans la plupart des cas dans le dossier %USERPROFILE%).

     • macOS : Si vous avez installé Siril dans le dossier Applications, comme cela est généralement recommandé, commencez par ouvrir l'application Terminal à partir du dossier Utilities dans Applications, puis copiez et collez la ligne suivante :

       /Applications/Siril.app/Contents/MacOS/siril > ~/Desktop/output.log 2>&1
       

       Après le crash, les logs seront disponibles sur le bureau dans le fichier output.log.

     • GNU/Linux : Lancez simplement Siril dans un terminal. Habituellement, le binaire est situé dans la variable $PATH, dans ce cas tapez :

       siril > output.log 2>&1
       

       est tout ce dont vous avez besoin pour rediriger les logs dans le fichier output.log. Le fichier output.log sera sauvegardé dans le dossier où le terminal a été démarré

5. Envoyez-nous votre image. Si vous trouvez votre image étrange, n'hésitez pas à la partager avec nous, généralement au format FITS. C'est toujours plus intéressant qu'une capture d'écran. Pour ce faire, vous devez utiliser un service d'échange de fichiers volumineux. Il en existe beaucoup, et nous pouvons vous suggérer WeTransfer, par exemple. Dans ce cas, téléchargez vos données sur WeTransfer et obtenez un lien de téléchargement à partager.

Comment nous contacter ?

Il y a plusieurs façons de nous contacter et de signaler un bug. La plus simple est de nous trouver sur le forum (anglais), ou celui-ci (français). Mais il est également possible d'ouvrir un ticket sur notre dépôt gitlab. Dans ce cas, vérifiez d'abord que le même ticket n'a pas déjà été ouvert. Il se peut même qu'il ait été fermé parce qu'il a été résolu, dans ce cas, une courte description avec un numéro de ticket sera affichée dans le Changelog. Pour visualiser le ticket (même un ticket fermé) et confirmer que vous rencontrez ou non le même problème, rendez-vous à l'adresse https://gitlab.com/free-astro/siril/-/issues/XXXX avec XXXX le numéro de ticket.