diff options
author | Patrick Bideault <pathe@UNKNOWN> | 2017-05-13 19:24:48 +0000 |
---|---|---|
committer | Patrick Bideault <pathe@UNKNOWN> | 2017-05-13 19:24:48 +0000 |
commit | 066de7ea29fb7cfeec3e1be440efb873a557b484 (patch) | |
tree | 628df8f465f1f725bbaa8a555e054c8c3ae2b559 | |
parent | cc91c0524d972a35a121437641b210f64aa5a683 (diff) |
texlive-fr update (section Getting Help)
git-svn-id: svn://tug.org/texlive/trunk@44315 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r-- | Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.pdf | bin | 923395 -> 740974 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.tex | 185 |
2 files changed, 145 insertions, 40 deletions
diff --git a/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.pdf b/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.pdf Binary files differindex ad92047a0f2..27144c8a36f 100644 --- a/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.pdf +++ b/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.pdf diff --git a/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.tex b/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.tex index 3bb9d2faa35..e60716a42ab 100644 --- a/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.tex +++ b/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.tex @@ -6,6 +6,7 @@ % % Change history (started May 18th 2002) +% 2017/05/13: synced with 2017 English version, by Denis Bitouzé & Patrick Bideault % 2016/05/08: synced with 2016 English version, by Denis Bitouzé % 2015/05/17: synced with 2014/2015 English version, by Denis Bitouzé % 2009/09/21: synced with 2009 English version, by Manuel Pégourié-Gonnard @@ -18,7 +19,7 @@ % 2002/05/25: proof-reading and corrections, by Daniel Flipo % 2002/05/18: synced with English version, by Fabrice -\documentclass[english, french]{article} +\documentclass[german, english, french]{article} \usepackage[utf8]{inputenc} \usepackage[T1]{fontenc} @@ -54,6 +55,7 @@ % plus de macros (mpg) \newcommand\eng[1]{\foreignlanguage{english}{\emph{#1}}} +\newcommand\ger[1]{\foreignlanguage{german}{\emph{#1}}} \newcommand*\semail[1]{\href{mailto:#1}{#1}} \setlength{\parindent}{0mm} @@ -205,17 +207,104 @@ compiler les documents inconnus dans un répertoire nouvellement créé. \subsection{Obtenir de l'aide} \label{sec:help} - -La communauté \TeX{} est active et conviviale ; la plupart des questions +\subsubsection{De l'aide en français} +Au cas où vous ne disposeriez pas d'une distribution \TL{} fonctionnelle, +vous pouvez avoir un aperçu du fonctionnement de l'un de ses logiciels, \LaTeXe{}, +en lisant la \emph{Une courte (?) introduction à \LaTeXe{}}, +dont la traduction française est disponible à l'adresse +\url{http://mirrors.ctan.org/info/lshort/french/lshort-fr.pdf}. + +Si votre distribution \TL{} est fonctionnelle, la commande\footnote{Sur systèmes Mac, +il faut utiliser l'application « Terminal » pour avoir accès à l'émulateur de commandes. +Sur systèmes Windows, il faut taper \code{Win-R} puis \code{cmd}. +Sur systèmes de type Unix, il est vraisemblable que vous sachiez +comment utiliser cette commande.} \code{texdoc} vous permettra d'afficher +la documentation des différents composants de \TL{}. + +Ainsi, pour lire la \emph{Courte Introduction} citée plus haut, +vous n'aurez qu'à taper \code{texdoc lshort-fr} (vous remarquerez +que la chaîne de caractères \code{lshort-fr} est également présente +dans l'url citée plus haut : c'est son nom au sein de \TL{}). + +En toute logique, la commande \code{texdoc texdoc} vous indiquera +comment vous servir au mieux de cette commande, par exemple +pour qu'elle utilise votre lecteur pdf favori, +ou pour qu'elle affiche automatiquement les documentations, +en français si celles-ci existent. + +Car voilà : l'intégralité de la documentation +des innombrables composants de \TL{} n'est pas encore traduite +en français, loin s'en faut. + +Fort heureusement, des ressources francophones de qualité existent. +La documentation de \LaTeXe est traduite : elle est accessible via la commande \code{texdoc latex2e-fr}. Une communauté d'utilisateurs a recensé d'autres ressources à l'adresse suivante : \url{http://texnique.fr/osqa/questions/2559/des-sources-dinformation-pour-debutants}. + +En effet, la communauté \TeX{} est active et conviviale ; la plupart des questions finissent par obtenir une réponse. Par contre, le support est informel, assuré par des volontaires et des lecteurs occasionnels, aussi est-il particulièrement important que vous fassiez votre propre travail de recherche avant de poser une question (si vous préférez un support commercial, vous -pouvez renoncer à \TL{} et acheter un système payant ; voir une liste à +pouvez renoncer à \TL{} et acheter un système payant ; voir une liste, en anglais, à \url{http://tug.org/interest.html#vendors}). -Voici une liste de ressources, classées selon l'ordre dans lequel nous -recommandons de les utiliser : +Avant de poser une question à d'autres utilisateurs, +nous vous invitons à vérifier qu'elle n'a pas déjà été posée : +un moteur de recherche peut à lui seul fournir des réponses pertinentes, +et les archives des différents espaces de discussion contiennent des +milliers de questions et réponses déjà traitées ; elles permettent +une recherche fructueuse. + +Enfin, avant de poser une question, n'hésitez pas à prendre conseil +sur la façon de rédiger la question pour +avoir des chances d'obtenir une réponse pertinente. +Soyez clair, précis et concis. Et illustrez votre propos +avec un exemple complet minimal, comme indiqué ici : +\url{http://texnique.fr/osqa/faq/#custom-id-ecm}. + +Ces précautions étant prises, il est temps de vous présenter les trois espaces +de discussion en ligne des utilisateurs francophones. + +\begin{description} + \item [texnique.fr] est un site de questions \& réponses. + D'utilisation très simple, il permet aux utilisateurs + ayant besoin d'aide de poser des questions, + à d'autres de leur apporter des réponses, et aux visiteurs du site + de noter celles-ci selon leur pertinence, + ce qui permet de les repérer efficacement. + Les questions sont triées par mots-clés, + et le site offre la compilation en ligne + des exemples de code qui y sont postés. + Il est accessible à l'adresse \url{http://texnique.fr}. + + \item[la liste GUT] est une liste de discussion par courriel, + dotée d'un grand nombre d'abonnés. + Elle permet de demander ou d'apporter de l'aide, + mais aussi de débattre ou d'exprimer des opinions, + ce qui n'est pas l'objet du site cité plus haut. + Pour vous inscrire à cette liste, envoyez un message + à \email{sympa@ens.fr} avec \code{subscribe gut} + comme corps ou sujet du message. + + \item[FCTT] est l'appellation usuelle du groupe + de nouvelles Usenet \code{fr.comp.text.tex}. + Très fréquenté, il est accessible à l'adresse + \url{news:fr.comp.text.tex} et ses archives + sont à cette adresse : + \url{http://groups.google.com/groups?group=fr.comp.text.tex}. +\end{description} +Il est à noter que le site \dirname{texnique.fr} et la liste GUT +sont soutenus par l'association GUTenberg, +qui est le groupe francophone des utilisateurs de \TeX{}, \LaTeX{} +et logiciels compagnons. Le site de l'association +est accessible ici : \url{https://www.gutenberg.eu.org/}. +Les traducteurs de la présente documentation sont également +membres de l'association, qui elle-même contribue au développement +de \TL{}. + +\subsubsection{De l'aide en anglais} +Donald Knuth, l'auteur de \TeX, est anglophone : il est donc logique +qu'une large documentation existe en anglais. Voici une liste +de ressources anglophones, classées selon l'ordre dans lequel nous recommandons de les utiliser : \begin{description} \item [Getting Started] -- pour ceux qui débutent en \TeX, la page web @@ -239,34 +328,36 @@ du système. beaucoup de liens relatifs à \TeX{}, en particulier concernant des livres, manuels et articles portant sur tous les aspects du système. -\item [Archives des forums d'aide] -- les principaux forums dédiés - au support de \TeX{} sont les groupes de nouvelles Usenet - \url{news:comp.text.tex} (en anglais) et \url{news:fr.comp.text.tex} - (en français) ainsi que les listes de diffusion - \email{texhax@tug.org} (en anglais) et \email{gut@ens.fr} (en français) et - le site de questions/réponses \url{http://tex.stackexchange.com} (en anglais - uniquement). - Les archives correspondantes contiennent des - milliers de questions et réponses déjà traitées et permettent - une recherche fructueuse. Voir - \url{http://groups.google.com/groups?group=fr.comp.text.tex} - et \url{http://tug.org/mail-archives/texhax}, respectivement. Une - question posée sur un moteur de recherche, tel que - \url{http://google.com}, peut aussi fournir des réponses pertinentes. - -\item [Poster une question] -- si vous ne trouvez pas de réponse, vous pouvez - poser la question (en français) sur \dirname{fr.comp.text.tex} via Google ou - votre lecteur de nouvelles, ou encore par messagerie à - \email{gut@ens.fr} (sur inscription). - Mais avant de le faire, merci de lire l'introduction de la - FAQ donnant les conseils sur la façon de rédiger la question pour - avoir des chances d'obtenir une réponse pertinente : - \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion}. Pour de - l'aide en anglais, vous pouvez également vous tourner vers le site \LaTeX{} - Community : \url{http://www.latex-community.org/} et son forum - \url{http://www.latex-community.org/forum/}, ainsi que le site \TeX\ - StackExchange à \url{http://tex.stackexchange.com/}. +\item [Forums d'aide] -- les principaux forums dédiés + au support de \TeX{} sont le groupe de nouvelles Usenet + \url{news:comp.text.tex}, + la liste de diffusion + \email{texhax@tug.org} + (dont les archives sont à l'adresse + \url{http://tug.org/mail-archives/texhax}), + le site de questions/réponses \url{http://tex.stackexchange.com}, + et le forum du site \LaTeX{} Community : + \url{http://www.latex-community.org/forum/}. + +\item [Poster une question] -- d'utiles conseils pour poser une question + avec efficacité sont disponibles ici : + \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion}. + +\end{description} + +Enfin, l'organisation internationale des utilisateurs de \TeX, le \eng{\TeX{} Users Group}, ou TUG, est anglophone. Elle est basée aux États-Unis, et son site est à l'adresse \url{http://tug.org/}. Parmi ses très nombreuses activités, elle organise une conférence annuelle, publie une revue, le \emph{TUGboat}, ainsi que\dots{} \TL{} ! + +\subsubsection{De l'aide en allemand} +La communauté germanophone est très active. Elle organise des tables rondes, des rencontres, publie des ouvrages de grande qualité\dots{} et a produit de très nombreuses lignes de code utilisées par \TL{} ! Le groupe germanophone des utilisateurs de \TeX s'appelle \textsc{dante} et son site est à l'adresse \url{http://www.dante.de}. Il publie régulièrement une revue, \emph{Die TeXnische Komödie}, et soutient le forum \dirname{golatex.de} (\url{http://golatex.de/}). + +Enfin, le site germanophone de questions \& réponses \code{texwelt.de} (\url{http://texwelt.de}) est le grand frère de \dirname{texnique.fr} ! +\subsubsection{De l'aide dans d'autres langues} +\TeX est répandu dans le monde entier, et des groupes d'utilisateurs existent dans de nombreux pays, de la Bulgarie à l'Afrique du Sud ! On en trouvera la liste ici : \url{http://tug.org/usergroups.html}. + +\subsubsection{Apporter de l'aide} +Il vous est possible d'apporter une aide précieuse à la communauté : +\begin{description} \item [Support de \TL{}] -- si vous voulez faire un rapport d'anomalie, émettre des suggestions ou des commentaires sur la distribution \TL{}, son installation ou sa documentation, utilisez @@ -277,15 +368,29 @@ du système. souvent d'ajouter l'option \code{-{}-help} lors de l'exécution du programme pour trouver à qui adresser le rapport. +\item [Aide en ligne] -- des personnes soumettent des questions, et + leur répondre est très utile, tant pour eux que pour vous : + formuler clairement une réponse est une source d'apprentissage + non négligeable ! + Les sites \LaTeX{}, tels \dirname{texnique.fr}, + les groupes de nouvelles comme + \dirname{fr.comp.text.tex} ainsi que la liste \code{gut} + sont ouverts à tous : n'hésitez pas à vous y joindre, + à commencer la lecture et à fournir de l'aide + là où cela vous est possible. + +\item [Traduction] -- le présent document a été rédigé puis traduit bénévolement, + pour le bien de la communauté. Il en va de même pour l'essentiel + des logiciels et de leur documentation. Comme la rédaction de réponses, + la traduction est un exercice très profitable en terme d'apprentissage. + Si la documentation qui vous est nécessaire n'est pas encore traduite, + n'hésitez pas à la faire vous-même et à en faire profiter les autres utilisateurs ! + Les coordonnées des auteurs des logiciels figurent généralement + dans la documentation originale de ceux-ci ; dès lors, + il est très simple de prendre contact avec eux pour publier + votre traduction. \end{description} -L'autre aspect du sujet concerne l'aide à apporter aux personnes -soumettant des questions. Les forums \dirname{comp.text.tex}, -\dirname{fr.comp.text.tex} ainsi que les listes de diffusion \code{texhax} -et \code{gut} -sont ouverts à tous, aussi n'hésitez pas à vous y joindre, à commencer -la lecture et à fournir de l'aide là où cela vous est possible. - % No \protect needed as \TL is defined in French with \newcommand (robust). \section{Structure de \protect\TK} \label{sec:overview-tl} |