Table des matières

À propos de ce site
Fond des contributions
Forme des contributions
Divers
Problèmes

À propos de ce site

En quoi ce site de questions/réponses diffère-t-il d'un forum typique ?

Nous nous concentrons ici sur la recherche de réponses aux questions de nos membres, et cherchons à proposer des solutions (et seulement des solutions) optimales. Au contraire, un forum Web typique fonctionne plus comme un groupe de discussion, où les membres partagent leurs opinions et les sujets discutés sont souvent plus subjectifs.

Qui anime cette communauté ?

La réponse courte est : vous… et nous. Ce site est animé par ses utilisateurs. Un système de points permet aux utilisateurs d'acquérir certaines compétences de modération.

Pourquoi d'autres personnes peuvent-elles modifier mes contributions (questions/réponses/commentaires) ?

Pour améliorer la qualité globale de la base de connaissances de ce site, les membres expérimentés de sa communauté peuvent remanier les contributions des autres. Ainsi, les visiteurs trouveront ici beaucoup de questions bien posées et de réponses clairement formulées.

Pourquoi mes contributions sont-elles automatiquement placées sous licence « cc-by-sa 3.0 fr » ?

La raison principale pour laquelle nous demandons aux utilisateurs du présent site d'accepter que toutes leurs contributions (questions, réponses, commentaires) soient publiées sous la licence Creative Commons Partage dans les mêmes conditions 3.0 France (cc-by-sa 3.0 fr), est d'assurer que celles-ci pourront être exploitées ultérieurement, par exemple pour constituer ou enrichir une FAQ LaTeX (bien sûr alors publiée sous la même licence).

Pour participer à cette communauté, dois-je créer un nouveau compte ?

Si vous possédez déjà un OpenID, vous pouvez directement vous connecter au site par ce biais-là.
Sinon, vous devez vous créer préalablement un nouveau compte.

Comment fonctionne le système de points ?

Quand une question ou une réponse reçoit un vote positif, l'utilisateur qui en est l'auteur gagne quelques points appelés « points de karma ». Ces points permettent de mesurer (approximativement) la confiance de la communauté en cet utilisateur. Diverses compétences de modération sont progressivement affectées aux utilisateurs en fonction de ces points.

Par exemple, si vous posez une question intéressante ou donnez une réponse utile, votre contribution recevra un vote positif. En revanche, une réponse fausse ou trompeuse recevra un vote négatif. Chaque vote positif générera |REP_GAIN_BY_UPVOTED| points, chaque vote négatif soustraira |REP_LOST_BY_DOWNVOTED| points. Un maximum de 200 points peut être atteint par une question ou une réponse. La liste suivante indique le seuil minimal de karma pour obtenir chaque compétence de modération.

Ajouter des commentaires → |REP_TO_COMMENT|
Fermer ses propres questions → |REP_TO_CLOSE_OWN|
Rouvrir ses propres questions → |REP_TO_REOPEN_OWN|
Changer les mots-clés d'une question → |REP_TO_RETAG|
Modifier toute réponse → |REP_TO_EDIT_OTHERS|
Rouvrir toute question fermée → |REP_TO_CLOSE_OTHERS|
Supprimer tout commentaire → |REP_TO_DELETE_COMMENTS|

Qu'est-ce qu'un « gravatar » ?

Votre « gravatar » (« Globally Recognized avatar ») est l'avatar, sous forme d'image unique, associé à votre adresse courriel. Il s'agit simplement d'une image affichée à côté de vos messages sur les sites qui prennent en charge le protocole gravatar. Le gravatar par défaut est un carré contenant une image semblable à un flocon de neige. Vous pouvez configurer cette image sur gravatar.com.

On peut considérer le service gravatar comme un mouchard. Néanmoins, nous le considérons comme globalement inoffensif. En témoignent, pour les lecteurs anglophones, la page https://apps.ghostery.com/fr/apps/gravatar… ainsi que celle-ci qui précise les conditions d'utilisation des données recueillies par les serveurs de automattic.com, société mère de gravatar.com.

Pourquoi les notifications par courriel sont-elles si importantes ?

