DokuWiki

It's better when it's simple

Outils pour utilisateurs

Outils du site


Panneau latéral

Traductions de cette page?:

Découvrir DokuWiki

Options avancées

Pour les entreprises

Notre Communautée


Suivez-nous sur Facebook, Twitter et les autres résaux sociaux.

Notre politique de confidentialité

fr:bugs

Signaler les bogues DokuWiki

Chaque logiciel a des bogues. Nous tâchons de sortir la meilleure version possible de DokuWiki à chaque fois, mais des erreurs se produisent. Cette page est là pour vous aider à signaler les bogues que vous pourriez rencontrer.

Assurez-vous qu'il s'agit bien d'un Bogue

Avant de signaler quelque chose, essayez de rechercher si le problème que vous rencontrez est vraiment un bogue. Peut-être s'agit-il d'un comportement intentionnel pour une raison quelconque ? Peut-être y a-t-il un un paramètre de configuration que vous pourriez régler ?

Vous devriez aussi rechercher sur le forum si d'autres personnes ont rencontré le même problème. Peut-être existe-il déjà une solution.

Cependant, si vous avez encore des doutes, il suffit d'ouvrir un rapport de bogue. Nous pouvons toujours le fermer s'il s'avère qu'il ne s'agit pas d'un bogue.

Vérifiez si le problème est déjà signalé

Tous les bogues DokuWiki doivent être signalés dans notre outil de suivi des bogues sur GitHub, situé à l'adresse https://github.com/splitbrain/dokuwiki/issues. Pour les bogues des thèmes et greffons, reportez vous au suivi de bogues propre à l'extension — vous trouverez un lien vers celui-ci sur la page de documentation de celle-ci.

Utilisez la recherche pour vérifier si votre problème a déjà été signalé. Veillez également à rechercher les bogues fermés — le bogue peut avoir été corrigé dès le début du développement.

Si le bogue a déjà été signalé, vérifiez si vous pouvez fournir des informations supplémentaires pour aider à le corriger. Voir ci-dessous comment faire.

Signaler un bogue

Comme mentionné ci-dessus, les bogues DokuWiki doivent être signalés sur https://github.com/splitbrain/dokuwiki/issues. Vous aurez besoin d'un compte GitHub gratuit pour ce faire. Veuillez ne pas signaler les bogues ailleurs (IRC, Twitter, Forum). Le suivi de bogue GitHub est la seule façon officielle de signaler un bogue. Encore une fois : rapportez les bogues de l'extension dans le suivi de bogue de l'extension elle-même.

Lorsque vous signalez un bogue, vous devez essayer d'inclure autant d'informations que possible qui aident les développeurs à identifier le problème.

Ceci peut inclure:

  • la version de DokuWiki
  • Le système d'exploitation (OS) du serveur et du client
  • Le serveur web utilisé
  • La version PHP utilisée
  • Les navigateurs utilisés (essayez-en plusieurs)
  • Tout ce qui est spécial dans votre configuration (extensions, backends d'authentification, configuration réseau inhabituelle, etc.)
  • Les étapes exactes pour reproduire le problème
  • Captures d'écran
  • Qu'avez-vous essayé de faire pour résoudre le problème et quels en ont été les résultats exacts ?

Il est particulièrement important de recueillir des messages d'erreur exacts ! Voyez si vous pouvez trouver les journaux d'erreurs du serveur web et de la console JavaScript (voir ci-dessous).

Veuillez également lire Comment signaler efficacement les bogues pour plus de conseils sur la façon de soumettre des rapports de bogues utiles.

Comment obtenir des informations supplémentaires

Comme mentionné ci-dessus, les développeurs de DokuWiki ont besoin de messages d'erreur détaillés pour déboguer un problème. Parfois, ces messages sont imprimés directement à l'écran, mais parfois ils ne le sont pas. Dans ces cas, vous pouvez vérifier les options suivantes :

Journaux d'erreurs Serveur/PHP

Chaque fois que quelque chose tourne fatalement mal, PHP arrête simplement de traiter votre demande. Cela se traduit généralement par une page blanche ou partielle. Parfois, les erreurs sont moins graves, mais il manque toujours des éléments.

Dans tous ces cas, PHP enregistre un message d'erreur dans un fichier journal. L'emplacement exact de ce fichier journal diffère d'un système à l'autre. Les erreurs peuvent être consignées dans le journal des erreurs du serveur web, dans le journal global du système ou dans un journal des erreurs PHP spécifique. Ceci est configuré dans la directive error_log de php.ini.

Les emplacements habituels sont :

  • /var/log/apache2/error.log
  • /var/log/apache/error.log
  • /var/log/httpd/error.log
  • /var/log/syslog

Si vous êtes sur un serveur hébergé, il est préférable de demander à votre fournisseur où se trouve ce journal. Si vous n'avez pas accès au fichier php.ini et que vous ne pouvez pas trouver le fichier journal, vous pouvez également essayer d'ajouter ce qui suit au fichier htaccess dans votre dossier racine DokuWiki :

php_value display_errors 1
php_value display_startup_errors 1

Cela peut envoyer le message d'erreur au navigateur.

Journal de la console JavaScript

Parfois, les choses se passent mal du côté client (dans votre navigateur). Pour le savoir, vous devez accéder à la console JavaScript de votre navigateur. Pour ce faire, utilisez les raccourcis clavier suivants :

Navigateur Windows/Linux Mac
Chrome Ctrl + Shift + J Cmd + Opt + J
Firefox Ctrl + Shift + K Cmd + Opt + K
Internet Explorer F12, then click on the “Console” tab
Safari Cmd + Opt + C

Si vous voyez des erreurs (généralement indiquées en rouge) dans la console, allez dans votre Gestionnaire de configuration et désactivez le paramètre "compress". Rechargez la page et vérifiez à nouveau la présence d'erreurs dans la console JavaScript.

Si vous trouvez des erreurs dans la console JavaScript, vous devez toujours les joindre à votre rapport de bogue. De préférence, celles trouvées avec le paramètre “compress” désactivé. Cependant, il arrive parfois que des erreurs n'apparaissent qu'avec “compress enabled” — dans ce cas, envoyez-nous ces messages d'erreur.

Tâches récemment ouvertes

Subscribe to ‘DokuWiki: Recently Opened Tasks’ by RSS

    Crédits

    • traduction : — digitalin 2020-08-13 16:44
    fr/bugs.txt · Dernière modification: 2021-04-26 18:01 de Aleksandr