#LyX 1.6.8svn created this file. For more info see http://www.lyx.org/ \lyxformat 345 \begin_document \begin_header \textclass article \begin_preamble % DO NOT ALTER THIS PREAMBLE!!! % %This preamble is designed to ensure that the document prints % out as advertised. If you mess with this preamble, % parts of the document may not print out as expected. If you % have problems LaTeXing this file, please contact % the documentation team % email: lyx-docs@lists.lyx.org \usepackage{ifpdf} % part of the hyperref bundle \ifpdf % if pdflatex is used % set fonts for nicer pdf view \IfFileExists{lmodern.sty}{\usepackage{lmodern}}{} \fi % end if pdflatex is used % the pages of the TOC is numbered roman % and a pdf-bookmark for the TOC is added \pagenumbering{roman} \let\myTOC\tableofcontents \renewcommand\tableofcontents{% \pdfbookmark[1]{\contentsname}{} \myTOC \cleardoublepage \pagenumbering{arabic} } % redefine the \LyX macro for PDF bookmarks \def\LyX{\texorpdfstring{% L\kern-.1667em\lower.25em\hbox{Y}\kern-.125emX\@} {LyX}} \end_preamble \use_default_options false \language french \inputencoding auto \font_roman default \font_sans default \font_typewriter default \font_default_family default \font_sc false \font_osf false \font_sf_scale 100 \font_tt_scale 100 \graphics default \paperfontsize 12 \spacing single \use_hyperref true \pdf_title "Introduction à LyX" \pdf_author "L'équipe LyX, Traduction: Adrien Rebollo et Siegfried Meunier-Guttin-Cluzel" \pdf_subject "Documentation Introduction" \pdf_keywords "LyX, documentation" \pdf_bookmarks true \pdf_bookmarksnumbered true \pdf_bookmarksopen true \pdf_bookmarksopenlevel 2 \pdf_breaklinks false \pdf_pdfborder false \pdf_colorlinks true \pdf_backref false \pdf_pdfusetitle false \pdf_quoted_options "linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue, pdfpagelayout=OneColumn, pdfnewwindow=true, pdfstartview=XYZ, plainpages=false" \papersize a4paper \use_geometry false \use_amsmath 1 \use_esint 0 \cite_engine basic \use_bibtopic false \paperorientation portrait \secnumdepth 3 \tocdepth 2 \paragraph_separation indent \defskip medskip \quotes_language french \papercolumns 1 \papersides 2 \paperpagestyle default \tracking_changes false \output_changes false \author "" \author "" \end_header \begin_body \begin_layout Title Introduction à LyX \end_layout \begin_layout Author par l'Équipe LyX \begin_inset Foot status collapsed \begin_layout Plain Layout Merci d'envoyer vos commentaires et corrections à la liste de diffusion de la documentation de LyX, \begin_inset CommandInset href LatexCommand href target "lyx-docs@lists.lyx.org" type "mailto:" \end_inset ou à la liste de diffusion de LyX en français \begin_inset CommandInset href LatexCommand href target "lyx-fr@lists.lyx.org" type "mailto:" \end_inset . \begin_inset Newline newline \end_inset Traduction en français par : P.-H. \noun on Boinnard \noun default , M. \noun on Boinnard \noun default , Jean-Pierre \noun on Chrétien \noun default , Jean-Marc \noun on Lasgouttes \noun default , Siegfried \noun on Meunier-Guttin-Cluzel \noun default , Adrien \noun on Rebollo \noun default et Denis \noun on Valdenaire \noun default . \end_layout \end_inset \begin_inset Newline newline \end_inset \end_layout \begin_layout Standard \begin_inset CommandInset toc LatexCommand tableofcontents \end_inset \end_layout \begin_layout Section La philosophie de LyX \end_layout \begin_layout Subsection Qu'est-ce que LyX ? \end_layout \begin_layout Standard LyX est un système de préparation de documents. Il est excellent si vous voulez écrire des articles scientifiques et techniques complexes avec des mathématiques, des références croisées, des bibliographies, des index, etc\SpecialChar \ldots{} Il est très bon pour tous les documents de toutes tailles pour lesquels sont requises les fonctions habituelles d'un traitement de texte : numérotation des sections et pagination automatiques, correction orthographique, et ainsi de suite. Il peut aussi servir à écrire une lettre à votre maman, même si je vous accorde qu'il existe sans doute des programmes plus simples pour ça. Il n'est certainement pas le meilleur outil pour créer des affiches, tracts ou publicités (nous expliquerons pourquoi plus tard), bien qu'avec quelque effort vous puissiez faire tout cela aussi. Quelques exemples de ce à quoi il peut servir : des rapports, des lettres, des dissertations et des thèses, des notes de conférence, des cahiers de séminaire, des actes de conférence, de la documentation de logiciel, des livres (sur PostgreSQL, les capteurs à distance, la cryptologie, des romans, de la poésie, et même un ou deux livres pour enfants), des articles dans des publications scientifiques, des scripts pour des pièces de théâtre ou des films, des propositions de contrats\SpecialChar \ldots{} vous voyez le genre. \end_layout \begin_layout Standard LyX est un programme qui offre une approche moderne de l'écriture de documents par ordinateur, inspirée des langages à balises, une approche qui rompt avec la tradition périmée héritée de la machine à écrire. Il est destiné aux auteurs qui veulent obtenir rapidement un rendu professionne l avec le minimum d'effort sans devenir des spécialistes en typographie. Le travail de typographie sera pris en charge en majorité par l'ordinateur, non par l'auteur ; avec LyX, l'auteur peut se concentrer sur le contenu de ce qu'il écrit. \end_layout \begin_layout Standard Pour faire le choix d'utiliser LyX, il faut avant tout changer d'état d'esprit. À une époque, pour créer des documents il n'y avait que les machines à écrire, et nous avons donc tous appris certains trucs pour contourner leurs limitations. Souligner, qui n'était rien d'autre que repasser sur le texte avec des caractères \begin_inset Quotes fld \end_inset _ \begin_inset Quotes frd \end_inset , est devenu un moyen de mettre du texte en valeur. Pour créer une table, il fallait évaluer au préalable la largeur des colonnes et mettre en place les tabulations adaptées. C'était la même chose pour écrire des lettres et tous les textes justifiés à droite. Les césures nécessitaient un oeil \begin_inset Foot status collapsed \begin_layout Plain Layout NdT : Pour conserver une bonne lisibilité dans la fenêtre LyX, l'o e dans l'o a volontairement été évité. Il faut savoir qu'il s'écrit \begin_inset ERT status collapsed \begin_layout Plain Layout \backslash oe{} \end_layout \end_inset , c'est-à-dire \backslash oe{} en mode TeX. Consultez la section \emph on LyX et la typographie française \emph default du \emph on Manuel \begin_inset space ~ \end_inset d'Apprentissage \emph default . \end_layout \end_inset exercé et beaucoup de prévoyance. \end_layout \begin_layout Standard En d'autres termes, nous avons tous été habitués à nous soucier de l'emplacement précis de chaque caractère. La plupart des traitements de texte ont par conséquent conservé la même approche. Ils utilisent encore les tabulations pour ajouter de l'espace. Vous avez encore à vous soucier de la place exacte qu'occupera tel ou tel élément dans la page. Mettre en évidence un texte se fait en changeant de police, ce qui revient à changer la roue de la machine à écrire. C'est la philosophie correspondant aux traitements de texte WYSIWYG : \begin_inset Quotes fld \end_inset What You See Is What You Get \begin_inset Quotes frd \end_inset \begin_inset Foot status collapsed \begin_layout Plain Layout NdT : \begin_inset Quotes fld \end_inset Vous voyez ce que vous obtenez. \begin_inset Quotes frd \end_inset \end_layout \end_inset . Malheureusement, ce paradigme devient souvent \begin_inset Quotes fld \end_inset What You See Is All You Get \begin_inset Quotes frd \end_inset \begin_inset Foot status collapsed \begin_layout Plain Layout NdT : \begin_inset Quotes fld \end_inset Vous n'obtenez que ce que vous voyez. \begin_inset Quotes frd \end_inset \end_layout \end_inset . \end_layout \begin_layout Standard C'est là-dessus que LyX diffère d'un traitement de texte ordinaire. Vous ne vous souciez pas de savoir où sera placé tel ou tel caractère. Vous dites à LyX \shape slanted ce que vous voulez faire \shape default et LyX se charge du reste, appliquant un ensemble de règles appelé un \emph on style \emph default \begin_inset Foot status collapsed \begin_layout Plain Layout Pour être honnête, la plupart des versions récentes des suites bureautiques les plus populaires ont aujourd'hui des sortes de feuilles de style qui présentent une approche semblable. Cependant, l'expérience montre qu'elles sont encore rarement utilisées en pratique. \end_layout \end_inset . Voyons un petit exemple : \end_layout \begin_layout Standard Supposons que vous tapez un rapport. Pour commencer, vous voulez une section appelée \begin_inset Quotes fld \end_inset Introduction \begin_inset Quotes frd \end_inset Vous allez dans le menu de votre traitement de texte qui vous permet de changer la taille de police et vous choisissez une nouvelle taille. Puis vous passez en caractères gras. Ensuite, vous tapez : \begin_inset Quotes fld \end_inset 1. \begin_inset space ~ \end_inset \begin_inset space ~ \end_inset Introduction \begin_inset Quotes frd \end_inset . Bien sûr, si vous décidez de déplacer cette section dans votre document, ou d'en insérer une autre avant, il vous faudra changer la numérotation de la section, ainsi que celle des suivantes, sans oublier les entrées de la table des matières. \end_layout \begin_layout Standard Avec LyX, vous allez sur le menu déroulant tout à fait à gauche de la barre d'outils, sélectionnez \family sans Section \family default , et tapez \begin_inset Quotes fld \end_inset Introduction \begin_inset Quotes frd \end_inset . \end_layout \begin_layout Standard Eh oui, c'est tout. Si vous coupez-collez la section, la numérotation sera automatiquement remise à jour – partout. Et si vous entrez correctement des références à cette section (en insérant des balises de références croisées), LyX les mettra à jour automatiquement tout au long du document, de sorte que vous n'aurez jamais à taper de numéro de section. \end_layout \begin_layout Standard Vient ensuite le problème de la cohérence. Cinq jours plus tard, vous ouvrez votre rapport et commencez la Section \begin_inset space ~ \end_inset 4. Malheureusement, vous avez oublié que vous utilisiez du 18 \begin_inset space \thinspace{} \end_inset pt gras à la place de 16 \begin_inset space \thinspace{} \end_inset pt, et vous tapez l'en-tête de la Section \begin_inset space ~ \end_inset 4 avec une police différente de celle de la Section \begin_inset space ~ \end_inset 1. Ce problème n'existe pas avec LyX. L'ordinateur prend soin de toute cette comptabilité stupide. Après tout, c'est bien le domaine de prédilection d'un ordinateur. \end_layout \begin_layout Standard Voici un autre exemple. Supposons que vous écriviez une liste. Avec d'autres traitements de texte, une liste est juste un ensemble de tabulations et de retours chariot. Vous devez décider où mettre le marqueur pour chaque élément de la liste, quel doit être ce marqueur, combien de lignes blanches mettre entre chaque élément, et ainsi de suite. Avec LyX, il n'y a que deux choses à savoir : de quel genre de liste il s'agit, et ce qu'il y a dedans. C'est tout. \end_layout \begin_layout Standard Ainsi, l'idée maîtresse avec LyX est la suivante : dites ce que vous faites, et non pas comment le faire. À la place de \begin_inset Quotes fld \end_inset What You See Is What You Get \begin_inset Foot status collapsed \begin_layout Plain Layout NdT : Vous voyez ce que vous obtenez. \end_layout \end_inset \begin_inset Quotes frd \end_inset , le modèle de LyX serait plutôt \begin_inset Quotes fld \end_inset What You See Is What You \emph on Mean \begin_inset Foot status collapsed \begin_layout Plain Layout NdT : Vous voyez ce que vous \emph on voulez dire. \end_layout \end_inset \emph default \begin_inset Quotes frd \end_inset ou \begin_inset Quotes fld \end_inset WYSIWYM \begin_inset Quotes frd \end_inset en abrégé. C'est une idée puissante qui simplifie grandement le processus d'écriture de documents. C'est aussi pour ça que LyX n'est pas très adapté pour créer des affiches et des tracts – dans ce cas, vous \emph on voulez \emph default définir exactement où va chaque chose, parce qu'il n'y a pas d'unités fonctionn elles comme des paragraphes, des sections, etc\SpecialChar \ldots{} Ça ne veut pas dire qu'il manque à LyX des fonctions utiles. Ça signifie simplement que ce n'est pas l'outil adapté – vous n'utilisez pas un tournevis pour enfoncer des clous (sauf si votre tournevis est garanti à vie). \end_layout \begin_layout Subsection Différences entre LyX et les autres traitements de texte \begin_inset OptArg status collapsed \begin_layout Plain Layout LyX et les autres traitements de texte \end_layout \end_inset \begin_inset Foot status collapsed \begin_layout Plain Layout Non, nous ne cherchons pas ici à déclarer (ou à gagner) la guerre sainte des traitements de texte. Mais nous pensons vraiment qu'il est important de décrire les possibilités de LyX. Et l'un de ses aspects les plus importants, le WYSIWYM, est un concept fondamentalement différent de ce que la plupart des gens pensent qu'est un traitement de texte. \end_layout \end_inset \end_layout \begin_layout Standard Voici une liste de choses que vous ne trouverez pas dans LyX : \end_layout \begin_layout Itemize une règle ; \end_layout \begin_layout Itemize des taquets de tabulation ; \end_layout \begin_layout Itemize des espaces superflues (c'est-à-dire taper \family sans Entrée \family default ou \family sans Espace \family default deux fois ou plus). \end_layout \begin_layout Standard Les taquets de tabulation, au même titre que la règle qui vous indique la position des éléments dans la page, n'ont aucune utilité avec LyX. Le programme s'occupe de placer les éléments dans la page, pas vous. Pour les espaces, c'est pareil ; LyX en ajoute quand c'est nécessaire, en fonction du contexte. Le fait de ne pas pouvoir taper deux lignes vides à la suite vous agacera au début, mais prendra tout son sens une fois que vous penserez en termes WYSIWYM. \end_layout \begin_layout Standard Voilà quelques notions qui existent avec LyX, mais ne sont pas utilisées comme vous pourriez le penser : \end_layout \begin_layout Itemize contrôle de l'indentation ; \end_layout \begin_layout Itemize sauts de page ; \end_layout \begin_layout Itemize interligne (simple, double, etc\SpecialChar \ldots{} ) ; \end_layout \begin_layout Itemize espacement, horizontal et vertical ; \end_layout \begin_layout Itemize polices et tailles de police ; \end_layout \begin_layout Itemize types de caractère (gras, italique, souligné, etc\SpecialChar \ldots{} ). \end_layout \begin_layout Standard Même si elles existent dans LyX, vous n'en aurez généralement pas besoin. LyX prendra en charge tout cela pour vous, en fonction de ce que vous écrivez. Les différentes parties du document sont automatiquement imprimées avec des types de caractères et des tailles de police différents. L'indentation dépend du contexte ; des paragraphes de types différents suivent des règles d'indentation différentes. Les sauts de page, eux aussi, sont gérés automatiquement. En général, l'interligne, l'espace entre les mots et entre les paragraphes est variable, et est défini par LyX \begin_inset Foot status collapsed \begin_layout Plain Layout Il y a des façons d'ajuster manuellement toutes ces propriétés (et seules quelques-unes nécessitent des connaissances en LaTeX), que ce soit pour l'ensemble du document ou seulement pour une partie. Référez-vous au \emph on Guide \begin_inset space ~ \end_inset de \begin_inset space ~ \end_inset l'Utilisateur \emph default et/ou aux \emph on Options \begin_inset space ~ \end_inset Avancées \emph default pour avoir des détails. \end_layout \end_inset . \end_layout \begin_layout Standard Enfin, il y a quelques domaines où nous pensons que LyX (et LaTeX) surpasse quantité d'autres traitements de texte : \end_layout \begin_layout Itemize césure ; \end_layout \begin_layout Itemize listes de tous types ; \end_layout \begin_layout Itemize mathématiques ; \end_layout \begin_layout Itemize tables ; \end_layout \begin_layout Itemize références croisées. \end_layout \begin_layout Standard D'accord, un certain nombre de traitements de texte modernes peuvent gérer les symboles mathématiques, les tableaux et les césures, et beaucoup ont adopté des définitions de style et ont évolué en direction du concept WYSIWYM. Cependant, ils ne le font que depuis peu, alors que LyX est construit sur le système de préparation de document LaTeX. LaTeX est là depuis plus de 20 ans, et \shape slanted fonctionne. \end_layout \begin_layout Subsection Qu'est-ce donc que LaTeX ? \end_layout \begin_layout Standard LaTeX est un système de préparation de document conçu par Leslie Lamport en 1985 \begin_inset Foot status collapsed \begin_layout Plain Layout La source des informations de cette section est \begin_inset Quotes fld \end_inset \emph on A Guide to LaTeX2e \emph default \begin_inset Quotes frd \end_inset , par Helmut Kopka et Patrick Daly, ouvrage inclus dans la bibliographie du \emph on Guide \begin_inset space ~ \end_inset de \begin_inset space ~ \end_inset l'Utilisateur \emph default \SpecialChar \@. \end_layout \end_inset . À son tour, il a été construit à partir d'un langage de composition appelé TeX, créé par Donald \noun on Knuth \noun default en 1984. TeX prend une séquence de commandes typographiques, écrites dans un script dans un fichier ASCII, et les exécute. La plupart des \begin_inset Quotes fld \end_inset trucs \begin_inset Quotes frd \end_inset du métier d'imprimeur ont été modélisés par \noun on Knuth \noun default sous la forme d'algorithmes informatiques et incorporés dans TeX, d'où son excellent rendu d'impression. Dans tous les cas, la sortie produite par TeX est le format de document portable \family typewriter pdf \family default ou le format de fichier \begin_inset Quotes fld \end_inset \emph on device independent \emph default \begin_inset Foot status collapsed \begin_layout Plain Layout NdT : \begin_inset Quotes fld \end_inset indépendant du périphérique \begin_inset Quotes frd \end_inset \end_layout \end_inset \begin_inset Quotes frd \end_inset , en abrégé \family typewriter dvi \family default . Vous pouvez alors envoyer le fichier \family typewriter dvi \family default à tout ce qui comprend le \family typewriter dvi \family default , ou le convertir vers d'autres formats comme PostScript, PDF, etc\SpecialChar \ldots{} \end_layout \begin_layout Standard TeX ne serait qu'un moteur de rendu typographique s'il n'avait pas une capacité supplémentaire. En effet, TeX permet également de définir des macros. C'est là que ça devient intéressant. \end_layout \begin_layout Standard La plupart de ceux qui utilisent TeX utilisent en fait un paquetage de macros que Donald \noun on Knuth \noun default créa pour masquer nombre de détails typographiques. C'est ce à quoi la plupart des gens pensent quand ils pensent à TeX. Et c'est ici que Leslie \noun on Lamport \noun default entre en scène. Il voulait un paquetage plus orienté utilisateur que typographe, un ensemble de commandes pour composer avec cohérence des sections, des tableaux ou des formules de maths, d'une façon uniforme et cohérente avec le moins de tracas possible. C'est ainsi qu'est né LaTeX. \end_layout \begin_layout Standard Parallèlement au développement et au déploiement de LaTeX, d'autres personnes créèrent leurs propres paquetages de macros pour TeX, certains pour faire des transparents, d'autres pour des articles de journaux mathématiques et bien d'autres encore. Si certains utilisaient le TeX brut, d'autre commençaient à modifier LaTeX. Pour essayer d'unifier cette foire, un groupe de LaTeX-niciens (dont Leslie \noun on Lamport \noun default , bien sûr) a commencé à travailler à LaTeX2e, la version actuelle de LaTeX, à la fin des années 1980. Cette nouvelle version de LaTeX comporte notamment un jeu de commandes qui fournit une interface conviviale pour les anciennes commandes de création de macros de TeX, des commandes facilitant l'utilisation de nouvelles polices, et d'autres extensions. En fait, LaTeX est pratiquement un langage complet à lui tout seul ! Des utilisateurs du monde entier ont créé leur propres extensions de LaTeX, en plus de celles qui sont en standard. \end_layout \begin_layout Standard Il y a deux façons d'étendre LaTeX : les classes et les styles. Une \shape slanted classe \shape default est un jeu de macros LaTeX (et TeX) qui décrivent un nouveau type de document, comme un livre, ou un article. On trouve des classes pour des transparents, pour des articles de journaux de physique et de maths\SpecialChar \ldots{} de nombreuses universités ont même une classe pour la composition de leurs thèses ! Le \shape slanted style \shape default diffère de la classe en ceci qu'il ne définit pas de nouveau document, mais un \shape slanted comportement \shape default différent applicable dans n'importe quel document. Par exemple, LyX contrôle les marges et l'interligne grâce à deux fichiers de style conçus à cet effet. Il y a des fichiers de style pour plein de trucs : étiquettes, enveloppes, modifier l'indentation, ajouter des polices, manipuler des objets graphiques, définir des en-têtes de page fantaisie, personnaliser les bibliographies, modifier la place et l'allure des notes de bas de page, tableaux, et figures, personnaliser les listes, et cetera. \end_layout \begin_layout Standard Voici un résumé : \end_layout \begin_layout Description TeX: langage de composition avec possibilité de macros. \end_layout \begin_layout Description LaTeX: paquetage de macros basé sur TeX\SpecialChar \@. \end_layout \begin_layout Description classes: définitions d'un type de document, utilisant LaTeX\SpecialChar \@. \end_layout \begin_layout Description styles: modifications du comportement implicite de LaTeX d'une façon donnée. \end_layout \begin_layout Description LyX: traitement de texte visuel, WYSIWYM, qui à l'impression utilise LaTeX dans toute sa splendeur. \end_layout \begin_layout Standard LaTeX rend LyX diffèrent des autres traitements de texte. LyX est une interface graphique utilisateur \begin_inset Foot status collapsed \begin_layout Plain Layout \emph on Graphical User Interface \emph default (GUI) en anglais \end_layout \end_inset d'accueil pour LaTeX, conçue pour saisir des documents sans connaître les macro-commandes de LaTeX. Cependant, LyX ne propose pas d'interface graphique pour toutes les (innombrabl es) macros LaTeX existantes, mais il les accepte, ce qui le rend aussi fonctionn el que LaTeX. \end_layout \begin_layout Standard Exactement comme LaTeX, LyX se focalise sur le contexte de vos écrits – le \shape italic quoi. \shape default L'ordinateur s'occupe lui du \shape slanted comment \shape default le présenter. \end_layout \begin_layout Section Naviguer dans la documentation \end_layout \begin_layout Standard Pour répondre plus facilement à vos questions tout en décrivant toutes les fonctionnalités de LyX, la documentation a été répartie sur plusieurs fichiers. Ils ont chacun leur rôle, comme indiqué un peu plus loin. Mais avant de parcourir tous ces fichiers, il vaut mieux lire ce chapitre avec attention, parce qu'il contient des informations et commentaires qui pourront vous faire gagner du temps. \end_layout \begin_layout Standard Bien que LyX ait maintenant bien dépassé la version 1.0, certains documents seront peut-être incomplets ou un peu en retard dans la mise à jour, même si nous travaillons dur pour suivre les évolutions. Comme pour l'ensemble de LyX, les manuels sont l'oeuvre de bénévoles qui ont un \begin_inset Quotes fld \end_inset vrai \begin_inset Quotes frd \end_inset travail, une famille, la vaisselle à laver, la litière du chat à changer, et ainsi de suite. Si vous êtes volontaire pour nous rejoindre, jetez un oeil attentif sur la section \begin_inset space ~ \end_inset \begin_inset CommandInset ref LatexCommand ref reference "sec:Contrib" \end_inset de ce document. \end_layout \begin_layout Standard D'autre part, faites-nous une faveur – s'il arrivait que dans cette documentatio n quelque chose vous embrouille, ne soit pas bien clair, ou carrément faux, faites-le nous savoir ! Vous pouvez contacter les préposés à la mise à jour de la documentation à l'adresse email \begin_inset CommandInset href LatexCommand href target "lyx-docs@lists.lyx.org" type "mailto:" \end_inset . Si vous avez des questions à laquelle la documentation ne répond pas de manière évidente, et que vous avez besoin d'une aide urgente, vous pouvez joindre la liste de diffusion des utilisateurs à l'adresse \begin_inset CommandInset href LatexCommand href target "lyx-users@lists.lyx.org" type "mailto:" \end_inset . Pour les questions spécifiquement francophones, contactez la liste \begin_inset CommandInset href LatexCommand href target "lyx-fr@lists.lyx.org" type "mailto:" \end_inset . \end_layout \begin_layout Subsection Le format des manuels \end_layout \begin_layout Standard Si certains d'entre vous ont imprimé les manuels, d'autres les lisent en ligne. Il y a quelques différences de format entre les deux. En ligne, le titre n'est pas disposé sur une page séparée, comme sur certaines versions papier, mais simplement au tout début du document. Les notes de bas de page et la table des matières ne sont pas visibles dans le corps du document. Les notes de bas de page, qui ont l'aspect suivant: \begin_inset Graphics filename clipart/footnoteQt4.png scale 75 \end_inset , sont accessibles en cliquant dessus avec le bouton gauche de la souris. Vous pouvez consulter la table des matières soit en cliquant sur la boîte grise située sous le titre, soit en utilisant le menu \family sans Naviguer \family default , qui la fait apparaître automatiquement. (Essayez!) \end_layout \begin_layout Standard Sur la version papier, les références croisées sont affichées avec les bons numéros de page, de section ou de sous-section. En ligne, à l'inverse, elles apparaissent comme des boîtes grises ainsi: \begin_inset CommandInset ref LatexCommand ref reference "sec:Contrib" \end_inset . (Dans la version papier il y a un numéro à la place.) Si vous cliquez sur cet insert avec le bouton gauche de la souris, une fenêtre s'ouvre avec la liste de toutes les références croisées du document. Cette introduction n'en a que deux, la première est dénommée \begin_inset Quotes fld \end_inset sec:Contrib \begin_inset Quotes frd \end_inset . Vous pouvez vous rendre à la section mentionnée en cliquant sur le bouton \family sans Aller \begin_inset space ~ \end_inset à \begin_inset space ~ \end_inset l'étiquette \family default . Revenir d'où vous venez est tout aussi simple, il suffit de cliquer sur le bouton \family sans Revenir \family default ou de taper \family sans C-< \family default . (Que signifie \family sans C-< \family default ? La description est juste un peu plus loin.) \end_layout \begin_layout Standard Maintenant que nous avons décrit les différences entre les versions papier et en ligne, voyons le format de ce document. Vous pourrez trouver des textes en différentes polices : \end_layout \begin_layout Itemize le style \emph on Mise En évidence \emph default sert à mettre l'accent sur un point et à écrire les paramètres génériques, les titres de livres, les noms de sections d'autres manuels, et les notes des auteurs; \end_layout \begin_layout Itemize la police à \family typewriter Chasse fixe \family default sert pour les sources de programmes et les noms de fichiers, le code LyX, ainsi que les codes et fonctions LyX; \end_layout \begin_layout Itemize la police \family sans Sans Empattement \family default sert pour les menus, les boutons, les noms des fenêtres et des touches clavier; \end_layout \begin_layout Itemize le style \noun on Nom propre \noun default sert pour les noms propres; \end_layout \begin_layout Itemize le style \series bold Gras \series default sert pour le code LaTeX. \end_layout \begin_layout Standard Voici les conventions utilisées pour décrire les séquences de touches : \end_layout \begin_layout Itemize \begin_inset Quotes fld \end_inset \family sans Ctrl- \family default \begin_inset Quotes frd \end_inset pour la touche \family sans Control ; \end_layout \begin_layout Itemize \begin_inset Quotes fld \end_inset \family sans Shift- \family default \begin_inset Quotes frd \end_inset pour la touche \family sans Majuscule ; \end_layout \begin_layout Itemize \begin_inset Quotes fld \end_inset \family sans Alt- \family default \begin_inset Quotes frd \end_inset pour la touche \family sans Alt \family default ; \end_layout \begin_layout Itemize \begin_inset Quotes fld \end_inset \family sans F1 \family default \begin_inset Quotes frd \end_inset \SpecialChar \ldots{} \begin_inset Quotes fld \end_inset \family sans F12 \family default \begin_inset Quotes frd \end_inset sont les touches de fonctions ; \end_layout \begin_layout Itemize \begin_inset Quotes fld \end_inset \family sans Esc \family default \begin_inset Quotes frd \end_inset la touche \family sans Échap \family default ; \end_layout \begin_layout Itemize \begin_inset Quotes fld \end_inset \family sans Gauche \family default \begin_inset Quotes frd \end_inset \begin_inset Quotes fld \end_inset \family sans Droite \family default \begin_inset Quotes frd \end_inset \begin_inset Quotes fld \end_inset \family sans Haute \family default \begin_inset Quotes frd \end_inset \begin_inset Quotes fld \end_inset \family sans Basse \family default \begin_inset Quotes frd \end_inset : les flèches de déplacement du curseur ; \end_layout \begin_layout Itemize \begin_inset Quotes fld \end_inset \family sans Inser \family default \begin_inset Quotes frd \end_inset \begin_inset Quotes fld \end_inset \family sans Suppr \family default \begin_inset Quotes frd \end_inset \begin_inset Quotes fld \end_inset \family sans Début \family default \begin_inset Quotes frd \end_inset \begin_inset Quotes fld \end_inset \family sans Fin \family default \begin_inset Quotes frd \end_inset \begin_inset Quotes fld \end_inset \family sans PageUp \family default \begin_inset Quotes frd \end_inset \begin_inset Quotes fld \end_inset \family sans PageDown \family default \begin_inset Quotes frd \end_inset : sont les 6 touches situées, sur la plupart des claviers de PC, au dessus des flèches de déplacement du curseur. \begin_inset Quotes fld \end_inset \family sans PageUp \family default \begin_inset Quotes frd \end_inset et \begin_inset Quotes fld \end_inset \family sans PageDown \family default \begin_inset Quotes frd \end_inset sont appelées \begin_inset Quotes fld \end_inset \family sans Prior \family default \begin_inset Quotes frd \end_inset et \begin_inset Quotes fld \end_inset \family sans Next \family default \begin_inset Quotes frd \end_inset sur certains claviers, ou sérigraphiées de flèches vers le haut et vers le bas barrées de plusieurs traits ; \end_layout \begin_layout Itemize \family sans \begin_inset Quotes fld \end_inset Return \family default \begin_inset Quotes frd \end_inset , \family sans \begin_inset Quotes fld \end_inset Enter \begin_inset Quotes frd \end_inset \family default et \family sans \begin_inset Quotes fld \end_inset Entrée \begin_inset Quotes frd \end_inset \family default font référence à la même touche. La touche \family sans Return \family default est indifféremment sérigraphiée \begin_inset Quotes fld \end_inset \family sans Return \family default \begin_inset Quotes frd \end_inset , \begin_inset Quotes fld \end_inset \family sans Enter \family default \begin_inset Quotes frd \end_inset , \begin_inset Quotes fld \end_inset \family sans Entrée \family default \begin_inset Quotes frd \end_inset ou \begin_inset Quotes fld \end_inset \family sans Entr \family default \begin_inset Quotes frd \end_inset sur les différents claviers. Certains ont même deux de ces touches. LyX les traite toutes de la même façon, nous utiliserons \family sans Return \family default , \family sans Enter \family default ou \family sans Entrée \family default sans distinction. \end_layout \begin_layout Standard La liste avec les raccourcis qui sont utilisés actuellement se trouve dans le menu \family sans Aide \family default sous \family sans Raccourcis \family default . \end_layout \begin_layout Subsection \series medium Unités utilisées dans les manuels \end_layout \begin_layout Standard Le tableau \begin_inset space ~ \end_inset \begin_inset CommandInset ref LatexCommand ref reference "cap:Unités" \end_inset décrit les unités utilisées dans Lyx. \end_layout \begin_layout Standard \begin_inset Float table placement t wide false sideways false status open \begin_layout Plain Layout \begin_inset Caption \begin_layout Plain Layout \begin_inset CommandInset label LatexCommand label name "cap:Unités" \end_inset Unités \end_layout \end_inset \end_layout \begin_layout Plain Layout \begin_inset VSpace medskip \end_inset \end_layout \begin_layout Plain Layout \align center \begin_inset Tabular \begin_inset Text \begin_layout Plain Layout unité \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout nom/description \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout mm \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout millimètre \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout cm \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout centimètre \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout in \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout inch/pouce \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout pt \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout point (72.27 \begin_inset space \thinspace{} \end_inset pt = 1 \begin_inset space \thinspace{} \end_inset in) \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout pc \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout pica (1 \begin_inset space \thinspace{} \end_inset pc = 12 \begin_inset space \thinspace{} \end_inset pt) \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout sp \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout scaled point/point divisé (65536 \begin_inset space \thinspace{} \end_inset sp = 1 \begin_inset space \thinspace{} \end_inset pt) \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout bp \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout big point/point arrondi (72 \begin_inset space \thinspace{} \end_inset bp = 1 \begin_inset space \thinspace{} \end_inset in) \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout dd \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout didot (72 \begin_inset space \thinspace{} \end_inset dd \begin_inset Formula $\approx$ \end_inset 37.6 \begin_inset space \thinspace{} \end_inset mm) \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout cc \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout cicero (1 \begin_inset space \thinspace{} \end_inset cc = 12 \begin_inset space \thinspace{} \end_inset dd) \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout Scale% \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout % largeur originale \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout text% \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout % largeur du texte \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout col% \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout % largeur de la colonne \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout page% \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout % largeur du papier \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout line% \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout % de la ligne \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout theight% \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout % hauteur du texte \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout pheight% \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout % hauteur du papier \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout ex \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout hauteur de la lettre \emph on x \emph default dans la police courante \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout em \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout largeur de la lettre \emph on M \emph default dans la police courante \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout mu \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout unité mathématique (1 \begin_inset space \thinspace{} \end_inset mu = 1/18 \begin_inset space \thinspace{} \end_inset em) \end_layout \end_inset \end_inset \end_layout \end_inset \end_layout \begin_layout Subsection \series medium Les manuels \end_layout \begin_layout Standard La liste suivante décrit le contenu de chaque fichier de la documentation : \end_layout \begin_layout Description \emph on Introduction \end_layout \begin_deeper \begin_layout Standard Ce fichier. \end_layout \end_deeper \begin_layout Description Manuel \begin_inset space ~ \end_inset d'Apprentissage \end_layout \begin_deeper \begin_layout Standard Si vous commencez avec LyX, et n'avez jamais touché à LaTeX, vous devriez commencer par là. Si vous pensez que le LaTeX est ce qui sert à faire les préservatifs, c'est qu'il vous faut relire le Chapitre \begin_inset space ~ \end_inset 1, puis lire le \emph on Manuel \begin_inset space ~ \end_inset d'Apprentissage \emph default . Après sa lecture, vous penserez encore que le LaTeX est une substance extensibl e – mais au moins, vous \emph on saurez \emph default comment utiliser LyX. \end_layout \begin_layout Standard Si vous connaissez déjà LaTeX, vous devriez lire au moins la section \begin_inset Quotes fld \end_inset LyX pour les connaisseurs de LaTeX \begin_inset Quotes frd \end_inset (et passer en revue le reste du document ne pourrait pas faire de tort). \end_layout \begin_layout Standard Et lorsque vous vous sentez un peu perdu avec LyX, essayez de lire attentivement le \emph on Manuel \begin_inset space ~ \end_inset d'Apprentissage \emph default avant de consulter les autres manuels. C'est un bon tremplin. \end_layout \end_deeper \begin_layout Description Guide \begin_inset space ~ \end_inset \shape italic \emph on de \begin_inset space ~ \end_inset l'Utilisateur \end_layout \begin_deeper \begin_layout Standard Le document de base. Il couvre la \emph on majeure partie \emph default des opérations et fonctions de base disponibles avec LyX. Pour bien en tirer profit, il faut avoir lu le \emph on Manuel \begin_inset space ~ \end_inset d'Apprentissage\SpecialChar \@. . \end_layout \end_deeper \begin_layout Description Objets \begin_inset space ~ \end_inset Insérés Extension du \emph on Guide \begin_inset space ~ \end_inset de L'Utilisateur \emph default , il explique en détail comment utiliser les tableaux, les graphiques, les objets flottants, les notes et le boîtes. Il inclut également de nombreuses astuces connus des spécialistes de LaTeX. \end_layout \begin_layout Description Math \end_layout \begin_deeper \begin_layout Standard Extension du \emph on Guide \begin_inset space ~ \end_inset de L'Utilisateur \emph default , il explique en détail comment mettre en forme tout type de formule. \end_layout \end_deeper \begin_layout Description Options \begin_inset space ~ \end_inset Avancées \end_layout \begin_deeper \begin_layout Standard Extension du \emph on Guide \begin_inset space ~ \end_inset de \begin_inset space ~ \end_inset l'Utilisateur \emph default , il décrit comment utiliser des commandes LaTeX brutes, des formats supplémenta ires, des fonctions d'édition particulières. \end_layout \end_deeper \begin_layout Description Personnalisation \end_layout \begin_deeper \begin_layout Standard C'est une description de certaines fonctions avancées de LyX, notamment la façon de personnaliser son comportement général. Y sont abordés la configuration du clavier (raccourcis), l'internationalisation , et les fichiers de configuration. Inutile de le consulter avant d'avoir lu le \emph on Manuel \begin_inset space ~ \end_inset d'Apprentissage \emph default . \end_layout \end_deeper \begin_layout Description Raccourcis \end_layout \begin_deeper \begin_layout Standard Des tableaux avec les raccourcis claviers qui sont définis actuellement dans LyX. \end_layout \end_deeper \begin_layout Description Configuration \begin_inset space ~ \end_inset LaTeX \end_layout \begin_deeper \begin_layout Standard Pendant son installation, LyX analyse votre système. Les informations qu'il découvre sont consignées dans ce document. Vous pouvez le consulter s'il manquait à LyX quelque chose qu'il est censé délivrer. \end_layout \end_deeper \begin_layout Standard Tous ces fichiers se référencent les uns les autres quand c'est nécessaire. Le \emph on Guide \begin_inset space ~ \end_inset de \begin_inset space ~ \end_inset l'Utilisateur \emph default contient par exemple \emph on quelques \emph default informations sur l'installation et la personnalisation, mais fait référence au manuel de \emph on Personnalisation \emph default pour de plus amples informations. \end_layout \begin_layout Standard Répétons un point important : \end_layout \begin_layout Standard \begin_inset VSpace bigskip \end_inset \end_layout \begin_layout Standard \align center Si vous commencez avec LyX, lisez le \emph on Manuel \begin_inset space ~ \end_inset d'Apprentissage \emph default dès maintenant\SpecialChar \@. \end_layout \begin_layout Standard \begin_inset VSpace bigskip \end_inset \end_layout \begin_layout Standard Sinon, vous vous poserez des problèmes inutilement. \end_layout \begin_layout Section Contribuer au projet LyX \begin_inset CommandInset label LatexCommand label name "sec:Contrib" \end_inset \end_layout \begin_layout Subsection Contribuer à LyX \end_layout \begin_layout Standard LyX est pour l'essentiel écrit en C++ (l'importation LaTeX est écrite en Python). C'est un vaste projet, il n'est donc pas exempt de bogues, et des améliorations peuvent être nécessaires dans le code source. \end_layout \begin_layout Subsubsection Signaler un bogue \end_layout \begin_layout Standard Lors de votre utilisation de LyX, vous pouvez rencontrer un comportement que vous considérez comme un bogue. Les plantages sont rares, mais ça peut arriver. Les problèmes d'interface utilisateur sont considérés par l'équipe LyX comme des bogues importants : des indications sur les parties de l'interface LyX que vous trouvez confuses et peu claires nous sont précieuses. \end_layout \begin_layout Standard LyX a un système de recensement de bogues, que vous trouverez sur le traceur de bogues de LyX \begin_inset Flex URL status collapsed \begin_layout Plain Layout http://www.lyx.org/trac/wiki/BugTrackerHome \end_layout \end_inset . Vous devez consulter le traceur de bogues avant de signaler un nouveau bogue, pour voir s'il n'est pas déjà répertorié. Si vous avez un commentaire à faire sur un bogue déjà répertorié, ou si vous voulez en signaler un nouveau, vous pouvez soit utiliser le traceur de bogues, soit envoyer un e-mail à la liste de diffusion des développeurs, \begin_inset CommandInset href LatexCommand href target "lyx-devel@lists.lyx.org" type "mailto:" \end_inset . L'adresse des archives de cette liste est indiquée sur le site principal de LyX, le site web de LyX \begin_inset Flex URL status collapsed \begin_layout Plain Layout http://www.lyx.org/ \end_layout \end_inset . \end_layout \begin_layout Standard Un bon rapport de bogue doit au minimum comprendre la version de LyX avec laquelle vous avez rencontré le problème. Envoyez les descriptions les plus exactes et détaillées possibles : plus les développeurs devront passer de temps à trouver l'origine du bogue, moins ils en auront pour d'autres améliorations. Dites sur quel système, et dans quelle version de celui-ci vous faites tourner LyX. Donnez les versions des bibliothèques installées sur votre système, et si nécessaire les versions des programmes externes utilisés par LyX. S'il s'agit d'un problème de configuration ou de compilation, joignez le fichier \family typewriter config.log \family default , et dites quel compilateur vous utilisez. \end_layout \begin_layout Standard \end_layout \begin_layout Subsubsection Offrir des corrections et de nouvelles fonctions \end_layout \begin_layout Standard Si vous avez fait des changements au code source de LyX et que vous pensez qu'ils devraient faire partie de la distribution, envoyez vos changements sous la forme d'un fichier diff (au format unifié) à la liste des développeurs référencée plus haut, avec un \begin_inset Quotes fld \end_inset change log \begin_inset Quotes frd \end_inset , et une description de ce qu'ils font. \end_layout \begin_layout Subsection Contribuer à la documentation \end_layout \begin_layout Standard La documentation de LyX est assez exhaustive ; cependant LyX est en constant développement, et chaque nouvelle version ajoute de nouvelles fonctions. Vous pouvez trouver qu'une partie de la documentation nécessite des amélioratio ns. Cette section décrit quoi faire si vous trouvez une erreur, ou avez des suggestions pour améliorer la documentation. \end_layout \begin_layout Subsubsection Rapporter les erreurs dans les manuels \end_layout \begin_layout Standard Si vous trouvez un problème dans la documentation, envoyez un message à la liste de diffusion \begin_inset CommandInset href LatexCommand href target "lyx-docs@lists.lyx.org" type "mailto:" \end_inset . L'équipe de documentation apportera tous les changements nécessaires. \end_layout \begin_layout Subsubsection Se joindre à l'équipe de documentation \end_layout \begin_layout Standard Comme pour l'ensemble du projet LyX, toute aide est bienvenue pour la documentat ion de LyX ! Si vous êtes volontaire, merci de respecter \shape italic avant tout \shape default les points suivants : \end_layout \begin_layout Enumerate Récupérez le code source de LyX le plus récent \begin_inset Newline newline \end_inset \begin_inset Flex URL status collapsed \begin_layout Plain Layout http://www.lyx.org/trac/browser/lyx-devel/trunk/lib/doc \end_layout \end_inset \end_layout \begin_layout Enumerate Lisez le \shape italic Guide \begin_inset space ~ \end_inset de \begin_inset space ~ \end_inset l'Utilisateur \shape default et le \emph on Manuel \begin_inset space ~ \end_inset d'Apprentissage \emph default . \end_layout \begin_deeper \begin_layout Standard Le but de cet exercice est de vous donner des idées. Le \emph on Manuel \begin_inset space ~ \end_inset d'Apprentissage \emph default et le \shape italic Guide \begin_inset space ~ \end_inset de \begin_inset space ~ \end_inset l'Utilisateur \shape default sont toujours les documents les plus à jour de la collection. Ils devraient vous aider à vous imprégner de l'aspect et de la structure que nous souhaitons avoir pour notre documentation. \end_layout \end_deeper \begin_layout Enumerate Contactez l'équipe de documentation à l'adresse suivante : \end_layout \begin_deeper \begin_layout Standard \begin_inset CommandInset href LatexCommand href target "lyx-docs@lists.lyx.org" type "mailto:" \end_inset \end_layout \begin_layout Standard pour discuter des changements que vous envisagez, et avoir l'avis des autres. \end_layout \end_deeper \begin_layout Standard Les changements que vous voudrez apporter peuvent aller du simple éclaircissemen t à une restructuration majeure de la documentation. Toute amélioration sera la bienvenue. \end_layout \begin_layout Subsubsection Contribuer à la traduction francophone \end_layout \begin_layout Standard Pour participer à la traduction, le principe est le même que pour modifier la version originale anglophone. Il existe une liste de diffusion pour les traducteurs et les utilisateurs francophones, à l'adresse \begin_inset Flex URL status collapsed \begin_layout Plain Layout lyx-fr@lists.lyx.org \end_layout \end_inset . Avant d'apporter une modification substantielle à un document, il faut envoyer un message à cette adresse. Pour s'inscrire sur cette liste, il faut envoyer un message vide à \begin_inset Flex URL status collapsed \begin_layout Plain Layout lyx-fr-subscribe@lists.lyx.org \end_layout \end_inset . \end_layout \begin_layout Standard D'autre part il faut prendre garde à ne modifier que la dernière version de la traduction. C'est toujours celle qui est sur le serveur SVN \lang english \begin_inset Flex URL status collapsed \begin_layout Plain Layout http://www.lyx.org/trac/browser/lyx-devel/trunk/lib/doc/fr \end_layout \end_inset \lang french . On peut y accéder également en suivant les indications qui se trouvent sur le site des développeurs de LyX \begin_inset Flex URL status collapsed \begin_layout Plain Layout http://www.devel.lyx.org/ \end_layout \end_inset . Il y a aussi une site de référence pour les traductions en français, sur laquelle vous pouvez télécharger les fichiers les plus récents \begin_inset Flex URL status collapsed \begin_layout Plain Layout http://lyxfr.free.fr/ \end_layout \end_inset . \end_layout \end_body \end_document