À 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 (cf. ci-dessous) permet aux utilisateurs d’acquérir certaines compétences de modération.

Pourquoi d’autres personnes peuvent-elles modifier mes 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 de remanier les contributions des autres. Ainsi, les visiteurs trouveront ici beaucoup de questions bien posées et des réponses clairement formulées.

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|
Supprimer les commentaires → |REP_TO_DELETE_COMMENTS|
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.

Fonds des contributions

En général

Comment rendre mes contributions aussi utiles que possible ?

Soyez clair, précis, concis. En particulier, évitez :
- les formules de politesse (« Bonjour », « Merci. », etc.) ou marques d’opinion (« +1 », etc.) qui ne sont en rien utiles et ont tendance à rendre moins lisible, voire brouillent, ce que d’autres personnes chercheront ici : des solutions (et seulement des solutions) optimales à des questions concernant (La)TeX ;
- les signatures qui sont redondantes : votre nom est automatiquement affiché en dessous de votre contribution.
Si possible, illustrez vos questions et réponses d’un ou plusieurs ECM… voire d’images illustrant ces ECM.
N’hésitez pas à éditer vos contributions pour les peaufiner en cliquant sur :
- le lien « éditer » pour les questions et réponses ;
- l’icône pour les commentaires.

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.

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.

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) ;
- définitions de macros personnelles ;
- texte ;
- etc.

Que ce soit ici ou sur tout autre lieu d’entraide à LaTeX, il est important d’accompagner la question qu’on pose d’un ECM. Ainsi, vous aidez ceux qui veulent vous aider en leur permettant de :

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

Il est donc important de fournir un ECM car, ainsi :

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 difficile (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.

N’oubliez pas : « Aide-toi, texnique.fr t’aidera. » :-)

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 plus développée ou 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 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 (plus de détails ici).
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 l’éditer pour la préciser ou de la rendre plus parlante en y ajoutant un ECM, voire une image illustrant ce que lui obtient.

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.

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 de la contribution à laquelle vous voulez répondre.

Forme des contributions

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

Comment mettre en forme ma contribution ?

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 : <kbd>Ctrl</kbd>+<kbd>b</kbd>
  - syntaxe : **gras**
- mise en exergue (italique) :
  - raccourci : <kbd>Ctrl</kbd>+<kbd>i</kbd>
  - syntaxe : *italique*
- bloc de citation :
  - raccourci : <kbd>Ctrl</kbd>+<kbd>q</kbd>
  - syntaxe : > citation
- liens :
  - raccourci : <kbd>Ctrl</kbd>+<kbd>l</kbd>
  - syntaxe : cf. http://daringfireball.net/projects/markdown/syntax#link
- code sous forme soit « en ligne » (court extrait à l’intérieur d’un paragraphe de texte), soit « hors texte » (bloc détaché des paragraphes pour afficher le source d’un fichier .tex ou autre) :
  - raccourci : <kbd>Ctrl</kbd>+<kbd>k</kbd>
  - syntaxe :
    - code en ligne : `code`
    - code hors texte : laisser 4 espaces en début de chaque ligne
- image :
  - raccourci : <kbd>Ctrl</kbd>+<kbd>g</kbd>
  - syntaxe : cf. http://daringfireball.net/projects/markdown/syntax#img
- liste numérotée :
  - raccourci : <kbd>Ctrl</kbd>+<kbd>o</kbd>
  - syntaxe : cf. http://daringfireball.net/projects/markdown/syntax#list
- liste non numérotée :
  - raccourci : <kbd>Ctrl</kbd>+<kbd>u</kbd>
  - syntaxe : cf. http://daringfireball.net/projects/markdown/syntax#list
- section/sous-section (non numérotées) :
  - raccourci : <kbd>Ctrl</kbd>+<kbd>h</kbd>
  - syntaxe :
    - # section
    - ## sous-section
- filet horizontal :
  - raccourci : <kbd>Ctrl</kbd>+<kbd>r</kbd>
  - 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.

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

annulation : <kbd>Ctrl</kbd>+<kbd>z</kbd>
rétablissement : <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>z</kbd>

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 ce code.
Saisir le raccourci <kbd>Ctrl</kbd>+<kbd>k</kbd> 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 <kbd>Ctrl</kbd>+<kbd>k</kbd> 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 l’option convert et de compiler le fichier .tex avec l’option -shell-escape. Par exemple, le fichier (disons test.tex) suivant :

\documentclass[convert]{standalone}
\begin{document}
    \begin{tabular}{|*{3}{p{.5cm}|}}
        \multicolumn{1}{c}{A} & \multicolumn{1}{c}{EA} & \multicolumn{1}{c}{NA} \\\hline
                              &                        &                        \\\hline
    \end{tabular}
\end{document}

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

Attention ! deux points sont à noter. La classe standalone avec l’option convert :

ne doit pas être employée avec le package geometry ;
est actuellement sujette à un bogue qui la rend incompatible avec le package babel.

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

Divers

À 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 questions et réponses positivement : → ou négativement → , choix réversibles à tout moment en cliquant à nouveau sur ces icônes ;
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 ;
le modérant (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 ma machine. Que puis-je faire ?

Il suffit de cliquer sur le lien « Ouvrir dans l’éditeur » situé juste au-dessus de cet ECM. Il sera alors ouvert et compilé sur le site Overleaf qui permet notamment l’édition (éventuellement collaborative) et la compilation en ligne de fichiers LaTeX.

Files

faq.org

Latest commit

History