Les notifications par courriel sont la pierre angulaire du succès d'un site de Q & R communautaire. Ces notifications permettent aux membres de la communauté d'être informés des événements importants, notamment lorsque :

l'une de leurs questions reçoit une réponse ;
l'un de leurs messages est commenté par un autre membre ;
les autres membres affichent de nouvelles questions, des réponses, ou des commentaires dans leur domaine d'intérêt.

Le succès de la communauté repose sur les contributions et la coopération de ses membres, et ceux-ci sont bien plus susceptibles d'être impliqués et de participer activement quand ils sont informés des événements les intéressant. Voilà pourquoi nous considérons une adresse de courriel valide comme nécessaire pour participer à la communauté et rendre ce site vivant.

Si vous êtes déjà membre de cette communauté et n'avez pas validé votre adresse courriel, vous pouvez le faire ici. Si vous n'êtes pas encore membre de cette communauté, vous pouvez la rejoindre en vous inscrivant.

Comment modifier mon profil, par exemple mes notifications par courriel ?

Pour modifier votre profil, cliquez sur votre nom tout en haut des pages du site puis cliquez sur « Outils pour l'utilisateur » pour choisir le type de modifications que vous souhaitez, par exemple « configuration des notifications par courriel ».

Et maintenant ?

Vous pouvez nous aider à améliorer notre site et enrichir la base de connaissance sur (La)TeX en :

trouvant une question à laquelle répondre ;
posant une question.

Un élément important de ce site étant la qualité (clarté, concision, précision, etc.) des questions, réponses et commentaires, n'hésitez pas à consulter les recommandations et astuces, tant pour le fond que pour la forme des contributions.

Fond des contributions

En général

Comment rendre mes contributions aussi utiles que possible ?

