lyx_mirror/lib/doc/fr/Additional.lyx

26074 lines
452 KiB
Plaintext
Raw Normal View History

#LyX 2.0 created this file. For more info see http://www.lyx.org/
\lyxformat 413
\begin_document
\begin_header
\textclass scrbook
\begin_preamble
% DO NOT ALTER THIS PREAMBLE!!!
%
% This preamble is designed to ensure that the User's Guide prints
% out as advertised. If you mess with this preamble,
% parts of the User's Guide may not print out as expected. If you
% have problems LaTeXing this file, please contact
% the documentation team
% email: lyx-docs@lists.lyx.org
% if pdflatex is used
\usepackage{ifpdf}
\ifpdf
% 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}}
% used for multi-column text
\usepackage{multicol}
% extra space for tables
\newcommand{\extratablespace}[1]{\noalign{\vskip#1}}
\end_preamble
\options fleqn,liststotoc,bibtotoc,idxtotoc,BCOR7.5mm,titlepage,tablecaptionabove
\use_default_options false
\begin_modules
logicalmkup
theorems-ams
theorems-ams-extended
\end_modules
\maintain_unincluded_children false
\begin_local_layout
Format 7
InsetLayout CharStyle:MenuItem
LyxType charstyle
LabelString menu
LatexType command
LatexName menuitem
Font
Family Sans
EndFont
Preamble
\newcommand*{\menuitem}[1]{{\sffamily #1}}
EndPreamble
End
\end_local_layout
\language french
\language_package default
\inputencoding auto
\fontencoding global
\font_roman default
\font_sans default
\font_typewriter default
\font_default_family default
\use_non_tex_fonts false
\font_sc false
\font_osf false
\font_sf_scale 100
\font_tt_scale 100
\graphics default
\default_output_format default
\output_sync 0
\bibtex_command default
\index_command default
\paperfontsize 12
\spacing single
\use_hyperref true
\pdf_title "Options avancées de LyX"
\pdf_author "LyX Team"
\pdf_subject "Options avancées LyX"
\pdf_keywords "LyX, Documentacion, Options avancées"
\pdf_bookmarks true
\pdf_bookmarksnumbered true
\pdf_bookmarksopen false
\pdf_bookmarksopenlevel 1
\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, pdfpagelabels"
\papersize default
\use_geometry false
\use_amsmath 0
\use_esint 0
\use_mhchem 1
\use_mathdots 1
\cite_engine basic
\use_bibtopic false
\use_indices false
\paperorientation portrait
\suppress_date false
\use_refstyle 1
\index Index
\shortcut idx
\color #008000
\end_index
\secnumdepth 3
\tocdepth 3
\paragraph_separation indent
\paragraph_indentation default
\quotes_language french
\papercolumns 1
\papersides 2
\paperpagestyle default
\bullet 0 5 9 -1
\tracking_changes false
\output_changes false
\html_math_output 0
\html_css_as_file 0
\html_be_strict false
\end_header
\begin_body
\begin_layout Title
Options avancées de LyX
\begin_inset Note Note
status open
\begin_layout Plain Layout
Informations de révision :
\end_layout
\begin_layout Plain Layout
Traduction : Mise à jour pour 2.0 par JPChrétien, Date : 20/06/12011
\end_layout
\begin_layout Plain Layout
Manque le chapitre 4, les sections 5.7 et 7.2.3 à 7.2.7
\end_layout
\begin_layout Plain Layout
Original : Révision: 38553, Date : 29/04/2011
\end_layout
\end_inset
\end_layout
\begin_layout Author
par l'équipe de LyX
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Le principal responsable de la rédaction de ce fichier est
\noun on
Mike Ressler
\noun default
.
Merci d'envoyer vos commentaires et corrections à la liste de diffusion
de la documentation de LyX,
\family typewriter
<lyx-docs@lists.lyx.org>
\family default
.
\begin_inset Newline newline
\end_inset
Traduction en français par :
\noun on
Olivier
\noun default
\noun on
Faucheux
\noun default
,
\noun on
Adrien
\noun default
\noun on
Rebollo
\noun default
,
\noun on
Siegfried
\noun default
\noun on
Meunier
\noun default
-
\noun on
Guttin
\noun default
-Cluz
\noun on
e
\noun default
l et
\noun on
Jean-Pierre Chrétien
\noun default
.
Merci d'envoyer vos commentaires et corrections sur la traduction à la
liste de diffusion de LyX en français
\family typewriter
<lyx-fr@lists.lyx.org>
\family default
.
\end_layout
\end_inset
\end_layout
\begin_layout Standard
\begin_inset CommandInset toc
LatexCommand tableofcontents
\end_inset
\end_layout
\begin_layout Chapter
Introduction
\end_layout
\begin_layout Standard
Le guide des
\emph on
Options
\begin_inset space ~
\end_inset
avancées
\emph default
de LyX que vous êtes en train de lire est avant tout la deuxième partie
du
\emph on
Guide
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
l'Utilisateur
\emph default
.
La raison de la division en deux du document est très simple : le
\emph on
Guide
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
l'Utilisateur
\emph default
est déjà énorme et il contient toutes les fonctions de base qu'il faut
connaître pour préparer la plupart des documents.
Cependant, l'Équipe de LyX a pour but à long terme de rendre LyX extensible
par différents fichiers de configuration et paquetages externes.
Cela signifie que si vous voulez utiliser le paquetage LaTeX Fizzwizzle,
vous pouvez créer un fichier de format qui lui soit dédié sans modifier
LyX lui-même.
Nous avons déjà reçu ainsi plusieurs contributions, et certaines sont documenté
es ici.
Il y a aussi quelques fonctionnalités plus
\begin_inset Quotes fld
\end_inset
avancées
\begin_inset Quotes frd
\end_inset
, comme les méthodes de présentation de bibliographies et la gestion des
documents éclatés en plusieurs fichiers, qui ne sont pas couverts par le
\emph on
Guide de l'utilisateur
\emph default
et sont décrites ici.
\end_layout
\begin_layout Standard
Ce manuel décrit aussi quelques fonctions spéciales, comme la gestion d'un
fax, le contrôle de version et le support de SGML, qui nécessitent des
logiciels supplémentaires pour fonctionner convenablement.
Il y a également un chapitre consacré à LyX et HTML.
Et enfin, il y a un chapitre sur les trucs et astuces LaTeX, qui servent
à améliorer vos documents grâce à la puissance de LaTeX.
Après tout, LyX est seulement WYSIWYM
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\begin_inset Quotes fld
\end_inset
What You See Is What You Mean
\begin_inset Quotes frd
\end_inset
:
\begin_inset Quotes fld
\end_inset
Vous voyez ce que vous voulez dire
\begin_inset Quotes frd
\end_inset
.
\end_layout
\end_inset
, et ne sera jamais qu'une interface à certaines des fonctions de LaTeX.
\end_layout
\begin_layout Standard
Si vous n'avez pas encore lu l'
\emph on
Introduction
\emph default
, il est sûr que vous n'êtes pas au bon endroit.
L'
\emph on
Introduction
\emph default
est la première chose à consulter, car elle décrit les notations et les
formats de tous les manuels.
Vous devez aussi être à l'aise avec le
\emph on
Guide
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
l'Utilisateur
\emph default
et avec toutes les fonctions de base de LyX.
\end_layout
\begin_layout Standard
Comme tous les sujets couverts par ce manuel dépendent étroitement de l'interact
ion de LyX avec LaTeX, le premier chapitre traite du fonctionnement interne
de LyX et explique comment LyX peut générer exactement le code LaTeX que
vous désirez.
Il est évidemment destiné à des utilisateurs aguerris de LyX.
\end_layout
\begin_layout Chapter
LyX et LaTeX
\end_layout
\begin_layout Section
Comment LyX utilise LaTeX
\end_layout
\begin_layout Standard
Ce chapitre est à la fois pour les TeX-niciens et les curieux de LaTeX.
Nous allons y expliquer comment LyX et LaTeX fonctionnent ensemble pour
produire une sortie imprimable.
C'est le seul endroit de tous ces manuels où nous présumons que vous connaissez
quelque chose à LaTeX.
\end_layout
\begin_layout Standard
À un moment, nous avions coutume d'appeler LyX une
\begin_inset Quotes fld
\end_inset
interface WYSIWYM pour LaTeX
\begin_inset Quotes frd
\end_inset
, mais ce n'est plus vrai désormais.
Des interfaces pour LaTeX existent.
Ce sont basiquement des éditeurs avec la possibilité de faire tourner LaTeX
et de marquer les erreurs dans le fichier que vous éditez.
Bien que LyX
\emph on
soit
\emph default
un éditeur, et qu'il
\emph on
fasse tourner
\emph default
LaTeX, et qu'il marque aussi les erreurs dans le fichier, il fait aussi
beaucoup, beaucoup d'autres choses.
Grâce au concept WYSIWYM, vous n'avez pas besoin de connaître LaTeX pour
utiliser LyX efficacement.
LyX a aussi ajouté quelques extensions à LaTeX.
Essayez un jour ceci : faites
\family sans
Fichier\SpecialChar \menuseparator
Exporter\SpecialChar \menuseparator
LaTeX
\family default
, (ou bien
\family sans
Visionner\SpecialChar \menuseparator
Afficher le code LaTeX
\family default
) puis regardez le préambule du fichier
\family typewriter
.tex
\family default
obtenu.
Vous remarquerez une variété de nouvelles macros définies spécialement
par LyX.
Ces macros sont définies automatiquement, en fonction de ce que vous utilisez
dans le document.
\end_layout
\begin_layout Standard
Il y a plusieurs commandes qui invoquent LaTeX automatiquement.
Ce sont :
\end_layout
\begin_layout Itemize
\family sans
Visionner\SpecialChar \menuseparator
\emph on
Format
\end_layout
\begin_layout Itemize
\family sans
Visionner\SpecialChar \menuseparator
Mise
\begin_inset space ~
\end_inset
à
\begin_inset space ~
\end_inset
jour\SpecialChar \menuseparator
\emph on
Format
\end_layout
\begin_layout Itemize
\family sans
Fichier\SpecialChar \menuseparator
Imprimer\SpecialChar \ldots{}
\end_layout
\begin_layout Itemize
\family sans
Fichier\SpecialChar \menuseparator
Fax\SpecialChar \ldots{}
\end_layout
\begin_layout Standard
Elles n'invoqueront LaTeX que si le fichier a changé depuis la dernière
fois que LaTeX l'a traité.
\end_layout
\begin_layout Standard
Quand vous faites tourner LaTeX sur le fichier que vous éditez, LyX réalise
les étapes suivantes :
\end_layout
\begin_layout Enumerate
Il convertit le document en LaTeX et l'enregistre dans un fichier avec l'extensi
on
\family typewriter
.tex
\family default
au lieu de
\family typewriter
.lyx
\family default
.
\end_layout
\begin_layout Enumerate
Il fait tourner LaTeX sur le fichier
\family typewriter
.tex
\family default
(peut-être plusieurs fois) et exécute toute autre commande (comme
\family typewriter
bibtex
\family default
ou
\family typewriter
makeindex
\family default
) nécessaire à la compilation du fichier LaTeX.
\end_layout
\begin_layout Enumerate
S'il y a des erreurs, il affiche le journal d'erreurs.
\end_layout
\begin_layout Standard
Si vous avez lancé LaTeX avec
\family sans
Visionner\SpecialChar \menuseparator
DVI
\family default
, LyX exécute alors
\family typewriter
xdvi
\family default
sur le fichier DVI.
Si vous avez utilisé
\family sans
Visionner\SpecialChar \menuseparator
PostScript
\family default
ou
\family sans
Fichier\SpecialChar \menuseparator
Imprimer
\family default
, LyX réalise deux étapes supplémentaires :
\end_layout
\begin_layout Itemize
il fait tourner
\family typewriter
dvips
\family default
pour convertir le fichier DVI en PostScript;
\end_layout
\begin_layout Itemize
il exécute une visonneuse PostScript, comme
\family typewriter
ghostview
\family default
, pour afficher le résultat.
\end_layout
\begin_layout Standard
Lyx procède de manière similaire pour afficher ou exporter d'autres formats.
\end_layout
\begin_layout Section
Traduire des fichiers LaTeX en LyX
\end_layout
\begin_layout Standard
Vous pouvez importer un fichier LaTeX dans LyX en utilisant le menu Fichier
\SpecialChar \menuseparator
Importer\SpecialChar \menuseparator
LaTeX de LyX.
Cela va appeler un programme nommé
\family typewriter
tex2lyx
\family default
, qui va créer un fichier
\family typewriter
toto.lyx
\family default
à partir du fichier
\family typewriter
toto.tex
\family default
.
LyX va ensuite ouvrir ce fichier.
\end_layout
\begin_layout Standard
\family typewriter
tex2lyx
\family default
peut traduire la plupart des constructions LaTeX légales, mais pas toutes.
Ce qu'il ne parviendra pas à comprendre, il le laissera mode TeX, ce qui
fait qu'après avoir traduit un fichier avec tex2lyx, vous pouvez rechercher
les portions en code TeX et les corriger manuellement.
\end_layout
\begin_layout Standard
Si vous ignorez ce qu'est le code TeX, lisez le paragraphe suivant.
\end_layout
\begin_layout Section
Insérer du code LaTeX dans des documents LyX
\begin_inset CommandInset label
LatexCommand label
name "sec:Insérer-du-code-LaTeX"
\end_inset
\end_layout
\begin_layout Standard
\begin_inset CommandInset label
LatexCommand label
name "sec:code-LaTeX"
\end_inset
Vous pouvez faire en LyX tout ce que vous faites en LaTeX, pour une raison
très simple: vous pouvez toujours insérer du code LaTeX dans un document
LyX.
LyX ne peut tout simplement pas, et ne pourra probablement jamais, afficher
toutes les structures LaTeX possibles.
Si vous avez besoin d'insérer des commandes LaTeX dans votre document LyX,
vous pouvez utiliser la boîte de
\family typewriter
code TeX
\family default
, que vous pouvez mettre dans votre document avec
\family sans
Insérer\SpecialChar \menuseparator
Code
\begin_inset space ~
\end_inset
TeX
\family default
.
\end_layout
\begin_layout Standard
Voici un exemple d'insertion de commandes LaTeX dans un document LyX.
Le code ressemble à ceci :
\end_layout
\begin_layout LyX-Code
\backslash
begin{tabular}{ll}
\begin_inset Newline newline
\end_inset
\backslash
begin{minipage}{5cm}
\begin_inset Newline newline
\end_inset
Un exemple d'environnement minipage.
Vous pouvez
\begin_inset Newline newline
\end_inset
mettre presque tout dedans, même des figures
\begin_inset Newline newline
\end_inset
et des tableaux (non flottants).
\begin_inset Newline newline
\end_inset
\backslash
end{minipage}
\begin_inset Newline newline
\end_inset
&
\begin_inset Newline newline
\end_inset
\backslash
begin{minipage}{5cm}
\begin_inset Newline newline
\end_inset
\backslash
begin{verbatim}
\begin_inset Newline newline
\end_inset
\backslash
begin{minipage}{5cm}
\begin_inset Newline newline
\end_inset
Un exemple ...
\begin_inset Newline newline
\end_inset
\backslash
end{minipage}
\begin_inset Newline newline
\end_inset
\backslash
end{verbatim}
\begin_inset Newline newline
\end_inset
\backslash
end{minipage}
\begin_inset Newline newline
\end_inset
\backslash
end{tabular}
\end_layout
\begin_layout Standard
La boîte de
\family typewriter
code TeX
\family default
contenant ce texte est juste après ce paragraphe.
Ceux d'entre vous qui lisent le manuel en ligne verront seulement un paquet
de texte en rouge.
Ceux qui lisent une version imprimée du manuel verront le résultat final
:
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
begin{tabular}{ll}
\end_layout
\begin_layout Plain Layout
\backslash
begin{minipage}{5cm}
\end_layout
\begin_layout Plain Layout
Un exemple d'environnement minipage.
Vous pouvez mettre presque tout dedans, même des figures et des tableaux
(non flottants).
\end_layout
\begin_layout Plain Layout
\backslash
end{minipage}
\end_layout
\begin_layout Plain Layout
&
\end_layout
\begin_layout Plain Layout
\backslash
begin{minipage}{5cm}
\end_layout
\begin_layout Plain Layout
\backslash
begin{verbatim}
\end_layout
\begin_layout Plain Layout
\backslash
begin{minipage}{5cm}
\end_layout
\begin_layout Plain Layout
Un exemple ...
\end_layout
\begin_layout Plain Layout
\backslash
end{minipage}
\end_layout
\begin_layout Plain Layout
\backslash
end{verbatim}
\end_layout
\begin_layout Plain Layout
\backslash
end{minipage}
\end_layout
\begin_layout Plain Layout
\backslash
end{tabular}
\end_layout
\end_inset
\end_layout
\begin_layout Standard
En plus de l'utilisation du
\family typewriter
code TeX
\family default
, vous pouvez aussi créer un fichier séparé contenant une structure LaTeX
complexe.
Vous pouvez alors utiliser
\family sans
Insérer\SpecialChar \menuseparator
Fichier\SpecialChar \menuseparator
Sous-document
\family default
pour inclure votre fichier (vous devez choisir le type
\family sans
Incorporé
\begin_inset space ~
\end_inset
(input)
\family default
).
Nous vous recommandons de ne faire cela que si vous avez un fichier
\family typewriter
.tex
\family default
dont vous
\emph on
savez
\emph default
déjà qu'il marche.
Sinon, vous allez avoir du mal à partir à la chasse aux erreurs...
\end_layout
\begin_layout Standard
Encore quelques notes pour insister:
\end_layout
\begin_layout Itemize
au sein de LyX, le code LaTeX apparaît
\emph on
en rouge;
\end_layout
\begin_layout Itemize
LyX
\emph on
ne vérifie pas
\emph default
si votre code LaTeX est correct;
\end_layout
\begin_layout Itemize
attention à ne pas réinventer la roue.
\end_layout
\begin_layout Standard
Sur ce dernier point, LyX dispose déjà de pas mal de possibilités, et encore
plus sont en préparation.
Assurez-vous de vérifier dans les manuels que LyX n'a pas déjà telle ou
telle fonction avant de vous lancer joyeusement dans l'écriture de code
LaTeX.
De plus, il existe beaucoup de paquetages LaTeX pour faire toutes sortes
de choses, des étiquettes et enveloppes aux tableaux sur plusieurs pages.
Voyez un site du
\begin_inset CommandInset href
LatexCommand href
name "CTAN"
target "http://www.ctan.org/"
\end_inset
pour plus de détails, et lisez le chapitre
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "cha:secrets"
\end_inset
.
\end_layout
\begin_layout Standard
Si vous avez effectivement besoin de faire quelque chose de bizarre avec
votre document, référez-vous à un bon livre sur LaTeX pour avoir de l'aide.
Un certain nombre sont cités dans la bibliographie du
\emph on
Guide
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
l'Utilisateur
\emph default
.
\end_layout
\begin_layout Section
LyX et le préambule LaTeX
\end_layout
\begin_layout Subsection
À propos du préambule LaTeX
\end_layout
\begin_layout Standard
Si vous connaissez déjà LaTeX, il n'y a pas besoin d'expliquer ici à quoi
sert le préambule.
Si vous ne le connaissez pas, ce qui suit vous en donnera une idée nous
vous recommandons encore de consulter un livre sur LaTeX pour plus d'informatio
n.
Dans tous les cas, il vaut mieux lire les points ci-dessous, parce qu'ils
expliquent ce que vous pouvez faire et ce que vous n'avez pas besoin de
faire dans le préambule LaTeX d'un document LyX.
\end_layout
\begin_layout Standard
Le préambule LaTeX vient au tout début d'un document,
\emph on
avant
\emph default
le texte.
Il sert à :
\end_layout
\begin_layout Itemize
déclarer la classe de document.
LyX l'a déjà fait à votre place.
\end_layout
\begin_deeper
\begin_layout Standard
Si vous êtes un LaTeX-nicien expérimenté, et que vous avez une classe de
document particulière dont vous voulez vous servir, voyez le manuel de
\emph on
Personnalisation
\emph default
pour savoir comment la faire reconnaître par LyX.
Puis soumettez le fruit de vos efforts à l'équipe LyX pour que cela paraisse
dans de prochaines versions !
\end_layout
\end_deeper
\begin_layout Itemize
déclarer les paquetages utilisés.
Les paquetages LaTeX fournissent des commandes spéciales, qui sont disponibles
dans un document seulement si le paquetage a été déclaré dans le préambule.
Par exemple, le paquetage
\family typewriter
indentfirst
\family default
force l'indentation de tous les paragraphes.
Il y a d'autres paquetages pour des étiquettes, des enveloppes, des marges,
etc.
\end_layout
\begin_layout Itemize
fixer les compteurs, variables, longueurs et largeurs.
Il y a plusieurs compteurs et variables LaTeX qui
\emph on
doivent
\emph default
être fixés globalement depuis le préambule afin d'avoir l'effet désiré.
(Il y a aussi d'autres variables que vous pouvez ajuster dans le document.)
Les marges sont un bon exemple de ce qui doit être fixé dans le préambule.
Un autre exemple est le type de marqueur pour les listes.
Vous pouvez en fait régler cela n'importe où, mais il est préférable de
le faire une seule fois, dans le préambule.
\end_layout
\begin_layout Itemize
déclarer les commandes définies par l'utilisateur (avec
\family typewriter
\backslash
newcommand
\family default
ou
\family typewriter
\backslash
renewcommand
\family default
), pour la plupart ce sont des abréviations pour des commandes LaTeX qui
apparaissent très souvent dans le document.
Bien que le préambule soit un bon endroit pour déclarer de telles commandes,
elles
\emph on
peuvent
\emph default
être définies n'importe où ailleurs (mais
\emph on
avant
\emph default
d'être utilisées pour la première fois, bien sûr...).
Ce peut être utile s'il y a beaucoup de code LaTeX brut dans votre document,
ce qui normalement ne devrait pas être le cas.
\end_layout
\begin_layout Standard
LyX ajoute son propre lot de définitions au préambule du fichier
\family typewriter
.tex
\family default
qu'il engendre.
Ceci rend les fichiers LaTeX générés par LyX portables.
\end_layout
\begin_layout Subsection
Changer le préambule
\end_layout
\begin_layout Standard
Les commandes que LyX ajoute au préambule d'un fichier LaTeX sont déterminées
; vous ne pouvez pas les changer sans modifier les sources de LyX.
Vous pouvez toutefois ajouter vos propres commandes au préambule en sélectionna
nt
\family sans
Document\SpecialChar \menuseparator
Paramètres\SpecialChar \menuseparator
Préambule
\family default
\begin_inset space ~
\end_inset
\family sans
LaTeX
\family default
.
LyX ajoute tout ce qu'il y a dans la fenêtre
\family sans
Préambule
\begin_inset space ~
\end_inset
LaTeX
\family default
à son propre préambule.
Avant d'ajouter vos propres déclarations, vous devriez vous assurer que
LyX ne fait pas déjà ce que vous voulez faire (rappelez-vous ce que nous
avons dit : ne réinventez pas la roue !).
\emph on
Assurez-vous aussi que votre préambule est correct.
\emph default
LyX ne le vérifie pas.
S'il y a une erreur, vous risquez de voir apparaître un message d'erreur
comme
\begin_inset Quotes fld
\end_inset
\family typewriter
Missing
\backslash
begin{document}
\family default
\begin_inset Quotes frd
\end_inset
.
Si vous voyez ce message, vérifiez votre préambule.
\end_layout
\begin_layout Subsection
Exemples
\end_layout
\begin_layout Standard
Voici quelques exemples de ce que vous pouvez ajouter au préambule, et de
l'effet produit :
\end_layout
\begin_layout Subsubsection
Exemple 1 : Décalages
\end_layout
\begin_layout Standard
Il y a deux variables dans LaTeX qui contrôlent la position de la page :
\family typewriter
\backslash
hoffset
\family default
et
\family typewriter
\backslash
voffset
\family default
, c'est-à-dire décalage horizontal et décalage vertical.
Ces variables sont utiles si vous pensez par exemple à l'impression d'étiquette
s.
Parfois, la taille d'un médium d'impression et l'aire effectivement imprimable
ne sont pas les mêmes.
C'est là qu'interviennent
\family typewriter
\backslash
hoffset
\family default
et
\family typewriter
\backslash
voffset
\family default
.
\end_layout
\begin_layout Standard
Les valeurs par défaut de
\family typewriter
\backslash
hoffset
\family default
et
\family typewriter
\backslash
voffset
\family default
sont toutes deux de 0
\begin_inset space ~
\end_inset
pt, c'est-à-dire que la page n'est pas décalée.
\end_layout
\begin_layout Standard
Malheureusement, quelques pilotes DVI semblent toujours décaler la page.
Nous ne savons pas pourquoi, ni pourquoi l'administrateur système n'a pas
corrigé un tel comportement.
Si vous utilisez LyX sur un système que vous n'entretenez pas vous-même,
et si votre administrateur système est un paresseux
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT : Traduction vraisemblable de
\begin_inset Quotes fld
\end_inset
your sysadmin is a doofus
\begin_inset Quotes frd
\end_inset
.
\end_layout
\end_inset
,
\family typewriter
\backslash
hoffse
\family default
t et
\family typewriter
\backslash
voffset
\family default
peuvent sauver la mise.
Supposez que vos marges du haut et de gauche soient toujours 0,5
\begin_inset space ~
\end_inset
pouce trop grandes.
Vous pouvez ajouter ceci au préambule :
\end_layout
\begin_layout LyX-Code
\backslash
setlength{
\backslash
hoffset}{-0.5 in}
\end_layout
\begin_layout LyX-Code
\backslash
setlength{
\backslash
voffset}{-0.5 in}
\end_layout
\begin_layout Standard
...et vos marges devraient désormais être correctes.
\end_layout
\begin_layout Subsubsection
Exemple 2 : Étiquettes
\end_layout
\begin_layout Standard
Supposez que vous vouliez imprimer un paquet d'étiquettes d'adresse.
Il y a un paquetage plutôt sympathique, disponible à votre archive CTAN
la plus proche, pour imprimer des feuilles d'étiquettes, appelé
\family typewriter
labels.sty
\family default
.
Il est possible que votre système n'ait pas ce paquetage installé par défaut.
Nous vous laissons le vérifier.
Il vous faut aussi lire sa documentation ; nous n'allons pas le faire à
votre place.
Toutefois, comme c'est un exemple, nous allons vous montrer comment il
marche.
\end_layout
\begin_layout Standard
D'abord, assurez-vous que vous utilisez la classe de document
\family sans
article
\family default
.
Ensuite, vous devez ajouter ce qui suit dans votre préambule :
\end_layout
\begin_layout LyX-Code
\backslash
usepackage{labels}
\end_layout
\begin_layout LyX-Code
\backslash
LabelCols=3
\end_layout
\begin_layout LyX-Code
\backslash
LabelRows=7
\end_layout
\begin_layout LyX-Code
\backslash
LeftBorder=8mm
\end_layout
\begin_layout LyX-Code
\backslash
RightBorder=8mm
\end_layout
\begin_layout LyX-Code
\backslash
TopBorder=9mm
\end_layout
\begin_layout LyX-Code
\backslash
BottomBorder=2mm
\end_layout
\begin_layout Standard
Ceci est la configuration pour des feuilles d'étiquette Avery®, référence
#5360.
Vous êtes maintenant prêt à imprimer des étiquettes, mais si vous devez
insérer du code LaTeX, placez les commandes
\family typewriter
\backslash
begin{labels}
\family default
et
\family typewriter
\backslash
end{labels}
\family default
autour de chaque étiquette.
C'est expliqué dans la documentation du paquetage, ainsi que d'autres fonctions
de celui-ci.
\end_layout
\begin_layout Standard
Un jour, quelqu'un écrira peut-être une fonction de LyX pour supporter directeme
nt ce paquetage.
Peut-être même que ce sera vous.
\end_layout
\begin_layout Subsubsection
Exemple 3 : Indentation de paragraphe
\end_layout
\begin_layout Standard
Les Américains ont l'habitude d'indenter la première ligne de
\emph on
chaque
\emph default
paragraphe.
Comme avec toutes leurs autres mœurs étranges, la plupart des Américains
vont se plaindre et récriminer jusqu'à ce qu'ils aient ce qu'ils veulent,
et qu'ils puissent indenter la première ligne de chaque paragraphe.
\end_layout
\begin_layout Standard
Bien sûr, cette habitude n'est pas typographiquement correcte.
Dans des livres, vous n'indentez en général la première ligne d'un paragraphe
\emph on
que
\emph default
s'il en suit un autre.
L'idée derrière l'indentation de la première ligne est de pouvoir distinguer
deux paragraphes consécutifs.
S'il y a pas de paragraphe précédent, par exemple s'il suit une figure,
ou si c'est le premier paragraphe d'une section, alors il n'y a pas d'indentati
on spéciale.
\end_layout
\begin_layout Standard
Si vous êtes un Américain typique
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT : Ce qui m'étonnerait, mais on ne sait jamais!
\end_layout
\end_inset
, cependant, vous ne vous occupez pas de choses aussi ésotériques ; vous
voulez votre indentation ! Ajoutez ceci au préambule :
\end_layout
\begin_layout LyX-Code
\backslash
usepackage{indentfirst}
\end_layout
\begin_layout Standard
Si votre distribution TeX n'est pas un vieux coucou, vous avez ce paquetage,
et tous vos paragraphes auront l'indentation que vous pensez qu'ils méritent.
\end_layout
\begin_layout Subsubsection
Exemple 4 : Ce document
\end_layout
\begin_layout Standard
Vous pouvez aussi aller voir le préambule de ce document pour avoir une
idée de certaines possibilités avancées.
La fenêtre
\family sans
Préambule
\begin_inset space ~
\end_inset
LaTeX
\family default
risque de ne pas être visible en une fois, même en plein écran.
Il y a aussi d'autres exemples et un assortiment de
\begin_inset Quotes fld
\end_inset
trucs et astuces
\begin_inset Quotes frd
\end_inset
LaTeX dans le chapitre
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "cha:secrets"
\end_inset
.
\end_layout
\begin_layout Section
LyX et les erreurs LaTeX
\end_layout
\begin_layout Standard
Quand LyX invoque LaTeX, il lui dit d'ignorer toute erreur et de continuer.
Il se sert ensuite du fichier log de LaTeX pour en faire l'autopsie.
S'il y a une erreur quelque part, LyX ouvre une boîte avec un listing d'erreurs.
Cliquer sur l'une d'elles déplace le curseur à l'emplacement approprié
dans le document
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
LyX fera occasionnellement des déductions fausses sur l'emplacement de l'erreur.
Ça arrivera surtout dans les tableaux, les figures, les math et le préambule.
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
Quelques-uns préfèrent regarder le fichier journal directement, il est accessibl
e par
\family sans
Document\SpecialChar \menuseparator
Fichier
\begin_inset space ~
\end_inset
log
\begin_inset space ~
\end_inset
LaTeX
\family default
.
Il y a quelques erreurs et avertissements assez fréquents.
Nous allons les traiter ici.
Vous devriez vous reporter à un bon livre sur LaTeX pour une liste complète.
\end_layout
\begin_layout Itemize
\family typewriter
\begin_inset Quotes fld
\end_inset
LaTeX Warning
\begin_inset Quotes frd
\end_inset
\end_layout
\begin_deeper
\begin_layout Standard
Tout ce qui commence par ces mots est un message d'avertissement destiné
à
\begin_inset Quotes fld
\end_inset
déboguer
\begin_inset Quotes frd
\end_inset
le code LaTeX lui-même.
Vous aurez des messages de ce type si vous avez ajouté ou changé des références
croisées ou des entrées de bibliographie, auquel cas LaTeX essaye de vous
dire que vous devez l'exécuter une nouvelle fois.
\end_layout
\begin_layout Standard
Vous pouvez en général les ignorer.
\end_layout
\end_deeper
\begin_layout Itemize
\family typewriter
\begin_inset Quotes fld
\end_inset
LaTeX Font Warning
\begin_inset Quotes frd
\end_inset
\end_layout
\begin_deeper
\begin_layout Standard
Un autre message d'avertissement, cette fois au sujet de polices que LaTeX
n'a pas trouvées.
Le reste du message indiquera souvent la police de substitution que LaTeX
a choisi.
\end_layout
\begin_layout Standard
Vous pouvez les ignorer sans crainte.
\end_layout
\end_deeper
\begin_layout Itemize
\family typewriter
\begin_inset Quotes fld
\end_inset
Overfull
\backslash
hbox
\begin_inset Quotes frd
\end_inset
\end_layout
\begin_deeper
\begin_layout Standard
LaTeX
\emph on
adore
\emph default
cracher ce genre de messages.
Ils vous préviennent que les lignes sont trop longues et débordent sur
la marge de droite.
C'est presque toujours impossible à déceler dans le rendu final.
Ou bien seuls un ou deux caractères débordent sur la marge.
On dirait que LaTeX génère au moins un message de ce type pour chaque document
que vous écrivez.
\end_layout
\begin_layout Standard
Vous pouvez ignorer ces messages stupides.
Vos yeux vous diront bien s'il y a quelque chose de trop large ; vous n'avez
qu'à regarder ce qui sort.
\end_layout
\end_deeper
\begin_layout Itemize
\family typewriter
\begin_inset Quotes fld
\end_inset
Underfull
\backslash
hbox
\begin_inset Quotes frd
\end_inset
\end_layout
\begin_deeper
\begin_layout Standard
Pas aussi courant que son cousin.
LaTeX semble préférer imprimer des lignes un peu trop larges plutôt qu'un
peu trop étroites.
Nous ne savons pas pourquoi.
\end_layout
\begin_layout Standard
Vous pouvez tout autant les ignorer que les précédents.
\end_layout
\end_deeper
\begin_layout Itemize
\family typewriter
\begin_inset Quotes fld
\end_inset
Overfull
\backslash
vbox
\begin_inset Quotes frd
\end_inset
\family default
et
\family typewriter
\begin_inset Quotes fld
\end_inset
Underfull
\backslash
vbox
\begin_inset Quotes frd
\end_inset
\end_layout
\begin_deeper
\begin_layout Standard
Des avertissements sur des problèmes de saut de page.
À nouveau, vous n'avez qu'à regarder ce qui sort.
Vous verrez bien si quelque chose ne va pas.
\end_layout
\end_deeper
\begin_layout Itemize
\family typewriter
\begin_inset Quotes fld
\end_inset
LaTeX Error: File 'Xxxx' not found
\begin_inset Quotes frd
\end_inset
\end_layout
\begin_deeper
\begin_layout Standard
Le fichier
\family typewriter
\begin_inset Quotes fld
\end_inset
Xxxx
\begin_inset Quotes frd
\end_inset
\family default
n'est pas présent sur ce système.
Ceci apparaît habituellement parce qu'un paquetage nécessaire à votre document
n'est pas installé.
Si vous n'avez pas touché au préambule ou si vous n'avez pas utilisé la
commande
\family typewriter
\backslash
usepackage{}
\family default
, alors un des paquetages que LyX a essayé de charger est manquant.
Faites
\family sans
Aide\SpecialChar \menuseparator
Configuration
\begin_inset space ~
\end_inset
LaTeX
\family default
pour voir la liste des paquetages dont LyX a entendu parler.
Ce fichier est mis à jour à chaque fois que vous reconfigurez LyX (avec
\family sans
Outils\SpecialChar \menuseparator
Reconfigurer
\family default
) et vous dit quels paquetages ont été détectés et à quoi ils servent.
\end_layout
\begin_layout Standard
Si vous
\emph on
avez
\emph default
utilisé la commande
\family typewriter
\backslash
usepackage{}
\family default
, et que le paquetage en question n'est pas installé, vous devez l'installer
vous-même.
\end_layout
\end_deeper
\begin_layout Itemize
\family typewriter
\begin_inset Quotes fld
\end_inset
LaTeX Error: Unknown option
\begin_inset Quotes frd
\end_inset
\end_layout
\begin_deeper
\begin_layout Standard
Les messages d'erreur commençant ainsi essayent de vous dire que vous avez
spécifié une option impossible ou inexistante dans un paquetage.
Vérifiez dans sa documentation.
\end_layout
\end_deeper
\begin_layout Itemize
\family typewriter
\begin_inset Quotes fld
\end_inset
Undefined control sequence
\begin_inset Quotes frd
\end_inset
\end_layout
\begin_deeper
\begin_layout Standard
Si vous avez inséré du code LaTeX dans votre document, et fait une faute
de frappe, vous aurez un de ceux-là.
Vous pouvez aussi avoir oublié de charger un paquetage.
Dans tous les cas, d'habitude ce message d'erreur veut dire que vous avez
utilisé une commande inconnue.
\end_layout
\end_deeper
\begin_layout Standard
Il y a d'autres messages d'erreur et d'avertissement.
Quelques-uns sont explicites
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT : Pour un anglophone...
\end_layout
\end_inset
.
Ce sont souvent des messages LaTeX.
D'autres sont carrément incompréhensibles.
Ce sont en fait des messages d'erreur TeX, et nous n'avons vraiment
\emph on
aucune idée
\emph default
de ce qu'ils signifient ou de comment les déchiffrer.
Personne ne le sait.
\end_layout
\begin_layout Standard
Voici une liste de vérifications à effectuer si vous êtes confronté à des
messages d'erreur :
\end_layout
\begin_layout Enumerate
cherchez d'éventuelles fautes de frappe dans le code LaTeX que vous avez
inséré;
\end_layout
\begin_layout Enumerate
s'il n'y a pas de fautes de frappe, vérifiez que vous avez utilisé les commandes
correctement;
\end_layout
\begin_layout Enumerate
si vous avez un paquet de boîtes d'erreur entassées tout en haut du document
― et surtout si vous voyez
\begin_inset Quotes fld
\end_inset
\family typewriter
Missing
\backslash
begin{document}
\family default
\begin_inset Quotes frd
\end_inset
, ça veut dire qu'il y a des erreurs dans le préambule.
Commencez par corriger votre préambule;
\end_layout
\begin_layout Enumerate
si vous n'avez rien ajouté au préambule et si vous n'avez pas ajouté de
code LaTeX au document, le suspect numéro un est votre distribution LaTeX
elle-même.
Vérifiez s'il manque des paquetages et rajoutez-les;
\end_layout
\begin_layout Enumerate
très bien, il ne manque aucun paquetage.
Avez-vous utilisé une des options de réglage fin de LyX ? Plus précisément,
avez-vous
\emph on
mal utilisé
\emph default
l'une d'entre elles, en essayant par exemple d'insérer manuellement des
tas de
\family sans
Blancs
\begin_inset space ~
\end_inset
Insécables
\family default
, de sauts de paragraphe ou de sauts de page ? Avez-vous essayé de bricoler
quelque chose avec tout ça au lieu d'utiliser les environnements de paragraphe
appropriés ?
\end_layout
\begin_layout Enumerate
d'accord, vous n'avez utilisé aucune des options de réglage fin, vous avez
joué dans les règles.
Avez-vous essayé une manœuvre bizarre ? Avez-vous fait quelque chose de
pas net dans un tableau ou une équation, comme insérer un graphique dans
une case de tableau ?
\end_layout
\begin_layout Enumerate
Avez-vous de longues portions de texte dans lesquelles LaTeX ne peut pas
trouver d'endroit où passer à la ligne ? Par défaut, LaTeX est assez strict
avec la quantité d'espace entre les mots qu'il va ajouter pour passer à
la ligne.
Il est alors préférable que vous retravailliez le paragraphe pour éviter
le problème.
Si ce n'est pas envisageable, vous pouvez entourer votre texte par
\family typewriter
\backslash
sloppypar
\family default
pour que les passages à la ligne de LaTeX soient plus souples;
\end_layout
\begin_layout Enumerate
avez-vous exagéré avec l'imbrication ? LyX (actuellement) ne vérifie pas
que vous restez dans les limites de l'imbrication d'environnements.
Si vous avez imbriqué un tas d'environnements jusqu'au
\begin_inset Formula $17^{e}$
\end_inset
niveau, le problème est là;
\end_layout
\begin_layout Enumerate
vous n'avez obtenu aucun message d'erreur, mais votre rendu ne ressemble
pas à grand chose.
Si vous avez un tableau ou une figure qui est trop large ou trop haute
pour la page, vous devez :
\end_layout
\begin_deeper
\begin_layout Enumerate
mettre la figure à l'échelle pour qu'elle tienne.
\end_layout
\begin_layout Enumerate
rétrécir le tableau pour qu'il tienne.
\end_layout
\end_deeper
\begin_layout Enumerate
Si quelque chose d'autre ne va pas avec le rendu, et que vous n'avez rien
essayé de bizarre ni bricolé avec les réglages fins, nous ne savons pas
trop ce qui cloche.
\end_layout
\begin_layout Standard
Si vous n'êtes pas plus avancé avec tout ceci et bien,
\emph on
peut-être
\emph default
que vous avez trouvé une erreur dans LyX\SpecialChar \ldots{}
\end_layout
\begin_layout Chapter
Outils supplémentaires
\end_layout
\begin_layout Section
Personnaliser une bibliographie avec BibTeX
\end_layout
\begin_layout Standard
L'essentiel des bases de l'utilisation de BibTeX sont décrites dans le paragraph
e
\emph on
Les bases de données bibliographiques (BibTeX)
\emph default
du
\emph on
Guide de l'utilisateur
\emph default
.
Les paragraphes qui suivent détaillent les fonctionnalités bibliographiques
particulières qui sont accessibles depuis LyX.
\end_layout
\begin_layout Subsection
Autres styles de citation
\end_layout
\begin_layout Standard
Le style standard de BibTeX utilise des nombres (par exemple
\begin_inset Quotes fld
\end_inset
[12]
\begin_inset Quotes frd
\end_inset
) pour faire référence à un ouvrage cité.
Cependant, dans de nombreuses disciplines scientifiques, on utilise d'autres
styles de citations.
Le plus courant et le style auteur-année (par exemple
\begin_inset Quotes fld
\end_inset
Knuth 1984a
\begin_inset Quotes frd
\end_inset
).
LyX gère deux paquetages qui fournissent ce style,
\family typewriter
natbib
\family default
et
\family typewriter
jurabib
\family default
.
Ces deux paquetage ont leurs avantages et leurs inconvénients qui ne peuvent
être listés ici en détail.
Si vous voulez seulement avoir un simple style auteur-année (ou auteur-nombre)
ou si vous voulez utiliser un des innombrables fichiers de styles pour
natbib, alors vous choisirez probablement le paquetage
\family typewriter
natbib
\family default
qui est réputé.
Si vous avez besoin de fonctions spéciales comme des titres courts pour
les références, ibidem etc., vous pouvez envisager d'utiliser le paquetage
plus récent
\family typewriter
jurabib
\family default
.
\end_layout
\begin_layout Standard
L'utilisation de ces deux paquetages avec LyX est sensiblement la même.
Allez dans le menu
\family sans
Document\SpecialChar \menuseparator
Paramètres
\family default
et choisissez la rubrique
\family sans
Bibliographie
\family default
.
Choisissez ensuite
\family sans
Natbib
\family default
ou
\family sans
Jurabib
\family default
.
Avec ces deux paquetages, vous aurez des options supplémentaires dans le
dialogue
\family sans
Citation
\family default
et vous pourrez choisir le style de la référence (
\begin_inset Quotes fld
\end_inset
Knuth 1984
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
Knuth (1984),
\begin_inset Quotes fld
\end_inset
Knuth, 1984
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
1984
\begin_inset Quotes frd
\end_inset
etc.).
Notez que ces deux paquetages nécessitent des fichiers de style spécifiques
(ils sont fournis avec leur propres fichiers, mais on peut trouver beaucoup
de fichiers de style supplémentaires et même un programme interactif pour
construire des fichiers de style
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Voyez
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
ftp://ctan.tug.org/tex-archive/macros/latex/contrib/custom-bib/
\end_layout
\end_inset
\end_layout
\end_inset
pour
\family typewriter
natbib
\family default
).
\end_layout
\begin_layout Subsection
Bibliographies sectionnées
\begin_inset CommandInset label
LatexCommand label
name "sub:Bibliographies-sectionnées"
\end_inset
\end_layout
\begin_layout Standard
Parfois vous avez besoin de diviser votre bibliographie en plusieurs sections.
Si par exemple, vous êtes un historien, la possibilité de séparer les sources
et les travaux scientifiques est vraisemblablement une possibilité
\begin_inset Quotes fld
\end_inset
indispensable
\begin_inset Quotes frd
\end_inset
.
Malheureusement, BibTeX ne vous permet pas lui-même de faire cela.
La bonne nouvelle : Avec l'aide de quelques paquetages LaTeX, on peut étendre
BibTeX pour satisfaire vos besoins historiques.
\end_layout
\begin_layout Standard
LyX fournit un support natif d'un de ces paquetages,
\family typewriter
bibtopic
\family default
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Disponible sur
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
ftp://ctan.tug.org/tex-archive/macros/latex/contrib/bibtopic/
\end_layout
\end_inset
\end_layout
\end_inset
.
L'avantage de ce paquetage (comparé à d'autres comme
\family typewriter
multibib
\family default
) est que n'avez pas besoin de définir de nouvelles commandes de citation.
À la place, vous aurez à préparer des bases de données bibliographiques
différentes pour les différentes sections de votre bibliographie.
Par exemple, si vous voulez diviser votre bibliographie en deux sections
\begin_inset Quotes fld
\end_inset
sources
\begin_inset Quotes frd
\end_inset
et
\begin_inset Quotes fld
\end_inset
travaux scientifiques
\begin_inset Quotes frd
\end_inset
, vous devez d'abord créer deux bases de données, par exemple
\family typewriter
sources.bib
\family default
et
\family typewriter
scientifique.bib
\family default
.
\end_layout
\begin_layout Standard
Dans LyX, allez dans le menu
\family sans
Document\SpecialChar \menuseparator
Paramètres
\family default
dans la rubrique
\family sans
Bibliographie
\family default
.
Activez l'option
\family sans
Bibliographies
\begin_inset space ~
\end_inset
en
\begin_inset space ~
\end_inset
sections
\family default
.
Vous pouvez maintenant insérer plusieurs bibliographies BibTeX, une par
section de votre bibliographie.
Pour revenir à notre exemple : Insérez une bibliographie BibTeX pour la
base de donnée
\family typewriter
sources.bib
\family default
et une deuxième pour la base de données
\family typewriter
scientifique.bib
\family default
.
Vous êtes libres d'utiliser le même style ou un style différent pour chaque
section.
En plus, vous pouvez choisir que votre section bibliographique contienne
\begin_inset Quotes fld
\end_inset
toutes les références citées
\begin_inset Quotes frd
\end_inset
de la base de données utilisée (ce qui est le comportement par défaut),
\begin_inset Quotes fld
\end_inset
toutes les références non citées
\begin_inset Quotes frd
\end_inset
ou encore
\begin_inset Quotes fld
\end_inset
toutes les références
\begin_inset Quotes frd
\end_inset
.
Ceci put être utile si vous voulez séparer votre bibliographie en trois
sections :
\begin_inset Quotes fld
\end_inset
Sources citées
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
Sources non citées
\begin_inset Quotes frd
\end_inset
et
\begin_inset Quotes fld
\end_inset
Travaux scientifiques
\begin_inset Quotes frd
\end_inset
.
Les titres des sections peuvent être ajoutés comme des entêtes de section
ou de sous-section ordinaires.
Puisque
\family typewriter
bibtopic
\family default
supprime le titre de la bibliographie, vous devez aussi le remettre manuellemen
t ( comme un chapitre* ou une section*, par exemple).
\end_layout
\begin_layout Subsection
Bibliographies multiples
\end_layout
\begin_layout Standard
Les bibliographies multiples, par exemple une bibliographie par section
ou par chapitre, ne sont pas gérées par BibTeX lui-même.
Mais le paquetage
\family typewriter
bibtopic
\family default
, qui est utilisé pour créer des bibliographies en sections avec LyX (voir
le paragraphe précédents), fournit un moyen aisé de résoudre ce problème,
si vous êtes prêt à utiliser un peu de
\family typewriter
code LaTeX
\family default
(voir section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:Insérer-du-code-LaTeX"
\end_inset
)
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Une autre approche consiste à utiliser les paquetages LaTeX
\family typewriter
chapterbib
\family default
ou
\family typewriter
bibunits
\family default
.
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
D'abord, allez dans le menu
\family sans
Document\SpecialChar \menuseparator
Paramètres
\family default
, choisissez la rubrique Bibliographie et activez l'option
\family sans
Bibliographies
\begin_inset space ~
\end_inset
en
\begin_inset space ~
\end_inset
sections
\family default
.
Dans votre document vous devez inclure les sections qui auront leur propre
bibliographie (en incluant la référence BibTeX elle-même), entre un
\family typewriter
\backslash
begin{btUnit}
\family default
et un
\family typewriter
\backslash
end{btUnit}
\family default
(ces commandes doivent être mises en
\family typewriter
code TeX)
\family default
.
La bibliographie contiendra toutes les références qui ont été citées dans
la
\family typewriter
btUnit
\family default
courante.
\series bold
Attention
\series default
: si vous utilisez cette approche,
\emph on
toutes
\emph default
les références doivent se trouver à l'intérieur d'une
\family typewriter
btUnit
\family default
.
En plus les
\family typewriter
btUnits
\family default
ne peuvent pas être emboîtées.
\end_layout
\begin_layout Standard
\end_layout
\begin_layout Section
Documents en plusieurs fichiers
\end_layout
\begin_layout Subsection
Généralités
\end_layout
\begin_layout Standard
Quand on travaille sur un gros fichier avec de nombreux chapitres, il est
souvent pratique de diviser le document en plusieurs fichiers ; par ailleurs,
il arrive qu'un élément comme un tableau soit susceptible de modifications
ultérieures, alors que le reste du texte ne changera plus.
Dans ces cas-là, il est judicieux d'utiliser les possibilités de segmentation
de documents.
Ainsi, les communications scientifiques ont souvent cinq chapitres principaux
: introduction, observations, résultats, discussion, conclusion.
Chacun d'entre eux peut constituer un fichier LyX séparé, avec un fichier
\begin_inset Quotes fld
\end_inset
maître
\begin_inset Quotes frd
\end_inset
qui contient le titre, les auteurs, le résumé, les références, etc.
Il convient de noter que chacun des fichiers est un fichier LyX en lui-même,
qui peut aussi bien être mis en page et imprimé seul, qu'être inclus dans
le document maître.
Tous ces fichiers doivent cependant avoir la même classe de document
n'essayez pas de mélanger la classe
\family sans
book
\family default
avec la classe
\family sans
article
\family default
.
Il est également possible d'inclure des fichiers LaTeX : cependant, ces
fichiers doivent alors être sans leur préambule (c'est-à-dire sans la partie
jusqu'à la ligne
\family typewriter
\backslash
begin{document}
\family default
incluse, et sans la ligne
\family typewriter
\backslash
end{document}
\family default
) pour éviter des erreurs à la création du fichier DVI.
\end_layout
\begin_layout Standard
LyX permet l'inclusion de fichiers en sélectionnant
\family sans
\bar under
I
\bar default
nsérer\SpecialChar \menuseparator
Fichier\SpecialChar \menuseparator
Sous-document
\family default
, ce qui positionne une balise à l'endroit du curseur.
Un clic sur cette balise ouvre une fenêtre qui permet de saisir le nom
du fichier et la méthode d'inclusion.
\end_layout
\begin_layout Standard
Les trois méthodes d'inclusion sont
\begin_inset Quotes fld
\end_inset
\family sans
inclus (include)
\family default
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
\family sans
incorporé (input)
\family default
\begin_inset Quotes frd
\end_inset
, et
\begin_inset Quotes fld
\end_inset
\family sans
Verbatim
\family default
\begin_inset Quotes frd
\end_inset
.
La différence entre
\begin_inset Quotes fld
\end_inset
inclus
\begin_inset Quotes frd
\end_inset
et
\begin_inset Quotes fld
\end_inset
incorporé
\begin_inset Quotes frd
\end_inset
nécessite une bonne connaissance de LaTeX, mais la différence pratique
est que les fichiers
\begin_inset Quotes fld
\end_inset
inclus
\begin_inset Quotes frd
\end_inset
commenceront sur une nouvelle page, alors que ceux
\begin_inset Quotes fld
\end_inset
incorporés
\begin_inset Quotes frd
\end_inset
commenceront sur la page en cours.
\end_layout
\begin_layout Standard
Le fichier maître est généralement converti en un fichier LaTeX complet
avant d'être mis en page, tandis que les fichiers inclus sont convertis
en fichiers LaTeX sans les informations de préambule.
En cochant la case
\family sans
Formatage
\begin_inset space ~
\end_inset
désactivé
\family default
, cette conversion n'aura pas lieu.
\end_layout
\begin_layout Standard
Un fichier inclus en
\begin_inset Quotes fld
\end_inset
verbatim
\begin_inset Quotes frd
\end_inset
vous permet d'insérer un texte mis en forme exactement comme il apparaît
dans le fichier d'origine.
Normalement, les espaces dans ce fichier sont invisibles, cependant, deux
espaces consécutives sont conservées, a contrario des règles habituelles
de LyX.
Cependant, cocher l'option
\family sans
Marquer
\begin_inset space ~
\end_inset
les
\begin_inset space ~
\end_inset
espaces
\family default
résout toute incertitude en matérialisant chaque espace par un symbole.
\end_layout
\begin_layout Subsection
Références croisées entre fichiers
\end_layout
\begin_layout Standard
\lang english
\begin_inset Box Shadowbox
position "t"
hor_pos "c"
has_inner_box 1
inner_pos "t"
use_parbox 0
use_makebox 0
width "100col%"
special "none"
height "1in"
height_special "totalheight"
status open
\begin_layout Plain Layout
Ce paragraphe est quelque peu obsolète.
Il faudrait décrire les documents maîtres implicites et comment les sous-docume
nts s'ouvrent en même temps que le document maître.
[[AFAIRE]]
\end_layout
\end_inset
\lang french
Il est possible de faire des références croisées entre différents fichiers.
D'abord, il faut ouvrir tous les fichiers concernés : appelons-les A et
B pour un exemple avec deux fichiers, avec B inclus dans A.
Supposons que nous ayons inséré une étiquette dans A, à laquelle nous voulons
faire référence dans B.
Il faut ouvrir la fenêtre de référence croisée à partir de B, et il est
alors possible de choisir le
\begin_inset Quotes fld
\end_inset
tampon
\begin_inset Quotes frd
\end_inset
à utiliser.
\end_layout
\begin_layout Subsection
Listes bibliographiques dans tous les sous-documents
\end_layout
\begin_layout Standard
\begin_inset Box Frameless
position "t"
hor_pos "c"
has_inner_box 1
inner_pos "t"
use_parbox 0
use_makebox 0
width "100col%"
special "none"
height "1in"
height_special "totalheight"
status open
\begin_layout Plain Layout
Ce paragraphe nécessite également une mise à jour.
Il y a aujourd'hui des informations sur ce point dans le wiki, qui pourraient
être copiées ici.
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Copier la liste bibliographique avec toutes ses entrées dans tous les sous-docum
ents.
De cette façon LyX trouvera les fichiers
\family typewriter
.bib
\family default
et vous pouvez facilement insérer les références en masquant la liste des
bibliographies.
\end_layout
\begin_layout Standard
Si la liste des bibliographies est dans un commentaire, LaTeX ne l'inclura
pas dans la sortie imprimable et les références s'afficheront comme [?],
au lieu de [1].
Une solution est d'utiliser le paquetage
\family typewriter
comment
\family default
qui n'inclura les commentaires que lors des traitements séparés des fichiers.
Pour ce faire, ajouter, dans le préambule LaTeX de chaque sous-document
les lignes suivantes;
\end_layout
\begin_layout LyX-Code
\backslash
usepackage{comment}
\end_layout
\begin_layout LyX-Code
\backslash
includecomment{comment}
\end_layout
\begin_layout Standard
Voir aussi
\begin_inset Flex URL
status open
\begin_layout Plain Layout
http://wiki.lyx.org/FAQ/Unsorted#toc31
\end_layout
\end_inset
.
\end_layout
\begin_layout Section
Archives LyX
\end_layout
\begin_layout Standard
Les utilisateurs ont parfois besoin de
\begin_inset Quotes fld
\end_inset
relier
\begin_inset Quotes frd
\end_inset
un fichier LyX avec toutes les images (et d'autres fichiers dont il dépend,
soit pour l'envoyer à un éditeur, soit pour le partager avec un co-auteur.
Lyx-2.0 inclut un script Python (
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
lyxpak.py
\end_layout
\end_inset
) qui automatise le processus.
Pour l'utiliser, il faut que l'un des modules Python
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
zipfile
\end_layout
\end_inset
ou
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
tarfile
\end_layout
\end_inset
soit installé sur votre système.
Implicitement, le script préfère l'archive
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
tar
\end_layout
\end_inset
compressée par
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
gzip
\end_layout
\end_inset
sur les systèmes Unix et le format
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
zip
\end_layout
\end_inset
sur Windows.
\end_layout
\begin_layout Standard
La procédure de configuration de LyX positionne le script pour qu'il exporte
une
\begin_inset Quotes fld
\end_inset
Archive LyX
\begin_inset Quotes frd
\end_inset
, et ce format sera disponible via
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Fichier\SpecialChar \menuseparator
Exporter
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
Indépendamment du système d'exploitation, la création d'un format d'archive
particulier peut être imposée en ajoutant soit l'option
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-t
\end_layout
\end_inset
(pour le format
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
tar
\end_layout
\end_inset
) soit l'option
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-z
\end_layout
\end_inset
(pour le format
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
zip
\end_layout
\end_inset
) au convertisseur
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
LyX \SpecialChar \menuseparator
Archive LyX
\end_layout
\end_inset
dans
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Outils\SpecialChar \menuseparator
Préférences\SpecialChar \menuseparator
Gestion des fichiers\SpecialChar \menuseparator
Convertisseurs
\end_layout
\end_inset
(veillez bien à ajouter l'option après le nom du script, pas avant).
\end_layout
\begin_layout Section
En-têtes et pieds de page sur mesure
\end_layout
\begin_layout Standard
Le format de page implicite est assez banal : pour un document avec la classe
article, tout ce que vous obtenez se limite au numéro de page en bas de
la feuille.
Ce document-ci est de la classe
\begin_inset Quotes fld
\end_inset
book (KOMA script)
\begin_inset Quotes frd
\end_inset
(livre), donc il est un peu plus fourni, mais pour réellement en mettre
plein la vue, il faut choisir la mise en page
\begin_inset Quotes fld
\end_inset
fancy
\begin_inset Quotes frd
\end_inset
, comme l'explique le
\emph on
Guide
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
l'Utilisateur
\emph default
.
Cette section décrit les codes LaTeX qu'il vous faudra insérer dans votre
préambule LaTeX ou dans le texte pour obtenir les effets désirés.
Pour plus d'information sur les en-têtes sophistiqués, voir la documentation
du paquetage
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
fancyhdr
\end_layout
\end_inset
\lang english
(
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
http://www.ctan.org/tex-archive/help/Catalogue/entries/fancyhdr.html
\end_layout
\end_inset
).
\end_layout
\begin_layout Standard
L'en-tête est divisé en trois champs, appelés logiquement
\begin_inset Quotes fld
\end_inset
gauche
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
centre
\begin_inset Quotes frd
\end_inset
et
\begin_inset Quotes fld
\end_inset
droit
\begin_inset Quotes frd
\end_inset
.
Le bas de page aussi a ces trois divisions.
Les commandes LaTeX pour éditer ces champs de la manière la plus simple
sont
\family typewriter
\backslash
lhead
\family default
,
\family typewriter
\backslash
chead
\family default
,
\family typewriter
\backslash
rhead
\family default
,
\family typewriter
\backslash
lfoot
\family default
, etc.
Si vous voulez mettre votre nom dans le coin en haut à gauche de chaque
page, insérez simplement cette commande dans le préambule :
\end_layout
\begin_layout Standard
\family typewriter
\backslash
lhead{Jean D.
Rédacteur}
\end_layout
\begin_layout Standard
Vous verrez désormais votre nom dans le coin supérieur gauche.
Si un champ a une entrée par défaut que vous souhaitez supprimer (comme
le numéro de page apparaissant en bas, centré), insérez simplement une
commande avec un paramètre vide, par exemple :
\end_layout
\begin_layout Standard
\family typewriter
\backslash
cfoot{}
\end_layout
\begin_layout Standard
Maintenant, plus dur : mettons le mot
\begin_inset Quotes fld
\end_inset
Section
\begin_inset Quotes frd
\end_inset
et le numéro de la section en cours (par exemple Section
\begin_inset space ~
\end_inset
3) dans le coin supérieur gauche, le numéro de page en haut à droite, votre
nom en bas à gauche et la date en bas à droite.
Les commandes suivantes doivent donc apparaître dans votre préambule :
\end_layout
\begin_layout Standard
\family typewriter
\backslash
lhead{Section
\backslash
thesection}
\end_layout
\begin_layout Standard
\family typewriter
\backslash
chead{}
\end_layout
\begin_layout Standard
\family typewriter
\backslash
rhead{Page
\backslash
thepage}
\end_layout
\begin_layout Standard
\family typewriter
\backslash
lfoot{Jean D.
Rédacteur}
\end_layout
\begin_layout Standard
\family typewriter
\backslash
cfoot{}
\end_layout
\begin_layout Standard
\family typewriter
\backslash
rfoot{
\backslash
today}
\end_layout
\begin_layout Standard
Les codes
\family typewriter
\backslash
thesection
\family default
et
\family typewriter
\backslash
thepage
\family default
permettent d'accéder aux compteurs LaTeX de section et de page, et d'afficher
ainsi les numéros de la section et de la page en cours.
\family typewriter
\backslash
today
\family default
affiche simplement la date d'aujourd'hui.
\end_layout
\begin_layout Standard
L'épaisseur de la barre horizontale dessinée au dessous de l'en-tête et
au dessus du pied de page peut elle aussi être modifiée.
Si vous n'en voulez pas, mettez sa largeur à 0.
Par défaut, la barre d'en-tête a une épaisseur de 0,4
\begin_inset space ~
\end_inset
pt, et celle de pied de page une épaisseur de 0.
Pour régler l'épaisseur, utilisez les commandes
\family typewriter
\backslash
renewcommand\SpecialChar \-
{
\backslash
headrulewidth}\SpecialChar \-
{0.4pt}
\family default
et
\family typewriter
\backslash
renewcommand\SpecialChar \-
{
\backslash
footrulewidth}\SpecialChar \-
{0.4pt}
\family default
.
\end_layout
\begin_layout Standard
Vous pouvez activer ou désactiver les paramètres d'en-tête et de pied de
page pour une page donnée avec, par exemple :
\family typewriter
\backslash
thispagestyle\SpecialChar \-
{empty}
\family default
,
\family typewriter
\backslash
thispagestyle\SpecialChar \-
{plain}
\family default
, et
\family typewriter
\backslash
thispagestyle\SpecialChar \-
{fancy}
\family default
.
Insérez simplement ces commandes dans le texte de la page que vous voulez
modifier, et mettez-les en mode TeX.
En fait, par défaut, si vous utilisez le style global
\begin_inset Quotes fld
\end_inset
fancy
\begin_inset Quotes frd
\end_inset
, les pages de titre sont en
\begin_inset Quotes fld
\end_inset
plain
\begin_inset Quotes frd
\end_inset
, alors que les autres sont en
\begin_inset Quotes fld
\end_inset
fancy
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Standard
Il existe des commandes plus complexes qui vous permettent d'introduire
des choses dans le coin gauche des pages impaires, etc., mais nous vous
renvoyons à la documentation du paquetage
\family typewriter
fancyhdr
\family default
pour plus de précisions.
(
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
http://www.ctan.org/tex-archive/help/Catalogue/entries/fancyhdr.html
\end_layout
\end_inset
)
\end_layout
\begin_layout Standard
Enfin, il est possible d'insérer une image dans l'en-tête ou le pied de
page.
Si vous voulez insérer un logo dans le coin supérieur gauche, vous pouvez
essayer quelque chose comme :
\end_layout
\begin_layout Standard
\family typewriter
\backslash
lhead{
\backslash
resizebox{1in}{!}{
\backslash
includegraphics{logo.eps}}}
\family default
\begin_inset Newline newline
\end_inset
(il vous faudra peut-être pré-ajouter
\family typewriter
\backslash
usepackage{graphics}
\family default
avant si aucun autre fichier EPS n'est inséré dans votre document).
\end_layout
\begin_layout Standard
\end_layout
\begin_layout Section
Choix de puces dans
\family sans
ListePuces
\family default
\begin_inset CommandInset label
LatexCommand label
name "sec:puces"
\end_inset
\end_layout
\begin_layout Standard
par
\noun on
Allan Rae
\end_layout
\begin_layout Subsection
Introduction
\end_layout
\begin_layout Standard
LyX fournit 216 motifs de puces qui sont accessibles par une simple fenêtre.
Vous pouvez facilement y sélectionner la puce souhaitée pour chaque niveau
de profondeur dans l'environnement
\family sans
ListePuces
\family default
.
Ces choix sont valables pour tout le document, donc vous ne pouvez pas
spécifier différents types de puces pour différents paragraphes
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
En fait, c'est possible mais il faut le faire à la main.
\end_layout
\end_inset
.
\end_layout
\begin_layout Subsection
À quoi elles ressemblent
\end_layout
\begin_layout Standard
Allez dans la rubrique
\family sans
Puces
\family default
de la fenêtre
\family sans
Document\SpecialChar \menuseparator
Paramètres.
\end_layout
\begin_layout Standard
La fenêtre vous présente un tableau avec des formes de puces.
À gauche du tableau, une colonne de boutons vous donne accès aux six panneaux
possibles.
La rangée de boutons du haut sert à choisir le niveau de profondeur sur
lequel vous agissez.
Une boîte de texte sous le tableau affiche l'équivalent LaTeX de la forme
de puce actuellement sélectionnée, et ce champ peut être édité.
Si vous modifiez le texte vous devrez aussi spécifier à la main dans le
préambule LaTeX les paquetages requis.
\end_layout
\begin_layout Standard
Les six panneaux sont répartis selon les paquetages qu'ils nécessitent.
Le tableau suivant vous montre la correspondance entre le nom des boutons
et les paquetages LaTeX.
\end_layout
\begin_layout Standard
\align center
\begin_inset Tabular
<lyxtabular version="3" rows="7" columns="2">
<features tabularvalignment="middle">
<column alignment="center" valignment="top" width="0pt">
<column alignment="center" valignment="top" width="0pt">
<row>
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
Bouton
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
Paquetages Requis
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\family sans
Standard
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
LaTeX de base
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\family sans
Maths
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\family typewriter
amssymb.sty
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\family sans
Ding1
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\family typewriter
pifont.sty
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\family sans
Ding2
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\family typewriter
pifont.sty
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\family sans
Ding3
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\family typewriter
pifont.sty
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\family sans
Ding4
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\family typewriter
pifont.sty
\end_layout
\end_inset
</cell>
</row>
</lyxtabular>
\end_inset
\end_layout
\begin_layout Standard
LyX ne vous empêche pas d'utiliser les puces correspondant à des paquetages
que vous n'avez pas.
Si vous obtenez des erreurs LaTeX lorsque vous essayez de Visionner ou
d'imprimer le fichier, c'est sûrement qu'il vous manque un paquetage.
LyX ne vous empêche pas d'agir car vous pourriez vouloir éditer quelque
part et imprimer avec un autre système.
\end_layout
\begin_layout Subsection
Comment s'en servir
\end_layout
\begin_layout Standard
Sélectionnez le niveau de profondeur sur lequel vous voulez agir, puis le
motif de puce et la taille.
Les changements ne seront pas visibles dans LyX, mais seulement lors du
visionnement..
\end_layout
\begin_layout Standard
Vous pouvez remettre une puce à sa valeur par défaut, en cliquant avec le
bouton droit de la souris sur la profondeur de la puce en question
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Si vous voulez réellement avoir des paragraphes avec des puces différentes
dans chacun d'eux, vous devez mettre les mains dans le cambouis.
La fenêtre dont nous venons de parler est cependant utile car elle montre
en même temps l'aspect de la puce et son code LaTeX, ceci pour un grand
nombre de puces.
Pour personnaliser vos paragraphes, vous avez le choix :
\end_layout
\begin_layout Plain Layout
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
let
\backslash
savelabelitemi=
\backslash
labelitemi
\end_layout
\end_inset
\end_layout
\begin_layout Plain Layout
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
renewcommand
\backslash
labelitemi[0]{
\backslash
small
\backslash
(
\backslash
sharp
\backslash
)}
\end_layout
\end_inset
\end_layout
\begin_layout Itemize
Utilisez la commande LaTeX
\family typewriter
\backslash
renewcommand{}{}
\family default
pour spécifier un nouveau format de puce pour une profondeur donnée.
Vous aurez aussi besoin d'enregistrer le format actuel pour le restaurer
plus tard.
Dans cette liste à puces, le code LaTeX suivant a été utilisé pour changer
les puces de profondeur 1 :
\family typewriter
\begin_inset Newline newline
\end_inset
\backslash
let
\backslash
savelabelitemi=
\backslash
labelitemi
\family default
\family typewriter
\begin_inset Newline newline
\end_inset
\backslash
renewcommand
\backslash
labelitemi[0]{
\backslash
small
\backslash
(
\backslash
sharp
\backslash
)}
\begin_inset Newline newline
\end_inset
\family default
Remarquez que la profondeur de puce est donnée en chiffres romains comme
partie intégrante de la commande
\family typewriter
\backslash
labelitem
\family default
.
\end_layout
\begin_layout Itemize
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
[
\backslash
(
\backslash
star
\backslash
)]
\end_layout
\end_inset
Agissez sur chaque entrée individuellement en écrivant le motif de la puce
entre crochets en mode TeX.
Par exemple, cet élément a commencé par
\family typewriter
[
\backslash
(
\backslash
star
\backslash
)]
\family default
.
\end_layout
\begin_layout Plain Layout
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
renewcommand
\backslash
labelitemi[0]{
\backslash
savelabelitemi}
\end_layout
\end_inset
\end_layout
\begin_layout Plain Layout
Vous aurez besoin de remettre le
\family typewriter
labelitem
\family default
à sa valeur d'origine pour que les autres puces retrouvent les réglages
globaux.
Nous avons donc ici :
\family typewriter
\begin_inset Newline newline
\end_inset
\backslash
renewcommand
\backslash
labelitemi[0]{
\backslash
savelabelitemi}
\end_layout
\end_inset
.
\end_layout
\begin_layout Chapter
\lang english
LyX and the World Wide Web
\begin_inset Note Note
status open
\begin_layout Plain Layout
Chapitre restant à traduire (JPChrétien, juin 2011)
\end_layout
\end_inset
\end_layout
\begin_layout Standard
\lang english
LyX has long supported the export of documents to various web-friendly formats,
such as HTML.
Before verson 2.0, however, HTML export was always accomplished by the use
of external converters.
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
For details on the use of external converters with LyX, see the
\emph on
Converters
\emph default
section of the Customization manual.
\end_layout
\end_inset
These fall into two large groups: there are converters that use LaTeX as
an intermediate format, such as
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
htlatex
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
html2latex
\end_layout
\end_inset
, and
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
plastex
\end_layout
\end_inset
, relying upon LyX to produce the LaTeX; and there is a converter that works
directly on LyX files,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
eLyXer
\end_layout
\end_inset
.
All of these have different advantages and disadvantages.
\end_layout
\begin_layout Standard
\lang english
The LaTeX-based converters have the advantage that, in principle, they know
everything about the exported document that LaTeX does.
Such converters do not care, for example, if a certain block of code was
produced by LyX or was Evil Red Text.
These converters know about
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
aux
\end_layout
\end_inset
files, counters, and references, and can often make use of the
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
bbl
\end_layout
\end_inset
files generated by BibTeX.
On the other hand, LaTeX is a very hard language to parse---it is sometimes
said that only TeX itself understands TeX---and LaTeX-based converters
will often choke on what seem to be quite simple constructs; complex ones
can throw them completely, and as of this writing, for example, the
\emph on
Embedded Objects
\emph default
manual will not export with
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
htlatex
\end_layout
\end_inset
, though the others will.
The other issue concerns how math is handled.
These converters typically convert the formulae into little pictures that
are then linked from the HTML document.
Since these are actually generated by LaTeX, they are accurate.
But they do not scale well, and just getting them to look as if they are
actually meant to be in your document---so that the font sizes seem to
be roughly the same---can be a challenge.
\end_layout
\begin_layout Standard
\lang english
Alex Fernandez's
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
eLyXer
\end_layout
\end_inset
(
\begin_inset CommandInset href
LatexCommand href
name "http://elyxer.nongnu.org/"
target "http://elyxer.nongnu.org/"
\end_inset
) solves some of these problems.
In particular, the formulae it produces scale perfectly, since it renders
math using a combination of HTML and CSS rather than converting the formulae
to images.
But even moderately complex formula are rendered less well than with
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
htlatex
\end_layout
\end_inset
; this reflects the limitations of HTML.
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
That said,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
eLyXer
\end_layout
\end_inset
can also use jsMath and MathJax for equations, but this setting is only
available globally and requires one to have access to a server that runs
the backend.
\end_layout
\end_inset
More importantly (as of version 1.1.1, at least),
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
eLyXer
\end_layout
\end_inset
has limited support for math macros and no support for user-defined paragraph
or character styles.
These limitations make
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
eLyXer
\end_layout
\end_inset
unsuitable for many of the documents LyX users produce.
In principle, of course, these problems could be solved, but the LyX developers
have decided to follow a different path and have made LyX itself capable
of writing XHTML, just as it is capable of writing LaTeX, DocBook, and
plaintext.
\end_layout
\begin_layout Standard
\lang english
As of this writing, XHTML output remains under development and should probably
be regarded as
\begin_inset Quotes eld
\end_inset
experimental
\begin_inset Quotes erd
\end_inset
.
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
The file
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
development/HTML.notes
\end_layout
\end_inset
, which can be found in the LyX source tree or
\begin_inset CommandInset href
LatexCommand href
name "accessed online"
target "http://www.lyx.org/trac/browser/lyx-devel/trunk/development/HTML/HTML.notes"
\end_inset
, usually contains up-to-date information about the state of XHTML output.
See also the list of XHTML bugs on
\begin_inset CommandInset href
LatexCommand href
name "the bug tracker"
target "http://www.lyx.org/trac/query?status=reopened&status=assigned&status=new&max=0&component=xhtml+export&order=id&col=id&col=summary&col=reporter&col=keywords&keywords=%21%7Efixedintrunk&desc=1"
\end_inset
.
\end_layout
\end_inset
Still, the developers have chosen this approach because it has several
potential advantages over the other two.
\end_layout
\begin_layout Standard
\lang english
These advantages are primarily due to the fact that the XHTML output routines,
since they are part of LyX, know everything LyX knows about the document
being exported.
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
Another advantage is that, since these routines are internal to LyX, they
are immune to changes in LyX's file format, or to changes in the semantics
of existing insets.
\end_layout
\end_inset
So they know about the table of contents (as displayed in the outline),
about the counters associated with different paragraph styles, and about
user-defined styles.
The XHTML output routines know what LyX knows about internationalization,
too, so they will output
\begin_inset Quotes eld
\end_inset
Chapter 1
\begin_inset Quotes erd
\end_inset
or
\begin_inset Quotes eld
\end_inset
\lang ngerman
Kapitel
\lang english
1
\begin_inset Quotes erd
\end_inset
, depending upon the language in effect at the time.
\end_layout
\begin_layout Standard
\lang english
Quite generally, the output routines know what LyX knows about document
layout, that is, about how the document is to be rendered on screen.
We use this information when we output the document as XHTML.
In particular, LyX
\emph on
automatically
\emph default
generates CSS style information corresponding to the layout information
it uses to render the document on screen: if section headings are supposed
to be sans-serif and bold as seen in LyX, then (by default) they will be
sans-serif and bold when viewed in a web browser, too.
And this is true not just for pre-defined styles, like Section, but for
any style, including user-defined styles.
Indeed, the XHTML output routines make no distinction between user-defined
paragraph and character styles and LyX's own pre-defined styles: in each
case, everything LyX knows about the styles is contained in the layout
files.
And much the same is true as regards pre-defined textual insets, such as
footnotes, and various custom insets.
\end_layout
\begin_layout Standard
\lang english
The result is that XHTML output can be customized and extended in exactly
the same way LaTeX output can be customized and extended: through layout
files and modules.
See chapter five of the
\emph on
Customization
\emph default
manual for the details.
\end_layout
\begin_layout Standard
\lang english
The remainder of this chapter contains more detailed information on XHTML
output, its limitations, and ways to work around those limitations.
\end_layout
\begin_layout Section
\lang english
Math Output in XHTML
\end_layout
\begin_layout Standard
\lang english
LyX offers four choices for how math is rendered.
These have various advantages and disadvantages:
\end_layout
\begin_layout Itemize
\lang english
MathML
\begin_inset Newline newline
\end_inset
MathML is a dialect of XML designed specifically for mathematics on the
web, and it typically renders very well in browsers that support it.
The disadvantage is that not all browsers support MathML, and support is
not complete even in the Gecko-based browsers, such as Firefox.
\begin_inset Newline newline
\end_inset
If LyX is unable to render a formula as MathML---for example, if the formula
uses the
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
xymatrix
\end_layout
\end_inset
package or ERT---then it will instead output the formula as an image.
\end_layout
\begin_layout Itemize
\lang english
HTML
\begin_inset Newline newline
\end_inset
As mentioned above,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
elyxer
\end_layout
\end_inset
outputs math as HTML, styled by CSS.
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
LyX has borrowed some of the CSS for its HTML output from
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
elyxer
\end_layout
\end_inset
.
\end_layout
\end_inset
For simple formulae, this can work quite well, though with more complicated
formulae it tends to break down.
Still, this method has the advantage that it is very widely supported and
so it may be appropriate for documents that contain only a little, fairly
simple math.
\begin_inset Newline newline
\end_inset
If Lyx is unable to render a formula as HTML---for example, if the formula
uses the
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
xymatrix
\end_layout
\end_inset
package or ERT---then it will instead output the formula as an image.
\end_layout
\begin_layout Itemize
\lang english
Images
\begin_inset Newline newline
\end_inset
Like
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
htlatex
\end_layout
\end_inset
, LyX will output formulae as images, the very same images, in fact, that
are used for instant preview.
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
Instant preview does
\emph on
not
\emph default
have to be on for images to be output, however.
\end_layout
\end_inset
The advantage to this method is that the images are simply generated by
LaTeX, so they are very accurate.
The disadvantage, as mentioned earlier, is that these are bitmapped images,
so they do not scale terribly well, and one cannot copy them, etc.
(As of this writing, there are also problems about equation numbering.
See
\begin_inset CommandInset href
LatexCommand href
name "bug 6894"
target "http://www.lyx.org/trac/ticket/6894"
\end_inset
.)
\begin_inset Newline newline
\end_inset
The size of the images can be controlled by setting the
\begin_inset Quotes eld
\end_inset
Math Images Scaling
\begin_inset Quotes erd
\end_inset
parameter under
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
Document\SpecialChar \menuseparator
Settings\SpecialChar \menuseparator
Output
\end_layout
\end_inset
.
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
For those who want to know, this controls the resolution of the image in
dots per inch and is based upon a default of 75 dpi.
\end_layout
\end_inset
\begin_inset Newline newline
\end_inset
If LyX for some reason fails to create an image for a formula (e.g., if a
required LaTeX package is not installed), then it will fall back to outputing
the raw LaTeX.
\end_layout
\begin_layout Itemize
\lang english
LaTeX
\begin_inset Newline newline
\end_inset
Finally, LyX will happily output math as LaTeX.
As well as being the output of last resort, this method can be used with
such tools as
\begin_inset CommandInset href
LatexCommand href
name "jsMath"
target "http://www.math.union.edu/~dpvc/jsMath/"
\end_inset
, which uses JavaScript to render LaTeX embedded in HTML documents.
LyX wraps the LaTeX in either a
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
span
\end_layout
\end_inset
(for inline formulas) or
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
div
\end_layout
\end_inset
(for displayed formulas) with
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
class='math'
\end_layout
\end_inset
, as is required for jsMath.
\end_layout
\begin_layout Standard
\lang english
One of these output methods must be selected under
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
Document\SpecialChar \menuseparator
Settings\SpecialChar \menuseparator
Output
\end_layout
\end_inset
.
By default, LyX outputs MathML.
This is a document-wide setting, therefore.
\end_layout
\begin_layout Standard
\lang english
Eventually, LyX will offer the user the option to select an alternate output
method for a particular inset, say, one that isn't being rendered very
well by MathML.
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
That said, since LyX falls back to images if the inset contains ERT, then
one can force output as an image by putting some harmless ERT into the
math, for example:
\begin_inset Formula $a=b\relax$
\end_inset
.
\end_layout
\end_inset
\end_layout
\begin_layout Section
\lang english
Bibliography and Citations
\end_layout
\begin_layout Standard
\lang english
XHTML output fully supports bibliographies and citations.
\end_layout
\begin_layout Standard
\lang english
Citation labels are generated by the same machinery that generates LyX's
on-screen labels, so the labels will look in the output much as they do
in LyX, though better.
If you are using numerical citations, then LyX will output numerical labels,
such as [1] or [17], rather than simply showing the citation key in square
brackets, as it does on-screen.
If you are using author-year citations, then LyX will add lowercase letters
to the years, just as BibTeX does, if it finds more than one citation for
a given author-year combination.
The labels will be printed with the bibliography entries.
Note that there is, at present, no way to customize the appearance of the
labels, for example, to choose between square brackets and parentheses.
\end_layout
\begin_layout Standard
\lang english
Bibliography output is handled by the same machinery that handles the presentati
on of reference information in the citation dialog, so you will see in the
XHTML output pretty much what you would see if you were to look at a given
entry in the citation dialog.
The formatting can be customized in your layout file or, preferably, in
a module.
See the
\emph on
Customization
\emph default
manual for the details.
\end_layout
\begin_layout Standard
\lang english
The main defect at present is that cross-referenced information is printed
with every entry with which it is associated.
So you can see things like this:
\end_layout
\begin_layout Quote
\lang english
Jason Stanley,
\begin_inset Quotes eld
\end_inset
Context and Logical Form
\begin_inset Quotes erd
\end_inset
, in
\emph on
Language in Context: Selected Essays
\emph default
(Oxford: Oxford University Press, 2007), pp.
30--68.
\end_layout
\begin_layout Quote
\lang english
Jason Stanley,
\begin_inset Quotes eld
\end_inset
Semantics in Context
\begin_inset Quotes erd
\end_inset
, in
\emph on
Language in Context: Selected Essays
\emph default
(Oxford: Oxford University Press, 2007), pp.
201--30.
\end_layout
\begin_layout Standard
\lang english
This should be fixed before long.
\end_layout
\begin_layout Standard
\lang english
There is no support at present for sectioned bibliographies.
If you have multiple bibliographies, then LyX will print the same bibliography
over and over.
\end_layout
\begin_layout Section
\lang english
Indexes
\end_layout
\begin_layout Standard
\lang english
LyX will happily export indexes as XHTML, but with certain limitations at
the moment.
\end_layout
\begin_layout Standard
\lang english
Index export will be most reliable when you do not attempt to use the fancy
constructs that are described in the section on indexes in the
\emph on
User's Guide
\emph default
.
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
The main issue here is that LyX itself does not really handle these.
It just lets you enter what you would have to enter in raw LaTeX.
\end_layout
\end_inset
We'll describe how they are handled using the subsection headings from
that section.
\end_layout
\begin_layout Itemize
\lang english
Grouping Index Entries (aka, sub-entries): LyX makes an effort to support
these, but the entries must be separated by
\begin_inset Quotes eld
\end_inset
!
\begin_inset Quotes erd
\end_inset
, that is, there must be spaces around the exclamation point.
This is because it is otherwise too difficult to check for escaped exclamation
points, ones in math, and so forth.
\end_layout
\begin_layout Itemize
\lang english
Page Ranges: There is no support at all for page ranges, since these make
no sense with XHMTL.
Instead, you will just get two index entries, one at either end.
\end_layout
\begin_layout Itemize
\lang english
Cross-referencing: There is no support for cross-referencing.
If LyX finds an entry containing the
\begin_inset Quotes eld
\end_inset
|see\SpecialChar \ldots{}
\begin_inset Quotes erd
\end_inset
construct, it is just dropped, and the rest is treated as an ordinary index
entry.
\end_layout
\begin_layout Itemize
\lang english
Index Entry Order: LyX does support attempts to fix the sorting order.
It will take what is before the first `@' it finds and use that for sorting,
taking what follows the first `@' to be the actual entry.
At present, LyX does not check for escaped `@', so do not try to index
email addresses.
\end_layout
\begin_layout Itemize
\lang english
Index Entry Layout: You can format entries by using the text style dialog,
or by using any other method available within LyX itself.
There is no support for constructs like:
\begin_inset Quotes eld
\end_inset
entry|textbf
\begin_inset Quotes erd
\end_inset
.
Indeed, if LyX finds a pipe symbol, `|', in an entry, it will delete it
and everything that follows it.
\end_layout
\begin_layout Itemize
\lang english
Multiple Indexes: There is no support for multiple indexes.
Rather, all index entries will be printed as one large index.
To avoid our printing several versions of the index, we print only the
main index, so make sure you have one.
\end_layout
\begin_layout Section
\lang english
Nomenclature and Glossary
\end_layout
\begin_layout Standard
\lang english
There is at present no support for glossaries.
Adding it would be fairly trivial, and welcome.
\end_layout
\begin_layout Chapter
Le Serveur LyX
\end_layout
\begin_layout Section
Introduction
\end_layout
\begin_layout Standard
Le
\begin_inset Quotes fld
\end_inset
serveur LyX
\begin_inset Quotes frd
\end_inset
est une méthode implémentée dans LyX qui permet à d'autres programmes de
dialoguer avec LyX, d'invoquer des commandes LyX et d'obtenir de l'information
à propos de son état interne.
Tout ceci n'est destiné qu'aux utilisateurs avancés, qui devraient le trouver
utile.
C'est grâce au serveur LyX, par exemple, que des gestionnaires de bibliographie
s comme JabRef peuvent permettre de
\begin_inset Quotes fld
\end_inset
pousser
\begin_inset Quotes frd
\end_inset
des citations dans LyX.
\end_layout
\begin_layout Section
Démarrer le Serveur LyX
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
begin{sloppypar}
\end_layout
\end_inset
Le serveur LyX fonctionne par l'intermédiaire d'une paire de tubes.
Ils sont habituellement disposés dans votre répertoire utilisateur
\family typewriter
MonRép
\family default
(sauf sur Windows, ou des tubes nominatifs
\emph on
locaux
\emph default
sont des objets spéciaux localisés dans
\family typewriter
\backslash
\backslash
.
\backslash
pipe
\family default
) et portent les noms
\family typewriter
\begin_inset Quotes fld
\end_inset
.lyxpipe.in
\begin_inset Quotes frd
\end_inset
\family default
et
\family typewriter
\begin_inset Quotes fld
\end_inset
.lyxpipe.out
\begin_inset Quotes frd
\end_inset
\family default
.
Les programmes externes écrivent dans
\family typewriter
.lyxpipe.in
\family default
et lisent les données dans
\family typewriter
.lyxpipe.out
\family default
.
La racine de ces deux noms peut être définie dans la fenêtre
\family sans
Éditer\SpecialChar \menuseparator
Préférences\SpecialChar \menuseparator
Entrées\SpecialChar \menuseparator
Répertoires
\family default
, par exemple
\begin_inset Quotes fld
\end_inset
\family typewriter
/home/mon_home/.lyxpipe
\family default
\begin_inset Quotes frd
\end_inset
, ou
\family typewriter
\begin_inset Quotes fld
\end_inset
\backslash
\backslash
.
\backslash
pipe
\backslash
lyxpipe
\family default
\begin_inset Quotes frd
\end_inset
avec Windows (mais n'importe quel chemin effectif peut être utilisé).
Vous devez configurer ceci
\emph on
manuellement
\emph default
pour que le serveur puisse démarrer.
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
end{sloppypar}
\end_layout
\end_inset
\end_layout
\begin_layout Standard
LyX ajoutera les suffixes
\family typewriter
\begin_inset Quotes fld
\end_inset
.in
\begin_inset Quotes frd
\end_inset
\family default
et
\family typewriter
\begin_inset Quotes fld
\end_inset
.out
\begin_inset Quotes frd
\end_inset
\family default
pour créer les tubes.
Si l'un des ces tubes existe déjà, LyX supposera qu'un autre processus
LyX est déjà en route et ne démarrera pas le serveur.
Sur les systèmes POSIX (similaires à Unix), si pour d'autres raisons un
tube inutilisé et
\begin_inset Quotes fld
\end_inset
dormant
\begin_inset Quotes frd
\end_inset
existe à la fermeture de LyX, LyX essaiera de le supprimer.
Si ceci échoue pour une raison ou une autre, vous devrez supprimer les
tubes à la main et redémarrer LyX.
Sur Windows, les tubes sont supprimés par le système à la fermeture du
programme ou après un crash, ainsi les tubes
\begin_inset Quotes fld
\end_inset
dormants
\begin_inset Quotes frd
\end_inset
ne peuvent exister.
\end_layout
\begin_layout Standard
Pour faire tourner plusieurs processus LyX avec des serveurs en même temps,
vous devez utiliser différentes configurations, peut-être en utilisant
des répertoires utilisateurs différents, avec leurs propres
\family typewriter
préférences
\family default
, pour chaque processus.
\end_layout
\begin_layout Standard
Si vous développez un programme client, il vous sera peut-être utile d'activer
les informations de déboguage du serveur LyX.
Pour cela, démarrez LyX avec la commande
\family typewriter
lyx -dbg 8192
\family default
.
\end_layout
\begin_layout Standard
Vous pouvez trouver un exemple complet de client écrit en C dans la distribution
source sous le nom
\family typewriter
development/server_monitor.c
\family default
.
\end_layout
\begin_layout Standard
Un autre outil utile est un client en ligne de commande que vous trouverez
dans
\family typewriter
src/client/lyxclient
\family default
.
\end_layout
\begin_layout Section
Communication normale
\end_layout
\begin_layout Standard
Pour émettre un appel LyX, le client écrit une ligne de texte ASCII dans
le tube d'entrée, selon le format suivant :
\end_layout
\begin_layout LyX-Code
LYXCMD:
\emph on
nom_client
\emph default
:
\emph on
fonction
\emph default
:
\emph on
paramètre
\end_layout
\begin_layout Description
\family typewriter
\emph on
nom_client
\family default
\emph default
est un nom que le client peut choisir arbitrairement.
LyX rappelle ce nom s'il envoie une réponse un client peut donc répartir
les réponses aux différentes requêtes.
\end_layout
\begin_layout Description
\family typewriter
\emph on
fonction
\family default
\emph default
est la fonction que vous voulez faire exécuter à LyX.
C'est la commande que vous auriez entrée dans le minibuffer.
\end_layout
\begin_layout Description
\family typewriter
\emph on
paramètre
\family default
\emph default
est un paramètre optionnel qui n'est utile que pour certaines fonctions
(par exemple, le LFUN
\begin_inset Quotes fld
\end_inset
self-insert
\begin_inset Quotes frd
\end_inset
qui insère le paramètre comme du texte à la position du curseur).
\end_layout
\begin_layout Standard
La réponse de LyX arrive dans le tube de sortie sous la forme :
\end_layout
\begin_layout LyX-Code
INFO:
\emph on
nom_client
\emph default
:
\emph on
fonction
\emph default
:
\emph on
données
\end_layout
\begin_layout Standard
\family typewriter
\emph on
nom_client
\family default
\emph default
et
\family typewriter
\emph on
fonction
\family default
\emph default
sont les mêmes que dans la requête, tandis que
\family typewriter
\emph on
données
\family default
\emph default
contient des informations plus ou moins utiles selon la façon avec laquelle
la commande s'est exécutée.
Certaines commandes renvoient des informations à propos de l'état interne
de LyX, comme
\begin_inset Quotes fld
\end_inset
font-state
\begin_inset Quotes frd
\end_inset
, tandis que d'autres ne renvoient rien.
Ça signifie alors que l'exécution s'est bien passée.
\end_layout
\begin_layout Standard
En cas d'erreurs, la réponse de LyX aura la forme :
\end_layout
\begin_layout LyX-Code
ERROR:
\emph on
nom_client
\emph default
:
\emph on
fonction
\emph default
:
\emph on
message_d'erreur
\end_layout
\begin_layout Standard
où le
\family typewriter
\emph on
message_d'erreur
\family default
\emph default
doit expliquer pourquoi la commande a échoué.
\end_layout
\begin_layout Standard
Exemples :
\end_layout
\begin_layout LyX-Code
echo "LYXCMD:test:beginning-of-buffer:" >~/.lyxpipe.in
\end_layout
\begin_layout LyX-Code
echo "LYXCMD:test:get-xy:" >~/.lyxpipe.in
\begin_inset Newline newline
\end_inset
read a <~/.lyxpipe.out
\begin_inset Newline newline
\end_inset
echo $a
\end_layout
\begin_layout Section
Notification
\end_layout
\begin_layout Standard
LyX peut notifier aux clients les événements qui se produisent de manière
asynchrone.
Pour l'instant il ne le fait que si l'utilisateur associe une séquence
de touches à la fonction
\begin_inset Quotes fld
\end_inset
notify
\begin_inset Quotes frd
\end_inset
.
Voici le format de ce que LyX envoie :
\end_layout
\begin_layout LyX-Code
NOTIFY:
\emph on
séquence_touches
\end_layout
\begin_layout Standard
\family typewriter
\emph on
séquence_touches
\family default
\emph default
est la représentation imprimée de la séquence de touches réellement tapée
par l'utilisateur.
\end_layout
\begin_layout Standard
Ce mécanisme peut servir pour étendre l'ensemble des commandes LyX et implémente
r des macros : associez certaines séquences de touches à
\begin_inset Quotes fld
\end_inset
notify
\begin_inset Quotes frd
\end_inset
, démarrez un client qui écoute le tube de sortie, traite la commande selon
la séquence et démarre une fonction qui peut utiliser des appels et des
requêtes LyX pour envoyer une commande ou une série de commandes à LyX.
\end_layout
\begin_layout Section
Le protocole serveur LyX
\end_layout
\begin_layout Standard
LyX implémente un protocole simple qui peut servir à la gestion de session.
Tous les messages sont de la forme :
\end_layout
\begin_layout LyX-Code
LYXSRV:
\emph on
nom_client
\emph default
:
\emph on
message_protocole
\end_layout
\begin_layout Standard
\family typewriter
\emph on
message_protocole
\family default
\emph default
peut être
\begin_inset Quotes fld
\end_inset
hello
\begin_inset Quotes frd
\end_inset
ou
\begin_inset Quotes fld
\end_inset
bye
\begin_inset Quotes frd
\end_inset
.
Si un client reçoit
\begin_inset Quotes fld
\end_inset
hello
\begin_inset Quotes frd
\end_inset
, c'est que LyX l'informe qu'il écoute ses messages, s'il reçoit
\begin_inset Quotes fld
\end_inset
bye
\begin_inset Quotes frd
\end_inset
, c'est que LyX est en train de s'arrêter.
\end_layout
\begin_layout Section
Recherche inversée DVI/PDF
\end_layout
\begin_layout Standard
Quelques visionneuses DVI/PDF
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Les visionneuses suivantes proposent la fonction de recherche inversée en
PDF: Okular sur KDE/Linux, Skim sur Mac OSX et SumatraPDF sur Windows.
\end_layout
\end_inset
assurent la fonction de
\emph on
recherche inversée
\emph default
.
Ceci signifie que vous pouvez demander à LyX de positionner le curseur
sur une ligne particulière en cliquant sur la même ligne dans le résultat
imprimable DVI/PDF.
Pour que ceci soit possible, il faut que la visionneuse puisse communiquer
avec LyX.
C'est la cas par le serveur LyX soit par un tube nommé (
\emph on
lyxpipe
\emph default
), soit par un connecteur de domaine (
\emph on
lyxsocket
\emph default
) créé par LyX dans son répertoire temporaire (c'est comme ceci que le programme
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
lyxclient
\end_layout
\end_inset
communique avec LyX).
Dans certains cas, vous aurez besoin d'un script auxiliaire qui interface
la visionneuse et LyX, dans d'autres cas, la visionneuse peut communiquer
directement avec LyX: ceci dépend de la visionneuse sélectionnée et de
votre système d'exploitation.
La même considération s'applique pour la configuration des visionneuses
et pour le méthode d'implantation de la recherche inversée.
Dans ce qui suit, nous allons donc décrire comment configurer la recherche
inversée pour des visionneuses particulières.
mais auparavant, nous allons expliquer d'une manière générale ce qu'il
faut faire pour activer la recherche inversée depuis le résultat imprimable
DVI/PDF.
\end_layout
\begin_layout Subsection
\lang english
\begin_inset CommandInset label
LatexCommand label
name "sub:rev-search"
\end_inset
Activation automatique
\end_layout
\begin_layout Standard
Le plus souvent, LyX démarrera le serveur pour vous en activant
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Document\SpecialChar \menuseparator
Paramètres\SpecialChar \menuseparator
Sortie\SpecialChar \menuseparator
Synchroniser avec la sortie imprimable
\end_layout
\end_inset
.
Dans ce cas, LyX insérera automatiquement la macro SyncTeX (pour PDF) ou
chargera le paquetage srcltx (pour DVI).
Cette option peut être facilement atteinte depuis la barre d'outils
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Visionner/Mettre à jour
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
S'il vous faut un réglage différent, vous pouvez sélectionner ou saisir
une macro personnalisée dans la liste déroulante située juste au-dessous
de
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Document\SpecialChar \menuseparator
Paramètres\SpecialChar \menuseparator
Sortie\SpecialChar \menuseparator
Synchroniser avec la sortie imprimable
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
Notez bien que la l'inclusion des paquetages
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
srcltx
\end_layout
\end_inset
ou
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
src-specials
\end_layout
\end_inset
a quelquefois un impact imprévu sur la typographie.
Vous devrez donc supprimer la synchronisation avec la sortie imprimable
pour la compilation finale du document si vous utilisez
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
srcltx
\end_layout
\end_inset
ou
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
src-specials
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
Si vous avez besoin de réglages particuliers qui ne sont pas couverts par
la réglage automatique, lisez les paragraphes suivants consacrés à la synchroni
sation manuelle.
Si la configuration automatique vous convient, allez directement au paragraphe
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Configuration-et-utilisation"
\end_inset
, où sont décrites les étapes de la configuration dans votre visionneuse,
-- que la mise en œuvre soit automatique ou manuelle.
\end_layout
\begin_layout Subsection
Activation manuelle
\end_layout
\begin_layout Standard
LaTeX fournit plusieurs méthodes pour la recherche inversée.
Certaines sont inhérentes au programme
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
latex/pdflatex
\end_layout
\end_inset
, d'autres sont fournies par des paquetages externes.
Votre choix dépendra du fait que votre distribution LaTeX fournisse déjà
une méthode donnée (les méthodes inhérentes sont assez récentes) et du
fait que votre visionneuse puisse le gérer.
Les méthodes disponibles dont décrites dans la suite.
\end_layout
\begin_layout Subsubsection*
Recherche
\begin_inset space ~
\end_inset
inversée
\begin_inset space ~
\end_inset
DVI
\begin_inset space ~
\end_inset
inhérente
\begin_inset space ~
\end_inset
via
\begin_inset space ~
\end_inset
src-specials
\begin_inset space ~
\end_inset
(DVI
\begin_inset space ~
\end_inset
uniquement)
\end_layout
\begin_layout Standard
Cette méthode équipe le fichier DVI de l'information nécessaire pour la
recherche inversée.
Elle est disponible en LaTeX depuis quelque temps (n'importe quelle distributio
n suffisamment récente devrait l'inclure) et elle est fiable.
Pour l'activer, modifier la commande dans le convertisseur
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
LaT
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
{}
\end_layout
\end_inset
eX (plain)->DVI
\end_layout
\end_inset
ou le convertisseur
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
LaT
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
{}
\end_layout
\end_inset
eX (plain)->DraftDVI
\end_layout
\end_inset
dans
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Préférences\SpecialChar \menuseparator
Gestion des fichiers\SpecialChar \menuseparator
Convertisseurs
\end_layout
\end_inset
comme ceci:
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
latex -src-specials $$i
\end_layout
\end_inset
.
Si cela ne fonctionne pas, vérifiez les options votre moteur TeX (la syntaxe
peut différer dans quelques distributions).
\end_layout
\begin_layout Subsubsection*
Paquetages
\begin_inset space ~
\end_inset
externes
\begin_inset space ~
\end_inset
(PDFSync
\begin_inset space ~
\end_inset
et
\begin_inset space ~
\end_inset
scrltx)
\end_layout
\begin_layout Standard
Les paquetages
\emph on
pdfsync
\emph default
and
\emph on
scrltx
\emph default
fournissent la fonctionnalité de recherche inversée pour les sorties imprimable
s PDF (via pdflatex) et DVI, respectivement.
Pour l'activer, charger les paquetages dans le préambule LyX:
\end_layout
\begin_layout Itemize
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
\backslash
usepackage{pdfsync}
\end_layout
\end_inset
pour la recherche inversée depuis le PDF;
\end_layout
\begin_layout Itemize
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
\backslash
usepackage[active]{srcltx}
\end_layout
\end_inset
pour la recherche inversée depuis le DVI.
\end_layout
\begin_layout Standard
Si vous souhaitez effectuer la recherche inversée depuis les deux formats,
vous pouvez saisir les lignes suivantes dans le préambule:
\end_layout
\begin_layout LyX-Code
\backslash
usepackage{ifpdf}
\begin_inset Newline newline
\end_inset
\backslash
ifpdf
\begin_inset Newline newline
\end_inset
\backslash
usepackage{pdfsync}
\begin_inset Newline newline
\end_inset
\backslash
else
\begin_inset Newline newline
\end_inset
\backslash
usepackage[active]{srcltx}
\begin_inset Newline newline
\end_inset
\backslash
fi
\end_layout
\begin_layout Standard
De cette façon, vous pourrez visionner les fichiers soit en DVI, soit en
PDF (pdflatex) et le paquetage adéquat sera chargé.
\end_layout
\begin_layout Standard
Notez bien que PDFSync peut affecter la mise en page du document, il vaut
mieux le désactiver lors des passes finales de compilation du document.
\end_layout
\begin_layout Subsubsection*
Recherche
\begin_inset space ~
\end_inset
inversée
\begin_inset space ~
\end_inset
DVI
\begin_inset space ~
\end_inset
inhérente
\begin_inset space ~
\end_inset
via
\begin_inset space ~
\end_inset
SyncTeX
\begin_inset space ~
\end_inset
(DVI
\begin_inset space ~
\end_inset
et
\begin_inset space ~
\end_inset
PDF)
\end_layout
\begin_layout Standard
Les versions récentes de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
(pdf)latex
\end_layout
\end_inset
offrent un support inhérent pour la recherche inversé en PDF et DVI.
Cette fonctionnalité dénommée
\emph on
SyncTeX
\emph default
résulte à la base de l'intégration du paquetage PDFSync dans le programme
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
pdftex
\end_layout
\end_inset
et de sa fusion avec l'approche
\emph on
scr-specials
\emph default
.
Il vous faut au moins TeXLive 2008 ou une distribution MikTeX récente pour
pouvoir l'utiliser.
Notez également que seules quelques visionneuses (Skim sur Mac, SumatraPDF
sur Windows) supportent actuellement SyncTeX.
\end_layout
\begin_layout Standard
Pour activer SyncTeX pour le résultat imprimable DVI, modifier le convertisseur
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
LaT
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
{}
\end_layout
\end_inset
eX (plain) -> DVI
\end_layout
\end_inset
ou le convertisseur
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
LaT
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
{}
\end_layout
\end_inset
eX (plain) -> DraftDVI
\end_layout
\end_inset
dans
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Préférences\SpecialChar \menuseparator
Gestion des fichiers\SpecialChar \menuseparator
Convertisseurs
\end_layout
\end_inset
en
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
latex -synctex=1 $$i
\end_layout
\end_inset
, et pour le résultat imprimable PDF, modifier le convertisseur
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
LaT
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
{}
\end_layout
\end_inset
eX (pdflatex) -> PDF (pdflatex)
\end_layout
\end_inset
en
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
pdflatex -synctex=1 $$i
\end_layout
\end_inset
.
Vérifiez la documentation de votre visionneuse pour ce qui concerne la
configuration pour SyncTeX
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
L'option
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
-synctex=1
\end_layout
\end_inset
active la compression gzip.
Si votre visionneuse ne la comprend pas, vous devez saisir à la place
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
-synctex=-1
\end_layout
\end_inset
.
\end_layout
\end_inset
.
\end_layout
\begin_layout Subsection
Configuration et utilisation de visionneuses particulières
\begin_inset CommandInset label
LatexCommand label
name "sub:Configuration-et-utilisation"
\end_inset
\end_layout
\begin_layout Subsubsection*
Xdvi (toutes plate-formes)
\end_layout
\begin_layout Standard
Si vous utilisez
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
xdvi
\end_layout
\end_inset
, vous n'avez rien de plus à faire pour utiliser la recherche inversée,
puisque LyX fournit les ancres nécessaires pour l'utilisation automatisée
de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
lyxclient
\end_layout
\end_inset
.
Il vous suffit de paramétrer votre document comme indiqué plus haut (la
recherche inversée est déclenchée par Ctrl-clic ou Alt-clic sur Mac OSX,
respectivement).
\end_layout
\begin_layout Standard
Cependant, si pour quelque raison vous préférez utiliser le tube nommé au
lieu du connecteur pour la communication avec LyX, modifiez simplement
la visionneuse DVI dans
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
P
\lang french
références\SpecialChar \menuseparator
Gestion des fichiers\SpecialChar \menuseparator
Convertisseurs
\end_layout
\end_inset
en
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Sur Mac OSX vous devez utiliser
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
DISPLAY=:0.0 xdvi -editor 'lyxeditor.sh %f %l'
\end_layout
\end_inset
\end_layout
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
xdvi -editor 'lyxeditor.sh %f %l'
\end_layout
\end_inset
, ou
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
lyxeditor.sh
\end_layout
\end_inset
est un script approprié.
Par exemple, un script minimal est le suivant:
\end_layout
\begin_layout LyX-Code
#!/bin/sh
\begin_inset Newline newline
\end_inset
LYXPIPE="/path/to/lyxpipe"
\begin_inset Newline newline
\end_inset
COMMAND="LYXCMD:revdvi:server-goto-file-row:$1 $2"
\begin_inset Newline newline
\end_inset
echo "$COMMAND" > "${LYXPIPE}".in || exit
\begin_inset Newline newline
\end_inset
read < "${LYXPIPE}".out || exit
\end_layout
\begin_layout Standard
ou
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
/path/to/lyxpipe
\end_layout
\end_inset
est le chemin d'accès au tube Ly
\begin_inset ERT
status open
\begin_layout Plain Layout
{}
\end_layout
\end_inset
XServer spécifié dans
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
Preferences\SpecialChar \menuseparator
Paths
\end_layout
\end_inset
.
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Dans le répertoire
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
development/tools
\end_layout
\end_inset
de la distribution des sources LyX, vous trouverez un script
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
lyxeditor
\end_layout
\end_inset
, capable de trouver
\emph on
le lyxpipe
\emph default
de vos préférences.
\end_layout
\end_inset
\end_layout
\begin_layout Subsubsection*
MacDviX (Mac OSX)
\end_layout
\begin_layout Standard
À la fin du script
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
/Applications/MacDviX_Folder/calleditor.script
\end_layout
\end_inset
, ajoutez les lignes suivantes:
\end_layout
\begin_layout LyX-Code
/Applications/Ly
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
{}
\end_layout
\end_inset
X.app/Contents/MacOS/lyxeditor "$2" $1
\begin_inset Newline newline
\end_inset
exit 1
\end_layout
\begin_layout Standard
Adaptez ces lignes si vous installez LyX ailleurs que dans le répertoire
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Applications
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
La recherche inversée est déclenchée par Alt-clic (OPTION-clic).
\end_layout
\begin_layout Subsubsection*
Skim (Mac OSX)
\end_layout
\begin_layout Standard
Saisir
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
open -a Skim.app $$i
\end_layout
\end_inset
dans le réglage de la visionneuse
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Préférences\SpecialChar \menuseparator
Gestion des fichiers\SpecialChar \menuseparator
Formats de fichiers\SpecialChar \menuseparator
PDF (pdflatex)
\end_layout
\end_inset
, et sélectionnez Ly
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
{}
\end_layout
\end_inset
X dans
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
Skim\SpecialChar \menuseparator
Preferences\SpecialChar \menuseparator
Sync
\end_layout
\end_inset
..
\end_layout
\begin_layout Standard
La recherche inversée est déclenchée par COMMAND-SHIFT-clic.
\end_layout
\begin_layout Subsubsection*
Okular (KDE)
\end_layout
\begin_layout Standard
Aller à
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
Configuration\SpecialChar \menuseparator
Configurer Okular\SpecialChar \ldots{}
\SpecialChar \menuseparator
Editeur
\end_layout
\end_inset
, sélectionner
\begin_inset Quotes fld
\end_inset
Custom Text Editor
\begin_inset Quotes frd
\end_inset
et ajouter la commande
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
lyxclient -g %f %l
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
La recherche inversée est déclenchée par SHIFT-clic.
\end_layout
\begin_layout Subsubsection*
YAP (Windows)
\end_layout
\begin_layout Standard
Activer Yap, choisir le menu
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
View\SpecialChar \menuseparator
Options
\end_layout
\end_inset
et sélectionner l'onglet
\begin_inset Quotes fld
\end_inset
Recherche inversée DVI
\begin_inset Quotes frd
\end_inset
.
Cliquer sur le bouton
\begin_inset Quotes fld
\end_inset
New\SpecialChar \ldots{}
\begin_inset Quotes frd
\end_inset
et, dans la fenêtre qui s'ouvre, saisir
\begin_inset Quotes fld
\end_inset
LyX Editor
\begin_inset Quotes frd
\end_inset
(ou un autre nom de votre choix) dans le champ
\begin_inset Quotes fld
\end_inset
Name:
\begin_inset Quotes frd
\end_inset
.
Maintenant cliquer sur le bouton identifié par
\begin_inset Quotes fld
\end_inset
\SpecialChar \ldots{}
\begin_inset Quotes frd
\end_inset
pour ouvrir une fenêtre de choix de fichier et aller jusqu'au répertoire
contenant le fichier exécutable
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
lyxeditor.bat
\end_layout
\end_inset
(voir ci-dessous).
Sélectionner
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
lyxeditor.bat
\end_layout
\end_inset
et spécifier les arguments du programme comme suit:
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
%f %l
\end_layout
\end_inset
.
Le conteneur
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
lyxeditor.bat
\end_layout
\end_inset
est utilisé pour communiquer avec LyX via
\emph on
lyxpipe
\emph default
et se présente ainsi
\end_layout
\begin_layout LyX-Code
@echo off
\begin_inset Newline newline
\end_inset
echo LYXCMD:revdvi:server-goto-file-row:%1 %2>
\backslash
\backslash
.
\backslash
pipe
\backslash
lyxpipe.in
\begin_inset Newline newline
\end_inset
type
\backslash
\backslash
.
\backslash
pipe
\backslash
lyxpipe.out
\end_layout
\begin_layout Standard
Vérifier que le chemin d'accès au tube LyXServer spécifié dans LyX est bien
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
\backslash
\backslash
.
\backslash
pipe
\backslash
lyxpipe
\end_layout
\end_inset
, sinon adapter le conteneur
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
lyxeditor.bat
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
Avec Yap, la recherche inversée est déclenchée par double-clic.
\end_layout
\begin_layout Subsubsection*
SumatraPDF (Windows)
\end_layout
\begin_layout Standard
Pour utiliser SumatraPDF en recherche inversée, saisir
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
SumatraPDF -inverse-search "lyxeditor.bat %f %l"
\end_layout
\end_inset
dans les réglages de la visionneuse dans
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Préférences\SpecialChar \menuseparator
Gestion des fichiers\SpecialChar \menuseparator
Formats de fichiers\SpecialChar \menuseparator
PDF (pdflatex)
\end_layout
\end_inset
, ou
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
lyxeditor.bat
\end_layout
\end_inset
est le conteneur indiqué ci-dessus.
Si
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
SumatraPDF.exe
\end_layout
\end_inset
ne figure pas dans la liste des chemins des commandes, utiliser le nom
complet.
\end_layout
\begin_layout Standard
La recherche inversée est déclenchée par double-clic.
\end_layout
\begin_layout Subsubsection*
YAP (Cygwin)
\end_layout
\begin_layout Standard
D'abord, vérifier que Yap est la visionneuse DVI implicite de l'environnement
Windows, puis le lancer, choisir le menu
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
View\SpecialChar \menuseparator
Options
\end_layout
\end_inset
et sélectionner l'onglet
\begin_inset Quotes fld
\end_inset
Recherche DVI inversée
\begin_inset Quotes frd
\end_inset
.
Cliquer sur le bouton
\begin_inset Quotes fld
\end_inset
New\SpecialChar \ldots{}
\begin_inset Quotes frd
\end_inset
et, dans la fenêtre qui s'ouvre, saisir
\begin_inset Quotes fld
\end_inset
Éditeur LyX
\begin_inset Quotes frd
\end_inset
(ou un autre nom de votre choix) dans le champ
\begin_inset Quotes fld
\end_inset
Name:
\begin_inset Quotes frd
\end_inset
.
Maintenant cliquer sur le bouton identifié par
\begin_inset Quotes fld
\end_inset
\SpecialChar \ldots{}
\begin_inset Quotes frd
\end_inset
pour ouvrir une fenêtre de choix de fichier et aller jusqu'au répertoire
contenant le fichier exécutable
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
lyxeditor.exe
\end_layout
\end_inset
(qui est implicitement installé dans Cygwin avec l'exécutable LyX) .
Sélectionner
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
lyxeditor.exe
\end_layout
\end_inset
et spécifier les arguments du programme comme suit:
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
-g %f %l
\end_layout
\end_inset
.
De cette façon, vous utiliserez le
\emph on
lyxsocket
\emph default
pour communiquer avec LyX.
Si pour quelque raison, vous souhaitez utiliser
\emph on
lyxpipe
\emph default
, omettez l'option
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
-g
\end_layout
\end_inset
et spécifiez le chemin d'accès au tube LyXServer dans les préférences.
\end_layout
\begin_layout Standard
Avec Yap, la recherche inversée est déclenchée par double-clic.
\end_layout
\begin_layout Subsubsection*
SumatraPDF (Cygwin)
\end_layout
\begin_layout Standard
Pour utiliser SumatraPDF en recherche inversée, saisir
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
SumatraPDF.sh
\end_layout
\end_inset
dans les réglages de la visionneuse dans
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Préférences\SpecialChar \menuseparator
Gestion des fichiers\SpecialChar \menuseparator
Formats de fichiers\SpecialChar \menuseparator
PDF (pdflatex)
\end_layout
\end_inset
, ou
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
SumatraPDF.sh
\end_layout
\end_inset
est le script suivant (à rendre accessible dans le chemin d'accès aux commandes
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
/usr/local/bin
\end_layout
\end_inset
étant le meilleur choix):
\end_layout
\begin_layout LyX-Code
#!/bin/bash
\begin_inset Newline newline
\end_inset
cd $(dirname $1)
\begin_inset Newline newline
\end_inset
SumatraPDF -inverse-search "lyxeditor -g %f %l" $(basename $1)
\end_layout
\begin_layout Standard
Ce conteneur et nécessaire parce que SumatraPDF est une application Windows
native et ne comprend pas les chemins POSIX utilisés par la version Cygwin
de LyX.
Si
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
SumatraPDF.exe
\end_layout
\end_inset
n'est pas dans votre chemin d'accès, utiliser le chemin complet dans le
script ci-dessus.
L'option
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
-g
\end_layout
\end_inset
active la communication via
\emph on
lyxsocket
\emph default
.
De nouveau, l'omettre
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
-g
\end_layout
\end_inset
pour utiliser
\emph on
lyxpipe
\emph default
, et spécifier le chemin d'accès au tube LyXServer dans les préférences
LyX.
\end_layout
\begin_layout Standard
La recherche inversée est déclenchée par double-clic.
\end_layout
\begin_layout Section
\lang english
Forward search
\begin_inset Note Note
status open
\begin_layout Plain Layout
Section restant à traduire (JPChrétien, juin 2011)
\end_layout
\end_inset
\end_layout
\begin_layout Standard
\lang english
Forward search is, as the name implies, in a sense the
\begin_inset Quotes eld
\end_inset
opposite
\begin_inset Quotes erd
\end_inset
to reverse search.
It allows you to let the viewer jump to a given position from within LyX.
If forward search is set up (as described in what follows), you can put
the cursor anywhere in your LyX document, and hit
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
Navigate\SpecialChar \menuseparator
Forward search
\end_layout
\end_inset
(or select
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
Forward search
\end_layout
\end_inset
in the context menu via right mouse click), and then the viewer will jump
to that position as well.
This implies, of course, that your viewer supports this function.
\end_layout
\begin_layout Standard
\lang english
To make forward search possible, you first need to provide the generated
output PDF/DVI file with additional information about the TeX sources.
This can be done via the methods described in the section
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:rev-search"
\end_inset
.
\end_layout
\begin_layout Standard
\lang english
Additionally, you need to configure LyX for using your viewers in
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
Tools\SpecialChar \menuseparator
Preferences\SpecialChar \menuseparator
Output\SpecialChar \menuseparator
General
\end_layout
\end_inset
.
We provide a range of tested configurations for some viewers, which you
can select from the drop down list.
If none of these configurations suits you, you have to find out and enter
a suitable configuration yourself.
The definition syntax uses the following placeholders:
\end_layout
\begin_layout Itemize
\noindent
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$n
\end_layout
\end_inset
: row number
\end_layout
\begin_layout Itemize
\noindent
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$t
\end_layout
\end_inset
: name of the (temporary) exported .tex file
\end_layout
\begin_layout Itemize
\noindent
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$o
\end_layout
\end_inset
: name of the exported output file (either dvi or pdf, depending on which
one exists in the temporary directory)
\end_layout
\begin_layout Standard
\lang english
Note that only some of the viewers provide full forward search functionality,
among them yap, xdvi, okular and Sumatra PDF
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
For Sumatra CMCDDE is needed --- downloadable from http://www.istri.fr/zip/CMCDDE.z
ip
\end_layout
\end_inset
.
While many of the widespread PDF viewers (most notably Adobe Reader) do
not support forward search at all, some other viewers -- e.
\begin_inset space \thinspace{}
\end_inset
g.
evince and xpdf -- allow at least to reload the document and jump to a
specific page of the file, so you can at least navigate
\begin_inset Quotes eld
\end_inset
near
\begin_inset Quotes erd
\end_inset
.
These latter functionality is provided by an external call of synctex (see
the predefined example configurations).
\end_layout
\begin_layout Standard
\lang english
Forward search works both with DVI and PDF output.
LyX simply checks which preview format you have used before (i.
\begin_inset space \thinspace{}
\end_inset
e., which format is already there in the temporary directory) and chooses
the appropriate configuration for the respective format.
\end_layout
\begin_layout Chapter
Classes de document spéciales
\end_layout
\begin_layout Section
Article AASTeX
\end_layout
\begin_layout Standard
par
\noun on
Mike Ressler
\end_layout
\begin_layout Subsection
Introduction
\end_layout
\begin_layout Standard
AASTeX est un ensemble de macros produit par l'
\lang english
American Astronomical Society
\lang french
pour faciliter la soumission électronique de manuscrits aux trois journaux
qu'elle publie : l'
\lang english
Astrophysical Journal
\lang french
(y compris les
\lang english
Letters
\lang french
et le
\lang english
Supplement
\lang french
), l'
\lang english
Astronomical Journal
\lang french
, et les
\lang english
Publications of the Astronomical Society of the Pacific
\lang french
.
LyX a besoin de la version 5.0 (ou plus récente) de ces macros.
Les versions antérieures à la 5.0 sont destinées à être utilisées avec LaTeX2.09
et sont fondamentalement incompatibles avec LyX.
Le paquetage AASTeX peut être téléchargé depuis le site de l'AAS
\end_layout
\begin_layout Standard
\begin_inset VSpace medskip
\end_inset
\end_layout
\begin_layout Standard
\align center
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
http://www.journals.uchicago.edu/AAS/AASTeX
\end_layout
\end_inset
\end_layout
\begin_layout Standard
\begin_inset VSpace medskip
\end_inset
\end_layout
\begin_layout Standard
Un guide de l'utilisateur complet est compris dans ce paquetage et il vaut
mieux que vous vous familiarisiez sérieusement avec avant de vous embarquer
à écrire un papier en LyX.
LyX ne va pas vous dispenser de comprendre toutes les commandes AASTeX,
il vous dispensera seulement de la corvée de toutes les taper.
Il est de votre responsabilité de vous assurer que le document final exporté
en LaTeX soit complètement conforme aux recommandations du journal auquel
vous soumettez votre papier.
\end_layout
\begin_layout Subsection
Commencer un nouveau papier
\end_layout
\begin_layout Standard
Je vous suggère vivement de commencer avec le fichier de modèle AASTeX.
Cliquez sur
\family sans
Fichier\SpecialChar \menuseparator
Nouveau
\begin_inset space ~
\end_inset
avec
\begin_inset space ~
\end_inset
Modèle
\family default
, entrez le nouveau nom de fichier, puis choisissez le modèle
\family typewriter
aastex.lyx
\family default
.
Il montrera les champs les plus courants dans un manuscrit.
Écrivez par dessus le texte existant (y compris les crochets,
\family typewriter
<>
\family default
) les informations correctes.
Beaucoup des commandes et environnements AASTeX peuvent être implémentés
directement dans LyX, mais certains ne peuvent pas : notamment
\family typewriter
\backslash
altaffilmark
\family default
et
\family typewriter
\backslash
altaffiltext
\family default
, qui devraient se voir comme le nez au milieu de la figure dans le fichier
de modèle.
Pour des commandes comme celles-là, le code LaTeX doit être entré directement
et signalé comme tel.
De telles commandes sont du Vilain Texte Rouge, ou ERT
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT : Evil Red Text
\end_layout
\end_inset
.
J'essaye de minimiser la quantité de Vilain Texte Rouge nécessaire dans
un document AASTeX, mais il y en a toujours trop.
\end_layout
\begin_layout Subsection
Finir votre papier
\end_layout
\begin_layout Standard
Quand le papier est fini, que vous en êtes satisfaits et qu'il se visualise
/ s'imprime correctement, il y a quelques opérations de
\begin_inset Quotes fld
\end_inset
post-production
\begin_inset Quotes frd
\end_inset
à effectuer avant de le soumettre aux journaux.
\end_layout
\begin_layout Enumerate
Exportez votre papier en tant que fichier LaTeX (
\family sans
Fichier\SpecialChar \menuseparator
Exporter\SpecialChar \menuseparator
LaTeX
\family default
).
\end_layout
\begin_layout Enumerate
Éditez le fichier
\family typewriter
.tex
\family default
résultant avec votre éditeur de texte favori.
\end_layout
\begin_deeper
\begin_layout Enumerate
enlevez les lignes de commentaire avant la commande
\family typewriter
\backslash
documentclass
\family default
.
\end_layout
\begin_layout Enumerate
enlevez la ligne
\family typewriter
\backslash
usepackage...{fontenc}
\family default
si elle apparaît (en général juste après
\family typewriter
\backslash
documentclass
\family default
) ; enlevez aussi la ligne
\family typewriter
\backslash
secnumdepth
\family default
si elle est présente.
\end_layout
\begin_layout Enumerate
enlevez tout entre les commandes
\family typewriter
\backslash
makeatletter
\family default
et
\family typewriter
\backslash
makeatother
\family default
comprises, sauf les commandes que vous avez volontairement mises dans le
préambule LaTeX (qui devraient apparaître immédiatement après le commentaire
\begin_inset Quotes fld
\end_inset
User specified LaTeX commands
\begin_inset Quotes frd
\end_inset
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT :
\begin_inset Quotes fld
\end_inset
Commandes LaTeX spécifiées par l'utilisateur
\begin_inset Quotes frd
\end_inset
\end_layout
\end_inset
dans le fichier
\family typewriter
.tex
\family default
).
\end_layout
\end_deeper
\begin_layout Enumerate
Faites tourner LaTeX sur ce fichier après modifications pour s'assurer qu'il
peut encore être compilé correctement.
\end_layout
\begin_layout Enumerate
Relisez les spécifications du journal pour vous assurer que vos noms de
fichier et vos formats sont corrects.
\end_layout
\begin_layout Enumerate
Soumettez-le.
\end_layout
\begin_layout Subsection
Commentaires sur des commandes particulières
\end_layout
\begin_layout Standard
Je ne vais pas décrire l'emploi détaillé de chaque commande AASTeX : le
Guide de l'utilisateur d'AASTeX (
\family typewriter
aasguide.tex
\family default
) en donne une bonne description.
Il me sera donc probablement plus facile de parcourir la liste telle qu'on
la trouve dans le guide et de la commenter si nécessaire.
Allons-y...
\end_layout
\begin_layout Subsubsection
Les choses qui marchent comme prévu
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
begin{sloppypar}
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Puisqu'elles marchent comme prévu, j'en fais simplement la liste avec la
section dans laquelle elles se trouvent :
\family typewriter
\backslash
documentclass
\family default
(2.1.1),
\family typewriter
\backslash
begin{document}
\family default
(2.2),
\family typewriter
\backslash
title
\family default
(2.3),
\family typewriter
\backslash
author
\family default
(2.3),
\family typewriter
\backslash
affil
\family default
(2.3),
\family typewriter
\backslash
abstract
\family default
(2.4),
\family typewriter
\backslash
keywords
\family default
(2.5),
\family typewriter
\backslash
section
\family default
(2.7),
\family typewriter
\backslash
subsection
\family default
(2.7),
\family typewriter
\backslash
subsubsection
\family default
(2.7),
\family typewriter
\backslash
paragraph
\family default
(2.7),
\family typewriter
\backslash
begin{displaymath}
\family default
(2.11),
\family typewriter
\backslash
begin{equation}
\family default
(2.11),
\family typewriter
\backslash
begin{eqnarray}
\family default
(2.11),
\family typewriter
\backslash
begin{mathletters}
\family default
(2.11),
\family typewriter
\backslash
begin{thebibliography}
\family default
(2.12.1),
\family typewriter
\backslash
bibitem
\family default
(2.12.2),
\family typewriter
\backslash
begin{table}
\family default
(2.14.4),
\family typewriter
\backslash
begin{tabular}
\family default
(2.14.4),
\family typewriter
\backslash
caption
\family default
(2.14.4),
\family typewriter
\backslash
label
\family default
(2.14.4, entre autres),
\family typewriter
\backslash
tablerefs
\family default
(2.14.5),
\family typewriter
\backslash
tablecomments
\family default
(2.14.5),
\family typewriter
\backslash
url
\family default
(2.15.4),
\family typewriter
\backslash
end{document}
\family default
(2.16).
\end_layout
\begin_layout Standard
Les options de style qui suivent marchent elles aussi correctement :
\family typewriter
preprint
\family default
,
\family typewriter
preprint2
\family default
,
\family typewriter
eqsecnum
\family default
,
\family typewriter
flushrt
\family default
(3, 3.1, 3.2).
Mettez-les simplement dans le champ
\family sans
Options
\family default
de
\family sans
Document\SpecialChar \menuseparator
Paramètres
\family default
rubrique
\family sans
Classe
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
document.
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
end{sloppypar}
\end_layout
\end_inset
\end_layout
\begin_layout Subsubsection
Les choses qui marchent, mais qui nécessitent un commentaire
\end_layout
\begin_layout Standard
Les éléments suivants marchent, mais requièrent un petit commentaire :
\end_layout
\begin_layout Itemize
Ces éléments sont réservés à l'utilisation par les éditeurs du journal,
mais vous pouvez les mettre dans le préambule LaTeX si vous vous sentez
tenu de le faire :
\family typewriter
\backslash
received
\family default
,
\family typewriter
\backslash
revised
\family default
,
\family typewriter
\backslash
accepted
\family default
,
\family typewriter
\backslash
ccc
\family default
,
\family typewriter
\backslash
cpright
\family default
(tous à partir de 2.1.3)
\end_layout
\begin_layout Itemize
Ces éléments peuvent être placés dans le préambule LaTeX, et sont inclus
comme des blancs dans le fichier modèle :
\family typewriter
\backslash
slugcomment
\family default
(2.1.4),
\family typewriter
\backslash
shorttitle
\family default
(2.1.5),
\family typewriter
\backslash
shortauthors
\family default
(2.1.5)
\end_layout
\begin_layout Itemize
\family typewriter
\backslash
email
\family default
(2.3) peut seulement être utilisé seul, pas au milieu d'un paragraphe.
Utilisez du Vilain Texte Rouge si vous devez l'insérer.
\end_layout
\begin_layout Itemize
\family typewriter
\backslash
and
\family default
(2.3) aura un
\family typewriter
{}
\family default
en trop après.
Ça ne devrait pas causer d'erreur.
\end_layout
\begin_layout Itemize
\family typewriter
\backslash
notetoeditor
\family default
(2.6) peut seulement être utilisé seul, pas au milieu d'un paragraphe.
Utilisez du Vilain Texte Rouge si vous devez l'insérer.
\end_layout
\begin_layout Itemize
\family typewriter
\backslash
placetable
\family default
(2.8) ne peut pas insérer une marque de référence croisée, vous devez
la placer à la main
\end_layout
\begin_layout Itemize
\family typewriter
\backslash
placefigure
\family default
(2.8) même chose que pour
\family typewriter
\backslash
placetable
\end_layout
\begin_layout Itemize
\family typewriter
\backslash
acknowledgements
\family default
(2.9) aura un
\family typewriter
{}
\family default
en trop après.
Ça ne devrait pas causer d'erreur.
\end_layout
\begin_layout Itemize
\family typewriter
\backslash
appendix
\family default
(2.10) aura un
\family typewriter
{}
\family default
en trop après.
Ça ne devrait pas causer d'erreur.
\end_layout
\begin_layout Itemize
\family typewriter
\backslash
figcaption
\family default
(2.13.2) vous devrez éditer le paramètre optionnel à la main dans le fichier
LaTeX final.
\end_layout
\begin_layout Subsubsection
Les choses qui ne sont pas implémentées, utilisez du code TeX
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
begin{sloppypar}
\end_layout
\end_inset
\end_layout
\begin_layout Standard
\family typewriter
\backslash
altaffilmark
\family default
(2.3),
\family typewriter
\backslash
altaffiltext
\family default
(2.3),
\family typewriter
\backslash
eqnum
\family default
(2.11),
\family typewriter
\backslash
setcounter{equation}
\family default
(2.11),
\family typewriter
\backslash
citet
\family default
(2.12),
\family typewriter
\backslash
citep
\family default
(2.12), les abréviations des noms de journaux (2.12.4),
\family typewriter
\backslash
figurenum
\family default
(2.13.1),
\family typewriter
\backslash
epsscale
\family default
(2.13.1),
\family typewriter
\backslash
plotone
\family default
(2.13.1),
\family typewriter
\backslash
plottwo
\family default
(2.13.1),
\family typewriter
\backslash
tablenum
\family default
(2.14.4),
\family typewriter
\backslash
tableline
\family default
(2.14.4, insérez-le comme le premier élément dans la case la plus à gauche
après l'endroit où vous voulez le placer.
N'utilisez pas les règles LyX dans le tableau
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT : Traduction incertaine.
\end_layout
\end_inset
),
\family typewriter
\backslash
tablenotemark
\family default
(2.14.5),
\family typewriter
\backslash
tablenotetext
\family default
(2.14.5), pratiquement tout dans Divers (2.15, sauf
\family typewriter
\backslash
url
\family default
et
\family typewriter
\backslash
email
\family default
; voir ci-dessus),
\family typewriter
\backslash
singlespace
\family default
(3.1),
\family typewriter
\backslash
doublespace
\family default
(3.1),
\family typewriter
\backslash
onecolumn
\family default
(3.2),
\family typewriter
\backslash
twocolumn
\family default
(3.2)
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
end{sloppypar}
\end_layout
\end_inset
\end_layout
\begin_layout Subsubsection
Les choses qui ne peuvent pas être implémentées
\end_layout
\begin_layout Standard
\SpecialChar \ldots{}
au moins d'une façon qui ait un sens, et que je suggère donc d'ignorer.
Ce sont l'environnement
\family typewriter
references
\family default
(2.12.3) et l'environnement
\family typewriter
deluxetable
\family default
(2.14).
Si vous avez vraiment, vraiment besoin d'utiliser
\family typewriter
deluxetable
\family default
, je vous suggère de l'éditer avec un éditeur de texte dans un fichier séparé,
puis de faire
\family sans
Insérer\SpecialChar \menuseparator
Fichier\SpecialChar \menuseparator
Sous-document
\family default
pour l'inclure dans votre document LyX.
Voyez le fichier
\family typewriter
aas_sample.lyx
\family default
pour voir un exemple de cela.
\end_layout
\begin_layout Subsection
FAQs, conseils, trucs et autres astuces
\end_layout
\begin_layout Subsubsection
Faire coopérer LyX et AASTeX
\end_layout
\begin_layout Standard
Il peut être un peu difficile de faire reconnaître à LyX un nouveau format
et une nouvelle classe de document.
Quand tout le reste échoue, faites ceci :
\end_layout
\begin_layout Enumerate
Assurez-vous que LaTeX trouve AASTeX.
Copiez
\family typewriter
sample.tex
\family default
(et peut-être
\family typewriter
table.tex
\family default
) de la distribution AASTeX vers un répertoire complètement indépendant
de LaTeX ou d'AASTeX et faites tourner LaTeX sur
\family typewriter
sample.tex
\family default
.
\end_layout
\begin_layout Enumerate
Assurez-vous qu'
\family typewriter
aastex.layout
\family default
apparaît bien dans le répertoire de formats (layout) de LyX.
\end_layout
\begin_layout Enumerate
Refaites
\family sans
Outils\SpecialChar \menuseparator
Reconfigurer
\family default
dans LyX, puis redémarrez celui-ci.
\end_layout
\begin_layout Enumerate
Ouvrez un nouveau fichier normal, pas avec un modèle.
AASTeX apparaît-il dans
\family sans
Document\SpecialChar \menuseparator
Paramètres\SpecialChar \menuseparator
Classe
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
document
\family default
?
\end_layout
\begin_layout Standard
Si vous obtenez un avertissement provenant d'un document AASTeX existant
vous disant qu'il n'arrive pas à trouver le format AASTeX ou un message
du genre
\begin_inset Quotes fld
\end_inset
You should not mix title layouts with normal ones
\begin_inset Quotes frd
\end_inset
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT :
\begin_inset Quotes fld
\end_inset
Il ne faut pas mélanger les formats de titre avec les formats normaux.
\begin_inset Quotes frd
\end_inset
\end_layout
\end_inset
, c'est que les choses n'ont pas été installées correctement.
\end_layout
\begin_layout Subsubsection
Erreur LaTeX lors du traitement d'un tableau
\end_layout
\begin_layout Standard
LyX, par défaut, tente de centrer la légende/titre du tableau.
Ça semble produire une interférence négative dans AASTeX.
Vous devez donc cliquer quelque part dans la légende/titre, puis faire
\family sans
Éditer\SpecialChar \menuseparator
Paramètres
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
Paragraphe
\family default
, et régler l'
\family sans
Alignement
\family default
sur
\family sans
Bloc
\family default
.
Pour moi ça a résolu le problème.
\end_layout
\begin_layout Subsubsection
Références
\end_layout
\begin_layout Standard
Quelques petites choses :
\end_layout
\begin_layout Enumerate
J'ai remarqué quelques espacements bizarres avec les entrées de bibliographie.
Quand vous entrez les données de bibliographie, assurez-vous qu'il n'y
a
\emph on
pas
\emph default
d'espace entre le dernier auteur et la parenthèse indiquant l'année ; par
exemple tapez
\family typewriter
Ressler(1992)
\family default
et non
\family typewriter
Ressler (1992)
\family default
.
\end_layout
\begin_layout Enumerate
Je suis vraiment malheureux de ne pas pouvoir rendre
\family typewriter
\backslash
citet
\family default
et
\family typewriter
\backslash
citep
\family default
plus automatiques, mais ça nécessiterait des changements au code source
de LyX.
Pour le moment vous pouvez faire deux choses :
\end_layout
\begin_deeper
\begin_layout Enumerate
entrez toutes vos citations en utilisant le mécanisme prédéfini
\family sans
Insérer\SpecialChar \menuseparator
Citation
\family default
; au moins vous pourrez tirer avantage des insertions automatiques.
Puis éditez à la main le fichier LaTeX exporté avant de le soumettre, en
changeant les entrées
\family typewriter
\backslash
cite
\family default
en commandes
\family typewriter
\backslash
citet
\family default
ou
\family typewriter
\backslash
citep
\family default
appropriées (
\family typewriter
\backslash
cite
\family default
est actuellement équivalent à
\family typewriter
\backslash
citet
\family default
, donc vous n'avez pas absolument besoin de changer ceux-là).
\end_layout
\begin_layout Enumerate
ou vous pouvez simplement entrer toutes vos citations en Vilain Texte Rouge
en utilisant la même clef pour paramètre que celle que vous avez utilisée
dans la fenêtre de bibliographie, par exemple
\family typewriter
\backslash
citet{clef}
\family default
.
\end_layout
\begin_layout Standard
Aucun des deux choix n'est plaisant, mais nous aurons à faire avec jusqu'à
ce que le mécanisme de citation de LyX ne comprenne
\family typewriter
natbib
\family default
.
\end_layout
\end_deeper
\begin_layout Enumerate
Rien qu'entrer les références n'est pas du tout évident.
La façon la plus facile est de commencer à taper votre première référence
à la fin du document, puis de la marquer comme
\family sans
Citation
\family default
.
Ça mettra une petite boîte grise devant ce que vous venez de taper.
Cliquez sur la boîte pour remplir le reste.
Pour de nouvelles références, allez à la fin d'une référence existante
et appuyez sur
\family sans
Entrée
\family default
.
Ça créera une nouvelle ligne avec sa propre boîte, etc.
\end_layout
\begin_layout Subsubsection
Inclure des fichiers EPS
\end_layout
\begin_layout Standard
Avec tout le respect qui est dû à Chris Biemesderfer et aux autres qui ont
contribué à écrire le paquetage AASTeX, le mécanisme de gestion des figures
est vraiment mal foutu.
Vous pouvez insérer les commandes
\family typewriter
\backslash
plotone
\family default
, etc.
en Vilain Texte Rouge dans une Figure Flottante, mais je n'ai jamais vraiment
réussi à obtenir une apparence correcte.
Mon conseil serait d'éviter toute inclusion de fichier EPS dans le manuscrit
que vous soumettez au journal, mais d'utiliser le mécanisme d'inclusion
de fichier EPS standard de LyX quand vous voulez imprimer vos propres tirés
à part.
LyX va insérer une commande
\family typewriter
\backslash
usepackage{graphics}
\family default
dans le préambule LaTeX et gérer les figures de la façon habituelle dans
LaTeX2e.
Ceux qui essaieront d'imprimer votre manuscrit AASTeX 5.0 doivent de toutes
façons avoir une installation de LaTeX2e, donc pourquoi ne pas profiter
du mécanisme infiniment meilleur de gestion de graphiques ? S'ils se plaignent
du choix de LaTeX2e ou du paquetage
\family typewriter
graphics
\family default
, faites valoir qu'il apparaît dans la deuxième édition de Lamport (1994),
et qu'il était temps de faire la mise à jour il y a bien longtemps.
\end_layout
\begin_layout Subsubsection
Les choses qui auraient pu être faites, mais qui ne l'ont pas été
\end_layout
\begin_layout Standard
Il y a quelques choses
\begin_inset Quotes fld
\end_inset
sympathiques
\begin_inset Quotes frd
\end_inset
que j'aurais pu implémenter, mais que j'ai choisi de laisser de côté.
Par exemple, je ne voyais pas l'utilité d'afficher le texte en double interlign
e dans la fenêtre de LyX, même s'il l'est dans le manuscrit imprimé.
J'ai aussi choisi de ne pas faire des formats séparés pour les styles
\family typewriter
preprint
\family default
et
\family typewriter
preprint2
\family default
.
Comme je suppose que vous passerez la plupart du temps en mode manuscrit
simple, j'ai décidé de ne pas bouffer plus d'espace disque avec tout ça.
Si vous pensez vraiment que je devrais écrire ces formats, je ne pourrai
que suivre les règles édictées par l'Association de Lanceurs de Boomerangs
de l'État du Wisconsin :
\end_layout
\begin_layout Quotation
\begin_inset Quotes fld
\end_inset
Les décisions des juges seront sans appel sauf si elles sont conspuées par
une majorité écrasante de l'assistance.
Les réclamants ne doivent pas faire usage d'un vocabulaire obscène et injurieux
envers les membres du jury, ni les membres du jury envers les réclamants
(sauf s'ils viennent d'être frappés par un boomerang).
\begin_inset Quotes frd
\end_inset
\end_layout
\begin_layout Subsection
Touche finale
\end_layout
\begin_layout Standard
J'ai maintenant eu des papiers publiés aussi bien dans Apj que dans AJ avec
98% du travail fait avec LyX ; les 2% restants étant du post-traitement
avec LaTeX et un peu de nettoyage.
Je n'ai rencontré aucun problème avec le processus de soumission, et je
suis sûr que les journaux n'ont jamais eu conscience qu'il pouvait y avoir
une différence.
Donc, allez-y et publiez !
\end_layout
\begin_layout Section
Article A&A
\end_layout
\begin_layout Standard
par
\noun on
Peter Sütterlin
\end_layout
\begin_layout Subsection
Introduction
\end_layout
\begin_layout Standard
Cette section décrit comment utiliser LyX pour écrire des articles à soumettre
au journal scientifique
\emph on
\lang english
Astronomy and Astrophysics
\emph default
\lang french
(www.edpsciences.fr/aa/
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
http://www.edpsciences.fr/aa/
\end_layout
\end_inset
), avec la Version 5.01 de la classe de document
\family typewriter
aa.cls
\family default
.
Ce paquetage peut être téléchargé depuis le site ftp
\end_layout
\begin_layout Standard
\begin_inset VSpace medskip
\end_inset
\end_layout
\begin_layout Standard
\align center
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
ftp://ftp.edpsciences.org/pub/aa/readme.html
\end_layout
\end_inset
\end_layout
\begin_layout Standard
\begin_inset VSpace medskip
\end_inset
\end_layout
\begin_layout Standard
Un manuel est fourni avec ce paquetage, et ce texte n'est pas censé remplacer
le manuel d'origine mais est simplement un bref guide à la réalisation
d'un papier dans un format correct.
\end_layout
\begin_layout Standard
Notez que l'éditeur de ce journal a changé le 1er janvier 2001 : ce n'est
plus Springer mais EDP Sciences.
Ce changement a aussi entraîné quelques légères modifications aux fichiers
de style, notamment la suppression de la commande thesaurus.
La classe LyX
\family typewriter
aa
\family default
supporte la dernière version de ces fichiers de style, V 5.01.
Si vous avez une ancienne version installée, veuillez la mettre à jour.
Par souci de compatibilité, l'ancien format (version 4) a été conservé
sous le nom de
\family sans
article (A&A V4)
\family default
.
Voyez les commentaires dans
\family typewriter
LyXDir/layouts/aapaper.layout
\family default
.
\end_layout
\begin_layout Subsection
Pour commencer
\end_layout
\begin_layout Standard
Il est recommandé de commencer à partir du modèle distribué avec LyX.
Si vous n'utilisez pas de modèle, jetez un œil aux réglages suivants :
\end_layout
\begin_layout Itemize
Choisissez
\family sans
article
\begin_inset space ~
\end_inset
(A&A)
\family default
dans le champ
\family sans
Classe
\family default
\begin_inset space ~
\end_inset
\family sans
de
\family default
\begin_inset space ~
\end_inset
\family sans
Document
\family default
du dialogue
\family sans
Document\SpecialChar \menuseparator
Paramètres
\family default
.
(D'accord, c'est évident.)
\end_layout
\begin_layout Itemize
Ne changez pas l'option
\family sans
Mise
\begin_inset space ~
\end_inset
en
\begin_inset space ~
\end_inset
page
\family default
: laissez-la sur
\family sans
Défaut
\family default
.
La mise en page est prise en charge par les macros, vous n'avez rien à
changer.
\end_layout
\begin_layout Subsection
Le bloc d'en-tête
\end_layout
\begin_layout Standard
La première chose à entrer est l'information d'en-tête.
Elle consiste en sept entrées, dont certaines sont facultatives.
Ce sont
\end_layout
\begin_layout Itemize
\family sans
Titre
\family default
(Title) : (nécessaire)
\end_layout
\begin_layout Itemize
\family sans
SousTitre
\family default
(Subtitle) : (facultatif)
\end_layout
\begin_layout Itemize
\family sans
Auteur
\family default
(Author) : (nécessaire)
\end_layout
\begin_layout Itemize
\family sans
Adresse
\family default
(Address) : (nécessaire)
\end_layout
\begin_layout Itemize
\family sans
Tirés_À_Part
\family default
(Tiré à part): (facultatif) Si plus d'un auteur : qui contacter pour demander
des tirés à part.
\end_layout
\begin_layout Itemize
\family sans
Mail
\family default
: (facultatif) Adresse mail pour les contacts.
\end_layout
\begin_layout Itemize
\family sans
Date
\family default
: (nécessaire) Format suggéré
\family typewriter
Received: <date>; Accepted <date>
\end_layout
\begin_layout Standard
Il n'y a pas besoin de taper la commande
\family typewriter
\backslash
maketitle
\family default
, LyX le fait tout seul quand l'en-tête est fini.
Bien que l'ordre des entrées d'en-tête n'ait pas d'importance il est conseillé
de conserver la séquence ci-dessus, juste pour avoir un meilleur aspect
visuel et correspondre au format du document réel.
\end_layout
\begin_layout Standard
Si vous voulez placer des notes de bas de page dans le bloc d'en-tête, par
exemple pour entrer votre adresse actuelle, utilisez les notes de bas de
page standard avec
\family sans
Insérer\SpecialChar \menuseparator
Note
\begin_inset space ~
\end_inset
en
\begin_inset space ~
\end_inset
Bas
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
Page
\family default
.
LyX utilisera automagiquement
\family typewriter
\backslash
thanks{}
\family default
dans ce cas.
\end_layout
\begin_layout Standard
En plus de ces points, les macros utilisent trois commandes LaTeX supplémentaire
s qui n'ont pas d'équivalent dans LyX :
\end_layout
\begin_layout Itemize
\family typewriter
\backslash
and
\family default
pour séparer les noms quand il y a plusieurs auteurs et plusieurs instituts.
\end_layout
\begin_layout Itemize
\family typewriter
\backslash
inst{<numéro>}
\family default
pour marquer les couples auteur/institut correspondants.
Les instituts sont numérotés dans l'ordre où ils apparaissent dans le champ
\family sans
Address
\family default
, vous devez donc mettre un marqueur à chaque auteur.
\end_layout
\begin_layout Itemize
\family typewriter
\backslash
email{<adresse>}
\family default
pour fournir une adresse électronique pour être joignable rapidement.
\end_layout
\begin_layout Standard
Dans tous les cas, la commande appropriée doit être tapée dans LyX en mode
TeX.
Voir les exemples.
\end_layout
\begin_layout Subsection
L'abstract
\end_layout
\begin_layout Standard
L'abstract devrait suivre immédiatement le bloc d'en-tête.
Avec la version 5 l'abstract est devenu une commande, et il est maintenant
limité à un seul paragraphe.
En plus, il doit contenir une entrée avec les mots-clés.
La seule chose spéciale à en dire est qu'il doit contenir une entrée avec
les mots-clés.
Ce n'est pas encore implémenté pour LyX, vous devez donc entrer la commande
LaTeX
\family typewriter
\backslash
keywords{}
\family default
à la main en mode TeX.
Référez-vous au papier exemple.
\end_layout
\begin_layout Subsection
Environnements supportés
\end_layout
\begin_layout Standard
Le format
\family sans
paper
\begin_inset space ~
\end_inset
(A&A)
\family default
supporte les environnements suivants pour structurer votre texte :
\end_layout
\begin_layout Itemize
\family sans
Standard
\end_layout
\begin_layout Itemize
\family sans
Section
\end_layout
\begin_layout Itemize
\family sans
SousSection
\end_layout
\begin_layout Itemize
\family sans
SousSousSection
\end_layout
\begin_layout Itemize
\family sans
ListePuces
\end_layout
\begin_layout Itemize
\family sans
Énumération
\end_layout
\begin_layout Itemize
\family sans
Description
\end_layout
\begin_layout Itemize
\family sans
Légende
\end_layout
\begin_layout Itemize
\family sans
Abstract
\end_layout
\begin_layout Itemize
\family sans
Remerciement
\end_layout
\begin_layout Itemize
\family sans
Bibliographie
\end_layout
\begin_layout Itemize
\family sans
LaTeX
\end_layout
\begin_layout Subsection
Commandes non encore supportées par LyX
\end_layout
\begin_layout Standard
Quelques commandes ne sont pas encore supportées par le format
\family sans
paper
\begin_inset space ~
\end_inset
(A&A)
\family default
de LyX.
Quelques-unes ont déjà été mentionnées.
Par souci d'exhaustivité, elles sont toutes listées ici :
\end_layout
\begin_layout Itemize
\family typewriter
\backslash
and
\end_layout
\begin_layout Itemize
\family typewriter
\backslash
email
\end_layout
\begin_layout Itemize
\family typewriter
\backslash
appendix
\end_layout
\begin_layout Itemize
\family typewriter
\backslash
authorrunning
\end_layout
\begin_layout Itemize
\family typewriter
\backslash
inst{}
\end_layout
\begin_layout Itemize
\family typewriter
\backslash
keywords{}
\end_layout
\begin_layout Itemize
\family typewriter
\backslash
object{}
\end_layout
\begin_layout Itemize
\family typewriter
\backslash
titlerunning{}
\end_layout
\begin_layout Standard
Si vous voulez utiliser l'une de ces commandes, vous devez les taper vous-mêmes.
\series bold
N'oubliez pas de les signaler comme code LaTeX !
\end_layout
\begin_layout Subsection
Figures et tableaux flottants
\end_layout
\begin_layout Standard
LyX fournit le support pour les environnements de flottants
\family sans
figure
\family default
,
\family sans
figure*
\family default
,
\family sans
table
\family default
et
\family sans
table*
\family default
, nous n'en dirons donc pas beaucoup plus.
Référez-vous au
\emph on
Guide
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
l'Utilisateur
\emph default
.
Rappelez-vous juste que les tableaux devront être alignés à gauche.
Pour cela, sélectionnez le tableau et changez l'alignement dans
\family sans
Format\SpecialChar \menuseparator
Paragraphe
\family default
.
\end_layout
\begin_layout Standard
Il y a une seule chose spéciale : les figures avec la légende à côté.
Pour créer une telle figure, vous devez faire ceci :
\end_layout
\begin_layout Enumerate
Créez une grande figure flottante : faites
\family sans
Insérer\SpecialChar \menuseparator
Flottants\SpecialChar \menuseparator
Figure
\family default
, puis un clic droit sur la figure et cochez
\family sans
Plusieurs
\begin_inset space ~
\end_inset
colonnes
\family default
.
\end_layout
\begin_layout Enumerate
Entrez votre légende.
\end_layout
\begin_layout Enumerate
Tapez
\family sans
Entrée
\family default
pour déplacer le curseur au dessus de la figure.
\end_layout
\begin_layout Enumerate
Insérez votre figure.
\end_layout
\begin_layout Enumerate
Positionnez le curseur derrière la figure et insérez un ressort horizontal
:
\family sans
Insérer\SpecialChar \menuseparator
Formats\SpecialChar \menuseparator
Ressort
\begin_inset space ~
\end_inset
Horizontal
\family default
.
\end_layout
\begin_layout Enumerate
Passez en mode LaTeX :
\family sans
M-c
\begin_inset space ~
\end_inset
t
\family default
.
\end_layout
\begin_layout Enumerate
Entrez
\family typewriter
\backslash
parbox[b]{55mm}{
\family default
.
\series bold
Ne fermez pas l'accolade !
\end_layout
\begin_layout Enumerate
Positionnez le curseur derrière le texte de la légende, passez en mode LaTeX
et insérez l'accolade fermante :
\family sans
M-c
\begin_inset space ~
\end_inset
t
\family default
\family typewriter
}
\family default
.
\end_layout
\begin_layout Standard
Là encore, voyez les figures dans le papier exemple.
\end_layout
\begin_layout Subsection
Format du référé
\end_layout
\begin_layout Standard
Pour la soumission, le papier doit être formaté dans un format spécial à
double interligne.
Pour ce faire, vous devez donner à la classe de document l'option
\family typewriter
referee
\family default
.
Il faut la mettre dans le champ
\family sans
Options
\family default
, dans
\family sans
Document\SpecialChar \menuseparator
Paramètres
\family default
rubrique
\family sans
Classe
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
document
\family default
.
Entrez-y juste le mot
\family typewriter
referee
\family default
.
\end_layout
\begin_layout Subsection
Le papier exemple
\end_layout
\begin_layout Standard
Le répertoire d'exemples contient un papier exemple écrit avec LyX.
C'est l'exemple venant du paquetage de macros d'origine, traduit pour LyX.
Utilisez-le comme source d'inspiration, et comparez le code LaTeX d'origine
avec la façon de l'écrire avec LyX.
\end_layout
\begin_layout Section
LaTeX AMS
\end_layout
\begin_layout Standard
par
\noun on
David Johnson;
\noun default
mise à jour par
\noun on
Richard Heck
\end_layout
\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset
\end_layout
\begin_layout Standard
Les formats LaTeX AMS ont été écrits pour se conformer au style suggéré
pour les articles mathématiques à soumettre aux publications de l'
\lang english
American Mathematical Society
\lang french
.
Les formats ne sont pas définis pour une revue particulière, mais peuvent
facilement y être adaptés.
Il faut vous référer à la documentation de l'AMS pour obtenir des instructions
spécifiques à chaque revue (habituellement il suffira de changer une ligne
dans la sortie TeX).
Cette documentation est disponible sur le réseau à
\begin_inset Flex URL
status open
\begin_layout Plain Layout
http://www.ams.org
\end_layout
\end_inset
ou par ftp à
\begin_inset Flex URL
status open
\begin_layout Plain Layout
ftp://ftp.ams.org/pub/tex/amslatex/
\end_layout
\end_inset
.
Ces formats sont appropriés, et utiles, pour tout écrit mathématique.
\end_layout
\begin_layout Standard
Il y a actuellement 2 formats LaTeX AMS distincts :
\end_layout
\begin_layout Enumerate
amsart : le format standard d'article AMS.
\end_layout
\begin_layout Enumerate
amsbook :lLe format standard de livre AMS (en réalité de monographie).
\end_layout
\begin_layout Standard
Les formats eux-mêmes ne contiennent qu'un minimum nécessaire pour l'utilisation
des classes AMS.
Ils n'inclent aps en particulier d'environnments de
\begin_inset Quotes fld
\end_inset
théorèmes
\begin_inset Quotes frd
\end_inset
pour les théorèmes, les lemmes, et similaires.
Ceux-ci sont fournis par le module
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Théorèmes (AMS)
\end_layout
\end_inset
, chargé implicitement lorsqu'une classe AMS est sélectionnée (il peut ére
utilisé avec d'autres classes et peut être enlevé, si vious souhaitez utiliser
autre chose).
Les environnements contenus dans
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Théorèmes (extensions AMS)
\end_layout
\end_inset
, moins fréquemment utilisés, doivent être chargés manuellement.
\end_layout
\begin_layout Standard
Implicitement, les théorèmes et environnements similaires sont numérotés
consécutivement tout au long du document, mais ceci peut être modifié en
chargeant le module
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Théorèmes (numérotation par section)
\end_layout
\end_inset
ou bien, si vous utilisez la classe
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
book (AMS)
\end_layout
\end_inset
, le module
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Théorèmes (numérotation par chapitre)
\end_layout
\end_inset
.
Ceux-ci vont numéroter les environnements comme
\emph on
n.m.
\emph default
, où le premier nombre réfère la section (ou le chapitre) et le second réfère
le numéro d'ordre courant dans la section (ou le chapitre).
De nombreux environnements peuvent aussi rester non numérotés, ceux-ci
sont marqués par un astérisque.
Si par hasard vous désirez que tous les environnements soient non numérotés,
utilisez le module
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Théorèmes (non numérotés)
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
Notez que ces modules ne doivent pas être
\emph on
nécessairement
\emph default
utilisés avec les classes AMS.
Il est parfaitement possible d'utiliser les modules
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Théorèmes (AMS)
\end_layout
\end_inset
et les autres modules mentionnés ci-dessus avec d'autres classes, comme
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
article
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
report
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
book (KOMA-script)
\end_layout
\end_inset
, etc.
\end_layout
\begin_layout Subsection
Ce qu'offrent ces formats
\end_layout
\begin_layout Standard
La liste des environnements offerts par ces formats est longue.
Avec LaTeX AMS il y a la possibilité de définir une variété illimitée d'environ
nements de type
\begin_inset Quotes fld
\end_inset
théorème
\begin_inset Quotes frd
\end_inset
.
Cependant, l'AMS recommande les environnements disponibles dans LyX.
Voici la liste des environnements ― ainsi que les environnements standard,
comme
\family sans
\begin_inset Flex Noun
status collapsed
\begin_layout Plain Layout
\family sans
section
\end_layout
\end_inset
\family default
,
\family sans
\begin_inset Flex Noun
status collapsed
\begin_layout Plain Layout
\family sans
bibliograph
\family default
ie
\end_layout
\end_inset
\family default
,
\family sans
\begin_inset Flex Noun
status collapsed
\begin_layout Plain Layout
\family sans
titre
\end_layout
\end_inset
\family default
,
\family sans
\begin_inset Flex Noun
status collapsed
\begin_layout Plain Layout
\family sans
auteur
\end_layout
\end_inset
et
\begin_inset Flex Noun
status collapsed
\begin_layout Plain Layout
\family sans
date
\end_layout
\end_inset
\family default
― proposés par
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
article (AMS)
\end_layout
\end_inset
and
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
book (AMS)
\end_layout
\end_inset
:
\end_layout
\begin_layout Description
Adresse Ce devrait être l'adresse permanente de l'auteur.
\end_layout
\begin_layout Description
Adresse_Actuelle Ce devrait être l'adresse temporaire de l'auteur au moment
de la soumission, si elle est différente de l'Adresse ci-dessus.
\end_layout
\begin_layout Description
Email L'adresse e-mail de l'auteur.
\end_layout
\begin_layout Description
URL L'adresse de la page personnelle de l'auteur, s'il le souhaite.
\end_layout
\begin_layout Description
Mots-clés Mots-clés ou descripteurs, utilisés pour identifier les sujets
discutés dans l'article.
\end_layout
\begin_layout Description
Classe_Sujet Ceci fait référence à la Classification des Sujets de l'AMS,
publiée et décrite dans
\emph on
Mathematical Reviews
\emph default
.
Elle est aussi disponible en ligne sur les sites de l'AMS cités plus haut.
\end_layout
\begin_layout Description
Remerciements
\end_layout
\begin_layout Description
Dédicace
\end_layout
\begin_layout Description
Traducteur
\end_layout
\begin_layout Standard
Les environnments suivants sont fournis aussi bien par le module
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Théorèmes
\end_layout
\end_inset
que par le module
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Théorèmes (AMS)
\end_layout
\end_inset
, en version numérotée ou non numérotée pour ce dernier.
Ces environnements sont fournis dans la seule version non numérotée par
le module
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Théorèmes (non numérotés)
\end_layout
\end_inset
:
\end_layout
\begin_layout Theorem
Typiquement utilisé pour les résultats les plus importants.
\end_layout
\begin_layout Corollary*
Corollaire Utilisé pour des assertions qui découlent assez directement d'asserti
ons précédentes.
Peuvent être également des résultats importants.
\end_layout
\begin_layout Lemma
Ce sont des résultats moins forts, nécessaires à la preuve d'autres assertions.
\end_layout
\begin_layout Proposition
e sont des résultats moins importants qui apportent quelque chose à la théorie
générale dont il est question.
\end_layout
\begin_layout Conjecture
Ce sont des assertions fournies sans justification, dont l'auteur ne connaît
pas de preuve, mais qui semblent vraies (du moins aux yeux de l'auteur).
\end_layout
\begin_layout Definition*
Devinez à quoi ça sert.
La police, à la fois à l'écran et à l'impression, est différente dans cet
environnement.
\end_layout
\begin_layout Example*
Utilisé pour illustrer des résultats prouvés.
\end_layout
\begin_layout Problem
On ne sait pas à quoi sert celui-ci, vous devriez chercher.
\end_layout
\begin_layout Exercise*
Écrire une description de celui-ci.
\end_layout
\begin_layout Description
Remarque (Remark) Cet environnement est également un nouveau type de théorème.
Le mot
\family sans
\begin_inset Quotes fld
\end_inset
Remark
\begin_inset Quotes frd
\end_inset
\family default
apparaît en italique, et le reste comme du texte simple.
\end_layout
\begin_layout Claim*
Souvent utilisé dans le cours d'une preuve d'un résultat plus vaste.
\end_layout
\begin_layout Case
En général, ils servent à diviser de longues preuves en examinant des cas
distincts.
\end_layout
\begin_layout Case
Le schéma de numérotation des cas leur est spécifique : il n'appartient
pas à la même séquence que les autres assertions.
\end_layout
\begin_layout Proof
À la fin de cet environnement est inséré un symbole CQFD (d'habitude un
carré, mais ça peut varier avec les différents styles).
Si vous désirez avoir d'autres environnements insérés dans celui-ci, et
avoir le symbole CQFD tout à la fin, il faut augmenter la profondeur de
ceux-ci (voir la section
\emph on
Emboîter les environnements
\emph default
dans le
\emph on
Guide de l'utilisateur
\emph default
).
\end_layout
\begin_layout Standard
Et ces environnements sont fournis par le module
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Théorèmes (extensions AMS)
\end_layout
\end_inset
:
\end_layout
\begin_layout Criterion*
Une condition requise.
\end_layout
\begin_layout Algorithm*
Une procédure générale à utiliser.
\end_layout
\begin_layout Axiom*
C'est une propriété ou assertion considérée comme vraie dans la théorie
dont il est question.
\end_layout
\begin_layout Condition*
Utilisé parfois pour expliciter une condition admise dans le contexte de
la discussion.
\end_layout
\begin_layout Note*
Note Typographie similaire à
\family sans
Remarque
\family default
.
\end_layout
\begin_layout Notation*
Comme son nom l'indique
\end_layout
\begin_layout Acknowledgement*
Idem
\end_layout
\begin_layout Conclusion*
Utilisé parfois à la fin d'une argumentation
\end_layout
\begin_layout Fact
Utilsable comme Propositon, à une échelle peut-être réduite
\end_layout
\begin_layout Standard
En plus, ces environnements se servent automatiquement des paquetages de
polices AMS-LaTeX et AMS.
Il faut qu'ils soient disponibles sur votre système pour pouvoir utiliser
ces environnements.
\end_layout
\begin_layout Section
Broadway
\end_layout
\begin_layout Standard
par
\shape smallcaps
Garst Reese
\end_layout
\begin_layout Subsection
Introduction
\end_layout
\begin_layout Standard
Broadway est destiné à l'écriture de pièces de théâtre.
Le format est plus décoratif que Hollywood, et beaucoup moins standardisé.
Ce format devrait convenir à des ateliers.
\end_layout
\begin_layout Subsection
Problèmes particuliers
\end_layout
\begin_layout Standard
Les mêmes que dans Hollywood.
\end_layout
\begin_layout Subsection
Fonctions particulières
\end_layout
\begin_layout Standard
Entrez les noms des personnages comme étiquettes puis faites des références
croisées sur ces étiquettes pour insérer le nom.
La fenêtre de référence croisée montrera l'ensemble des personnages.
\end_layout
\begin_layout Subsection
Taille de papier et marges
\end_layout
\begin_layout Standard
USLetter, gauche 1,6
\begin_inset space ~
\end_inset
in, droite 0,75
\begin_inset space ~
\end_inset
in, haut 0,5
\begin_inset space ~
\end_inset
in, bas 0,75
\begin_inset space ~
\end_inset
in.
\end_layout
\begin_layout Subsection
Environnements
\end_layout
\begin_layout Standard
Les environnements suivants sont disponibles.
Vous pouvez utiliser
\family typewriter
broadway.bind
\family default
pour accéder aux touches de raccourci indiquées à droite.
\end_layout
\begin_layout Itemize
\family sans
Standard
\begin_inset Newline newline
\end_inset
\family default
Vous ne devriez pas avoir à l'utiliser, mais il est là pour tout ce qui
n'a pas sa place ailleurs.
\end_layout
\begin_layout Itemize
\family sans
Narrative
\begin_inset space \hfill{}
\end_inset
M-z n
\begin_inset Newline newline
\end_inset
\family default
Utilisé pour décrire le décor et l'action.
La première occurrence des noms des personnages en MAJUSCULES.
\end_layout
\begin_layout Itemize
\family sans
ACT
\family default
(Acte)
\begin_inset space \hfill{}
\end_inset
M
\family sans
-z a
\begin_inset Newline newline
\end_inset
\family default
Automatiquement numéroté.
À l'écran sera en chiffres arabes, mais imprimé en chiffres romains.
\end_layout
\begin_layout Itemize
\family sans
ACT*
\family default
(Acte*)
\begin_inset space \hfill{}
\end_inset
M
\family sans
-z S at
\begin_inset Newline newline
\end_inset
\family default
Sous-titre pour
\family sans
ACT
\family default
.
C'est juste du texte centré.
\end_layout
\begin_layout Itemize
\family sans
SCENE
\begin_inset space \hfill{}
\end_inset
M-z S-S
\begin_inset Newline newline
\end_inset
\family default
Pas automatiquement numéroté.
Vous donnez le numéro.
C'est parce que je n'ai pas trouvé comment faire.
\end_layout
\begin_layout Itemize
AT_RISE (Lever de Rideau)
\begin_inset space \hfill{}
\end_inset
M
\family sans
-z S-R
\begin_inset Newline newline
\end_inset
\family default
Un cas particulier de
\family sans
Narrative
\family default
pour décrire le décor et l'action quand le rideau se lève.
\end_layout
\begin_layout Itemize
\family sans
Speaker
\begin_inset space \hfill{}
\end_inset
M-z s
\begin_inset Newline newline
\end_inset
\family default
Le nom du personnage, centré en MAJUSCULES.
\end_layout
\begin_layout Itemize
\family sans
Parenthetical
\family default
(Didascalies)
\begin_inset space \hfill{}
\end_inset
M
\family sans
-z p
\begin_inset Newline newline
\end_inset
\family default
Instructions au personnage.
Les () sont insérées automatiquement, mais seule la ( sera affichée dans
LyX.
Les deux seront imprimées.
Cet environnement n'est utilisé qu'à l'intérieur de
\family sans
Dialogue
\family default
.
\end_layout
\begin_layout Itemize
\family sans
Dialogue
\begin_inset space \hfill{}
\end_inset
M-z d
\begin_inset Newline newline
\end_inset
\family default
Ce que dit le personnage.
\end_layout
\begin_layout Itemize
\family sans
CURTAIN
\family default
(Rideau)
\begin_inset space \hfill{}
\end_inset
M
\family sans
-z S-C
\begin_inset Newline newline
\end_inset
\family default
Le rideau tombe.
\end_layout
\begin_layout Itemize
\family sans
Titre
\begin_inset space \hfill{}
\end_inset
M-z S-T
\end_layout
\begin_layout Itemize
\family sans
Auteur
\begin_inset space \hfill{}
\end_inset
M-z S-A
\end_layout
\begin_layout Itemize
\family sans
Right_Address
\begin_inset space \hfill{}
\end_inset
M-z r
\end_layout
\begin_layout Standard
Salut tout le monde.
\end_layout
\begin_layout Section
Dinbrief
\end_layout
\begin_layout Standard
La classe de document
\family sans
dinbrief
\family default
peut servir à taper des lettres selon les conventions allemandes.
Un fichier modèle est inclus dans
\family typewriter
.../lyx/share/templates
\family default
pour vous servir de point de départ.
\end_layout
\begin_layout Section
Elsevier Journals
\end_layout
\begin_layout Standard
par
\noun on
Rod Pinna
\end_layout
\begin_layout Standard
Elsevier Science Publishers B.V.
met une classe de document LaTeX standard (
\family typewriter
elsart.cls
\family default
) à disposition de ceux qui veulent soumettre des articles à leurs différentes
publications.
Vous pouvez directement télécharger le fichier de style sur leur page web
:
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
http://authors.elsevier.com/
\end_layout
\end_inset
.
Des instructions sont fournies avec le fichier de classe, qui précisent
les desiderata de l'éditeur.
LyX peut fonctionner avec cette classe, grâce à un fichier de format et
un modèle de document.
L'installation de la classe est identique à n'importe quel autre paquetage
LaTeX, tout ceci est expliqué dans la documentation d'Elsevier.
\end_layout
\begin_layout Standard
Pour utiliser
\family typewriter
elsart.cls
\family default
, vous disposez d'un fichier
\family typewriter
elsart.layout
\family default
.
Comme la classe Elsevier est construite à partir de la classe standard
\family sans
article
\family default
, la plupart des fonctions de base sont les mêmes.
La classe Elsevier définit un certain nombre d'environnements mathématiques,
semblables à ceux de l'AMS.
Ces commandes sont toutes décrites dans la documentation d'Elsevier, et
disponibles depuis LyX.
\end_layout
\begin_layout Standard
La façon la plus simple d'utiliser la classe Elsevier est de construire
vos documents à partir du modèle fourni.
Il est préférable de ne pas utiliser les options d'en-têtes
\begin_inset Quotes fld
\end_inset
fancy
\begin_inset Quotes frd
\end_inset
ou le paquetage geometry, car Elsevier définit des fonctions similaires
dans le fichier de style.
Idéalement, vous ne devriez pas utiliser d'autre paquetage que ceux mentionnés
dans la documentation d'Elsevier.
Basiquement, Elsevier souhaite recevoir un fichier LaTeX le plus
\begin_inset Quotes fld
\end_inset
propre
\begin_inset Quotes frd
\end_inset
possible, car ils vont prendre le fichier que vous aurez soumis et remplacer
le fichier de classe par celui du journal auquel vous soumettez votre article.
Cela signifie aussi qu'il ne faut pas que vous passiez trop de temps à
mettre en forme votre document : de toute manière, il aura changé à la
publication.
Pour tout le reste, vous utilisez ce format de la même façon que la classe
\family sans
article
\family default
.
Pour plus de détails sur ce qu'Elsevier accepte et n'accepte pas, reportez-vous
à leur documentation.
\end_layout
\begin_layout Section
Diapos Foils (alias
\family sans
Foil
\family default
\noun on
T
\noun default
e
\noun on
X
\noun default
)
\begin_inset CommandInset label
LatexCommand label
name "sec:foiltex"
\end_inset
\end_layout
\begin_layout Standard
par
\noun on
Allan Rae
\end_layout
\begin_layout Subsection
Introduction
\end_layout
\begin_layout Standard
Cette section décrit comment utiliser LyX pour préparer des transparents
pour rétroprojecteurs.
Il y a deux classes de document qui le permettent : la classe par défaut
\family sans
slides
\family default
et la classe
\family sans
FoilteX
\family default
.
Cette section décrit la classe
\family sans
FoilteX
\end_layout
\begin_layout Standard
Redisons-le donc bien clairement :
\end_layout
\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset
\end_layout
\begin_layout Standard
\align center
\size large
Cette section concerne la classe
\family sans
\begin_inset Quotes fld
\end_inset
slides
\family default
\begin_inset space ~
\end_inset
(
\family sans
FoilTeX
\family default
)
\begin_inset Quotes frd
\end_inset
uniquement.
\end_layout
\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset
\end_layout
\begin_layout Standard
Si vous voulez une documentation sur
\begin_inset Quotes fld
\end_inset
\family sans
slides
\begin_inset space ~
\end_inset
(default)
\family default
\begin_inset Quotes frd
\end_inset
, voyez la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:slitex"
\end_inset
.
Si votre machine n'a pas la classe
\family sans
foils
\family default
installée
\lang english
[
\family sans
\begin_inset Quotes fld
\end_inset
slides (FoilTeX)
\family default
\begin_inset Quotes frd
\end_inset
]
\lang french
, il vous faudra sûrement utiliser la classe
\family sans
slides
\family default
par défaut, qui n'est pas aussi bonne.
\end_layout
\begin_layout Standard
La classe
\family sans
foils
\family default
est conçue pour être utilisée avec la version 2.1 du fichier de classe LaTeX
\family sans
foils.cls
\family default
.
Celui-ci fait maintenant partie intégrante de LaTeX2e.
\end_layout
\begin_layout Subsection
Pour commencer
\end_layout
\begin_layout Standard
Bien entendu, pour utiliser cette classe de document, il vous faut sélectionner
\begin_inset Quotes fld
\end_inset
\family sans
slides
\begin_inset space ~
\end_inset
(FoilTe
\family default
X
\family sans
)
\family default
\begin_inset Quotes frd
\end_inset
dans le champ
\family sans
Classe
\family default
de la fenêtre
\family sans
Document\SpecialChar \menuseparator
Paramètres
\family default
\SpecialChar \menuseparator
\family sans
Classe
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
document
\family default
.
Il y a quelques autres réglages qui ont une signification spéciale avec
cette classe :
\end_layout
\begin_layout Itemize
Ne changez pas les options
\family sans
Pagination
\family default
et
\family sans
Colonnes
\family default
dans la fenêtre
\family sans
Document\SpecialChar \menuseparator
Paramètres
\family default
.
Elles sont ignorées par la classe
\family sans
foils
\family default
.
\end_layout
\begin_layout Itemize
La taille par défaut est de 20
\begin_inset space ~
\end_inset
pt, les autres choix étant respectivement 17
\begin_inset space ~
\end_inset
pt, 25
\begin_inset space ~
\end_inset
pt et 30
\begin_inset space ~
\end_inset
pt.
\end_layout
\begin_layout Itemize
La police par défaut est
\family sans
Sans
\begin_inset space ~
\end_inset
empattement
\family default
mais toutes les équations mathématiques restent formatées dans la police
habituelle
\family sans
Romain
\family default
.
\end_layout
\begin_layout Itemize
\family sans
\lang english
FoilTeX
\family default
\lang french
accepte les formats de papier A4 et Letter, ainsi qu'un format particulier
pour travailler avec des diapos 35mm.
Les tailles A5, B5,
\emph on
legal
\emph default
\emph toggle
ou
\emph default
\emph on
excutive
\emph default
\emph toggle
ne sont pas supportées.
\end_layout
\begin_layout Itemize
Ne vous occupez pas de
\family sans
Placement
\begin_inset space ~
\end_inset
des
\begin_inset space ~
\end_inset
flottants
\family default
: l'option est de toute façon ignorée.
Tous les flottants apparaîtront là où ils sont définis dans le texte.
\end_layout
\begin_layout Itemize
Les réglages
\family sans
Mise
\begin_inset space ~
\end_inset
en
\begin_inset space ~
\end_inset
page
\family default
se comportent un peu différemment avec cette classe.
\family sans
\lang english
FoilTeX
\family default
\lang french
propose en effet des possibilités plus étendues pour les en-têtes et pieds
de page, comme l'insertion d'un logo défini par l'utilisateur.
Voyez la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:foil-en-tetes"
\end_inset
pour de plus amples détails.
La page de titre est traitée différemment de toutes les autres pages du
document et n'est
\emph on
jamais
\emph default
\emph toggle
numérotée.
L'éventuel logo y est
\emph default
\emph on
toujours
\emph default
\emph toggle
centré au bas de la page.
Les différentes mises en page possibles sont les suivantes :
\end_layout
\begin_deeper
\begin_layout Labeling
\labelwidthstring MMMMMMM
\family sans
\series bold
empty
\family default
\series default
Les diapos ne présenteront ni numéro de page, ni en-tête ou pied de page
(sauf évidemment les notes de bas de page).
\end_layout
\begin_layout Labeling
\labelwidthstring MMMMMMM
\family sans
\series bold
plain
\family default
\series default
Les diapos auront un numéro de page centré en bas de la page.
Ni en-tête, ni pied de page (à part les notes).
\end_layout
\begin_layout Labeling
\labelwidthstring MMMMMMM
\series bold
foilheadings
\series default
Le numéro apparaît en bas à droite.
Les en-têtes et pieds de page seront présents.
C'est le choix par défaut.
\end_layout
\begin_layout Labeling
\labelwidthstring MMMMMMM
\series bold
fancy
\series default
Vous donne accès au paquetage
\family sans
fancyheadings
\family default
, et ce même si son utilisation est déconseillée par l'auteur de
\family sans
\lang english
FoilTeX
\family default
\lang french
car certaines incompatibilités apparaissent.
\end_layout
\end_deeper
\begin_layout Subsubsection
Options supplémentaires
\end_layout
\begin_layout Standard
Les options suivantes peuvent être activées dans le champ
\family sans
Options
\family default
de la fenêtre
\family sans
Document\SpecialChar \menuseparator
Paramètres
\family default
\SpecialChar \menuseparator
\family sans
Classe
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
document
\family default
.
\end_layout
\begin_layout Labeling
\labelwidthstring MMMMMMx
\series bold
35mmSlide
\series default
Règle le format de page à 7,33
\begin_inset space ~
\end_inset
pouces sur 11
\begin_inset space ~
\end_inset
pouces, ce qui donne le même rapport largeur/hauteur qu'une diapo 35
\begin_inset space ~
\end_inset
mm, facilitant ainsi le travail avec ce support.
\end_layout
\begin_layout Labeling
\labelwidthstring MMMMMMx
\series bold
headrule
\series default
Trace une ligne horizontale le long de la page, au-dessous de l'en-tête,
sur toutes les pages sauf celle de titre.
\end_layout
\begin_layout Labeling
\labelwidthstring MMMMMMx
\series bold
footrule
\series default
Trace une ligne horizontale le long de la page, au-dessus du pied de page,
sur toutes les pages sauf celle de titre.
\end_layout
\begin_layout Labeling
\labelwidthstring MMMMMMx
\series bold
dvips
\series default
Cette option indique à
\family sans
\lang english
FoilTeX
\family default
\lang french
d'utiliser le pilote dvips pour effectuer les rotations des pages en format
paysage.
(Elle est automatiquement activée à la création d'un nouveau document
\family sans
foils
\family default
).
\end_layout
\begin_layout Labeling
\labelwidthstring MMMMMMx
\series bold
landscape
\series default
Change simplement la taille des pages au format paysage, mais sans effectuer
de rotation.
Si vous utilisez cette option, vous aurez besoin d'un programme externe
pour effectuer une rotation de chaque page, ou bien il vous faudra alimenter
votre imprimante directement en format paysage.
Remarquez que cette option renverse les rôles respectifs des environnements
\family sans
En-tête_Diapo
\family default
et
\family sans
En-tête_Diapo_Tourné
\family default
(ne vous inquiétez pas, ils sont décrits plus loin).
\end_layout
\begin_layout Labeling
\labelwidthstring MMMMMMx
\series bold
leqno
\series default
Numéros des équations à gauche.
\end_layout
\begin_layout Labeling
\labelwidthstring MMMMMMx
\series bold
fleqn
\series default
Équations alignées à gauche.
\end_layout
\begin_layout Subsection
Environnements supportés
\end_layout
\begin_layout Standard
La plupart des environnements courants sont supportés par la classe
\family sans
foils
\family default
.
Il y a des environnements supplémentaires fournis par
\family sans
\lang english
FoilTeX
\family default
\lang french
ainsi que deux apportés par LyX.
Les environnements suivants sont partagés avec d'autres classes :
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
begin{multicols}{2}
\end_layout
\end_inset
\end_layout
\begin_layout Itemize
\family sans
Standard
\end_layout
\begin_layout Itemize
\family sans
ListePuces
\end_layout
\begin_layout Itemize
\family sans
Énumeration
\end_layout
\begin_layout Itemize
\family sans
Description
\end_layout
\begin_layout Itemize
\family sans
Liste
\end_layout
\begin_layout Itemize
\family sans
LyX-Code
\end_layout
\begin_layout Itemize
\family sans
Vers
\end_layout
\begin_layout Itemize
\family sans
Cite
\end_layout
\begin_layout Itemize
\family sans
Citation
\end_layout
\begin_layout Itemize
\family sans
Titre
\end_layout
\begin_layout Itemize
\family sans
Auteur
\end_layout
\begin_layout Itemize
\family sans
Date
\end_layout
\begin_layout Itemize
\family sans
Abstract
\end_layout
\begin_layout Itemize
\family sans
Bibliographie
\end_layout
\begin_layout Itemize
\family sans
Adresse
\end_layout
\begin_layout Itemize
\family sans
Adresse_À_Droite
\end_layout
\begin_layout Itemize
\family sans
Légende
\end_layout
\begin_layout Itemize
\family sans
Commentaire
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
end{multicols}
\end_layout
\end_inset
\end_layout
\begin_layout Standard
En gros, il s'agit de tous les environnements, mis à part ceux de section.
En effet, dans un diaporama, les sections sont en fait les diapos elles-mêmes.
\family sans
\lang english
FoilTeX
\family default
\lang french
propose des commandes pour commencer de nouvelles diapos :
\end_layout
\begin_layout Itemize
\family sans
En-Tête_Diapo
\family default
(Foilhead)
\end_layout
\begin_layout Itemize
\family sans
En-Tête_Diapo_Tourné (RotateFoilhead)
\end_layout
\begin_layout Standard
LyX a aussi des versions légèrement modifiées de ces deux environnements
:
\end_layout
\begin_layout Itemize
\family sans
En-tête_Diapo_Court
\family default
(ShortFoilhead)
\end_layout
\begin_layout Itemize
\family sans
En-tête_Diapo_Court_Tourné
\family default
(ShortRotateFoilhead)
\end_layout
\begin_layout Standard
Les différences seront expliquées dans une autre section.
\end_layout
\begin_layout Standard
De plus, les diapos sont souvent utilisées pour exposer des idées, ou de
nouveaux théorèmes.
De ce fait,
\family sans
\lang english
FoilTeX
\family default
\lang french
fournit aussi un ensemble d'outils pour les présenter :
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
begin{multicols}{2}
\end_layout
\end_inset
\end_layout
\begin_layout Itemize
\family sans
Théorème
\end_layout
\begin_layout Itemize
\family sans
Lemme
\end_layout
\begin_layout Itemize
\family sans
Corollaire
\end_layout
\begin_layout Itemize
\family sans
Proposition
\end_layout
\begin_layout Itemize
\family sans
Définition
\end_layout
\begin_layout Itemize
\family sans
Preuve
\end_layout
\begin_layout Itemize
\family sans
Théorème*
\end_layout
\begin_layout Itemize
\family sans
Lemme*
\end_layout
\begin_layout Itemize
\family sans
Corollaire*
\end_layout
\begin_layout Itemize
\family sans
Proposition*
\end_layout
\begin_layout Itemize
\family sans
Définition*
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
end{multicols}
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Les versions sans étoiles sont numérotées, tandis que celles avec étoiles
ne le sont pas.
Il y a enfin des environnements de liste ajoutés par LyX :
\end_layout
\begin_layout Itemize
\family sans
ListeCochés
\family default
(TickList)
\end_layout
\begin_layout Itemize
\family sans
ListeCroix
\family default
(CrossList)
\end_layout
\begin_layout Standard
\family sans
\lang english
FoilTeX
\family default
\lang french
offre aussi de nombreuses possibilités pour les en-têtes et pieds de pages,
qu'il vaut mieux définir dans le préambule, bien que vous puissiez le faire
à tout moment dans le document.
Si vous souhaitez changer ces réglages en cours de document, il est préférable
de le faire au tout début d'une diapo, donc juste après l'
\family sans
En-tête_Diapo
\family default
.
\end_layout
\begin_layout Standard
Pour ces réglages, vous disposez des environnements suivants [
\noun on
Martin Vermeer
\noun default
] :
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
begin{multicols}{2}
\end_layout
\end_inset
\end_layout
\begin_layout Itemize
\family sans
Mon_Logo
\family default
(My_Logo)
\end_layout
\begin_layout Itemize
\family sans
Restriction
\end_layout
\begin_layout Itemize
\family sans
Pied_Droite
\family default
(Right_Footer)
\end_layout
\begin_layout Itemize
\family sans
En-tête_Droite
\family default
(Right_Header)
\end_layout
\begin_layout Itemize
\family sans
En-tête_Gauche
\family default
(Left_Header)
\end_layout
\begin_deeper
\begin_layout Standard
\begin_inset space ~
\end_inset
\end_layout
\end_deeper
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
end{multicols}
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Certaines commandes de
\family sans
FoilTeX
\family default
ne sont pas directement supportées par LyX, mais vous pourrez tout de même
les utiliser, comme l'explique la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:foil-non-supporte"
\end_inset
.
\end_layout
\begin_layout Subsection
Création de diapos
\end_layout
\begin_layout Standard
Cette section est une rapide introduction aux différents environnements
qui permettent de construire un ensemble de diapos.
Si vous voulez un exemple, ouvrez
\family typewriter
Foils.lyx
\family default
qui se trouve dans le répertoire des
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
exemples
\end_layout
\end_inset
.
\end_layout
\begin_layout Subsubsection
Donner un titre de page
\end_layout
\begin_layout Standard
À la différence des autres classes qui proposent les environnements
\family sans
Titre
\family default
,
\family sans
Auteur
\family default
et
\family sans
Abstract
\family default
, la classe
\family sans
foils
\family default
crée le titre sur une page à part.
Si vous laissez l'environnement
\family sans
Date
\family default
vide, LaTeX lui substituera la date du jour (et ce, à chaque fois que vous
générerez le rendu).
\end_layout
\begin_layout Subsubsection
Débuter une nouvelle diapo
\end_layout
\begin_layout Standard
Comme il est dit plus haut, il existe quatre manières de commencer une nouvelle
diapo.
Pour les formats portrait, utilisez
\family sans
En-tête_Diapo
\family default
ou
\family sans
En-tête_Diapo_Court
\family default
.
La différence entre ces deux environnements est la quantité d'espace entre
le titre (l'
\family sans
En-tête_Diapo
\family default
) et le corps de la diapo.
\end_layout
\begin_layout Standard
Les diapos en position paysage seront créées via les environnements
\family sans
En-tête_Diapo_Tourné
\family default
et
\family sans
En-tête_Diapo_Court_Tourné
\family default
.
À nouveau, la seule différence est l'espace entre le titre et le corps.
Les deux versions courtes ont 0,5
\begin_inset space ~
\end_inset
pouce de séparation en moins.
\end_layout
\begin_layout Standard
Il vous faut
\family typewriter
dvips
\family default
pour générer des sorties PostScript de diapos en format paysage, sans quoi
la rotation de ces diapos ne sera pas exécutée.
Il vous sera possible d'obtenir des diapos en format paysage sans
\family typewriter
dvips
\family default
, mais il vous faudra introduire les feuilles en position couchée dans l'imprima
nte ;-)
\end_layout
\begin_layout Subsubsection
Théorèmes, lemmes, preuves et tutti quanti
\end_layout
\begin_layout Standard
Un petit bogue de LyX fait que deux de ces environnements ne peuvent se
suivre directement.
Ils doivent être séparés par quelque chose.
Si vous essayez d'en coller deux, ça semblera marcher sous LyX, mais la
sortie LaTeX aura fusionné les deux environnements en un seul.
Alors, comment contourner le problème ? L'option la plus simple est d'insérer
du texte entre les deux environnements ou d'ajouter un environnement
\family sans
LaTeX
\family default
entre les deux paragraphes avec juste un
\begin_inset Quotes fld
\end_inset
\family typewriter
%
\family default
\begin_inset Quotes frd
\end_inset
dedans.
Cela forcera LyX à produire la bonne sortie LaTeX.
Il y en a un exemple dans le fichier d'exemple inclus dans la distribution
LyX.
Nous rappelons que ce problème n'apparaît que lorsque vous essayez de placer
deux environnements de type théorème juste l'un derrière l'autre.
\end_layout
\begin_layout Subsubsection
Listes
\end_layout
\begin_layout Standard
Vous pouvez profiter de tous les types de listes que l'on trouve dans les
autres classes plus deux nouvelles.
Je ne décrirai ici que ces dernières.
Si vous voulez plus d'informations sur les autres environnements de liste,
voyez le
\emph on
Guide
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
l'Utilisateur
\emph toggle
.
Si vous voulez utiliser les listes à puce, lisez aussi le paragraphe sur
le choix des puces, à la section
\begin_inset space ~
\end_inset
\emph default
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:puces"
\end_inset
.
\end_layout
\begin_layout Standard
Les deux nouveaux environnements de liste,
\family sans
ListeCochés
\family default
et
\family sans
ListeCroix
\family default
, ont pour but de faciliter l'utilisation de listes
\begin_inset Quotes fld
\end_inset
À
\begin_inset space ~
\end_inset
faire
\begin_inset space ~
\end_inset
/
\begin_inset space ~
\end_inset
À
\begin_inset space ~
\end_inset
éviter
\begin_inset Quotes frd
\end_inset
ou
\begin_inset Quotes fld
\end_inset
Oui
\begin_inset space ~
\end_inset
/
\begin_inset space ~
\end_inset
Non
\begin_inset Quotes frd
\end_inset
, bref, qui utilisent comme puces des coches (
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
ding{51}
\end_layout
\end_inset
) ou des croix (
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
ding{55}
\end_layout
\end_inset
).
Ces listes sont en fait des versions spécialisées de l'environnement
\family sans
Itemize
\family default
.
Elles nécessitent cependant que vous disposiez du paquetage
\family typewriter
psnfss
\family default
.
\end_layout
\begin_layout Subsubsection
Figures et tableaux
\end_layout
\begin_layout Standard
\family sans
\lang english
FoilTeX
\family default
\lang french
redéfinit la notion de figures et tables flottantes afin qu'elles apparaissent
exactement là où elles sont dans le texte plutôt qu'en haut des pages où
en une quelconque autre position prédéfinie.
En fait, si vous changez les réglages de positionnement des flottants,
ces modifications ne seront pas prises en compte.
\end_layout
\begin_layout Subsubsection
En-têtes et pieds de pages
\begin_inset CommandInset label
LatexCommand label
name "sec:foil-en-tetes"
\end_inset
\end_layout
\begin_layout Standard
Les deux commandes
\family sans
Mon_Logo
\family default
et
\family sans
Restriction
\family default
servent à définir le texte en pied de page à gauche.
La première vous permet d'insérer un logo sur vos diapos.
Vous aurez par défaut comme logo
\begin_inset Quotes fld
\end_inset
-Typeset by
\family sans
\lang english
FoilTeX
\family default
\lang french
-
\begin_inset Quotes frd
\end_inset
.
La seconde sert à classifier des documents en fonction du type de public,
par exemple
\begin_inset Quotes fld
\end_inset
Confidentiel
\begin_inset Quotes frd
\end_inset
.
Par défaut elle ne contient rien.
\end_layout
\begin_layout Standard
Vous pouvez remplir les autres coins de la page avec
\family sans
Pied_Droite
\family default
(qui par défaut contient le numéro de page),
\family sans
En-tête_Droite
\family default
et
\family sans
En-tête_Gauche
\family default
.
\end_layout
\begin_layout Subsection
Fonctions de
\family sans
FoilTeX
\family default
non-supportées
\begin_inset CommandInset label
LatexCommand label
name "sec:foil-non-supporte"
\end_inset
\end_layout
\begin_layout Standard
Toutes les commandes décrites ci-dessous doivent être entrées dans un environnem
ent
\family sans
LaTeX
\family default
, ou en mode
\family sans
TeX
\family default
dans un autre environnement.
\end_layout
\begin_layout Subsubsection
Longueurs
\end_layout
\begin_layout Standard
Toutes les longueurs sont ajustées en utilisant la commande
\family typewriter
\backslash
setlength\SpecialChar \-
{
\family default
\emph on
nom_longeur
\family typewriter
\emph toggle
}\SpecialChar \-
{
\family default
\emph on
nouvelle_longeur
\family typewriter
\emph toggle
}
\family default
\emph default
\emph toggle
\emph default
\emph on
nom_longeur
\emph default
\emph toggle
sera remplacé par le nom de la variable de longueur que vous voulez modifier,
et
\emph default
\emph on
nouvelle_longeur
\emph default
\emph toggle
par la valeur de la variable.
Toutes les variables de longueur doivent être indiquées dans des unités
comme le pouce
\begin_inset space ~
\end_inset
(
\family typewriter
in
\family default
), le millimètre
\begin_inset space ~
\end_inset
(
\family typewriter
mm
\family default
) ou le point
\begin_inset space ~
\end_inset
(
\family typewriter
pt
\family default
), ou bien dans une unité dépendant du document ou de la police employée,
comme
\emph default
\family typewriter
\emph toggle
\backslash
textwidth
\family default
.
\end_layout
\begin_layout Standard
Il est possible de changer l'espacement entre l'en-tête et le corps d'une
diapo en ajustant la longueur spécifiée par
\family typewriter
\backslash
foilheadskip
\family default
.
Par exemple, pour rendre
\emph on
tous
\emph default
\emph toggle
les titres plus proches des corps de 0,5
\begin_inset space ~
\end_inset
pouce, mettez dans le préambule
\emph default
\family typewriter
\emph toggle
\backslash
setlength{
\backslash
foilheadskip}{-0.5in}
\family default
.
\end_layout
\begin_layout Standard
L'espacement autour des flottants peut être modifié via
\emph toggle
ces variables :
\end_layout
\begin_layout Labeling
\labelwidthstring MMMMMMMMMMM
\family typewriter
\backslash
abovefloatskip
\family default
Séparation entre le texte et le haut du flottant ;
\end_layout
\begin_layout Labeling
\labelwidthstring MMMMMMMMMMM
\family typewriter
\backslash
abovecaptionskip
\family default
Séparation entre le flottant et sa légende ;
\end_layout
\begin_layout Labeling
\labelwidthstring MMMMMMMMMMM
\family typewriter
\backslash
belowcaptionskip
\family default
Séparation entre la légende et le texte qui la suit ;
\end_layout
\begin_layout Labeling
\labelwidthstring MMMMMMMMMMM
\family typewriter
\backslash
captionwidth
\family default
Vous pouvez rendre les légendes plus étroites que le texte alentour en
réglant cette valeur.
Le mieux est sûrement de la définir en fonction de
\family typewriter
\backslash
textwidth
\family default
.
\end_layout
\begin_layout Standard
Il y a aussi plusieurs variables de longueur relatives à la page de titre.
Elles vous seront utiles dans le cas d'un titre long, ou de plusieurs auteurs
:
\end_layout
\begin_layout Labeling
\labelwidthstring MMMMMMMMMMM
\family typewriter
\backslash
abovetitleskip
\family default
Séparation entre les en-têtes et le titre (environnement
\family sans
Titre
\family default
) ;
\end_layout
\begin_layout Labeling
\labelwidthstring MMMMMMMMMMM
\family typewriter
\backslash
titleauthorskip
\family default
entre les environnements
\family sans
Titre
\family default
et
\family sans
Auteur
\family default
;
\end_layout
\begin_layout Labeling
\labelwidthstring MMMMMMMMMMM
\family typewriter
\backslash
authorauthorskip
\family default
entre différentes lignes de l'environnement
\family sans
Auteur
\family default
;
\end_layout
\begin_layout Labeling
\labelwidthstring MMMMMMMMMMM
\family typewriter
\backslash
authordateskip
\family default
entre l'auteur et la date ;
\end_layout
\begin_layout Labeling
\labelwidthstring MMMMMMMMMMM
\family typewriter
\backslash
dateabstractskip
\family default
entre la date et le résumé (
\family sans
Abstract
\family default
).
\end_layout
\begin_layout Standard
La dernière des commandes d'ajustement de longueur agit sur tous les environneme
nts de liste.
Si vous placez
\family typewriter
\backslash
zerolistvertdimens
\family default
\emph on
dans
\emph default
\emph toggle
un environnement de liste, tout l'espacement vertical entre les éléments
de la liste est supprimé.
Remarquez qu'il s'agit d'une commande et non d'une variable, donc on n'utilise
pas ici
\emph default
\family typewriter
\emph toggle
\backslash
setlength
\family default
.
\end_layout
\begin_layout Subsubsection
En-têtes et pieds de page
\end_layout
\begin_layout Standard
Les commandes
\family typewriter
\backslash
LogoOn
\family default
et
\family sans
\backslash
\family typewriter
LogoOff
\family default
permettent de préciser dans une page donnée si le logo de
\family sans
Mon_Logo
\family default
apparaîtra ou non.
Si vous mettez
\family typewriter
\backslash
LogoOff
\family default
dans le préambule, aucune des diapos n'aura de logo.
Si c'est uniquement sur une diapo particulière que vous ne voulez pas de
logo, mettez
\family typewriter
\backslash
LogoOff
\family default
juste après le début de cette diapo et
\family typewriter
\backslash
LogoOn
\family default
juste après le début de la suivante.
\end_layout
\begin_layout Standard
Si vous voulez utiliser la mise en page
\family sans
fancy
\family default
dans la fenêtre
\family sans
Document\SpecialChar \menuseparator
Paramètres
\family default
, il vous faudra sûrement ajouter
\family typewriter
\backslash
let
\backslash
headwidth
\backslash
textwidth
\family default
à votre préambule.
Ainsi, en format paysage, les en-têtes et les pieds de page seront positionnés
correctement une fois les pages retournées.
C'est obligatoire à cause d'incompatibilités entre le paquetage
\family sans
fancyheadings
\family default
et la classe
\family sans
foils
\family default
.
\end_layout
\begin_layout Section
Diapos Slides (alias S
\noun on
li
\noun default
T
\noun on
e
\noun default
X)
\begin_inset CommandInset label
LatexCommand label
name "sec:slitex"
\end_inset
\end_layout
\begin_layout Standard
par
\noun on
John Weiss
\noun default
.
\end_layout
\begin_layout Subsection
Introduction
\end_layout
\begin_layout Standard
Cette section décrit comment utiliser LyX pour préparer des transparents
pour rétroprojecteurs.
Il y a deux classes de document qui le permettent : la classe par défaut
\family sans
slides
\family default
et la classe
\family sans
FoilteX
\family default
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Il y en a d'autres, comme
\family sans
Beamer
\family default
, mais elle ne sont pas décrites dans ce document (NdT).
\end_layout
\end_inset
.
Cette section décrit la première.
\end_layout
\begin_layout Standard
Je le redis, clairement et distinctement, qu'il n'y ait pas de malentendu
:
\end_layout
\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset
\end_layout
\begin_layout Standard
\align center
\size large
Cette section décrit
\emph on
uniquement
\emph default
la classe
\begin_inset Quotes fld
\end_inset
\family sans
slides
\begin_inset space ~
\end_inset
(default)
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Standard
Si vous cherchez une documentation sur
\begin_inset Quotes fld
\end_inset
\family sans
slides
\begin_inset space ~
\end_inset
(FoilTeX)
\family default
\begin_inset Quotes frd
\end_inset
, voyez la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:foiltex"
\end_inset
.
La classe
\family sans
foils
\family default
(pour
\family sans
FoilTeX
\family default
, vous l'aurez compris) est en fait un peu meilleure que la classe par défaut
\family sans
slides
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
...
enfin, c'est ce que m'ont dit et répété ses défenseurs.
Ne l'ayant jamais utilisée, je n'ai aucune idée de la validité de cette
affirmation.
\end_layout
\end_inset
,
\family default
dont parle cette section.
\end_layout
\begin_layout Standard
Cette classe est l'évolution en LaTeX2e du vieux package S
\noun on
li
\noun default
T
\noun on
e
\noun default
X.
Toutes les distributions de LaTeX2e comprennent cette classe (qu'à partir
de maintenant j'appellerais simplement
\begin_inset Quotes fld
\end_inset
\family sans
slides
\begin_inset Quotes frd
\end_inset
\family default
), donc vous devez logiquement l'avoir.
Comme je l'ai déjà dit, il existe d'autres classes qui produisent aussi
des transparents pour rétroprojecteurs et font du meilleur boulot, comme
\family sans
foils
\family default
.
Cependant, il y a des choses que
\family sans
slides
\family default
fait et que les autres ne font pas, comme générer des sur-couches.
Continuez la lecture pour en savoir plus !
\end_layout
\begin_layout Subsection
Pour commencer
\begin_inset CommandInset label
LatexCommand label
name "sec:demarrer-slides"
\end_inset
\end_layout
\begin_layout Standard
Avant tout, pour utiliser cette classe de document, vous devez sélectionner
\begin_inset Quotes fld
\end_inset
\family sans
slides
\begin_inset space ~
\end_inset
(default)
\begin_inset Quotes frd
\end_inset
\family default
comme
\family sans
Classe
\family default
dans la fenêtre
\family sans
Document\SpecialChar \menuseparator
Paramètres
\family default
.
Il y a quelques particularités qu'il faut connaître à propos de cette classe
:
\end_layout
\begin_layout Itemize
Ne vous fatiguez pas à changer les options
\family sans
Pagination
\family default
et
\family sans
Colonnes
\family default
dans
\family sans
Document\SpecialChar \menuseparator
Paramètres
\family default
: de toute façon, elles ne sont pas supportées par la classe
\family sans
slides.
\end_layout
\begin_layout Itemize
L'option
\family sans
Mise
\begin_inset space ~
\end_inset
en
\begin_inset space ~
\end_inset
page
\family default
de la fenêtre
\family sans
Document\SpecialChar \menuseparator
Paramètres
\family default
a un comportement un peu différent pour cette classe.
Voici les choix possibles et leurs effets :
\end_layout
\begin_deeper
\begin_layout Description
\family sans
plain
\family default
Le rendu final contient des numéros de page dans le coin inférieur droit.
\end_layout
\begin_layout Description
\family sans
headings
\family default
Comme
\family sans
plain
\family default
, mais imprime aussi tous les marqueurs temporels que vous aurez placés.
C'est le choix par défaut.
\end_layout
\begin_layout Description
\family sans
empty
\family default
Le rendu final ne contient pas de numéros de page, de marqueurs temporels
ni de marqueurs d'alignement.
\end_layout
\end_deeper
\begin_layout Itemize
La classe
\family sans
slides
\family default
a une option supplémentaire :
\family typewriter
clock
\family default
.
Pour l'utiliser, mettez
\begin_inset Quotes fld
\end_inset
\family typewriter
clock
\family default
\begin_inset Quotes frd
\end_inset
dans les
\family sans
Options
\family default
de la fenêtre
\family sans
Document\SpecialChar \menuseparator
Paramètres
\family default
\SpecialChar \menuseparator
\family sans
Classe
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
document
\family default
.
\end_layout
\begin_deeper
\begin_layout Standard
Utiliser cette option vous permet d'ajouter des marqueurs temporels aux
\family sans
Note
\family default
s.
Voir la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:note-slides"
\end_inset
pour plus de détails.
\end_layout
\end_deeper
\begin_layout Standard
Vous pouvez aussi utiliser le fichier modèle
\family typewriter
\begin_inset Quotes fld
\end_inset
slides.lyx
\begin_inset Quotes frd
\end_inset
\family default
pour mettre en place automatiquement un document de la classe
\family sans
slides
\family default
(avec
\family sans
Fichier\SpecialChar \menuseparator
Nouveau
\begin_inset space ~
\end_inset
avec
\begin_inset space ~
\end_inset
modèle
\family default
pour créer votre document).
Le fichier modèle contient aussi quelques exemples d'environnements de
paragraphe spéciaux utilisés par cette classe.
Je vais maintenant décrire ces derniers.
\end_layout
\begin_layout Subsection
Environnements de paragraphe
\end_layout
\begin_layout Subsubsection
Environnements supportés
\end_layout
\begin_layout Standard
La première chose que vous allez remarquer en commençant un nouveau document
\family sans
slides
\family default
est la taille et le type de police : il est équivalent à la taille
\family sans
Grand
\begin_inset space ~
\end_inset
(3)
\family default
dans la police
\family sans
Sans
\begin_inset space ~
\end_inset
empattement
\family default
.
C'est aussi la police qui est utilisée pour le rendu final.
Dites-vous que c'est un
\begin_inset Quotes fld
\end_inset
indice visuel
\begin_inset Quotes frd
\end_inset
pour vous rappeler que c'est une diapositive.
Vos transparents finaux utiliseront une grande police, donc vous aurez
moins de place.
Bien sûr, la police plus grande à l'écran n'est pas WYSIWYG, mais juste
un aide-mémoire.
\end_layout
\begin_layout Standard
La deuxième chose qui frappe est le changement du menu des environnements
(tout à gauche de la barre d'outils).
La plupart des environnements de paragraphe que vous avez l'habitude d'y
voir sont absents.
Il y en a aussi cinq nouveaux.
C'est parce que la classe
\family sans
slides
\family default
elle-même ne supporte que certains environnements de paragraphe :
\end_layout
\begin_layout Itemize
\family sans
Standard
\end_layout
\begin_layout Itemize
\family sans
ListePuces
\end_layout
\begin_layout Itemize
\family sans
Énumeration
\end_layout
\begin_layout Itemize
\family sans
Description
\end_layout
\begin_layout Itemize
\family sans
Liste
\end_layout
\begin_layout Itemize
\family sans
Citation
\end_layout
\begin_layout Itemize
\family sans
Cite
\end_layout
\begin_layout Itemize
\family sans
Vers
\end_layout
\begin_layout Itemize
\family sans
Légende
\end_layout
\begin_layout Itemize
\family sans
LyX-Code
\end_layout
\begin_layout Itemize
\family sans
Commentaire
\end_layout
\begin_layout Standard
Tous les autres environnements standard, comme les en-têtes de section,
ne servent pas dans la classe
\family sans
slides
\family default
.
\end_layout
\begin_layout Standard
D'autre part, vous remarquerez de nouveaux environnements :
\end_layout
\begin_layout Itemize
\family sans
Diapo
\family default
(
\family sans
Slide
\family default
)
\end_layout
\begin_layout Itemize
\family sans
Surcouche
\family default
(
\family sans
Overlay)
\end_layout
\begin_layout Itemize
\family sans
Note
\end_layout
\begin_layout Itemize
\family sans
Texte_Invisible
\family default
(
\family sans
InvisibleText
\family default
)
\end_layout
\begin_layout Itemize
\family sans
Texte_Visible
\family default
(
\family sans
VisibleText
\family default
)
\end_layout
\begin_layout Standard
Ces cinq-là présentent des subtilités, dues à une
\begin_inset Quotes fld
\end_inset
fonction
\begin_inset Quotes frd
\end_inset
de LyX.
LyX, voyez-vous, ne vous autorise pas à inclure un environnement de paragraphe
dans un environnement vide.
C'est sympa et marrant, mais cela signifie que vous ne pourrez pas commencer
une diapo par autre chose que du texte.
Pour contourner cela, j'ai fait un peu de
\begin_inset Quotes fld
\end_inset
magie LaTeX
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Subsubsection
Subtilités des nouveaux environnements
\begin_inset CommandInset label
LatexCommand label
name "sec:subtilité-slides"
\end_inset
\end_layout
\begin_layout Standard
Les cinq nouveaux environnements de paragraphe présentent tous des bizarreries,
dues aux limitations inhérentes à la version actuelle de LyX.
Comme je viens de le dire, LyX interdit les environnements qui commencent
par un autre environnement.
Pour contourner ceci, l'environnement
\family sans
Diapo
\family default
n'en est pas vraiment un, si l'on se fie à la description du
\emph on
Guide
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
l'Utilisateur.
\end_layout
\begin_layout Standard
Il faut considérer
\family sans
Diapo
\family default
,
\family sans
Surcouche
\family default
et
\family sans
Note
\family default
comme des
\begin_inset Quotes fld
\end_inset
pseudo-environnements
\begin_inset Quotes frd
\end_inset
.
Ils ressemblent à des en-têtes de section ou à une
\family sans
Légende
\family default
, mais en fait commencent un environnement de paragraphe (et terminent le
précédent si nécessaire).
De la même manière, considérez
\family sans
Texte_Invisible
\family default
et
\family sans
Texte_Visible
\family default
comme des
\begin_inset Quotes fld
\end_inset
pseudo-commandes
\begin_inset Quotes frd
\end_inset
.
Ces deux objets réalisent en effet des actions.
\end_layout
\begin_layout Standard
Un propriété commune aux cinq environnements
\family sans
Diapo
\family default
,
\family sans
Surcouche
\family default
,
\family sans
Note
\family default
,
\family sans
Texte_Invisible
\family default
et
\family sans
Texte_Visible
\family default
est un marqueur plutôt longuet.
Le texte suivant ce marqueur d'ordinaire le contenu de l'environnement
de paragraphe n'est pas pris en compte par
\family sans
Diapo
\family default
,
\family sans
Surcouche
\family default
,
\family sans
Note
\family default
,
\family sans
Texte_Invisible
\family default
et
\family sans
Texte_Visible
\family default
.
LyX l'ignore totalement.
En fait, vous pouvez laisser ces cinq environnements complètement vides.
\end_layout
\begin_layout Standard
Bien qu'il ne soit pas obligatoire de mettre du texte après ces marqueurs,
vous pouvez le faire.
Ça peut être une brève description du contenu de la
\family sans
Diapo
\family default
, par exemple.
Dans ce cas, entrez votre description et tapez
\family sans
Entrée
\family default
comme vous le feriez normalement.
\end_layout
\begin_layout Standard
Si, par contre, vous ne souhaitez pas entrer de texte descriptif, vous allez
rencontrer une autre subtilité de LyX.
LyX, comme la nature, a horreur du vide, et ne vous laissera pas entamer
un nouvel environnement de paragraphe si vous n'avez rien mis dans le précédent.
Vous ferez donc ainsi :
\end_layout
\begin_layout Itemize
Commencez à entrer le texte qui
\emph on
suivra
\emph default
le nouveau paragraphe
\family sans
Diapo
\family default
,
\family sans
Surcouche
\family default
,
\family sans
Note
\family default
,
\family sans
Texte_Invisible
\family default
ou
\family sans
Texte_Visible
\family default
.
\end_layout
\begin_layout Itemize
Placez-vous maintenant au début de ce paragraphe.
\end_layout
\begin_layout Itemize
Tapez ensuite
\family sans
Entrée
\family default
.
\end_layout
\begin_layout Itemize
Changez enfin ce nouveau paragraphe vide en un
\family sans
Diapo
\family default
,
\family sans
Surcouche
\family default
,
\family sans
Note
\family default
,
\family sans
Texte_Invisible
\family default
ou
\family sans
Texte_Visible
\family default
.
\end_layout
\begin_layout Standard
Espérons qu'une future version de LyX résoudra cette bizarrerie\SpecialChar \ldots{}
\end_layout
\begin_layout Subsection
Réaliser une présentation grâce à
\family sans
Diapo
\family default
,
\family sans
Surcouche
\family default
et
\family sans
Note
\end_layout
\begin_layout Subsubsection
Utiliser l'environnement
\family sans
Diapo
\end_layout
\begin_layout Standard
Si vous espérez apprendre dans cette section comment faire une présentation
orale, vous serez amèrement déçu.
Naturellement, je vais vous décrire en quoi la classe
\family sans
slides
\family default
pourra vous aider à préparer les supports de la présentation.
En revanche, le contenu de celle-ci est entièrement de votre ressort.
(C'est ça aussi, la philosophie LyX !)
\end_layout
\begin_layout Standard
Sélectionnez l'environnement
\family sans
Diapo
\family default
(de la manière décrite à la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:subtilité-slides"
\end_inset
) pour dire à LyX de commencer une nouvelle diapo (eh oui).
Le marqueur pour cet environnement /
\begin_inset Quotes fld
\end_inset
pseudo-commande
\begin_inset Quotes frd
\end_inset
est une
\begin_inset Quotes fld
\end_inset
ligne ASCII
\begin_inset Quotes frd
\end_inset
en bleu, suivie de l'indication
\begin_inset Quotes fld
\end_inset
NewSlide:
\begin_inset Quotes frd
\end_inset
.
Tout texte ou paragraphe qui suivra cette dernière fera partie de la nouvelle
diapo.
C'est aussi simple que ça.
\end_layout
\begin_layout Standard
Les diapos sont sûrement les seules fois dans LyX où vous aurez à forcer
la fin des pages (vous pouvez toujours le faire dans
\family sans
Éditer\SpecialChar \menuseparator
Paramètres
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
Paragraphe
\family default
).
En fait, vous devrez le faire une fois vous aurez fini d'entrer le contenu
d'une diapo.
Si vous avez entré plus de texte qu'un transparent ne peut physiquement
en contenir, le surplus débordera sur une nouvelle diapo.
Je vous déconseille de le faire, cependant, car la diapo
\begin_inset Quotes fld
\end_inset
de surplus
\begin_inset Quotes frd
\end_inset
ne présentera aucun numéro de page.
De plus, elle peut interférer avec une
\family sans
Surcouche
\family default
que vous aurez préparé pour accompagner la
\family sans
Diapo
\family default
trop remplie.
\end_layout
\begin_layout Standard
Les environnements
\family sans
Surcouche
\family default
et
\family sans
Note
\family default
fonctionnent comme l'environnement
\family sans
Diapo.
\family default
Tous deux créent une
\begin_inset Quotes fld
\end_inset
ligne ASCII
\begin_inset Quotes frd
\end_inset
suivie par un marqueur (
\begin_inset Quotes fld
\end_inset
NewOverlay:
\begin_inset Quotes frd
\end_inset
et
\begin_inset Quotes fld
\end_inset
NewNote:
\begin_inset Quotes frd
\end_inset
, respectivement).
La couleur n'est plus le bleu, mais un magenta éclatant et la
\begin_inset Quotes fld
\end_inset
ligne ASCII
\begin_inset Quotes frd
\end_inset
se présente différemment, dans son style et sa longueur.
Les trois marqueurs diffèrent par leur police.
\end_layout
\begin_layout Standard
Comme pour l'environnement
\family sans
Diapo
\family default
, si le contenu d'une
\family sans
Note
\family default
ou d'une
\family sans
Surcouche
\family default
dépasse la taille physique d'un transparent ou d'une feuille de papier,
le surplus sera disposé sur une nouvelle page.
À nouveau, je vous le déconseille, les
\family sans
Notes
\family default
et
\family sans
Surcouches
\family default
n'auraient plus aucune utilité.
\end_layout
\begin_layout Subsubsection
Utiliser des
\family sans
Surcouches
\family default
avec des
\family sans
Diapos
\end_layout
\begin_layout Standard
L'idée d'une
\family sans
Surcouche
\family default
est de créer une diapo qui vienne se superposer à une autre.
Vous pouvez vouloir présenter une figure sur la
\family sans
Diapo
\family default
principale avant d'afficher le texte qui va avec.
Une façon de faire est de poser une feuille de papier noire sur la partie
de la
\family sans
Diapo
\family default
que vous souhaitez cacher.
Cette méthode, cependant, n'est pas valable si vous voulez par exemple
superposer un graphique à un autre.
Vous auriez alors à vous bagarrer, tout en parlant, avec les deux
\family sans
Diapos
\family default
pour que les graphiques se superposent.
L'utilisation des
\family sans
Surcouches
\family default
rend les choses bien plus faciles.
\end_layout
\begin_layout Standard
Chaque
\family sans
Surcouche
\family default
reçoit le numéro de page de la
\family sans
Diapo
\family default
\begin_inset Quotes fld
\end_inset
parent
\begin_inset Quotes frd
\end_inset
, agrémenté d'un
\family typewriter
\begin_inset Quotes fld
\end_inset
-a
\begin_inset Quotes frd
\end_inset
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Des
\family sans
Surcouches
\family default
multiples auront donc
\family typewriter
\begin_inset Quotes fld
\end_inset
-b
\begin_inset Quotes frd
\end_inset
\family default
,
\family typewriter
\begin_inset Quotes fld
\end_inset
-c
\begin_inset Quotes frd
\end_inset
\family default
, etc.
accolé au numéro de page.
\end_layout
\end_inset
\family default
.
En effet, vous voulez que la
\family sans
Diapo
\family default
et sa
\family sans
Surcouche
\family default
paraissent n'en former plus qu'une ! Vous pouvez considérérer une
\family sans
Surcouche
\family default
comme
\begin_inset Quotes fld
\end_inset
faisant partie
\begin_inset Quotes frd
\end_inset
d'une
\family sans
Diapo
\family default
.
En fait, la classe
\family sans
slides
\family default
le laisse voir : le marqueur qui débute un environnement
\family sans
Surcouche
\family default
est moins long que celui d'une
\family sans
Diapo
\family default
.
Enfin, sur le document imprimé apparaîtront des marques d'alignement aux
quatre coins de la
\family sans
Surcouche
\family default
et de la
\family sans
Diapo
\family default
.
Ces marques vous aideront à aligner les deux transparents.
\end_layout
\begin_layout Standard
Le principal problème de la superposition de transparents est d'aligner
les contenus de ces diapos.
Quel espace devez-vous laisser pour le graphique sur la deuxième diapo
? Pire encore : que faire si sur le deuxième transparent vous voulez un
graphique et du texte, mais qu'une phrase du premier doit venir s'intercaler
entre les deux ? Vous pourriez essayer d'insérer un espace vertical de
la bonne taille entre les deux, mais le meilleur moyen est d'utiliser les
environnements
\family sans
Texte_Visible
\family default
et
\family sans
Texte_Invisible
\family default
.
\end_layout
\begin_layout Standard
Comme leur nom l'indique,
\family sans
Texte_Visible
\family default
et
\family sans
Texte_Invisible
\family default
sont deux environnements de paragraphe, qui rendent le texte respectivement
visible et invisible.
Remarquez à la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:subtilité-slides"
\end_inset
que vous ne placez rien
\emph on
dans
\emph default
\emph toggle
ces environnements.
Lorsque vous créez un
\emph default
\family sans
\emph toggle
Texte_Invisible
\family default
, LyX insère un marqueur centré, bleu clair, indiquant
\begin_inset Quotes fld
\end_inset
<Invisible Text Follows>
\begin_inset Quotes frd
\end_inset
.
Les paragraphes suivant ce marqueur ne seront pas affichés sur la diapo
(ou la
\emph default
\family sans
\emph toggle
Surcouche
\family default
), mais l'espace qu'ils auraient occupé sera laissé vide.
\end_layout
\begin_layout Standard
Pour
\family sans
Texte_Visible
\family default
, l'étiquette centrée sera
\begin_inset Quotes fld
\end_inset
<Visible Text Follows>
\begin_inset Quotes frd
\end_inset
, en vert.
Les paragraphes qui suivent cette étiquette se comporteront normalement.
Remarquez qu'au début d'une nouvelle
\family sans
Diapo
\family default
,
\family sans
Note
\family default
, ou
\family sans
Surcouche
\family default
, la fonction
\family sans
Texte_Invisible
\family default
est automatiquement désactivée.
Il n'est donc pas nécessaire d'utiliser
\family sans
Texte_Visible
\family default
à la fin d'une
\family sans
Diapo
\family default
.
\end_layout
\begin_layout Standard
Maintenant, voyons comment utiliser les commandes
\family sans
Texte_Visible
\family default
et
\family sans
Texte_Invisible
\family default
avec les environnements
\family sans
Diapo
\family default
et
\family sans
Surcouche
\family default
pour créer des diapos superposées :
\end_layout
\begin_layout Enumerate
Créez une
\family sans
Diapo
\family default
(environnement
\family sans
Diapo
\family default
) avec tout ce qui devra apparaître autant sur la
\family sans
Diapo
\family default
elle-même que sur les
\family sans
Surcouches
\family default
.
\end_layout
\begin_layout Enumerate
Avant chaque figure ou paragraphe qui ne devra apparaître que sur la
\family sans
Surcouche
\family default
, insérez un environnement
\family sans
Texte_Invisible
\family default
.
Si nécessaire, insérez un environnement
\family sans
Texte_Visible
\family default
là où le texte devra de nouveau apparaître sur la
\family sans
Diapo
\family default
principale.
\end_layout
\begin_layout Enumerate
Commencez un environnement
\family sans
Surcouche
\family default
juste après l'environnement
\family sans
Diapo
\family default
.
\end_layout
\begin_layout Enumerate
Copiez le contenu de l'environnement
\family sans
Diapo
\family default
dans l'environnement
\family sans
Surcouche
\family default
.
\end_layout
\begin_layout Enumerate
Dans la
\family sans
Surcouche
\family default
, changez tous les
\family sans
Texte_Invisible
\family default
par des
\family sans
Texte_Visible
\family default
et vice versa.
\end_layout
\begin_layout Standard
C'est bon, vous avez votre superposition.
\end_layout
\begin_layout Standard
Il reste un problème avec la façon dont j'ai conçu la classe
\family sans
slides
\family default
de LyX : vous ne pouvez pas rendre invisible du texte au milieu d'un paragraphe
, ni rendre visible du texte au milieu d'un paragraphe invisible.
Pour ce faire, vous devrez insérer du code LaTeX
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Les commandes en question sont :
\end_layout
\begin_layout Itemize
\family typewriter
{
\backslash
invisible ...}
\end_layout
\begin_layout Itemize
\family typewriter
{
\backslash
visible ...}
\end_layout
\begin_layout Plain Layout
...
et devront être entrées en mode TeX.
Le texte dont vous voulez changer la
\begin_inset Quotes fld
\end_inset
visibilité
\begin_inset Quotes frd
\end_inset
sera à l'intérieur des accolades, derrière la commande
\family typewriter
\backslash
invisible
\family default
ou
\family typewriter
\backslash
visible
\family default
.
Si vous ne savez pas comment entrer du TeX sous LyX, voyez la section approprié
e dans le
\emph on
Guide
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
l'Utilisateur
\family sans
\emph toggle
.
\end_layout
\end_inset
.
\end_layout
\begin_layout Subsubsection
Utiliser des
\family sans
Notes
\family default
avec des
\family sans
Diapos
\family default
\begin_inset CommandInset label
LatexCommand label
name "sec:note-slides"
\end_inset
\end_layout
\begin_layout Standard
Comme une
\family sans
Surcouche
\family default
, une
\family sans
Note
\family default
est toujours associée à une
\family sans
Diapo
\family default
\begin_inset Quotes fld
\end_inset
parent
\begin_inset Quotes frd
\end_inset
.
Ici aussi, la classe
\family sans
slides
\family default
de LyX fournit des indices visuels.
Le marqueur d'une
\family sans
Note
\family default
est magenta éclatant, comme celui d'une
\family sans
Surcouche
\family default
; et en longueur, il est intermédiaire entre celui d'une
\family sans
Diapo
\family default
(qui est plus long) et celui d'une
\family sans
Surcouche
\family default
(qui est plus court).
De plus, une fois imprimée, une
\family sans
Note
\family default
aura le numéro de page de sa
\family sans
Diapo
\family default
\begin_inset Quotes fld
\end_inset
parent
\begin_inset Quotes frd
\end_inset
avec
\family typewriter
\begin_inset Quotes fld
\end_inset
-1
\begin_inset Quotes frd
\end_inset
\family default
,
\family typewriter
\begin_inset Quotes fld
\end_inset
-2
\begin_inset Quotes frd
\end_inset
\family default
,
\family typewriter
\begin_inset Quotes fld
\end_inset
-3
\begin_inset Quotes frd
\end_inset
\family default
, etc.
accolé.
Vous pouvez avoir plusieures
\family sans
Notes
\family default
associées à une seule
\family sans
Diapo
\family default
, et, comme pour les
\family sans
Diapos
\family default
et les
\family sans
Surcouches
\family default
, vous voudrez sûrement couper les longues
\family sans
Notes
\family default
de manière à ce qu'elles tiennent sur une seule page.
\end_layout
\begin_layout Standard
L'utilité d'une
\family sans
Note
\family default
est évidente : elle contient toute sortes d'informations que vous voulez
ajouter à propos d'une
\family sans
Diapo
\family default
.
Elle peut aussi servir d'aide-mémoire pour une
\family sans
Diapo
\family default
donnée.
Dans ce dernier cas, vous serez peut-être intéressé par les marqueurs temporels.
Actuellement, la classe
\family sans
slides
\family default
de LyX ne supporte pas d'origine les marqueurs temporels, qui sont une
fonction
\noun on
Sli
\noun default
T
\noun on
e
\noun default
X.
Il faudra donc passer par le code LaTeX.
\end_layout
\begin_layout Standard
Pour utiliser des marqueurs temporels, spécifiez avant tout l'option supplémenta
ire
\begin_inset Quotes fld
\end_inset
\family typewriter
clock
\family default
\begin_inset Quotes frd
\end_inset
(voir la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:demarrer-slides"
\end_inset
).
Cette option active les marqueurs temporels qui apparaîtront alors dans
le coin inférieur gauche de toutes les
\family sans
Notes
\family default
que vous générerez.
Pour choisir ce qui apparaîtra dans ces indicateurs, utilisez les commandes
LaTeX
\begin_inset Quotes fld
\end_inset
\family typewriter
\backslash
settime{}
\family default
\begin_inset Quotes frd
\end_inset
et
\begin_inset Quotes fld
\end_inset
\family typewriter
\backslash
addtime{}
\family default
\begin_inset Quotes frd
\end_inset
.
Le paramètre de chacune de ces commandes est un temps mesuré en secondes.
\begin_inset Quotes fld
\end_inset
\family typewriter
\backslash
settime{}
\family default
\begin_inset Quotes frd
\end_inset
sert à indiquer le temps voulu, tandis que
\begin_inset Quotes fld
\end_inset
\family typewriter
\backslash
addtime{}
\family default
\begin_inset Quotes frd
\end_inset
est utilisé pour ajouter une certaine durée.
En utilisant les
\family sans
Notes
\family default
et les marqueurs temporels, vous pouvez vous rappeler combien de temps
vous voulez passer sur chaque
\family sans
Diapo
\family default
.
\end_layout
\begin_layout Standard
Il reste une fonction à décrire.
Vous voudrez forcément imprimer toutes vos
\family sans
Diapos
\family default
et
\family sans
Surcouches
\family default
sur des transparents et toutes vos
\family sans
Notes
\family default
sur des feuilles blanches.
Cependant, une
\family sans
Note
\family default
doit suivre la
\family sans
Diapo
\family default
à laquelle elle est associée.
Comment faire ?
\end_layout
\begin_layout Standard
Heureusement il existe deux commandes LaTeX qui vous permettent de sélectionner
ce qu'il faut imprimer.
Toutes deux doivent être placées dans le préambule de votre document.
La commande
\begin_inset Quotes fld
\end_inset
\family typewriter
\backslash
onlyslides{
\backslash
slides}
\family default
\begin_inset Quotes frd
\end_inset
n'imprimera que les
\family sans
Diapos
\family default
et les
\family sans
Surcouches
\family default
.
De même, la commande
\begin_inset Quotes fld
\end_inset
\family typewriter
\backslash
onlynotes{notes}
\family default
\begin_inset Quotes frd
\end_inset
n'imprimera que les
\family sans
Notes
\family default
.
Je vous conseille de mettre les deux commandes en commentaire dans votre
préambule et de
\begin_inset Quotes fld
\end_inset
décommenter
\begin_inset Quotes frd
\end_inset
celle dont vous avez besoin à l'impression.
J'ai l'habitude de : décommenter
\family typewriter
\begin_inset Quotes fld
\end_inset
\backslash
onlyslides{
\backslash
slides}
\begin_inset Quotes frd
\end_inset
\family default
, imprimer dans un fichier dont le nom contient
\family typewriter
\begin_inset Quotes fld
\end_inset
-slides
\begin_inset Quotes frd
\end_inset
\family default
, la recommenter et décommenter
\family typewriter
\begin_inset Quotes fld
\end_inset
\backslash
onlynotes{
\backslash
notes}
\begin_inset Quotes frd
\end_inset
\family default
et imprimer dans un fichier
\family typewriter
\begin_inset Quotes fld
\end_inset
*-notes
\begin_inset Quotes frd
\end_inset
\family default
.
Je peux ensuite envoyer l'un ou l'autre fichier à l'imprimante, en mettant
des transparents ou des feuilles blanches selon le cas.
\end_layout
\begin_layout Standard
Vous pouvez aussi donner d'autres paramètres à
\begin_inset Quotes fld
\end_inset
\family typewriter
\backslash
onlyslides{}
\family default
\begin_inset Quotes frd
\end_inset
et
\begin_inset Quotes fld
\end_inset
\family typewriter
\backslash
onlynotes{}
\family default
\begin_inset Quotes frd
\end_inset
.
Reportez-vous à un bon livre sur LaTeX pour plus de détails.
\end_layout
\begin_layout Subsection
Le fichier modèle pour la classe
\family sans
slides
\end_layout
\begin_layout Standard
J'ai aussi créé un fichier modèle,
\begin_inset Quotes fld
\end_inset
\family typewriter
slides.lyx
\family default
\begin_inset Quotes frd
\end_inset
avec la classe
\family sans
slides
\family default
.
Pour l'utiliser, créez votre document avec
\family sans
Fichier\SpecialChar \menuseparator
Nouveau
\begin_inset space ~
\end_inset
avec
\begin_inset space ~
\end_inset
modèle
\family default
.
Votre fichier de présentation LyX contiendra un exemple du triplet
\family sans
Diapo Surcouche Note
\family default
.
De plus, la
\family sans
Diapo
\family default
et la
\family sans
Surcouche
\family default
contiennent un exemple de
\family sans
Texte_Invisible
\family default
et de
\family sans
Texte_Visible
\family default
.
Enfin, le préambule contient :
\end_layout
\begin_layout LyX-Code
% Uncomment to print out only slides and overlays
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT :
\family typewriter
Décommentez pour n'imprimer que les diapos et les sur-couches
\end_layout
\end_inset
\end_layout
\begin_layout LyX-Code
%
\end_layout
\begin_layout LyX-Code
%
\backslash
onlyslides{
\backslash
slides}
\begin_inset Newline newline
\end_inset
\end_layout
\begin_layout LyX-Code
% Uncomment to print out only notes
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT :
\family typewriter
Décommentez pour n'imprimer que les notes
\end_layout
\end_inset
\end_layout
\begin_layout LyX-Code
%
\end_layout
\begin_layout LyX-Code
%
\backslash
onlynotes{
\backslash
notes}
\end_layout
\begin_layout Standard
Un dernier point : j'ai créé cette classe pour l'utilisation de la classe
de LaTeX2e
\begin_inset Quotes fld
\end_inset
émulation de
\noun on
SliTeX
\noun default
\begin_inset Quotes frd
\end_inset
.
Ni moi ni le reste de l'Équipe LyX n'impose d'utiliser ou de ne pas utiliser
cette classe.
Elle est là si vous en avez besoin.
Il y a d'autres classes de LaTeX2e pour créer des présentations, comme
la classe
\family sans
Foils
\family default
(cf.
la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:foiltex"
\end_inset
) ou le paquetage
\family sans
seminar
\family default
\noun toggle
(présent sur certaines distributions TeX).
Ce dernier n'est pas encore supporté par LyX
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Si vous voulez vous y mettre...
\end_layout
\end_inset
.
\noun default
Je ne connais rien à ces classes.
Essayez-les pour voir quelles alternatives elles représentent.
\end_layout
\begin_layout Section
Hollywood (scripts d'Hollywood)
\end_layout
\begin_layout Standard
par
\shape smallcaps
Garst Reese
\end_layout
\begin_layout Subsection
Introduction
\end_layout
\begin_layout Standard
Maîtriser le format d'un script d'Hollywood est un
\begin_inset Quotes fld
\end_inset
rite de passage
\begin_inset Quotes frd
\end_inset
.
Ce format est destiné à laisser le lecteur se concentrer sur le contenu
et à être facile à lire et familier pour les acteurs.
Chaque page d'un script doit représenter une minute de film.
Il n'y a rien dans le script qui ne soit pas visible ou audible à l'écran.
La police courier 12
\begin_inset space ~
\end_inset
pt doit être utilisée tout le long.
Pas d'italiques.
\end_layout
\begin_layout Subsection
Problèmes particuliers
\end_layout
\begin_layout Standard
Les lignes de dialogue ne doivent JAMAIS être coupées au milieu d'une phrase.
Si le texte d'un personnage
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT :
\family sans
Speaker
\end_layout
\end_inset
franchit un saut de page, repétez le nom du personnage suivi de (Cont'd)
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT : (suite)
\end_layout
\end_inset
.
\end_layout
\begin_layout Subsection
Fonctions particulières
\end_layout
\begin_layout Standard
Entrez les noms des personnages comme étiquettes, puis faites des références
croisées sur ces étiquettes pour insérer le nom.
La fenêtre de référence croisée montrera l'ensemble des personnages.
Vous pouvez utiliser cette méthode également pour insérer le nom d'un personnag
e dans les parties narratives.
\end_layout
\begin_layout Subsection
Taille de papier et marges
\end_layout
\begin_layout Standard
USLetter, gauche 1,6
\begin_inset space ~
\end_inset
in, droite 0,75
\begin_inset space ~
\end_inset
in, haut 0,5
\begin_inset space ~
\end_inset
in, bas 0,75
\begin_inset space ~
\end_inset
in.
\end_layout
\begin_layout Subsection
Environnements
\end_layout
\begin_layout Standard
Les environnements suivants sont disponibles.
Vous pouvez utiliser
\family typewriter
hollywood.bind
\family default
pour accéder aux touches de raccourci indiquées à droite.
\end_layout
\begin_layout Itemize
\family sans
Standard
\family default
\family sans
\begin_inset Newline newline
\end_inset
\family default
Quand rien d'autre ne convient.
Essayez de l'éviter.
\end_layout
\begin_layout Itemize
\family sans
FADE_IN
\family default
(Fondu
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT : Incertain.
\end_layout
\end_inset
):
\begin_inset space \hfill{}
\end_inset
\family sans
M-z S-I
\family default
\begin_inset Newline newline
\end_inset
Suivi en général de quelque chose comme
\begin_inset Quotes fld
\end_inset
sur Sally qui se lève
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Itemize
\family sans
INT :
\begin_inset space \hfill{}
\end_inset
M-z i
\begin_inset Newline newline
\end_inset
\family default
Introduit une nouvelle séquence INTÉRIEUR.
Toujours suivi par JOUR ou NUIT, ou quelque chose d'approchant pour définir
l'éclairage nécessaire.
Toute cette ligne en MAJUSCULES.
\end_layout
\begin_layout Itemize
\family sans
EXT :
\begin_inset space \hfill{}
\end_inset
M-z e
\begin_inset Newline newline
\end_inset
\family default
Introduit une nouvelle séquence EXTÉRIEUR.
Toute cette ligne en MAJUSCULES.
\end_layout
\begin_layout Itemize
\family sans
Speaker
\begin_inset space \hfill{}
\end_inset
M-z s
\begin_inset Newline newline
\end_inset
\family default
Le personnage qui parle.
\end_layout
\begin_layout Itemize
\family sans
Parenthetical
\begin_inset space \hfill{}
\end_inset
M-z p
\begin_inset Newline newline
\end_inset
\family default
Instructions au personnage intervenant.
Les () sont insérées automatiquement, mais seule la ( sera affichée dans
LyX.
Les deux seront imprimées.
\end_layout
\begin_layout Itemize
\family sans
Dialogue
\begin_inset space \hfill{}
\end_inset
M-z d
\begin_inset Newline newline
\end_inset
\family default
Ce qui dit le personnage.
\end_layout
\begin_layout Itemize
\family sans
Transition
\begin_inset space \hfill{}
\end_inset
M-z t
\begin_inset Newline newline
\end_inset
\family default
Instruction de mouvement de caméra.
\end_layout
\begin_layout Itemize
\family sans
FADE OUT:
\begin_inset space \hfill{}
\end_inset
M-z S-I
\end_layout
\begin_layout Itemize
\family sans
Auteur
\begin_inset space \hfill{}
\end_inset
M-z S-A
\end_layout
\begin_layout Itemize
\family sans
Titre
\begin_inset space \hfill{}
\end_inset
M-z S-T
\end_layout
\begin_layout Itemize
\family sans
Right_Address
\begin_inset space \hfill{}
\end_inset
M-z r
\end_layout
\begin_layout Subsection
Jargon de script
\end_layout
\begin_layout Itemize
(O.S) off screen (hors écran)
\end_layout
\begin_layout Itemize
(V.O) voice over (voix off)
\end_layout
\begin_layout Itemize
b.g.
background (arrière-plan)
\end_layout
\begin_layout Itemize
C.U.
close-up (plan rapproché)
\end_layout
\begin_layout Itemize
PAN mouvement de caméra
\end_layout
\begin_layout Itemize
INSERT insérez un plan rapproché
\end_layout
\begin_layout Section
ijmpc et ijmpd
\end_layout
\begin_layout Standard
par
\noun on
Panayotis Papasotiriou
\end_layout
\begin_layout Subsection
En résumé
\end_layout
\begin_layout Standard
Le paquetage
\family typewriter
ijmpc
\family default
est un jeu de macros pour faciliter les soumissions électroniques de manuscrits
à l'
\emph on
\lang english
International Journal of Modern Physics C
\emph default
\lang french
publié par
\lang english
World Scientific
\lang french
.
De la même manière
\family typewriter
ijmpd
\family default
est destiné à des manuscrits soumis à l'
\emph on
I
\lang english
ntenational Journal of Modern Physics D
\emph default
\lang french
.
Les classes de document s'appellent respectivement
\family typewriter
ws-ijmpc.cls
\family default
et
\family typewriter
ws-ijmpd.cls.
\family default
Vous pouvez télécharger ce fichier, ainsi que des recommandations aux auteurs,
sur les sites
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
http://www.worldscinet.com/ijmpc/mkt/guidelines.shtml
\end_layout
\end_inset
et
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
http://www.worldscinet.com/ijmpd/mkt/guidelines.shtml
\end_layout
\end_inset
.
Ces deux paquetages sont des versions modifiées du paquetage standard
\begin_inset Quotes fld
\end_inset
article
\begin_inset Quotes frd
\end_inset
, et ils sont presques identiques (mais pas tout à fait).
LyX sait gérer la plupart de leurs fonctions.
J'ai utilisé LyX avec succès pour écrire des articles soumis à ces deux
journaux.
\end_layout
\begin_layout Subsection
Écrire un papier
\end_layout
\begin_layout Standard
Comme d'habitude, la façon la plus simple d'écrire un papier est de commencer
par un modèle.
Faites
\family sans
Fichier\SpecialChar \menuseparator
Nouveau
\begin_inset space ~
\end_inset
avec
\begin_inset space ~
\end_inset
Modèle
\family default
, et choisissez le modèle
\family typewriter
ijmpc.lyx
\family default
ou le modèle
\family typewriter
ijmpd.lyx
\family default
.
Ça vous donnera un document (presque) vide comprenant les parties les plus
courantes d'un manuscrit.
Vous n'avez qu'à écrire votre texte par dessus le texte existant (en effaçant
aussi les crochets
\family typewriter
<>
\family default
).
Veuillez juste garder ce qui suit présent à l'esprit.
\end_layout
\begin_layout Enumerate
LyX ne vous laissera pas changer la taille de police ni la mise en page
du document, car les deux paquetage ne permettent pas de telles modifications.
\end_layout
\begin_layout Enumerate
La langue du document ne doit pas être modifiée.
Avant de Visionner votre papier, assurez-vous que vous n'utilisez pas le
paquetage
\family typewriter
babel
\family default
.
Pour cela, faites
\family sans
Outils\SpecialChar \menuseparator
Préférences
\family default
, et dans l'onglet
\family sans
Paramètres
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
langue\SpecialChar \menuseparator
Langue
\family default
, décochez la case
\family sans
Utiliser
\begin_inset space ~
\end_inset
Babel
\family default
et cliquez sur
\family sans
Appliquer
\family default
(ou
\family sans
Enregistrer
\family default
si vous voulez retenir ce changement).
\end_layout
\begin_layout Enumerate
Le style
\begin_inset Quotes fld
\end_inset
Mots clés
\begin_inset Quotes frd
\end_inset
doit être utilisé pour définir les mots clés.
\end_layout
\begin_layout Enumerate
Le paquetage
\family typewriter
ijmpc
\family default
fournit un style nommé
\begin_inset Quotes fld
\end_inset
Code de classification
\begin_inset Quotes frd
\end_inset
, qui peut être utilisé pour définir des codes de clasification comme les
numéros PACS.
Notez que cette fonction n'est pas disponible dans le paquetage
\family typewriter
ijmpd
\family default
.
\end_layout
\begin_layout Enumerate
Plusieurs nouveaux environnements sont disponibles :
\begin_inset Quotes fld
\end_inset
Définition
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
Étape
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
Exemple
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
Remarque
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
Notation
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
Théorème
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
Preuve
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
Corollaire
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
Lemme
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
Proposition
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
Prop
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
Question
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
Affirmation
\begin_inset Quotes frd
\end_inset
et
\begin_inset Quotes fld
\end_inset
Conjecture
\begin_inset Quotes frd
\end_inset
.
Leur utilisation est plus ou moins évidente.
LyX gère tous ces environnements ; il utilisera l'étiquette, le style de
texte, et le schéma de numérotation qui convient pour chacun d'eux.
\end_layout
\begin_layout Enumerate
Les deux paquetages utilisent des citations de base ; on ne doit pas utiliser
le paquetage
\family typewriter
natbib
\family default
.
Dans LyX, les citations s'affichent comme d'habitude ; dans la sortie,
les citations apparaissent comme des exposants.
Si vous voules utiliser une citation en texte normal, vous devez utiliser
la commande
\family typewriter
refcite
\family default
, par exemple
\begin_inset Quotes fld
\end_inset
See Ref.
\begin_inset space ~
\end_inset
\family typewriter
\backslash
refcite{clé}
\begin_inset Quotes frd
\end_inset
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Je ne traduis pas, vu que c'est un journal en anglais (NdT).
\end_layout
\end_inset
.
\end_layout
\begin_layout Enumerate
Il n'y a pas de section
\begin_inset Quotes fld
\end_inset
Remerciments
\begin_inset Quotes frd
\end_inset
dans les deux paquetages, utilisez simplement l'environnement
\begin_inset Quotes fld
\end_inset
Section*
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Enumerate
Vous pouvez ajouter des appendices au papier,
\emph on
après
\emph default
les remerciements et
\emph on
avant
\emph default
les Références.
LyX propose un environnement spécial, appelé
\family sans
Section
\begin_inset space ~
\end_inset
d'appendices
\family default
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT : ou
\family sans
Appendices Section
\family default
.
\end_layout
\end_inset
qui indique le début des appendices.
Cet environnement doit être laissé vide ; il sert juste à emettre une commande
LaTeX, mais rien n'est imprimé.
Dans LyX, le mot
\begin_inset Quotes fld
\end_inset
Appendices
\begin_inset Quotes frd
\end_inset
apparaît en lettres bleues, comme indications que toutes les sections qui
suvent ce point sont des appendices.
Pour écrire un appendice, utilisez l'environnement
\begin_inset Quotes fld
\end_inset
Appendice
\begin_inset Quotes frd
\end_inset
.
LyX va numéroter chaque appendice avec une lettre majuscule, comme cela
est demandé par les deux journaux.
Notes que la
\begin_inset Quotes fld
\end_inset
Section d'appendices
\begin_inset Quotes frd
\end_inset
\emph on
doit
\emph default
être présente avant le premier appendice ; si ce n'est pasle cas, tous
les appendices seront numérotés comme des sections normales, dans la sortie.
Un appendice peut contenir des
\family sans
Section
\family default
s,
\family sans
SousSection
\family default
s et
\family sans
SousSousSection
\family default
s de la manière habituelle.
\end_layout
\begin_layout Enumerate
Les paquetages
\family typewriter
ijmpc
\family default
et
\family typewriter
ijmpd
\family default
utilisent la commande
\family typewriter
tbl
\family default
pour les légendes des tableaux.
La conséquence en est qu'un tableau créé avec LyX est affiché correctement,
mais sans sa légende.
Cependant, vous pouvez utiliser un peu d'ERT our contourner ce problème,
de façon à ce que les légendes s'impriment comme prévu.
Pour le faire, créez un flottant de tableau comme d'habitude, effacez la
légende, et remplacez la par le code LaTeX
\family typewriter
\backslash
tbl{votre légende de tableau}{
\family default
(sic) ; vous devez ensuite mettre le code LaTeX
\family typewriter
}
\family default
immédiatement après votre tableau.
Étudiez l'exemple de tableau qui est inclu dans le fichier modèle pour
voir comme cette astuce est utilisée.
Une autre soution, si vous avez besoin de légendes de tableaux, est de
construire tout le tableau dans un fichier
\family typewriter
.tex
\family default
, puis inclure celui-ci dans le document LyX (par
\family sans
Insérer\SpecialChar \menuseparator
Fichier\SpecialChar \menuseparator
Sous-document
\family default
).
Vous pouvez trouver des consignes pour la création d'un tableau flottant
dans les fichier
\family typewriter
ws-ijmpc.tex
\family default
et
\family typewriter
ws-ijmpd.tex
\family default
, qui se trouve dans la distribution des paquetages correspondants.
\end_layout
\begin_layout Subsection
Préparer un papier avant de le soumettre
\end_layout
\begin_layout Standard
Avant de soumettre votre papier vous devez exporter le document LyX en tant
que fichier LaTeX (
\family sans
Fichier\SpecialChar \menuseparator
Exporter\SpecialChar \menuseparator
LaTeX
\family default
), puis modifier le fichier
\family typewriter
.tex
\family default
exporté comme suit
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
En fait, vous avez le choix entre LaTeX
\begin_inset space ~
\end_inset
(plain) et LaTeX
\begin_inset space ~
\end_inset
(pdflatex).
Si vous prévoyez d'utiliser pdflatex pour préparer votre papier, vous devez
utiliser l'option pdflatex pour que les graphiques soient convertis au
format PDF, prêts à être utiliséspar pdflatex.
\end_layout
\end_inset
:
\end_layout
\begin_layout Enumerate
Enlevez les lignes de commentaires avant la commande
\family typewriter
\backslash
documentclass
\family default
.
\end_layout
\begin_layout Enumerate
Enlevez tout ce qui se trouve entre les commandes
\family typewriter
\backslash
makeatletter
\family default
et
\family typewriter
\backslash
makeatother
\family default
comprises, sauf les commandes que vous avez vous-même ajoutées dans le
préambule LaTeX.
\end_layout
\begin_layout Standard
Vous devez maintenant sauvegarder le fichier
\family typewriter
.tex
\family default
ainsi modifié, et lancer LaTeX dessus autant de fois que nécessaire.
Vous pouvez alors contrôler l'aspect du document
\family typewriter
.dvi
\family default
correspondant.
\end_layout
\begin_layout Subsection
Utilisation du code TeX
\end_layout
\begin_layout Standard
L'usage du code TeX est réduit à deux commandes, qui doivent être placées
au début du document.
Si vous avez commencé à écrire votre papier à partir du modèle
\family typewriter
ijmpc.lyx
\family default
ou
\family typewriter
ijmpd.lyx
\family default
, le code TeX nécessaire est déjà là, et vous n'avez normalement pas besoin
de l'effacer.
Vous pouvez seulement changer le premier ERT pour spécifier ce qui s'imprime
en haut des pages paires et impaires (respectivement le titre abrégé et
le nom des auteurs).
Ce code TeX doit être de la forme
\family typewriter
\backslash
markboth{Noms des Auteurs}{Titre Abrégé du Papier}
\family default
.
\end_layout
\begin_layout Section
iopart
\end_layout
\begin_layout Standard
par
\noun on
Uwe Stöhr
\end_layout
\begin_layout Subsection
En résumé
\end_layout
\begin_layout Standard
Le paquetage
\family typewriter
iopart
\family default
fournit une classe de document pour créer un manuscrit adapté pour une
soumission électronique à un des journaux publiés par l'IoP
\emph on
(Institute of Physics)
\emph default
.
Les instructions aux auteurs pour créer un papier en utilisant la classe
\family typewriter
iopart
\family default
peuvent être téléchargées en même temps que le paquetage iopart à partir
du site
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
ftp://ftp.iop.org/pub/journals/latex2e
\end_layout
\end_inset
.
\end_layout
\begin_layout Subsection
Écrire un papier
\end_layout
\begin_layout Standard
La manière la plus simple pour écrire un papier est de commencer avec le
fichier
\family typewriter
IOP-article.lyx
\family default
qui est disponible dans la liste des modèles de LyX.
Faites
\family sans
Fichier\SpecialChar \menuseparator
Nouveau
\begin_inset space ~
\end_inset
avec
\begin_inset space ~
\end_inset
Modèle
\family default
, et choisissez le modèle, enregistrez-le sous un nouveau nom et commencez
à écrire.
Le modèle explique comment utiliser les environnements spéciaux.
Voici les conseils les plus importants :
\end_layout
\begin_layout Itemize
Pour pouvoir compiler votre document en PDF, PS ou DVI, vérifiez ques les
deux options
\family sans
Utilise
\begin_inset space ~
\end_inset
le
\begin_inset space ~
\end_inset
paquetage math
\begin_inset space ~
\end_inset
AMS
\family default
ne sont pas activées dans les paramètres du document,
\family sans
options des Maths
\family default
.
\family sans
\end_layout
\begin_layout Itemize
L'environnement de titre définit le type de document.
Vous devez donc utiliser un des environnements suivants pour le titre :
\end_layout
\begin_deeper
\begin_layout Itemize
\family sans
Titre
\family default
pour un papier (Paper)
\end_layout
\begin_layout Itemize
\family sans
Review
\begin_inset Note Note
status collapsed
\begin_layout Plain Layout
\family sans
Je ne l'ai pas trouvé (NdT)
\end_layout
\end_inset
\family default
pour une revue (Review)
\end_layout
\begin_layout Itemize
\family sans
Topical
\family default
pour une revue thématique (Topical review)
\end_layout
\begin_layout Itemize
\family sans
Comment
\family default
pour un commentaire (Comment)
\end_layout
\begin_layout Itemize
\family sans
Note
\family default
pour une note
\end_layout
\begin_layout Itemize
\family sans
Paper
\family default
pour un papier ( comme titre)
\end_layout
\begin_layout Itemize
\family sans
Prelim
\family default
pour une communication préliminaire
\end_layout
\begin_layout Itemize
\family sans
Rapid
\family default
pour une communication rapide
\end_layout
\begin_layout Itemize
\family sans
Lettre
\family default
pour une lettre aux éditeurs (Letter)
\end_layout
\end_deeper
\begin_layout Itemize
Tous les environnements de titre, sauf
\family sans
Lettre,
\family default
peuvent avoir un titre court facultatif.
\end_layout
\begin_layout Itemize
Il y a un environnement de titre général
\family sans
Article
\family default
qui n'est pas géré par LyX.
Il peut être utilisé en ERT si votre document ne correspond pas à l'un
des autres types de titres.
\end_layout
\begin_layout Standard
Pour plus d'information comme des astuces pour des mises en formes spéciales
pour les tableaux et les formules, voyez les instructions aux auteurs de
l'IoP.
\end_layout
\begin_layout Section
Kluwer
\end_layout
\begin_layout Standard
par
\noun on
Panayotis Papasotiriou
\end_layout
\begin_layout Subsection
En résumé
\end_layout
\begin_layout Standard
Le paquetage Kluwer est un jeu de macros produit par les éditions Kluwer
Academic Publishers, qui permet de soumettre sous format électronique des
manuscrits destinés à leurs publications.
Les plus connues d'entre elles (au moins dans mon domaine d'intérêt) sont
\emph on
Astrophysics and Space Science
\emph default
et
\emph on
Solar Physics
\emph default
, mais il y en a beaucoup d'autres (voyez la liste complète à l'adresse
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
http://www.wkap.nl/jrnllist.htm/JRNLHOME
\end_layout
\end_inset
).
On peut télécharger le paquetage Kluwer sur le site
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
http://www.wkap.nl/kaphtml.htm/STYLEFILES
\end_layout
\end_inset
.
Ce paquetage contient un guide de l'utilisateur complet (qui peut également
être téléchargé séparément).
\end_layout
\begin_layout Standard
LyX supporte de nombreuses fonctions de ce paquetage mais pas tout.
Cependant, le Texte Rouge nécessaire se résume à quelques commandes
\begin_inset Quotes fld
\end_inset
particulières
\begin_inset Quotes frd
\end_inset
du paquetage (voir
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:particularités_kluwer"
\end_inset
).
J'ai récemment utilisé LyX pour écrire un article soumis à
\emph on
Astrophysics and Space Science
\emph default
sans aucun problème.
\end_layout
\begin_layout Subsection
Écrire un papier
\end_layout
\begin_layout Standard
La façon la plus simple d'écrire un papier est de partir du fichier modèle
Kluwer.
Faites
\family sans
Fichier\SpecialChar \menuseparator
Nouveau
\begin_inset space ~
\end_inset
avec
\begin_inset space ~
\end_inset
Modèle
\family default
, et choisissez
\family typewriter
kluwer.lyx
\family default
.
Ça vous donnera un document (presque) vide qui comprend les champs les
plus couramment utilisés dans un manuscrit avec une courte description
de leur emploi.
Comme dans la plupart des modèles, vous n'avez qu'à remplacer le texte
existant (y compris les crochets,
\family typewriter
<>
\family default
) par l'information correcte.
\end_layout
\begin_layout Subsection
Préparer un papier avant de le soumettre
\end_layout
\begin_layout Standard
Comme pour le paquetage AASTeX, avant de soumettre votre papier à la publication
, vous devez le
\begin_inset Quotes fld
\end_inset
post-traiter
\begin_inset Quotes frd
\end_inset
comme suit.
\end_layout
\begin_layout Enumerate
Exportez votre papier comme fichier LaTeX.
Pour cela, faites
\family sans
\bar under
F
\bar default
ichier\SpecialChar \menuseparator
E
\bar under
x
\bar default
porter\SpecialChar \menuseparator
\bar under
L
\bar default
aTeX
\family default
.
\end_layout
\begin_layout Enumerate
Éditez avec un éditeur de texte le fichier
\family typewriter
.tex
\family default
obtenu, et faites les changements suivants
\end_layout
\begin_deeper
\begin_layout Enumerate
enlevez les lignes de commentaire avant la commande
\family typewriter
\backslash
documentclass
\family default
,
\end_layout
\begin_layout Enumerate
enlevez tout ce qui se trouve entre les commandes
\family typewriter
\backslash
makeatletter
\family default
et
\family typewriter
\backslash
makeatother
\family default
comprises, sauf celles que vous avez explicitement incluses dans le préambule
LaTeX.
\end_layout
\begin_layout Standard
Enregistrez le fichier
\family typewriter
.tex
\family default
obtenu.
\end_layout
\end_deeper
\begin_layout Enumerate
Lancez LaTeX sur ce fichier
\family typewriter
.tex
\family default
autant de fois que nécessaire (d'habitude jusqu'à trois fois).
\end_layout
\begin_layout Enumerate
Visualisez le document
\family typewriter
.dvi
\family default
obtenu avec, par exemple,
\family sans
xdvi
\family default
, et vérifiez si tout va bien (ce qui devrait être le cas si vous n'avez
pas fait d'erreur).
\end_layout
\begin_layout Subsection
\begin_inset Quotes fld
\end_inset
Particularités
\begin_inset Quotes frd
\end_inset
du paquetage Kluwer
\begin_inset CommandInset label
LatexCommand label
name "subsec:particularités_kluwer"
\end_inset
\end_layout
\begin_layout Standard
Le paquetage Kluwer présente les
\begin_inset Quotes fld
\end_inset
particularités
\begin_inset Quotes frd
\end_inset
suivantes.
\end_layout
\begin_layout Enumerate
Il est possible d'écrire plusieurs articles dans le même fichier LaTeX
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Je ne vois aucune bonne raison de le faire.
\end_layout
\end_inset
.
Chaque article doit être compris dans l'environnement
\begin_inset Quotes fld
\end_inset
article
\begin_inset Quotes frd
\end_inset
.
Malheureusement, cet environnement ne peut pas être omis, même si vous
n'écrivez qu'un seul article.
Ainsi, chaque article commence par la commande
\family typewriter
\backslash
begin{article}
\family default
et, bien sûr, se termine par la commande
\family typewriter
\backslash
end{article}
\family default
.
Bien que cela puisse être implémenté dans LyX, je ne l'ai pas fait car
ce n'est pas beau, et peut prêter à confusion pour l'utilisateur novice.
Vous devez donc les entrer directement et les marquer comme code LaTeX
(le fameux
\begin_inset Quotes fld
\end_inset
Texte Rouge
\begin_inset Quotes frd
\end_inset
).
\end_layout
\begin_layout Enumerate
L'information donnée au début de l'article (c'est-à-dire le titre, le sous-titre
, l'auteur, l'institution, le titre courant, l'auteur courant, l'abstract
et les mots-clés) doit être comprise dans un environnement appelé
\begin_inset Quotes fld
\end_inset
opening
\begin_inset Quotes frd
\end_inset
.
Ce n'est pas implémenté dans LyX, vous devez donc entrer le titre, le sous-titr
e, etc.
entre deux lignes de Texte Rouge (
\family typewriter
\backslash
begin{opening}
\family default
et
\family typewriter
\backslash
end{opening}
\family default
).
\end_layout
\begin_layout Enumerate
D'après le manuel utilisateur, l'étiquette de chaque élément de bibliographie
doit être écrite ainsi :
\family typewriter
\backslash
protect
\backslash
citeauthoryear{
\family default
\emph on
auteur(s)
\family typewriter
\emph default
}{
\family default
\emph on
année
\family typewriter
\emph default
}
\family default
.
\end_layout
\begin_layout Standard
Le modèle
\family typewriter
kluwer.lyx
\family default
tient compte de toutes ces
\begin_inset Quotes fld
\end_inset
particularités
\begin_inset Quotes frd
\end_inset
.
Si vous commencez un nouveau papier à partir de ce modèle vous n'aurez
rien besoin de faire de spécial.
Simplement
\end_layout
\begin_layout Enumerate
n'effacez pas le Texte Rouge qui se trouve dans le modèle, et
\end_layout
\begin_layout Enumerate
pour entrer de nouveaux éléments de bibliographie, copiez l'exemple d'élément
fourni et modifiez-le.
\end_layout
\begin_layout Section
Koma-Script
\end_layout
\begin_layout Standard
par
\noun on
Bernd Rellermeyer
\end_layout
\begin_layout Subsection
En résumé
\end_layout
\begin_layout Standard
Les classes de document LyX
\emph on
article (koma-script)
\emph default
,
\emph on
report (koma-script)
\emph default
,
\emph on
book
\emph default
\emph on
(koma-script)
\emph default
, et
\emph on
letter
\emph default
\emph on
(koma-script)
\emph default
correspondent respectivement aux classes LaTeX
\family typewriter
scrartcl.cls
\family default
,
\family typewriter
scrreprt.cls
\family default
,
\family typewriter
scrbook.cls
\family default
et
\family typewriter
scrlettr.cls
\family default
, de la famille Koma-Script.
Elles forment des alternatives aux classes standard, respectivement
\family typewriter
article.cls
\family default
,
\family typewriter
report.cls
\family default
,
\family typewriter
book.cls
\family default
et
\family typewriter
letter.cls
\family default
et sont plus proches des conventions typographiques européennes en un certain
nombre de points :
\end_layout
\begin_layout Itemize
La taille de caractère standard est de 11
\begin_inset space ~
\end_inset
pt dans
\emph on
article (koma-script)
\emph default
,
\emph on
report (koma-script)
\emph default
, et
\emph on
book (koma-script)
\emph default
, et de 12
\begin_inset space ~
\end_inset
pt dans
\emph on
letter (koma-script)
\emph default
.
\end_layout
\begin_layout Itemize
Les en-têtes, les marqueurs de l'environnement
\family sans
Description
\family default
et d'autres éléments de la classe
\emph on
letter (koma-script)
\emph default
sont en police grasse sans empattement
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Il y a une grande différence entre les anciennes polices cm grasses sans
empattement et les nouvelles polices ec, particulièrement pour les en-têtes.
En comparaison, les polices grasses sans empattement ec semblent un peu
plus fines.
Le paquetage LaTeX
\family typewriter
cmsd.sty
\family default
de
\shape smallcaps
Walter Schmidt
\shape default
permet de reproduire l'apparence
\begin_inset Quotes fld
\end_inset
habituelle
\begin_inset Quotes frd
\end_inset
, tout en utilisant les polices ec.
\end_layout
\end_inset
.
La numérotation des en-têtes de chapitre est rendue de la même manière
que celle des en-têtes de section, c'est-à-dire sans la ligne supplémentaire
\begin_inset Quotes fld
\end_inset
Chapitre...
\begin_inset Quotes frd
\end_inset
.
En outre, l'apparence des en-têtes peut être modifiée par un certain nombre
d'options (à entrer dans le champ
\family sans
Options
\family default
de la fenêtre
\family sans
Document\SpecialChar \menuseparator
Paramètres\SpecialChar \menuseparator
Classe
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
document
\family default
).
Une description détaillée de ces options, en allemand, est disponible dans
le
\family typewriter
scrguide
\family default
de la documentation Koma-script
\family sans
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
La version en anglais est le
\family typewriter
scrguien
\family default
.
\end_layout
\end_inset
.
\end_layout
\begin_layout Itemize
La principale méthode utilisée dans les classes de cocuments pour modifier
le type
\begin_inset Note Note
status collapsed
\begin_layout Plain Layout
je n'arrive pas à traduire
\begin_inset Quotes fld
\end_inset
type area options
\begin_inset Quotes frd
\end_inset
\end_layout
\end_inset
sont les options
\family sans
BCOR
\family default
et
\family sans
DIV
\family default
( dans LyX elles doivent être entrées dans le champ d'
\family sans
Options
\family default
du dialogue
\family sans
Document\SpecialChar \menuseparator
Paramètres\SpecialChar \menuseparator
Classe
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
document
\family default
).
Elles permettent une modification plus claire des marges de page que celle
du dialogue
\family sans
Document\SpecialChar \menuseparator
Paramètres.
\family default
Une description détaillée de ces options, en allemand, est disponible dans
le
\family typewriter
scrguide
\family default
de la documentation Koma-script
\family sans
.
\end_layout
\begin_layout Itemize
Les classes de document LaTeX de la famille Koma-Script définissent un certain
nombre de commandes supplémentaires.
Celles d'entre elles qui ont une signification dans LyX sont implémentées
par des types de paragraphes y correspondant.
\end_layout
\begin_layout Standard
Une description détaillée, en allemand, des classes de document LaTeX de
la famille Koma-Script se trouve dans le
\family typewriter
scrguide
\family default
de la documentation Koma-Script
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Il y en a une traduction en anglais, incomplète,
\family typewriter
screnggu
\family default
\begin_inset Note Note
status collapsed
\begin_layout Plain Layout
ou scrguien (NdT) qui ne semble pas si incomplète que ça !
\end_layout
\end_inset
.
\end_layout
\end_inset
.
Les sections qui suivent décrivent seulement les aspects de ces classes
qui ont un sens dans LyX.
\end_layout
\begin_layout Subsection
\family sans
article (koma-script)
\family default
,
\family sans
report (koma-script)
\family default
, et
\family sans
book (koma-script)
\end_layout
\begin_layout Standard
Les classes de document
\emph on
article (koma-script)
\emph default
,
\emph on
report (koma-script)
\emph default
et book
\emph on
(koma-script)
\emph default
sont implémentées respectivement dans les fichiers de format
\family typewriter
scrartcl.layout
\family default
,
\family typewriter
scrreprt.layout
\family default
et
\family typewriter
scrbook.layout
\family default
.
Ils contiennent tous les types de paragraphe correspondant aux classes
standard respectives
\emph on
article
\emph default
,
\emph on
report
\emph default
, et
\emph on
book
\emph default
mais partiellement modifiés, à l'exception du type
\family sans
Liste
\family default
, spécifique à LyX, qui est remplacé par le nouveau type
\family sans
Marquage
\family default
(Labeling) qui a les mêmes fonctions.
En plus du type
\family sans
Marquage
\family default
, il y d'autres nouveaux types de paragraphe.
Ceux-ci cependant
\emph on
n'apparaissent pas
\emph default
dans la classe
\emph on
letter (koma-script)
\emph default
.
\end_layout
\begin_layout Itemize
\family sans
AjoutPartie
\family default
(AddPart),
\family sans
AjoutChap
\family default
(Addchap),
\family sans
AjoutSec
\family default
(Addsec) : sont les équivalents respectifs de
\family sans
Partie*
\family default
,
\family sans
Chapter*
\family default
et
\family sans
Section*
\family default
, ajoutant de plus une entrée dans la table des matières.
\family sans
AjoutPartie
\family default
et
\family sans
AjoutChap
\family default
n'existent pas dans
\emph on
article (koma-script)
\emph default
.
\end_layout
\begin_layout Itemize
\family sans
AjoutChap*
\family default
,
\family sans
AjoutSec*
\family default
: ont le même role que, respectivement
\family sans
AjoutChap
\family default
et
\family sans
AjoutSec
\family default
, mais sans indiquer de numéro de chapitre ou de section.
\family sans
AjoutChap*
\family default
n'est pas disponible dans
\emph on
article (koma-script)
\emph default
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Il y a aussi une commande
\family typewriter
\backslash
addpart*
\family default
dans
\emph on
book (koma-script)
\emph default
et dans
\emph on
report (koma-script)
\emph default
, mais comme elle fait la même chose que
\family sans
Partie*
\family default
, elle n'a pas été implémentée dans LyX.
\end_layout
\end_inset
.
\end_layout
\begin_layout Itemize
\family sans
MiniSec
\family default
: génère un en-tête écrit avec des caractères de taille standard, juste
au-dessus du paragraphe suivant et sans modifier la structure du document.
\end_layout
\begin_layout Itemize
\family sans
Légende_Dessus
\family default
(Captionabove) et
\family sans
Légende_Dessous
\family default
(Captionbelow) : sont des légendes spéciales qui respectent les différents
réglages d'espacement nécessaires pour des légendes placées au-dessus ou
au-dessous d'un élément (si vous suivez strictement les règles typographiques,
vous mettez toujours les légendes au-dessus des tableaux).
Vous pouvez aussi utiliser l'option de classe
\family typewriter
tablecaptionsabove
\family default
, qui transformera
\family sans
Légende
\family default
en
\family sans
Légende_Dessus
\family default
pour les tableaux et en
\family sans
Légende_Dessous
\family default
pour les figures.
Il vous faut au minimum Koma-Script version 2.8q pour avoir cette fonction.
\end_layout
\begin_layout Itemize
\family sans
Maxime
\family default
(Dictum) : sert à mettre une citation ou un proverbe, par exemple au début
d'un chapitre.
Si vous utilisez le paramètre optionnel (
\family sans
Insérer\SpecialChar \menuseparator
Titre
\begin_inset space ~
\end_inset
Court
\family default
), vous pouvez y mettre l'auteur de la maxime.
Maxime et auteur sont séparés par une ligne.
Il vous faut au minimum Koma-Script version 2.8q.
\family sans
Maxime
\family default
n'est pas présent dans
\emph on
article (koma-script)
\emph default
.
\end_layout
\begin_layout Standard
Les types qui sont présentés ci-dessous forment en compagnie des types
\family sans
Titre
\family default
,
\family sans
Auteur
\family default
et
\family sans
Date
\family default
, la zone de titre du document.
Ils doivent être entrés au-dessus du premier paragraphe
\begin_inset Quotes fld
\end_inset
normal
\begin_inset Quotes frd
\end_inset
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Les commandes LaTeX correspondantes doivent apparaître avant la commande
\family typewriter
\backslash
maketitle
\family default
.
\end_layout
\end_inset
.
Lorsqu'un tel type est utilisé plusieurs fois, la dernière instance annule
les précédentes, donc pour chaque type, seule compte la dernière occurrence.
L'ordre des différents types n'a, lui, aucune importance, tout comme celui
des
\family sans
Titre
\family default
,
\family sans
Auteur
\family default
et
\family sans
Date
\family default
.
\end_layout
\begin_layout Itemize
\family sans
Sujet
\family default
(Subject) : introduit au-dessus du titre ordinaire (
\family sans
Titre
\family default
,
\family sans
Auteur
\family default
,
\family sans
Date
\family default
) un paragraphe centré pour indiquer le sujet du document.
\end_layout
\begin_layout Itemize
\family sans
Éditeurs
\family default
(Publishers) : introduit au-dessous du titre ordinaire (
\family sans
Titre
\family default
,
\family sans
Auteur
\family default
,
\family sans
Date
\family default
) un paragraphe centré indiquant le nom de l'éditeur.
\end_layout
\begin_layout Itemize
\family sans
Dédicace
\family default
(Dedication) : dans
\emph on
report (koma-script)
\emph default
et
\emph on
book (koma-script)
\emph default
, dispose un paragraphe centré, sur une page à part après la page de titre,
pour la dédicace.
Dans
\emph on
article (koma-script)
\emph default
, dispose un paragraphe centré, en-dessous du titre normal (
\family sans
Titre
\family default
,
\family sans
Auteur
\family default
,
\family sans
Date
\family default
,
\family sans
Éditeurs
\family default
) pour la dédicace.
\end_layout
\begin_layout Itemize
\family sans
En-tête_Titre
\family default
(Titlehead) : produit un paragraphe aligné à gauche au-dessus du titre
normal (
\family sans
Titre
\family default
,
\family sans
Auteur
\family default
,
\family sans
Date
\family default
,
\family sans
Sujet
\family default
) pour un en-tête de document.
\end_layout
\begin_layout Itemize
\family sans
Verso_Titre_Haut
\family default
(Uppertitleback) : dans un document
\emph on
report (koma-script)
\emph default
imprimé recto-verso, dispose un paragraphe aligné à gauche, en haut du
verso de la page de titre.
N'a aucun effet dans un document imprimé en recto seul ni dans
\emph on
article (koma-script).
\end_layout
\begin_layout Itemize
\family sans
Verso_Titre_Bas
\family default
(Lowertitleback) : dans un document
\emph on
report (koma-script)
\emph default
imprimé recto-verso, dispose un paragraphe aligné à gauche, en bas du verso
de la page de titre.
N'a aucun effet dans un document imprimé en recto seul ni dans
\emph on
article (koma-script).
\end_layout
\begin_layout Itemize
\family sans
Titre_Suppl.
\family default
(Extratitle) : introduit une page
\begin_inset Quotes fld
\end_inset
moche
\begin_inset Quotes frd
\end_inset
qui précède le document réel, comprenant un paragraphe sans formatage spécial.
\end_layout
\begin_layout Standard
Les fichiers de configuration correspondant aux classes
\emph on
article (koma-script)
\emph default
,
\emph on
report (koma-script)
\emph default
, et
\emph on
book (koma-script)
\emph default
comprennent le fichier
\family typewriter
scrmacros.inc
\family default
.
C'est là que vous définirez vos propres types.
Copiez
\family typewriter
scrmacros.inc
\family default
dans votre répertoire personnel de formats, et éditez-le !
\end_layout
\begin_layout Subsection
\family sans
letter (koma-script)
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
begin{sloppypar}
\end_layout
\end_inset
\end_layout
\begin_layout Standard
La classe de document
\emph on
letter (koma-script)
\emph default
est implémentée dans le fichier
\family typewriter
scrlettr.layout
\family default
.
Elle contient tous les paragraphes de la classe standard
\emph on
letter
\emph default
correspondante, partiellement modifiés, à l'exception des types
\family sans
LyX-Code
\family default
,
\family sans
Commentaire
\family default
et
\family sans
Liste
\family default
, spécifiques à LyX et qui sont remplacés par le nouveau type
\family sans
Marquage
\family default
.
En plus par rapport à la classe standard, elle contient les types connus
\family sans
Citation
\family default
,
\family sans
Cite
\family default
, et
\family sans
Vers
\family default
.
En outre, il y a un certain nombre de nouveaux types spécifiques aux lettres.
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
end{sloppypar}
\end_layout
\end_inset
\end_layout
\begin_layout Standard
L'apparence de la lettre produite par cette classe de document peut-être
contrôlée par des commandes LaTeX que vous pouvez insérer dans le préambule
du document
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
On obtient un en-tête
\begin_inset Quotes fld
\end_inset
ordinaire
\begin_inset Quotes frd
\end_inset
, comportant le nom et l'adresse, avec les commandes LaTeX suivantes dans
le préambule :
\end_layout
\begin_layout LyX-Code
\backslash
firsthead{
\backslash
parbox[b]{
\backslash
textwidth}
\end_layout
\begin_layout LyX-Code
{
\backslash
ignorespaces
\backslash
fromname
\backslash
\backslash
\backslash
ignorespaces
\backslash
fromaddress}}
\end_layout
\begin_layout LyX-Code
\backslash
nexthead{
\backslash
parbox[b]{
\backslash
textwidth}
\end_layout
\begin_layout LyX-Code
{
\backslash
ignorespaces
\backslash
fromname
\backslash
hfill
\backslash
ignorespaces
\backslash
pagename
\backslash
\backslash
thepage}}
\end_layout
\end_inset
.
Une description détaillée de ces commandes se trouve en langue allemande
dans la documentation de Koma-Script
\emph on
scrguide
\emph default
.
Grâce à elles, l'auteur de la lettre peut créer son propre format.
\end_layout
\begin_layout Standard
Les types
\family sans
Lettre
\family default
et
\family sans
Ouverture
\family default
définissent le début de la lettre et doivent être présents dans toute lettre.
Pour les identifier dans LyX, les lettres
\emph on
L
\emph default
et
\emph on
O
\emph default
apparaissent dans la marge.
Il est possible d'écrire plusieurs lettres en un seul fichier.
Un type
\family sans
Ouverture
\family default
provoque le passage à une nouvelle lettre au même destinataire, et le type
\family sans
Lettre
\family default
permet de changer de destinataire.
Les types
\family sans
Fermeture
\family default
,
\family sans
PS
\family default
,
\family sans
CC
\family default
et
\family sans
P.J.
\family default
sont des types de paragraphe ordinaires et peuvent aussi être utilisés
plusieurs fois dans une même lettre.
\end_layout
\begin_layout Itemize
\family sans
Lettre
\family default
(Letter) : introduit un paragraphe pour le destinataire et définit implicitemen
t le début d'une lettre.
\end_layout
\begin_layout Itemize
\family sans
Ouverture
\family default
(Opening) : introduit un paragraphe pour la formule de politesse initiale
et produit implicitement une nouvelle lettre.
\end_layout
\begin_layout Itemize
\family sans
Fermeture
\family default
(Closing
\family sans
)
\family default
: introduit un paragraphe pour la formule de politesse finale.
\end_layout
\begin_layout Itemize
\family sans
PS
\family default
: introduit un post-scriptum.
\end_layout
\begin_layout Itemize
\family sans
CC
\family default
: introduit un paragraphe pour les co-destinataires.
\end_layout
\begin_layout Itemize
\family sans
P.J.
\family default
(Encl) : introduit un paragraphe pour les pièces jointes.
\end_layout
\begin_layout Standard
Les types
\family sans
N
\family default
om,
\family sans
Signature
\family default
,
\family sans
Adress
\family default
e,
\family sans
Téléphone
\family default
,
\family sans
Lieu
\family default
,
\family sans
Adresse_Retour
\family default
,
\family sans
Courrier_Spécial
\family default
,
\family sans
Emplacement
\family default
,
\family sans
Titre
\family default
, et
\family sans
Sujet
\family default
sont des types qui présentent une invite et qui servent à entrer des renseignem
ents qui seront utilisés par la classe de document.
Nous les appellerons
\begin_inset Quotes fld
\end_inset
types à invite
\begin_inset Quotes frd
\end_inset
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT : Mais si quelqu'un a une meilleure idée pour traduire
\begin_inset Quotes fld
\end_inset
input type
\begin_inset Quotes frd
\end_inset
, je ne dis pas non.
\end_layout
\end_inset
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
On pourrait considérer que les types
\family sans
Letter
\family default
et
\family sans
Opening
\family default
devraient être des types à invite.
Cependant, à cause de la signification particulière de ces types, je les
ai implémentés comme des types de paragraphe ordinaires marqués d'une lettre
dans la marge.
En plus, cela choquerait mon sens de la symétrie si les types
\family sans
Opening
\family default
et
\family sans
Closing
\family default
avaient une apparence très différente.
\end_layout
\end_inset
.
Ces types doivent être présents avant le type
\family sans
Ouverture
\family default
correspondant.
\end_layout
\begin_layout Standard
Une implémentation de ces types dans une logique WYSIWYG n'aurait pas de
sens, car l'aspect réel de la lettre produite ne dépendra pas seulement
de l'utilisation d'un type donné, mais aussi d'autres facteurs.
Par exemple, dans le comportement par défaut, une signature entrée avec
le type
\family sans
Signature
\family default
n'apparaîtra dans la lettre que si celle-ci contient aussi le type
\family sans
Fermeture
\family default
.
La valeur indiquée pour
\family sans
Téléphone
\family default
n'apparaîtra même pas dans la lettre.
Nous avons déjà signalé plus haut la possibilité de décrire son propre
environnement de lettre.
\end_layout
\begin_layout Standard
Les types à invite peuvent être utilisés comme des paragraphes vides.
Cela a un sens par exemple pour le type
\family sans
Signature
\family default
: si ce type n'est pas présent du tout, c'est par défaut la valeur spécifiée
dans
\family sans
Name
\family default
qui est prise comme signature, tandis que si l'on utilise un paragraphe
\family sans
Signature
\family default
vide, il n'y a réellement pas de signature spécifiée.
\end_layout
\begin_layout Standard
Il est possible en utilisant ces types à invite de créer un patron de lettre
contenant des types pré-remplis avec vos coordonnées personnelles (nom,
adresse, etc.) et des types vides pour d'autres données que vous entrerez.
\end_layout
\begin_layout Itemize
\family sans
Nom
\family default
(Name) : nom de l'expéditeur.
Par défaut, apparaît comme un paragraphe centré, en petites majuscules,
dans l'en-tête de la lettre.
\end_layout
\begin_layout Itemize
\family sans
Signature
\family default
: signature de l'expéditeur.
Par défaut, apparaît en dessous du type
\family sans
Fermeture.
\family default
Si le type
\family sans
Signature
\family default
est absent, c'est la valeur du type
\family sans
Nom
\family default
qui apparaît.
\end_layout
\begin_layout Itemize
\family sans
Adresse
\family default
(Address) : adresse de l'expéditeur.
Par défaut, apparaît dans un paragraphe centré, dans l'en-tête de la lettre,
en dessous du nom de l'expéditeur.
\end_layout
\begin_layout Itemize
\family sans
Téléphone
\family default
(Telephone) : numéro de téléphone de l'expéditeur.
Par défaut, correspond à la variable
\family typewriter
\backslash
telephonenum
\family default
de LaTeX.
\end_layout
\begin_layout Itemize
\family sans
Lieu
\family default
(Place) : lieu d'écriture de la lettre.
\end_layout
\begin_layout Itemize
\family sans
Date
\family default
: date d'écriture de la lettre.
\family sans
Lieu
\family default
et
\family sans
Date
\family default
disposent par défaut le lieu et la date sur une ligne alignée à droite,
en dessous du destinataire.
Si le paragraphe
\family sans
Date
\family default
est vide, ni date, ni lieu n'apparaissent, et ce quelle que soit la valeur
de
\family sans
Lieu
\family default
.
S'il n'y a pas de paragraphe
\family sans
Date
\family default
, la date du jour est utilisée.
\end_layout
\begin_layout Itemize
\family sans
Adresse_Retour
\family default
(Backaddress) : adresse pour le retour du courrier.
Par défaut, apparaît au-dessus du destinataire, en petits caractères sans
empattement.
\end_layout
\begin_layout Itemize
\family sans
Courrier_Spécial
\family default
(Specialmail) : informations spéciales sur le courrier.
Par défaut, apparaît souligné au-dessus du destinataire, en dessous de
l'adresse de retour du courrier.
\end_layout
\begin_layout Itemize
\family sans
Emplacement
\family default
(Location) : informations supplémentaires.
Par défaut, apparaît à droite en dessous du champ du destinataire.
\end_layout
\begin_layout Itemize
\family sans
Titre
\family default
: le titre de la lettre.
par défaut, apparaît en grands caractères gras sans empattement, au-dessus
du sujet.
\end_layout
\begin_layout Itemize
\family sans
Sujet
\family default
: le sujet de la lettre.
Par défaut, apparaît en caractères gras au-dessus du paragraphe
\family sans
Ouverture
\family default
.
\end_layout
\begin_layout Standard
Les types
\family sans
Votre_réf
\family default
,
\family sans
Votre_courrier
\family default
,
\family sans
Notre_réf
\family default
,
\family sans
Client
\family default
et
\family sans
Facture
\family default
génèrent comme dans les lettres commerciales, au-dessus de la ligne de
titre, une ligne qui contient les champs
\begin_inset Quotes fld
\end_inset
Votre réf.
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
Votre courrier du
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
Notre réf.
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
Numéro de Client
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
Numéro de Facture
\begin_inset Quotes frd
\end_inset
et
\begin_inset Quotes fld
\end_inset
Date
\begin_inset Quotes frd
\end_inset
.
Pour le champ
\begin_inset Quotes fld
\end_inset
Date
\begin_inset Quotes frd
\end_inset
, LyX reprend la valeur donnée dans
\family sans
Date
\family default
.
Si l'un quelconque de ces types
\begin_inset Quotes fld
\end_inset
pour lettre commerciale
\begin_inset Quotes frd
\end_inset
est utilisé, la valeur donnée pour
\family sans
Place
\family default
n'apparaîtra pas, seule est définie la variable LaTeX
\family typewriter
\backslash
fromplace
\family default
.
L'affichage normal du lieu et de la date (une ligne alignée à droite sous
le champ du destinataire) est supprimée.
Les types sont implémentés comme des types à invite, avec les invites correspon
dantes, et doivent être utilisés avant le type
\family sans
Ouverture
\family default
correspondant.
\end_layout
\begin_layout Itemize
\family sans
Votre_réf
\family default
(Yourref) : Votre référence
\end_layout
\begin_layout Itemize
\family sans
Votre_courrier
\family default
(Yourmail) : Votre courrier du
\end_layout
\begin_layout Itemize
\family sans
Notre_réf
\family default
(Myref) : Notre référence
\end_layout
\begin_layout Itemize
\family sans
Client
\family default
(Customer) : Numéro de client
\end_layout
\begin_layout Itemize
\family sans
Facture
\family default
(Invoice) : Numéro de facture
\end_layout
\begin_layout Subsection
La nouvelle classe lettre :
\family sans
letter (koma-script v.2)
\end_layout
\begin_layout Standard
par
\noun on
Jürgen Spitzmüller
\end_layout
\begin_layout Standard
\begin_inset VSpace medskip
\end_inset
\end_layout
\begin_layout Standard
Koma-Script version 2.8 a introduit une nouvelle classe de lettres
\family typewriter
scrlttr2
\family default
qui remplace
\family typewriter
scrlettr
\family default
, désormais périmée.
Elle a du côté LaTeX une interface complètement nouvelle et n'est pas
compatible avec l'ancienne classe.
LyX supporte les deux, mais il est recommandé d'utiliser la nouvelle.
\end_layout
\begin_layout Standard
Cette classe recouvre les mêmes fonctionnalités que
\emph on
letter (koma-script)
\emph default
, plus quelques autres.
Les éléments de base sont
\family sans
Adresse
\family default
(adresse du destinataire, comme
\family sans
Lettre
\family default
dans le précédent format),
\family sans
Ouverture
\family default
et
\family sans
Fermeture
\family default
.
\family sans
Adresse_Suivante
\family default
(NextAddress) démarre une nouvelle lettre (vous pouvez donc écrire plusieurs
lettres dans un même document).
Les nouveaux éléments concernent l'expéditeur, ce sont :
\family sans
E-Mail
\family default
,
\family sans
URL
\family default
,
\family sans
Fax
\family default
,
\family sans
Banque
\family default
et la possibilité de mettre un
\family sans
Logo
\family default
(par
\family sans
Insérer\SpecialChar \menuseparator
Graphique
\family default
) dans l'en-tête.
\end_layout
\begin_layout Standard
La plus grande amélioration est la possibilité de configurer la mise en
page de la lettre pour s'adapter à presque tous les besoins, soit dans
le préambule (
\family sans
Document\SpecialChar \menuseparator
Paramètres\SpecialChar \ldots{}
\family default
) soit avec un fichier de style spécial (Option de la Classe Lettre, d'extension
\family typewriter
.lco
\family default
), qui sera lu comme une option de classe
\begin_inset Foot
status open
\begin_layout Plain Layout
Le paquetage KOMA est livré avec quelques fichiers
\family typewriter
.lco
\family default
par défaut.
Il y a par exemple un fichier
\family typewriter
DIN.lco
\family default
qui suit les règles typographiques allemandes, et un
\family typewriter
KOMAold.lco
\family default
qui permet de retrouver la mise en page par défaut de l'ancienne classe
\family typewriter
scrlettr
\family default
.
Vous pouvez charger cette dernière avec l'option de classe
\family typewriter
KOMAold
\family default
, mise dans le champ
\family sans
Options
\family default
dans
\family sans
Document\SpecialChar \menuseparator
Paramètres\SpecialChar \menuseparator
Classe
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
document
\family default
.
\end_layout
\end_inset
.
Jetez donc un œil sur le modèle
\emph on
koma-letter2
\emph default
fourni avec LyX, qui vous donnera des exemples.
Vous trouverez une description détaillée dans la documentation de Koma-Script
(
\emph on
scrguide
\emph default
).
\end_layout
\begin_layout Subsection
Problèmes
\end_layout
\begin_layout Standard
Avec LyX, la visualisation d'un document de classe Koma-Script peut poser
quelques problèmes :
\end_layout
\begin_layout Itemize
Le numéro de chapitre pour un type
\family sans
Chapitre
\family default
apparaît sur une ligne à part, au-dessus de l'en-tête de chapitre, au lieu
d'être sur la même ligne juste avant.
C'est causé par le comportement interne de LyX face au marqueur de type
\family sans
Counter_Chapter
\family default
dans le fichier de format.
\end_layout
\begin_layout Itemize
Les en-têtes des types
\family sans
AjoutChap
\family default
et
\family sans
AjoutSec
\family default
sont uniquement dans la
\begin_inset Quotes fld
\end_inset
vraie
\begin_inset Quotes frd
\end_inset
table des matières LaTeX, et pas dans la table des matières LyX (
\family sans
Document\SpecialChar \menuseparator
Plan
\family default
).
\end_layout
\begin_layout Itemize
Les paragraphes avec la classe de document
\emph on
letter
\emph default
apparaissent séparés par de l'interligne supplémentaire, et non par une
indentation.
C'est le comportement par défaut, qui se passe de commande LaTeX spécifique.
Mais dans la fenêtre
\family sans
Document\SpecialChar \menuseparator
Paramètres
\family default
le bouton à cocher correspondant indique
\family sans
Indentation
\family default
.
Cocher
\family sans
Interligne
\family default
insère toujours des commandes LaTeX supplémentaires dans le document pour
causer cet espacement, ce qui ne serait pas le comportement désiré dans
ce cas.
\end_layout
\begin_layout Section
Latex8 (papiers des conférences de l'IEEE)
\end_layout
\begin_layout Standard
par
\noun on
Allan Rae
\end_layout
\begin_layout Subsection
Introduction
\end_layout
\begin_layout Standard
Comme cette classe est spécifiquement destinée à écrire des soumissions
à des conférences sous l'égide de l'IEEE, je vous recommande vivement de
vous procurer une copie de leur
\begin_inset Quotes fld
\end_inset
Kit de l'Auteur
\begin_inset Quotes frd
\end_inset
.
Le paquetage
\family sans
latex.sty
\family default
et le fichier de style de bibliographie associé sont inclus dans ce kit.
Le
\begin_inset Quotes fld
\end_inset
Kit de l'Auteur
\begin_inset Quotes frd
\end_inset
est en général envoyé par e-mail une fois que votre soumission initiale
a été acceptée.
Il y a dedans beaucoup d'informations utiles, qui expliquent les restrictions
de mise en page et ainsi de suite, et je vais supposer que vous l'avez
lu pour ne pas avoir à tout répéter ici.
\end_layout
\begin_layout Subsection
Pour commencer
\end_layout
\begin_layout Standard
(AR.
plus à l'avenir)
\end_layout
\begin_layout Subsection
Environnements supportés
\end_layout
\begin_layout Itemize
\family sans
Standard
\end_layout
\begin_layout Itemize
\family sans
Titre
\end_layout
\begin_layout Itemize
\family sans
Auteur
\end_layout
\begin_layout Itemize
\family sans
E-mail
\end_layout
\begin_layout Itemize
\family sans
Affiliation
\end_layout
\begin_layout Itemize
\family sans
Abstract
\end_layout
\begin_layout Itemize
\family sans
Section
\end_layout
\begin_layout Itemize
\family sans
SousSection
\end_layout
\begin_layout Itemize
\family sans
Légende
\end_layout
\begin_layout Subsection
Différences entre écran et impression
\end_layout
\begin_layout Standard
Il y a quelques légères différences d'apparence principalement pour la présentat
ion des compteurs de section.
À l'écran le point final du compteur de section est absent mais il apparaîtra
à l'impression : ne vous affolez donc pas.
\end_layout
\begin_layout Section
Article (mwart), book (mwbk) and report (mwrep)
\begin_inset Argument
status collapsed
\begin_layout Plain Layout
Les classes
\family sans
mw
\end_layout
\end_inset
\end_layout
\begin_layout Standard
par
\noun on
Tomasz Luczak
\end_layout
\begin_layout Standard
Les classes de document LyX
\emph on
article (mwart)
\emph default
,
\emph on
report (mwrep)
\emph default
et
\emph on
book (mwbk)
\emph default
correspondent aux classes de document LaTeX
\family typewriter
mwart.cls
\family default
,
\family typewriter
mwrep.cls
\family default
et
\family typewriter
mwbk.cls
\family default
respectivement.
Elles remplacent les classes de document standard
\family typewriter
article.cls
\family default
,
\family typewriter
report.cls
\family default
et
\family typewriter
book.cls
\family default
et sont mieux adaptées en bien des aspects aux conventions typographiques
polonaises.
\end_layout
\begin_layout Standard
Les différences principales sont :
\end_layout
\begin_layout Itemize
Les titres non numérotés (avec une étoile, comme
\family sans
Section*
\family default
) sont présents dans la table des matières.
\end_layout
\begin_layout Itemize
Des styles de mise en page supplémentaires :
\end_layout
\begin_deeper
\begin_layout Description
uheadings en-têtes sur plusieurs lignes,
\end_layout
\begin_layout Description
myheadings en-têtes personnalisés, définis par les commandes
\family typewriter
\backslash
markright
\family default
et
\family typewriter
\backslash
markboth
\family default
,
\end_layout
\begin_layout Description
myuheadings en-têtes personnalisés sur plusieurs lignes
\end_layout
\begin_layout Description
outer le numéro de page est placé du côté extérieur de la page
\end_layout
\end_deeper
\begin_layout Itemize
Options
\end_layout
\begin_deeper
\begin_layout Description
rmheadings titres avec empattement par défaut,
\end_layout
\begin_layout Description
sfheadings titres sans empattement,
\end_layout
\begin_layout Description
authortitle sur la page de titre, d'abord l'auteur puis le titre par défaut,
\end_layout
\begin_layout Description
titleauthor sur la page de titre, d'abord le titre puis l'auteur,
\end_layout
\begin_layout Description
withmarginpar réserver de la place sur la page pour les marges.
\end_layout
\end_deeper
\begin_layout Section
Memoir
\end_layout
\begin_layout Standard
Par
\noun on
Jürgen
\noun default
\noun on
Spitzmüller
\end_layout
\begin_layout Subsection
Introduction
\end_layout
\begin_layout Standard
\family sans
Memoir
\family default
est une classe très puissante et en constante évolution.
Elle a été conçue pour la littérature de fiction comme de non-fiction.
Son but est de donner à l'utilisateur le maximum de contrôle sur la mise
en forme de son document.
\family sans
Memoir
\family default
est basée sur la classe standard
\family sans
book
\family default
, mais elle peut aussi émuler la classe
\family sans
article
\family default
(voir plus loin).
\end_layout
\begin_layout Standard
\noun on
Peter Wilson
\noun default
, le développeur de
\family sans
Memoir
\family default
est connu comme l'auteur de nombreux et utiles paquetages dans le monde
LaTeX .
La plupart ont été rassemblés avec
\family sans
Memoir
\family default
.
Il est donc beaucoup plus facile de mettre en forme la table des matières,
les appendices, les chapitres et autres.
LyX, ne gère pas de façon native la plupart de ces fonctionnalités.
Quelque-unes pourront être ajoutées dans de prochaines versions
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Vous êtes invités à faire des suggestions à
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
lyx-devel@lists.lyx.org
\end_layout
\end_inset
.
\end_layout
\end_inset
, beaucoup ne le seront probablement jamais, à cause des limitations de
la structure de LyX.
Bien sûr, vous pouvez quand même utiliser toutes les fonctions avec l'aide
de quelques commandes LaTeX ( en ERT
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Voir la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:Insérer-du-code-LaTeX"
\end_inset
pour plus de détails.
\end_layout
\end_inset
).
Dans cette section, nous ne listerons que les fonctions qui sont gérées
par LyX de façon native.
Pour une description détaillée (et pour le reste des fonctions) nous recommendo
ns de jetter un œil au manuel détaillé de la classe
\family sans
Memoir
\family default
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Voir
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
CTAN:/macros/latex/memoir/memman.pdf
\end_layout
\end_inset
.
\end_layout
\end_inset
, qui est non seulement un manuel de l'utilisateur de la classe, mais aussi
à la fois une description complète de la bonne manière de typographier
et un superbe exemple de bonne typographie en lui-même.
\end_layout
\begin_layout Subsection
Fonctions de base et restrictions
\end_layout
\begin_layout Standard
À la base,
\family sans
Memoir
\family default
accepte toutes les fonctions de la classe standard
\family sans
book
\family default
.
Il y a pourtant quelques différences, comme celles qui suivent :
\end_layout
\begin_layout Description
Taille
\begin_inset space ~
\end_inset
des
\begin_inset space ~
\end_inset
polices
\begin_inset space ~
\end_inset
: Memoir a une gamme plus large de taille de polices : 9, 10, 11, 12, 14,
17
\end_layout
\begin_layout Description
Style
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
page
\begin_inset space ~
\end_inset
: Le style de page
\begin_inset Quotes fld
\end_inset
fancy
\begin_inset Quotes frd
\end_inset
n'est pas géré, à cause d'un conflit de commandes entre
\family sans
Memoir
\family default
et le paquetage
\family sans
fancyhdr
\family default
(ils définissent tous les deux une commande avec le même nom, ce qui perturbe
LaTeX).
À la place, Memoir est fourni avec un paquet de ses propres styles de pages
(voir
\family sans
Document\SpecialChar \menuseparator
Paramètres\SpecialChar \menuseparator
Format
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
la
\begin_inset space ~
\end_inset
page
\family default
).
Si vous voulez les utiliser pour les pages de chapitre, vous devez utiiser
la commande
\family typewriter
\backslash
chapterstyle
\family default
dans le corps du texte ou dans le préambule (par exemple
\family typewriter
\backslash
chapterstyle{companion}
\family default
).
\end_layout
\begin_layout Description
Sectionnement
\begin_inset space ~
\end_inset
: Les sections (chapitres, sections, sous-sections etc.) ont un paramètre
facultatif dans les classes standard.
Avec ce dernier, vous pouvez donner une version alternative du titre pour
la table des matière et les entêtes (par exemple, quand le titre est trop
long).
Dans LyX, vous pouvez le faire avec
\family sans
Insérer\SpecialChar \menuseparator
Titre
\begin_inset space ~
\end_inset
court
\family default
au début de la section/chapitre.
\family sans
Memoir
\family default
a un deuxième paramètre facultatif qui permet de séparer la table des matières
et les entêtes.
Vous pouvez donc définir trois variantes d'un titre : un pour le corps
du texte, un pour la table des matières et un pour les entêtes.
Insérez simplement deux paramètres facultatifs si vous avez besoin de cette
fonction, le premier contient le titre court destiné à la table des matière,
le second un autre titre court destiné aux entêtes.
\end_layout
\begin_layout Description
TdM/LdT/LdF
\begin_inset space ~
\end_inset
: Dans les classes standard (et dans beaucoup d'autres classes), la table
des matières, la liste des tableaux et la liste des figures commencent
automatiquement une novelle page.
\family sans
Memoir
\family default
ne suit pas cette règle.
Vous devez insérer un saut de page vous-même, si vous en voulez un.
\end_layout
\begin_layout Description
Page
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
titre
\begin_inset space ~
\end_inset
: Pour quelque raison inconnue, Memoir utilise une pagination sur la page
de titre (dans les classes standard, les pages de titres sont
\begin_inset Quotes fld
\end_inset
vides
\begin_inset Quotes frd
\end_inset
, c'est-à-dire sans numérotation).
Si vous voulez une page de titre vide, tapez
\family typewriter
\backslash
aliaspagestyle{title}{empty}
\family default
dans le préambule.
\end_layout
\begin_layout Description
Article
\begin_inset space ~
\end_inset
: Avec l'option de classe
\emph on
article
\emph default
(à ajouter dans
\family sans
Document\SpecialChar \menuseparator
Paramètres\SpecialChar \menuseparator
Classe
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
document
\family default
dans les
\family sans
options
\family default
), vous pouvez imiter le style
\family sans
article
\family default
.
C'est-à-dire que les compteurs (notes de bas de page, figures, tableaux
etc.) ne seront pas réinitialisés à chaque nouveau chapitre, les chapitres
ne commenceront pas sur une nouvelle page (maiscontrairement à la
\begin_inset Quotes fld
\end_inset
vraie
\begin_inset Quotes frd
\end_inset
classe
\family sans
article
\family default
—ils sont encore autorisés), les parties cependant utilisent leur propre
page comme dans
\family sans
book
\family default
.
\end_layout
\begin_layout Description
Anciennes
\begin_inset space ~
\end_inset
commandes
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
polices
\begin_inset space ~
\end_inset
: Par défaut, Memoir n'autorise pas l'utilisation des commandes de changement
de police supprimées, qui étaient utilisée par l'ancienne version LaTeX
2.09 (par exemple
\family typewriter
\backslash
rm,
\backslash
it
\family default
).
Il produit une erreur et arrête LaTeX dès qu'une commande de ce genre apparaît.
L'option de classe
\emph on
oldfontcommands
\emph default
autorise de nouveau ces commandes et set contente d'émettre un avertissement
(qui au moins ne stoppe pas LaTeX).
Puisque beaucoup de paquetages LaTeX et en particulier les fichiers de
style BibTeX utilisent encore ces commandes, nous avous décidé d'utiliser
cette option par défaut.
\end_layout
\begin_layout Subsection
Fonctions supplémentaires
\end_layout
\begin_layout Standard
Nous n'allons décrire que les fonctions qui sont gérées par LyX (ce qui
ne fait pas beaucoup pour l'instant).
veuillez consulter le manuel de
\family sans
Memoir
\family default
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Voir
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
CTAN:/macros/latex/memoir/memman.pdf
\end_layout
\end_inset
.
\end_layout
\end_inset
pour plus de détails.
\end_layout
\begin_layout Description
Abstract
\begin_inset space ~
\end_inset
: Vous pouvez vous demander pourquoi un abstract est une fonctionnalité
supplémentaire.
Hé bien, c'est une classe book.
En principe, les classes book n'ont pas d'abstract.
Memoir, lui, en a une.
Vous pouvez l'utiliser quand vous le voulez et autant des fois que vous
le voulez.
\end_layout
\begin_layout Description
Chapterprecis
\begin_inset space ~
\end_inset
: Vous avez peut-être déja vu cela dans la littérature : Le contenu d'un
chapitre est brièvement décrit sous le titre et aussi dans la table des
matières (par exemple :
\emph on
Notre héros arrive à Troie ; il perd quelques amis ; il s'en fait des nouveaux
\emph default
).
Chapterprecis fait exactement cela.
Cela n'a donc de sens qu'après un début de chapitre.
\end_layout
\begin_layout Description
Epigraph
\begin_inset space ~
\end_inset
: Une épigraphe est un joli slogan ou une devise placée au début d'un chapitre.
L'environnement epigraph fournit un moyen élégant de mettre en forme une
telle devise.
Le texte de la devise (texte) et son auteur (source) sont séparés par une
petite ligne.
Malheureusement, nous devons tromper LyX encore un peu, puisque cet environneme
nt a besoin de deux paramètres (le texte et la source).
Dans ce cas nous devons utiliser des accolades (en mode TeX) entre les
deux paramètres :
\family typewriter
<joli slogan> }{ <auteur du slogan>
\family default
.
\end_layout
\begin_layout Description
Poemtitle
\begin_inset space ~
\end_inset
: Memoir offre de nombreuses possibilités pour mettre en forme de la poésie
(jusqu'à de très complexes poèmes figuratifs).
LyX n'en gère que quelques-uns.
L'un d'eux est
\family sans
poemtitle
\family default
, qui est un titre centré pour les poèmes, qui sera aussi ajouté à la table
des matières (l'environnement standard pour les poèmes est
\family sans
vers
\family default
.
\family sans
Memoir
\family default
a plusieurs versions améliorées de
\family sans
vers
\family default
, mais vous aurez besoin d'utiliser des ERT, puisqu'ils doivent être emboîtés
à l'intérieur d'environnements
\family sans
vers
\family default
ordinaires, ce qui n'est pas possible avec LyX).
\end_layout
\begin_layout Description
Poemtitle*
\begin_inset space ~
\end_inset
: Comme
\family sans
poemtitle
\family default
, mais il n'ajoute pas une entrée à la table des matières.
\end_layout
\begin_layout Section
Papier
\end_layout
\begin_layout Standard
La classe de document
\family sans
paper
\family default
(publication,
\begin_inset Quotes fld
\end_inset
papier
\begin_inset Quotes frd
\end_inset
) offre une alternative à la classe standard
\family sans
article
\family default
.
Elle a les mêmes fonctionalités, mais vous pouvez préférer ce format, avec
des sections et en-têtes en police sans empattement, ainsi que d'autres
particularités.
\end_layout
\begin_layout Section
Publications Springer sur deux colonnes (
\family sans
svjour
\family default
)
\end_layout
\begin_layout Standard
par
\noun on
Martin Vermeer
\end_layout
\begin_layout Subsection
Description
\end_layout
\begin_layout Standard
Ce sont les fichiers de format pour certains types de journaux édités par
Springer Verlag et dont la liste apparaît à
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
http://www.springer.de/author/tex/help-journals.html
\end_layout
\end_inset
, où vous devrez aussi aller récupérer les fichiers de classe (eh oui, c'est
maintenant du LaTeX2e !).
C'est un système modulaire : ce qui est commun à tous les journaux est
implémenté dans
\family typewriter
svjour.inc
\family default
, et les fichiers de format particuliers à un journal (comme, par exemple,
\family typewriter
svjog.layout
\family default
pour le
\emph on
Journal of Geodesy
\emph default
) peuvent l'inclure.
\end_layout
\begin_layout Standard
Ça veut dire qu'ajouter le support de n'importe quel autre journal Springer
présent dans cette liste n'est rien d'autre qu'écrire votre propre fichier
\family typewriter
sv<
\family default
mon_journal
\family typewriter
>.layout
\family default
en suivant le schéma donné dans
\family typewriter
svjog.layout
\family default
.
\end_layout
\begin_layout Standard
Ce n'a raisonnablement bien été testé que pour le
\emph on
Journal of Geodesy
\emph default
.
\family typewriter
svjour
\family default
et
\family typewriter
svjog
\family default
sont fournis avec la distribution standard de LyX.
Installez le fichier de classe correspondant (téléchargé chez Springer)
dans un répertoire approprié, reconfigurez LaTeX (en lançant
\family typewriter
texhash
\family default
dans le cas de teTeX, en tant que super-utilisateur si nécessaire LyX
ne s'occupe-t-il pas tout seul de ça ?), reconfigurez LyX et ça devrait
marcher.
\end_layout
\begin_layout Subsection
Nouveaux styles
\end_layout
\begin_layout Standard
Un grand nombre de styles de type théorème
\family sans
Affirmation
\family default
,
\family sans
Conjecture
\family default
, \SpecialChar \ldots{}
\family sans
Théorème
\family default
.
\end_layout
\begin_layout Standard
\family sans
Note_En_Tête
\family default
(Headnote
\family sans
)
\family default
,
\family sans
Dédicace
\family default
(Dedication),
\family sans
SousTitre
\family default
(Subtitle
\family sans
)
\family default
,
\family sans
Titre_LaTeX_Courant
\family default
(Running_LaTeX_Title
\family sans
)
\family default
,
\family sans
Auteur_Courant
\family default
(Author_Running),
\family sans
Institut
\family default
(Institute),
\family sans
Mail
\family default
,
\family sans
Tirés_À_Part
\family default
(Tiré à parts),
\family sans
Mots-Clés
\family default
(Keywords),
\family sans
Remerciements
\family default
(Acknowledgements),
\family sans
Remerciement
\family default
(Acknowledgement).
Voir la documentation du fichier de classe de Springer pour les détails.
\end_layout
\begin_layout Subsection
Publications supportées
\end_layout
\begin_layout Itemize
\emph on
Journal of Geodesy
\emph default
:
\family typewriter
svjog.layout
\family default
\noun on
Martin Vermeer
\end_layout
\begin_layout Itemize
\emph on
Probability Theory and Related Fields
\emph default
:
\family typewriter
svprobth.layout
\family default
\noun on
Jean-Marc Lasgouttes
\end_layout
\begin_layout Standard
Ajoutez le vôtre, ce n'est pas si dur !
\end_layout
\begin_layout Subsection
Crédits
\end_layout
\begin_layout Standard
Ces fichiers sont partiellement basés sur l'ancien
\family typewriter
ejour2.layout
\family default
, qui était lui-même basé sur une version bricolée d'un vieux fichier de
style LaTeX 2.09 de Springer.
Tout ceci, ainsi que le format
\family typewriter
ejour2
\family default
, est maintenant dépassé.
Jean-Marc Lasgouttes a été d'un grand secours pour me guider dans le mécanisme
des fichiers de format LyX.
\end_layout
\begin_layout Subsection
Bogues
\end_layout
\begin_layout Standard
Sans doute.
Mais probablement moins que dans l'ancien
\family typewriter
ejour2
\family default
bricolé.
\end_layout
\begin_layout Standard
Limitations : par exemple, n'affiche pas le numéro pour les formats de type
théorème, seulement #.
\end_layout
\begin_layout Section
Publications de l'AGU (
\family sans
aguplus
\family default
)
\end_layout
\begin_layout Standard
par
\shape smallcaps
Martin Vermeer
\end_layout
\begin_layout Subsection
Description
\end_layout
\begin_layout Standard
Ce sont les fichiers de format correspondant à certaines publications de
l'American Geophysical Society.
Nous supposons que vous avez déjà installé les fichiers de classe propres
à l'AGU, ainsi qu'AGUplus (tout ceci se trouve à
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
ftp://ftp.agu.org/journals/latex/journals
\end_layout
\end_inset
).
\end_layout
\begin_layout Subsection
Nouveaux environnements
\end_layout
\begin_layout Standard
\family sans
Paragraphe
\family default
et
\family sans
Paragraphe*
\family default
sont redéfinis.
Ils portent toujours ce nom dans l'interface LyX, bien que leurs équivalents
LaTeX dans les classes AGU soient
\family sans
Subsubsubsection
\family default
et
\family sans
Subsubsubsection*
\family default
.
\end_layout
\begin_layout Standard
Les environnements nouvellement définis sont
\family sans
En-tête_Gauche
\family default
(Left_Header
\family sans
)
\family default
,
\family sans
En-tête_Droite
\family default
(Right_Header
\family sans
)
\family default
,
\family sans
Reçu
\family default
(Received
\family sans
)
\family default
,
\family sans
Révisé
\family default
(Revised
\family sans
)
\family default
,
\family sans
Accepté
\family default
(Accepted
\family sans
)
\family default
,
\family sans
CCC
\family default
,
\family sans
Id_Papier
\family default
(PaperId
\family sans
)
\family default
,
\family sans
Adresse_Auteur
\family default
(AuthorAddr) et
\family sans
SlugComment
\family default
.
Ce sont pour la plupart des paramètres du manuscrit qui sont expliqués
dans la documentation des classes AGU.
\end_layout
\begin_layout Standard
Je soupçonne que tout ceci soit encore relativement incomplet.
\end_layout
\begin_layout Subsection
Nouveaux flottants
\end_layout
\begin_layout Standard
\family sans
Planotable
\family default
et
\family sans
Planche
\family default
(Plate).
Nous avons également une nouvelle
\family sans
Légende_Table
\family default
(Table_Caption).
\end_layout
\begin_layout Subsection
Publications supportées
\end_layout
\begin_layout Itemize
\emph on
Journal of Geophysical Research
\emph default
:
\family typewriter
jgrga.layout
\family default
Martin Vermeer
\end_layout
\begin_layout Standard
Ajoutez les vôtres, ce n'est pas si dur ! Regardez l'exemple
\family typewriter
jgrga.layout
\family default
ainsi que
\family typewriter
aguplus.inc
\family default
.
\end_layout
\begin_layout Subsection
Bogues et choses à retenir
\end_layout
\begin_layout Standard
Pour utiliser les nouveaux environnements, vous devez faire ce qui suit
à chaque nouveau document :
\end_layout
\begin_layout Enumerate
\emph on
(Dés)Activer babel
\emph default
, ce que vous ferez dans
\family sans
Document\SpecialChar \menuseparator
Paramètres
\family default
.
(Les articles AGU sont écrits en anglais de toutes façons, il ne faut donc
\emph on
pas
\emph default
choisir de langue.)
\end_layout
\begin_layout Enumerate
Tapez
\family typewriter
jgrga
\family default
dans le champ
\family sans
Options
\family default
de la classe de document.
(C'est effectivement un bogue.)
\end_layout
\begin_layout Enumerate
Assurez-vous que vous utilisez le style de bibliographie
\family typewriter
agu.bst
\family default
, en tapant
\family sans
agu
\family default
dans le deuxième champ de l'insert BibTeX.
Aucun des styles standard ne conviendra.
\end_layout
\begin_layout Section
Publications de l'EGS (
\family sans
egs
\family default
)
\end_layout
\begin_layout Standard
par
\shape smallcaps
Martin Vermeer
\end_layout
\begin_layout Subsection
Description
\end_layout
\begin_layout Standard
C'est le fichier de format pour les publications de l'EGS (
\emph on
European Geophysical Society
\emph default
).
Vous pouvez télécharger la classe
\family typewriter
egs.cls
\family default
(nécessaire) depuis le site de l'EGS à
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
www.copernicus.org
\end_layout
\end_inset
.
\end_layout
\begin_layout Subsection
Nouveaux environnements
\end_layout
\begin_layout Standard
\family sans
Adresse_À_Droite
\family default
(Right_address)
\family sans
, Titre_Latex
\family default
(Latex_Title)
\family sans
, Affil., Journal, numéro_ms
\family default
(msnumber)
\family sans
, PremierAuteur
\family default
(FirstAuthor)
\family sans
, Reçu
\family default
(Received)
\family sans
, Accepté
\family default
(Accepted) et
\family sans
Offsets
\family default
.
L'actuel fichier de format est malheureusement très peu modulaire et devrait
plus utiliser les inclusions
\family typewriter
std*.inc
\family default
.
\end_layout
\begin_layout Section
RevTeX4
\end_layout
\begin_layout Standard
par
\noun on
Amir Karger
\end_layout
\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset
\end_layout
\begin_layout Standard
\noindent
La classe de texte
\family sans
Revtex
\begin_inset space ~
\end_inset
4
\family default
marche avec la classe RevTeX 4.0 (version
\begin_inset Formula $\beta$
\end_inset
de mai 1999) de l'American Physical Society.
\end_layout
\begin_layout Standard
LyX a une classe de texte
\family sans
Revtex
\family default
, qui marche avec RevTeX 3.1.
Cependant, la version 3.1 est périmée, car elle fonctionne avec LaTeX 2.09.
Ce qui signifie qu'elle n'interagit pas très bien avec LyX, qui a besoin
de LaTeX2e, même si on l'a trafiqué pour qu'elle marche.
Comme RevTeX 4.0 a été étudiée pour marcher beaucoup mieux avec LaTeX2e,
LyX avec la classe de texte
\family sans
Revtex
\begin_inset space ~
\end_inset
4
\family default
devrait être assez facile à utiliser.
\end_layout
\begin_layout Standard
Cette documentation est censée servir en
\emph on
plus
\emph default
de la documentation de RevTeX 4.0, nous ne décrirons donc aucune des macros
spéciales RevTeX, et supposerons que vous savez ce qu'il faut mettre dans
le préambule si besoin.
\end_layout
\begin_layout Subsection
Installation
\end_layout
\begin_layout Standard
Tout ce que vous avez à faire est d'installer RevTeX 4, comme c'est décrit
dans le fichier README du paquetage.
Le paquetage est disponible sur le site de RevTeX 4
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
http://publish.aps.org/revtex4/
\end_layout
\end_inset
.
Installez-le quelque part où LaTeX puisse le voir.
Testez-le en essayant de LaTeXer un court document RevTeX 4 dans un répertoire
au hasard (c'est-à-dire pas dans celui où vous avez installé le fichier
de classe).
Ensuite, si vous reconfigurez LyX, il trouvera le fichier de classe et
vous laissera utiliser la classe de texte
\family sans
Revtex4
\family default
.
\end_layout
\begin_layout Standard
Probablement la façon la plus simple de démarrer est soit d'importer un
document RevTeX 4 avec
\family typewriter
tex2lyx
\family default
, soit d'utiliser le modèle
\family sans
Revtex
\begin_inset space ~
\end_inset
4
\family default
, qui se trouve dans le répertoire de modèles.
\end_layout
\begin_layout Subsection
Dans le préambule
\end_layout
\begin_layout Standard
Les paramètres optionnels de
\family typewriter
\backslash
documentclass
\family default
, comme
\begin_inset Quotes fld
\end_inset
preprint
\begin_inset Quotes frd
\end_inset
et
\begin_inset Quotes fld
\end_inset
aps
\begin_inset Quotes frd
\end_inset
, vont dans le champ d'
\family sans
Options
\family default
de la fenêtre
\family sans
Document\SpecialChar \menuseparator
Paramètres
\family default
\SpecialChar \menuseparator
\family sans
Classe
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
document
\family default
, comme d'habitude.
Rappelez-vous que dans RevTeX, il faut au moins un paramètre optionnel
!
\end_layout
\begin_layout Standard
Le reste de ce qui va dans le préambule, comme
\family typewriter
\backslash
draft
\family default
etc., va comme d'habitude dans la fenêtre
\family sans
Préambule
\family default
\begin_inset space ~
\end_inset
\family sans
LaTeX
\family default
.
\end_layout
\begin_layout Subsection
Champs
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT : Dans la section sur RevTeX, j'ai traduit
\begin_inset Quotes fld
\end_inset
layout
\begin_inset Quotes frd
\end_inset
par
\begin_inset Quotes fld
\end_inset
champ
\begin_inset Quotes frd
\end_inset
à de nombreux endroits.
Ce que l'auteur indiquait était peut-être un environnement, mais ressemble
de toute façon à un champ à remplir.
N'ayant pas RevTeX, je ne peux pas aller vérifier.
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Les champs correspondent basiquement aux commandes dans RevTeX 4.0.
Par exemple, le champ
\family sans
Email
\family default
correspond à
\family typewriter
\backslash
email{}
\family default
.
Notez que (au moins pour RevTeX 4.0 Beta), les champs
\family sans
Adresse
\family default
et
\family sans
Affiliation
\family default
sont exactement équivalents, vous n'avez donc pas besoin d'utiliser les
deux
\begin_inset Foot
status open
\begin_layout Plain Layout
Au cas où ça vous intéresse, les deux sont inclus pour que
\family typewriter
tex2lyx
\family default
puisse traduire à la fois
\family typewriter
\backslash
address
\family default
et
\family typewriter
\backslash
affiliation
\family default
.
\end_layout
\end_inset
.
\end_layout
\begin_layout Subsection
Notes importantes
\end_layout
\begin_layout Standard
Il y a un ou deux aspects spécifiques de RevTeX 4 qui peuvent causer des
erreurs qui sont encore plus troublantes dans LyX.
\end_layout
\begin_layout Standard
Dans RevTeX, la commande
\family typewriter
\backslash
thanks
\family default
va
\emph on
en dehors
\emph default
de la commande
\family typewriter
\backslash
author
\family default
.
L'équivalent LyX en est qu'il y a un champ
\family sans
Remerciements
\family default
séparé.
N'écrivez
\emph on
pas
\emph default
de notes de bas de page dans le champ
\family sans
Auteur
\family default
, ou des choses étranges apparaîtront.
Voyez la documentation de RevTeX 4 pour plus de détails.
\end_layout
\begin_layout Standard
Également, les champs
\family sans
Email_Auteur
\family default
(Author_Email
\family sans
)
\family default
,
\family sans
URL_Auteur
\family default
(Author
\begin_inset space ~
\end_inset
URL) et
\family sans
Remerciements
\family default
(Thanks) doivent être placés
\emph on
entre
\emph default
le champ
\family sans
Auteur
\family default
et le champ
\family sans
Adresse
\family default
correspondant (ou son équivalent
\family sans
Affiliation
\family default
).
Si vous mettez les
\family sans
Remerciements
\family default
après l'
\family sans
Adresse
\family default
, la compilation LaTeX échouera.
\end_layout
\begin_layout Subsection
Inconvénients
\end_layout
\begin_layout Standard
Le principal problème avec ce format est que vous ne pouvez pas utiliser
les paramètres optionnels de certains champs comme
\family sans
Email
\family default
et
\family sans
Titre
\family default
.
(Ce problème n'est pas particulier à ce format ; vous ne pouvez pas non
plus utiliser les paramètres optionnels des environnements
\family sans
Section
\family default
.) Ça signifie qu'après avoir exporté le fichier en LaTeX (ce que vous devrez
faire de toutes façons pour l'envoyer à l'APS), vous aurez à éditer le
fichier LaTeX avec un éditeur de texte et ajouter les paramètres optionnels
qui restent à spécifier, par exemple le titre en cours pour les en-têtes
de page.
Faute de cette possibilité, les commandes
\family typewriter
\backslash
altaffiliation
\family default
(et l'équivalent
\family typewriter
\backslash
altaddress
\family default
) sont inutiles, donc les champs correspondants n'existent pas, et ces commandes
devront être ajoutées à la main
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\emph on
Note de Jean-Marc :
\emph default
en fait, LyX 1.3.0 gère certains types de paramètres optionnels, mais ce
format n'a pas encore été mis à jour.
\end_layout
\end_inset
.
\end_layout
\begin_layout Chapter
LyX et applications externes
\end_layout
\begin_layout Section
Correcteur TeX
\end_layout
\begin_layout Standard
par
\noun on
Asger Alstrup
\end_layout
\begin_layout Subsection
Introduction
\end_layout
\begin_layout Standard
Vous trouverez dans le menu
\family sans
Outils
\family default
la commande
\family sans
Correction
\begin_inset space ~
\end_inset
TeX
\family default
.
Cette fonctionnalité requière le programme
\family typewriter
chktex
\family default
\lang english
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\family typewriter
chktex
\family default
n'est pas encore disponible avec la distribution MiKTeX
\lang english
.
\end_layout
\end_inset
\lang french
et la commande est donc grisée si celui-ci n'est pas installé.
Vous pouvez vous le procurer de CTAN,
\begin_inset CommandInset href
LatexCommand href
target "http://www.ctan.org/tex-archive/help/Catalogue/entries/chktex.html"
\end_inset
.
\end_layout
\begin_layout Standard
Le paquetage
\family sans
ChkTeX
\family default
est un programme qui a été écrit par
\noun on
Jens T.
Berger Thielemann
\noun default
qui se plaignait que certaines commandes de LaTeX n'étaient pas naturelles
et s'oubliaient facilement.
Ce programme parcourt votre fichier LaTeX et en vérifie la bonne écriture.
C'est donc l'équivalent de
\family typewriter
Lint
\family default
\noun toggle
, mais pour LaTeX.
\end_layout
\begin_layout Standard
La question est donc : mais que vient faire ce logiciel sous LyX alors que
LyX est déjà censé produire du LaTeX exempt de fautes ? La réponse est
simple : tout comme
\family typewriter
Lint
\family default
ne vérifie pas seulement la
\emph on
syntaxe
\emph default
\emph toggle
d'un fichier C, mais aussi la bonne utilisation des types,
\emph default
\family sans
\emph toggle
ChkTeX
\family default
\emph default
\emph toggle
détecte en plus des erreurs syntaxiques quelques erreurs typographiques.
Entre autres,
\emph default
\family sans
\emph toggle
ChkTeX
\family default
\emph default
\emph toggle
est à même de détecter des erreurs courantes comme
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT : Certaines de ces règles me sont totalement inconnues.
Il est possible qu'elles ne s'appliquent pas à la langue française.
\emph on
of
\end_layout
\end_inset
:
\end_layout
\begin_layout Itemize
De mauvais points de suspension :
\begin_inset Newline newline
\end_inset
Utiliser \SpecialChar \ldots{}
et non pas ...
\end_layout
\begin_layout Itemize
Des espaces à l'intérieur des parenthèses :
\begin_inset Newline newline
\end_inset
( mauvais espacement )
\end_layout
\begin_layout Itemize
L'utisation d'espaces normaux dans des abréviations courantes :
\begin_inset Newline newline
\end_inset
Par exemple il y a ici trop d'espaces dans l'abréviation C.
N.
R.
S.
\end_layout
\begin_layout Itemize
L'utilisation d'un mauvais espacement à la fin d'une phrase dont la dernière
lettre est une majuscule :
\begin_inset Newline newline
\end_inset
Voici un TEST.
Et l'espacement n'est pas bon.
\end_layout
\begin_layout Itemize
L'insertion d'une espace avant une étiquette ou un autre objet de ce type
:
\begin_inset Newline newline
\end_inset
L'étiquette ou la note doit être collée au texte, sans quoi elle risque
d'apparaître sur une mauvaise page.
\begin_inset CommandInset label
LatexCommand label
name "sec:chktex"
\end_inset
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Cette note peut apparaître sur une mauvaise page, car son appel (le petit
numéro dans le texte) n'est pas collé au mot le précédant.
\end_layout
\end_inset
.
L'étiquette est ici trop séparée.
\end_layout
\begin_layout Itemize
L'utilisation d'espaces simples au lieu d'espaces insécables devant des
références :
\begin_inset Newline newline
\end_inset
Si vous n'avez pas de chance, le saut de ligne aura lieu exactement entre
le mot
\begin_inset Quotes fld
\end_inset
section
\begin_inset Quotes frd
\end_inset
et le numéro, et ça ferait le plus mauvais effet...
: voyez la section
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:chktex"
\end_inset
.
\end_layout
\begin_layout Itemize
L'utilisation d'un
\begin_inset Quotes fld
\end_inset
x
\begin_inset Quotes frd
\end_inset
au lieu du symbole
\begin_inset Quotes fld
\end_inset
\begin_inset Formula $\times$
\end_inset
\begin_inset Quotes frd
\end_inset
entre deux nombres :
\begin_inset Newline newline
\end_inset
2x2 rend beaucoup moins bien que
\begin_inset Formula $2\times2$
\end_inset
.
\end_layout
\begin_layout Standard
et bien plus encore...
C'est un outil très utile pour le
\begin_inset Quotes fld
\end_inset
polissage final
\begin_inset Quotes frd
\end_inset
du document avant son impression, et vous devriez l'utiliser après l'inévitable
correction de l'orthographe et avant d'affiner la typographie.
\end_layout
\begin_layout Subsection
Comment l'utiliser
\end_layout
\begin_layout Standard
Si le programme est installé, l'employer est un jeu d'enfant : faites
\family sans
Outils\SpecialChar \menuseparator
Correction
\begin_inset space ~
\end_inset
TeX
\family default
.
LyX générera alors une version LaTeX de votre document, lancera
\family sans
ChkTeX
\family default
pour la corriger, puis insérera des
\begin_inset Quotes fld
\end_inset
boîtes d'erreurs
\begin_inset Quotes frd
\end_inset
avec les avertissements de
\family sans
ChkTeX
\family default
, s'il y en a.
Ces avertissements seront placés au plus près de l'erreur, et vous pourrez
facilement les trouver avec
\family sans
Naviguer\SpecialChar \menuseparator
Erreur
\family default
, ou par le raccourci clavier
\family sans
C-g
\family default
(d'après le fichier de raccourcis implicites
\family typewriter
cua
\family default
).
Ouvrez les boîtes d'erreur en cliquant dessus, ou par le raccourci
\family typewriter
cua
\family default
\family sans
C-i
\family default
, ou le raccourci
\family typewriter
emacs
\family default
\family sans
C-o
\family default
.
Lisez l'avertissement, et corrigez l'erreur si c'en est bien une.
Si vous ne comprenez pas l'avertissement, ignorez-le.
En effet, il y a des différences entre ce qu'il y a à l'écran et les détails
techniques que
\family sans
ChkTeX
\family default
vérifie, et ça peut amener certains de ses avertissements à paraître mystérieux
ou même stupides.
\end_layout
\begin_layout Standard
Ce document est un excellent terrain d'entraînement, et sa vérification
lèvera sûrement quelques avertissements.
Les ordinateurs sont idiots: la plupart de ces avertissements seront donc
des fausses alertes.
\end_layout
\begin_layout Subsection
Réglages fins
\end_layout
\begin_layout Standard
Vous trouverez parfois que
\family sans
ChkTeX
\family default
est plus bavard qu'il ne devrait l'être.
Vous pouvez alors choisir de ne pas l'utiliser, ou alors le configurer
à vos propres goûts.
\end_layout
\begin_layout Standard
Mais, même si
\family sans
ChkTeX
\family default
est vraiment configurable et extensible, vous ne pourrez pas résoudre tous
les problèmes de
\family sans
ChkTeX
\family default
dans LyX de cette manière.
En effet, LyX génère un fichier LaTeX un peu particulier pour être ensuite
capable de faire correspondre les numéros de lignes indiqués par
\family sans
ChkTeX
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Vous pouvez trouver toutes les indications de
\family typewriter
chktex
\family default
en faisant
\family sans
Document\SpecialChar \menuseparator
Fichier
\begin_inset space ~
\end_inset
Journal
\begin_inset space ~
\end_inset
LaTeX
\family default
après avoir lancé
\family typewriter
chktex
\family default
.
\end_layout
\end_inset
\family default
avec la structure interne du document.
De ce fait, certains avertissements ne sembleront pas apparaître correctement.
Vous pouvez faire deux choses contre cela :
\end_layout
\begin_layout Itemize
Paramétrez l'appel à
\family sans
ChkTeX
\family default
dans
\family sans
Éditer\SpecialChar \menuseparator
Préférences\SpecialChar \menuseparator
Sorties\SpecialChar \menuseparator
\family default
LaTeX, ou alors dans le fichier de configuration de l'installation de
\family sans
ChkTeX
\family default
(souvent, le fichier
\family typewriter
chktexrc
\family default
).
Voyez ci-dessous pour savoir quels avertissements peuvent être activés
ou désactivés à la ligne de commande.
\end_layout
\begin_layout Itemize
Exportez votre document en tant que fichier LaTeX normal par
\family sans
Fichier\SpecialChar \menuseparator
Exporter\SpecialChar \menuseparator
LaTeX
\family default
et lancer manuellement
\family typewriter
chktex
\family default
dessus.
S'il est invoqué de cette façon, ça peut être pénible de trouver l'endroit
correspondant dans le document LyX, mais avec un peu de patience, vous
devriez y arriver.
\end_layout
\begin_layout Standard
Voici maintenant les messages d'avertissement qui peuvent être activés ou
désactivés dans
\family sans
Préférences
\family default
.
Utilisez
\family typewriter
-n#
\family default
pour désactiver un avertissement, et
\family typewriter
-w#
\family default
pour l'activer.
Les entrées en italiques sont désactivées par défaut, car le réglage de
base est
\begin_inset Quotes fld
\end_inset
\family typewriter
chktex -n1 -n3 -n6 -n9 -n22 -n25 -n30 -n38
\family default
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Standard
Remarquez que vous ne devriez toucher qu'à ces options d'activation et de
désactivation d'avertissements, et pas aux autres.
En effet, LyX utilise les autres options à sa convenance pour dialoguer
avec
\family typewriter
chktex
\family default
.
\end_layout
\begin_layout Enumerate
\size small
\emph on
Command terminated with space.
(La commande se termine par une espace.)
\end_layout
\begin_layout Enumerate
\size small
Non-breaking space (
\begin_inset Quotes eld
\end_inset
\family typewriter
~
\family default
\begin_inset Quotes erd
\end_inset
) should have been used.
(Il faut utiliser ici une espace insécable (
\family typewriter
\begin_inset Quotes fld
\end_inset
~
\begin_inset Quotes frd
\end_inset
\family default
).)
\end_layout
\begin_layout Enumerate
\size small
\emph on
You should enclose the previous parenthesis with
\begin_inset Quotes eld
\end_inset
\family typewriter
{}
\family default
\begin_inset Quotes erd
\end_inset
.
(Vous devriez entourer les parenthèses précédentes par
\emph default
\family typewriter
\emph on
\begin_inset Quotes fld
\end_inset
{}
\begin_inset Quotes frd
\end_inset
\family default
\emph default
\emph on
.)
\end_layout
\begin_layout Enumerate
\size small
Italic correction (
\begin_inset Quotes eld
\end_inset
\family typewriter
\backslash
/
\family default
\begin_inset Quotes erd
\end_inset
) found in non-italic buffer.
(Une correction d'italique (
\family typewriter
\begin_inset Quotes fld
\end_inset
\backslash
/
\begin_inset Quotes frd
\end_inset
\family default
) est dans un groupe qui n'est pas en italique.)
\end_layout
\begin_layout Enumerate
\size small
Italic correction (
\begin_inset Quotes eld
\end_inset
\family typewriter
\backslash
/
\family default
\begin_inset Quotes erd
\end_inset
) found more than once.
(Il y a plus d'une correction d'italique (
\family typewriter
\begin_inset Quotes fld
\end_inset
\backslash
/
\begin_inset Quotes frd
\end_inset
\family default
) .)
\end_layout
\begin_layout Enumerate
\size small
\emph on
No italic correction (
\begin_inset Quotes eld
\end_inset
\family typewriter
\backslash
/
\family default
\begin_inset Quotes erd
\end_inset
) found.
(Il n'y a pas de correcteur d'italique (
\family typewriter
\begin_inset Quotes fld
\end_inset
\backslash
/
\begin_inset Quotes frd
\end_inset
\family default
\emph default
\emph on
) .)
\end_layout
\begin_layout Enumerate
\size small
Accent command
\begin_inset Quotes eld
\end_inset
\family typewriter
cmd
\family default
\begin_inset Quotes erd
\end_inset
needs use of
\begin_inset Quotes eld
\end_inset
\family typewriter
cmd
\family default
\begin_inset Quotes erd
\end_inset
.
(La commande
\family typewriter
\begin_inset Quotes fld
\end_inset
cmd
\begin_inset Quotes frd
\end_inset
\family default
requière l'utilisation de
\family typewriter
\begin_inset Quotes fld
\end_inset
cmd
\begin_inset Quotes frd
\end_inset
\family default
.)
\end_layout
\begin_layout Enumerate
\size small
Wrong length of dash may have been used.
(Il se peut que le tiret ne soit pas de la bonne longueur.)
\end_layout
\begin_layout Enumerate
\size small
\emph on
\begin_inset Quotes eld
\end_inset
\family typewriter
%s
\family default
\begin_inset Quotes erd
\end_inset
expected, found
\begin_inset Quotes eld
\end_inset
\family typewriter
%s
\family default
\begin_inset Quotes erd
\end_inset
.
(Attendait
\emph default
\family typewriter
\emph on
\begin_inset Quotes fld
\end_inset
%s
\begin_inset Quotes frd
\end_inset
\family default
, a trouvé
\emph default
\family typewriter
\emph on
\begin_inset Quotes fld
\end_inset
%s
\begin_inset Quotes frd
\end_inset
\family default
.)
\end_layout
\begin_layout Enumerate
\size small
Solo
\begin_inset Quotes eld
\end_inset
\family typewriter
%s
\family default
\begin_inset Quotes erd
\end_inset
found.
(Un seul
\size default
\family typewriter
\begin_inset Quotes fld
\end_inset
\size small
%s
\size default
\begin_inset Quotes frd
\end_inset
\family default
\size small
a été trouvé.)
\end_layout
\begin_layout Enumerate
\size small
You should use
\begin_inset Quotes eld
\end_inset
\family typewriter
%s
\family default
\begin_inset Quotes erd
\end_inset
to achieve an ellipsis.
(Vous devriez utiliser
\family typewriter
\begin_inset Quotes fld
\end_inset
%s
\begin_inset Quotes frd
\end_inset
\family default
pour une ellipse (points de suspension).)
\end_layout
\begin_layout Enumerate
\size small
Inter-word spacing (
\begin_inset Quotes eld
\end_inset
\family typewriter
\backslash
\family default
\begin_inset Quotes eld
\end_inset
) should perhaps be used.
(Une espace d'entre mots (
\family typewriter
\begin_inset Quotes fld
\end_inset
\backslash
\begin_inset space ~
\end_inset
\family default
\begin_inset Quotes frd
\end_inset
) devrait peut-être être utilisé.)
\end_layout
\begin_layout Enumerate
\size small
Inter-sentence spacing (
\begin_inset Quotes eld
\end_inset
\family typewriter
\backslash
@
\family default
\begin_inset Quotes erd
\end_inset
) should perhaps be used.
(Une espace d'entre phrases (
\family typewriter
\begin_inset Quotes fld
\end_inset
\backslash
@
\begin_inset Quotes frd
\end_inset
\family default
) devrait peut-être être utilisé.)
\end_layout
\begin_layout Enumerate
\size small
Could not find argument for command.
(N'a pas trouvé de paramètre à la commande.)
\end_layout
\begin_layout Enumerate
\size small
No match found for
\begin_inset Quotes eld
\end_inset
\family typewriter
%s
\family default
\begin_inset Quotes erd
\end_inset
.
(Aucune occurrence de
\begin_inset Quotes fld
\end_inset
\family typewriter
%s
\family default
\begin_inset Quotes frd
\end_inset
n'a été trouvée.)
\end_layout
\begin_layout Enumerate
\size small
Math mode still on at end of LaTeX file.
(Le fichier LaTeX se termine dans le mode Math.)
\end_layout
\begin_layout Enumerate
\size small
Number of
\begin_inset Quotes eld
\end_inset
\family typewriter
char
\family default
\begin_inset Quotes erd
\end_inset
doesn't match the number of
\begin_inset Quotes eld
\end_inset
\family typewriter
char
\family default
\begin_inset Quotes erd
\end_inset
.
(Le numéro de
\family typewriter
\begin_inset Quotes fld
\end_inset
char
\begin_inset Quotes frd
\end_inset
\family default
ne correspond pas à celui de
\family typewriter
\begin_inset Quotes fld
\end_inset
char
\begin_inset Quotes frd
\end_inset
\family default
.)
\end_layout
\begin_layout Enumerate
\size small
You should use either
\family typewriter
\begin_inset Quotes eld
\end_inset
\family default
or
\family typewriter
\begin_inset Quotes erd
\end_inset
\family default
as an alternative to
\begin_inset Quotes eld
\end_inset
\family typewriter
"
\family default
\begin_inset Quotes erd
\end_inset
.
(Vous devriez utiliser
\family typewriter
\begin_inset Quotes eld
\end_inset
\family default
ou
\family typewriter
\begin_inset Quotes erd
\end_inset
\family default
plutôt que
\family typewriter
\begin_inset Quotes fld
\end_inset
"
\begin_inset Quotes frd
\end_inset
\family default
.)
\end_layout
\begin_layout Enumerate
\size small
You should use "
\family typewriter
'
\family default
" (ASCII 39) instead of "´" (ASCII 180).
(Vous devriez utiliser
\family typewriter
\begin_inset Quotes fld
\end_inset
'
\begin_inset Quotes frd
\end_inset
\family default
(ASCII 39) au lieu de
\family typewriter
\begin_inset Quotes fld
\end_inset
\family default
´
\family typewriter
\begin_inset Quotes frd
\end_inset
\family default
(ASCII 180).)
\end_layout
\begin_layout Enumerate
\size small
User-specified pattern found.
(A trouvé un format défini par l'utilisateur.)
\end_layout
\begin_layout Enumerate
\size small
This command might not be intended.
(Cette commande n'est peut-être pas volontaire.)
\end_layout
\begin_layout Enumerate
\size small
\emph on
Comment displayed.
(Un commentaire est affiché.)
\end_layout
\begin_layout Enumerate
\size small
Either
\family typewriter
''
\backslash
,'
\family default
or
\family typewriter
'
\backslash
,''
\family default
will look better.
(
\family typewriter
''
\backslash
,'
\family default
ou
\family typewriter
'
\backslash
,''
\family default
présentera mieux.)
\end_layout
\begin_layout Enumerate
\size small
Delete this space to maintain correct page references.
(Enlevez cette espace pour avoir une pagination correcte.)
\end_layout
\begin_layout Enumerate
\size small
\emph on
You might wish to put this between a pair of
\begin_inset Quotes eld
\end_inset
\family typewriter
{}
\family default
\begin_inset Quotes erd
\end_inset
.
(Ce serait peut-être mieux entre deux accolades
\emph default
\family typewriter
\emph on
\begin_inset Quotes fld
\end_inset
{}
\begin_inset Quotes frd
\end_inset
\family default
.)
\end_layout
\begin_layout Enumerate
\size small
You ought to remove spaces in front of punctuation.
(Il n'y a pas d'espace devant cette ponctuation.)
\end_layout
\begin_layout Enumerate
\size small
Could not execute LaTeX command.
(Ne peut pas exécuter la commande LaTeX.)
\end_layout
\begin_layout Enumerate
\size small
Don't use
\family typewriter
\backslash
/
\family default
in front of small punctuation.
(N'utilisez pas
\family typewriter
\backslash
/
\family default
devant la ponctuation basse.)
\end_layout
\begin_layout Enumerate
\family typewriter
\size small
$
\backslash
times$
\family default
may look prettier here.
(
\family typewriter
$
\backslash
times$
\family default
serait mieux ici.)
\end_layout
\begin_layout Enumerate
\size small
\emph on
Multiple spaces detected in output.
(La sortie affiche ici plusieurs espaces.)
\end_layout
\begin_layout Enumerate
\size small
This text may be ignored.
(Ce texte ne sera peut-être pas pris en compte.)
\end_layout
\begin_layout Enumerate
\size small
Use
\family typewriter
\begin_inset Quotes eld
\end_inset
\family default
to begin quotation, not
\family typewriter
'
\family default
.
(Utilisez
\family typewriter
\begin_inset Quotes eld
\end_inset
\family default
pour ouvrir une citation et non
\family typewriter
'
\family default
.)
\end_layout
\begin_layout Enumerate
\size small
Use
\family typewriter
'
\family default
to end quotation, not
\family typewriter
\begin_inset Quotes eld
\end_inset
\family default
.
(Utilisez
\family typewriter
'
\family default
pour clore une citation et non
\family typewriter
\begin_inset Quotes eld
\end_inset
\family default
.)
\end_layout
\begin_layout Enumerate
\size small
Don't mix quotes.
(Ne mélangez pas les différents types de guillemets.)
\end_layout
\begin_layout Enumerate
\size small
You should perhaps use
\begin_inset Quotes eld
\end_inset
\family typewriter
cmd
\family default
\begin_inset Quotes erd
\end_inset
instead.
(Il vaudrait peut-être mieux utiliser
\family typewriter
\begin_inset Quotes fld
\end_inset
cmd
\begin_inset Quotes frd
\end_inset
\family default
.)
\end_layout
\begin_layout Enumerate
\size small
You should put a space in front of/after parenthesis.
(Il faut des espaces à l'extérieur des parenthèses.)
\end_layout
\begin_layout Enumerate
\size small
You should avoid spaces in front of/after parenthesis.
(Ne mettez pas d'espaces à l'intérieur des parenthèses.)
\end_layout
\begin_layout Enumerate
\size small
\emph on
You should not use punctuation in front of/after quotes.
(La ponctuation ne doit pas apparaître derrière les guillemets.)
\end_layout
\begin_layout Enumerate
\size small
Double space found.
(Double espace !)
\end_layout
\begin_layout Enumerate
\size small
You should put punctuation outside inner/inside display math mode.
(La ponctuation devrait se trouver à l'extérieur du mode mathématique.)
\end_layout
\begin_layout Enumerate
\size small
You ought to not use primitive TeX in LaTeX code.
(Vous ne devez pas utiliser de primitives TeX dans du code LaTeX.)
\end_layout
\begin_layout Enumerate
\size small
You should remove spaces in front of
\begin_inset Quotes eld
\end_inset
\family typewriter
%s
\family default
\begin_inset Quotes erd
\end_inset
.
(Ne mettez pas d'espaces devant
\family typewriter
\begin_inset Quotes fld
\end_inset
%s
\begin_inset Quotes frd
\end_inset
\family default
.)
\end_layout
\begin_layout Enumerate
\size small
\begin_inset Quotes eld
\end_inset
\family typewriter
%s
\family default
\begin_inset Quotes erd
\end_inset
is normally not followed by
\begin_inset Quotes eld
\end_inset
\family typewriter
%c
\family default
\begin_inset Quotes erd
\end_inset
.
(
\family typewriter
\begin_inset Quotes fld
\end_inset
%s
\begin_inset Quotes frd
\end_inset
\family default
n'est normalement pas suivi de
\family typewriter
\begin_inset Quotes fld
\end_inset
%c
\begin_inset Quotes frd
\end_inset
\family default
.)
\end_layout
\begin_layout Standard
Nous espérons fournir dans les versions futures de LyX une interface plus
complète à cet outil (ainsi qu'à son petit cousin
\family typewriter
lacheck
\family default
) pour pouvoir en exploiter toute la puissance.
Mais, , il est dès maintenant utilisable : lancez-le sur l'un de vos documents
de bonne taille, et voyez le résultat.
\end_layout
\begin_layout Section
Contrôle de version sous LyX
\end_layout
\begin_layout Standard
par
\noun on
Lars Gullik Bjønnes,
\noun default
mise à jour par
\noun on
Pavel sanda
\end_layout
\begin_layout Subsection
Introduction
\end_layout
\begin_layout Standard
Un de mes amis voulut essayer LyX pour un projet de groupe, mais lorsqu'il
s'aperçut qu'il n'y avait pas de contrôle de version ou de verrou de fichier,
il laissa tomber.
Cela me chagrina un peu, et je me mis à travailler au support de RCS par
LyX (avec la perspective future d'un support de CVS et/ou SCCS).
Maintenant, c'est fait.
LyX accepte la plupart des commandes simples de RCS/CVS/SVN.
Si vous devez utiliser des fonctions plus sophistiquées, il vous faudra
cependant encore passer par un terminal de commande.
\end_layout
\begin_layout Standard
Avant de vous lancer dans l'utilisation du contrôle de version sous LyX,
vous devrez connaître l'utilisation de RCS/CVS/SVN.
Notez également que le support de CVS n'est pas aussi bon que celui de
Subversion, que nous vous conseillons donc.
Un bon document de départ pour Subversion est le Manuel SVN
\begin_inset Foot
status open
\begin_layout Plain Layout
\begin_inset CommandInset href
LatexCommand href
target "http://svnbook.red-bean.com/"
\end_inset
\end_layout
\end_inset
.
Pour RCS, lisez d'abord
\begin_inset Quotes fld
\end_inset
rcsintro
\begin_inset Quotes frd
\end_inset
(c'est un fichier man : lisez-le avec
\family typewriter
man rcsintro
\family default
).
Ce fichier décrit toutes les fonctions de base de RCS\SpecialChar \@.
Voyez particulièrement
le paragraphe sur le répertoire RCS, et la notion de fichier RCS maître
(le fichier finissant par
\family typewriter
,v
\family default
).
\end_layout
\begin_layout Standard
Le support assuré dans LyX a été réalisé pour des versions récentes des
paquetages GNU RCS ou CVS/SVN ― il n'est pas garanti que cela fonctionne
avec des versions plus anciennes.
En général, les messages de contrôle ne sont pas affichés après chaque
opération ― vous pouvez les vérifier dans la console de lancement de LyX
si vous doutez.
\end_layout
\begin_layout Standard
Pour créer vos propres commandes externes, consultez
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
vc-command
\end_layout
\end_inset
dans le manuel des fonctions LyX.
\end_layout
\begin_layout Subsection
Les commandes RCS sous LyX
\end_layout
\begin_layout Standard
Les sections suivantes décrivent les commandes RCS supportées par LyX.
Vous pouvez les trouver dans
\family sans
Fichier\SpecialChar \menuseparator
Contrôle
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
Version
\family default
.
Lyx a été testé avec RCS 5.7.
\end_layout
\begin_layout Subsubsection
\family sans
Initialiser le contrôle de version
\end_layout
\begin_layout Standard
Si votre document n'est pas sous le mode
\begin_inset Quotes fld
\end_inset
contrôle de version
\begin_inset Quotes frd
\end_inset
, c'est le seul choix qui vous soit proposé.
Si vous êtes déjà sous ce mode, l'élément
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
S'inscrire
\end_layout
\end_inset
est grisé et inaccessible.
\end_layout
\begin_layout Standard
Cette commande intialise le contrôle de version avec RCS\SpecialChar \@.
Il vous est alors
demandé de donner une description initiale du document.
Le document est alors mis en mode
\begin_inset Quotes fld
\end_inset
lecture seule
\begin_inset Quotes frd
\end_inset
et il vous faudra faire
\family sans
Nouvelle
\begin_inset space ~
\end_inset
Version
\begin_inset space ~
\end_inset
Modifiable
\family default
avant de le modifier.
Un document sous contrôle de version a dans le minibuffer
\begin_inset Quotes fld
\end_inset
[RCS:<version><locker>]
\begin_inset Quotes frd
\end_inset
accolé au nom de fichier.
\end_layout
\begin_layout Standard
En arrière-plan, la commande RCS qui a été lancée est
\family typewriter
ci -q -u -i -t-\SpecialChar \-
"<description_\SpecialChar \-
initiale>" <nom_fichier>.
\end_layout
\begin_layout Standard
Lisez
\family typewriter
man ci
\family default
pour comprendre le sens des paramètres.
\end_layout
\begin_layout Subsubsection
Enregistrer
\begin_inset space ~
\end_inset
les
\begin_inset space ~
\end_inset
changements
\end_layout
\begin_layout Standard
Lorsque vous avez fini de modifier un fichier, vous figez vos modifications
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT : check-in
\end_layout
\end_inset
par
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Fichier\SpecialChar \menuseparator
Contrôle
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
Version\SpecialChar \menuseparator
Enregistrer
\begin_inset space ~
\end_inset
les
\begin_inset space ~
\end_inset
changements...
\end_layout
\end_inset
.
Il vous sera alors demandé une description de ceux-ci.
Cette information est conservée dans le fichier d'historique.
Le numéro de version est alors incrémenté, vos modifications sont appliquées
au fichier RCS maître et le document est déverrouillé et remis en mode
\begin_inset Quotes fld
\end_inset
lecture seule
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Standard
Commande RCS :
\family typewriter
ci -q -u -m"<description>" <nom_fichier>
\end_layout
\begin_layout Subsubsection
\family sans
Nouvelle version modifiable
\end_layout
\begin_layout Standard
En utilisant cette commande, vous verrouillez le document de manière à ce
que vous soyez le seul à pouvoir l'éditer.
Vous seul en possédez les droits d'écriture.
Vous continuez donc à éditer le fichier un moment, puis vous figez vos
changements.
La ligne d'état est modifiée pour indiquer que le fichier est verrouillé.
\end_layout
\begin_layout Standard
Commande RCS :
\family typewriter
co -q -l <nom_fichier>
\end_layout
\begin_layout Subsubsection
\family sans
Revenir à la version du dépôt
\end_layout
\begin_layout Standard
Ceci annule tous les changements réalisés sur le document depuis que le
document a été figé la dernière fois.
Une demande de confirmation apparaît alors, avant que tous les changements
soient perdus.
\end_layout
\begin_layout Standard
Commande RCS :
\family typewriter
co -f -u<version> <nom_fichier>
\end_layout
\begin_layout Subsubsection
\family sans
Annuler le dernier enregistrement
\end_layout
\begin_layout Standard
Fait comme si la dernière modification n'avait jamais été faite.
Aucune modification n'apparaît sur le document LyX, mais la dernière version
est effacée du fichier maître RCS.
\end_layout
\begin_layout Standard
Commande RCS :
\family typewriter
rcs -o<version> <nom_fichier>
\end_layout
\begin_layout Subsubsection
\family sans
Visionner historique
\end_layout
\begin_layout Standard
Montre l'historique complet du document RCS.
La sortie de
\family typewriter
rlog <nom_fichier>
\family default
est ainsi affichée dans une fenêtre.
Voyez
\family typewriter
man rlog
\family default
pour plus d'informations.
\end_layout
\begin_layout Subsubsection
Informations de révision
\end_layout
\begin_layout Standard
Lyx ne connaît que le numéro de version RCS, voir
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:VCS-Revision-Information"
\end_inset
pour les détails.
\end_layout
\begin_layout Subsection
\lang english
CVS commands in LyX
\begin_inset Note Note
status open
\begin_layout Plain Layout
Le reste de ce chapitre reste à traduire (JPChrétien, juin 2011)
\end_layout
\end_inset
\end_layout
\begin_layout Standard
\lang english
A subset of CVS operations is supported by LyX.
You can find the commands in the
\family sans
File\SpecialChar \menuseparator
Version
\begin_inset space ~
\end_inset
Control
\family default
submenu.
The version control system SVN is more powerful, so please use it instead
of CVS if possible.
\end_layout
\begin_layout Subsubsection
\family sans
\lang english
General CVS usage
\end_layout
\begin_layout Standard
\lang english
If you start from scratch with CVS you have to create your repository and
checkout the working copy with external tools.
If you're using a client-server setup you may need to login before doing
the first repository checkout.
\end_layout
\begin_layout Standard
\lang english
If your documents are under revision control and others are using the same
repository problems arise when different changes to the same document at
the same location happen.
Standard CVS repositories doesn't operate with a file locking mechanism.
This may be surprising, but conflicts only occur if people disagree on
the proper content of the same part of a document.
So, if co-workers are used to communicate regularly, these conflicts occur
rarely.
If they don't communicate they have a fundamental problem anyway.
Nevertheless some people like to work with so called
\begin_inset Quotes eld
\end_inset
reserved checkouts
\begin_inset Quotes erd
\end_inset
.
If they do so the working copy of all files is readonly when checked out
first and the user starts editing after using a special command to make
the working copy writable.
When the changes are checked in the working copy returns to readonly state.
With LyX one has to edit the
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
.cvsrc
\end_layout
\end_inset
file and add the line
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
cvs -r
\end_layout
\end_inset
to work with reserved checkouts.
The benefit is the possibility to see who is using a writable copy of some
document.
It's not guaranteed only one user makes a copy writable.
\end_layout
\begin_layout Standard
\lang english
LyX tries to guess if you're using reserved or non-reserved checkouts.
If your working copy is readonly or it is writable and an additional copy
of your document exists in the CVS/Base sub-directory a reserved otherwise
a non-reserved checkout is assumed.
When a reserved checkout is detected you have to use
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
Check Out
\end_layout
\end_inset
to make your working copy writable if it's readonly.
After doing so the
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
Check In
\end_layout
\end_inset
operation is possible and that makes your working copy readonly again after
transferring your changes to the repository.
\end_layout
\begin_layout Standard
\lang english
More information about CVS can be found here
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
http://www.nongnu.org/cvs
\end_layout
\end_inset
and here
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
http://ximbiot.com/cvs
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
\lang english
Read
\family typewriter
man cvs
\family default
to understand the sub-commands and the switches mentioned below.
\end_layout
\begin_layout Subsubsection
\family sans
\lang english
Register
\end_layout
\begin_layout Standard
\lang english
If your document is not under revision control, this is the only item shown
in the menu.
And if it is under revision control, the
\family sans
\bar under
R
\bar default
egister
\family default
item is not visible.
\end_layout
\begin_layout Standard
\lang english
This command registers in CVS your document
\begin_inset Flex Strong
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
only
\end_layout
\end_inset
in case you have already the documents directory under CVS control (in
particular
\family typewriter
CVS/Entries
\family default
file exists).
This means you have to create or checkout the archive by yourself using
external tools.
(In case you forget that step LyX registers the document with RCS.)
\end_layout
\begin_layout Standard
\lang english
Then you are asked interactively to supply an initial description of the
document.
Don't forget that registered file is not yet checked in.
\end_layout
\begin_layout Standard
\lang english
CVS command that is run:
\family typewriter
cvs -q add -m"<entered message>" "<file-name>"
\end_layout
\begin_layout Standard
\lang english
The term
\family typewriter
"<file-name>"
\family default
above and for all other CVS commands is an abbreviation for
\begin_inset Quotes eld
\end_inset
change the current working directory to file location and use the file name
without path component as argument
\begin_inset Quotes erd
\end_inset
.
\end_layout
\begin_layout Subsubsection
\family sans
\lang english
Check In Changes
\end_layout
\begin_layout Standard
\lang english
When you are finished editing a file, you commit your changes.
When you do this and you had changed the document, you are asked for a
description of the changes.
After that changes are written to the repository.
In case you didn't change the document and a reserved checkout is detected
the reservation made on
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
Check Out
\end_layout
\end_inset
is undone.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\lang english
CVS
\begin_inset space ~
\end_inset
command:
\begin_inset space ~
\end_inset
\begin_inset Newline newline
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
cvs
\family typewriter
-q commit -m"<description>" "<file-name>"
\end_layout
\end_inset
or
\begin_inset Newline newline
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
cvs -q unedit
\family typewriter
"<file-name>"
\end_layout
\end_inset
\end_layout
\begin_layout Subsubsection
\family sans
\lang english
Check Out Changes
\end_layout
\begin_layout Standard
\lang english
When you are sharing a repository with others, you may have to incorporate
their changes into your working copy.
\end_layout
\begin_layout Standard
\lang english
CVS command:
\family typewriter
cvs -q update "<file-name>"
\end_layout
\begin_layout Standard
\lang english
If a readonly checkout is detected the working copy is made writable and
reserved.
\end_layout
\begin_layout Standard
\lang english
CVS command:
\family typewriter
cvs -q edit "<file-name>"
\end_layout
\begin_layout Subsubsection
\family sans
\lang english
Revert To Repository Version
\end_layout
\begin_layout Standard
\lang english
This will discard all changes made to the document since the last check
in.
You get a warning before changes are discarded.
Firstly the file is deleted, secondly CVS update command is run.
\end_layout
\begin_layout Standard
\lang english
CVS command:
\family typewriter
cvs -q update "<file-name>"
\end_layout
\begin_layout Standard
\lang english
If a reserved checkout is detected and the working copy has no changes only
the reservation is undone.
\end_layout
\begin_layout Standard
\lang english
CVS command:
\family typewriter
cvs -q unedit "<file-name>"
\end_layout
\begin_layout Subsubsection
\lang english
Update of the local directory checkout from repository
\end_layout
\begin_layout Standard
\lang english
Once your documents gets more complex, containing sub-documents and pictures,
including external
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
.tex
\end_layout
\end_inset
files and so on using version control becomes more complicated.
LyX supports updating the whole tree in which resides the document.
This become especially useful once you cooperate with people which neither
have detailed knowledge about CVS usage nor they have ambition to commit
additional material to the repository.
You have to organize the files structure so that all external files are
in the same directory or subdirectories of the document.
It's good practice anyway to store multipart documents in an extra directory.
\end_layout
\begin_layout Standard
\lang english
The
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Update local directory from repository
\end_layout
\end_inset
command updates the whole directory.
If local changes are detected user is warned before update starts.
In case of merge conflicts both versions of the conflicting document parts
are placed in the final document.
You have to review and correct the result of the merge.
You'll find the conflicts enclosed in pairs of
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
<<<<<<<
\end_layout
\end_inset
and
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
>>>>>>>
\end_layout
\end_inset
separated by
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
=======
\end_layout
\end_inset
.
The first part is your version as before the update operation with the
document name prepended.
The second one is the repository version with the version number after
the sequence of
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
>
\end_layout
\end_inset
signs.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\lang english
CVS
\begin_inset space ~
\end_inset
commands:
\begin_inset space ~
\end_inset
\begin_inset Newline newline
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
cd $path; cvs diff
\family typewriter
"."
\end_layout
\end_inset
(Ask if changes are detected.)
\begin_inset Newline newline
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
cd $path; cvs -q update
\family typewriter
"."
\end_layout
\end_inset
\end_layout
\begin_layout Standard
\lang english
where
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$path
\end_layout
\end_inset
stands for the path to the document.
\end_layout
\begin_layout Subsubsection
\family sans
\lang english
Show History
\end_layout
\begin_layout Standard
\lang english
This shows the complete history of the CVS document.
The output of
\family typewriter
cvs log "<file-name>"
\family default
is shown in a browser.
\end_layout
\begin_layout Subsection
\lang english
SVN commands in LyX
\end_layout
\begin_layout Standard
\lang english
SVN is now partially supported by LyX.
You can find the commands in the
\family sans
File\SpecialChar \menuseparator
Version
\begin_inset space ~
\end_inset
Control
\family default
submenu.
Please note that if you use password protected access to repository via
ssh, you will be asked in terminal window.
LyX was tested against SVN 1.5 and 1.6
\begin_inset Foot
status open
\begin_layout Plain Layout
\lang english
Most of the commands will work with 1.4 too, see
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:SVN-Repo-Update"
\end_inset
.
\end_layout
\end_inset
\end_layout
\begin_layout Subsubsection
\family sans
\lang english
Register
\end_layout
\begin_layout Standard
\lang english
If your document is not under revision control, this is the only item shown
in the menu.
And if it is under revision control, the
\family sans
\bar under
R
\bar default
egister
\family default
item is not visible.
\end_layout
\begin_layout Standard
\lang english
This command registers in SVN your document ONLY in case you have already
the documents directory under SVN control (in particular
\family typewriter
.svn/entries
\family default
file exists).
This means you have to checkout the archive by yourself.
\end_layout
\begin_layout Standard
\lang english
Then you are asked interactively to supply an initial description of the
document.
Don't forget that registered file is not yet commited.
\end_layout
\begin_layout Standard
\lang english
SVN command that is run:
\family typewriter
svn add -q
\begin_inset Quotes eld
\end_inset
<file-name>
\begin_inset Quotes erd
\end_inset
\end_layout
\begin_layout Standard
\lang english
Read
\family typewriter
man svn
\family default
to understand the switches.
\end_layout
\begin_layout Subsubsection
\family sans
\lang english
Check In Changes
\end_layout
\begin_layout Standard
\lang english
When you are finished editing a file, you commit your changes.
When you do this, you are asked for a description of the changes.
After that changes are commited.
\end_layout
\begin_layout Standard
\lang english
SVN command:
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
In case locking is not enabled.
See Section
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:SVN-File-Locking"
\end_inset
.
\end_layout
\end_inset
\family typewriter
svn commit -q -m"<description>" <file-name>
\end_layout
\begin_layout Subsubsection
\family sans
\lang english
Check Out For Edit
\end_layout
\begin_layout Standard
\lang english
Updates the changes of this file from the repository.
Be sure you understand SVN merging and conflicts resolving before using
this function, because all conflicts has to be resolved manually by you!
\end_layout
\begin_layout Standard
\lang english
SVN command:
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
Ditto.
\end_layout
\end_inset
\family typewriter
svn update --non-interactive
\begin_inset Quotes eld
\end_inset
<file-name>
\begin_inset Quotes erd
\end_inset
\end_layout
\begin_layout Subsubsection
\family sans
\lang english
Revert To Repository Version
\end_layout
\begin_layout Standard
\lang english
This will discard all changes made to the document since the last check
in.
You get a warning before changes are discarded.
\end_layout
\begin_layout Standard
\lang english
SVN command:
\family typewriter
svn revert -q
\begin_inset Quotes eld
\end_inset
<file-name>
\begin_inset Quotes erd
\end_inset
\end_layout
\begin_layout Subsubsection
\lang english
\begin_inset CommandInset label
LatexCommand label
name "sub:SVN-Repo-Update"
\end_inset
Update of the local directory checkout from repository
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
Note that this command will work only with subversion
\begin_inset Formula $\geqq1.5$
\end_inset
\end_layout
\end_inset
\end_layout
\begin_layout Standard
\lang english
All the commands above have one shortcomming - they deal with the current
document only.
Once your document contains pictures, includes external
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
.tex
\end_layout
\end_inset
files and so on administration becomes more complicated.
LyX now supports updating the whole tree in which resides the document
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
One need to organize the files structure so that all external files are
in the same directory or subdirectories of the document.
\end_layout
\end_inset
.
This become especially useful once you cooperate with people which neither
know about subversion management nor they have ambition to commit additional
material to the repository.
\end_layout
\begin_layout Standard
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Update local directory from repository
\end_layout
\end_inset
command updates the whole directory and in case of merge conflicts local
version of the files are left, so no unintended data loss occurs.
If local changes are detected user is warned before update starts.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\lang english
SVN
\begin_inset space ~
\end_inset
commands:
\begin_inset space ~
\end_inset
\begin_inset Newline newline
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
svn diff $path
\end_layout
\end_inset
(Ask if changes are detected.)
\begin_inset Newline newline
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
svn update --accept mine-full $path
\end_layout
\end_inset
\end_layout
\begin_layout Standard
\lang english
where
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$path
\end_layout
\end_inset
stands for the path to the document.
\end_layout
\begin_layout Subsubsection
\family sans
\lang english
Show History
\end_layout
\begin_layout Standard
\lang english
This shows the complete history of the SVN document.
The output of
\family typewriter
svn log
\begin_inset Quotes eld
\end_inset
<file-name>
\begin_inset Quotes erd
\end_inset
\family default
is shown in a browser.
\end_layout
\begin_layout Subsubsection
\lang english
File Locking
\begin_inset CommandInset label
LatexCommand label
name "subsec:SVN-File-Locking"
\end_inset
\end_layout
\begin_layout Standard
\lang english
The file exchange through various revision control systems brings the problem
of merge conflicts in case two different users try to edit the same (parts
of) document.
When such a conflict happens it needs manual resolving and one reasonable
alternative is to provide some kind of locking mechanism, which guarantees
that only one user is allowed to edit file at the given time.
\end_layout
\begin_layout Standard
\lang english
SVN has two such mechanisms to provide mutual exclusivity for file access
- locks and automatic setting of write permissions (see sec.
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:Automatical-Locking-Property"
\end_inset
) based on
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
svn:needs-lock
\end_layout
\end_inset
file svn property
\begin_inset Foot
status open
\begin_layout Plain Layout
\lang english
http://svnbook.red-bean.com/en/1.2/svn.advanced.locking.html
\end_layout
\end_inset
.
If this property is detected for a given document LyX starts to use SVN
locks for document editing automatically and the whole check-in/out mechanism
switches to the same regimen as for RCS.
This in particular means there are two different modes of file use in LyX:
\end_layout
\begin_layout Itemize
\lang english
Unlocked state.
The loaded file is in the read-only mode.
For editing on needs to check-out.
\emph on
Check-out
\emph default
consists of updating from the repository and gaining write lock.
If the lock is not possible to obtain, we remain in unlocked state.
\end_layout
\begin_layout Itemize
\lang english
Locked state.
The loaded file is in the 'normal' edit mode.
No other user is allowed to edit the file.
\emph on
Check-in
\emph default
consists of commiting changes and releasing write-lock.
If no changes have been made to the document, no commit will be produced
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
Don't be puzzled by the fact that you will be asked for commit message anyway.
\end_layout
\end_inset
and only the write-lock will be released.
\end_layout
\begin_layout Standard
\lang english
SVN commands:
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\lang english
Check-in:
\family typewriter
svn commit -q -m"<description>" "<file-name>"
\begin_inset Newline newline
\end_inset
svn unlock "<file-name>"
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\lang english
Check-out:
\family typewriter
svn update "<file-name>"
\begin_inset Newline newline
\end_inset
svn lock "<file-name>"
\end_layout
\begin_layout Subsubsection
\family typewriter
\lang english
\begin_inset CommandInset label
LatexCommand label
name "subsec:Automatical-Locking-Property"
\end_inset
\family default
Automatic Locking Property
\end_layout
\begin_layout Standard
\lang english
The above mentioned automatic setting of write permissions of the .lyx file
can be set through
\family sans
\bar under
F
\bar default
ile\SpecialChar \menuseparator
\bar under
V
\bar default
ersion
\begin_inset space ~
\end_inset
Control\SpecialChar \menuseparator
\bar under
T
\bar default
oggle locking property
\family default
.
This command is active only when the file is not locked on the svn server
(i.e.
you need to check-out before proceeding).
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\lang english
SVN
\begin_inset space ~
\end_inset
commands:
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\lang english
Set:
\family typewriter
svn propset svn:needs-lock ON "<file-name>"
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\lang english
Unset:
\family typewriter
svn propdel svn:needs-lock "<file-name>"
\end_layout
\begin_layout Subsubsection
\lang english
\begin_inset CommandInset label
LatexCommand label
name "sub:VCS-Revision-Information"
\end_inset
Revision Information in Documents
\end_layout
\begin_layout Standard
\lang english
There are more possibilities how to activate revision information in our
document.
\end_layout
\begin_layout Itemize
\lang english
LyX supports directly:
\end_layout
\begin_deeper
\begin_layout Itemize
\lang english
tree revision information (
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
vcs-tree-revision
\end_layout
\end_inset
).
The result is the output of the
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
svnversion
\end_layout
\end_inset
command, the following table gives you an idea, how to read the results.
\end_layout
\begin_layout Standard
\align center
\lang english
\begin_inset Tabular
<lyxtabular version="3" rows="6" columns="2">
<features tabularvalignment="middle">
<column alignment="center" valignment="top" width="0">
<column alignment="center" valignment="top" width="0">
<row>
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\lang english
Output
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\lang english
Meaning
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\lang english
4123:4168
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\lang english
mixed revision working copy
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\lang english
4168M
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\lang english
modified working copy
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\lang english
4123S
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\lang english
switched working copy
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\lang english
4123P
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\lang english
partial working copy, from a sparse checkout
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\lang english
4123:4168MS
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\lang english
mixed revision, modified, switched working copy
\end_layout
\end_inset
</cell>
</row>
</lyxtabular>
\end_inset
\end_layout
\begin_layout Itemize
\lang english
file revision information.
The result comes from parsing the output of
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
svn
\begin_inset space ~
\end_inset
info
\begin_inset space ~
\end_inset
--xml
\begin_inset space ~
\end_inset
file.lyx
\end_layout
\end_inset
.
Supported flags are:
\end_layout
\begin_deeper
\begin_layout Itemize
\lang english
version number of the last commit (
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
vcs-revision
\end_layout
\end_inset
)
\end_layout
\begin_layout Itemize
\lang english
author of the last commit (
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
vcs-author
\end_layout
\end_inset
)
\end_layout
\begin_layout Itemize
\lang english
date of the last commit (
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
vcs-date
\end_layout
\end_inset
)
\end_layout
\begin_layout Itemize
\lang english
time of the last commit (
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
vcs-time
\end_layout
\end_inset
)
\end_layout
\end_deeper
\begin_layout Standard
\lang english
You can obtain this info via InsetInfo (e.g.
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
info-insert buffer vcs-date
\end_layout
\end_inset
).
The information will be available only when you have the file stored under
svn managment (i.e.
the
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
.svn
\end_layout
\end_inset
directory is available with your document).
\end_layout
\end_deeper
\begin_layout Itemize
\lang english
Another---a hacking one---possibility is to use svn keywords
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
http://svnbook.red-bean.com/en/1.4/svn.advanced.props.special.keywords.html
\end_layout
\end_inset
.
In short -- you set file keywords property (e.g.
\family sans
svn propset svn:keywords 'Rev' file.lyx
\family default
) and then paste keyword TeX code
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
This is an easy way how to ensure that LyX won't break the line in the middle
of keyword tag.
\end_layout
\end_inset
tag in your document (e.g.
\begin_inset ERT
status open
\begin_layout Plain Layout
$Rev$
\end_layout
\end_inset
).
This way svn client will automatically substitute revision number (e.g.
\begin_inset ERT
status open
\begin_layout Plain Layout
$Rev: 59 $
\end_layout
\end_inset
) after each update and commit.
There are more problems with this approach.
Firstly, the '$' character is used in TeX world for math equations, so
any occurence of math formula
\begin_inset Formula $Rev$
\end_inset
become
\begin_inset Formula $Rev:59$
\end_inset
in your LyX document.
Similarly for other keywords like Id, Date, Author, etc.
Secondly svn output is dependent on your locales, so its very easy that
svn would produce some problematic strings once Date is used.
Thirdly you get the whole 'Rev: 59' string in your document instead of
the plain number.
Until subversion implements user's custom keywords it will be hard to use
this approach reliably or let LyX to support it directly.
\end_layout
\begin_layout Subsection
\lang english
SVN and Windows Environment
\end_layout
\begin_layout Quote
\lang english
My inclination is to say that if the user cannot figure out the command
line operations on their own fairly quickly, they would be well advised
to use TortoiseSVN.
---P.
A.
Rubin
\end_layout
\begin_layout Subsubsection
\lang english
Preparation
\end_layout
\begin_layout Standard
\lang english
In addition to installing LyX, and having access to a Subversion repository,
the user will need to install the Subversion client program.
A Windows installer for the client program is available from
\begin_inset CommandInset href
LatexCommand href
name "CollabNet"
target "http://www.collab.net/nonav/downloads/subversion/"
\end_inset
.
The user may also want to install
\begin_inset CommandInset href
LatexCommand href
name "TortoiseSVN"
target "http://tortoisesvn.tigris.org/"
\end_inset
, which integrates Subversion operations into the context (rightclick) menu
of Windows Explorer.
Operations done outside LyX will typically be more convenient using the
Explorer context menu.
Note that TortoiseSVN is not a replacement for the client program, which
is what LyX itself will use.
\end_layout
\begin_layout Subsubsection
\lang english
Bringing a document under Subversion control
\end_layout
\begin_layout Standard
\lang english
Before a LyX document can be brought under version control in Subversion,
its parent directory needs to be under version control.
If the document is being added to a project already in the repository,
this is accomplished by checking the project out to the directory where
the new document will be placed.
If the project itself is not yet under version control (for instance, if
this document starts a new project), the directory must be imported into
the repository.
This is done outside LyX.
Both import and checkout are easily accomplished from the Explorer context
menu using TortoiseSVN, or alternatively can be done using the command
line client at a DOS prompt.
The procedure for importing the project using TortoiseSVN is described
below, assuming an existing repository and a new project being started
in
\family typewriter
C:
\backslash
new project
\family default
.
For information on using the Subversion client program, run
\family typewriter
svn --help
\family default
in a DOS shell.
\end_layout
\begin_layout Enumerate
\lang english
Locate
\family typewriter
C:
\backslash
new project
\family default
in Windows Explorer, right click it, and select
\family typewriter
TortoiseSVN > Repo-browser
\family default
.
If necessary, adjust the URL for the repository, then click OK.
\end_layout
\begin_layout Enumerate
\lang english
Right click the level of the repository under which you want to place the
new project folder (typically the top level) and click
\family typewriter
Create folder\SpecialChar \ldots{}
\family default
Supply a name for the project folder and click OK.
Add a message for the log file if desired, then click OK again.
The new project folder should appear in the repository.
Finally, click OK again to exit the repository browser.
\end_layout
\begin_layout Enumerate
\lang english
Once again right click
\family typewriter
C:
\backslash
new project
\family default
, this time selecting SVN Checkout\SpecialChar \ldots{}
Select the URL of the project folder
you just created in the repository, and set the checkout directory to
\family typewriter
C:
\backslash
new project.
\family default
Click OK.
You will be warned about a non-empty folder; click OK to proceed.
You should now have a
\family typewriter
.svn
\family default
directory under
\family typewriter
C:
\backslash
new project.
\end_layout
\begin_layout Enumerate
\lang english
Create or open your document in LyX and click
\family sans
\bar under
F
\bar default
ile\SpecialChar \menuseparator
\bar under
V
\bar default
ersion
\begin_inset space ~
\end_inset
Control\SpecialChar \menuseparator
\bar under
R
\bar default
egister.
\family default
Add a log message and click OK to commit the document to version control.
\end_layout
\begin_layout Standard
\lang english
From this point onward, you should have full functionality in the
\family sans
\bar under
F
\bar default
ile\SpecialChar \menuseparator
\bar under
V
\bar default
ersion
\begin_inset space ~
\end_inset
Control
\family default
menu.
You also have the option of checking the document in and out, viewing its
history, etc.
using the TortoiseSVN context menu in Windows Explorer or the Subversion
client program from a command prompt.
\end_layout
\begin_layout Subsubsection
\lang english
SSH tunnel used with SVN under Windows
\end_layout
\begin_layout Standard
\lang english
Compared with Linux setting up svn client to communicate over ssh under
Windows is a rather troublesome task.
We will at least offer some hints how to setup the client side but prior
knowledge about ssh and the Windows command line is needed, also be prepared
for a great deal of frustration\SpecialChar \ldots{}
\end_layout
\begin_layout Enumerate
\lang english
Get a svn client for windows, as described in the previous sections.
When it is a fresh install run some svn command (e.g.
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
svn --version
\end_layout
\end_inset
) to create config files, which you will need to change later on.
\end_layout
\begin_layout Enumerate
\lang english
Choose a ssh client for Windows.
There are several possibilities, we will use the one from Putty tools
\begin_inset Foot
status open
\begin_layout Plain Layout
\lang english
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
\end_layout
\end_inset
\end_layout
\end_inset
.
You will need to set the connection up so that the client doesn't ask for
any password from you.
To keep things easy we will use only keys without any additional password
protection etc.
\end_layout
\begin_deeper
\begin_layout Enumerate
\lang english
Generate keys by
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
puttygen
\end_layout
\end_inset
.
Save your private .ppk key file and put the public one on the server side.
If the SVN server runs on Linux, note that the format of the public key
is not compatible with Linux openssh and you will need to direcly copy-paste
the key from the “
\emph on
Public key for pasting into OpenSSH authorized_keys file
\emph default
:” edit field into the server's
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
~/.ssh/authorized_keys
\end_layout
\end_inset
/
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
authorized_keys2
\end_layout
\end_inset
file.
\end_layout
\begin_layout Enumerate
\lang english
Get the Putty's
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
plink
\end_layout
\end_inset
.
In the SVN config file
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
Exact path depends on Windows version, usually somewhere around
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
c:
\backslash
Documents and Settings
\backslash
user
\backslash
Application Data
\backslash
Subversion
\backslash
config
\end_layout
\end_inset
/
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
AppData
\backslash
Roaming
\backslash
Subversion
\end_layout
\end_inset
.
\end_layout
\end_inset
, section [tunnels], setup ssh command, e.g.
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
ssh=c:/path/plink.exe -i c:/path/private_key.ppk
\end_layout
\end_inset
.
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
It will usually take a lot of time to get exact command right and it depends
on many things.
For example do not have some remote server saved as a default session in
Putty etc.
If things fail, try to connect via plink without SVN first.
\end_layout
\end_inset
\end_layout
\end_deeper
\begin_layout Enumerate
\lang english
Checkout the SVN archive, e.g.
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
svn co svn+ssh://user@server/repository_path
\end_layout
\end_inset
.
\end_layout
\begin_layout Subsubsection
\lang english
End-of-Line Conversions
\end_layout
\begin_layout Standard
\lang english
When the collsraborators are mixing Linux and Windows environments, LyX
will use different line endings inside the .lyx files.
This is not a problem as far as LyX functionality is concerned, but the
commit diffs will be huge and merge-conflicts prone.
Fortunately SVN itself knows
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
http://svnbook.red-bean.com/en/1.4/svn.advanced.props.file-portability.html
\end_layout
\end_inset
\end_layout
\end_inset
how to deal with CR/LF problems when switching .lyx files to the
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
native
\end_layout
\end_inset
mode.
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\lang english
For the lazy guys:
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
svn propset svn:eol-style native FILE_NAME
\end_layout
\end_inset
\end_layout
\end_inset
\end_layout
\begin_layout Subsection
\lang english
Further tuning
\end_layout
\begin_layout Standard
\lang english
With the recent addition of the vc-command function LyX power users are
allowed to create their own commands for revision control.
\end_layout
\begin_layout Standard
\lang english
As an example you can see how two TortoiseSVN commands could be integrated
directly:
\end_layout
\begin_layout Description
\lang english
Commit:
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
vc-command DR "." "TortoiseProc /command:commit /path:$$p"
\end_layout
\end_inset
\end_layout
\begin_layout Description
\lang english
Revert:
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
vc-command DR "." "TortoiseProc /command:revert /path:$$p"
\end_layout
\end_inset
\end_layout
\begin_layout Subsection
\lang english
Version control and Document comparison
\end_layout
\begin_layout Standard
\lang english
One of the typical uses of version control is to inspect the changes between
revisions, usually by creating
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
diff
\end_layout
\end_inset
dumps.
While this is useful for plain text files, it is much less useful in the
case of LyX files, which have more complicated structure.
Hence we provide binding to the Document comparison feature.
They are two ways of calling this feature - either by direct call of
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
VC_COMPARE
\end_layout
\end_inset
LyX function (for details see LyX functions manual) or by icon/menu item
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
Compare with older revision...
\end_layout
\end_inset
.
One can either compare two chosen revisions of the document or he can simply
compare the current version of edited text with older revisions (where
'
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
0
\end_layout
\end_inset
' revisions back means comparison of the edited file with last commited
revision).
\end_layout
\begin_layout Standard
\lang english
This feature is supported for SVN and RCS though due to the more complicated
versioning scheme of RCS there is a constraint -- when addressing the revisions
in dialog, numbers always point to the last number in RCS revision number,
i.e.
'35' in '1.2.35'.
\end_layout
\begin_layout Section
Programmation littéraire
\end_layout
\begin_layout Standard
Mise à jour par
\noun on
Kayvan Sylvan
\noun default
(kayvan@sylvan.com), document d'origine écrit par
\noun on
Edmar Wienskoski Jr.
\noun default
(edmar-w-jr@technologist.com)
\end_layout
\begin_layout Subsection
Introduction
\end_layout
\begin_layout Standard
Le but principal de cette documentation est de montrer comment utiliser
LyX pour la programmation littéraire.
Nous supposerons que vous êtes familiers de cette technique de programmation,
et savez donc ce que
\begin_inset Quotes fld
\end_inset
tangling
\begin_inset Quotes frd
\end_inset
et
\begin_inset Quotes fld
\end_inset
weaving
\begin_inset Quotes frd
\end_inset
signifient
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT : Respectivement la génération du code et de la documentation.
ar
\end_layout
\end_inset
.
Si ce n'est pas le cas, veuillez lire les pages web dont les adresses sont
indiquées un peu plus loin.
Vous y trouverez une bonne documentation, allant de l'histoire du développement
aux derniers trucs et astuces.
\end_layout
\begin_layout Standard
Nous supposerons aussi que vous êtes assez familiarisés avec LyX pour pouvoir
changer vos préférences, et le fichier de ressources X.
Si ce n'est pas le cas, voyez le reste de la documentation de LyX qui couvre
ces domaines.
\end_layout
\begin_layout Subsection
La programmation littéraire
\end_layout
\begin_layout Standard
Extrait de la FAQ de la Programmation Littéraire :
\end_layout
\begin_layout Quotation
La programmation littéraire est la combinaison de la documentation et des
sources en une forme lisible par un être humain.
En fait, la programmation littéraire doit être agréable à lire, et même
aguicheuse ! (Désolé, Bob, je n'ai pas pu résister...) En général, la programmatio
n littéraire combine la source et la documentation dans un seul et unique
fichier.
Des outils de programmation littéraire permettent ensuite de produire séparémen
t le fichier source et la documentation.
Le style WEB de programmation littéraire fut créé par D.E.
Knuth lors du développement de son logiciel de typographie, TeX.
\end_layout
\begin_layout Standard
Un autre extrait :
\end_layout
\begin_layout Quotation
\emph on
En quoi la programmation littéraire diffère-t-elle du commentaire ?
\end_layout
\begin_layout Quotation
Il y a trois signes distinctifs qui sont, dans l'ordre d'importance :
\end_layout
\begin_deeper
\begin_layout Itemize
un ordre d'élaboration flexible
\end_layout
\begin_layout Itemize
le support automatique pour la visualisation
\end_layout
\begin_layout Itemize
une documentation mise en forme, notamment les diagrammes et les mathématiques
\end_layout
\end_deeper
\begin_layout Standard
Maintenant que j'ai éveillé votre curiosité, voyons les références :
\end_layout
\begin_layout Subsubsection
Références
\end_layout
\begin_layout Standard
La FAQ complète de la Programmation Littéraire se trouve à :
\end_layout
\begin_layout Quote
FAQ de la Programmation Littéraire
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
http://shelob.ce.ttu.edu/daves/lpfaq/faq.html
\end_layout
\end_inset
\end_layout
\begin_layout Standard
La FAQ dénombre 23 (vingt-trois !) outils différents pour la programmation
littéraire.
Certains sont spécialisés pour certains langages de programmation, d'autre
ont une portée plus générale.
J'ai sélectionné
\family typewriter
NoWeb
\family default
\noun toggle
pour mon usage personnel pour plusieures raisons :
\end_layout
\begin_layout Itemize
Il sait générer la documentation aussi bien en LaTeX qu'en HTML.
\end_layout
\begin_layout Itemize
Il a une architecture ouverte, c'est-à-dire qu'il est facile d'y ajouter
de nouveaux filtres et de réaliser des opérations spéciales au besoin.
\end_layout
\begin_layout Itemize
Un grand nombre de filtres est déjà disponible (dont celui pour le HTML).
\end_layout
\begin_layout Itemize
Il est libre.
\end_layout
\begin_layout Standard
La page web de Noweb se trouve à :
\end_layout
\begin_layout Quote
Page d'accueil de Noweb
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
http://www.cs.virginia.edu/~nr/noweb/
\end_layout
\end_inset
\end_layout
\begin_layout Standard
À partir de là, vous trouverez de nombreux liens intéressants et mêmes quelques
exemples de programmation littéraire.
\end_layout
\begin_layout Subsection
LyX et la Programmation Littéraire
\end_layout
\begin_layout Standard
LyX supporte la Programmation Littéraire par l'intermédiaire du mécanisme
de gestion des convertisseurs.
Ce support est
\begin_inset Quotes fld
\end_inset
indépendant de Noweb
\begin_inset Quotes frd
\end_inset
, c'est-à-dire que vous pourrez utiliser cette nouvelle fonction de LyX
avec un autre outil de programmation littéraire de votre choix, en changeant
juste vos préférences LyX.
\end_layout
\begin_layout Subsubsection
Génération des documents et du code (weaving and tangling)
\end_layout
\begin_layout Paragraph
Sélection de la classe de document
\end_layout
\begin_layout Standard
Si vous avez installé Noweb et LyX avec succès, vous devez trouver trois
nouvelles classes de document :
\end_layout
\begin_layout Itemize
\family sans
Article
\begin_inset space ~
\end_inset
(Noweb)
\end_layout
\begin_layout Itemize
\family sans
Book
\begin_inset space ~
\end_inset
(Noweb)
\end_layout
\begin_layout Itemize
\family sans
Report
\begin_inset space ~
\end_inset
(Noweb)
\end_layout
\begin_layout Standard
Il vous faut sélectionner l'une d'entre elles pour créer votre document
littéraire.
\end_layout
\begin_layout Standard
Remarquez bien que les documents littéraires ne sont pas limités à ces trois
classes.
De nouvelles classes peuvent être générées à partir d'autres styles, comme
les lettres, ou à partir d'autres variantes d'une classe, comme
\family sans
Article
\begin_inset space ~
\end_inset
(AMS)
\family default
.
Si vous avez des besoins particuliers qui ne peuvent être couverts par
ces classes, faites-le savoir à la liste de diffusion des développeurs
de LyX
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
lyx-devel@lists.lyx.org
\end_layout
\end_inset
et nous nous arrangerons pour ajouter une nouvelle entrée, ou vous expliquer
comment le faire vous-même
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
C'est très simple, ça ne demande que la création d'un fichier de quatre
lignes, et la relance de l'auto-configuration.
\end_layout
\end_inset
.
De plus, si vous utilisez un outil littéraire autre que Noweb, vous voudrez
peut-être créer un nouvel ensemble de classes de document prévues pour.
\end_layout
\begin_layout Paragraph
Ajout de code
\end_layout
\begin_layout Standard
LyX vous permet d'entrer du code par l'intermédiaire d'un format nommé
\family sans
Scrap
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\family sans
\noun on
Le terme équivalent sous Noweb est
\begin_inset Quotes fld
\end_inset
Chunk
\begin_inset Quotes frd
\end_inset
.
Pour des raisons historiques, j'ai gardé le terme
\begin_inset Quotes fld
\end_inset
scrap
\begin_inset Quotes frd
\end_inset
d'un autre outil littéraire appelé Nuweb, que j'ai utilisé bien des années
avant de me convertir à Noweb.
\end_layout
\end_inset
\family default
.
Noweb délimite les scraps ainsi :
\end_layout
\begin_layout LyX-Code
<<Mon scrap>>=
\end_layout
\begin_layout LyX-Code
code
\end_layout
\begin_layout LyX-Code
encore du code
\end_layout
\begin_layout LyX-Code
toujours du code
\end_layout
\begin_layout LyX-Code
@
\end_layout
\begin_layout Standard
Le problème est que tout ce qui est compris entre le
\family typewriter
<<
\family default
et l'arobase
\family typewriter
@
\family default
doit être pris tel quel, c'est-à-dire que LyX ne doit faire aucune interprétati
on de ce qui a été écrit.
C'est géré par un environnement spécial appelé
\family sans
Scrap
\family default
, qui fonctionne comme un paragraphe normal mais qui présente une totale
liberté en ce qui concerne l'espacement.
\end_layout
\begin_layout Standard
L'inconvénient de l'environnement de paragraphe
\family sans
Scrap
\family default
est que des paragraphes consécutifs de code vont être séparés par une ligne
vide dans le code source et dans la documentation imprimée.
Pour éviter ça, il faut donc, dans un
\family sans
Scrap
\family default
donné, finir chaque ligne de code par un saut de ligne (
\family sans
C-Entrée
\family default
) et non un
\family sans
Entrée
\family default
normal.
L'exemple ci-dessus donnera donc
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Sur un document imprimé, il n'y a aucune différence entre cet exemple et
le précédent.
\end_layout
\end_inset
:
\end_layout
\begin_layout LyX-Code
<<Mon scrap>>=
\begin_inset Newline newline
\end_inset
code
\begin_inset Newline newline
\end_inset
encore du code
\begin_inset Newline newline
\end_inset
toujours du code
\begin_inset Newline newline
\end_inset
@
\end_layout
\begin_layout Standard
Cet environnement fonctionne bien.
Le seul réel inconvénient est de devoir taper
\family sans
C-Entrée
\family default
et non un simple
\family sans
Entrée
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Régler ce problème fait partie de la liste des améliorations à apporter.
\end_layout
\end_inset
\family default
.
\end_layout
\begin_layout Standard
Il est à noter que vous pouvez aussi utiliser la construction
\family typewriter
\begin_inset Quotes fld
\end_inset
%def
\begin_inset Quotes frd
\end_inset
\family default
de Noweb dans vos scraps pour ajouter des éléments de référence croisée
:
\end_layout
\begin_layout LyX-Code
<<Mon scrap>>=
\begin_inset Newline newline
\end_inset
def une_fonction(param):
\begin_inset Newline newline
\end_inset
"C'est la documentation de cette fonction."
\begin_inset Newline newline
\end_inset
print "Mes paramètres : ", param
\end_layout
\begin_layout LyX-Code
@ %def une_fonction
\end_layout
\begin_layout Standard
Pour avoir un exemple de cette construction et des références croisées engendrée
s, regardez le programme littéraire python dans
\family typewriter
\emph on
LIBDIR
\emph default
/examples/listerrors.lyx
\family default
qui devrait clarifier tout ça.
\end_layout
\begin_layout Paragraph
Génération de la documentation
\end_layout
\begin_layout Standard
Arrivé ici, vous avez déjà un nouveau fichier avec sa propre classe de document,
et vous avec tapé un peu de code et de texte dedans.
Bien ; et maintenant, comment je l'imprime ? La réponse est simple : vous
faites
\family sans
Visionner\SpecialChar \menuseparator
DVI
\family default
, etc.
comme vous le feriez pour un document quelconque.
Il n'y a aucune procédure particulière.
\end_layout
\begin_layout Standard
Pour vous aider à vous y retrouver, je vais vous expliquer ce qui se passe
à l'intérieur de LyX :
\end_layout
\begin_layout Enumerate
Quand vous choisissez
\family sans
Visionner\SpecialChar \menuseparator
Mise
\begin_inset space ~
\end_inset
à
\begin_inset space ~
\end_inset
Jour\SpecialChar \menuseparator
DVI
\family default
, un fichier LaTeX est généré.
\end_layout
\begin_deeper
\begin_layout Standard
Si le document est d'un type littéraire, le fichier généré sera nommé avec
l'extension définie par le format
\begin_inset Quotes fld
\end_inset
littéraire
\begin_inset Quotes frd
\end_inset
(défini dans la fenêtre de
\family sans
Préférences
\family default
), sinon le fichier aura l'extension habituelle
\family typewriter
.tex
\family default
.
\end_layout
\end_deeper
\begin_layout Enumerate
Remarquez que la seule différence est cette extension : LyX n'a rien de
particulier à faire.
Tant que vous avez utilisé l'environnement
\family sans
Scrap
\family default
en entrant le texte, tout se passera sans problème.
\end_layout
\begin_layout Enumerate
Si le document est d'une classe littéraire, LyX utilisera ensuite le convertisse
ur interne LyX vers Noweb, suivi par le convertisseur Noweb vers LaTeX
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Les convertisseurs sont définis dans la fenêtre
\family sans
Éditer\SpecialChar \menuseparator
Préférences
\family default
, dans l'onglet
\family sans
Conversion
\family default
.
\end_layout
\end_inset
pour générer le fichier LaTeX
\end_layout
\begin_deeper
\begin_layout Standard
Sinon, il saute simplement cette étape.
\end_layout
\end_deeper
\begin_layout Enumerate
Enfin, LaTeX est invoqué et le processus continue comme s'il s'agissait
d'un document quelconque.
\end_layout
\begin_layout Standard
Vous êtes donc indépendant d'un
\begin_inset Quotes fld
\end_inset
outil littéraire
\begin_inset Quotes frd
\end_inset
donné, car vous pouvez changer les commandes correspondant aux différents
convertisseurs.
\end_layout
\begin_layout Paragraph
Génération du code
\end_layout
\begin_layout Standard
Quand on demande de
\family sans
Compiler
\family default
dans les menus, ou quand on appuie sur le bouton correspondant de la barre
d'outils, un fichier LaTeX est généré comme dans l'étape
\begin_inset space ~
\end_inset
1 ci-dessus.
LyX invoque ensuite le convertisseur
\family typewriter
NoWeb->Program
\family default
.
Celui-ci (comme tout convertisseur) est invoqué en deux parties :
\end_layout
\begin_layout Enumerate
Le programme de conversion proprement dit.
Ce programme procède à la conversion d'un format à un autre (ici, du format
\family typewriter
NoWeb
\family default
au pseudo-format
\family typewriter
Program
\family default
).
\end_layout
\begin_layout Enumerate
Le filtre de messages d'erreur.
C'est un programme dont le seul rôle est de réécrire les messages d'erreur
dans un format compréhensible par LyX.
Ça permet à LyX de placer des boîtes d'erreur au bon endroit dans le tampon
du fichier.
\end_layout
\begin_layout Standard
La première partie, déterminée par le champ
\family sans
Convertisseur
\family default
, doit contenir
\family typewriter
\begin_inset Quotes fld
\end_inset
build-script $$i
\begin_inset Quotes frd
\end_inset
\family default
.
Ça signifie que LyX va appeler
\family typewriter
build-script
\family default
(un programme ou un script) avec le nom du fichier Noweb (en général un
fichier dans le répertoire temporaire de LyX).
\end_layout
\begin_layout Standard
Voici une implémentation de
\family typewriter
build-script
\family default
que vous pouvez mettre dans un répertoire de votre chemin d'accès par défaut
:
\end_layout
\begin_layout LyX-Code
#!/bin/sh
\end_layout
\begin_layout LyX-Code
#
\end_layout
\begin_layout LyX-Code
notangle -Rbuild-script $1 | env NOWEB_SOURCE=$1 sh
\end_layout
\begin_layout Standard
L'autre partie de la définition du convertisseur est le champ
\family sans
Autres
\begin_inset space ~
\end_inset
Options
\family default
qui doit contenir
\family typewriter
\begin_inset Quotes fld
\end_inset
originaldir,parselog=listerrors
\begin_inset Quotes frd
\end_inset
\family default
.
Ça fera passer toutes les erreurs générées par
\family typewriter
build-script
\family default
à travers le programme
\family typewriter
listerrors
\family default
.
\end_layout
\begin_layout Standard
La gestion des convertisseurs cherche le programme
\family typewriter
listerrors
\family default
d'abord dans
\family typewriter
\emph on
MON_RÉPERTOIRE_LYX
\emph default
/scripts
\family default
, puis dans
\family typewriter
\emph on
LIBDIR
\emph default
/scripts
\family default
puis dans le chemin d'accès par défaut.
\end_layout
\begin_layout Paragraph
Instructions de compilation dans le document
\end_layout
\begin_layout Standard
La dernière partie de l'interface entre LyX et noweb est le scrap
\begin_inset Quotes fld
\end_inset
build-script
\begin_inset Quotes frd
\end_inset
.
En général, les instructions de compilation de votre programme doivent
être regroupées dans un scrap à part.
Le
\family typewriter
build-script
\family default
vu plus haut est spécifique à noweb et utilise la commande
\family typewriter
notangle
\family default
pour rechercher ce scrap (appelé
\begin_inset Quotes fld
\end_inset
build-script
\begin_inset Quotes frd
\end_inset
) et passer son contenu dans
\family typewriter
sh
\family default
.
\end_layout
\begin_layout Standard
Typiquement, un tel scrap ressemble à ceci :
\end_layout
\begin_layout LyX-Code
<<build-script>>=
\begin_inset Newline newline
\end_inset
#!/bin/sh
\begin_inset Newline newline
\end_inset
\begin_inset Newline newline
\end_inset
if [ -z "${NOWEB_SOURCE}" ]
\begin_inset Newline newline
\end_inset
then
\begin_inset Newline newline
\end_inset
NOWEB_SOURCE=mon_fichier.nw
\begin_inset Newline newline
\end_inset
fi
\begin_inset Newline newline
\end_inset
[...
code pour extraire les fichiers ...]
\begin_inset Newline newline
\end_inset
[...
code pour compiler les fichiers ...]
\begin_inset Newline newline
\end_inset
@
\end_layout
\begin_layout Standard
Voyez dans
\family typewriter
\emph on
LIBDIR
\emph default
/examples/listerrors.lyx
\family default
ou dans
\family typewriter
\emph on
LIBDIR
\emph default
/examples/Literate.lyx
\family default
qui implémentent deux versions du programme
\family typewriter
listerrors
\family default
pour avoir des exemples de comment tout cela va ensemble.
Vous pouvez encore consulter
\family typewriter
\emph on
LIBDIR
\emph default
/examples/noweb2lyx.lyx
\family default
.
Il est intéressant de constater que ces trois fichiers démontrent l'indépendanc
e de LyX relativement au langage de programmation littéraire adopté car
ils sont écrits respectivement en Python, C et Perl.
\end_layout
\begin_layout LyX-Code
\end_layout
\begin_layout Subsubsection
Configurer LyX
\end_layout
\begin_layout Standard
Vous pouvez configurer ce qui concerne la Programmation Littéraire dans
l'onglet
\family sans
Conversion
\family default
de la fenêtre
\family sans
Éditer\SpecialChar \menuseparator
Préférences
\family default
.
Les parties importantes sont :
\end_layout
\begin_layout Description
le
\begin_inset space ~
\end_inset
format
\begin_inset space ~
\end_inset
\begin_inset Quotes fld
\end_inset
littéraire
\begin_inset Quotes frd
\end_inset
Choisi dans l'onglet
\family sans
Formats
\family default
, où vous mettez ce qui est spécifique à Noweb.
Le
\family sans
Nom
\begin_inset space ~
\end_inset
d'interface
\family default
est
\family typewriter
\begin_inset Quotes fld
\end_inset
NoWeb
\begin_inset Quotes frd
\end_inset
\family default
, l'
\family sans
Extension
\family default
est
\family typewriter
\begin_inset Quotes fld
\end_inset
nw
\begin_inset Quotes frd
\end_inset
\family default
.
LyX créera donc un fichier d'extension
\family typewriter
.nw
\family default
lors de la première étape du processus de conversion.
\end_layout
\begin_layout Description
le
\begin_inset space ~
\end_inset
format
\begin_inset space ~
\end_inset
\family sans
Programme
\family default
C'est un format fictif dont le seul but est d'être le point d'arrivée d'une
conversion (ce qui permet ainsi de mettre en place un convertisseur pointant
vers lui).
\end_layout
\begin_layout Description
\family sans
NoWeb
\family default
->
\family sans
LaTeX
\family default
Ce convertisseur assure la génération de la documentation (
\begin_inset Quotes fld
\end_inset
weaving
\begin_inset Quotes frd
\end_inset
).
Pour Noweb, il faut mettre
\family typewriter
\begin_inset Quotes fld
\end_inset
noweave -delay -index $$i > $$o
\begin_inset Quotes frd
\end_inset
\end_layout
\begin_layout Description
\family sans
NoWeb
\family default
->
\family sans
Program
\family default
Celui-ci assure la génération du code (
\begin_inset Quotes fld
\end_inset
tangling
\begin_inset Quotes frd
\end_inset
).
Comme vu plus haut, il faut mettre
\family typewriter
\begin_inset Quotes fld
\end_inset
build-script $$i
\begin_inset Quotes frd
\end_inset
\family default
, avec comme
\family sans
Autres
\begin_inset space ~
\end_inset
Options
\family default
\family typewriter
\begin_inset Quotes fld
\end_inset
originaldir,parselog=listerrors
\begin_inset Quotes frd
\end_inset
\family default
.
\end_layout
\begin_layout Subsubsection
Fonctions pour le déboguage
\end_layout
\begin_layout Standard
Une nouvelle fonction est aussi implémentée dans le serveur LyX, la fonction
\begin_inset Quotes fld
\end_inset
serveur va à la bonne ligne
\begin_inset Quotes frd
\end_inset
que l'on utilisera avec
\family typewriter
ddd
\family default
/
\family typewriter
gdb
\family default
ou un autre débogueur.
\end_layout
\begin_layout Standard
Lorsque vous déboguez du code avec
\family typewriter
ddd
\family default
/
\family typewriter
gdb
\family default
, il est possible d'appeler un éditeur de texte à la position actuelle d'exécuti
on, avec un seul appui clavier.
La configuration par défaut de
\family typewriter
ddd
\family default
est
\family sans
Shift-Ctrl-V
\family default
.
Il se trouve que vous pouvez choisir l'éditeur appelé par
\family typewriter
ddd
\family default
dans la fenêtre
\family sans
Éditer\SpecialChar \menuseparator
Préférences\SpecialChar \menuseparator
Helpers
\family default
en changeant l'entrée
\family sans
Edit
\begin_inset space ~
\end_inset
Sources
\family default
.
\end_layout
\begin_layout Standard
J'ai trouvé avantageux d'utiliser LyX avec
\family typewriter
ddd
\family default
en réglant
\family sans
Edit
\begin_inset space ~
\end_inset
Sources
\family default
sur :
\end_layout
\begin_layout LyX-Code
echo "LYXCMD:monitor:server-goto-file-row:@FILE@ @LINE@" >~/.lyxpipe.in
\end_layout
\begin_layout Standard
Ainsi, quand vous utilisez
\family typewriter
ddd
\family default
et que vous vous apercevez qu'il faut modifier le code, vous pressez juste
\family sans
Shift-Ctrl-V
\family default
(dans la fenêtre
\family typewriter
ddd
\family default
), et
\family typewriter
ddd
\family default
renvoie cette information à LyX via le serveur LyX.
La fenêtre LyX montrera le fichier en question, avec le curseur pile poil
là où se trouvait
\family typewriter
ddd
\family default
.
Plus besoin de jouer aux devinettes ou de faire défiler tout le document
pour savoir où se situait le problème !
\end_layout
\begin_layout Standard
Notez cependant qu'il vous faut activer cette fonction du serveur LyX, inactive
par défaut.
Pour cela, allez dans
\family sans
Outils\SpecialChar \menuseparator
Préférences\SpecialChar \menuseparator
Répertoires
\family default
et mettez un chemin du genre
\family typewriter
\begin_inset Quotes fld
\end_inset
/home/<votre-réperoire-home>/\SpecialChar \-
.lyx/lyxpipe
\begin_inset Quotes frd
\end_inset
\family default
dans le champ
\family sans
Tubes du Serveur LyX
\family default
.
\end_layout
\begin_layout Standard
Lisez la documentation sur le serveur LyX dans le manuel de
\emph on
Personnalisation
\emph default
pour plus d'information.
\end_layout
\begin_layout Subsubsection
Ajouts à la barre d'outils
\end_layout
\begin_layout Standard
Il y a six nouveaux boutons qui peuvent être ajoutés à la barre d'outils
de LyX.
Cinq de ces boutons sont des raccourcis vers les styles
\family sans
Standard
\family default
,
\family sans
Section
\family default
,
\family sans
LaTeX
\family default
,
\family sans
LyX-Code
\family default
et
\family sans
Scrap
\family default
.
Le dernier bouton est un raccourci vers la commande
\begin_inset Quotes fld
\end_inset
Compiler
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Standard
LyX a tout une série de boutons qui peuvent être intégrés dans la barre
d'outils.
Personnellement, j'ai combiné les six raccourcis ci-dessus avec deux autres
: un pour
\family sans
Visionner\SpecialChar \menuseparator
Mise
\begin_inset space ~
\end_inset
à
\begin_inset space ~
\end_inset
Jour\SpecialChar \menuseparator
DVI
\family default
et un autre pour
\family sans
Visionner\SpecialChar \menuseparator
DVI
\family default
.
Voilà comment cela se présente :
\end_layout
\begin_layout LyX-Code
Toolbar
\end_layout
\begin_layout LyX-Code
Layouts
\end_layout
\begin_layout LyX-Code
Icon "layout Standard"
\end_layout
\begin_layout LyX-Code
Icon "layout Section"
\end_layout
\begin_layout LyX-Code
Icon "layout LaTeX"
\end_layout
\begin_layout LyX-Code
Icon "layout LyX-Code"
\end_layout
\begin_layout LyX-Code
Icon "layout Scrap"
\end_layout
\begin_layout LyX-Code
Separator
\end_layout
\begin_layout LyX-Code
Icon "buffer-view"
\end_layout
\begin_layout LyX-Code
Icon "buffer-typeset"
\end_layout
\begin_layout LyX-Code
Icon "build-program"
\end_layout
\begin_layout LyX-Code
Separator
\end_layout
\begin_layout LyX-Code
.
\end_layout
\begin_layout LyX-Code
.
\end_layout
\begin_layout LyX-Code
.
\end_layout
\begin_layout LyX-Code
End
\end_layout
\begin_layout Subsubsection
Couleurs personnalisées
\end_layout
\begin_layout Standard
Un certain nombre de couleurs de LyX peuvent être personnalisées dans la
fenêtre
\family sans
Préférences
\family default
.
Une des choses qui ennuient nombre d'entre nous est la couleur du code
LaTeX.
La couleur par défaut est le rouge, or les scraps utilisent la police LaTeX,
et comme il y a beaucoup de scraps dans un document de programmation littéraire
, vous en aurez sûrement marre de tout voir en rouge.
Vous pouvez la changer dans l'onglet
\family sans
Apparence\SpecialChar \menuseparator
Couleurs
\family default
.
\end_layout
\begin_layout Standard
Le problème suivant est la présence visible des caractères
\begin_inset Quotes fld
\end_inset
nouvelle ligne
\begin_inset Quotes frd
\end_inset
sur l'écran.
Vous pouvez aussi choisir la couleur de ces caractères particuliers et
donc les faire se confondre avec le fond.
Je vous conseille de choisir une couleur qui est proche de celle du fond,
mais pas la même : vous pourrez toujours les voir, mais ils ne vous dérangeront
plus.
\end_layout
\begin_layout Chapter
Secrets des Maîtres du LaTeX
\begin_inset CommandInset label
LatexCommand label
name "cha:secrets"
\end_inset
\end_layout
\begin_layout Standard
Même si LyX est un outil puissant, il ne faut pas s'attendre à ce qu'il
puisse supporter tout ce qui peut être fait avec TeX ou LaTeX.
Cependant, la plupart des trucs et astuces de TeX et LaTeX peuvent resservir
dans LyX, à condition de ne pas avoir peur d'utiliser le bouton
\begin_inset Quotes fld
\end_inset
TeX
\begin_inset Quotes frd
\end_inset
de la barre d'outils ou d'ajouter des lignes au préambule LaTeX.
Cette section présente un ensemble de conseils, d'astuces et d'idées sympa
pour donner un petit quelque chose en plus à votre document.
\emph on
Mais essayez-les à la maison !
\emph default
\emph toggle
Faites vos premières tentatives sur quelque chose de plus court et de moins
important que votre thèse !
\end_layout
\begin_layout Standard
La plupart des idées présentées dans cette section requièrent des fichiers
un peu moins courants dans les installations LaTeX.
Si vous avez un système comme teTeX, la plupart seront sûrement présents.
Certains, cependant, devront être téléchargés sur les archives CTAN.
Il y a souvent plusieures manières de faire la même chose, ou plusieurs
fichiers de style LaTeX qui ont le même rôle.
Nous ne recommandons pas une méthode plutôt qu'une autre, nous affirmons
simplement que tel fichier permet de faire telle chose.
Enfourchez votre destrier, ceignez votre heaume et lancez-vous !
\end_layout
\begin_layout Section
MultiColonnes
\end_layout
\begin_layout Standard
par
\noun on
Lars Gullik Bjønnes
\end_layout
\begin_layout Subsection
But
\end_layout
\begin_layout Standard
Le but de ce chapitre
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Note de l'Éditeur : Le chapitre original de Lars était une magistrale descriptio
n de comment utiliser le paquetage
\family typewriter
multicol
\family default
.
Il était cependant trop long pour s'insérer sans heurt dans ce document.
J'ai donc choisi d'en extraire ici les sections les plus importantes (désolé,
Lars) ; vous pouvez lire le chapitre original (et un peu plus de l'histoire
!) dans le fichier exemple
\family typewriter
examples/fr/MultiColonnes.lyx
\family default
.
mer
\end_layout
\end_inset
est de montrer comment utiliser le paquetage LaTeX
\family typewriter
multicol
\family default
dans un document LyX.
Comme LyX ne le supporte pas encore d'origine, il faut utiliser quelques
trucs, qui devraient vous paraître clairs quand vous aurez lu cette section.
\end_layout
\begin_layout Subsection
Limitations
\end_layout
\begin_layout Standard
Le paquetage
\family typewriter
multicol
\family default
permet de basculer dans une même page entre le format sur une colonne et
sur plusieurs.
Les notes de bas de page sont gérées correctement (pour la plus grande
part), mais seront placées en bas de la page et non en bas de chaque colonne.
Le mécanisme de gestion des flottants de LaTeX, cependant, est partiellement
désactivé dans l'implémentation actuelle.
Aujourd'hui seuls des flottants couvrant en largeur toute la page peuvent
être utilisés au sein de l'environnement.
\end_layout
\begin_layout Subsection
Exemples
\end_layout
\begin_layout Subsubsection
Deux Colonnes
\end_layout
\begin_layout Standard
Si vous voulez avoir deux colonnes dans votre texte, il faut pour insérer
\family typewriter
\backslash
begin{multicols}{2}
\family default
en mode LaTeX à l'endroit où vous voulez démarrer la disposition en deux
colonnes, et
\family typewriter
\backslash
end{multicols}
\family default
là où vous voulez qu'elle se termine.
Comme ceci
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT : Les lecteurs anglophobes me pardonneront, mais je ne me lance pas
à traduire des passages de Sherlock Holmes.
:-) of
\end_layout
\end_inset
:
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
begin{multicols}{2}
\end_layout
\end_inset
\end_layout
\begin_layout Standard
\noindent
\series bold
\size small
The Adventure of the Empty House
\series default
\begin_inset Newline newline
\end_inset
by
\noun on
Sir Arthur Conan Doyle
\end_layout
\begin_layout Standard
\size small
It was in the spring of the year 1894 that all London was interested, and
the fashionable world dismayed, by the murder of the Honourable Ronald
Adair under most unusual and inexplicable circumstances.
The public has already learned those particulars of the crime which came
out in the police investigation, but a good deal was suppressed upon that
occasion, since the case for the prosecution was so overwhelmingly strong
that it was not necessary to bring forward all the facts.
Only now, at the end of nearly ten years, am I allowed to supply those
missing links which make up the whole of that remarkable chain.
The crime was of interest in itself, but that interest was as nothing to
me compared to the inconceivable sequel, which afforded me the greatest
shock and surprise of any event in my adventurous life.
Even now, after this long interval, I find myself thrilling as I think
of it, and feeling once more that sudden flood of joy, amazement, and increduli
ty which utterly submerged my mind.
Let me say to that public, which has shown some interest in those glimpses
which I have occasionally given them of the thoughts and actions of a very
remarkable man, that they are not to blame me if I have not shared my knowledge
with them, for I should have considered it my first duty to do so, had
I not been barred by a positive prohibition from his own lips, which was
only withdrawn upon the third of last month.
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
end{multicols}
\end_layout
\end_inset
\end_layout
\begin_layout Subsubsection
Colonnes Multiples
\end_layout
\begin_layout Standard
Le même schéma s'applique si vous voulez plus de deux colonnes.
(Vous pouvez avoir plus de 3 colonnes si vous voulez, mais ça risque de
ne pas être très agréable à regarder.)
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
begin{multicols}{3}
\end_layout
\end_inset
\end_layout
\begin_layout Standard
\size footnotesize
It can be imagined that my close intimacy with Sherlock Holmes had interested
me deeply in crime, and that after his disappearance I never failed to
read with care the various problems which came before the public.
And I even attempted, more than once, for my own private satisfaction,
to employ his methods in their solution, though with indifferent success.
There was none, however, which appealed to me like this tragedy of Ronald
Adair.
As I read the evidence at the inquest, which led up to a verdict of willful
murder against some person or persons unknown, I realized more clearly
than I had ever done the loss which the community had sustained by the
death of Sherlock Holmes.
There were points about this strange business which would, I was sure,
have specially appealed to him, and the efforts of the police would have
been supplemented, or more probably anticipated, by the trained observation
and the alert mind of the first criminal agent in Europe.
All day, as I drove upon my round, I turned over the case in my mind and
found no explanation which appeared to me to be adequate.
At the risk of telling a twice-told tale, I will recapitulate the facts
as they were known to the public at the conclusion of the inquest.
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
end{multicols}
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Vous pouvez sans problème avoir plus de 3 colonnes, si vous le voulez, mais
ce n'est plus très agréable à lire.
\end_layout
\begin_layout Subsubsection
Des Colonnes dans une Colonne
\end_layout
\begin_layout Standard
Vous pouvez même avoir des colonnes dans une colonne :
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
begin{multicols}{2}
\end_layout
\end_inset
\end_layout
\begin_layout Standard
\size footnotesize
The Honourable Ronald Adair was the second son of the Earl of Maynooth,
at that time governor of one of the Australian colonies.
Adair's mother had returned from Australia to undergo the operation for
cataract, and she, her son Ronald, and her daughter Hilda were living together
at 427 Park Lane.
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
begin{multicols}{2}
\end_layout
\end_inset
\end_layout
\begin_layout Standard
\size footnotesize
The youth moved in the best societyhad, so far as was known, no enemies
and no particular vices.
He had been engaged to Miss Edith Woodley, of Carstairs, but the engagement
had been broken off by mutual consent some months before, and there was
no sign that it had left any very profound feeling behind it.
For the rest {sic} the man's life moved in a narrow and conventional circle,
for his habits were quiet and his nature unemotional.
Yet it was upon this easy-going young aristocrat that death came, in most
strange and unexpected form, between the hours of ten and eleven-twenty
on the night of March 30, 1894.
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
end{multicols}
\end_layout
\end_inset
\end_layout
\begin_layout Standard
\size footnotesize
Ronald Adair was fond of cardsplaying continually, but never for such stakes
as would hurt him.
He was a member of the Baldwin, the Cavendish, and the Bagatelle card clubs.
It was shown that, after dinner on the day of his death, he had played
a rubber of whist at the latter club.
He had also played there in the afternoon.
\size default
\size footnotesize
The evidence of those who had played with him Mr.
Murray, Sir John Hardy, and Colonel Moranshowed that the game was whist,
and that there was a fairly equal fall of the cards.
Adair might have lost five pounds, but not more.
His fortune was a considerable one, and such a loss could not in any way
affect him.
He had played nearly every day at one club or other, but he was a cautious
player, and usually rose a winner.
It came out in evidence that, in partnership with Colonel Moran, he had
actually won as much as four hundred and twenty pounds in a sitting, some
weeks before, from Godfrey Milner and Lord Balmoral.
So much for his recent history as it came out at the inquest.
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
end{multicols}
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Veuillez lire le fichier
\family typewriter
example/fr/MultiColonnes.lyx
\family default
pour des exemples plus complexes avec l'espacement des colonnes et de l'en-tête
, les lignes de séparation verticale, et plus encore.
\end_layout
\begin_layout Section
Numérotation dans l'environnement de paragraphe
\family sans
Énumération
\begin_inset Argument
status collapsed
\begin_layout Plain Layout
Numérotation dans les
\family sans
Énumérations
\end_layout
\end_inset
\end_layout
\begin_layout Standard
par
\noun on
John Weiss
\end_layout
\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset
\end_layout
\begin_layout Standard
La numérotation par défaut dans l'environnement de paragraphe
\family sans
Énumération
\family default
commence par les chiffres arabes et finit par les lettres majuscules.
Supposons cependant que vous vouliez un autre schéma de numérotation.
Voici un rapide exemple de ce qu'il vous faudra écrire :
\end_layout
\begin_layout LyX-Code
\backslash
renewcommand{
\backslash
labelenumi}{
\backslash
Romain{enumi}.}
\end_layout
\begin_layout LyX-Code
\backslash
renewcommand{
\backslash
labelenumii}{
\backslash
Alph{enumii}.}
\end_layout
\begin_layout LyX-Code
\backslash
renewcommand{
\backslash
labelenumiii}{
\backslash
arabic{enumiii}.}
\end_layout
\begin_layout LyX-Code
\backslash
renewcommand{
\backslash
labelenumiv}{
\backslash
alph{enumiv}.)}
\end_layout
\begin_layout Standard
Ceci remplace le schéma existant par, dans l'ordre, les chiffres romains,
les lettres majuscules, les chiffres arabes et les lettres minuscules.
\end_layout
\begin_layout Standard
En fait, cet exemple n'est pas seulement une redéfinition de la numérotation.
Par exemple, le marqueur du premier niveau devient en fait
\family sans
\begin_inset Quotes fld
\end_inset
I.
\begin_inset Quotes frd
\end_inset
\family default
.
Pour faciliter la lecture, nous allons décrire les schémas de numérotation
avec cette notation :
\family sans
<
\begin_inset Quotes fld
\end_inset
I.
\begin_inset Quotes frd
\end_inset
\family default
,
\family sans
\begin_inset Quotes fld
\end_inset
A.
\begin_inset Quotes frd
\end_inset
\family default
,
\family sans
\begin_inset Quotes fld
\end_inset
1.
\begin_inset Quotes frd
\end_inset
\family default
,
\family sans
\begin_inset Quotes fld
\end_inset
a.)
\begin_inset Quotes frd
\end_inset
>
\family default
.
\end_layout
\begin_layout Standard
Comme vous pouvez le voir dans l'exemple, il existe pour chaque niveau d'emboîte
ment une commande :
\family typewriter
\backslash
labelenumi
\family default
\SpecialChar \ldots{}
\family typewriter
\backslash
labelenumiv
\family default
, et un compteur :
\family typewriter
enumi
\family default
\SpecialChar \ldots{}
\family typewriter
enumiv
\family default
.
Il existe aussi cinq commandes de mise en forme des numéros :
\family typewriter
\backslash
arabic{}
\family default
,
\family typewriter
\backslash
roman{}
\family default
,
\family typewriter
\backslash
Romain{}
\family default
,
\family typewriter
\backslash
alph{}
\family default
, et
\family typewriter
\backslash
Alph{}
\family default
, chacune prenant un compteur pour paramètre.
Vous pouvez ajouter des caractères avant et après celui-ci, les espaces
étant quant à elles générées automatiquement.
\end_layout
\begin_layout Standard
Ça peut devenir vraiment amusant avec, par exemple :
\end_layout
\begin_layout LyX-Code
\backslash
renewcommand{
\backslash
labelenumi}{
\backslash
#
\backslash
Alph{enumi}
\backslash
#}
\end_layout
\begin_layout LyX-Code
\backslash
renewcommand{
\backslash
labelenumii}{
\backslash
Alph{enumi}.
\backslash
arabic{enumii}}
\end_layout
\begin_layout LyX-Code
\backslash
renewcommand{
\backslash
labelenumiii}{
\backslash
alph{enumiii}+}
\end_layout
\begin_layout LyX-Code
\backslash
renewcommand{
\backslash
labelenumiv}{(
\backslash
roman{enumiv})}
\end_layout
\begin_layout Standard
qui donne le schéma de numérotation :
\family sans
<
\begin_inset Quotes fld
\end_inset
#A#
\begin_inset Quotes frd
\end_inset
\family default
,
\family sans
\begin_inset Quotes fld
\end_inset
A.1
\begin_inset Quotes frd
\end_inset
\family default
,
\family sans
\begin_inset Quotes fld
\end_inset
a+
\begin_inset Quotes frd
\end_inset
\family default
,
\family sans
\begin_inset Quotes fld
\end_inset
(i)
\begin_inset Quotes frd
\end_inset
>
\family default
.
\end_layout
\begin_layout Section
Lettrines
\end_layout
\begin_layout Standard
by
\noun on
Mike Ressler
\end_layout
\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
newfont{
\backslash
tmpfont}{cmr17 scaled 2500}{
\backslash
tmpfont C}
\backslash
vspace*{-8.4ex}
\end_layout
\end_inset
\end_layout
\begin_layout Standard
\noindent
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
hangindent=4.5em
\backslash
hangafter=-3
\end_layout
\end_inset
eux d'entre vous qui aiment les vieux écrits aiment aussi certainement
les lettrines, ces grandes lettres majuscules qui ouvrent un nouveau chapitre.
L'implémentation de celles-ci se fait assez bien, à condition que vous
connaissiez un peu le TeX pur et dur, mais demande un peu de travail, comme
vous pouvez le voir à l'abominable code TeX qui entame ce paragraphe.
\end_layout
\begin_layout Standard
\begin_inset ERT
status open
\begin_layout Plain Layout
\backslash
verb+(
\backslash
bigdrop{-1em}{3}{ptmri}{I})+
\end_layout
\end_inset
l existe bien entendu une manière plus facile de s'en servir.
Le paquetage
\family typewriter
dropcaps
\family default
(ou le plus récent
\family typewriter
dropping
\family default
) du CTAN en est un exemple.
Ce paquetage n'étant pas dans la distribution standard de teTeX, je ne
peux pas en faire la démonstration dans ce document, mais si vous copiez
ce paragraphe dans un nouveau document, enlevez le
\family typewriter
\begin_inset Quotes fld
\end_inset
\backslash
verb
\begin_inset Quotes frd
\end_inset
\family default
et les caractères
\family typewriter
\begin_inset Quotes fld
\end_inset
+
\begin_inset Quotes frd
\end_inset
\family default
du code TeX et ajoutez
\family typewriter
\backslash
usepackage{dropcaps}
\family default
à votre préambule LaTeX, vous obtiendrez un magnifique
\begin_inset Quotes fld
\end_inset
I
\begin_inset Quotes frd
\end_inset
en Times Romain italique, dont la hauteur sera trois fois celle d'une ligne
de texte et qui dépasse de 1
\begin_inset space ~
\end_inset
em dans la marge.
(Il faut donc avoir copié
\family typewriter
dropcaps.sty
\family default
dans un répertoire ou TeX pourra le trouver.) Le premier paramètre indique
le retrait par rapport à la marge.
Dans le cas d'un nombre négatif, la lettrine dépassera dans celle-ci.
Le deuxième paramètre donne la hauteur de la lettrine en nombre de lignes
de texte.
Le troisième est le nom de la police à utiliser.
Normalement, un quelconque fichier tfm peut convenir (voyez le répertoire
\family typewriter
.../texmf/fonts/tfm
\family default
pour en avoir la liste).
Ma préférence personnelle va à
\family typewriter
\begin_inset Quotes fld
\end_inset
yinit
\begin_inset Quotes frd
\end_inset
\family default
, une police gothique spécialement créée pour les lettrines.
Le quatrième et dernier paramètre est la (les) lettre(s) à mettre en lettrine.
Le paquetage
\family typewriter
dropping
\family default
offre aussi la commande
\family typewriter
\backslash
bigdrop
\family default
ainsi qu'une commande
\family typewriter
\backslash
dropping
\family default
légèrement plus simple.
\end_layout
\begin_layout Section
Paragraphes de forme inhabituelle
\end_layout
\begin_layout Standard
par
\noun on
Mike Ressler
\end_layout
\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
begin{sloppypar}
\end_layout
\end_inset
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
newdimen
\backslash
varunit
\end_layout
\begin_layout Plain Layout
\backslash
setlength{
\backslash
varunit}{4.5in}
\end_layout
\end_inset
\end_layout
\begin_layout Standard
\noindent
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
parshape 19 0.45
\backslash
varunit 0.367
\backslash
varunit
\end_layout
\begin_layout Plain Layout
0.40
\backslash
varunit 0.335
\backslash
varunit
\end_layout
\begin_layout Plain Layout
0.35
\backslash
varunit 0.328
\backslash
varunit
\end_layout
\begin_layout Plain Layout
0.30
\backslash
varunit 0.335
\backslash
varunit
\end_layout
\begin_layout Plain Layout
0.25
\backslash
varunit 0.352
\backslash
varunit
\end_layout
\begin_layout Plain Layout
0.20
\backslash
varunit 0.377
\backslash
varunit
\end_layout
\begin_layout Plain Layout
0.15
\backslash
varunit 0.408
\backslash
varunit
\end_layout
\begin_layout Plain Layout
0.10
\backslash
varunit 0.445
\backslash
varunit
\end_layout
\begin_layout Plain Layout
0.05
\backslash
varunit 0.488
\backslash
varunit
\end_layout
\begin_layout Plain Layout
0.00
\backslash
varunit 0.535
\backslash
varunit
\end_layout
\begin_layout Plain Layout
0.05
\backslash
varunit 0.488
\backslash
varunit
\end_layout
\begin_layout Plain Layout
0.10
\backslash
varunit 0.445
\backslash
varunit
\end_layout
\begin_layout Plain Layout
0.15
\backslash
varunit 0.408
\backslash
varunit
\end_layout
\begin_layout Plain Layout
0.20
\backslash
varunit 0.377
\backslash
varunit
\end_layout
\begin_layout Plain Layout
0.25
\backslash
varunit 0.352
\backslash
varunit
\end_layout
\begin_layout Plain Layout
0.30
\backslash
varunit 0.335
\backslash
varunit
\end_layout
\begin_layout Plain Layout
0.35
\backslash
varunit 0.328
\backslash
varunit
\end_layout
\begin_layout Plain Layout
0.40
\backslash
varunit 0.335
\backslash
varunit
\end_layout
\begin_layout Plain Layout
0.45
\backslash
varunit 0.367
\backslash
varunit
\end_layout
\begin_layout Plain Layout
\end_layout
\end_inset
Il y a des fois où il faut en finir avec la tyrannie des paragraphes rectangulai
res.
Dans de telles situations, il faut recourir à la délicieuse commande TeX
\family typewriter
\backslash
parshape
\family default
.
Comme vous voyez, on peut construire des formes complètement arbitraires
en déclarant un ensemble de longueurs de ligne.
Cette forme de paragraphe peut sembler un peu idiote et sans utilité, mais
on peut imaginer des situations, comme des lettrines finement ajustées,
l'enrobage de graphiques non rectangulaires, etc.
qui bénéficieraient d'une telle opération.
\end_layout
\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset
\end_layout
\begin_layout Standard
La syntaxe est
\family typewriter
\backslash
parshape nombre_lignes #1indentation #1longueur #2indentation #2longueur
\SpecialChar \ldots{}
#nindentation #nlongueur
\family default
, où
\family typewriter
nombre_lignes
\family default
est le nombre de lignes du texte qui définit le paragraphe.
S'il n'y a pas assez de lignes, la forme est tronquée ; s'il y en a trop,
les lignes en surplus ont les mêmes dimensions que la dernière ligne ainsi
définie.
Les entrées
\family typewriter
#nindentation
\family default
et
\family typewriter
#nlongueur
\family default
spécifient l'indentation de la ligne à compter de la marge de gauche, et
la longueur de la ligne à partir de ce point.
La forme ne s'applique qu'au paragraphe en cours ; tout est remis à la
normale pour le paragraphe suivant.
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
end{sloppypar}
\end_layout
\end_inset
\end_layout
\begin_layout Section
Résumé
\end_layout
\begin_layout Standard
Comme vous voyez, les exemples dans cette section vont de l'utile au futile.
Je ne m'attends pas à ce que qui que ce soit ait un jour besoin des formes
de paragraphe présentées dans la dernière section, mais le point essentiel
est que vous pouvez presque tout faire avec LyX : il vous suffit de trouver
comment procéder en TeX et LaTeX.
TeX est un système de typographie incroyablement puissant et toute cette
puissance vous est acquise puisque LyX s'en sert en arrière-plan.
LyXez en paix !
\end_layout
\end_body
\end_document