Comment obtenir de l’aide en ligne ?#
1. Avant de demander de l’aide#
Nous supposons ici que, si vous ne savez plus quoi faire, vous avez au moins :
regardé les réponses données dans des FAQ ;
regardé dans les livres dont vous disposez ;
étudié des tutoriels ;
étudié des fils de discussion, par exemple sur TeXnique.fr ;
et éventuellement fouillé des archives d’échanges :
en français, celles du groupe de discussion fr.comp.text.tex ou celle de la liste gut ;
en anglais, celles du groupe de discussion comp.text.tex ou de la liste de discussion texhax.
Pensez aussi, si vous cherchez une extension ou un programme particulier, à regarder sur votre propre système : vous avez peut-être déjà ce que vous cherchez car les distributions TeX fournissent un large éventail de fichiers. Le CTAN peut également identifier les extensions qui pourraient aider : vous pouvez les chercher, tout comme vous pouvez le parcourir par sujet. Chaque entrée du CTAN propose une brève description de l’extension et des liens vers la documentation connue sur le net. Mieux, une grande partie de ces entrées incluent désormais de la documentation, il est donc souvent utile de consulter la page CTAN de l’extension que vous envisagez d’utiliser. D’ailleurs, dans la mesure du possible, chaque lien mis sur une extension dans le corps principal de cette FAQ a un lien vers le entrée de catalogue pertinente).
Si la recherche par historique échoue, vous pouvez alors demander de l’aide au monde entier.
2. Construire un exemple complet minimal#
Pour être bien aidé, il faut bien décrire votre problème. La question « Comment poser une question ? » vous donne ici des conseils généraux sur cette phase.
Dans le cas où votre code ne produit pas le résultat que vous attendez, il est indispensable d’accompagner la description de votre problème d’un exemple de code qui permette de le reproduire. Cet exemple doit être si possible complet et minimal, c’est ce qu’on appelle un « ECM » (exemple complet minimal).
La question « Comment rédiger un « exemple minimal » ? » décrit en détail comment procéder.
3. Où demander de l’aide ?#
Voici les trois principales sources d’aide en ligne :
les listes de diffusion ;
les groupes de discussion ;
les forums.
Enfin, n’essayez surtout pas d’envoyer un e-mail à l’équipe du projet LaTeX ou aux responsables des distributions TeX Live ou MiKTeX pour obtenir de l’aide. Même si ces adresses concernent des utilisateurs expérimentés de TeX et LaTeX, aucun petit groupe ne peut avoir une expertise dans tous les domaines d’utilisation, de sorte que les listes et forums restent un bien meilleur pari.
Sources
LaTeX : À l’aide ! (wikibook)