Soyez informatif : veillez à ce que vos contributions enrichissent (et uniquement enrichissent) la base de connaissances (La)TeX car c'est ce que d'autres personnes chercheront ici : des solutions (et seulement des solutions) optimales à des questions concernant (La)TeX. Vos contributions doivent donc contenir :
- de l'information utile ;
- seulement de l'information utile.
En particulier, évitez de faire figurer (et surtout de ne faire figurer que) :
- des formules de politesse (« Bonjour », « Merci d'avance », etc.) ;
- des marques d'opinion (« Merci », « +1 », etc.) ou des confirmations de solution (notamment dans les commentaires) :
  - si une contribution vous a été utile, inutile de le dire : il suffit de (et il faut) voter (positivement) pour elle ;
  - si une réponse fournit la (meilleure) solution à une question, inutile de le dire : il suffit de (et il faut) accepter cette réponse ;
- votre signature qui est redondante : votre nom d'utilisateur est automatiquement affiché en dessous de vos contributions.
Soyez clair, précis, concis.
Si possible, illustrez vos questions et réponses d'un ou plusieurs ECM… voire d'images illustrant ces ECM.
N'hésitez pas à modifier vos contributions pour les peaufiner.

Je viens de constater que ma contribution n'a pas été très clairement formulée. Puis-je la modifier ?

Tout à fait, l'idée étant d'améliorer autant que possible la qualité globale du site. Vous pouvez donc peaufiner vos contributions en cliquant sur :

le lien « Modifier » pour les questions et réponses ;
l'icône pour les commentaires.

On me dit d'éviter le syndrome XYZ. Que cela signifie-t-il ?

Vous êtes atteint du syndrome XYZ lorsque :

vous voulez faire X ;
vous croyez que la solution passe par Y ;
vous ne parvenez pas à mettre en œuvre Y ;
vous demandez de l'aide pour Y, sans mentionner X ;
tout le monde perd du temps à tenter de mettre en œuvre Y ;
or la solution à X est en fait Z (qui n'a rien à voir avec Y) !

NB. Indiquer le contexte (X) dès le début fait gagner du temps :

à ceux qui m'aident ;
à moi-même.

Questions

Quelles questions puis-je poser ici ?

Avant tout, les questions posées doivent être pertinentes pour la communauté (La)TeX. Avant de poser une question, assurez-vous qu'une question similaire n'a pas déjà été posée : cela fera gagner du temps à vous et aux contributeurs de ce site. Vous pouvez rechercher des questions par leur titre, leur contenu ou leurs mots-clés (tags).

Quelles questions devraient être évitées ?

Évitez de poser des questions qui ne sont pas relatives à (La)TeX, dont les réponses seraient trop subjectives ou qui pourraient mener à des débats.

Pourquoi est-il si important de ne poser qu'une question à la fois ?

Cela permet de :

donner des titres (plus) concis aux questions ;
rendre plus rapide et plus facile le travail de ceux qui sont disposés à répondre ;
faciliter la recherche de questions pour ceux qui consultent les archives de ce site.

On me demande de reformuler le titre de ma question sous forme interrogative. Pourquoi ?

Vous êtes ici sur un site de questions et réponses et il est donc logique que les questions soient intitulées sous forme de… questions ! Cela aide également ceux qui sont disposés à vous aider : ils savent ainsi précisément à quelle question répondre.

À ce sujet, n'hésitez pas à placer une capitale initiale au premier mot du titre.

Qu'est-ce qu'un ECM et pourquoi est-il si important d'en fournir un ?

Un exemple complet minimal (ECM) est un fichier source :

mettant en évidence le problème rencontré ;
complet, c’est-à-dire contenant tout ce qui permet de le compiler directement (de \documentclass à \end{document} en passant par \begin{document}), sans devoir ajouter une seule ligne ;
minimal, c’est-à-dire allégé de tout ce qui n'est pas en rapport direct avec la question posée :
- packages (sauf éventuellement inputenc, fontenc, lmodern et, dans une moindre mesure, babel) ;
- texte ;
- définitions de macros personnelles ;
- commandes de configuration ;
- etc.

Que ce soit ici ou sur tout autre lieu d’entraide à LaTeX, il est important que vous illustriez votre question par un ECM car, ainsi, vous aidez ceux qui veulent vous aider. Ils pourront en effet alors :

reproduire sur leur machine (ou sur le site de test) exactement le problème que vous rencontrez ;
isoler la cause de ce problème sans devoir faire eux-mêmes le ménage dans votre code source.

En résumé, en fournissant un ECM :

vous montrez votre bonne volonté ;
vous augmentez les chances d'être aidé, et de l'être rapidement.

La production d'un ECM est un exercice certes pas facile (surtout au début), mais instructif et souvent suffisant pour résoudre le problème. N'hésitez pas à commenter/décommenter des portions de code pour que votre exemple devienne effectivement complet et minimal. Pour mettre en évidence un problème lié à l'inclusion de graphiques, vous pouvez vous aider du package mwe qui :

fournit des images dont les autres disposeront également ;
inclut le package lipsum permettant l'inclusion de faux-texte, ce qui peut être utile.

Et n'oubliez pas : « Aide-toi, texnique.fr t'aidera. » :-)

Qu'est-ce qu'un MWE et pourquoi est-il si important d'en fournir un ?

Un MWE, de l'anglais minimal working example, est un ECM, tout simplement - c'est-à-dire un exemple complet minimal : voir ci-dessus.

Qu'est-ce qu'un PO ?

PO signifie post original. Cela vient de l'anglais OP, pour original post, c'est-à-dire « message d'origine ». Mais OP est parfois utilisé dans le sens de original poster, c'est-à-dire « utilisateur ayant posé la question originale ».

Que dois-je faire quand une réponse à ma question a été postée ?

Si la réponse vous semble :

non satisfaisante, notamment si elle ne solutionne pas (complètement) votre problème ou si vous souhaitez par exemple qu'elle soit davantage détaillée, ajoutez un commentaire en cliquant sur le lien correspondant sous cette réponse ;
satisfaisante, veillez à le faire savoir :
- pas au moyen d'un commentaire ;
- en « acceptant » cette réponse : pour cela, il suffit de cliquer sur l'icône correspondante : → ;
- en votant (positivement) pour cette réponse.

J'ai accepté une réponse à ma question mais une autre qui vient d'être publiée est également satisfaisante. Pourquoi ne puis-je pas l'accepter aussi ?

L'idée est d'indiquer quelle réponse apporte la meilleure solution à la question que vous avez posée. Si la nouvelle réponse est « meilleure », vous pouvez toujours annuler l'acceptation de la première (en cliquant à nouveau sur l'icône d'acceptation) au profit de la nouvelle.
Vous pouvez toujours indiquer que les deux réponses apportent des solutions satisfaisantes en votant positivement pour chacune d'elles.

Réponses

Que dois-je éviter dans mes réponses ?

Veillez à ne pas confondre réponses et commentaires.
Ceci est un site de questions et réponses et pas un groupe de discussion. Évitez de tenir des débats dans vos réponses car ils ont tendance à rendre moins lisible ce que d'autres personnes chercheront ici : des solutions (et seulement des solutions) optimales à des questions concernant (La)TeX. Vous pouvez bien sûr faire de brèves remarques en postant des commentaires.

Je pense pouvoir répondre à une question mais je ne suis pas certain de l'avoir bien comprise. Que puis-je faire ?

Si une question ne vous semble pas claire, n'hésitez pas à y ajouter un commentaire pour demander à l'auteur de la modifier pour la préciser ou de la rendre plus parlante en y ajoutant un ECM, voire une image illustrant ce qu'il obtient lui sur sa propre machine.

Commentaires

Quel type de commentaires puis-je poster ici ?

Utilisez les commentaires sur les questions ou réponses par exemple pour :

formuler de brèves remarques ;
demander des éclaircissements ou des précisions ;
signaler des alternatives ;
indiquer (gentiment) à l'auteur de la question ou réponse comment il pourrait mieux formuler sa contribution.

Que dois-je éviter dans mes commentaires ?

Ceci est un site de questions et réponses et pas un groupe de discussion. Nous vous prions donc de proscrire dans vos commentaires les débats et les jugements de valeurs sur les contributions des autres car cela rend moins lisible ce que d’autres personnes chercheront ici : des solutions (et seulement des solutions) optimales à des questions concernant (La)TeX.

En quoi un commentaire diffère-t-il d'une réponse ?

Veillez à ne pas confondre réponses et commentaires :

La zone de texte « Votre réponse » est réservée aux… réponses qui, donc, sont censées fournir une solution à la question posée.
Pour demander par exemple des éclaircissements ou des précisions sur la question ou sur une de ses réponses, veillez à utiliser les commentaires en cliquant sur le lien « ajouter un commentaire » sous la question ou la réponse correspondante.

Qu'est-ce que ces « `@⟨nom⟩` » qui introduisent les commentaires et pourquoi devrais-je y recourir ?

La mention « @⟨nom⟩ » indique le ⟨nom⟩ (et est un lien menant au profil) de la personne à qui s'adresse le commentaire : « @ » signifie « at » soit « à ».

Elle présente plusieurs avantages :

si des commentaires de plusieurs personnes précèdent le vôtre, on sait ainsi à qui vous répondez ;
la personne à qui vous vous adressez pourra être notifiée de la publication de votre commentaire (selon la configuration qu'elle aura choisie pour ses notifications par courriel).

Pour faire figurer ce type de mention, saisissez simplement « @ » suivi (immédiatement) du nom qui apparaît en signature du commentaire auquel vous voulez répondre.

Puis-je faire figurer du code dans mes commentaires ?

Bien que cela relève davantage de la forme que du fond, nous signalons ici que les « codes « hors texte » » sont à proscrire dans les commentaires (cf. la question « Une contribution est indiquée comme agrémentée d'un certain nombre de commentaires mais tous ne sont pas visibles. Pourquoi ? »).

Forme des contributions

Veillez à vous assurer de la lisibilité de vos contributions (questions, réponses et commentaires).

Comment mettre en forme ma contribution ?

Titre : prière de placer une capitale initiale au premier mot du titre.
Questions ou réponses : dans les zones dédiées aux questions ou réponses, une mise en forme basique du texte est possible, et facilitée par des raccourcis claviers et boutons :
- gras :
  - raccourci : Ctrl+b
  - syntaxe : **gras**
- mise en exergue (italique) :
  - raccourci : Ctrl+i
  - syntaxe : *italique*
- bloc de citation :
  - raccourci : Ctrl+q
  - syntaxe : > citation
- liens :
  - raccourci : Ctrl+l
  - syntaxe : cf. http://daringfireball.net/projects/markdown/syntax#link
- code sous forme :
  - soit « en ligne » c.-à-d. sous la forme d'un court extrait à l'intérieur d'un paragraphe de texte :
    - raccourci : Ctrl+k
    - syntaxe : `code`
  - soit « hors texte » c.-à-d. sous la forme de bloc détaché des paragraphes pour afficher le source d'un fichier .tex ou autre (attention, les codes « hors texte » sont à proscrire dans les commentaires) : le code doit être préalablement (1) saisi (ou copié-collé), (2) séparé du reste par une ligne vide avant et une ligne vide après, (3) sélectionné, puis :
    - raccourci : Ctrl+k
    - syntaxe : laisser 4 espaces en début de chaque ligne (8 espaces si le code se trouve dans un item de liste)
- image (en cas de problème, cf. cette question) :
  - raccourci : Ctrl+g
  - syntaxe : cf. http://daringfireball.net/projects/markdown/syntax#img
- liste numérotée (ordered) :
  - raccourci : Ctrl+o
  - syntaxe : cf. http://daringfireball.net/projects/markdown/syntax#list
- liste non numérotée (unordered) :
  - raccourci : Ctrl+u
  - syntaxe : cf. http://daringfireball.net/projects/markdown/syntax#list
- section/sous-section (non numérotées) :
  - raccourci : Ctrl+h
  - syntaxe :
    - # section
    - ## sous-section
- filet horizontal :
  - raccourci : Ctrl+r
  - syntaxe : ---
Commentaires : dans les zones de texte dédiées aux commentaires, les boutons et raccourcis ne sont pas disponibles mais il est toujours possible de mettre en forme soi-même au moyen de la syntaxe indiquée ci-dessus. Attention : les codes « hors texte » sont à proscrire dans les commentaires (cf. cette question)

Dans tous les cas, il est possible d'annuler et de rétablir ce qui vient d'être fait au moyen des raccourcis :

annulation : Ctrl+z
rétablissement : Ctrl+Shift+z

Comment insérer le (un extrait de) code d'un fichier `.tex` (ou autre) ?

Pour insérer le code d'un fichier .tex (ou autre) dans une zone de texte dédiée aux questions ou réponses, il suffit de :

Laisser une ligne vide.
Coller le code préalablement copié.
Sélectionner toutes les lignes de ce code.
Saisir le raccourci Ctrl+k ou cliquer sur le bouton de code (« Code Sample… »).
Laisser une ligne vide après le code (sauf en fin de contribution).

Dans un paragraphe de texte, comment faire ressortir une commande (La)TeX ou le nom d'un package ?

Il suffit de les afficher en tant qu'extrait de code. Pour cela, recourir au raccourci Ctrl+k ou cliquer sur le bouton de code (« Code Sample… »), ce qui est à faire ressortir étant saisi :

soit après ;
soit avant, mais alors étant préalablement sélectionné.

Dans une liste, comment ajouter un nouvel item et comment en sortir ?

Dans une liste :

un nouvel item est introduit par un retour chariot ;
la sortie se fait au moyen de deux retours chariot consécutifs.

Comment faire figurer une image du fichier `.pdf` (ou `.dvi`) que j'obtiens pour que les autres voient immédiatement le problème que je rencontre ou la solution que je propose ?

Il suffit de générer une image .png du .pdf (ou .dvi) obtenu.

Pour cela, un moyen consiste à recourir à la classe standalone avec les options convert et varwith, et à compiler le fichier .tex avec l'option -shell-escape. Par exemple, le fichier (disons test.tex) suivant :

\documentclass[convert,varwidth]{standalone}
\usepackage[multiple]{footmisc}
\begin{document}
Foo\footnote{Blah}\footnote{Bleh}\footnote{Blih}

Foo\textsuperscript{1,2,3}
\end{document}

compilé avec pdflatex lancé avec l'option -shell-escape, génère le fichier test.png suivant :

Attention ! La classe standalone avec l'option convert ne doit pas être employée avec le package geometry.

Au cas où cette méthode échoue (ou ne soit pas adaptée en raison de l'avertissement ci-dessus), d'autres possibilités existent.

Divers

Une contribution (question, réponse et commentaire) me paraît (in)utile. Puis-je le faire savoir ?

Oui mais en évitant de le formuler, sauf s'il vous paraît important d'en expliquer la raison. En général, il suffit de :

voter (choix réversibles à tout moment en cliquant à nouveau sur les icônes) :
1. pour les différentes questions et réponses, positivement : → ou négativement → ;
2. pour les commentaires qui vous semblent utiles (positivement : → ) ;
accepter une réponse si elle fournit la (meilleure) solution à une question.

À part lire ou poster des questions, réponses et commentaires, que puis-je faire ici ?

Une fois connecté, vous pouvez participer à la vie de ce site en :

votant pour les différentes contributions ;
aidant les novices à mieux l'utiliser, notamment par le biais de commentaires pour expliquer par exemple :
- comment mieux poser les questions ;
- qu'il ne faut pas confondre réponses et commentaires ;
- qu'il faut penser :
  - à accepter une réponse si elle est satisfaisante ;
  - à voter pour les questions ou réponses, y compris celles postées par d'autres ;
modérant les contributions (si vous avez acquis suffisamment de points pour cela), les différentes actions de modération étant listées ici.

Je voudrais tester un ECM illustrant une question ou une réponse mais (La)TeX n'est pas installé sur la machine que j'utilise actuellement. Que puis-je faire ?

Il suffit de cliquer sur le lien « Ouvrir dans l'éditeur » situé juste au-dessus de cet ECM : son code source sera alors ouvert puis automatiquement compilé et le PDF correspondant affiché sur le Overleaf. Ce site permet notamment l'édition (éventuellement collaborative) et la compilation en ligne de fichiers LaTeX.

Que signifie le taux d'acceptation figurant à côté des noms d'utilisateurs ?

Pour un utilisateur donné, ce taux indique, parmi toutes les réponses qu'il a proposées, le pourcentage de celles acceptées par les auteurs des questions. Ce chiffre peut être un peu biaisé puisque certains auteurs de questions omettent d'accepter les réponses qu'on leur fournit.

Que signifient les losanges figurant à côté de certains noms d'utilisateurs ?

Ces losanges (ou « diamants ») indiquent :

un membre de l'équipe s'ils sont uniques (♦) ;
un administrateur s'ils sont doubles (♦♦).

Que signifient les différents codes couleurs du site ?

Sur la page d'accueil, les boîtes contenant le nombre de réponses figurant en regard des questions ont leurs fonds colorés en :
1. rose s'il n'y a encore aucune réponse ;
2. bleu s'il y a au moins une réponse mais dont aucune n'a été acceptée par l'auteur de la question ;
3. vert s'il y a au moins une réponse dont une a été acceptée par l'auteur de la question.
Sur la page d'une question, le fond d'une réponse est coloré en :
1. vert si elle a été acceptée par l'auteur de la question ;
2. bleu si son auteur est aussi l'auteur de la question.

Problèmes

J'ai inséré une image mais elle est trop large. Comment ajuster sa taille ?

Si une image est insérée comme indiqué à la question « Comment mettre en forme ma contribution ? », il se peut qu'elle déborde en largeur. Dans ce cas, il faut l'insérer en recourant à l'instruction HTML :

<img src="/upfiles/⟨fichier⟩.png" style="width: 100%;"/>

où ⟨fichier⟩ est le nom du fichier image utilisé.

Une contribution est indiquée comme agrémentée d'un certain nombre de commentaires mais tous ne sont pas visibles. Pourquoi ?

Ce problème est un bogue du logiciel, OSQA, utilisé pour ce site de questions et réponses. Il se produit lorsqu'un contributeur insère dans un commentaire du code « hors texte » : tous les commentaires suivants sont alors invisibles. En attendant que ce bogue soit réglé (compétences et bonnes volontés bienvenues !), il est demandé aux contributeurs de proscrire les codes « hors texte » dans leurs commentaires.

J'ai ajouté un nouveau commentaire mais il reste invisible. Pourquoi ?

Cf. la question « Une contribution est indiquée comme agrémentée d'un certain nombre de commentaires mais tous ne sont pas visibles. Pourquoi ? »

Files

faq.md

Latest commit

History