anne/lyx_mirror
1
0
Fork 0
mirror of https://git.lyx.org/repos/lyx.git synced 2024-09-20 15:01:58 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
4c39562025
lyx_mirror/lib/doc/fr/Customization.lyx
Uwe Stöhr 63148de4a0 - Customization.lyx: add new possible font types uuline, strikeout and uwave 
- German Customization.lyx: lot of refactoring

git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/branches/BRANCH_2_0_X@39606 a592a061-630c-0410-9148-cb99ea01b6c8
2011-09-06 02:46:23 +00:00

22533 lines
334 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

#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
\usepackage{ifpdf} % part of the hyperref bundle
\ifpdf % if pdflatex is used
% set fonts for nicer pdf view
\IfFileExists{lmodern.sty}{\usepackage{lmodern}}{}
\fi % end if pdflatex is used
% the pages of the TOC is numbered roman
% and a pdf-bookmark for the TOC is added
\let\myTOC\tableofcontents
\renewcommand\tableofcontents{%
\frontmatter
\pdfbookmark[1]{\contentsname}{}
\myTOC
\mainmatter }
\end_preamble
\options fleqn,liststotoc,bibtotoc,idxtotoc,BCOR7.5mm,titlepage,tablecaptionabove
\use_default_options false
\begin_modules
logicalmkup
\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 "LyX Configuration Manual"
\pdf_author "LyX Team"
\pdf_subject "LyX-documentation Customization"
\pdf_keywords "LyX, documentation, customization"
\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"
\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 0
\branch Obsolete
\selected 0
\filename_suffix 0
\color #aaffff
\end_branch
\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 headings
\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
Personnaliser LyX : fonctions pour l'utilisateur avancé
\begin_inset Note Note
status open
\begin_layout Plain Layout
Informations de révision :
\end_layout
\begin_layout Plain Layout
Traduction : Mise à jour OK pour la publication 2.0.0, Date: 03/04/2011
\end_layout
\begin_layout Plain Layout
Original : Révision: 37808, Date: 28/02/2011
\end_layout
\end_inset
\end_layout
\begin_layout Author
par l'équipe LyX
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Merci d'envoyer vos commentaires et corrections à la liste de diffusion
de la documentation de LyX,
\family typewriter
\begin_inset CommandInset href
LatexCommand href
target "lyx-docs@lists.lyx.org"
\end_inset
\family default
.
Insérer
\begin_inset Quotes fld
\end_inset
[Customization]
\begin_inset Quotes frd
\end_inset
dans l'objet, et mettre en copie le responsable courant de ce fichier,
Richard Heck <rgheck@comcast.net>.
\begin_inset Newline newline
\end_inset
Traduction en français par : P.-H.
\noun on
Boinnard
\noun default
, Adrien
\noun on
Rebollo
\noun default
, Siegfried
\noun on
Meunier-Guttin-Cluzel
\noun default
, Jean-Pierre
\noun on
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
\begin_inset Newline newline
\end_inset
\begin_inset Newline newline
\end_inset
Version 2.0.x
\end_layout
\begin_layout Standard
\begin_inset CommandInset toc
LatexCommand tableofcontents
\end_inset
\end_layout
\begin_layout Chapter
Introduction
\end_layout
\begin_layout Standard
Ce manuel couvre les fonctions de personnalisation de LyX.
Nous y abordons des sujets comme les raccourcis clavier, les options d'aperçu
à l'écran, les options d'impression, l'envoi de commandes à LyX via le
Serveur LyX, l'internationalisation, l'installation de nouvelles classes
LaTeX et de nouveaux formats LyX, etc.
Nous n'espérons pas aborder tout ce que vous pouvez modifier – nos développeurs
ajoutent de nouvelles fonctions plus vite que nous n'en écrivons la documentati
on – mais nous allons expliquer les personnalisations les plus courantes
et au moins vous indiquer la bonne direction pour les plus obscures d'entre
elles.
\end_layout
\begin_layout Chapter
Les fichiers de configuration de LyX
\end_layout
\begin_layout Standard
Ce chapitre devrait vous aider à trouver votre chemin parmi les fichiers
de configuration de LyX.
Avant d'entreprendre sa lecture, consultez
\family sans
Aide
\bar under
\SpecialChar \menuseparator
\bar default
À
\begin_inset space ~
\end_inset
Propos
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
LyX
\family default
pour connaître le répertoire de bibliothèques et le répertoire utilisateur
de LyX.
C'est dans celui-ci que LyX place ses fichiers de configuration système;
le répertoire utilisateur est celui dans lequel vous pouvez mettre vos
versions modifiées Le premier sera appelé
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
RépLyX
\end_layout
\end_inset
et le second
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
MonRép
\end_layout
\end_inset
dans la suite de ce document.
\end_layout
\begin_layout Section
Qu'est-ce qu'il y a dans
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
RépLyX
\end_layout
\end_inset
?
\end_layout
\begin_layout Standard
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
RépLyX
\end_layout
\end_inset
et ses sous-répertoires contiennent un certain nombre de fichiers qui peuvent
servir à personnaliser le comportement de LyX.
Vous pouvez modifier ces fichiers depuis LyX lui-même avec la fenêtre
\family sans
Éditer\SpecialChar \menuseparator
Préférences
\family default
.
La plupart des réglages personnels que vous voudrez apporter à LyX peuvent
se faire par l'intermédiaire de cette fenêtre.
Il y a cependant bien d'autres aspects du fonctionnement de LyX sur lesquels
on peut agir en modifiant les fichiers de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
RépLyX
\end_layout
\end_inset
.
Ils entrent dans différentes catégories, qui sont décrites dans les sous-sectio
ns suivantes.
\end_layout
\begin_layout Subsection
Les fichiers générés automatiquement
\end_layout
\begin_layout Standard
Ces fichiers sont générés au moment de la configuration de LyX.
Ils définissent différentes valeurs par défaut qui sont évaluées par l'inspecti
on de votre système.
Comme ils peuvent être réécrits à tout moment, il n'est pas conseillé de
les modifier.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
lyxrc.defaults
\end_layout
\end_inset
contient les valeurs implicites pour différentes commandes.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
packages.lst
\end_layout
\end_inset
contient la liste des paquetages LaTeX que LyX a reconnu.
LyX ne se sert pas directement de ce fichier, mais les informations obtenues
sont disponibles en faisant
\family sans
Aide\SpecialChar \menuseparator
Configuration
\begin_inset space ~
\end_inset
LaTeX
\family default
.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
textclass.lst
\end_layout
\end_inset
donne la liste des classes de texte présentes dans le répertoire
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
layout/
\end_layout
\end_inset
, les classes de document LaTeX correspondantes et leur description.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
lyxmodules.lst
\end_layout
\end_inset
donne la liste des modules figurant dans vos répertoires de format (
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
layout
\end_layout
\end_inset
).
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
*files.lst
\end_layout
\end_inset
donne la liste de différentes sortes de fichiers connexes à LaTeX figurant
dans votre système.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
doc/LaTeXConfig.lyx
\end_layout
\end_inset
est généré automatiquement pendant la configuration de LyX, à partir du
fichier
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
LaTeXConfig.lyx.in
\end_layout
\end_inset
.
\end_layout
\begin_layout Subsection
Répertoires
\end_layout
\begin_layout Standard
Ces répertoires figurent à la fois dans
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
RépLyx
\end_layout
\end_inset
et dans
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
MonRép
\end_layout
\end_inset
.
Si un fichier existe dans les deux répertoires, c'est celui de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
MonRép
\end_layout
\end_inset
qui sera utilisé.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
bind/
\end_layout
\end_inset
ce répertoire contient les fichiers de définition des raccourcis clavier,
qui ont l'extension
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
.bind
\end_layout
\end_inset
.
S'il y a une version
\begin_inset Quotes fld
\end_inset
traduite
\begin_inset Quotes frd
\end_inset
du fichier de raccourcis, appelée
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
$LANG_xxx.bind
\end_layout
\end_inset
, celle-ci sera détectée et utilisée en premier.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
clipart/
\end_layout
\end_inset
contient quelques fichiers graphiques qui peuvent être inclus dans les
documents.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
doc/
\end_layout
\end_inset
contient les fichiers de la documentation de LyX (dont celui que vous êtes
en train de lire).
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
LaTeXConfig.lyx
\end_layout
\end_inset
est un cas à part, comme nous venons de le voir.
S'il existe des version traduites des fichiers d'aide, avec le préfixe
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
$LANG
\end_layout
\end_inset
, celles-ci seront utilisées d'abord (voir le chapitre
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "chap:i18n"
\end_inset
).
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
examples/
\end_layout
\end_inset
contient les fichiers d'exemples qui illustrent la façon d'utiliser certaines
fonctions.
Vous pouvez y accéder en appuyant sur le bouton
\family sans
Exemples
\family default
de la fenêtre
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Fichier\SpecialChar \menuseparator
Ouvrir
\end_layout
\end_inset
.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
images/
\end_layout
\end_inset
contient les fichiers d'images utilisés dans l'interface
\family sans
Document
\family default
.
Il contient également les icônes utilisées dans la barre d'outils et les
bannières affichées au démarrage de LyX.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
kbd/
\end_layout
\end_inset
contient les fichiers de réaffectation clavier.
Voir le chapitre
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:clavier"
\end_inset
pour des informations détaillées.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
layouts/
\end_layout
\end_inset
contient les classes de texte et les fichiers de modules décrits au chapitre
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "chap:classe-texte"
\end_inset
.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
lyx2lyx
\end_layout
\end_inset
contient les scripts Python
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
lyx2lyx
\end_layout
\end_inset
permettant d'effectuer les conversions entre versions de LyX.
Ils peuvent être exécutés depuis la ligne de commande, si vous désirez
par exemple faire un traitement par lots.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
scripts/
\end_layout
\end_inset
contient quelques fichiers qui illustrent les possibilités offertes par
l'insertion d'
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Objet
\begin_inset space ~
\end_inset
Externe
\end_layout
\end_inset
.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
templates/
\end_layout
\end_inset
contient les fichiers modèles de LyX décrits dans la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:modeles"
\end_inset
.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
ui/
\end_layout
\end_inset
contient des fichiers avec l'extension
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
.ui
\end_layout
\end_inset
qui définissent l'interface utilisateur de LyX.
C'est-à-dire que ces fichiers définissent quels éléments apparaissent dans
les menus et quels éléments apparaissent dans la barre d'outils.
\end_layout
\begin_layout Subsection
Fichiers que vous n'avez pas à modifier
\end_layout
\begin_layout Standard
Ce sont des fichiers internes à LyX, et ils ne doivent pas être modifiés,
sauf par les développeurs.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\family typewriter
\series medium
CREDITS
\family default
\series default
ce fichier contient la liste des développeurs de LyX.
Son contenu est affiché en sélectionnant
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Aide\SpecialChar \menuseparator
Crédits
\end_layout
\end_inset
.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\family typewriter
\series medium
chkconfig.ltx
\family default
\series default
est un script LaTeX utilisé pendant le processus de configuration.
Ne pas le lancer directement.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\family typewriter
\series medium
configure
\family default
\series default
est le script qui permet de reconfigurer LyX.
Il génère des fichiers de configuration dans le répertoire dans lequel
il est exécuté.
\end_layout
\begin_layout Subsection
Autres fichiers appelant un commentaire
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\family typewriter
encodings
\family default
contient des tables de conversion faisant correspondre les différents encodages
de caractères avec unicode.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\family typewriter
external_templates
\family default
contient les modèles disponibles pour la nouvelle fonction d'
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Objet
\begin_inset space ~
\end_inset
Externe
\end_layout
\end_inset
.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\family typewriter
languages
\family default
contient la liste de toutes les langues actuellement supportées par LyX.
\end_layout
\begin_layout Section
Votre répertoire personnel de configuration
\end_layout
\begin_layout Standard
Même si vous utilisez LyX sans être le super-utilisateur, vous pouvez avoir
envie de modifier la configuration de LyX pour votre usage personnel.
Le répertoire
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
MonRép
\end_layout
\end_inset
contient les fichiers personnels de configuration.
C'est le répertoire qui est décrit comme
\begin_inset Quotes fld
\end_inset
Répertoire utilisateur
\begin_inset Quotes frd
\end_inset
dans la fenêtre
\family sans
Aide\SpecialChar \menuseparator
À
\begin_inset space ~
\end_inset
Propos
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
LyX
\family default
.
Il est traité comme un miroir du répertoire
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
RépLyX
\end_layout
\end_inset
, et chaque fichier qui se trouve dans
\family typewriter
MonRép
\family default
remplace par conséquent le fichier correspondant de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
RépLyX
\end_layout
\end_inset
.
Chaque fichier de configuration décrit dans les sections précédentes peut
se trouver soit dans le répertoire de configuration système, ce qui jouera
pour tous les utilisateurs, soit dans votre répertoire personnel, pour
votre propre configuration.
\end_layout
\begin_layout Standard
Pour éclaircir la situation, voici quelques exemples :
\end_layout
\begin_layout Itemize
les réglages effectués dans la fenêtre
\family sans
Outils\SpecialChar \menuseparator
Préférences
\family default
sont enregistrés dans un fichier
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
preferences
\end_layout
\end_inset
dans
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
MonRép
\end_layout
\end_inset
;
\end_layout
\begin_layout Itemize
quand vous reconfigurez LyX avec
\family sans
Outils\SpecialChar \menuseparator
\bar under
R
\bar default
econfigurer
\family default
, LyX fait tourner le script
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
configure.py
\end_layout
\end_inset
et les fichiers résultants sont placés dans votre répertoire personnel
de configuration.
Ça signifie que les nouvelles classes de texte que vous avez pu ajouter
dans
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
MonRép/layouts
\end_layout
\end_inset
seront ajoutées à la liste des classes de la fenêtre
\family sans
Document\SpecialChar \menuseparator
Paramètres
\family default
.
\end_layout
\begin_layout Itemize
Si vous récupérez sur le site ftp de LyX des fichiers de documentation mis
à jour et que vous n'êtes pas administrateur sur votre système, vous pouvez
placer ces fichiers dans
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
MonRép/doc/
\end_layout
\end_inset
et ils seront ouverts directement à partir du menu d'
\family sans
Aide
\family default
!
\end_layout
\begin_layout Section
Utiliser LyX avec plusieurs configurations
\end_layout
\begin_layout Standard
La liberté offerte pour le répertoire de configuration locale peut être
insuffisante si vous avez besoin de plusieurs configurations différentes.
Par exemple, vous pouvez vouloir utiliser des raccourcis clavier ou des
réglages d'imprimante différents selon les moments
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT : Ou encore vouloir écrire dans des langues différentes et adapter vos
configurations en conséquence.
\end_layout
\end_inset
.
Vous pouvez y arriver en ayant plusieurs répertoires de configuration.
Vous spécifiez alors lequel utiliser au moment de lancer LyX.
\end_layout
\begin_layout Standard
Si vous lancez LyX avec l'option de ligne de commande
\family typewriter
-userdir
\family default
\emph on
<répertoire>
\emph default
, le programme va lire la configuration qui se trouve dans ce répertoire,
et non dans le répertoire par défaut (en lançant LyX sans cette option
vous pouvez déterminer le répertoire par défaut).
Si ce répertoire n'existe pas, LyX vous propose de le créer, exactement
comme il le fait avec le répertoire implicite au premier lancement du programme.
Vous pouvez modifier les options de configuration dans ce
\family typewriter
MonNouveauRép
\family default
supplémentaire exactement comme vous le feriez pour le répertoire implicite.
Ces répertoires sont complètement indépendants (mais lisez la suite).
Notez que positionner la variable d'environnement
\family typewriter
LYX_USERDIR_VER
\family default
a exactement le même effet.
\end_layout
\begin_layout Standard
Quand vous avez plusieurs configurations, vous devez faire plus attention:
si vous voulez ajouter un nouveau format dans
\family typewriter
MonNouveauRép/layouts
\family default
, pour qu'il soit disponible dans toutes vos configurations, vous devez
l'ajouter dans chaque répertoire séparément.
Vous pouvez contourner ceci avec l'astuce suivante : après que LyX a créé
le répertoire supplémentaire, la plupart des sous-répertoires (voir plus
haut) sont vides.
Si vous voulez que la nouvelle configuration soit le reflet d'une déjà
existante, remplacez le sous-répertoire vide par un lien symbolique au
sous-répertoire correspondant dans la configuration existante.
Faites toutefois attention avec le sous-répertoire
\family typewriter
doc/
\family default
, car il contient un fichier écrit par le script de configuration (accessible
avec
\family sans
Outils\SpecialChar \menuseparator
Reconfigurer
\family default
) qui est propre à chaque configuration.
\end_layout
\begin_layout Chapter
La fenêtre
\family sans
Préférences
\end_layout
\begin_layout Standard
Tous les options de la fenêtre
\family sans
Préférences
\family default
sont expliquées dans l'appendice
\emph on
La fenêtre Préférences
\emph default
du
\emph on
Guide de l'utilisateur
\emph default
.
Pour certaines options, vous trouverez ici plus de précisions.
\end_layout
\begin_layout Section
Formats
\begin_inset CommandInset label
LatexCommand label
name "sec:Formats"
\end_inset
\end_layout
\begin_layout Standard
La première étape consiste à définir vos formats de fichiers si ce n'est
pas déjà le cas.
Pour ce faire, ouvrez
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Outils\SpecialChar \menuseparator
Préférences
\end_layout
\end_inset
: dans
\lang english
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Gestion des fichiers\SpecialChar \menuseparator
Formats de fichier
\end_layout
\end_inset
\lang french
, appuyez sur le bouton
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Nouveau\SpecialChar \ldots{}
\end_layout
\end_inset
.
Le champ
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Format
\end_layout
\end_inset
contient le nom utilisé pour identifier le format de manière interne.
Vous devrez également saisir un suffixe de nom de fichier.
Toutes ces informations sont obligatoires.
Le champ optionnel
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Raccourci
\end_layout
\end_inset
permet de définir une séquence de touches du clavier pour un accès rapide
aux menus (par exemple, appuyer sur
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Alt-V a D
\end_layout
\end_inset
activera
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Visionner
\lang english
\SpecialChar \menuseparator
\lang french
Visionner (autres formats)
\lang english
\SpecialChar \menuseparator
\lang french
DVI
\end_layout
\end_inset
).
\end_layout
\begin_layout Standard
Un Format peut se voir associer une
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Visionneuse
\end_layout
\end_inset
et un
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Éditeur
\end_layout
\end_inset
.
Par exemple, vous pouvez vouloir utiliser Ghostview pour afficher les fichier
PostScript.
Vous pouvez saisir le nom de la commande permettant de lancer les programmes
dans les champs correspondants.
La visionneuse est lancée quand vous voulez voir un graphique dans LyX
ou utiliser le menu
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Visionner
\end_layout
\end_inset
.
L'éditeur est lancé par exemple quand vous faites un clic-droit sur un
graphique et que vous choisissez
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Modifier le fichier via une application externe\SpecialChar \ldots{}
\end_layout
\end_inset
dans le menu contextuel qui apparaît.
\end_layout
\begin_layout Standard
La case à cocher Format de document informe LyX que le format est approprié
pour une exportation du document.
Si la case est cochée que qu'une procédure de conversion est définie (voir
la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:Convertisseurs"
\end_inset
), ce format apparaîtra dans le menu
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Fichier\SpecialChar \menuseparator
Exporter
\end_layout
\end_inset
.
Le format apparaîtra également dans le menu Visionner si une visionneuse
est définie pour lui.
Les formats purement graphiques, comme png, ne doivent pas utiliser cette
option.
Les formats adaptés à la fois aux graphiques et aux documents, comme pdf,
doivent l'utiliser.
\end_layout
\begin_layout Standard
La case
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Format graphique vectoriel
\end_layout
\end_inset
informe LyX qu'un format peut contenir des vecteurs graphiques.
Cette information est utile pour déterminer le format cible des graphiques
inclus lors de l'exportation via
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
pdflatex
\end_layout
\end_inset
.
Les graphiques inclus dans le document peuvent nécessiter une conversion
vers
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
pdf
\end_layout
\end_inset
,
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
png
\end_layout
\end_inset
ou
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
jpg
\end_layout
\end_inset
puisque
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
pdflatex
\end_layout
\end_inset
ne sait pas gérer d'autres formats graphiques.
Si un graphique inclus n'est pas déjà dans un des ces trois formats, il
est converti en
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
pdf
\end_layout
\end_inset
si la case est cochée, et en
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
png
\end_layout
\end_inset
sinon.
\end_layout
\begin_layout Section
Copieurs
\end_layout
\begin_layout Standard
Du fait que toutes les conversions d'un format à une autre se font dans
la répertoire temporaire de LyX, il peut être nécessaire de modifier un
fichier avant de le copier dan le répertoire temporaire pour que la conversion
se fasse correctement
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Par exemple, le fichier peut référencer d'autres fichiers ― e.g.
une image ― par un nom de fichier relatif, qui peut devenir incorrect lors
de la copie du fichier dans le répertoire temporaire.
\end_layout
\end_inset
.
Ceci est effectué par un Copieur: il copie un fichier vers (ou depuis)
le répertoire temporaire et peut le modifier à la volée.
\end_layout
\begin_layout Standard
La définition des copieurs peut utiliser quatre variables:
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$s
\end_layout
\end_inset
le répertoire système de LyX (e.
\begin_inset space \thinspace{}
\end_inset
g.
\begin_inset space \space{}
\end_inset
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
/usr/share/lyx
\end_layout
\end_inset
)
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$i
\end_layout
\end_inset
le fichier en entrée
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$o
\end_layout
\end_inset
le fichier en sortie
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$l
\end_layout
\end_inset
le
\begin_inset Quotes fld
\end_inset
nom LaTeX
\begin_inset Quotes frd
\end_inset
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
Ce dernier doit être le nom du fichier tel qu'il serait spécifié dans la
commande LaTeX
\series bold
\lang english
\backslash
include
\series default
\lang french
.
Il n'est pertinent que pour l'exportation des fichiers appropriés à une
telle inclusion.
\end_layout
\begin_layout Standard
Les copieurs peuvent être utilisés pour à peu près n'importe quelle opération
sur un fichier.
Par exemple, supposons que vous vouliez que les fichiers pdf soient copiés
dans un répertoire particulier,
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
/home/you/pdf/
\end_layout
\end_inset
\lang french
.
Alors vous pouvez écrire un script comme celui-ci:
\end_layout
\begin_layout Standard
\lang english
\begin_inset listings
inline false
status open
\begin_layout Plain Layout
#!/bin/bash
\end_layout
\begin_layout Plain Layout
FROMFILE=$1
\end_layout
\begin_layout Plain Layout
TOFILE=`basename $2`
\end_layout
\begin_layout Plain Layout
cp $FROMFILE /home/you/pdf/$TOFILE
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Enregistrez le dans votre répertoire LyX local ― disons,
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
/home/you/.lyx/scripts/pdfcopier.sh
\end_layout
\end_inset
\lang french
― et rendez le exécutable, si c'est nécessaire sur votre plate-forme.
Puis, dans
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Outils\SpecialChar \menuseparator
Préférences
\end_layout
\end_inset
, sélectionnez sous
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Gestion des fichiers\SpecialChar \menuseparator
Formats de fichier
\end_layout
\end_inset
le format
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
PDF(pdflatex)
\end_layout
\end_inset
―ou l'un des autres formats PDF ― et saisissez
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
pdfcopier.sh $$i $$o
\end_layout
\end_inset
\lang french
dans le champ
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Copieur
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
Les copieurs sont utilisés par LyX dans plusieurs de ses convertisseurs
internes.
Par exemple, si les programmes appropriés sont trouvés lors de la configuration
, LyX installera automatiquement des copieurs pour les formats
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
HTML
\end_layout
\end_inset
et
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
HTML
\begin_inset space ~
\end_inset
(MSWord)
\end_layout
\end_inset
.
Quand le documente est exporté vers ces formats, le copieur considère que
non seulement le fichier HTML, mais aussi les fichiers auxiliaires (fichiers
de style, images, etc.) sont également copiés.
Tous ces fichiers sont recopiés dans un sous-répertoire du répertoire dans
lequel se trouvait le document LyX original.
\end_layout
\begin_layout Section
Convertisseurs
\begin_inset CommandInset label
LatexCommand label
name "sec:Convertisseurs"
\end_inset
\end_layout
\begin_layout Standard
Vous pouvez définir vos propres Convertisseurs pour activer les conversions
entre différents formats.
Ceci est défini dans
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Outils\SpecialChar \menuseparator
Préférences\SpecialChar \menuseparator
Gestion des fichiers\SpecialChar \menuseparator
Convertisseurs
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
Pour définir un nouveau convertisseur, sélectionner les formats appropriés
dans les menus déroulants
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Depuis le format
\end_layout
\end_inset
et
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Vers le format
\end_layout
\end_inset
, saisir le nom de la commande nécessaire à la conversion et appuyer sur
le bouton
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Ajouter
\end_layout
\end_inset
.
Plusieurs variables peuvent être utilisées pour préciser les arguments
des commandes de conversion:
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$s
\end_layout
\end_inset
\lang french
le répertoire système de LyX
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$i
\end_layout
\end_inset
le fichier en entrée
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$o
\end_layout
\end_inset
le fichier en sortie
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$b
\end_layout
\end_inset
le nom de base du fichier en entrée (c'est-à-dire sans suffixe)
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$p
\end_layout
\end_inset
le chemin du fichier d'entrée
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$r
\end_layout
\end_inset
le chemin du fichier d'entrée original (ceci peut différer de
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
$$p
\end_layout
\end_inset
lors de l'appel d'une séquence de convertisseurs)
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$e
\end_layout
\end_inset
\lang french
l'identificateur
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
iconv
\end_layout
\end_inset
désignant l'encodage du document
\end_layout
\begin_layout Standard
Dans le champ
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Autres
\begin_inset space ~
\end_inset
options
\end_layout
\end_inset
, vous pouvez saisir les mots-clés suivants, séparés par des virgules:
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
latex
\end_layout
\end_inset
ce convertisseur exécute LaTeX ou une variante de LaTeX, le fichier journal
sera disponible
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
needaux
\end_layout
\end_inset
la conversion utilise le fichier
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
.aux
\end_layout
\end_inset
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
xml
\end_layout
\end_inset
la sortie est au format XML
\end_layout
\begin_layout Standard
Les trois mots-clés suivants ne sont pas vraiment des mots-clés, ils prennent
un argument de la forme
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
clé=valeur
\end_layout
\end_inset
:
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
parselog
\end_layout
\end_inset
s'il est utilisé, les messages d'erreur standard du convertisseur seront
redirigés vers un fichier
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
infile.out
\end_layout
\end_inset
, et le script passé en valeur sera exécuté comme:
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
script < infile.out > infile.log
\end_layout
\end_inset
.
L'argument peut contenir
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$s
\end_layout
\end_inset
.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
resultdir
\end_layout
\end_inset
précise le nom du répertoire dans lequel le convertisseur placera les fichiers
engendrés par la conversion.
LyX ne créera pas ce répertoire, et ne copiera rien dedans, bien qu'il
le copie dans la cible.
La valeur peut utiliser
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$b
\end_layout
\end_inset
, qui sera remplacé par le nom sans suffixe des fichiers d'entrée et de
sortie, respectivement, lors de la copie du répertoire.
\begin_inset Newline newline
\end_inset
Noter que l'utilisation simultanée de
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
resultdir
\end_layout
\end_inset
et
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
usetempdir
\end_layout
\end_inset
n'a aucun sens.
Le dernier sera ignoré si le premier est employé.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
resultfile
\end_layout
\end_inset
détermine le nom du fichier résultat et peut contenir
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$b
\end_layout
\end_inset
.
N'a de sens qu'avec
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
resultdir
\end_layout
\end_inset
et est optionnel même dans ce cas; la valeur
\begin_inset Quotes fld
\end_inset
index
\begin_inset Quotes frd
\end_inset
est implicite s'il n'est pas activé.
\end_layout
\begin_layout Standard
Aucun de ces trois derniers mots-clés n'est utilisé dans les convertisseurs
installés par LyX.
\end_layout
\begin_layout Standard
Il n'est pas nécessaire de définir des convertisseurs pour tous les formats
entre lesquels vous désirez effectuer des conversions.
Par exemple, vous remarquerez qu'il n'y a pas de convertisseur
\begin_inset Quotes fld
\end_inset
LyX vers PostScript
\begin_inset Quotes frd
\end_inset
, mais LyX exportera bien vers PostScript.
Ceci se fait parce que LyX crée d'abord un fichier LaTeX (pas besoin de
convertisseur pour cela) qui est ensuite converti vers DVI en utilisant
le convertisseur
\begin_inset Quotes fld
\end_inset
LyX vers DVI
\begin_inset Quotes frd
\end_inset
, pour terminer par la conversion
\begin_inset Quotes fld
\end_inset
DVI vers PostScript
\begin_inset Quotes frd
\end_inset
.
LyX trouve ainsi les séquences de convertisseurs automatiquement, et trouvera
toujours le séquence la plus courte.
Vous pouvez cependant définir plusieurs méthodes de conversion entre formats
de fichier.
Par exemple, la configuration LyX standard propose trois façons différentes
de convertir LaTeX vers PDF: directement, via
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
pdflatex
\end_layout
\end_inset
; via (DVI et) PostScript, en utilisant
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
ps2pdf
\end_layout
\end_inset
; ou via DVI, en utilisant
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
dvipdfm
\end_layout
\end_inset
.
Pour définir de tels choix de séquences, vous devez définir plusieurs
\begin_inset Quotes fld
\end_inset
formats de fichier
\begin_inset Quotes frd
\end_inset
cible, comme décrit dans la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:Formats"
\end_inset
.
Par exemple, avec la configuration standard, les formats dénommés
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
pdf
\end_layout
\end_inset
,
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
pdf2
\end_layout
\end_inset
et
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
pdf3
\end_layout
\end_inset
sont définis, qui correspondent tous au suffixe
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
pdf
\end_layout
\end_inset
et auxquels sont associées les trois méthodes décrites ci-dessus.
\end_layout
\begin_layout Chapter
Internationaliser LyX
\begin_inset CommandInset label
LatexCommand label
name "chap:i18n"
\end_inset
\end_layout
\begin_layout Standard
Il est possible de traduire l'interface utilisateur de LyX.
La dernière fois que nous avons vérifié, LyX était disponible en 30 langues.
La langue que vous avez choisie est appelée votre
\emph on
locale
\emph default
(pour plus de renseignements sur les réglages de localisation, voyez la
documentation de votre système d'exploitation sur les locales.
Pour Linux, la page de man de
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
locale(5)
\end_layout
\end_inset
est un bon point de départ).
\end_layout
\begin_layout Standard
Notez que ces traductions fonctionnent, mais présentent quelques failles.
En particulier, toutes les fenêtres ont été tracées en fonction du texte
anglais, et quelques-unes des traductions sont trop grandes pour rentrer
dans l'espace alloué.
Ce n'est qu'un problème d'affichage sans conséquence.
Vous verrez aussi que certaines traductions n'ont pas de raccourcis définis
pour tout.
Parfois, c'est qu'il n'y a pas assez de lettres disponibles.
Parfois c'est que le traducteur n'a tout simplement pas encore eu le temps
de le faire.
Nos équipes de traduction, que vous pouvez souhaiter rejoindre
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Si vous parlez couramment une autre langue que l'anglais, rejoindre ces
équipes est un des grands moyens de rendre service à la communauté des
développeurs et utilisateurs de LyX.
\end_layout
\end_inset
, essaieront de faire disparaître ces inconvénients dans les versions futures
de LyX
\end_layout
\begin_layout Section
Traduire LyX
\end_layout
\begin_layout Subsection
Traduire l'interface graphique (messages textuels)
\end_layout
\begin_layout Standard
LyX utilise la bibliothèque GNU
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
gettext
\end_layout
\end_inset
pour gérer l'internationalisation de l'interface.
Pour que LyX parle votre langue favorite dans tous les menus et fenêtres,
vous avez besoin d'un fichier
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
.po
\end_layout
\end_inset
pour cette langue.
Quand celui-ci est disponible, vous devez générer à partir de là un fichier
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
.mo
\end_layout
\end_inset
et installer ce dernier.
Tout ce processus est expliqué dans la documentation de GNU
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
gettext
\end_layout
\end_inset
.
Vous pouvez effectuer cette traduction pour votre propre besoin, mais si
vous avez l'intention de la faire, vous pouvez aussi bien partager le résultat
de votre travail avec la communauté LyX.
Envoyez un message à la liste de messagerie des développeurs LyX pour plus
d'information sur la procédure.
\end_layout
\begin_layout Standard
En bref, voici un résumé de ce qu'il faut faire (
\family typewriter
\series bold
xx
\family default
\series default
est le code de la langue) :
\end_layout
\begin_layout Itemize
télécharger le code source de LyX (voir la
\begin_inset CommandInset href
LatexCommand href
name "page d'information sur le Web"
target "http://www.lyx.org/WebFr.HowToUseSVN"
\end_inset
)
\end_layout
\begin_layout Itemize
copier
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
lyx.pot
\end_layout
\end_inset
dans
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
po
\end_layout
\end_inset
, le répertoire des fichiers
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
**.po
\end_layout
\end_inset
.
Puis renommez le en
\family typewriter
\series bold
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\family typewriter
\series bold
xx
\series default
.po
\end_layout
\end_inset
\family default
\series default
(si
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
lyx.pot
\end_layout
\end_inset
n'existe pas, il peut être recréé avec la commande
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
make lyx.pot
\end_layout
\end_inset
dans ce répertoire, ou bien vous pouvez utiliser le fichier
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
po
\end_layout
\end_inset
d'une autre langue comme modèle).
\end_layout
\begin_layout Itemize
Éditez
\family typewriter
\series bold
xx
\series default
.po
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
C'est un fichier texte: il peut donc être modifié par n'importe quel éditeur
de texte.
Mais il existe des programmes spécifiques pour gérer les modifications,
comme
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Poedit
\end_layout
\end_inset
(toutes plate-formes) ou
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
KBabel
\end_layout
\end_inset
(KDE).
(X)Emacs est également doté d'un
\begin_inset Quotes fld
\end_inset
mode
\begin_inset Quotes frd
\end_inset
pour modifier les fichier
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
.po
\end_layout
\end_inset
, mais attention, les fichiers sont encodés en Unicode.
\end_layout
\end_inset
\family default
.
Pour certains menus, il y a aussi des touches de raccourci qui doivent
être traduites.
Ces touches viennent après un
\family typewriter
\begin_inset Quotes fld
\end_inset
|
\begin_inset Quotes frd
\end_inset
\family default
, et doivent être adaptées au texte traduit.
Vous devez aussi remplir les champs au début du nouveau fichier
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
po
\end_layout
\end_inset
avec votre adresse e-mail, etc., pour que les gens sachent comment vous
joindre pour proposer des suggestions, ou pour démolir votre travail.
\end_layout
\begin_layout Standard
Si vous voulez juste traduire pour vous-même, alors:
\end_layout
\begin_layout Itemize
engendrer
\family typewriter
\series bold
xx
\series default
.mo
\family default
, avec la commande
\begin_inset Newline newline
\end_inset
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
msgfmt -o xx.mo < xx.po
\end_layout
\end_inset
\end_layout
\begin_layout Itemize
copier le fichier
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
mo
\end_layout
\end_inset
dans votre répertoire de locales, dans le répertoire correspondant aux
messages pour la langue
\family typewriter
\series bold
xx
\family default
\series default
, sous le nom
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
lyx.mo
\end_layout
\end_inset
\begin_inset Newline newline
\end_inset
(par exemple
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
/usr/local/share/locale/xx/LC_MESSAGES/lyx.mo
\end_layout
\end_inset
)
\end_layout
\begin_layout Standard
Pour ajouter un nouveau fichier
\family typewriter
po
\family default
à la
\emph on
distribution
\emph default
de LyX (ce qui serait mieux pour que d'autres puisent en profiter), il
faut effectuer quelques changements dans LyX: envoyez donc une courrier
à la liste de messagerie des développeurs pour ce faire.
\end_layout
\begin_layout Subsubsection
\family roman
\series medium
Messages ambigus
\end_layout
\begin_layout Standard
Il arrive quelquefois qu'un message anglophone doive être traduit de différentes
façons dans le langage cible.
Un exemple est le message
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
To
\end_layout
\end_inset
qui se traduit en allemand par
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Nach
\end_layout
\end_inset
ou
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Bis
\end_layout
\end_inset
, suivant la signification exacte de
\begin_inset Quotes fld
\end_inset
to
\begin_inset Quotes frd
\end_inset
en anglais.
GNU
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
gettext
\end_layout
\end_inset
ne sait pas gérer de telles traductions ambiguës, et vous devez donc ajouter
une information contextuelle au message: au lieu de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
To
\end_layout
\end_inset
il devient
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
To[[as in 'From format x to format y']]
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
To[[as in 'From page x to page y']].
\end_layout
\end_inset
De ce fait, les deux occurrences de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
To
\end_layout
\end_inset
sont différentes pour
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
gettext
\end_layout
\end_inset
et peuvent être traduites correctement pour
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Nach
\end_layout
\end_inset
et
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Bis
\end_layout
\end_inset
, respectivement.
\end_layout
\begin_layout Standard
Bien entendu l'information contextuelle doit être supprimée de l'affichage
lorsqu'aucune traduction n'est utilisée, c'est pourquoi il faut la mettre
entre double crochets à la fin du message comme ci-dessus.
Le mécanisme de traduction de LyX assure que tout ce qui est entre double
crochets à la fin des messages est supprimé à l'affichage du message.
\end_layout
\begin_layout Subsection
Traduire la documentation
\end_layout
\begin_layout Standard
La documentation en ligne (dans le menu
\family sans
Aide
\family default
) peut (et doit !) être traduite.
S'il existe une traduction de la documentation
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
En mars 2008, au moins quelques documents avaient été traduit en14 langues,
le manuel d'apprentissage étant disponible en quelques autres.
\end_layout
\end_inset
, et si la locale est correctement réglée, LyX affichera tout seul la version
traduite.
LyX cherche les versions traduites sous le nom
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
RépLyX/doc/
\series bold
xx
\series default
_NomDoc.lyx
\end_layout
\end_inset
, où
\family typewriter
\series bold
xx
\family default
\series default
est e code pour la langue en cours d'utilisation.
S'il n'y a pas de traduction disponible, c'est la version anglaise qui
est affichée.
Notez que les versions traduites doivent avoir le même nom de fichier (ici
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
NomDoc
\end_layout
\end_inset
) que l'original.
Si vous vous sentez de traduire la documentation (ce qui est d'ailleurs
un excellent moyen de corriger la documentation d'origine !), il y a un
certain nombre de choses que vous devez faire tout de suite :
\end_layout
\begin_layout Itemize
faire un tour sur la page web de la
\begin_inset CommandInset href
LatexCommand href
name "traduction des documentations"
target "http://www.lyx.org/WebFr.Translation"
\end_inset
sur le site de LyX.
De cette façon, vous pourrez voir quels documents ont déjà été traduits
dans votre langue, s'il y en a.
Vous y trouverez aussi qui s'occupe d'organiser l'effort de traduction
dans votre langue.
Si personne ne s'en occupe, faites-nous connaître votre intérêt.
\end_layout
\begin_layout Standard
Une fois que vous vous y mettez pour de bon, voilà quelques conseils qui
pourront vous éviter des ennuis :
\end_layout
\begin_layout Itemize
joignez-vous à l'équipe de documentation !
\family typewriter
Intro.lyx
\family default
(
\family sans
Aide\SpecialChar \menuseparator
Introduction
\family default
) explique comment faire.
C'est d'ailleurs le premier document à traduire.
\end_layout
\begin_layout Itemize
étudiez les conventions typographiques de la langue dans laquelle vous traduisez.
La typographie est un art ancien et au cours des siècles, une grande variété
de conventions ont vu le jour dans les différentes parties du globe.
Apprenez aussi le vocabulaire spécifique des professionnels de la typographie
dans votre pays.
Si vous inventez votre propre terminologie, vous allez induire les lecteurs
en erreur.
(
\emph on
Attention ! La typographie peut devenir une passion !
\emph default
)
\end_layout
\begin_layout Itemize
faites une copie du document.
Ce sera votre fichier de travail.
Vous pouvez l'utiliser comme fichier d'aide personnel en le mettant dans
votre répertoire
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
MonRép/doc/xx/
\end_layout
\end_inset
.
\end_layout
\begin_layout Itemize
de temps à autre le document original (de l'équipe LyX) est mis à jour.
Utilisez
\begin_inset CommandInset href
LatexCommand href
name "l'interface d'affichage des source"
target "http://www.lyx.org/trac/browser"
\end_inset
pour voir ce qui a changé.
De cette façon vous pouvez voir facilement les parties de votre document
qui ont besoin d'être mises à jour
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT : Je conseille très vivement de partir des fichiers disponibles sur
Trac, et de ne pas perdre de temps à traduire la version contenue dans
votre distribution pour s'apercevoir trop tard que tout est périmé.
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
Si vous avez trouvé une erreur dans le document original, corrigez-la et
dites-le au reste de l'équipe de documentation (que vous n'avez pas manqué
de rejoindre, n'est-ce pas ?)
\end_layout
\begin_layout Standard
\begin_inset Branch Obsolete
status collapsed
\begin_layout Section
Support de Clavier International
\end_layout
\begin_layout Standard
\emph on
[Note de l'Éditeur : La section qui suit a été écrite par
\noun on
Ivan Schreter
\noun default
.
Il faut la corriger pour qu'elle soit conforme à la nouvelle feuille de
style de la Documentation et pour utiliser les nouvelles fonctions de la
version 1.0.
Le tout doit aussi être fusionné avec la section d'après.
- jw]
\end_layout
\begin_layout Subsection
Définir ses propres réaffectations clavier : Format de fichier
\family typewriter
.kmap
\end_layout
\begin_layout Standard
Regardons d'un peu plus près un fichier de définition de clavier.
C'est un fichier ASCII qui définit :
\end_layout
\begin_layout Itemize
des correspondances touche à touche ou touche à chaîne
\end_layout
\begin_layout Itemize
des touches mortes
\end_layout
\begin_layout Itemize
des exceptions des touches mortes
\end_layout
\begin_layout Standard
Pour définir une traduction touche à touche ou touche à chaîne, utilisez
cette commande :
\end_layout
\begin_layout Quotation
\family typewriter
\backslash
kmap touche
\family default
\family typewriter
chaîne_sortie
\end_layout
\begin_layout Standard
où
\family typewriter
touche
\family default
est la touche à traduire et
\family typewriter
chaîne_sortie
\family default
est la chaîne à insérer dans le document.
Pour définir des touches mortes, faites :
\end_layout
\begin_layout Quotation
\family typewriter
\backslash
kmod touche touche_morte
\end_layout
\begin_layout Standard
où
\family typewriter
touche
\family default
est la touche du clavier et
\family typewriter
touche_morte
\family default
est le nom de la touche morte.
Les touches mortes suivantes sont supportées (nom du raccourci entre parenthèse
s) :
\end_layout
\begin_layout Quotation
\emph on
Nom
\begin_inset space \hfill{}
\end_inset
Exemple
\end_layout
\begin_layout Quotation
acute (acu)
\begin_inset space \hfill{}
\end_inset
áéíóú
\end_layout
\begin_layout Quotation
grave (gra)
\begin_inset space \hfill{}
\end_inset
àèìòù
\end_layout
\begin_layout Quotation
macron (mac)
\begin_inset space \hfill{}
\end_inset
ō
\end_layout
\begin_layout Quotation
tilde (til)
\begin_inset space \hfill{}
\end_inset
ñÑ
\end_layout
\begin_layout Quotation
underbar (underb)
\begin_inset space \hfill{}
\end_inset
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
b o
\end_layout
\end_inset
\end_layout
\begin_layout Quotation
cedilla (ced)
\begin_inset space \hfill{}
\end_inset
çÇ
\end_layout
\begin_layout Quotation
underdot (underd)
\begin_inset space \hfill{}
\end_inset
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
d o
\end_layout
\end_inset
\end_layout
\begin_layout Quotation
circumflex (circu)
\begin_inset space \hfill{}
\end_inset
âêîôû
\end_layout
\begin_layout Quotation
circle (circl)
\begin_inset space \hfill{}
\end_inset
ÅůŮ
\end_layout
\begin_layout Quotation
tie (tie)
\begin_inset space \hfill{}
\end_inset
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
t o
\end_layout
\end_inset
\end_layout
\begin_layout Quotation
breve (bre)
\begin_inset space \hfill{}
\end_inset
ă
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
u o
\end_layout
\end_inset
\end_layout
\begin_layout Quotation
caron (car)
\begin_inset space \hfill{}
\end_inset
čšž
\end_layout
\begin_layout Quotation
hungarian umlaut (hug)
\begin_inset space \hfill{}
\end_inset
őű
\end_layout
\begin_layout Quotation
umlaut (uml)
\begin_inset space \hfill{}
\end_inset
äöü
\end_layout
\begin_layout Quotation
dot (dot)
\begin_inset space \hfill{}
\end_inset
ż
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
.s
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Dans beaucoup de claviers internationaux il y a des exceptions dans les
règles d'emploi des touches mortes, vous pouvez les définir ainsi :
\end_layout
\begin_layout Quotation
\family typewriter
\backslash
kxmod touche_morte touche chaîne_sortie
\end_layout
\begin_layout Standard
Par exemple, sur un clavier slovaque, si vous tapez caron-o, ça génère circonfle
xe-o, il faut donc mettre :
\end_layout
\begin_layout Quotation
\family typewriter
\backslash
kxmod
\family default
\family typewriter
caron o "
\backslash
^o"
\end_layout
\begin_layout Standard
pour le faire marcher correctement.
Vous devez aussi définir comme des exceptions les touches mortes avec i
et j, pour enlever le point avant d'insérer une marque d'accentuation.
Je changerai ceci le moment venu, mais je n'en ai pas encore eu le temps.
\end_layout
\begin_layout Standard
Au fait, à propos des caractères : l'antislash est un caractère d'échappement,
pour l'entrer, il faut taper un double antislash.
Les guillemets et
\family typewriter
#
\family default
ont aussi un sens différent.
\family typewriter
#
\family default
indique les commentaires, les guillemets entourent les commandes style
LaTeX.
Pour entrer un guillemet, il faut taper
\family typewriter
\backslash
"
\family default
, pour entrer
\family typewriter
#
\family default
, il faut taper
\family typewriter
\backslash
#
\family default
.
\end_layout
\begin_layout Standard
Si vous faites un fichier de réaffectation clavier qui marche pour votre
langue, merci de me l'envoyer, pour que je puisse l'inclure dans la prochaine
distribution de réaffectations clavier.
\end_layout
\begin_layout Standard
Il y aura plus de mots-clés supportés à l'avenir dans les fichiers de réaffectat
ion clavier, comme :
\end_layout
\begin_layout Itemize
\family typewriter
\backslash
kinclude nom_fichier
\family default
\begin_inset space \hfill{}
\end_inset
inclut un autre fichier (
\family typewriter
include
\family default
)
\end_layout
\begin_layout Itemize
\family typewriter
\backslash
kprog programme
\family default
\begin_inset space \hfill{}
\end_inset
définit un programme externe de traduction (
\family typewriter
define
\family default
)
\end_layout
\begin_layout Standard
Il devrait aussi chercher dans
\family typewriter
lyxrc
\family default
les valeurs par défaut (par exemple, une option
\family typewriter
\backslash
kinclude
\family default
pour inclure le clavier par défaut).
\end_layout
\end_inset
\end_layout
\begin_layout Section
Les Claviers Internationaux
\begin_inset CommandInset label
LatexCommand label
name "sec:clavier"
\end_inset
\end_layout
\begin_layout Standard
\begin_inset Note Note
status collapsed
\begin_layout Plain Layout
En révisant ce document en mars 2008, le relecteur anglophone n'a pas vérifié
cette section par manque de compréhension de son contenu.
Ce serait bien que quelqu'un s'en charge.
Le traducteur francophone (SMGC) l'avait traduit tel quel, le relecteur
francophone (JPC) l'a relu tel quel.
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Les deux sections suivantes décrivent en détail la syntaxe des fichiers
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
.kmap
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
.cdef
\end_layout
\end_inset
.
Ces sections devraient vous aider à concevoir votre propre réaffectation
clavier si celles fournies ne vous donnent pas satisfaction.
\end_layout
\begin_layout Subsection
Le fichier
\family typewriter
.kmap
\end_layout
\begin_layout Standard
Un fichier
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
.kmap
\end_layout
\end_inset
fait correspondre des appuis clavier à des caractères ou à des chaînes
de caractères.
Il définit une réaffectation clavier
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT : Keyboard MAPping.
\end_layout
\end_inset
.
Cette section décrit les mots clés
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
kmap
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
kmod
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
kxmod
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
kcomb
\end_layout
\end_inset
des fichiers
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
.kmap
\end_layout
\end_inset
.
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
kmap
\end_layout
\end_inset
fait correspondre un caractère à une chaîne
\end_layout
\begin_layout LyX-Code
\backslash
kmap
\family roman
\emph on
caractère chaîne
\end_layout
\begin_layout Standard
Ceci fait correspondre
\emph on
chaîne
\emph default
à
\emph on
caractère
\emph default
.
Notez que dans
\emph on
chaîne
\emph default
, le guillemet double (
\family typewriter
"
\family default
) et l'antislash (
\family typewriter
\backslash
\family default
) doivent être protégés par un antislash (
\family typewriter
\backslash
\family default
) juste avant-++.
\end_layout
\begin_layout Standard
Voici un exemple de commande
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
kmap
\end_layout
\end_inset
qui fait s'afficher le symbole
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
/
\end_layout
\end_inset
quand on tape la touche
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
&
\end_layout
\end_inset
:
\end_layout
\begin_layout LyX-Code
\family typewriter
\backslash
kmap & /
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
kmod
\end_layout
\end_inset
définit un caractère accentué
\end_layout
\begin_layout LyX-Code
\backslash
kmod
\family roman
\emph on
caractère accent autorisés
\end_layout
\begin_layout Standard
Le
\emph on
caractère
\emph default
devient alors un
\emph on
accent
\emph default
sur les caractères
\emph on
autorisés
\emph default
.
C'est le principe de la touche morte
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Le terme
\emph on
touche morte
\emph default
désigne une touche qui seule ne produit pas de caractère, mais qui produit
le caractère accentué voulu quand elle est suivie par une autre touche
autorisée.
Par exemple, pour écrire un
\family typewriter
\begin_inset Quotes fld
\end_inset
ê
\begin_inset Quotes frd
\end_inset
\family default
sur un clavier français, il faut d'abord taper sur
\family typewriter
\begin_inset Quotes fld
\end_inset
^
\begin_inset Quotes frd
\end_inset
\family default
puis sur
\family typewriter
\begin_inset Quotes fld
\end_inset
e
\begin_inset Quotes frd
\end_inset
\family default
.
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
Si vous tapez
\emph on
caractère
\emph default
puis une autre touche qui ne fait pas partie des caractères
\emph on
autorisés
\emph default
, vous obtiendrez un
\emph on
caractère
\emph default
suivi par l'autre touche non autorisée.
Notez que
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Ret.Arr
\end_layout
\end_inset
efface une touche morte, si vous tapez
\emph on
caractère
\emph default
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Ret.Arr
\end_layout
\end_inset
, le curseur ne recule pas mais annule l'effet que
\emph on
caractère
\emph default
aurait pu avoir sur la touche suivante.
\end_layout
\begin_layout Standard
Dans l'exemple suivant, il est spécifié que le caractère ' doit être un
accent aigu, autorisé sur les caractères a, e, i, o, u, A, E, I, O et U
:
\end_layout
\begin_layout LyX-Code
\backslash
kmod ' acute aeiouAEIOU
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
kxmod
\end_layout
\end_inset
définit une exception au caractère accentué
\end_layout
\begin_layout LyX-Code
\backslash
kxmod
\family roman
\emph on
accent caractère résultat
\end_layout
\begin_layout Standard
Ceci définit une exception pour l'
\emph on
accent
\emph default
sur le
\emph on
caractère
\emph default
.
L'
\emph on
accent
\emph default
doit avoir été assigné auparavant par une déclaration
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\backslash
kmod
\end_layout
\end_inset
et le
\emph on
caractère
\emph default
ne doit pas faire partie des caractères
\emph on
autorisés
\emph default
de l'
\emph on
accent
\emph default
.
Quand vous tapez la séquence
\emph on
accent
\emph default
\emph on
caractère
\emph default
, se produit le
\emph on
résultat
\emph default
.
Si une telle déclaration n'existe pas dans le fichier
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
.kmap
\end_layout
\end_inset
et que vous tapez
\emph on
accent caractère
\emph default
, vous obtenez
\emph on
touche_accent caractère
\emph default
où
\emph on
touche_accent
\emph default
est le premier paramètre de la déclaration
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\backslash
kmod
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
Avec la commande suivante, vous obtenez äi quand vous tapez acute-i ('i)
:
\end_layout
\begin_layout LyX-Code
\backslash
kxmod acute i "
\backslash
\backslash
'{
\backslash
\backslash
i}"
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
kcomb
\end_layout
\end_inset
Combine deux caractères accentués
\end_layout
\begin_layout LyX-Code
\backslash
kcomb
\family roman
\emph on
accent1 accent2 autorisés
\end_layout
\begin_layout Standard
Celui-ci est assez ésotérique.
Il vous permet de combiner les effets de l'
\emph on
accent1
\emph default
et de l'
\emph on
accent2
\emph default
(dans cet ordre !) sur les caractères
\emph on
autorisés
\emph default
.
Les touches pour l'
\emph on
accent1
\emph default
et l'
\emph on
accent2
\emph default
doivent avoir été définies par une commande
\family typewriter
\backslash
kmod
\family default
\emph on
plus haut
\emph default
dans le fichier.
\end_layout
\begin_layout Standard
Voyez cet exemple extrait du fichier
\family typewriter
greek.kmap
\family default
:
\end_layout
\begin_layout LyX-Code
\backslash
kmod ; acute aeioyvhAEIOYVH
\end_layout
\begin_layout LyX-Code
\backslash
kmod : umlaut iyIY
\end_layout
\begin_layout LyX-Code
\backslash
kcomb acute umlaut iyIY
\end_layout
\begin_layout Standard
Ça vous permet de taper
\family typewriter
;:i
\family default
et d'avoir l'effet de
\family typewriter
\backslash
'{
\backslash
"{i}}
\family default
.
Dans ce cas un
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Ret.Arr
\end_layout
\end_inset
annule la dernière touche morte, donc si vous tapez
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
;:Backspace i
\end_layout
\end_inset
vous obtenez
\family typewriter
\backslash
'{i}
\family default
.
\end_layout
\begin_layout Subsection
Le fichier
\family typewriter
.cdef
\end_layout
\begin_layout Standard
Après que la réaffectation
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
.kmap
\end_layout
\end_inset
a été effectuée, un fichier
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
.cdef
\end_layout
\end_inset
convertit les chaînes de symboles obtenues dans la police de caractères.
Actuellement, la distribution de LyX comprend au moins les fichiers
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
iso8859-1.cdef
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
iso8859-2.cdef
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
En général le fichier
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
.cdef
\end_layout
\end_inset
est une suite de déclarations de la forme :
\end_layout
\begin_layout LyX-Code
\family roman
\emph on
numéro_du_caractère chaîne
\end_layout
\begin_layout Standard
Par exemple, pour affecter
\family typewriter
\backslash
'{e}
\family default
au caractère correspondant dans le jeu iso-8859-1 (233), il y a la déclaration
suivante :
\end_layout
\begin_layout LyX-Code
233 "
\backslash
\backslash
'{e}"
\end_layout
\begin_layout Standard
avec
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\backslash
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
"
\end_layout
\end_inset
protégés dans
\emph on
chaîne
\emph default
.
Notez que le même caractère peut servir pour plus d'une chaîne.
Dans le fichier
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
iso-8859-7.cdef
\end_layout
\end_inset
vous avez
\end_layout
\begin_layout LyX-Code
192 "
\backslash
\backslash
'{
\backslash
\backslash
\backslash
"{i}}"
\begin_inset Newline newline
\end_inset
192 "
\backslash
\backslash
\backslash
"{
\backslash
\backslash
'{i}}"
\end_layout
\begin_layout Standard
Si LyX ne trouve pas de correspondance pour la chaîne produite par une touche
ou une séquence avec des touches mortes, il va vérifier si elle ressemble
à un caractère accentué et va essayer à l'écran de tracer un accent par
dessus le caractère.
\end_layout
\begin_layout Subsection
Touches mortes
\end_layout
\begin_layout Standard
Il y a une autre façon d'ajouter le support pour des caractères internationaux
par l'intermédiaire des touches mortes.
Une touche morte marche en combinaison avec une lettre pour produire un
caractère accentué.
Ici, nous allons expliquer comment créer une touche morte vraiment simple
pour montrer comment elles marchent.
\end_layout
\begin_layout Standard
Supposez que vous ayez besoin du caractère circonflexe
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT : déjà présent en français, mais nous allons conserver cet exemple.
\end_layout
\end_inset
,
\family typewriter
\begin_inset Quotes fld
\end_inset
^
\begin_inset Quotes frd
\end_inset
\family default
.
Vous devez faire correspondre la touche circonflexe à la commande LyX
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
accent-circumflex
\end_layout
\end_inset
dans votre fichier
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
lyxrc
\end_layout
\end_inset
.
Maintenant, à chaque fois que vous taperez la touche circonflexe suivie
par une lettre, il y aura un accent circonflexe dessus.
Par exemple, la séquence
\family typewriter
\begin_inset Quotes fld
\end_inset
\family default
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
^e
\end_layout
\end_inset
\family typewriter
\begin_inset Quotes frd
\end_inset
\family default
produit la lettre
\family typewriter
\begin_inset Quotes fld
\end_inset
\family default
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
ê
\end_layout
\end_inset
\family typewriter
\begin_inset Quotes frd
\end_inset
\family default
.
Cependant, si vous essayez de taper
\family typewriter
\begin_inset Quotes fld
\end_inset
\family default
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
^t
\end_layout
\end_inset
\family typewriter
\begin_inset Quotes frd
\end_inset
\family default
, LyX va se plaindre avec un bip, car un
\family typewriter
\begin_inset Quotes fld
\end_inset
\family default
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
t
\end_layout
\end_inset
\family typewriter
\begin_inset Quotes frd
\end_inset
\family default
ne prend jamais d'accent circonflexe.
Taper
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Espace
\end_layout
\end_inset
après une touche morte fait s'afficher l'accent seul.
Notez bien ce dernier point ! Si vous faites correspondre une touche à
une touche morte, vous devez faire correspondre le caractère sur cette
touche à une touche différente.
Faire correspondre la virgule à une cédille est une mauvaise idée, car
vous n'aurez plus que des cédilles à la place des virgules.
\end_layout
\begin_layout Standard
Une façon courante de créer des touches mortes est d'utiliser
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Meta-
\end_layout
\end_inset
,
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Ctrl-
\end_layout
\end_inset
ou
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Maj-
\end_layout
\end_inset
en combinaison avec un accent, comme
\family typewriter
\begin_inset Quotes fld
\end_inset
~
\begin_inset Quotes frd
\end_inset
\family default
ou
\family typewriter
\begin_inset Quotes fld
\end_inset
^
\begin_inset Quotes frd
\end_inset
\family default
.
Une autre méthode met en jeu
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
xmodmap
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
xkeycaps
\end_layout
\end_inset
(vus dans le
\emph on
Guide
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
l'Utilisateur
\emph default
) pour configurer la touche spéciale
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Mode_Switch
\end_layout
\end_inset
.
Elle agit un peu comme
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Maj
\end_layout
\end_inset
et permet de faire correspondre des touches à des caractères accentués.
Vous pouvez aussi transformer des touches en touches mortes en les affectant
à quelque chose comme
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
usldead_cedilla
\end_layout
\end_inset
puis en affectant cette touche symbolique à la commande LyX correspondante
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Note de
\noun on
John Weiss
\noun default
: C'est exactement ce que je fais dans mes fichiers
\family typewriter
~/.lyx/lyxrc
\family default
et
\family typewriter
~/.xmodmap
\family default
.
Ma touche
\family sans
Arrêt
\begin_inset space ~
\end_inset
Défil
\family default
(ou
\family sans
Scroll
\begin_inset space ~
\end_inset
Lock
\family default
) est configurée comme
\family typewriter
Mode_Switch
\family default
et j'ai affecté des choses comme
\family sans
Arrêt
\begin_inset space ~
\end_inset
Défil-^
\family default
ou
\family sans
Arrêt
\begin_inset space ~
\end_inset
Défil-~
\family default
à un tas de touches symboliques
\family typewriter
\begin_inset Quotes fld
\end_inset
usldead_*
\begin_inset Quotes frd
\end_inset
\family default
.
C'est comme ça que j'obtiens tous mes caractères accentués.
\end_layout
\end_inset
.
Vous pouvez transformer à peu près n'importe quelle touche en touche
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Mode_Switch
\end_layout
\end_inset
: une des touches
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Ctrl-
\end_layout
\end_inset
, une touche de fonction inutilisée, etc.
Quant aux commandes LyX qui produisent des accents, voyez à l'entrée
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
accent-acute
\end_layout
\end_inset
dans le
\emph on
Manuel
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
Référence
\emph default
.
Là-bas il y a la liste complète.
\end_layout
\begin_layout Subsection
Enregistrer votre Configuration Linguistique
\end_layout
\begin_layout Standard
Vous pouvez éditer vos préférences dans la fenêtre
\family sans
Outils\SpecialChar \menuseparator
Préférences
\family default
pour que LyX démarre avec l'environnement linguistique que vous souhaitez,
automatiquement configuré.
\end_layout
\begin_layout LyX-Code
\end_layout
\begin_layout Chapter
Installer de nouvelles classes de document, formats et modèles
\begin_inset CommandInset label
LatexCommand label
name "chap:classe-texte"
\end_inset
\begin_inset Argument
status collapsed
\begin_layout Plain Layout
Installer de nouvelles classes
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Dans ce chapitre, nous décrivons comment créer et installer de nouveaux
fichiers de format LyX ou de modèle, et nous vous offrons une révision
des procédures correctes d'installation de nouvelles classes de document
LaTeX.
\end_layout
\begin_layout Standard
D'abord, quelques mots pour décrire une bonne approche de la relation entre
LyX et LaTeX.
Ce qu'il faut bien comprendre, c'est qu'en certain sens, LyX ne sait rien
de LaTeX.
De fait, du point de vue de LyX, LaTeX est juste un
\begin_inset Quotes fld
\end_inset
format de sortie
\begin_inset Quotes frd
\end_inset
particulier parmi d'autres formats susceptibles de produire un résultat.
D'autres formats sont DocBook, texte brut, et XHTML.
LaTeX est bien entendu un format particulièrement important, mais une très
petite quantité d'information concernant LaTeX est réellement contenue
dans LyX
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Certaines commandes sont suffisamment compliquées pour être codées
\begin_inset Quotes fld
\end_inset
en dur
\begin_inset Quotes frd
\end_inset
dans les sources LyX, mais les développeurs considères que c'est une mauvaise
chose.
\end_layout
\end_inset
.
Cette information, même pour des classes standard comme
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
article.cls
\end_layout
\end_inset
, est contenue dans les
\begin_inset Quotes fld
\end_inset
fichiers de format
\begin_inset Quotes frd
\end_inset
.
De même, LyX ne connaît pas grand chose de DocBook ou XHTML, tout est décrit
dans les fichiers de format.
\end_layout
\begin_layout Standard
Vous pouvez imaginer un fichier de format pour une classe de document donnée
comme un traducteur entre les constructions LyX --- paragraphes et leur
style associé, certains types d'inserts, etc.
--- et les constructions LaTeX, DocBook ou XHTML correspondantes.
Pratiquement tout ce que LyX sait de la classe
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
article.cls
\end_layout
\end_inset
, par exemple, est contenu dans le ficher
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
article.layout
\end_layout
\end_inset
et dans les fichiers inclus par celui-ci.
Pour cette raison, un étude approfondie de ces fichiers est une bonne idée
si vous avez l'intention d'écrire un fichier de format.
Un bon point de départ est le fichier
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
stdsections.inc
\end_layout
\end_inset
, inclus par
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
article.layout
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
book.layout
\end_layout
\end_inset
et de nombreux autres fichiers de format pour de classes de document LaTeX.
C'est dans ce fichier que sont définies les sections et les constructions
similaires:
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
stdsections.lyx
\end_layout
\end_inset
décrit pour LyX comment les paragraphes marqués en style Section, SousSection,
etc.
peuvent être traduits en commandes ou balises LaTeX, DocBook et XHTML.
Le fichier article.layout ne contient essentiellement que des inclusions
de ces fichiers
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
std*.inc
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
Définir la correspondance LyX-LaTeX n'est cependant pas la seule fonction
des fichiers de format.
Leur autre but est de préciser comment les constructions LyX apparaîtront
à l'écran.
Le fait que ces fichiers assurent ces deux fonctions est souvent source
de confusion, parce qu'elles sont tout à fait séparées: expliquer à LyX
comment traduire un style de paragraphe en LaTeX ne lui dit pas comment
l'afficher; inversement, expliquer à LyX comment afficher un paragraphe
ne lui dit pas comment le traduire en LaTeX (sans parler de lui dire comment
LaTeX doit l'afficher).
Par conséquent, en général, quand vous devez définir une nouvelle construction
LyX, vous devez toujours effectuer deux tâches distinctes: (a) écrire comment
la traduire en LaTeX et (b) écrire comment l'afficher.
\end_layout
\begin_layout Standard
La même distinction est vraie pour les autre formats de sortie, bien que
XHTML soit différent sous divers aspects, du fait que dans ce cas LyX est
capable d'utiliser au moins partiellement l'information concernant l'affichage
à l'écran pour créer l'information (sous forme de CSS) nécessaire à l'affichage
dans un navigateur.
Même dans ce cas, cependant, la distinction entre les mécanismes internes
de LyX et la façon dont les objets sont restitués à l'extérieur reste valide,
et le contrôle séparé des deux facettes reste possible.
Voir la section
\begin_inset space ~
\end_inset
pour les détails.
\end_layout
\begin_layout Section
Installer de nouveaux fichiers LaTeX
\end_layout
\begin_layout Standard
Certaines installations peuvent ne pas contenir le paquetage LaTeX que vous
vouliez justement utiliser avec LyX.
Par exemple, vous pouvez avoir besoin de FoilTeX, un paquetage pour préparer
des transparents pour rétroprojecteurs.
Les distributions LaTeX récentes comme TeXLive (depuis 2008) ou MiKTeX
incluent une interface utilisateur pour installer de tels paquetages.
Par exemple avec MiKTeX, vous démarrez le programme
\begin_inset Quotes fld
\end_inset
Package
\begin_inset space ~
\end_inset
Manager
\begin_inset Quotes frd
\end_inset
pour afficher une liste des paquetages disponibles.
Pour installer l'un d'entre eux, il suffit d'effectuer un clic droit sur
son nom ou sur le bouton correspondant de la barre d'outil.
\end_layout
\begin_layout Standard
Si votre distribution LaTeX n'inclut pas un tel gestionnaire de paquetage,
ou si le paquetage n'est pas disponible pour votre distribution, alors
faites comme suit pour l'installer manuellement:
\end_layout
\begin_layout Enumerate
Récupérer le paquetage depuis
\begin_inset CommandInset href
LatexCommand href
name "CTAN"
target "http://www.ctan.org/"
\end_inset
ou ailleurs;
\end_layout
\begin_layout Enumerate
Si le paquetage contient un fichier doté d'un suffixe
\begin_inset Quotes fld
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
.ins
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
(c'est le cas pour FoilTeX), alors ouvrir une console, aller dans le répertoire
de ce fichier et exécuter la commande
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
latex foiltex.ins
\end_layout
\end_inset
.
Vous avez ainsi déplié le paquetage et vous disposez des fichiers nécessaires
à l'installation.
De nombreux paquetages ne sont pas reliés et vous pouvez sauter cette étape.
\end_layout
\begin_layout Enumerate
Vous devez alors décider si ce paquetage doit être disponible pour tous
les utilisateurs ou seulement pour vous-même.
\end_layout
\begin_deeper
\begin_layout Enumerate
Avec les systèmes *nix (Linux, OSX, etc.), si vous souhaitez que le paquetage
soit disponible pour tous les utilisateurs, installez-le dans l'arborescence
TeX
\begin_inset Quotes fld
\end_inset
locale
\begin_inset Quotes frd
\end_inset
, sinon installez-le dans votre arborescence TeX
\begin_inset Quotes fld
\end_inset
utilisateur
\begin_inset Quotes frd
\end_inset
.
La nécessité de créer ces arborescences, si elles n'existent pas déjà,
dépend de votre système.
Pour le savoir, examinez le fichier
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
texmf.cnf
\end_layout
\end_inset
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Ce fichier est habituellement dans le répertoire
\family sans
$TEXMF/web2c
\family default
, bien que vous puissiez exécuter la commande
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
kpsewhich texmf.cnf
\end_layout
\end_inset
pour le localiser.
\end_layout
\end_inset
.
L'emplacement de l'arborescence
\begin_inset Quotes fld
\end_inset
locale
\begin_inset Quotes frd
\end_inset
est définie par la variable
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
TEXMFLOCAL
\end_layout
\end_inset
; elle a usuellement pour valeur
\family sans
/usr/local/share/texmf/
\family default
.
L'emplacement de l'arborescence
\begin_inset Quotes fld
\end_inset
utilisateur
\begin_inset Quotes frd
\end_inset
est définie par
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
TEXMFHOME
\end_layout
\end_inset
et vaut d'habitude
\family sans
$HOME/texmf/
\family default
(si ces variables ne sont pas prédéfinies, vous devrez le faire vous-même).
Vous aurez besoin d'avoir les droits d'administration système pour créer
ou modifier l'arborescence
\begin_inset Quotes fld
\end_inset
locale
\begin_inset Quotes frd
\end_inset
, mais votre arborescence
\begin_inset Quotes fld
\end_inset
utilisateur
\begin_inset Quotes frd
\end_inset
ne devrait pas nécessiter de tels droits.
\begin_inset Newline newline
\end_inset
D'une manière générale, il est recommandable d'installer dans le répertoire
utilisateur parce que cette arborescence ne sera pas modifiée lors d'une
mise à jour de votre système.
Elle sera également sauvegardée avec tout le reste lors de le sauvegarde
de votre répertoire utilisateur
\begin_inset Quotes fld
\end_inset
home
\begin_inset Quotes frd
\end_inset
(que vous effectuez régulièrement, bien entendu).
\end_layout
\begin_layout Enumerate
Avec Windows, si vous souhaitez que le nouveau paquetage soit disponibles
pour tous les utilisateurs de votre système, allez dans le répertoire où
LaTeX est installé, puis dans le sous-répertoire
\family sans
~
\backslash
tex
\backslash
latex
\family default
(pour MiKTeX, celui-ci sera implicitement
\family sans
~:
\backslash
Programs
\backslash
MiKTeX
\backslash
tex
\backslash
latex
\family default
)
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Notez que ce chemin sera celui des installations anglophones.
Pour une installation germanophone, ce serait
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
~:
\backslash
Programme
\backslash
MiKTeX
\backslash
tex
\backslash
latex
\end_layout
\end_inset
, de même pour d'autres langages.
\end_layout
\end_inset
.
Créer dans ce répertoire un nouveau répertoire dénommé
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
foiltex
\end_layout
\end_inset
et copiez tous les fichiers du paquetage dedans.
Si le paquetage ne doit être accessible que par vous ou si vous n'avez
pas les droits d'administration, faites de même, mais dans le répertoire
LaTeX local, e.g.
avec MiKTeX 2.8 sur WinXP le répertoire
\begin_inset Newline newline
\end_inset
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
~:
\backslash
Documents and Settings
\backslash
<username>
\backslash
Application Data
\backslash
\end_layout
\end_inset
\begin_inset Newline newline
\end_inset
\begin_inset Phantom HPhantom
status open
\begin_layout Plain Layout
\family sans
\lang english
~:
\backslash
\end_layout
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
MiKTeX
\backslash
2.8
\backslash
tex
\backslash
latex
\end_layout
\end_inset
\family sans
\lang french
.
\family default
\begin_inset Newline newline
\end_inset
Avec Vista ce sera le répertoire
\begin_inset Newline newline
\end_inset
\family sans
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\family sans
~:
\backslash
Users
\backslash
<username>
\backslash
AppData
\backslash
Roaming
\backslash
2.8
\backslash
MiKTeX
\backslash
tex
\backslash
latex
\end_layout
\end_inset
.
\end_layout
\end_deeper
\begin_layout Enumerate
Vous devez alors informer LaTeX de la présence de nouveaux fichiers.
Ceci dépend de nouveau de la distribution LaTeX:
\end_layout
\begin_deeper
\begin_layout Enumerate
Avec TeXLive, exécuter la commande
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
texhash
\end_layout
\end_inset
dans une console.
Si vous avez installé le paquetage pour tous les utilisateurs, vous aurez
besoin des droits d'administration pour ce faire.
\end_layout
\begin_layout Enumerate
Avec MiKTeX, si vous avez installé le paquetage pour tous les utilisateurs,
démarrez le programme
\begin_inset Quotes fld
\end_inset
Settings
\begin_inset space ~
\end_inset
(Admin)
\begin_inset Quotes frd
\end_inset
et appuyez sur le bouton
\begin_inset Quotes fld
\end_inset
Refresh FNDB
\begin_inset Quotes frd
\end_inset
.
Sinon démarrez le programme
\begin_inset Quotes fld
\end_inset
Settings
\begin_inset Quotes frd
\end_inset
et faites de même.
\end_layout
\end_deeper
\begin_layout Enumerate
Enfin, vous devez informer LyX de l'existence de nouveaux paquetages: dans
LyX, utilisez le menu
\family sans
Outils\SpecialChar \menuseparator
Reconfigurer
\family default
, puis redémarrez LyX.
\end_layout
\begin_layout Standard
Le paquetage est maintenant installé.
Dans notre exemple, la classe de document
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Slides
\begin_inset space ~
\end_inset
(FoilTe
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
{}
\end_layout
\end_inset
x)
\end_layout
\end_inset
est maintenant disponible dans
\family sans
Document\SpecialChar \menuseparator
Paramètres\SpecialChar \ldots{}
\SpecialChar \menuseparator
Classe du document
\family default
.
\end_layout
\begin_layout Standard
Si vous souhaitez utiliser une classe de document qui ne figure pas dans
la liste
\family sans
Document\SpecialChar \menuseparator
Paramètres\SpecialChar \ldots{}
\SpecialChar \menuseparator
Classe du document
\family default
, vous devez créer une fichier de
\begin_inset Quotes fld
\end_inset
format
\begin_inset Quotes frd
\end_inset
(
\begin_inset Quotes fld
\end_inset
layout
\begin_inset Quotes frd
\end_inset
) pour celle-ci.
Ceci est le sujet du paragraphe suivant.
\end_layout
\begin_layout Section
Types de fichiers de formats
\end_layout
\begin_layout Standard
Cette section décrit les différentes variétés de fichiers contenant les
informations de format: instructions pour l'affichage par LyX et pour la
traduction en LaTeX, DocBook ou XHTML, ou autre format de sortie désiré,
des styles de paragraphe et de caractère variés.
\end_layout
\begin_layout Standard
Nous essayons ici de donner une description complète de la procédure à suivre
; il y a cependant une telle variété de classes LaTeX supportant des types
de document très différents que nous ne pouvons pas espérer couvrir tous
les cas possibles ni tous les problèmes que vous pourrez rencontrer.
La liste de messagerie des utilisateurs LyX est fréquentée par des personnes
expérimentées dans l'écriture des formats, qui voudront partager ce qu'elles
ont appris, n'hésitez pas à poser des questions sur cette liste.
\end_layout
\begin_layout Standard
Quand vous prévoyez d'écrire un nouveau format, il est extrêmement utile
de regarder les formats distribués avec LyX.
Si vous écrivez un fichier de format pour une classe de document LaTeX
qui pourrait intéresser d'autres personnes, ou si vous écrivez un module
utile, vous pouvez envisager de l'insérer dans les
\begin_inset CommandInset href
LatexCommand href
name "pages dans le wiki LyX"
target "http://wiki.lyx.org/Layouts/Layouts"
\end_inset
, voire de le soumettre à la liste des développeurs, pour qu'il figure dans
la distribution de LyX proprement dite
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Notez bien que du fait que LyX est diffusé sous licence GPL (General Public
License), toute contribution doit être également sous licence GPL.
\end_layout
\end_inset
.
\end_layout
\begin_layout Subsection
Modules de format
\begin_inset CommandInset label
LatexCommand label
name "sub:Modules_de_format"
\end_inset
\end_layout
\begin_layout Standard
Nous avons mentionné jusqu'ici les
\begin_inset Quotes fld
\end_inset
fichier de format
\begin_inset Quotes frd
\end_inset
.
mais il existe différentes sortes de fichiers qui contiennent des informations
de format.
Les fichiers de format au sens strict ont pour suffixe
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
.layout
\end_layout
\end_inset
et contiennent l'information nécessaire à LyX pour les classes de document.
Depuis LyX 1.6, cependant, les informations de format peuvent être incluses
dans les
\emph on
modules
\emph default
de format, qui ont pour suffixe
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
.module
\end_layout
\end_inset
.
Les modules sont aux paquetages LaTeX à peu près ce que sont les fichiers
de format aux classes de document, et certains modules — tels que le module
\begin_inset Quotes fld
\end_inset
endnotes
\begin_inset Quotes frd
\end_inset
— offrent la fonctionnalité d'un seul paquetage.
En un sens, le modules de format sont aussi similaires aux fichiers d'inclusion
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Ceux-ci peuvent avoir un suffixe quelconque, mais par convention il leur
a été attribué le suffixe
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
.inc
\end_layout
\end_inset
.
\end_layout
\end_inset
— des fichiers comme
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
stdsections.inc
\end_layout
\end_inset
— dans le fait que les modules ne sont pas spécifiques du format d'un document
donné, mais peuvent être utilisés avec de nombreux formats différents.
Cependant l'utilisation d'un fichier d'inclusion (dans
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
article.cls
\end_layout
\end_inset
par exemple) nécessite la modification du fichier de format
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
article.layout
\end_layout
\end_inset
; au lieu de cette modification, les modules sont sélectionnés dans la page
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
Document\SpecialChar \menuseparator
Paramètres\SpecialChar \ldots{}
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Rédiger des modules est la façon la plus simple de se familiariser avec
l'écriture des formats, puisque ce peut être aussi simple que l'ajout d'un
seul nouveau paragraphe ou insert.
Mais en principe, les modules peuvent inclure tout ce que peuvent inclure
les formats.
\end_layout
\begin_layout Standard
Après la création d'un nouveau module, vous devrez reconfigurer et redémarrer
LyX pour que le module apparaisse dans le menu.
Cependant, les modifications que vous faites dans le module seront immédiatemen
t actives, si vous ouvrez
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
Document\SpecialChar \menuseparator
Paramètres\SpecialChar \ldots{}
\SpecialChar \menuseparator
Modules
\end_layout
\end_inset
, sélectionnez une module et appuyez sur
\begin_inset Quotes fld
\end_inset
OK
\begin_inset Quotes frd
\end_inset
.
\emph on
Il vous est fortement recommandé d
\emph default
at
\emph on
e sauvegarder votre travail avant de procéder ainsi
\emph default
.
En fait,
\emph on
il vous est fortement recommandé de ne pas essayer de modifier des modules
durant une travail productif sur un document
\emph default
.
Bien évidemment, les développeurs s'efforcent de conserver une bonne stabilité
à LyX dans de telles situations, mais les erreurs de syntaxe et autres
dans votre module pourraient déclencher des comportements bizarres.
\end_layout
\begin_layout Subsection
Format pour un fichier
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
.sty
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Les deux situations que vous êtes probablement susceptibles de rencontrer
quand vous voulez gérer une nouvelle classe de document LaTeX sont les
fichiers LaTeX2e de classe (
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
.cls
\end_layout
\end_inset
) et de style (
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
.sty
\end_layout
\end_inset
).
Interfacer une nouveau fichier de style est assez facile, Interfacer une
nouvelle classe est plus compliqué: nous allons décrire la première opération
ici, et la seconde dans le paragraphe suivant.
Des considérations analogues s'appliquent bien entendu si vous voulez interface
r une nouvelle DTD DocBook.
\end_layout
\begin_layout Standard
La situation la plus simple se présente si votre nouvelle classe de document
est fournie sous la forme d'un fichier de style à utiliser en combinaison
avec une classe de document existante, déjà interfacée.
Dans notre exemple, le fichier de style sera appelé
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
ma_classe.sty
\end_layout
\end_inset
et il doit être utilisé avec la classe standard
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
report.cls
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
Commencez par copier le fichier de format de la classe de document en question
dans votre répertoire local.
\end_layout
\begin_layout LyX-Code
cp report.layout ~/.lyx/layouts/ma_classe.layout
\end_layout
\begin_layout Standard
Puis éditez
\family typewriter
ma_classe.layout
\family default
et changez la ligne :
\end_layout
\begin_layout LyX-Code
\backslash
DeclareLaTeXClass{report}
\end_layout
\begin_layout Standard
en :
\end_layout
\begin_layout LyX-Code
\backslash
DeclareLaTeXClass[report, ma_classe.sty]{report (ma_classe)}
\end_layout
\begin_layout Standard
Puis ajoutez :
\end_layout
\begin_layout LyX-Code
Preamble
\begin_inset Newline newline
\end_inset
\backslash
usepackage{ma_classe}
\begin_inset Newline newline
\end_inset
EndPreamble
\end_layout
\begin_layout Standard
près du début du fichier.
\end_layout
\begin_layout Standard
Démarrez LyX et faites
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Éditer\SpecialChar \menuseparator
Reconfigurer
\end_layout
\end_inset
.
Redémarrez LyX et essayez de créer un nouveau document.
Vous devriez voir
\begin_inset Quotes fld
\end_inset
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
report
\begin_inset space ~
\end_inset
(ma_classe)
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
parmi les classes de document dans la fenêtre
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Document\SpecialChar \menuseparator
Paramètres\SpecialChar \ldots{}
\SpecialChar \menuseparator
Classe de document
\end_layout
\end_inset
.
Il est probable que certaines des commandes de section devront être différentes
de celles de la classe de base
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
ici
\family typewriter
report
\end_layout
\end_inset
, vous pouvez donc jouer avec les réglages des différentes sections si vous
le souhaitez.
Les informations de format pour le sectionnement se trouvent dans
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
stdsections.inc
\end_layout
\end_inset
, mais il n'est pas nécessaire de recopier ce fichier pour le modifier.
Il vous suffit en effet d'ajouter vos modifications au fichier de format,
après la ligne
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Input
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
stdclass.inc
\end_layout
\end_inset
\end_layout
\end_inset
, qui implique l'inclusion de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
stdsections.inc
\end_layout
\end_inset
.
Par exemple, vous pourriez ajouter ces lignes:
\end_layout
\begin_layout LyX-Code
\lang english
Style Chapter
\end_layout
\begin_layout LyX-Code
\lang english
Font
\end_layout
\begin_layout LyX-Code
\lang english
Family Sans
\end_layout
\begin_layout LyX-Code
\lang english
EndFont
\end_layout
\begin_layout LyX-Code
\lang english
End
\end_layout
\begin_layout Standard
pour modifier la police des titres de chapitre en police sens empattements.
Ceci écrasera (ou bien, en l'occurrence, ajoutera) la déclaration existante
pour le style Chapitre.
\end_layout
\begin_layout Standard
Votre nouveau paquetage peut également fournir des commandes ou des environnemen
ts qui n'existent pas dans la classe de base.
dans ce cas, il vous faudra ajouter ceux-ci au fichier de format.
Voir le paragraphe
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:Syntaxe-des"
\end_inset
pour savoir comment faire.
\end_layout
\begin_layout Standard
Si
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
ma_classe.sty
\end_layout
\end_inset
peut être utilisé avec plusieurs classes de document différentes, vous
trouverez sans doute plus approprié d'écrire un module que vous pourrez
charger avec la classe de base.
Le module le plus simple qu'il est possible d'écrire dans ce contexte est
la suivant:
\end_layout
\begin_layout LyX-Code
\lang english
#
\backslash
DeclareLyXModule{mon paquetage}
\end_layout
\begin_layout LyX-Code
\lang english
#DescriptionBegin
\end_layout
\begin_layout LyX-Code
\lang english
#Support for mypkg.sty.
\end_layout
\begin_layout LyX-Code
\lang english
#DescriptionEnd
\begin_inset Newline newline
\end_inset
\end_layout
\begin_layout LyX-Code
\lang english
Format 21
\begin_inset Newline newline
\end_inset
\end_layout
\begin_layout LyX-Code
\lang english
Preamble
\begin_inset Newline newline
\end_inset
\backslash
usepackage{mypkg}
\begin_inset Newline newline
\end_inset
EndPreamble
\end_layout
\begin_layout Standard
\family typewriter
Un module plus compliqué pourrait modifier le comportement de constructions
es=xistantes ou den définir de nouvelles.
De nouveau, voir le paragraphe
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:Syntaxe-des"
\end_inset
pour les détails.
\end_layout
\begin_layout Subsection
Format pour un fichier
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
.cls
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Deux possibilités se présentent.
\end_layout
\begin_layout Standard
Soit le fichier de classe est fondé sur une classe de document existante.
Par exemple, de nombreuses classes pour une thèse sont des variantes de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
book.cls
\end_layout
\end_inset
.
Pour vérifier que c'est le cas pour la vôtre, cherchez une ligne comme
\end_layout
\begin_layout LyX-Code
\lang english
\backslash
LoadClass{book}
\end_layout
\begin_layout Standard
dans le fichier de classe.
Si c'est la cas, vous pouvez essentiellement procéder comme dans la section
précédente, bien que la ligne
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
DeclareLaTeXClass
\end_layout
\end_inset
soit différente.
Si votre nouvelle classe est une thèse, et est fondée sur
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
book
\end_layout
\end_inset
, cette ligne doit être
\lang english
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Et enregistrer le fichier comme
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
thesis.layout
\end_layout
\end_inset
facilitera les choses: LyX suppose que la classe de document a le même
nom que le fichier de format.
\end_layout
\end_inset
\lang french
:
\end_layout
\begin_layout LyX-Code
\lang english
\backslash
DeclareLaTeXClass[thesis,book]{thesis}
\end_layout
\begin_layout Standard
Soit le fichier de classe est original.
Dans ce cas, vous devrez probablement créer votre propre format.
Nous vous suggérons fortement de copier un fichier de format existant qui
utilise une classe LaTeX similaire et de le modifier si c'est possible.
Utilisez au moins un fichier existant comme point de départ pour savoir
quels sont les éléments dont vous devez vous occuper.
Encore une fois, les spécificités sont décrites ci-après.
\end_layout
\begin_layout Subsection
Création de modèles
\begin_inset CommandInset label
LatexCommand label
name "sec:modeles"
\end_inset
\end_layout
\begin_layout Standard
Une fois qu'un fichier de format a été crée pour une classe de document,
vous désirerez peut-être créer un
\emph on
modèle
\emph default
correspondant.
Un modèle est une sorte de mode d'emploi pour votre format, montrant comment
il peut être utilisé, mais avec un contenu fictif.
Vous pouvez jeter un œil aux divers modèles distribués avec LyX pour illustrati
on.
\end_layout
\begin_layout Standard
Les modèles sont créés comme les documents normaux.
La seule différence est que les documents normaux contiennent tous les
réglages possibles, y compris les polices et la taille du papier.
Or on ne veut en général pas qu'un modèle modifie ces réglages implicites.
Pour cette raison, l'auteur d'un modèle doit enlever les commandes correspondan
tes comme
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\backslash
font_roman
\end_layout
\end_inset
ou
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\backslash
papersize
\end_layout
\end_inset
du fichier modèle LyX.
C'est faisable avec un simple éditeur de texte, comme
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
vi
\end_layout
\end_inset
ou
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
notepad
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
Mettez les fichiers modèles que vous avez créés et édités dans
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
MonRép/templates/
\end_layout
\end_inset
, copiez ceux que vous utilisez du répertoire global de modèles
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
RépLyX/templates/
\end_layout
\end_inset
vers le même endroit, et redéfinissez le répertoire de modèles dans la
fenêtre
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Outils\SpecialChar \menuseparator
Préférences\SpecialChar \menuseparator
Répertoires
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
Notez que le modèle
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
defaults.lyx
\end_layout
\end_inset
a un statut particulier.
Il est chargé à chaque fois que vous créez un nouveau document avec
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Fichier\SpecialChar \menuseparator
Nouveau
\end_layout
\end_inset
afin d'avoir les réglages implicites.
Pour créer ce modèle depuis LyX, vous n'avez qu'à ouvrir un document ayant
déjà les réglages voulus, et appuyer sur le bouton
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Enregistrer comme valeurs implicites
\end_layout
\end_inset
.
\end_layout
\begin_layout Subsection
Mise à jour des anciens fichiers de format
\end_layout
\begin_layout Standard
La syntaxe des fichiers de format change à chaque publication d'une nouvelle
version de LyX, et les anciens fichiers de format doivent donc être convertis
dans la nouvelle syntaxe.
cette procédure a été rendue automatique depuis LyX 1.4: si LyX lit un fichier
de format écrit avec une syntaxe ancienne, il appelle le script
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
layout2layout.py
\end_layout
\end_inset
pour le convertir dans un fichier temporaire doté de la nouvelle syntaxe.
Le fichier original reste intact.
Si vous utilisez le fichier de format souvent, vous voudrez sans doute
rendre les modifications permanentes, pour éviter des conversions répétitives
de la part de LyX.
Pour ce faire, vous pouvez appeler le convertisseur manuellement:
\end_layout
\begin_layout LyX-Code
\lang english
mv ma_classe.layout ma_classe.old
\end_layout
\begin_layout LyX-Code
\lang english
python RépLyx/scripts/layout2layout.py ma_classe.old ma_classe.layout
\end_layout
\begin_layout Standard
Vous devez remplacer
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
RépLyx
\end_layout
\end_inset
par le nom de votre répertoire LyX au niveau système, naturellement.
\end_layout
\begin_layout Standard
Le convertisseur ne gère que les changements de syntaxe.
Il ne peut pas gérer les modifications du contenu des fichiers inclus,
ceux-ci doivent être convertis séparément.
\end_layout
\begin_layout Section
Syntaxe des fichiers de format
\begin_inset CommandInset label
LatexCommand label
name "sec:Syntaxe-des"
\end_inset
\end_layout
\begin_layout Standard
Les sections suivantes vous expliquent à quoi vous vous attaquez quand vous
décidez de mettre les mains dans le cambouis, et de créer ou d'éditer votre
propre fichier de format.
Notre conseil est d'aller doucement, d'enregistrer souvent pour faire des
essais, d'écouter de la musique relaxante, et de siroter tranquillement
un ou deux verres de votre boisson favorite, voire plus si vous êtes coincés.
Ce n'est pas si dur que ça, mais il y a une multitude d'options et vous
pouvez vous laisser submerger si vous essayez d'en faire trop d'un coup.
Allez donc prendre un verre, juste pour la route.
\end_layout
\begin_layout Standard
Toutes les balises décrites dans ce chapitre sont insensibles à la casse:
cela veut dire que
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Style
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
style
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
StYlE
\end_layout
\end_inset
sont une seule et même commande.
Les valeurs possibles sont inscrites entre crochets après le nom de la
fonction.
La valeur implicite d'une fonction quand elle n'est pas définie dans le
fichier décrivant la classe de texte est
\emph on
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
mise en évidence
\end_layout
\end_inset
\emph default
.
Si le paramètre est d'un type particulier la valeur implicite est indiquée
ainsi :
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
float=
\emph on
default
\end_layout
\end_inset
.
\end_layout
\begin_layout Subsection
Déclaration d'une classe de document
\end_layout
\begin_layout Standard
Les lignes qui commencent par un
\family typewriter
#
\family default
dans un fichier de format sont les commentaires.
Il y a une exception à cette règle : tous les
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
.layout
\end_layout
\end_inset
doivent commencer par ceci :
\end_layout
\begin_layout LyX-Code
\size small
#% Do not delete the line below; configure depends on this
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Ne pas effacer la ligne ci-dessous ; configure compte dessus.
\end_layout
\end_inset
\end_layout
\begin_layout LyX-Code
\size small
#
\backslash
DeclareLaTeXClass{article}
\end_layout
\begin_layout Standard
La deuxième ligne sert quand vous (re)configurez LyX.
Le fichier de format est lu par le script LaTeX
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chkconfig.ltx
\end_layout
\end_inset
, dans un mode spécial où
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
#
\end_layout
\end_inset
est ignoré.
La première ligne est juste un commentaire LaTeX, et la deuxième contient
la déclaration de la classe de texte.
Si ces lignes apparaissent dans un fichier appelé
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
article.layout
\end_layout
\end_inset
, elles définissent alors une classe de texte appelée
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
article
\end_layout
\end_inset
(le nom du fichier de format) qui utilise la classe de document LaTeX
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
article.cls
\end_layout
\end_inset
(implicitement, le même nom que le format).
La chaîne
\begin_inset Quotes fld
\end_inset
article
\begin_inset Quotes frd
\end_inset
qui apparaît ci-dessus sert de description de la classe de texte dans la
fenêtre
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Document\SpecialChar \menuseparator
Paramètres\SpecialChar \ldots{}
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Supposons que vous ayez écrit votre propre classe de texte qui utilise la
classe de document
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
article.cls
\end_layout
\end_inset
, mais dans laquelle vous avez changé l'apparence des en-têtes de sections.
Si vous la mettez dans un fichier
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
mon_article.layout
\end_layout
\end_inset
, l'en-tête de ce fichier doit être :
\end_layout
\begin_layout LyX-Code
\size small
#% Do not delete the line below; configure depends on this
\end_layout
\begin_layout LyX-Code
\size small
#
\backslash
DeclareLaTeXClass[article]{article (avec mes en-têtes)}
\end_layout
\begin_layout Standard
Ceci déclare une classe de texte
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
mon_article
\end_layout
\end_inset
, associée avec la classe de document LaTeX
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
article.cls
\end_layout
\end_inset
et décrite comme
\begin_inset Quotes fld
\end_inset
article (avec mes en-têtes)
\begin_inset Quotes frd
\end_inset
.
Si votre classe de texte repose sur plusieurs paquetages, vous pouvez la
déclarer ainsi :
\end_layout
\begin_layout LyX-Code
\size small
#% Do not delete the line below; configure depends on this
\end_layout
\begin_layout LyX-Code
\size small
#
\backslash
DeclareLaTeXClass[article,machin.sty]{article (avec mes en-têtes)}
\end_layout
\begin_layout Standard
Ceci indique que votre classe de texte utilise le paquetage
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
machin.sty
\end_layout
\end_inset
.
Enfin, il est aussi possible de déclarer des classes pour du code DocBook.
Les déclarations ressemblent en général à :
\end_layout
\begin_layout LyX-Code
#% Do not delete the line below; configure depends on this
\end_layout
\begin_layout LyX-Code
#
\backslash
DeclareDocBookClass[article]{SGML (DocBook article)}
\end_layout
\begin_layout Standard
Notez que ces déclarations peuvent aussi recevoir un paramètre optionnel
déclarant le nom de la classe de document (mais pas une liste).
\end_layout
\begin_layout Standard
Donc, de la manière la plus explicite, la forme d'une déclaration de format
est la suivante:
\end_layout
\begin_layout LyX-Code
\size small
\lang english
#
\backslash
DeclareLaTeXClass[class,package.sty]{layout description}
\end_layout
\begin_layout Standard
Il n'est nécessaire de déclarer la classe que si le nom de la classe LaTeX
et le nom du fichier de format diffèrent, ou si des paquetages sont à spécifier.
Si le nom de la classe n'est pas spécifiée, LyX suppose qu'elle est identique
à celle du fichier de format.
\end_layout
\begin_layout Standard
Une fois que la classe de texte a été modifiée à votre goût, tout ce que
vous avez à faire est de la copier soit dans
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
RépLyX/layouts/
\end_layout
\end_inset
soit dans
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
MonRép/layouts/
\end_layout
\end_inset
et de faire
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Outils\SpecialChar \menuseparator
Recon\SpecialChar \-
figurer
\end_layout
\end_inset
.
Quittez LyX et redémarrez-le; votre nouvelle classe de texte devrait alors
être disponible avec les autres.
\end_layout
\begin_layout Standard
Une fois le fichier de format installé, vous pouvez le modifier et vérifier
l'effet de ces modifications sans reconfigurer ou redémarrer LyX
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Avec les versions de LyX antérieures à 1.6, il vous fallait redémarrer LyX
pour valider les modifications effectuées dans les fichiers de format.
De ce fait, les modifications pouvaient prendre beaucoup de temps.
\end_layout
\end_inset
.
Vous pouvez imposer un rechargement du format en service en utilisant la
fonction
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
layout-reload
\end_layout
\end_inset
.
Cette fonction n'est implicitement liée à aucun raccourci — vous pouvez
bien sûr la lier à une touche vous-même.
Si vous voulez utiliser cette fonction, il vous suffit de la saisir dans
le mini-tampon.
\end_layout
\begin_layout Standard
\emph on
Attention
\emph default
:
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
layout-reload
\end_layout
\end_inset
est une fonctionnalité
\begin_inset Quotes fld
\end_inset
avancée
\begin_inset Quotes frd
\end_inset
\emph on
.
\emph default
Il vous est
\emph on
fortement
\emph default
recommandé de sauvegarder votre travail avant de procéder ainsi
\emph on
.
\emph default
En fait, il vous est
\emph on
fortement
\emph default
recommandé de ne pas essayer de modifier des formats durant une travail
productif sur un document.
Utilisez un document de test, les erreurs de syntaxe et autres dans votre
module pourraient déclencher des comportements bizarres.
En particulier, de telles erreurs pourraient inciter LyX à considérer les
formats en service comme incorrects et à essayer de basculer sur un autre
format
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Les erreurs de syntaxe vraiment graves peuvent même stopper LyX.
Ceci provient du fait que certaines erreurs rendent LyX incapable de lire
la moindre information de format.
Faites attention\SpecialChar \ldots{}
\end_layout
\end_inset
.
Les développeurs s'efforcent de conserver une bonne stabilité à LyX dans
de telles situations, mais il vaut mieux être sûr que regretter
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Puisque nous en sommes au conseils: faites des sauvegardes régulières.
Et soyez gentil avec votre maman.
\end_layout
\end_inset
.
\end_layout
\begin_layout Subsection
Déclaration d'un module
\end_layout
\begin_layout Standard
La première ligne d'un module doit être rédigée comme suit:
\end_layout
\begin_layout LyX-Code
\lang english
#
\backslash
DeclareLyXModule[endnotes.sty]{Endnotes}
\end_layout
\begin_layout Standard
L'argument obligatoire, entre accolades, est le nom du module, tel qu'il
apparaîtra dans
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Document\SpecialChar \menuseparator
Paramètres\SpecialChar \ldots{}
\SpecialChar \menuseparator
Modules
\end_layout
\end_inset
.
L'argument entre crochets est facultatif: il déclare n'importe quel paquetage
LaTeX dont dépend le module.
Notez bien que seuls les paquetages connus de LyX peuvent être énumérés
entre les crochets
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
La liste de ces paquetages n'est documentée que dans le code source.
\end_layout
\end_inset
.
LyX ne fera aucune vérification pour des paquetages quelconques.
Il est également possible d'utiliser la clé
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
depuis->vers
\end_layout
\end_inset
en argument optionnel: elle déclare que le module ne peut être employé
que s'il existe un chemin de conversion entre les formats
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
depuis
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
vers
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
La déclaration du module devra être suivi par des lignes descriptives comme
celles-ci
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
En anglais de préférence si le module doit être diffusé par LyX.
Cette description apparaîtra dans la liste des messages à traduire et sera
donc traduite lors de la mise à jour de l'interface.
\end_layout
\end_inset
:
\end_layout
\begin_layout LyX-Code
\lang english
#DescriptionBegin
\end_layout
\begin_layout LyX-Code
\lang english
#Adds an endnote command, in addition to footnotes.
\end_layout
\begin_layout LyX-Code
\lang english
#You will need to add
\backslash
theendnotes in TeX code where you
\end_layout
\begin_layout LyX-Code
\lang english
#want the endnotes to appear.
\end_layout
\begin_layout LyX-Code
\lang english
#DescriptionEnd
\end_layout
\begin_layout LyX-Code
\lang english
#Requires: somemodule | othermodule
\end_layout
\begin_layout LyX-Code
\lang english
#Excludes: badmodule
\end_layout
\begin_layout Standard
Cette description est utilisée dans
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Document\SpecialChar \menuseparator
Paramètres\SpecialChar \ldots{}
\SpecialChar \menuseparator
Modules
\end_layout
\end_inset
pour informer l'utilisateur de la fonction du module.
La ligne
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Requires
\end_layout
\end_inset
permet d'identifier les modules qui doivent être activés avec celui-ci;
la ligne
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Excludes
\end_layout
\end_inset
permet d'identifier les modules interdits avec celui-ci.
Les deux lignes sont facultatives et, comme indiqué, les modules dans une
liste doivent être séparés par une barre verticale: |.
Noter que les modules requis sont traités sur le mode disjonctif:
\emph on
au moins un
\emph default
des modules requis doit être utilisé.
De même,
\emph on
aucun
\emph default
des modules exclus ne doit être utilisé.
Noter également que les les modules sont identifiés par leur nom de fichier,
sans le suffixe
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
.module
\end_layout
\end_inset
.
Ainsi
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
telmodule
\end_layout
\end_inset
est vraiment
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
telmodule.module
\end_layout
\end_inset
.
\end_layout
\begin_layout Subsection
Numéro d'identification syntaxique
\end_layout
\begin_layout Standard
La première ligne non commentée doit contenir le numéro d'identification
syntaxique du contenu du fichier de format:
\end_layout
\begin_layout Description
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Format
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
int
\end_layout
\end_inset
] Identification syntaxique du fichier de format
\end_layout
\begin_layout Standard
Ce balisage a été introduit dans LyX 1.4.0 (les fichiers de format des versions
antérieures n'avaient pas de numéro de format explicite et sont affectés
du numéro 1).
Le numéro de format du présent fichier est le numéro 21.
mais chaque version de LyX peut lire les fichiers de format d'une version
plus ancienne, comme elle peut lire les documents crées avec une version
plus ancienne.
Il n'y a cependant aucun moyen de revernir aux numéros d'identification
antérieurs.
ainsi LyX 1.6 ne lira pas les fichiers de format identifiés par 21 mais
lira les fichiers numérotés 11 ou moins.
\end_layout
\begin_layout Subsection
Paramètres généraux d'une classe de texte
\begin_inset CommandInset label
LatexCommand label
name "sub:Paramètres-généraux-d'une"
\end_inset
\end_layout
\begin_layout Standard
Voici les paramètres généraux qui décrivent l'aspect du document pour une
classe complète (ceci ne veut pas dire qu'il
\emph on
doivent
\emph default
apparaître dans le fichiers
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
.layout
\end_layout
\end_inset
plutôt que dans les modules.
Un module peut contenir n'importe quelle balise de format):
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
AddToHTMLPreamble
\end_layout
\end_inset
\family roman
\lang french
\family default
ajoute une information qui sera incluse dans le bloc
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
<head>
\end_layout
\end_inset
quand le document est exporté en XHTML.
Typiquement, ce paramètre est utilisé pour exporter de l'information en
style CSS, mais il peut être utilisé pour toute information valide entre
les balises
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
<head>
\end_layout
\end_inset
.
Doit être fermé par
\begin_inset Quotes fld
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
EndPreamble
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
AddToPreamble
\end_layout
\end_inset
\family roman
\lang french
\family default
définit le style à utiliser pour afficher les informations bibliographiques.
Voir le paragraphe.
Doit être fermé par
\begin_inset Quotes fld
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
EndPreamble
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
CiteFormat
\end_layout
\end_inset
\family roman
\lang french
\family default
ajoute une information au préambule du document.
Voir
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Description citation"
\end_inset
Doit être fermé par
\begin_inset Quotes fld
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
EndPreamble
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
ClassOptions
\end_layout
\end_inset
\family roman
\lang french
\family default
décrit diverses options globales comprises par la classe du document.
Voir la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Section-ClassOptions"
\end_inset
pour les détails.
Doit être fermé par
\begin_inset Quotes fld
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
End
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Columns
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
1
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
2
\end_layout
\end_inset
]
\lang french
fixe le nombre implicite de colonnes (une ou deux).
Peut être changé dans la fenêtre
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Document\SpecialChar \menuseparator
Paramètres
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Counter
\end_layout
\end_inset
\family roman
\lang french
\family default
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chaîne
\end_layout
\end_inset
]définit les paramètres d'un nouveau compteur.
Si le compteur n'existe pas, il est créé; s'il existe, il est modifié.
Doit être fermé par
\begin_inset Quotes fld
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
End
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
.
\begin_inset Newline newline
\end_inset
Voir la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Compteurs"
\end_inset
pour les détails.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
DefaultFont
\end_layout
\end_inset
\lang french
décrit la police implicite dans le document.
Voir la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:polices"
\end_inset
pour une description.
Doit être fermé par
\begin_inset Quotes fld
\end_inset
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
EndFont
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
DefaultModule
\end_layout
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
]
\end_layout
\end_inset
\lang french
spécifie un module inclus implicitement avec cette classe de document, donné
par son nom de fichier sans suffixe
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
.module
\end_layout
\end_inset
.
L'utilisateur peut toujours le retirer, mais il sera actif à l'ouverture
du document (ceci s'applique pour un nouveau document, ou quand cette classe
est choisie pour un document existant).
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
DefaultStyle
\end_layout
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
]
\end_layout
\end_inset
\lang french
indique le style qui sera appliqué aux nouveaux paragraphes, habituellement
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
Standard
\end_layout
\end_inset
.
Ce sera implicitement le premier style défini si ce paramètre n'est pas
fixé, mais vous êtes vivement encouragé à utiliser cette directive.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
ExcludesModule
\end_layout
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
]
\end_layout
\end_inset
\lang french
indique que le module spécifié — donné par son nom de fichier sans le suffixe
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
.module
\end_layout
\end_inset
— ne peut pas être utilisé avec cette classe de document.
Ceci peut être utilisé par exemple dans un format pour une revue pour éviter
e.g.
l'utilisation du module
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
theorems-sec
\end_layout
\end_inset
(numérotation des théorèmes par sections).
Ce paramètre
\emph on
ne
\emph default
\emph on
peut pas
\emph default
être utilisé dans un module: les modules ont leur propre méthode d'exclusion
(voir
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Modules_de_format"
\end_inset
).
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Float
\end_layout
\end_inset
\lang french
définit un nouveau flottant.
Voir la Section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:flottants"
\end_inset
.
Doit être fermé par
\begin_inset Quotes fld
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
End
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLPreamble
\end_layout
\end_inset
\lang french
définit l'information qui sera incluse dans le bloc
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
<head>
\end_layout
\end_inset
quand le document est exporté en XHTML.
Notez bien que ceci écrasera toute déclaration
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLPreamble
\end_layout
\end_inset
\lang french
ou
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
AddToHTMLPreamble
\end_layout
\end_inset
\lang french
antérieure (utiliser
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
AddToHTMLPreamble
\end_layout
\end_inset
\lang french
si vous désirez simplement ajouter du contenu).
Voir la Section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:flottants"
\end_inset
.
Doit être fermé par
\begin_inset Quotes fld
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
End
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLTOCSection
\end_layout
\end_inset
\lang french
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
string
\end_layout
\end_inset
] définit le style utilisé pour la table des matières, la bibliographie,
et similaires, lorsque le document est exporté en HTML.
Pour les articles, ceci devrait normalement valoir Section; pour les livres,
Chapter.
Sans précisions, LyX essaiera de deviner quel style utiliser.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
IfCounter
\end_layout
\end_inset
\lang french
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chaîne
\end_layout
\end_inset
] modifie les propriétés d'un compteur donné.
Si le compteur n'existe pas, la directive est ignorée.
Doit être fermé par
\begin_inset Quotes fld
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
End
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
.
\begin_inset Newline newline
\end_inset
Voir la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Compteurs"
\end_inset
pour les détails au sujet des compteurs.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
IfStyle
\end_layout
\end_inset
\lang french
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chaîne
\end_layout
\end_inset
] modifies les propriétés de style d'un paragraphe donné.
Si le style n'existe pas, le directive est ignorée.
Doit être fermé par
\begin_inset Quotes fld
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
End
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Input
\end_layout
\end_inset
\lang french
permet d'inclure un autre fichier de définition de format pour éviter de
réécrire des commandes.
C'est souvent le cas des fichiers de format standard, comme
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
stdclass.inc
\end_layout
\end_inset
, qui contient la plupart des réglages de base.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
InsetLayout
\end_layout
\end_inset
\family roman
\lang french
\family default
cette section (re)définit le format d'un insert.
Elle peut être appliquée à un insert existant pour obtenir un nouvel insert
défini par l'utilisateur, e.g.
un nouveau style de caractères.
Doit être fermé par
\begin_inset Quotes fld
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
End
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
.
\begin_inset Newline newline
\end_inset
Voir la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Flex-insets-and"
\end_inset
pour les détails.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LeftMargin
\end_layout
\end_inset
\family roman
\lang french
\family default
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chaîne
\end_layout
\end_inset
] indique la largeur de la marge gauche à l'écran, par exemple
\begin_inset Quotes fld
\end_inset
MMMMM
\begin_inset Quotes frd
\end_inset
(noter que ce n'est pas une
\begin_inset Quotes fld
\end_inset
longueur
\begin_inset Quotes frd
\end_inset
, comme
\begin_inset Quotes fld
\end_inset
2ex.
\begin_inset Quotes frd
\end_inset
).
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
NoCounter
\end_layout
\end_inset
\lang french
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chaîne
\end_layout
\end_inset
] efface un compteur existant, habituellement défini dans un fichier inclus.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
NoFloat
\end_layout
\end_inset
\lang french
efface un flottant existant.
C'est très utile quand vous voulez supprimer un flottant qui a été défini
dans un fichier inclus.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
NoStyle
\end_layout
\end_inset
\lang french
efface un style existant.
C'est très utile quand vous voulez supprimer un style qui a été défini
dans un fichier inclus.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
OutputFormat
\end_layout
\end_inset
\family roman
\lang french
\family default
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
]
\end_layout
\end_inset
\lang french
indique quelle sorte de format de fichier (tel que défini dans la fenêtre
Préférences) est produit par cette classe.
Elle est surtout utile quand
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
OutputType
\end_layout
\end_inset
est
\begin_inset Quotes fld
\end_inset
literate
\begin_inset Quotes frd
\end_inset
et que l'on veut définir un nouvelle sorte de document literate.
La chaîne est redéfinie comme
\begin_inset Quotes fld
\end_inset
docbook
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
latex
\begin_inset Quotes frd
\end_inset
ou
\begin_inset Quotes fld
\end_inset
literate
\begin_inset Quotes frd
\end_inset
quand la directive correspondante
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
OutputType
\end_layout
\end_inset
est trouvée.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
OutputType
\end_layout
\end_inset
\family roman
\lang french
\family default
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
]
\end_layout
\end_inset
\lang french
indique quelle sorte de document résultant sera obtenu par cette classe.
Actuellement, les options sont:
\begin_inset Quotes fld
\end_inset
docbook
\begin_inset Quotes frd
\end_inset
,
\begin_inset Quotes fld
\end_inset
latex
\begin_inset Quotes frd
\end_inset
, et
\begin_inset Quotes fld
\end_inset
literate
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
PageStyle
\end_layout
\end_inset
[
\emph on
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
plain
\end_layout
\end_inset
\emph default
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
empty
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
headings
\end_layout
\end_inset
]
\lang french
fixe la mise en page implicite.
Peut être changée dans la fenêtre
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Document\SpecialChar \menuseparator
Paramètres\SpecialChar \ldots{}
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Preamble
\end_layout
\end_inset
\lang french
fixe le préambule du document LaTeX.
Notez bien que ceci remplacera complètement toute autre directive
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Preamble
\end_layout
\end_inset
ou
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
AddToPreamble
\end_layout
\end_inset
\lang french
(utiliser cette dernière directive si vous voulez seulement ajouter des
éléments au contenu).
Doit être fermé par
\begin_inset Quotes fld
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
EndPreamble
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Description
\family roman
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Provides
\end_layout
\end_inset
\family default
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
]
\end_layout
\end_inset
\lang french
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
0
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
1
\end_layout
\end_inset
] décrit si la classe fournit la fonctionnalité
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\family roman
chaîne
\end_layout
\end_inset
.
Une fonctionnalité est en général le nom d'un paquetage (
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
amsmath
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
makeidx
\end_layout
\end_inset
, \SpecialChar \ldots{}
) ou d'une commande LaTeX (
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
url
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
boldsymbol
\end_layout
\end_inset
,\SpecialChar \ldots{}
); la liste complète des fonctionnalités comprises n'est malheureusement
pas documentée ailleurs que dans le code source de LyX — mais voyez
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LaTeXFeatures.cpp
\end_layout
\end_inset
si vous voulez.
\family roman
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\family roman
Aide\SpecialChar \menuseparator
Configuration
\begin_inset space ~
\end_inset
LaTeX
\end_layout
\end_inset
\family default
donne également une revue des paquetage reconnus.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
ProvidesModule
\end_layout
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
]
\end_layout
\end_inset
\lang french
indique que ce format fournit la fonctionnalité du module indiqué, qui
doit être spécifié par le nom du fichier dans le suffixe
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
.module
\end_layout
\end_inset
.
Ceci sera utilisé typiquement si le format inclut directement le module,
plutôt que via le paramètre
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
DefaultModule
\end_layout
\end_inset
pour indiquer qu'il doit être utilisé.
Il pourrait être également utilisé dans un module fournissant une implantation
équivalente de la même fonctionnalité.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Requires
\end_layout
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
]
\end_layout
\end_inset
\lang french
indique que la classe nécessite la fonctionnalité
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\family roman
chaîne
\end_layout
\end_inset
.
Plusieurs fonctionnalités doivent être séparées par des virgules.
Noter que l'on ne peut requérir que des fonctionnalités reconnues (de nouveau,
voir
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LaTeXFeatures.cpp
\end_layout
\end_inset
\lang french
pour une liste de celles-ci).
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
RightMargin
\end_layout
\end_inset
\lang french
indique la largeur de la marge droite à l'écran, par exemple
\begin_inset Quotes fld
\end_inset
MMMMM
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
SecNumDepth
\end_layout
\end_inset
\family roman
\lang french
\family default
fixe quels sectionnements doivent être numérotés.
Correspond au compteur
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
secnumdepth
\end_layout
\end_inset
en LaTeX.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Sides
\end_layout
\end_inset
[
\emph on
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
1
\end_layout
\end_inset
\emph default
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
2
\end_layout
\end_inset
]
\lang french
fixe l'option implicite d'impression recto seul ou en recto verso.
Peut être changé dans la fenêtre
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Document\SpecialChar \menuseparator
Paramètres
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Style
\end_layout
\end_inset
\lang french
définit un nouveau style de paragraphe.
Si le style n'existe pas, il est créé; s'il existe déjà, ses paramètres
sont modifiés.
Doit être fermé par
\begin_inset Quotes fld
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
End
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
.
\begin_inset Newline newline
\end_inset
Voir la Section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Styles-de-paragraphe"
\end_inset
pour les détails.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
TitleLatexName
\end_layout
\end_inset
\family typewriter
\lang french
[chaîne="maketitle"]
\family default
définit nom de la commande ou de l'environnement mentionné ci-dessous.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
TitleLatexType
\end_layout
\end_inset
\family typewriter
\lang french
[
\emph on
CommandAfter
\emph default
, Environment]
\family default
indique le genre de balisage utilisé pour définir le titre d'un document.
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
CommandAfter
\end_layout
\end_inset
signifie que la commande définie par
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
TitleLatexName
\end_layout
\end_inset
sera insérée après le dernier format avec
\family typewriter
\begin_inset Quotes fld
\end_inset
\family default
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
InTitle 1
\end_layout
\end_inset
\family typewriter
\begin_inset Quotes frd
\end_inset
\family default
.
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Environment
\end_layout
\end_inset
correspond au cas
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
TitleLatexName
\end_layout
\end_inset
est un environnement, dans lequel doit être inclus le bloc de paragraphes
avec
\family typewriter
\begin_inset Quotes fld
\end_inset
\family default
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
InTitle 1
\end_layout
\end_inset
\family typewriter
\begin_inset Quotes frd
\end_inset
\family default
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
TocDepth
\end_layout
\end_inset
\lang french
fixe quels sectionnements sont inclus dans la table des matières.
Correspond au compteur
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
tocdepth
\end_layout
\end_inset
en LaTeX.
\end_layout
\begin_layout Description
\end_layout
\begin_layout Subsection
Section
\family typewriter
ClassOptions
\begin_inset CommandInset label
LatexCommand label
name "sub:Section-ClassOptions"
\end_inset
\end_layout
\begin_layout Standard
La section
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
ClassOptions
\end_layout
\end_inset
peut contenir les directives suivantes :
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
FontSize
\end_layout
\end_inset
\lang french
[
\family typewriter
chaîne="10|11|12"
\family default
] liste les tailles de police disponibles comme police principale du document,
séparées par un
\family typewriter
\begin_inset Quotes fld
\end_inset
\family default
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
|
\end_layout
\end_inset
\family typewriter
\begin_inset Quotes frd
\end_inset
\family default
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Header
\end_layout
\end_inset
\lang french
fixe le contenu de la ligne écrivant la DTD pour les classes produisant
du XML, e.g.
\lang english
PUBLIC
\begin_inset Quotes eld
\end_inset
-//OASIS//DTD DocBook V4.2//EN
\begin_inset Quotes erd
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
PageStyle
\end_layout
\end_inset
\lang french
[
\family typewriter
chaîne="empty|plain|headings|fancy"
\family default
] liste les mises en page disponibles, séparées par un
\family typewriter
\begin_inset Quotes fld
\end_inset
|
\begin_inset Quotes frd
\end_inset
\family default
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Other
\end_layout
\end_inset
\lang french
[
\family typewriter
chaîne=""
\family default
] introduit certaines options de la classe de document, séparées par une
virgule, qui seront ajoutées à la partie optionnelle de la commande
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\backslash
documentclass
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
La section
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
ClassOptions
\end_layout
\end_inset
doit être fermée par
\begin_inset Quotes fld
\end_inset
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
End
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Subsection
Styles de paragraphe
\begin_inset CommandInset label
LatexCommand label
name "sub:Styles-de-paragraphe"
\end_inset
\end_layout
\begin_layout Standard
La description d'un style de paragraphe ressemble à ceci
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
qui peut servir soit à définir un nouvel format soit à en modifier un déjà
existant.
\end_layout
\end_inset
:
\end_layout
\begin_layout LyX-Code
Style
\family roman
\emph on
nom
\end_layout
\begin_layout LyX-Code
...
\end_layout
\begin_layout LyX-Code
End
\end_layout
\begin_layout Standard
dans lequel on peut mettre les commandes suivantes :
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Align
\end_layout
\end_inset
\lang french
[
\family typewriter
\emph on
block
\emph default
, left, right, center
\family default
] alignement de paragraphe.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
AlignPossible
\end_layout
\end_inset
\lang french
[
\family typewriter
\emph on
block
\emph default
, left, right, center
\family default
]
\emph on
liste
\emph default
des alignements possibles séparés par une virgule.
Certains styles LaTeX interdisent certains alignements, car ils n'auraient
aucun sens.
Par exemple une énumération alignée à droite ou centrée est impossible.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
BabelPreamble
\end_layout
\end_inset
\lang french
noter que cette directive écrasera complètement toute déclaration
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
BabelPreamble
\end_layout
\end_inset
antérieure pour ce style.
Doit être fermée par
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
EndBabelPreamble
\end_layout
\end_inset
.
Voir la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:I18n"
\end_inset
pour les détails d'utilisation.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
BottomSep
\end_layout
\end_inset
\lang french
[
\family typewriter
float=0
\family default
]
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Noter que
\begin_inset Quotes fld
\end_inset
float
\begin_inset Quotes frd
\end_inset
ici désigne un nombre réel, e.g.
1.5
\end_layout
\end_inset
l'espacement vertical qui sépare du paragraphe suivant le dernier paragraphe
d'une série doté de cette directive.
Si le paragraphe suivant est doté d'un autre style, les séparations ne
sont pas simplement additionnées, mais le maximum est pris en considération.La
même chose que
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
TopSep
\end_layout
\end_inset
pour le dernier paragraphe.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Category
\end_layout
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
]
\end_layout
\end_inset
\lang french
fixe la catégorie pour ce style.
Ceci est utilise pour regrouper les styles apparentés dans le menu déroulant
des styles de la barre d'outils.
N'importe quelle chaîne de caractères peut être utilisée, mais vous voudrez
peut-être utiliser des catégories existantes pour vos propres styles.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
CommandDepth
\end_layout
\end_inset
\lang french
fixe la profondeur d'une commande XML.
Utilisable uniquement avec les formats XML.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
CopyStyle
\end_layout
\end_inset
\begin_inset CommandInset label
LatexCommand label
name "des:-copystyle"
\end_inset
\lang french
sert à copier toutes les caractéristiques d'un style déjà existant dans
un nouveau style.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
DependsOn
\end_layout
\end_inset
\lang french
nomme un style dont le préambule devra être placé
\emph on
avant
\emph default
celui-ci.
Ceci permet d'assurer une relation d'ordre entre les morceaux de préambule
quand les définitions de macros dépendent les unes des autres.
\lang english
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Noter que, à part cette fonctionnalité, il n'y a aucun moyen de garantir
un ordonnancement des préambules.
L'ordre que vous constatez avec une version de LyX peut changer sans préavis
dans les versions ultérieures.
\end_layout
\end_inset
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
EndLabeltype
\end_layout
\end_inset
\lang french
[
\family typewriter
\emph on
No_Label
\family default
\emph default
,
\family typewriter
Box
\family default
,
\family typewriter
Filled_Box
\family default
,
\family typewriter
Static
\family default
] fixe le type de marqueur qui se trouve à la fin du paragraphe (ou de la
suite de paragraphes si
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
LatexType
\end_layout
\end_inset
est
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Environment
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Item_Environment
\end_layout
\end_inset
ou
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
List_Environment
\end_layout
\end_inset
).
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
No_Label
\end_layout
\end_inset
signifie
\begin_inset Quotes fld
\end_inset
rien
\begin_inset Quotes frd
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Box
\end_layout
\end_inset
(respectivement
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Filled_Box
\end_layout
\end_inset
) est un carré blanc (respectivement noir) en général placé à la fin des
démonstrations.
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Static
\end_layout
\end_inset
est une chaîne de caractères explicitement donnée.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
EndLabelString
\end_layout
\end_inset
\lang french
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
=""]
\end_layout
\end_inset
\lang french
fixe la chaîne utilisée pour le marqueur quand
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
EndLabelType
\end_layout
\end_inset
vaut
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Static
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Font
\end_layout
\end_inset
\lang french
fixe la police utilisée à la fois pour le corps du texte
\emph on
et
\emph default
pour le marqueur.
Voir la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:polices"
\end_inset
.
Noter qu'en définissant cette police on définit aussi automatiquement
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LabelFont
\end_layout
\end_inset
\lang french
avec la même valeur.
Il faut donc définir celle-ci d'abord pour fixer
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LabelFont
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
FreeSpacing
\end_layout
\end_inset
\begin_inset CommandInset label
LatexCommand label
name "des:-Freespacing"
\end_inset
\lang french
[
\family typewriter
\emph on
0
\emph default
, 1
\family default
] LyX ne permet pas d'habitude d'insérer plus d'une espace entre deux mots,
car une espace est considérée comme un séparateur de mots, non comme un
caractère ou un symbole en tant que tel.
C'est très bien mais c'est parfois ennuyeux, par exemple pour taper un
code source de programme ou du code LaTeX brut.
C'est pourquoi on peut activer
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
FreeSpacing
\end_layout
\end_inset
.
Noter que LyX créera les espaces insécables correspondants aux espaces
additionnelles pour tous les modes autres que le mode LaTeX.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
HTML*
\end_layout
\end_inset
\lang french
sont utilisées avec l'exportation XHTML.
Voir
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Styles-de-paragraphe-XHTML"
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
InnerTag
\end_layout
\end_inset
[[FIXME]]
\lang french
(Utilisable uniquement avec les formats XML).
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
InPreamble
\end_layout
\end_inset
\family typewriter
\lang french
[1, 0]
\family default
indique avec 1 que que le style doit être inclus dans le préambule plutôt
que dans le corps du document.
Ceci est utile pour les classes de document qui désirent que les informations
telles que le titre et l'auteur figurent dans le préambule.
Notez bien que ceci ne fonctionne que pour les styles pour lesquels
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
LateXType
\end_layout
\end_inset
est
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Command
\end_layout
\end_inset
\lang french
ou
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Paragraph
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
InTitle
\end_layout
\end_inset
\family typewriter
\lang french
[1, 0]
\family default
indique avec 1 que le style fait partie d'un bloc de titre (voir aussi
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
TitleLatexType
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
TitleLatexName
\end_layout
\end_inset
dans les paramètres généraux).
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
ItemSep
\end_layout
\end_inset
\lang french
[
\family typewriter
float=0
\family default
] crée un espacement supplémentaire entre les paragraphes du même style
dans un environnement.
Si vous emboîtez des paragraphes d'autres formats dans un environnement,
ils seront espacés de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Parsep
\end_layout
\end_inset
.
Mais les éléments de l'environnement seront en plus espacés de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Itemsep
\end_layout
\end_inset
.
Noter que c'est un
\emph on
multiplicateur
\emph default
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
ItemTag
\end_layout
\end_inset
[[FIXME]]
\lang french
(Utilisable uniquement avec les formats XML).
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
KeepEmpty
\end_layout
\end_inset
\begin_inset CommandInset label
LatexCommand label
name "des:KeepEmpty"
\end_inset
\lang french
[
\family typewriter
\emph on
0
\emph default
, 1
\family default
] LyX ne permet pas d'habitude de laisser un paragraphe vide, car il ne
générerait rien en LaTeX.
Il y a quelques cas où c'est pourtant utile : dans un modèle pour une lettre,
les champs requis peuvent être laissés vides, pour que les gens ne les
oublient pas; dans certains cas particuliers, un style peut aussi servir
de séparateur, et ne pas contenir de texte.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LabelBottomsep
\end_layout
\end_inset
\family typewriter
\lang french
[float=0]
\family default
fixe l'espacement vertical entre le marqueur et le corps du texte.
Sert seulement pour les marqueurs qui sont au dessus du corps du texte
(
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Top_Environment
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Centered_Top_Environment
\end_layout
\end_inset
).
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LabelCounter
\end_layout
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
=""]
\end_layout
\end_inset
\lang french
dénomme le compteur pour la numérotation automatique.
\begin_inset Newline newline
\end_inset
Il
\emph on
doit
\emph default
être indiqué si
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Labeltype
\end_layout
\end_inset
est
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Counter
\end_layout
\end_inset
: dans ce cas, le compteur sera incrémenté chaque fois que le style apparaîtra
dans le document.
\begin_inset Newline newline
\end_inset
Il
\emph on
peut
\emph default
être indiqué si
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Labeltype
\end_layout
\end_inset
est
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Enumerate
\end_layout
\end_inset
, bien que ce cas soit un peu compliqué.
Supposez que vous déclariez
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\begin_inset Quotes fld
\end_inset
LabelCounter monEnum
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
.
Les compteurs effectivement utilisés sont alors
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
monEnumi
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
monEnumii
\end_layout
\end_inset
, monEnumiii et monEnumiv, tout à fait comme en LaTeX.
Ces compteurs doivent être tous déclarés séparément.
\begin_inset Newline newline
\end_inset
Voir la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Compteurs"
\end_inset
pour les détails sur les compteurs).
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LabelFont
\end_layout
\end_inset
\lang french
fixe la police utilisée pour le marqueur.
Voir la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:polices"
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LabelIndent
\end_layout
\end_inset
\lang french
fixe le texte indiquent l'importance de l'indentation d'un marqueur.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Labelsep
\end_layout
\end_inset
\lang french
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
=""]
\end_layout
\end_inset
\lang french
fixe l'espacement horizontal entre le marqueur et le corps du texte.
Sert seulement pour les marqueurs qui ne sont pas au dessus du corps du
texte.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LabelString
\end_layout
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
=""]
\end_layout
\end_inset
\lang french
fixe la chaîne utilisée comme marqueur avec le type
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Static
\end_layout
\end_inset
.
Quand
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LabelCounter
\end_layout
\end_inset
\lang french
est indiqué, cette chaîne peut contenir les instructions de formatage particuli
ères décrites dans la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Compteurs"
\end_inset
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Pour les besoins de la rétrocompatibilité, la chaîne
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
@
\emph on
style-name
\emph default
@
\end_layout
\end_inset
sera remplacée par le paramètre
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LabelString
\end_layout
\end_inset
du style
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
style-name
\end_layout
\end_inset
.
Cette fonctionnalité est maintenant obsolète et doit être remplacée par
les mécanismes décrits à la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Compteurs"
\end_inset
.
\end_layout
\end_inset
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LabelStringAppendix
\end_layout
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
=""]
\end_layout
\end_inset
\lang french
est utilisée dans un appendice à la place de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LabelString
\end_layout
\end_inset
.
Noter que toute directive
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LabelString
\end_layout
\end_inset
écrase
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LabelStringAppendix
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LabelTag
\end_layout
\end_inset
[FIXME]
\lang french
(Utilisable uniquement avec les formats XML).
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Labeltype
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
No_Label
\emph default
, Manual, Static, Top_Environment, Centered_Top_Environment, Counter, Sensitive,
Enumerate, Itemize, Bibliography
\end_layout
\end_inset
]
\end_layout
\begin_deeper
\begin_layout Itemize
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Manual
\end_layout
\end_inset
veut dire que le marqueur est le premier mot (avant la première vraie espace).
Utilisez des espaces insécables si vous voulez mettre plus d'un mot dans
le marqueur.
\end_layout
\begin_layout Itemize
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Static
\end_layout
\end_inset
veut dire qu'il est défini dans le style (voir
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
LabelString
\end_layout
\end_inset
).
Notez que ceci est vraiment
\begin_inset Quotes fld
\end_inset
statique
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Itemize
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Top_Environment
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Centered_Top_Environment
\end_layout
\end_inset
sont des cas particuliers de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Static
\end_layout
\end_inset
.
Le marqueur sera imprimé au dessus du paragraphe, mais seulement au début
d'un environnement ou au début d'une suite de paragraphes dans ce style.
Ceci peut être utilisé par exemple pour le style
\family sans
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\family sans
Abstract
\end_layout
\end_inset
.
\end_layout
\begin_layout Itemize
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Sensitive
\end_layout
\end_inset
est un cas particulier pour les marqueurs de légende
\begin_inset Quotes fld
\end_inset
Figure
\begin_inset Quotes frd
\end_inset
et
\begin_inset Quotes fld
\end_inset
Tableau
\begin_inset Quotes frd
\end_inset
.
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Sensitive
\end_layout
\end_inset
signifie que le mot affiché (défini en dur) dépend du type de flottant:
il est défini dans les sources comme
\begin_inset Quotes fld
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
FloatType N
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
où
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
N
\end_layout
\end_inset
est la valeur du compteur associé au flottant.
\end_layout
\begin_layout Itemize
Les marqueurs de type
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Counter
\end_layout
\end_inset
définissent automatiquement des marqueurs numérotés.
La directive
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
LabelString
\end_layout
\end_inset
sera déployée pour résoudre tout conflit de référence de compteur qui apparaîtr
ait.
Par exemple, ce pourrait être
\begin_inset Quotes fld
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Section
\backslash
thechapter.
\backslash
thesection
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
.
\begin_inset Newline newline
\end_inset
Voir la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Compteurs"
\end_inset
pour des précisions sur le compteurs.
\end_layout
\begin_layout Itemize
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Enumerate
\end_layout
\end_inset
produit le type habituel d'étiquettes d'énumération.
Pour le moment, il est défini en dur comme chiffres arabes, lettres en
bas de casse, petits chiffres romains et lettres capitales pour les quatre
profondeurs possibles.
\end_layout
\begin_layout Itemize
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Itemize
\end_layout
\end_inset
\lang french
produit des symboles pour les différents niveaux.
Il est également défini en dur.
\end_layout
\begin_layout Itemize
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Bibliography
\end_layout
\end_inset
\lang french
est utilisé de manière interne par LyX et ne doit être utilisé qu'avec
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LatexType BibEnvironment
\end_layout
\end_inset
.
\end_layout
\end_deeper
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LangPreamble
\end_layout
\end_inset
\lang french
écrasera complètement toute autre directive
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
LangPreamble
\end_layout
\end_inset
antérieure.
Doit être fermée par
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
EndLangPreamble
\end_layout
\end_inset
.
\begin_inset Newline newline
\end_inset
Voir la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:I18n"
\end_inset
pour les détails d'utilisation.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LatexName
\end_layout
\end_inset
\lang french
fixe le nom de l'objet LaTeX correspondant, soit l'environnement, soit
la commande.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LatexParam
\end_layout
\end_inset
\lang french
fixe le paramètre facultatif de l'objet
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
LatexName
\end_layout
\end_inset
correspondant.
Ce paramètre ne peut pas être changé depuis LyX.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LatexType
\end_layout
\end_inset
\begin_inset CommandInset label
LatexCommand label
name "des:LatexType"
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
Paragraph
\emph default
, Command, Environment, Item_Environment,
\end_layout
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
List_Environment, Bib_Environment
\end_layout
\end_inset
]
\lang french
\begin_inset Newline newline
\end_inset
décrit comment traduire l'environnement en LaTeX.
\end_layout
\begin_deeper
\begin_layout Itemize
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Paragraph
\end_layout
\end_inset
veut dire
\begin_inset Quotes fld
\end_inset
rien de spécial
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Itemize
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Command
\end_layout
\end_inset
veut dire
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\backslash
\emph on
LatexName
\emph default
{\SpecialChar \ldots{}
}
\end_layout
\end_inset
.
\end_layout
\begin_layout Itemize
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Environment
\end_layout
\end_inset
veut dire
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\backslash
begin{
\emph on
LatexName
\emph default
}\SpecialChar \ldots{}
\backslash
end{
\emph on
LatexName
\emph default
}
\end_layout
\end_inset
.
\end_layout
\begin_layout Itemize
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Item_Environment
\end_layout
\end_inset
est la même chose que
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Environment
\end_layout
\end_inset
, sauf qu'il génère un
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\backslash
item
\end_layout
\end_inset
pour chaque paragraphe de l'environnement.
\end_layout
\begin_layout Itemize
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
List_Environment
\end_layout
\end_inset
est la même chose que
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Item_Environment
\end_layout
\end_inset
, sauf que
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
LabelWidthString
\end_layout
\end_inset
est passé en paramètre de l'environnement.
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
LabelWidthString
\end_layout
\end_inset
peut être défini dans la fenêtre
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Éditer\SpecialChar \menuseparator
Paramètres
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
Paragraphe
\end_layout
\end_inset
.
\end_layout
\end_deeper
\begin_layout Standard
En collectant ces derniers éléments, l'exportation LaTeX sera ou bien:
\end_layout
\begin_layout LyX-Code
\lang english
\backslash
latexname[latexparam]{\SpecialChar \ldots{}
}
\end_layout
\begin_layout Standard
ou bien:
\end_layout
\begin_layout LyX-Code
\lang english
\backslash
begin{latexname}[latexparam] \SpecialChar \ldots{}
\backslash
end{latexname}.
\end_layout
\begin_layout Standard
en fonction du type LaTeX.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LeftMargin
\end_layout
\end_inset
\lang french
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
=""]
\end_layout
\end_inset
\lang french
fixe la marge gauche: si vous mettez des styles dans un environnement,
les marges de gauche ne seront pas ajoutées directement, mais avec un facteur
\begin_inset Formula $\frac{4}{profondeur+4}$
\end_inset
.
Notez que ce paramètre sert aussi quand la marge est définie comme
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Manual
\end_layout
\end_inset
ou
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Dynamic
\end_layout
\end_inset
.
Il est alors ajouté à la marge manuelle ou dynamique.
\begin_inset Newline newline
\end_inset
L'argument est passé comme une chaîne: par exemple,
\begin_inset Quotes fld
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
MM
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
signifie que le paragraphe est indenté avec la largeur de
\begin_inset Quotes fld
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
MM
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
dans la police normale.
Il est possible de créer une largeur négative avec
\begin_inset Quotes fld
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
.
Cette solution a été choisie pour que l'apparence soit la même quelle que
soit la police d'écran.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Margin
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
Static
\emph default
, Manual, Dynamic, First_Dynamic, Right_Address_Box
\end_layout
\end_inset
]
\begin_inset Newline newline
\end_inset
\lang french
fixe le type de marge à gauche du format.
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Static
\end_layout
\end_inset
veut dire une marge fixe.
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Manual
\end_layout
\end_inset
veut dire que la marge de gauche dépend de ce qu'il y a dans la fenêtre
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Éditer\SpecialChar \menuseparator
Paramètres
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
Paragraphe
\end_layout
\end_inset
.
Ceci sert à obtenir des listes bien mises en page sans tabulations.
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Dynamic
\end_layout
\end_inset
veut dire que la marge dépend de la taille du marqueur.
Ceci sert entre autres aux en-têtes numérotés.
Il est évident que l'en-tête
\begin_inset Quotes fld
\end_inset
5.4.3.2.1 Très long en-tête
\begin_inset Quotes frd
\end_inset
doit avoir une marge de gauche plus grande (autant que
\begin_inset Quotes fld
\end_inset
5.4.3.2.1
\begin_inset Quotes frd
\end_inset
plus l'espace) que
\begin_inset Quotes fld
\end_inset
3.2 Très long en-tête
\begin_inset Quotes frd
\end_inset
, même si les autres traitements de texte ne savent pas le faire.
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
First_Dynamic
\end_layout
\end_inset
est similaire, mais seulement la toute première ligne du paragraphe est
dynamique, les autres étant statiques; ceci est utile par exemple pour
les descriptions.
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Right_Address_Box
\end_layout
\end_inset
signifie que la marge est choisie pour que la ligne la plus longue du paragraph
e touche la marge de droite.
Ceci sert à typographier une adresse sur le bord droit de la page.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
NeedProtect
\end_layout
\end_inset
\lang french
[
\family typewriter
\emph on
0
\emph default
,1
\family default
] indique si les commandes fragiles doivent être protégées par
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\backslash
protect
\end_layout
\end_inset
dans ce style (Note: ceci n'indique pas si cette commande elle-même doit
être protégée).
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Newline
\end_layout
\end_inset
\lang french
[
\family typewriter
0,
\family default
\family typewriter
\emph on
1
\family default
\emph default
] indique si les nouvelles lignes sont traduites ou non en sauts de ligne
LaTeX (
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\backslash
\backslash
\end_layout
\end_inset
).
La traduction peut être désactivée pour permettre d'éditer plus confortablement
du LaTeX depuis LyX.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
NextNoIndent
\end_layout
\end_inset
\lang french
[
\family typewriter
1,
\family default
\family typewriter
\emph on
0
\family default
\emph default
] indique si LyX indente ou non la première ligne du paragraphe suivant.
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
1
\end_layout
\end_inset
veut dire qu'il ne peut pas,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
0
\end_layout
\end_inset
veut dire qu'il peut s'il le veut.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
ObsoletedBy
\end_layout
\end_inset
\lang french
dénomme un style qui a remplacé ce style en cours.
Ceci est utilisé pour renommer un style en conservant la rétrocompatibilité.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
OptionalArgs
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
int=0
\end_layout
\end_inset
]
\lang french
fixe le nombre d'arguments facultatifs qui peuvent être utilisés avec ce
style.
Ceci est utile pour par exemple pour les en-têtes de section, et n'a de
sens qu'avec LaTeX.
Noter que, dans le résultat, les arguments optionnels précéderont les arguments
obligatoire (voir ci-après).
On peut donc définir des constructions comme:
\end_layout
\begin_deeper
\begin_layout LyX-Code
\backslash
mycmd[opt1]{req1}{contenu du paragraphe}
\end_layout
\begin_layout Standard
mais on peut pas avoir de constructions comme:
\end_layout
\begin_layout LyX-Code
\backslash
mycmd[opt1]{req1}[opt2]{contenu du paragraphe}
\end_layout
\begin_layout Standard
du moins sans recours au code TeX (avec lequel vous faites ce que vous voulez).
\end_layout
\end_deeper
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
ParbreakIsNewline
\end_layout
\end_inset
\begin_inset CommandInset label
LatexCommand label
name "des:ParbreakIsNewline"
\end_inset
\lang french
[
\family typewriter
\emph on
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\family typewriter
\emph on
0
\end_layout
\end_inset
\emph default
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\family typewriter
1
\end_layout
\end_inset
\family default
] indique que les paragraphes ne seront pas séparés par une ligne vide dans
le résultat LaTeX, mais par un retour à la ligne; combiné avec
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
PassThru 1
\end_layout
\end_inset
, ceci permet d'émuler une éditeur plein texte (comme l'insert code TeX).
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
ParIndent
\end_layout
\end_inset
\lang french
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
=""]
\end_layout
\end_inset
\lang french
fixe l'indentation de la toute première ligne d'un paragraphe.
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Parindent
\end_layout
\end_inset
est fixé pour un format donné, à l'exception du format
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Standard
\end_layout
\end_inset
, car l'indentation d'un paragraphe dans l'environnement
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Standard
\end_layout
\end_inset
peut être empêchée par
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
NextNoIndent
\end_layout
\end_inset
.
De plus, les paragraphes de style
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Standard
\end_layout
\end_inset
emboîtés dans d'autres environnements utilisent le
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
ParIndent
\end_layout
\end_inset
de l'environnement, pas le leur.
Par exemple, les paragraphes
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Standard
\end_layout
\end_inset
dans une énumération ne sont pas indentés.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Parsep
\end_layout
\end_inset
\lang french
[
\family typewriter
float=0
\family default
] fixe l'espacement vertical entre deux paragraphes dans le style.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Parskip
\end_layout
\end_inset
\lang french
[
\family typewriter
float=0
\family default
] fixe la valeur d'interligne entre paragraphes.
LyX donne le choix entre
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Indentation
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Interligne
\end_layout
\end_inset
pour séparer les paragraphes d'un document.
Quand on choisit
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Indentation
\end_layout
\end_inset
, cette valeur n'est pas prise en compte.
Quand on choisit
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Interligne
\end_layout
\end_inset
, la valeur de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
ParIndent
\end_layout
\end_inset
n'est pas prise en compte et tous les paragraphes sont séparés par ce paramètre
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Parskip
\end_layout
\end_inset
, en plus de l'interligne normal.
L'espacement vertical est calculé par
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
valeur*DefaultHeight()
\end_layout
\end_inset
où
\family typewriter
valeur
\family default
est la valeur choisie pour
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Parskip
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
DefaultHeight()
\end_layout
\end_inset
est la hauteur d'une ligne dans la police normale.
De cette façon, l'aspect reste le même quelle que soit la police à l'écran.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
PassThru
\end_layout
\end_inset
\begin_inset CommandInset label
LatexCommand label
name "des:PathThru"
\end_inset
\lang french
[
\family typewriter
\emph on
0
\emph default
, 1
\family default
] indique si le contenu du paragraphe doit être passé sous forme brute,
c'est-à-dire sans les traductions spéciales dont LaTeX aurait besoin.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Preamble
\end_layout
\end_inset
\begin_inset CommandInset label
LatexCommand label
name "des:Preamble"
\end_inset
\lang french
fixe le contenu à inclure dans le préambule LaTeX quand le style est utilisé.
Utile pour définir des macros, charger des paquetages, etc.
requis pour ce style particulier.
Doit être fermé par
\begin_inset Quotes fld
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
EndPreamble
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
RefPrefix
\end_layout
\end_inset
\lang french
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chaîne
\end_layout
\end_inset
] indique le préfixe à utiliser pour créer des étiquettes référant les paragraph
es de ce type.
Ceci permet l'utilisation de références mises en forme.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
RequiredArgs
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
int=0
\end_layout
\end_inset
]
\lang french
précise le nombre d'arguments attendus par la commande ou l'environnement
LaTeX correspondant à ce style.
Dans le cas d'une commande, ce sont les arguments requis autres que ceux
qui sont associés au contenu du paragraphe proprement dit.
Ceux-ci n'ont pas nécessairement besoin d'être fournis: LyX créera des
arguments vides si nécessaire.
Noter que les arguments optionnels seront émis avant les arguments obligatoires.
Voir la description de la directive
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
OptionalTags
\end_layout
\end_inset
ci-dessus pour les détails.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Requires
\end_layout
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
]
\end_layout
\end_inset
\begin_inset CommandInset label
LatexCommand label
name "des:Requires"
\end_inset
\lang french
indique que le style requiert la fonctionnalité chaîne.
Voir la description de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Provides
\end_layout
\end_inset
ci-dessus (page
\begin_inset CommandInset ref
LatexCommand pageref
reference "des:-Freespacing"
\end_inset
) pour les détails sur les fonctionnalités.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
RightMargin
\end_layout
\end_inset
\lang french
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
=""]
\end_layout
\end_inset
\lang french
similaire à
\family typewriter
LeftMargin
\family default
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Spacing
\end_layout
\end_inset
\lang french
[
\family typewriter
\emph on
single
\emph default
, onehalf, double, other
\family default
\emph on
valeur
\emph default
] définit l'interligne par défaut dans ce style.
Les paramètres
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
single
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
onehalf
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
double
\end_layout
\end_inset
correspondent respectivement à un facteur multiplicatif de 1, 1,25 et 1,667.
Si vous mettez le paramètre
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
other
\end_layout
\end_inset
, vous devez aussi mettre une valeur numérique qui servira de facteur multiplica
tif.
Notez que, contrairement aux autres paramètres,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Spacing
\end_layout
\end_inset
implique de générer du code LaTeX spécifique, qui utilise le paquetage
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
setspace.sty
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Spellcheck
\end_layout
\end_inset
\lang french
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
0
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
1
\end_layout
\end_inset
] active la correction orthographique du style.
Implicitement vrai.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
TextFont
\end_layout
\end_inset
\lang french
fixe la police utilisée pour le corps du texte.
Voir la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:polices"
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
TocLevel
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\series medium
\lang english
int
\end_layout
\end_inset
]
\lang french
fixe le niveau du style dans le table des matières.
Ceci est utilisé pour la numérotation automatique des en-têtes.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
TopSep
\end_layout
\end_inset
\lang french
[
\family typewriter
float=0
\family default
] fixe L'espacement vertical qui sépare le premier paragraphe dans une série
du même style, du paragraphe qui le précède.
Si le paragraphe précédent est dans un autre style, les séparations ne
s'ajoutent pas, mais LyX prend le maximum des deux.
\end_layout
\begin_layout Subsection
\begin_inset CommandInset label
LatexCommand label
name "sub:I18n"
\end_inset
Internationalisation des styles de paragraphes
\end_layout
\begin_layout Standard
LyX effectue depuis longtemps la traduction des informations de format,
mais, jusqu'à la version 2.0, ceci ne s'appliquait qu'à l'interface utilisateur
et non pas par exemple au résultat PDF.
Ainsi les auteurs francophones devaient avoir recours à des astuces pénibles
s'ils voulaient obtenir
\begin_inset Quotes fld
\end_inset
Théorème 1
\begin_inset Quotes frd
\end_inset
au lieu de
\begin_inset Quotes fld
\end_inset
Theorem 1
\begin_inset Quotes frd
\end_inset
.
Grâce à Georg
\noun on
Baum
\noun default
, ce n'est plus les cas.
\end_layout
\begin_layout Standard
Si un
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Style
\end_layout
\end_inset
définit un texte qui doit apparaître dans le le document typographique,
il peut utiliser
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
LangPreamble
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
BabelPreamble
\end_layout
\end_inset
pour traiter correctement les documents non anglophones, et même multilingues.
L'extrait suivant (du fichier
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
theorems-ams.inc
\end_layout
\end_inset
) illustre le fonctionnement:
\end_layout
\begin_layout LyX-Code
\lang english
Preamble
\end_layout
\begin_deeper
\begin_layout LyX-Code
\lang english
\backslash
theoremstyle{remark}
\end_layout
\begin_layout LyX-Code
\lang english
\backslash
newtheorem{claim}[thm]{
\backslash
protect
\backslash
claimname}
\end_layout
\begin_layout LyX-Code
\lang english
EndPreamble
\end_layout
\begin_layout LyX-Code
\lang english
LangPreamble
\end_layout
\begin_layout LyX-Code
\lang english
\backslash
providecommand{
\backslash
claimname}{_(Claim)}
\end_layout
\begin_layout LyX-Code
\lang english
EndLangPreamble
\end_layout
\begin_layout LyX-Code
\lang english
BabelPreamble
\end_layout
\begin_layout LyX-Code
\lang english
\backslash
addto
\backslash
captions$$lang{
\backslash
renewcommand{
\backslash
claimname}{_(Claim)}}
\end_layout
\begin_layout LyX-Code
\lang english
EndBabelPreamble
\end_layout
\end_deeper
\begin_layout Standard
En principe, toute commande LaTeX autorisée peut apparaître dans les directives
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
LangPreamble
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
BabelPreamble
\end_layout
\end_inset
, mais dans la pratique elles se présenteront typiquement comme ce qui est
montré ici.
La clé de la traduction correcte du texte typographié est la définition
de le commande LateX
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\backslash
claimname
\end_layout
\end_inset
et son utilisation avec
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\backslash
newtheorem
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
La directive
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
LangPreamble
\end_layout
\end_inset
fournit ce qu'il faut pour l'internationalisation fondée sur le langage
global du document.
Le contenu de la directive sera inclus dans le préambule, comme avec la
directive
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Preamble
\end_layout
\end_inset
.
Ce qui la rend singulière est l'utilisation de la
\begin_inset Quotes fld
\end_inset
fonction
\begin_inset Quotes frd
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
_()
\end_layout
\end_inset
, qui sera remplacée, lorsque LyX produira le résultat LaTeX, par la traduction
de son argument dans la langue du document
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Pour ceux qui s'intéressent au fonctionnement sous-jacent, la fonction
\begin_inset Quotes fld
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
_()
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
cache la fonction
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
gettext()
\end_layout
\end_inset
, qui constitue le cœur du mécanisme de traduction de l'interface LyX, et
qui est étendue ici à la traduction à la volée de code LaTeX.
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
La directive
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
BabelPreamble
\end_layout
\end_inset
est plus compliquée, car elle fournit une fonctionnalité adaptée aux documents
multilingues et propose par conséquent une interface pour le paquetage
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
babel
\end_layout
\end_inset
Son contenu sera ajouté au préambule une fois pour chaque langue utilisée
par le document.
Dans ce cas, l'argument de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
_()
\end_layout
\end_inset
sera remplacé par sa traduction dans le langage en question: l'expression
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
$$lang
\end_layout
\end_inset
est remplacée par le nom de la langue (telle qu'il est connu de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
babel
\end_layout
\end_inset
).
\end_layout
\begin_layout Standard
Un document en allemand qui inclut aussi un paragraphe en français aura
donc ceci dans le préambule:
\end_layout
\begin_layout LyX-Code
\lang english
\backslash
addto
\backslash
captionsfrench{
\backslash
renewcommand{
\backslash
claimname}{Affirmation}}
\backslash
addto
\backslash
captionsngerman{
\backslash
renewcommand{
\backslash
claimname}{Behauptung}}
\backslash
providecommand{
\backslash
claimname}{Behauptung}
\end_layout
\begin_layout Standard
LaTeX et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
babel
\end_layout
\end_inset
vont alors conspirer pour créer le texte correct dans le résultat imprimable.
\end_layout
\begin_layout Standard
Un point important à noter est que les traductions sont celles qui sont
fournies par LyX lui-même, via le mécanisme d'internationalisation de l'interfa
ce utilisateur.
Ceci signifie que
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
LangPreamble
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
BabelPreamble
\end_layout
\end_inset
ne sont effectifs que dans les fichiers de format fournis avec LyX, puisque
les fichiers de format créés par l'utilisateur ne seront pas explorés par
les fonction d'internationalisation.
Ceci dit, tout fichier de format créé dans le but d'être distribué avec
LyX doit inclure ces directives s'il y a lieu.
\end_layout
\begin_layout Subsection
Flottants
\begin_inset CommandInset label
LatexCommand label
name "sub:Flottants"
\end_inset
\end_layout
\begin_layout Standard
\begin_inset CommandInset label
LatexCommand label
name "sec:flottants"
\end_inset
Depuis la version 1.3.0 de LyX, il faut définir les flottants (
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
figure
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
tableau
\end_layout
\end_inset
\SpecialChar \ldots{}
) dans la classe elle-même.
Si vous cherchez à savoir comment mettre à jour une classe déjà existante,
il suffit probablement que vous ajoutiez
\end_layout
\begin_layout LyX-Code
Input stdfloats.inc
\end_layout
\begin_layout Standard
à un endroit raisonnable dans la classe
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
N'oubliez pas de jeter aussi un
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
oe{}
\end_layout
\end_inset
il sur les compteurs dans la section suivante.
\end_layout
\end_inset
.
Si vous voulez implémenter une classe de texte qui propose un nouveau type
de flottant (comme la classe AGU fournie avec LyX), les explications ci-dessous
vont sans doute vous être utiles :
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Extension
\end_layout
\end_inset
\family typewriter
\lang french
\family default
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
=""]
\end_layout
\end_inset
\lang french
définit le suffixe d'un fichier auxiliaire contenant la liste des flottants
de ce type.
LaTeX écrit les légendes dans ce fichier.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
GuiName
\end_layout
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
=""]
\end_layout
\end_inset
\lang french
définit la chaîne de caractères qui se trouvera dans les menus et également
dans la légende.
Ceci est traduit dans le langage courant si
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
babel
\end_layout
\end_inset
est utilisé.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
HTML*
\end_layout
\end_inset
\lang french
sont utilisées avec l'exportation XHTML.
Voir
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Styles-de-paragraphe-XHTML"
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
IsPredefined
\end_layout
\end_inset
\lang french
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
0
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
1
\end_layout
\end_inset
] indique si le flottant est déjà défini dans la classe de document ou s'il
faut charger
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
float.sty
\end_layout
\end_inset
et utiliser ses fonctionnalités pour le définir à la volée.
La valeur implicite est
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
0
\end_layout
\end_inset
qui signifie: utiliser
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
float.sty
\end_layout
\end_inset
.
Elle doit être positionnée sur
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
1
\end_layout
\end_inset
si le flottant est déjà défini par la classe de document.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
ListCommand
\end_layout
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
=""]
\end_layout
\end_inset
\lang french
détermine la commande utilisée pour engendrer une liste de flottants du
type considéré; le
\begin_inset Quotes fld
\end_inset
\backslash
\begin_inset Quotes frd
\end_inset
initial doit être omis.
Cette directive
\emph on
doit
\emph default
être utilisée si
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
UsesFloatPkg
\end_layout
\end_inset
est faux, puisqu'il n'y a alors pas de procédure pour activer cette commande.
La directive est ignorée si
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
UsesFloatPkg
\end_layout
\end_inset
est vrai, puisqu'il y a alors une procédure.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
ListName
\end_layout
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
=""]
\end_layout
\end_inset
\lang french
fixe le titre utilisé pour une liste des flottants du type considéré (figures,
tableaux, etc.).
Il est utilisé pour l'étiquette à l'écran dans LyX; il est passé à LaTeX
pour être utilisé comme titre, et il est également utilisé comme titre
dans l'exportation XHTML.
Il sera traduit dans le langage du document.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
NumberWithin
\end_layout
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
=""]
\end_layout
\end_inset
\lang french
(paramètre facultatif) détermine si les flottants de cette classe seront
numérotés en suivant un type de section du document.
Par exemple, si vous mettez
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chapter
\end_layout
\end_inset
, les flottants seront numérotés chapitre par chapitre.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Placement
\end_layout
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
=""]
\end_layout
\end_inset
\lang french
définit le placement implicite pour cette catégorie de flottants.
C'est comme en LaTeX standard :
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
t
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
b
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
p
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
h
\end_layout
\end_inset
pour haut, bas, page et ici respectivement
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Notez que l'ordre dans lequel vous mettez ces lettres est sans importance,
comme en LaTeX.
\end_layout
\end_inset
.
En plus vous avez un nouveau type,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
H
\end_layout
\end_inset
, qui ne correspond pas vraiment à un flottant, car il signifie de le positionne
r
\begin_inset Quotes fld
\end_inset
ici
\begin_inset Quotes frd
\end_inset
et nulle part ailleurs.
Notez cependant que le type
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
H
\end_layout
\end_inset
est spécial et, à cause de détails d'implantation, ne peut pas être utilisé
avec des flottants non définis dans la classe de document.
Si vous n'avez pas compris tout ce baratin, mettez simplement
\family typewriter
\begin_inset Quotes fld
\end_inset
\family default
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
tbp
\end_layout
\end_inset
\family typewriter
\begin_inset Quotes frd
\end_inset
\family default
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
RefPrefix
\end_layout
\end_inset
\lang french
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chaîne
\end_layout
\end_inset
] détermine le préfixe à utiliser lors de la création d'étiquettes référant
les flottants du type considéré.
Ceci permet l'utilisation de références mises en forme.
Notez que vous pouvez supprimer tout préfixe défini en copiant un style
en utilisant la valeur spécifique
\begin_inset Quotes fld
\end_inset
OFF
\begin_inset Quotes frd
\end_inset
, qui doit être en capitales.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Style
\end_layout
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
=""]
\end_layout
\end_inset
\lang french
fixe le style utilisé quand on définit le flottant avec
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\backslash
newfloat
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Type
\end_layout
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
=""]
\end_layout
\end_inset
\lang french
définit le
\begin_inset Quotes fld
\end_inset
type
\begin_inset Quotes frd
\end_inset
de la nouvelle classe de flottants, comme
\begin_inset Quotes fld
\end_inset
program
\begin_inset Quotes frd
\end_inset
ou
\begin_inset Quotes fld
\end_inset
algorithm
\begin_inset Quotes frd
\end_inset
.
Après l'instruction
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\backslash
newfloat
\end_layout
\end_inset
appropriée, vous disposez de commandes comme
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\backslash
begin{program}
\end_layout
\end_inset
ou
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\backslash
end{algorithm*}
\end_layout
\end_inset
.
Noter que définir un flottant de type
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
type
\end_layout
\end_inset
définit automatiquement les compteur correspondant, de nom
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
type
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
UsesFloatPkg
\end_layout
\end_inset
\lang french
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
0
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
1
\end_layout
\end_inset
] indique si ce flottant est défini en utilisant les fonctionnalités fournies
par
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
float.sty
\end_layout
\end_inset
, soit par la classe de document ou par un paquetage, soit à la volée par
LyX.
\end_layout
\begin_layout Standard
Notez que la définition d'un flottant de type
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
type
\end_layout
\end_inset
implique la déclaration du compteur correspondant de nom
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
type
\end_layout
\end_inset
.
\end_layout
\begin_layout Subsection
\lang english
Inserts flexibles et InsetLayout
\begin_inset CommandInset label
LatexCommand label
name "sub:Flex-insets-and"
\end_inset
\end_layout
\begin_layout Standard
LyX connaît les styles de caractères depuis la version 1.4.0; depuis la version
1.6.0, ceux-ci sont appelés inserts flexibles.
\end_layout
\begin_layout Standard
Les inserts flexibles sont de trois sortes:
\end_layout
\begin_layout Itemize
styles de caractères (
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
CharStyle
\end_layout
\end_inset
): ceux-ci définissent un balisage sémantique correspondant à des commandes
LaTeX telles que
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
\backslash
noun
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
\backslash
code
\end_layout
\end_inset
.
\end_layout
\begin_layout Itemize
définis par l'utilisateur (
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Custom
\end_layout
\end_inset
): ceux-ci permettent de définir des inserts repliables personnalisés, similaire
s au code TeX, aux notes de bas de page, etc.
Un exemple évident est l'insert de note en fin de document, défini dans
le module
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
endnote
\end_layout
\end_inset
.
\end_layout
\begin_layout Itemize
\lang english
éléments XML (
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Element
\end_layout
\end_inset
): à utiliser avec les classes DocBook.
\end_layout
\begin_layout Standard
Les inserts flexibles sont définis en utilisant la directive
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
InsetLayout
\end_layout
\end_inset
, qui va être expliquée dans la suite.
\end_layout
\begin_layout Standard
La directive
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
InsetLayout
\end_layout
\end_inset
a une autre fonction: elle permet de personnaliser le style de différents
types d'inserts.
Actuellement,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
InsetLayout
\end_layout
\end_inset
permet de personnaliser les paramètres de style pour les notes de bas de
page, les notes en marge, les inserts de note, les inserts de code TeX
(ERT), les branches, les listings, les index, les boîtes, les tables, les
algorithmes, les URL et les arguments facultatifs, aussi bien que de définir
des inserts flexibles.
\end_layout
\begin_layout Standard
La définition d'un
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
InsetLayout
\end_layout
\end_inset
doit commencer par une lignes de la forme:
\end_layout
\begin_layout LyX-Code
\lang english
InsetLayout <Type>
\end_layout
\begin_layout Standard
Ici
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
<Type>
\end_layout
\end_inset
indique l'insert dont le style doit être défini, et il y a deux cas.
\end_layout
\begin_layout Enumerate
Le style d'un insert préexistant doit être modifié.
Dans ce cas, peuvent être
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
<Type>
\end_layout
\end_inset
un quelconque des éléments suivants:
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Algorithm
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Branch
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Box
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Box:shaded
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
ERT
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Figure
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Foot
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Index
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Info
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Info:menu
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Info:shortcut
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Info:shortcuts
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Listings
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Marginal
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Note:Comment
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Note:Note
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Note:Greyedout
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
OptArg
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Table
\end_layout
\end_inset
, ou
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
URL
\end_layout
\end_inset
.
\end_layout
\begin_layout Enumerate
Le style d'un insert flexible doit être défini.
Dans ce cas,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
<Type>
\end_layout
\end_inset
doit être de la forme
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Flex:<nom>
\end_layout
\end_inset
, où
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
nom
\end_layout
\end_inset
peut être n'importe quel identificateur valide qui n'est pas utilisé dans
un insert existant.
L'identificateur peut inclure des espaces, mais alors il faut enclore l'ensembl
e entre apostrophes.
Noter que la définition d'un insert flexible
\emph on
doit
\emph default
aussi inclure une entrée
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LyXType
\end_layout
\end_inset
, précisant quel est le type d'insert qu'il définit.
\end_layout
\begin_layout Standard
La définition d'un
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
InsetLayout
\end_layout
\end_inset
peut inclure les entrées suivantes:
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
BgColor
\end_layout
\end_inset
\lang french
définit la couleur d'arrière-plan de l'insert.
Les couleurs valides sont définies dans
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
src/ColorCode.h
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
ContentAsLabel
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
0
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
1
\end_layout
\end_inset
]
\lang french
indique s'il faut utiliser le contenu de l'insert comme une étiquette,
quand l'insert est fermé.
Valeur implicite: faux.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
CopyStyle
\end_layout
\end_inset
\lang french
fonctionne comme pour les styles de paragraphe (voir page
\begin_inset CommandInset ref
LatexCommand pageref
reference "des:-copystyle"
\end_inset
).
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
CustomPars
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
0
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
1
\end_layout
\end_inset
]
\lang french
indique si l'utilisateur peut utiliser le dialogue
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
Éditer\SpecialChar \menuseparator
Paramètres
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
paragraphe
\end_layout
\end_inset
pour personnaliser le paragraphe.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Decoration
\end_layout
\end_inset
\lang french
peut être
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Classic
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Minimalistic
\end_layout
\end_inset
, ou
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Conglomerate
\end_layout
\end_inset
, décrivant l'apparence du cadre et des boutons de l'insert.
les notes de bas de page utilisent en général
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Classic
\end_layout
\end_inset
, les insert des code TeX
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Minimalistic
\end_layout
\end_inset
, et les styles de caractères
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Conglomerate
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Display
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
0
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
1
\end_layout
\end_inset
]
\lang french
n'est utilisé que lorsque
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
LatexType
\end_layout
\end_inset
vaut
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Environment
\end_layout
\end_inset
.
Indique si l'environnement se trouvera à part dans le résultat imprimable
LaTeX ou bien apparaîtra inclus dans le texte environnant.
S'il est positionné à faux, on suppose que l'environnement LaTeX ignore
les espaces (avec un caractère retour ligne inclus) après les balises
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\backslash
begin{
\emph on
LatexName
\emph default
}
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\backslash
end{
\emph on
LatexName
\emph default
}
\end_layout
\end_inset
.
Valeur implicite: vrai.
\end_layout
\begin_layout Description
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
End
\end_layout
\end_inset
est requis pour fermer la déclaration d'un InsetLayout.
\end_layout
\begin_layout Description
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Font
\end_layout
\end_inset
définit la police utilisée pour le texte du corps de l'insert
\emph on
et
\emph default
pour le marqueur.
Voir la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:polices"
\end_inset
.
Noter qu'en définissant cette police on définit aussi automatiquement
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LabelFont
\end_layout
\end_inset
avec la même valeur.
Il faut donc définir celle-ci d'abord pour fixer
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LabelFont
\end_layout
\end_inset
différemment.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
ForceLTR
\end_layout
\end_inset
\lang french
impose le langage
\begin_inset Quotes fld
\end_inset
latex
\begin_inset Quotes frd
\end_inset
, conduisant à un résultat de gauche à droite (Left-to-Right, latin), e.
\begin_inset space \thinspace{}
\end_inset
g.
\begin_inset space \space{}
\end_inset
en code TeX ou dans un URL.
Une verrue.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
ForcePlain
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
0
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
1
\end_layout
\end_inset
]
\lang french
indique si
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
PlainLayout
\end_layout
\end_inset
doit être utilisé, ou bien si l'utilisateur peut modifier le style de paragraph
e utilisé dans l'insert.
Valeur implicite: faux.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
FreeSpacing
\end_layout
\end_inset
\lang french
fonctionne comme dans les styles de paragraphe (voir page
\begin_inset CommandInset ref
LatexCommand pageref
reference "des:-Freespacing"
\end_inset
).
Valeur implicite: faux.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
HTML*
\end_layout
\end_inset
\lang french
sont utilisées avec l'exportation XHTML.
Voir
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Styles-de-paragraphe-XHTML"
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
InToc
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
0
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
1
\end_layout
\end_inset
]
\lang french
indique s'il faut inclure le contenu de cet insert dans les chaînes créées
pour le panneau
\begin_inset Quotes fld
\end_inset
Plan
\begin_inset Quotes frd
\end_inset
.
L'utilisateur ne voudra pas, par exemple, que le contenu d'une note de
bas de page dans un titre de section soit incluse dans la tables des matières
affichée dans le plan, mais voudra habituellement voir affiché le contenu
d'un style de caractère.
Valeur implicite; faux, pas d'inclusion.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
KeepEmpty
\end_layout
\end_inset
\lang french
fonctionne comme dans les styles de paragraphe (voir
\lang english
page
\begin_inset CommandInset ref
LatexCommand pageref
reference "des:KeepEmpty"
\end_inset
).
\lang french
Valeur implicite: faux.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LabelFont
\end_layout
\end_inset
\lang french
définit la police utilisée pour le marqueur.
Voir la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:polices"
\end_inset
.
Noter que cette directive ne peut jamais apparaître avant
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Font
\end_layout
\end_inset
, sinon elle sera sans effet.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LabelString
\end_layout
\end_inset
\lang french
définit la chaîne de caractères qui apparaîtra sur le bouton ou ailleurs
en tant que marquer d'insert.
Quelques types d'inserts (
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
code TeX
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Branche
\end_layout
\end_inset
) modifient ce marqueur à la volée.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LatexName
\end_layout
\end_inset
\lang french
définit le nom du code LaTeX correspondant, soit un environnement, soit
une commande.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LatexParam
\end_layout
\end_inset
\lang french
définit le paramètre facultatif pour le
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LatexName
\end_layout
\end_inset
correspondant, y compris des paires de crochets
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[]
\end_layout
\end_inset
.
Ce paramètre ne peut pas être modifié depuis LyX.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LatexType
\end_layout
\end_inset
\lang french
fonctionne comme dans les styles de paragraphe (voir
\lang english
page
\begin_inset CommandInset ref
LatexCommand pageref
reference "des:LatexType"
\end_inset
).
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LyxType
\end_layout
\end_inset
\lang french
peut être
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
charstyle
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
custom
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
element
\end_layout
\end_inset
, ou
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
end
\end_layout
\end_inset
(indiquant une définition vide terminant les définitions de styles de caractère
s, etc).
Cette entrée est requise dans les inserts flexibles et n'est significative
que là.
Parmi d'autres choses, elle détermine dans quel menu cet insert va apparaître.
Fixer
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
LyXType
\end_layout
\end_inset
à
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
charstyle
\end_layout
\end_inset
positionnera
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
MultiPar
\end_layout
\end_inset
à faux.
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
MultiPar
\end_layout
\end_inset
peut être positionné à vrai pour les inserts
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
charstyle
\end_layout
\end_inset
, si vous le souhaitez, en le positionnant
\emph on
après
\emph default
avoir fixé
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
LyXType
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
MultiPar
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
0
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
1
\end_layout
\end_inset
]
\lang french
indique si plusieurs paragraphes sont autorisés dans cet insert.
Ceci positionnera aussi
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
CustomPars
\end_layout
\end_inset
à la même valeur et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
ForcePlain
\end_layout
\end_inset
à la valeur opposée.
Ceux-ci peuvent être repositionnés s'ils sont utilisés
\emph on
après
\emph default
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
MultiPar
\end_layout
\end_inset
.
Valeur implicite: vrai.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
NeedProtect
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
0
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
1
\end_layout
\end_inset
]
\lang french
indique si les commandes fragiles de cet insert doivent êtres protégées
par
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
\backslash
protect
\end_layout
\end_inset
(Note: ceci ne dit
\emph on
rien
\emph default
sur le fait que la commande elle-même doive être protégée).
Valeur implicite: faux.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
ParbreakIsNewline
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
0
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
1
\end_layout
\end_inset
]
\lang french
fonctionne comme dans les styles de paragraphe (voir page
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand pageref
reference "des:ParbreakIsNewline"
\end_inset
).
Valeur implicite: faux.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
PassThru
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
0
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
1
\end_layout
\end_inset
]
\lang french
fonctionne comme dans les styles de paragraphe (voir
\lang english
\lang french
page
\lang english
\begin_inset CommandInset ref
LatexCommand pageref
reference "des:PathThru"
\end_inset
).
\lang french
Valeur implicite: faux.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Preamble
\end_layout
\end_inset
\lang french
fonctionne comme dans les styles de paragraphe (voir page
\lang english
\begin_inset CommandInset ref
LatexCommand pageref
reference "des:Preamble"
\end_inset
).
\lang french
Valeur implicite: faux.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
RefPrefix
\end_layout
\end_inset
\lang french
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chaîne
\end_layout
\end_inset
] indique le préfixe à utiliser pour créer des étiquettes référant les paragraph
es de ce type.
Ceci permet l'utilisation de références mises en forme.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Requires
\end_layout
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
[
\lang french
chaîne
\lang english
=""]
\end_layout
\end_inset
\lang french
fonctionne comme dans les styles de paragraphe (voir page
\lang english
\begin_inset CommandInset ref
LatexCommand pageref
reference "des:Requires"
\end_inset
).
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
ResetsFont
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
0
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
1
\end_layout
\end_inset
]
\lang french
indique si l'insert doit utiliser la police de caractères environnante ou
bien utiliser la sienne propre.
Valeur implicite; vrai, utiliser sa propre police.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Spellcheck
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
0
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
1
\end_layout
\end_inset
]
\lang french
active le correcteur orthographique sur le contenu de cet insert.
Valeur implicite; vrai.
\end_layout
\begin_layout Subsection
Compteurs
\begin_inset CommandInset label
LatexCommand label
name "sub:Compteurs"
\end_inset
\end_layout
\begin_layout Standard
Depuis la version 1.3.0 de LyX, il faut définir les compteurs (
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chapitre
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
figure
\end_layout
\end_inset
\SpecialChar \ldots{}
) dans la classe elle-même.
Les compteurs standard sont définis dans le fichier
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
stdcounters.inc
\end_layout
\end_inset
\lang french
.
Si vous cherchez à savoir comment mettre à jour une classe déjà existante,
il suffit probablement que vous ajoutiez
\end_layout
\begin_layout LyX-Code
Input stdcounters.inc
\end_layout
\begin_layout Standard
à un endroit raisonnable dans la classe.
\end_layout
\begin_layout Standard
Mais si vous voulez définir des compteurs à votre guise, vous pouvez le
faire.
la déclaration d'un compteur doit commencer par
\end_layout
\begin_layout LyX-Code
\lang english
Counter
\lang french
nomCompteur
\end_layout
\begin_layout Standard
où bien entendu
\begin_inset Quotes fld
\end_inset
nomCompteur
\begin_inset Quotes frd
\end_inset
est remplacé par le nom du compteur.
Et elle doit se terminer par
\begin_inset Quotes fld
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
End
\end_layout
\end_inset
\begin_inset Quotes frd
\end_inset
.
Les paramètres suivants peuvent également être utilisés:
\end_layout
\begin_layout Description
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
LabelString [chaîne=""]
\end_layout
\end_inset
définit comment le compteur s'affiche.
Fixer ce paramètre positionne également
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LabelStringAppendix
\end_layout
\end_inset
à la même valeur.
Les arguments spécifiques suivants peuvent être utilisés:
\end_layout
\begin_deeper
\begin_layout Itemize
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
\backslash
thecounter
\end_layout
\end_inset
sera remplacé par l'expansion de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LabelString
\end_layout
\end_inset
(ou
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LabelStringAppendix
\end_layout
\end_inset
) du compteur
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
counter
\end_layout
\end_inset
.
\end_layout
\begin_layout Itemize
les valeurs du compteur peuvent être exprimées par des macros à la LaTeX
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
\backslash
\emph on
numbertype
\emph default
{
\emph on
counter
\emph default
}
\end_layout
\end_inset
, où
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
numbertype
\end_layout
\end_inset
peut être:
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
De fait, la situation est un peu plus compliquée; n'importe quel
\emph on
numbertype
\emph default
autre que ceux décrits ci-après produiront une numérotation en chiffres
arabes.
Il serait surprenant que cela change dans le futur.
\end_layout
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
arabic
\end_layout
\end_inset
: 1, 2, 3,\SpecialChar \ldots{}
;
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
alph
\end_layout
\end_inset
pour les let tes en bas de casse: a, b, c, \SpecialChar \ldots{}
;
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Alph
\end_layout
\end_inset
pour les lettres en capitales: A, B, C, \SpecialChar \ldots{}
;
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
roman
\end_layout
\end_inset
pour la numérotation en bas de casse romaine: i, ii, iii, \SpecialChar \ldots{}
;
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Roman
\end_layout
\end_inset
pour la numérotation capitale romaine: I, II, III\SpecialChar \ldots{}
;
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
hebrew
\end_layout
\end_inset
pour la numérotation hébraïque.
\end_layout
\end_deeper
\begin_layout Standard
Si LabelString est indéfini, une valeur implicite est construite comme suit:
si le compteur a un compteur maître
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
master
\end_layout
\end_inset
(défini via
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Within
\end_layout
\end_inset
), la chaîne
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
\backslash
themaster.
\backslash
arabic{counter}
\end_layout
\end_inset
est utilisée; sinon la chaîne
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
\backslash
arabic{counter}
\end_layout
\end_inset
est utilisée.
\end_layout
\begin_layout Description
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
LabelStringAppendix [string=""]
\end_layout
\end_inset
est identique à
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
LabelString
\end_layout
\end_inset
, mais pour les appendices.
\end_layout
\begin_layout Description
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
PrettyFormat
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
string
\end_layout
\end_inset
=
\begin_inset Quotes erd
\end_inset
\begin_inset Quotes erd
\end_inset
] définit un format à utiliser pour les références lises en forme utilisant
ce compteur.
Par exemple, on peut vouloir que les références aux numéros de section
apparaissent comme
\begin_inset Quotes fld
\end_inset
Section 2.4
\begin_inset Quotes frd
\end_inset
.
La chaîne devra contenir
\begin_inset Quotes fld
\end_inset
##
\begin_inset Quotes frd
\end_inset
.
Ceci sera remplacé par la valeur courante du compteur.
Ainsi, pour les sections, ce sera: Section ##.
\end_layout
\begin_layout Description
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Within
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
string
\end_layout
\end_inset
=
\begin_inset Quotes erd
\end_inset
\begin_inset Quotes erd
\end_inset
] contient le nom d'un autre compteur: le compteur actuel sera remis à zéro
à chaque fois que l'autre augmentera.
Par exemple,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
sous-section
\end_layout
\end_inset
est numéroté dans
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
section
\end_layout
\end_inset
.
\end_layout
\begin_layout Subsection
Description de police
\begin_inset CommandInset label
LatexCommand label
name "sub:polices"
\end_inset
\end_layout
\begin_layout Standard
Une description de police ressemble à :
\end_layout
\begin_layout LyX-Code
Font
\family roman
\emph on
ou
\family default
\emph default
LabelFont
\end_layout
\begin_layout LyX-Code
...
\end_layout
\begin_layout LyX-Code
EndFont
\end_layout
\begin_layout Standard
et les commandes suivantes sont disponibles :
\end_layout
\begin_layout Description
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Color
\end_layout
\end_inset
\family typewriter
\family default
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
none
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
black
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
white
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
red
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
green
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
blue
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
cyan
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
magenta
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
yellow
\end_layout
\end_inset
]
\end_layout
\begin_layout Description
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Family
\end_layout
\end_inset
[
\emph on
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Roman
\end_layout
\end_inset
\emph default
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Sans
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Typewriter
\end_layout
\end_inset
]
\end_layout
\begin_layout Description
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Misc
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
string
\end_layout
\end_inset
] avec les arguments valides suivants:
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
emph
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
noun
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
strikeout
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
underbar
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
uuline
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
uwave
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
no_emph
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
no_noun
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
no_strikeout
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
no_bar
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
no_uuline
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
no_uwave
\end_layout
\end_inset
.
Chacun de ceux-ci (dés)active l'attribut correspondant.
\begin_inset Newline newline
\end_inset
Par exemple,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
emph
\end_layout
\end_inset
active la mise en évidence, et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
no_emph
\end_layout
\end_inset
la désactive.
Si e dernier point vous intrigue, souvenez-vous que le réglage de police
du contexte courant est généralement hérité du contexte environnant.
De ce fait,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
no_emph
\end_layout
\end_inset
désactiverait la mise en évidence qui était active de toutes façons, par
exemple dans un environnement de théorème.
\end_layout
\begin_layout Description
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Series
\end_layout
\end_inset
[
\emph on
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Medium
\end_layout
\end_inset
\emph default
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Bold
\end_layout
\end_inset
]
\end_layout
\begin_layout Description
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Shape
\end_layout
\end_inset
[
\emph on
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Up
\end_layout
\end_inset
\emph default
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Italic
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
SmallCaps
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Slanted
\end_layout
\end_inset
]
\end_layout
\begin_layout Description
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Size
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
tiny
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
small
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
normal
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
large
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
larger
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
largest
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
huge
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
giant
\end_layout
\end_inset
]
\end_layout
\begin_layout Subsection
Description d'une insertion de citation
\begin_inset CommandInset label
LatexCommand label
name "sub:Description citation"
\end_inset
\end_layout
\begin_layout Standard
Les blocs
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
CiteFormat
\end_layout
\end_inset
servent à décrire comment les citations bibliographiques doivent être affichées
, à la fois dans LyX (dans la fenêtre de citation et dans les bulles d'aide,
par exemple) et dans le résultat XHTML.
Un tel bloc se présente comme suit:
\end_layout
\begin_layout LyX-Code
\lang english
CiteFormat
\end_layout
\begin_layout LyX-Code
\lang english
article ...
\end_layout
\begin_layout LyX-Code
\lang english
book ...
\end_layout
\begin_layout LyX-Code
\lang english
End
\end_layout
\begin_layout Standard
Les différentes lignes définissent l'affichage de l'information correspondant
à une article ou à un livre, respectivement, et une telle définition peut
être créée pour tout type d'entrée apparaissant dans un fichier BibTeX.
LyX définit un format implicite dans le code source qui sera utilisé si
aucune définition spécifique n'est fournie.
LyX prédéfinit plusieurs formats dans le fichier
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
stdciteformats.inc
\end_layout
\end_inset
, qui est inclus dans la plupart des classes de document LyX.
\end_layout
\begin_layout Standard
Les définitions utilisent un langage simple qui permet
\begin_inset space ~
\end_inset
de remplacer les clés BibTeX par leurs valeurs.
les clés doivent être encloses entre caractères
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
%
\end_layout
\end_inset
, e.g.:
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
%author%
\end_layout
\end_inset
.
\lang french
Une définition simple serait par exemple:
\end_layout
\begin_layout LyX-Code
\lang english
misc %author%,
\begin_inset Quotes eld
\end_inset
%title
\begin_inset Quotes erd
\end_inset
.
\end_layout
\begin_layout Standard
Ceci imprimerait le nom de l'auteur, suivi d'une virgule, suivi du titre,
entre double guillemets, suivi d'un point.
\end_layout
\begin_layout Standard
Bine entendu, vous voudrez parfois n'imprimer une clé que si elle existe.
Ceci est obtenu par une construction conditionnelle, comme:
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
{%volume%[[vol.
\begin_inset space ~
\end_inset
%volume%]]}
\end_layout
\end_inset
.
Ceci signifie: si la clé
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
volume
\end_layout
\end_inset
existe, alors imprimer
\begin_inset Quotes fld
\end_inset
vol.
\begin_inset Quotes frd
\end_inset
suivi de la clé volume.
On peut aussi introduire une clause
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
else
\end_layout
\end_inset
dans l'expression conditionnelle, comme dans:
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
{%author%[[%author%]][[%editor%, ed.]]}
\end_layout
\end_inset
.
Ici, la clé
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
author
\end_layout
\end_inset
est imprimée si elle existe; sinon la clé
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
editor
\end_layout
\end_inset
est imprimée, suivi de
\begin_inset Quotes fld
\end_inset
, ed.
\begin_inset Quotes frd
\end_inset
.
Noter que la clé est encore enclose entre caractères
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
%
\end_layout
\end_inset
; la clause conditionnelle entière est enclose entre accolades, et les clauses
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
if
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
else
\end_layout
\end_inset
sont encloses entre double crochets
\begin_inset Quotes fld
\end_inset
[[
\begin_inset Quotes frd
\end_inset
et
\begin_inset Quotes fld
\end_inset
]]
\begin_inset Quotes frd
\end_inset
.
Il ne peut avoir d'espaces entre ces marqueurs.
\end_layout
\begin_layout Standard
Il existe enfin une autre syntaxe possible dans ces définitions, qui se
présente comme suit:
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
{!<i>!}
\end_layout
\end_inset
.
Ceci définit une entité d'information utilisée pour créer du
\begin_inset Quotes fld
\end_inset
texte enrichi
\begin_inset Quotes frd
\end_inset
.
De manière évidente, nous ne souhaitons pas exporter des balises HTML en
écrivant du texte normal, aussi doivent elles être enclose entre
\begin_inset Quotes fld
\end_inset
{!
\begin_inset Quotes frd
\end_inset
et
\begin_inset Quotes fld
\end_inset
!}
\begin_inset Quotes frd
\end_inset
.
\end_layout
\begin_layout Standard
Deux définitions spéciales sont également disponibles dans un bloc
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
CiteFormat
\end_layout
\end_inset
Un exemple de la première définition est celle-ci:
\end_layout
\begin_layout LyX-Code
!quotetitle
\begin_inset Quotes eld
\end_inset
%title%
\begin_inset Quotes erd
\end_inset
\end_layout
\begin_layout Standard
Ceci est une abréviation, ou macro-instruction, et peut être employée comme
une clé:
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
%!quotetitle%
\end_layout
\end_inset
.
LyX considérera
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
%!quotetitle%
\end_layout
\end_inset
exactement comme s'l s'agissait de sa définition.
Exprimons par conséquent un
\emph on
avertissement
\emph default
évident: n'utilisez pas:
\end_layout
\begin_layout LyX-Code
!funfun %funfun%
\end_layout
\begin_layout Standard
ou similaire.
LyX ne devrait pas se perdre dans une boucle infinie, mais cela peut prendre
un moment avant qu'il s'en sorte.
\end_layout
\begin_layout Standard
Le second type de définitions particulières se présente comme ceci:
\end_layout
\begin_layout LyX-Code
\lang english
_pptext pp.
\end_layout
\begin_layout Standard
Ceci définit un segment de texte susceptible de traduction, ce qui permet
de traduire les parties appropriées de la bibliographie.
Cette syntaxe peut être inclue dans une définition normale en la considérant
comme une clé:
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
%_pptext%
\end_layout
\end_inset
.
Plusieurs d'entre elles sont prédéfinies dans
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
stdciteformats.inc
\end_layout
\end_inset
.
Notez bien que ce ne sont pas des macro-instructions, au sens défini ci-dessus:
elles ne seront pas interprétées.
\end_layout
\begin_layout Standard
Voici donc un exemple utilisant toutes ces fonctionnalités:
\end_layout
\begin_layout LyX-Code
\lang english
!authoredit {%author%[[%author%, ]][[{%editor%[[%editor%, %_edtext%, ]]}]]}
\end_layout
\begin_layout Standard
Ceci défini une macro qui imprime le nom de l'auteur, suivi d'un virgule,
si la clé
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
author
\end_layout
\end_inset
existe, ou bien imprime le nom de l'éditeur, suivi de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
_edtext
\end_layout
\end_inset
ou de sa traduction (implicitement, apparaîtra
\begin_inset Quotes fld
\end_inset
ed.
\begin_inset Quotes frd
\end_inset
), si la clé
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
editor
\end_layout
\end_inset
existe.
Notez que ceci est déjà défini dans
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
stdciteformats.inc
\end_layout
\end_inset
, vous pouvez donc l'utiliser dans vos propres définitions, ou redéfinitions,
si vous chargez ce fichier d'abord.
\end_layout
\begin_layout Section
Directives pour l'exportation XHTML
\begin_inset CommandInset label
LatexCommand label
name "sec:Tags-for-XHTML"
\end_inset
\end_layout
\begin_layout Standard
Comme pour LaTeX ou DocBook, la présentation du résultat HTML créé par LyX
est déterminé par les informations de format.
En général, LyX produit une présentation implicite raisonnable, et comme
indiqué plus haut, il construira même des règles implicites CSS à partir
des autres directives de format.
Par exemple, LyX essaiera d'utiliser l'information du bloc
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Font
\end_layout
\end_inset
du style Chapter pour écrire une CSS qui mettra en forme les titres de
chapitres de manière appropriée.
\end_layout
\begin_layout Standard
Dans de nombreux cas, vous n'aurez donc sans doute rien à faire du tout
pour obtenir un résultat XHTML acceptable pour vos environnements propres,
vos inserts personnalisés, et ainsi de suite.
Mais dans certains cas vous devrez faire quelque chose, et LyX fournit
par conséquent un certain nombre de directives de format qui peuvent être
utilisées pour personnaliser le XHTML et les CSS qui sont créés.
\end_layout
\begin_layout Standard
Notez qu'il existe deux directives,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
HTMLPreamble
\end_layout
\end_inset
and
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
AddToHTMLPreamble
\end_layout
\end_inset
, qui peuvent apparaître en dehors des déclarations de style et d'insert.
Voir
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Paramètres-généraux-d'une"
\end_inset
pour les détails sur celles-ci.
\end_layout
\begin_layout Subsection
Styles de paragraphe
\begin_inset CommandInset label
LatexCommand label
name "sub:Styles-de-paragraphe-XHTML"
\end_inset
\end_layout
\begin_layout Standard
Le type de XHTML que LyX crée pour un paragraphe dépend s'il s'agit d'un
paragraphe normal, d'une commande, ou d'un environnement, ce qui est déterminé
par le contenu de la directive correspondante
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
LaTeXType
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
Pour une commande ou un paragraphe normal, le résultat XHTML a la forme
suivante:
\end_layout
\begin_layout LyX-Code
\lang english
<tag attr=
\begin_inset Quotes erd
\end_inset
value
\begin_inset Quotes erd
\end_inset
>
\end_layout
\begin_layout LyX-Code
\lang english
<labeltag attr=
\begin_inset Quotes erd
\end_inset
value
\begin_inset Quotes erd
\end_inset
>
\lang french
Étiquette
\lang english
</labeltag>
\end_layout
\begin_layout LyX-Code
Contenu du paragraphe
\end_layout
\begin_layout LyX-Code
\lang english
</tag>
\end_layout
\begin_layout Standard
Les balises d'étiquette sont bien entendu omises si le paragraphe n'est
pas étiqueté.
\end_layout
\begin_layout Standard
Pour un environnement qui n'est pas du type liste, le XHTML prend la forme:
\end_layout
\begin_layout LyX-Code
\lang english
<tag attr=
\begin_inset Quotes erd
\end_inset
value
\begin_inset Quotes erd
\end_inset
>
\end_layout
\begin_layout LyX-Code
\lang english
<itemtag attr=
\begin_inset Quotes erd
\end_inset
value
\begin_inset Quotes erd
\end_inset
><labeltag attr=
\begin_inset Quotes erd
\end_inset
value
\begin_inset Quotes erd
\end_inset
>
\lang french
Étiquette d'environnement
\lang english
</labeltag>
\lang french
Premier paragraphe.
\lang english
</itemtag>
\end_layout
\begin_layout LyX-Code
\lang english
<itemtag>
\lang french
Second paragraphe.
\lang english
</itemtag>
\end_layout
\begin_layout LyX-Code
\lang english
</tag>
\end_layout
\begin_layout Standard
Noter que l'étiquette n'est émise que pour le premier paragraphe, comme
ce serait le cas pour une théorème, par exemple.
\end_layout
\begin_layout Standard
Pour une liste, nous avons une de ces formes:
\end_layout
\begin_layout LyX-Code
\lang english
<tag attr=
\begin_inset Quotes erd
\end_inset
value
\begin_inset Quotes erd
\end_inset
>
\end_layout
\begin_layout LyX-Code
\lang english
<itemtag attr=
\begin_inset Quotes erd
\end_inset
value
\begin_inset Quotes erd
\end_inset
><labeltag attr=
\begin_inset Quotes erd
\end_inset
value
\begin_inset Quotes erd
\end_inset
>
\lang french
Étiquette de liste
\lang english
</labeltag>
\lang french
Premier élément.
\lang english
</itemtag>
\end_layout
\begin_layout LyX-Code
\lang english
<itemtag attr=
\begin_inset Quotes erd
\end_inset
value
\begin_inset Quotes erd
\end_inset
><labeltag attr=
\begin_inset Quotes erd
\end_inset
value
\begin_inset Quotes erd
\end_inset
>
\lang french
Étiquette de liste
\lang english
</labeltag>
\lang french
Second élément.
\lang english
</itemtag>
\end_layout
\begin_layout LyX-Code
\lang english
</tag>
\end_layout
\begin_layout LyX-Code
\end_layout
\begin_layout LyX-Code
\lang english
<tag attr=
\begin_inset Quotes erd
\end_inset
value
\begin_inset Quotes erd
\end_inset
>
\end_layout
\begin_layout LyX-Code
\lang english
<labeltag attr=
\begin_inset Quotes erd
\end_inset
value
\begin_inset Quotes erd
\end_inset
>
\lang french
Étiquette de liste
\lang english
</labeltag><itemtag attr=
\begin_inset Quotes erd
\end_inset
value
\begin_inset Quotes erd
\end_inset
>
\lang french
Premier élément.
\lang english
</itemtag>
\end_layout
\begin_layout LyX-Code
\lang english
<labeltag attr=
\begin_inset Quotes erd
\end_inset
value
\begin_inset Quotes erd
\end_inset
>
\lang french
Étiquette de liste
\lang english
</labeltag><itemtag attr=
\begin_inset Quotes erd
\end_inset
value
\begin_inset Quotes erd
\end_inset
>
\lang french
Second élément.
\lang english
</itemtag>
\end_layout
\begin_layout LyX-Code
\lang english
</tag>
\end_layout
\begin_layout Standard
Noter la différence en ce qui concerne l'ordre des balises
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
labeltag
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
itemtag
\end_layout
\end_inset
.
L'ordre obtenu dépend du positionnement de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
HTMLLabelFirst
\end_layout
\end_inset
: si la valeur de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
HTMLLabelFirst
\end_layout
\end_inset
est fausse (valeur implicite), vous obtiendrez la première forme, avec
l'étiquette dans l'élément; s'il la valeur est vraie, vous obtiendrez la
seconde forme, avec l'étiquette en dehors de l'élément.
\end_layout
\begin_layout Standard
Les balises et les attributs spécifiques émis pour chaque type de paragraphe
peuvent être contrôlés par les directives de format que nous allons décrire.
Comme indiqué ci-dessus, cependant, LyX utilise des valeurs implicites
raisonnables pour la plupart d'entre elles, vous n'aurez donc pas grand'chose
à faire pour produire un résultat XHTML satisfaisant.
Pensez aux directives disponibles comme un supplément pour obtenir un réglage
à votre convenance.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLAttr
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chaîne
\end_layout
\end_inset
]
\lang french
précise les informations d'attribut à émettre avec la balise principale.
Par exemple
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\begin_inset Quotes fld
\end_inset
class=`madiv'
\begin_inset Quotes frd
\end_inset
\end_layout
\end_inset
.
Implicitement, LyX émettra
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\begin_inset Quotes fld
\end_inset
class=`nomstyle'
\begin_inset Quotes frd
\end_inset
\end_layout
\end_inset
, où
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
nomstyle
\end_layout
\end_inset
est le nom du style en bas de casse, par exemple: chapter.
Ceci ne doit contenir
\emph on
aucune
\emph default
information de style: utiliser
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
HTMLStyle
\end_layout
\end_inset
pour cela.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLForceCSS
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
0
\emph default
,1
\end_layout
\end_inset
]
\lang french
indique s'il faut émettre l'information CSS implicite engendrée par LyX
pour ce style, même si une information complémentaire est explicitement
émise par
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
HTMLStyle
\end_layout
\end_inset
.
Positionner cette directive à
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
1
\end_layout
\end_inset
vous permet de modifier ou de compléter la CSS créée, plutôt que de l'écraser
complètement.
Implicitement
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
0
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLItem
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chaîne
\end_layout
\end_inset
]
\lang french
définit la balise utilisée pour les paragraphes ou environnements isolés,
qui remplace
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
itemtag
\end_layout
\end_inset
dans les exemples ci-dessus.
Vaut implicitement
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
div
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLItemAttr
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chaîne
\end_layout
\end_inset
]
\lang french
définit les attributs des balises
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
itemtag
\end_layout
\end_inset
.
Vaut implicitement
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\begin_inset Quotes fld
\end_inset
class=`nomstyle_item'
\begin_inset Quotes frd
\end_inset
\end_layout
\end_inset
.
Ceci ne doit contenir
\emph on
aucune
\emph default
information de style: utiliser
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
HTMLStyle
\end_layout
\end_inset
pour cela.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLLabel
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chaîne
\end_layout
\end_inset
]
\lang french
définit la balise utilisée pour les étiquettes de paragraphe et d'élément,
qui remplace
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
labeltag
\end_layout
\end_inset
dans les exemples ci-dessus.
Vaut implicitement
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
span
\end_layout
\end_inset
, à moins que
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
LabelType
\end_layout
\end_inset
soit
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Top_Environment
\end_layout
\end_inset
ou
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Centered_Top_Environment
\end_layout
\end_inset
, auquel cas elle vaut implicitement
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
div
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLLabelAttr
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chaîne
\end_layout
\end_inset
]
\lang french
définit les attributs de la balise
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
labeltag
\end_layout
\end_inset
.
Vaut implicitement
\begin_inset Quotes erd
\end_inset
.
Ceci ne doit contenir
\emph on
aucune
\emph default
information de style: utiliser
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
HTMLStyle
\end_layout
\end_inset
pour cela.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLLabelFirst
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
0
\emph default
,1
\end_layout
\end_inset
]
\lang french
, significatif uniquement pour les environnements de liste, contrôle si
la balise d'étiquetage est émise avant ou dans la balise d'élément.
Ceci est utilisé par exemple dans l'environnement de description, où l'on
veut
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\begin_inset Quotes fld
\end_inset
<dt>\SpecialChar \ldots{}
</dt><dd>\SpecialChar \ldots{}
</dd>
\begin_inset Quotes frd
\end_inset
\end_layout
\end_inset
.
Vaut implicitement
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
0
\end_layout
\end_inset
: la balise d'étiquetage est dans la balise d'élément.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLPreamble
\end_layout
\end_inset
\lang french
définit l'information à émettre dans la section
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
<head>
\end_layout
\end_inset
quand ce style est utilisé.
Ceci pourrait être utilisé par exemple pour inclure un bloc
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
<script>
\end_layout
\end_inset
définissant un gestionnaire
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
onclick
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLStyle
\end_layout
\end_inset
\lang french
définit l'information à émettre dans la section
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
<head>
\end_layout
\end_inset
quand ce style est utilisé.
Ceci pourrait être utilisé par exemple pour inclure un bloc
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
<script>
\end_layout
\end_inset
définissant un gestionnaire
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
onclick
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLTag
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chaîne
\end_layout
\end_inset
]
\lang french
définit la balise utilisé pour l'étiquette principale, qui remplace
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
tag
\end_layout
\end_inset
dans les exemples ci-dessus.
Vaut implicitement
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
div
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLTitle
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
0
\emph default
,1
\end_layout
\end_inset
]
\lang french
identifie ce style comme celui à utiliser pour créer la balise
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
<title>
\end_layout
\end_inset
dans le fichier XHTML.
Implicitement fausse.
Le fichier
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
stdtitle.inc
\end_layout
\end_inset
la positionne à vraie pour l'environnement
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
title
\end_layout
\end_inset
.
\end_layout
\begin_layout Subsection
\lang english
InsetLayout XHTML
\end_layout
\begin_layout Standard
L'exportation XHTML des inserts peut également être contrôlée par l'information
résidant dans les fichiers de format
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
Pour le moment, ceci n'est exact que pour les inserts de
\begin_inset Quotes fld
\end_inset
texte
\begin_inset Quotes frd
\end_inset
(les inserts dans lesquels vous pouvez effectuer une saisie), mais n'est
pas exact pour les inserts de
\begin_inset Quotes fld
\end_inset
commande
\begin_inset Quotes frd
\end_inset
(inserts associés à des boîtes de dialogue).
\end_layout
\end_inset
.
Là encore, LyX essaie de produire implicitement un résultat raisonnable,
et il crée des règles CSS implicites.
Mais tout eut être personnalisé.
\end_layout
\begin_layout Standard
Le résultat XHTML produit par LyX pour un insert a la forme suivante:
\end_layout
\begin_layout LyX-Code
\lang english
<tag attr=
\begin_inset Quotes erd
\end_inset
value
\begin_inset Quotes erd
\end_inset
>
\end_layout
\begin_layout LyX-Code
\lang english
<labeltag>
\lang french
Étiquette
\lang english
</labeltag>
\end_layout
\begin_layout LyX-Code
\lang english
<innertag attr=
\begin_inset Quotes erd
\end_inset
value
\begin_inset Quotes erd
\end_inset
>
\lang french
Contenu de l'insert.
\lang english
</innertag>
\end_layout
\begin_layout LyX-Code
\lang english
</tag>
\end_layout
\begin_layout Standard
Si l'insert permet de saisir plusieurs paragraphes --- c'est-à-dire, si
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
MultiPar
\end_layout
\end_inset
est vrai --- alors le contenu de l'insert sera exporté également en paragraphes
formattés en fonction des styles utilisés pour ces paragraphes (standard,
citation et similaire).
La balise d'étiquetage est bien entendu omise si la paragraphe n'a pas
d'étiquette et, pour le moment, est toujours
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
span
\end_layout
\end_inset
.
La balise interne est facultative et, implicitement, n'apparaît pas.
\end_layout
\begin_layout Standard
Les balises et attributs spécifiques émis pour chaque insert peuvent être
contrôlés au moyen des directives de format suivantes:
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLAttr
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chaîne
\end_layout
\end_inset
]
\lang french
précise les informations d'attribut à émettre avec la balise principale.
Par exemple
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\begin_inset Quotes fld
\end_inset
class=`moninsert' onclick=`\SpecialChar \ldots{}
'
\begin_inset Quotes frd
\end_inset
\end_layout
\end_inset
.
Implicitement, LyX exportera
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\begin_inset Quotes fld
\end_inset
class=`nominsert'
\begin_inset Quotes frd
\end_inset
\end_layout
\end_inset
, où
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
nominsert
\end_layout
\end_inset
est le nom LyX de l'insert en bas de casse et avec les caractères non alphanumé
riques remplacés par des caractères
\begin_inset Quotes fld
\end_inset
souligné
\begin_inset Quotes frd
\end_inset
, par exemple: footnote.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLForceCSS
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\emph on
\lang english
0
\emph default
,1
\end_layout
\end_inset
]
\lang french
indique s'il faut émettre l'information CSS implicite engendrée par LyX
pour cet insert, même si une information complémentaire est explicitement
émise par
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
HTMLStyle
\end_layout
\end_inset
.
Positionner cette directive à
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
1
\end_layout
\end_inset
vous permet de modifier ou de compléter la CSS créée, plutôt que de l'écraser
complètement.
Implicitement
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
0
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLInnerAttr
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chaîne
\end_layout
\end_inset
]
\lang french
fixe l'attribut de la balise interne.
Vaut implicitement
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\begin_inset Quotes fld
\end_inset
class=`nominsert_inner'
\begin_inset Quotes frd
\end_inset
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLInnerTag
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chaîne
\end_layout
\end_inset
]
\lang french
détermine la balise interne, et remplace
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
innertag
\end_layout
\end_inset
dans les exemples ci-dessus.
Implicitement absente.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLIsBlock
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
0,
\emph on
1
\end_layout
\end_inset
]
\lang french
indique si cet insert représente un bloc autonome de texte (comme une note
de bas de page) ou bien représente du contenu inclus dans le texte environnant
(comme une branche).
Vaut implicitement
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
1
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLLabel
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chaîne
\end_layout
\end_inset
]
\lang french
définit une étiquette pour cet insert, pouvant inclure une référence à
un compteur.
Par exemple, pour une note de bas de page, ce peut être
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\backslash
arabic{footnote}
\end_layout
\end_inset
.
Cette directive est facultative, et n'a pas de valeur implicite.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLPreamble
\end_layout
\end_inset
\lang french
définit l'information à émettre dans la section
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
<head>
\end_layout
\end_inset
quand ce style est utilisé.
Ceci pourrait être utilisé par exemple pour inclure un bloc
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
<script>
\end_layout
\end_inset
définissant un gestionnaire
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
onclick
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLStyle
\end_layout
\end_inset
\lang french
définit l'information CSS à inclure quand ce style est utilisé.
Noter que le contenu sera automatiquement enclos dans un bloc
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
<style>
\end_layout
\end_inset
créé par la directive, il n'est donc besoin d'inclure que la CSS elle-même.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLTag
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chaîne
\end_layout
\end_inset
]
\lang french
définit la balise utilisé pour l'étiquette principale, qui remplace
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
tag
\end_layout
\end_inset
dans les exemples ci-dessus.
La valeur implicite dépend dépend du réglage de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
MultiPar
\end_layout
\end_inset
: si
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
MultiPar
\end_layout
\end_inset
est vrai, la valeur implicite est
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
div
\end_layout
\end_inset
; s'il est faux, la valeur implicite est
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
span
\end_layout
\end_inset
.
\end_layout
\begin_layout Subsection
Flottants XHTML
\end_layout
\begin_layout Standard
Le résultat XHTML pour les flottants peut être contrôlé par les informations
de format.
Le résultat a la forme suivante:
\end_layout
\begin_layout LyX-Code
\lang english
<tag attr=
\begin_inset Quotes erd
\end_inset
value
\begin_inset Quotes erd
\end_inset
>
\end_layout
\begin_layout LyX-Code
\lang english
Contenu du flottant.
\end_layout
\begin_layout LyX-Code
\lang english
</tag>
\end_layout
\begin_layout Standard
La légende, si elle est présente, est un insert séparé et sera émis en tant
que tel.
Son apparence pourra être contrôlée par la directive InsetLayout pour les
inserts de légende.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLAttr
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chaîne
\end_layout
\end_inset
]
\lang french
précise les informations d'attribut à émettre avec la balise principale.
Par exemple
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\begin_inset Quotes fld
\end_inset
class=`monflottant' onclick=`\SpecialChar \ldots{}
'
\begin_inset Quotes frd
\end_inset
\end_layout
\end_inset
.
Implicitement, LyX exportera
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\begin_inset Quotes fld
\end_inset
\lang english
class=`float float-typefloat'
\lang french
\begin_inset Quotes frd
\end_inset
\end_layout
\end_inset
, où
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
typefloat
\end_layout
\end_inset
est le nom LyX de l'insert (tel qu'il est déterminé par la déclaration
de flottant, voir
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Flottants"
\end_inset
) en bas de casse et avec les caractères non alphanumériques remplacés par
des caractères
\begin_inset Quotes fld
\end_inset
souligné
\begin_inset Quotes frd
\end_inset
, par exemple:
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
float-table
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLStyle
\end_layout
\end_inset
\lang french
définit l'information CSS à inclure quand ce flottant est utilisé.
\lang english
\lang french
Noter que le contenu sera automatiquement enclos dans un bloc
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
<style>
\end_layout
\end_inset
créé par la directive, il n'est donc besoin d'inclure que la CSS elle-même.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HTMLTag
\end_layout
\end_inset
[
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
chaîne
\end_layout
\end_inset
]
\lang french
définit la balise utilisé pour l'étiquette principale, qui remplace
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
tag
\end_layout
\end_inset
dans les exemples ci-dessus.
Vaut implicitement
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
div
\end_layout
\end_inset
, cette valeur devra rarement être modifiée.
\end_layout
\begin_layout Subsection
Mise en page de la bibliographie
\end_layout
\begin_layout Standard
La bibliographie peut être mise en forme via les blocs
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
CiteFormat
\end_layout
\end_inset
.
Voir la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Description citation"
\end_inset
pour les détails.
\end_layout
\begin_layout Subsection
CSS créés par LyX
\end_layout
\begin_layout Standard
Nous avons mentionné plusieurs fois que LyX créera des règles CSS implicites
pour les paragraphes et les inserts, fondées sur les autres informations
de format fournies.
Ici, nous préciserons quelle information est utilisée par LyX et comment.
\end_layout
\begin_layout Standard
Pour le moment, LyX engendre tout seul des CSS seulement pour les informations
de police, en utilisant les directives
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Family
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Series
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Shape
\end_layout
\end_inset
, et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Size
\end_layout
\end_inset
spécifiées dans la déclaration
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
Font
\end_layout
\end_inset
(voir
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:polices"
\end_inset
.) La traduction est essentiellement directe et évidente, par exemple
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\begin_inset Quotes fld
\end_inset
Family Sans
\begin_inset Quotes frd
\end_inset
\end_layout
\end_inset
devient
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\begin_inset Quotes fld
\end_inset
font-family: sans-serif;
\begin_inset Quotes frd
\end_inset
\end_layout
\end_inset
.
La correspondance entre les tailles en LyX et les tailles en CSS est un
peu moins évidente main néanmoins intuitive.
Voir la fonction
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
getSizeCSS()
\end_layout
\end_inset
dans
\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
src/FontInfo.cpp
\end_layout
\end_inset
pour les détails.
\end_layout
\begin_layout Chapter
Insérer un Objet externe
\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
Avertissement: cette partie des la documentation n'a pas été mise à jour
depuis un certain temps.
Nous espérons qu'elle est toujours correcte, mais ce n'est pas garanti.
\end_layout
\end_inset
\end_layout
\begin_layout Standard
L'utilisation d'éléments créés par des logiciels extérieurs à LyX est couverte
en détail dans le manuel
\emph on
Objets insérés
\emph default
.
Cette partie du manuel couvre ce qui se passe derrière la scène pour permettre
d'écrire un mécanisme d'inclusion pour un nouvel élément.
\end_layout
\begin_layout Section
Comment fonctionne-t-il ?
\end_layout
\begin_layout Standard
L'insertion d'objet externe repose sur le concept de
\emph on
cadre
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT : Traduction de
\begin_inset Quotes fld
\end_inset
template
\begin_inset Quotes frd
\end_inset
dans ce contexte.
\end_layout
\end_inset
\emph default
.
Un cadre définit comment LyX doit s'interfacer avec un type d'objet donné.
Tel qu'il est distribué, LyX possède des cadres prédéfinis pour les figures
XFig, pour les diagrammes Dia, pour différents formats d'images rastérisées,
pour gnuplot, et d'autres.
Vous pouvez en consulter la liste avec
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
Insérer\SpecialChar \menuseparator
Objet
\begin_inset space ~
\end_inset
Externe
\end_layout
\end_inset
.
En outre, il est possible de créer votre propre cadre pour supporter un
type donné d'objet.
Nous décrirons plus loin en détail ce qu'il faut faire, et nous espérons
que vous nous enverrez tous les cadres que vous créerez pour que nous puissions
les inclure dans de futures versions de LyX.
\end_layout
\begin_layout Standard
Un autre concept de base est qu'il faut faire la distinction entre le fichier
d'origine qui sert de point de départ et le fichier transformé qui est
inclus avec votre document exporté ou imprimé.
Voyons par exemple une figure produite avec
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
XFig
\end_layout
\end_inset
.
L'application XFig elle-même travaille sur un fichier avec l'extension
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
.fig
\end_layout
\end_inset
.
Dans XFig, vous créez et modifiez votre figure.
Quand c'est fini, vous enregistrez le fichier
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
fig
\end_layout
\end_inset
.
Quand vous voulez inclure la figure dans votre document, vous invoquez
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
transfig
\end_layout
\end_inset
pour créer un fichier PostScript qui sera aisément inclus dans votre fichier
LaTeX.
Dans ce cas, le fichier
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
.fig
\end_layout
\end_inset
est le fichier d'origine, et le fichier PostScript est le fichier transformé.
\end_layout
\begin_layout Standard
Cette distinction est importante pour pouvoir mettre à jour l'objet pendant
l'écriture de votre document.
En outre, elle vous donne la flexibilité requise pour supporter des formats
d'exportation différents.
Par exemple, dans le cas de l'exportation en Ascii, ce n'est pas vraiment
une super idée d'inclure la figure en PostScript brut.
À la place, vous préférerez soit inclure une référence à la figure, soit
essayer un convertisseur graphique vers Ascii pour rendre un résultat final
approchant du graphique d'origine.
L'insertion d'objet externe vous permet de le faire, car il est paramétré
avec les différents formats d'exportation supportés par LyX.
\end_layout
\begin_layout Standard
En plus de supporter la génération de fichiers transformés différents selon
le format d'exportation, l'insertion d'objet externe travaille en étroite
collaboration avec les applications d'édition et de visualisation.
Dans le cas d'une figure XFig, vous pouvez invoquer Xfig sur le fichier
d'origine d'un simple clic depuis la fenêtre d'objet externe de LyX, et
aussi visualiser le fichier transformé PostScript avec Ghostview d'un autre
clic.
Il n'y a plus à se bagarrer avec la ligne de commande ou avec des explorateurs
de fichier pour localiser et manipuler le fichier d'origine et le fichier
transformé.
De cette façon, vous pouvez enfin profiter à plein des nombreuses applications
différentes qui servent à la production de documents, et serez finalement
plus efficaces.
\end_layout
\begin_layout Section
\lang english
The external template configuration file
\end_layout
\begin_layout Standard
Il est assez facile de définir de nouveaux cadres externes dans LyX.
Cependant, sachez que si vous le faites de façon négligente, vous introduirez
\emph on
sûrement
\emph default
une faille de sécurité facilement exploitable.
Avant de commencer, lisez donc plus bas ce qui concerne la sécurité (section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand pageref
reference "sec:La-question-de"
\end_inset
).
\end_layout
\begin_layout Standard
Ceci dit, nous vous encourageons à créer des cadres intéressants et à nous
les proposer.
\end_layout
\begin_layout Standard
Les cadres externes sont définis dans le fichier
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
RépLyX/external_templates
\end_layout
\end_inset
\family typewriter
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
NdT : Nous rappelons que
\begin_inset Quotes fld
\end_inset
cadre
\begin_inset Quotes frd
\end_inset
est la traduction de
\begin_inset Quotes fld
\end_inset
template
\begin_inset Quotes frd
\end_inset
dans ce contexte de l'objet externe.
\end_layout
\end_inset
\family default
.
Vous pouvez mettre votre propre version dans
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
MonRép/external_templates
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
Un fichier de configuration de cadre typique se présente comme ceci:
\end_layout
\begin_layout LyX-Code
\lang english
Template XFig
\end_layout
\begin_layout LyX-Code
\lang english
GuiName "XFig: $$AbsOrRelPathParent$$Basename"
\end_layout
\begin_layout LyX-Code
\lang english
HelpText
\end_layout
\begin_layout LyX-Code
\lang english
An XFig figure.
\end_layout
\begin_layout LyX-Code
\lang english
HelpTextEnd
\end_layout
\begin_layout LyX-Code
\lang english
InputFormat fig
\end_layout
\begin_layout LyX-Code
\lang english
FileFilter "*.fig"
\end_layout
\begin_layout LyX-Code
\lang english
AutomaticProduction true
\end_layout
\begin_layout LyX-Code
\lang english
Transform Rotate
\end_layout
\begin_layout LyX-Code
\lang english
Transform Resize
\end_layout
\begin_layout LyX-Code
\lang english
Format LaTeX
\end_layout
\begin_layout LyX-Code
\lang english
TransformCommand Rotate RotationLatexCommand
\end_layout
\begin_layout LyX-Code
\lang english
TransformCommand Resize ResizeLatexCommand
\end_layout
\begin_layout LyX-Code
\lang english
Product "$$RotateFront$$ResizeFront
\end_layout
\begin_layout LyX-Code
\lang english
\backslash
\backslash
input{$$AbsOrRelPathMaster$$Basename.pstex_t}
\end_layout
\begin_layout LyX-Code
\lang english
$$ResizeBack$$RotateBack"
\end_layout
\begin_layout LyX-Code
\lang english
UpdateFormat pstex
\end_layout
\begin_layout LyX-Code
\lang english
UpdateResult "$$AbsPath$$Basename.pstex_t"
\end_layout
\begin_layout LyX-Code
\lang english
Requirement "graphicx"
\end_layout
\begin_layout LyX-Code
\lang english
ReferencedFile latex "$$AbsOrRelPathMaster$$Basename.pstex_t"
\end_layout
\begin_layout LyX-Code
\lang english
ReferencedFile latex "$$AbsPath$$Basename.eps"
\end_layout
\begin_layout LyX-Code
\lang english
ReferencedFile dvi "$$AbsPath$$Basename.eps"
\end_layout
\begin_layout LyX-Code
\lang english
FormatEnd
\end_layout
\begin_layout LyX-Code
\lang english
Format PDFLaTeX
\end_layout
\begin_layout LyX-Code
\lang english
TransformCommand Rotate RotationLatexCommand
\end_layout
\begin_layout LyX-Code
\lang english
TransformCommand Resize ResizeLatexCommand
\end_layout
\begin_layout LyX-Code
\lang english
Product "$$RotateFront$$ResizeFront
\end_layout
\begin_layout LyX-Code
\lang english
\backslash
\backslash
input{$$AbsOrRelPathMaster$$Basename.pdftex_t}
\end_layout
\begin_layout LyX-Code
\lang english
$$ResizeBack$$RotateBack"
\end_layout
\begin_layout LyX-Code
\lang english
UpdateFormat pdftex
\end_layout
\begin_layout LyX-Code
\lang english
UpdateResult "$$AbsPath$$Basename.pdftex_t"
\end_layout
\begin_layout LyX-Code
\lang english
Requirement "graphicx"
\end_layout
\begin_layout LyX-Code
\lang english
ReferencedFile latex "$$AbsOrRelPathMaster$$Basename.pdftex_t"
\end_layout
\begin_layout LyX-Code
\lang english
ReferencedFile latex "$$AbsPath$$Basename.pdf"
\end_layout
\begin_layout LyX-Code
\lang english
FormatEnd
\end_layout
\begin_layout LyX-Code
\lang english
Format Ascii
\end_layout
\begin_layout LyX-Code
\lang english
Product "$$Contents(
\backslash
"$$AbsPath$$Basename.asc
\backslash
")"
\end_layout
\begin_layout LyX-Code
\lang english
UpdateFormat asciixfig
\end_layout
\begin_layout LyX-Code
\lang english
UpdateResult "$$AbsPath$$Basename.asc"
\end_layout
\begin_layout LyX-Code
\lang english
FormatEnd
\end_layout
\begin_layout LyX-Code
\lang english
Format DocBook
\end_layout
\begin_layout LyX-Code
\lang english
Product "<graphic fileref=
\backslash
"$$AbsOrRelPathMaster$$Basename.eps
\backslash
">
\end_layout
\begin_layout LyX-Code
\lang english
</graphic>"
\end_layout
\begin_layout LyX-Code
\lang english
UpdateFormat eps
\end_layout
\begin_layout LyX-Code
\lang english
UpdateResult "$$AbsPath$$Basename.eps"
\end_layout
\begin_layout LyX-Code
\lang english
ReferencedFile docbook "$$AbsPath$$Basename.eps"
\end_layout
\begin_layout LyX-Code
\lang english
ReferencedFile docbook-xml "$$AbsPath$$Basename.eps"
\end_layout
\begin_layout LyX-Code
\lang english
FormatEnd
\end_layout
\begin_layout LyX-Code
\lang english
Product "[XFig: $$FName]"
\end_layout
\begin_layout LyX-Code
\lang english
FormatEnd
\end_layout
\begin_layout LyX-Code
\lang english
TemplateEnd
\end_layout
\begin_layout Standard
Comme vous pouvez le constater, le cadre est inséré entre
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Template
\end_layout
\end_inset
\SpecialChar \ldots{}
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
TemplateEnd
\end_layout
\end_inset
.
Il contient un en-tête spécifiant quelques réglages généraux et, pour chaque
format primaire de document reconnu, une section
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Format
\end_layout
\end_inset
\SpecialChar \ldots{}
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
FormatEnd
\end_layout
\end_inset
.
\end_layout
\begin_layout Subsection
L'en-tête de cadre
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
AutomaticProduction
\begin_inset space ~
\end_inset
true|false
\end_layout
\end_inset
\lang french
indique si le fichier représenté par le cadre doit être créé par LyX.
Cette directive doit apparaître une et une seule fois.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
FileFilter
\begin_inset space ~
\end_inset
<pattern>
\end_layout
\end_inset
\lang french
précise un patron gloal utilisé dans l'échange dans la spécification des
fichiers pour filtrer les fichiers désignés.
\lang english
\lang french
S'il y a plus d'un suffixe possible (e.g.
pour tgif,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
.obj
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
.tgo
\end_layout
\end_inset
), utiliser une syntaxe comme
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
"*.{obj,tgo}"
\end_layout
\end_inset
.
Cette directive doit apparaître une et une seule fois.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
GuiName
\begin_inset space ~
\end_inset
<guiname>
\end_layout
\end_inset
\lang french
fixe le texte apparaissant dans le bouton.
Cette directive doit apparaître une et une seule fois.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
HelpText
\begin_inset space ~
\end_inset
<text>
\begin_inset space ~
\end_inset
HelpTextEnd
\end_layout
\end_inset
\lang french
décrit le texte d'aide utilisé dans la fenêtre de dialogue
\begin_inset Quotes fld
\end_inset
Objet externe
\begin_inset Quotes frd
\end_inset
.
Fournir suffisamment d'informations pour que l'utilisateur comprenne ce
que le cadre peut faire pour lui.
Cette directive doit apparaître une et une seule fois.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
InputFormat
\begin_inset space ~
\end_inset
<format>
\end_layout
\end_inset
\lang french
indique le format du fichier original.
Ce doit être le nom d'un format reconnu par LyX (voir la section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:Formats"
\end_inset
).
Utiliser
\begin_inset Quotes eld
\end_inset
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
*
\end_layout
\end_inset
\begin_inset Quotes erd
\end_inset
si le cadre peut gérer des fichiers originaux dans plus d'un format.
LyX tentera d'analyser le fichier pour ne déduire le format dans ce cas.
Cette directive doit apparaître une et une seule fois.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Template
\begin_inset space ~
\end_inset
<id>
\end_layout
\end_inset
\lang french
est un nom original pour le cadre.
Il ne soit pas contenir de macros de substitution (voir ci-après).
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Transform
\begin_inset space ~
\end_inset
Rotate|Resize|Clip|Extra
\end_layout
\end_inset
\lang french
spécifie quelles transformations sont reconnues par ce cadre.
Elle peut apparaître zéro ou plusieurs fois.
Elle active les options correspondantes dans la fenêtre de dialogue.
Chaque directive
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Transform
\end_layout
\end_inset
doit avoir soit une directive
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
TransformCommand
\end_layout
\end_inset
correspondante, soit une directive
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
TransformOption
\end_layout
\end_inset
dans la section
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Format
\end_layout
\end_inset
.
Sinon, la transformation ne sera pas reconnue par ce cadre.
\end_layout
\begin_layout Subsection
La section Format
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Format
\begin_inset space ~
\end_inset
LaTeX|PDFLaTeX|PlainText|DocBook
\end_layout
\end_inset
\lang french
décrit le format de document primaire relevant de cette définition de format.
Tous les cadres n'ont pas de représentation raisonnable dans tous les formats
de fichier documentaire.
Définissez cependant une section
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Format
\end_layout
\end_inset
pour tous les formats, et utilisez un texte bidon lorsqu'il n'existe pas
de représentation.
Ainsi vous verrez au minimum une référence à l'objet externe dans le document
exporté.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Option
\begin_inset space ~
\end_inset
<
\lang french
nom
\lang english
>
\begin_inset space ~
\end_inset
<
\lang french
valeur
\lang english
>
\end_layout
\end_inset
\lang french
définit une macro additionnelle
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$<
\lang french
nom
\lang english
>
\end_layout
\end_inset
pour la substitution par
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Product
\end_layout
\end_inset
.
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
<
\lang french
valeur
\lang english
>
\end_layout
\end_inset
peut elle-même contenir des macros de substitution.
L'avantage par rapport à l'usage direct de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
<
\lang french
valeur
\lang english
>
\end_layout
\end_inset
dans
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Product
\end_layout
\end_inset
est que la valeur substituée par
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$<
\lang french
nom
\lang english
>
\end_layout
\end_inset
est nettoyée de sorte qu'elle est un argument facultatif valide dans le
format documentaire.
Cette directive doit apparaître une et une seule fois.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Product
\begin_inset space ~
\end_inset
<text>
\end_layout
\end_inset
\lang french
spécifie les texte inséré dans le document exporté.
C'est en fait la directive la plus importante et elle peut être assez compliqué
e.
Cette directive doit apparaître une et une seule fois.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Preamble
\begin_inset space ~
\end_inset
<
\lang french
nom
\lang english
>
\end_layout
\end_inset
\lang french
spécifie un élément de préambule qui sera inclus dans le préambule LaTeX.
Il doit être défini par
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
PreambleDef
\end_layout
\end_inset
\SpecialChar \ldots{}
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
PreambleDefEnd
\end_layout
\end_inset
.
Cette directive doit apparaître une et une seule fois.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
ReferencedFile
\begin_inset space ~
\end_inset
<format>
\begin_inset space ~
\end_inset
<filename>
\end_layout
\end_inset
\lang french
désigne les fichiers créés par la procédure de conversion et requis par
un format d'exportation particulier.
Si le nom d'un fichier est relatif, il est interprété relativement au document
maître.
Cette directive peut apparaître zéro ou plusieurs fois.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Requirement
\begin_inset space ~
\end_inset
<package>
\end_layout
\end_inset
\lang french
désigne le nom d'un paquetage LaTeX requis.
Le paquetage est inclus via
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
\backslash
usepackage{}
\end_layout
\end_inset
dans le préambule LaTeX.
Cette directive peut apparaître zéro ou plusieurs fois.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
TransformCommand
\begin_inset space ~
\end_inset
Rotate
\begin_inset space ~
\end_inset
RotationLatexCommand
\end_layout
\end_inset
\lang french
spécifie que la commande LaTeX native doit être utilisée pour effectuer
les rotations.
Cette directive peut apparaître une fois ou pas du tout.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
TransformCommand
\begin_inset space ~
\end_inset
Resize
\begin_inset space ~
\end_inset
ResizeLatexCommand
\end_layout
\end_inset
\lang french
spécifie que la commande LaTeX native doit être utilisée pour effectuer
les changements de taille.
Cette directive peut apparaître une fois ou pas du tout.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
TransformOption
\begin_inset space ~
\end_inset
Rotate
\begin_inset space ~
\end_inset
RotationLatexOption
\end_layout
\end_inset
\lang french
spécifie que les rotations sont effectuées via un paramètre facultatif.
Cette directive peut apparaître une fois ou pas du tout.
\lang english
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
TransformOption
\begin_inset space ~
\end_inset
Resize
\begin_inset space ~
\end_inset
ResizeLatexOption
\end_layout
\end_inset
\lang french
spécifie que les changements de taille sont effectuées via un paramètre
facultatif.
Cette directive peut apparaître une fois ou pas du tout
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
TransformOption
\begin_inset space ~
\end_inset
Clip
\begin_inset space ~
\end_inset
ClipLatexOption
\end_layout
\end_inset
\lang french
spécifie que les recadrages sont effectuées via un paramètre facultatif.
Cette directive peut apparaître une fois ou pas du tout
\lang english
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
TransformOption
\begin_inset space ~
\end_inset
Extra
\begin_inset space ~
\end_inset
ExtraLatexOption
\end_layout
\end_inset
\lang french
spécifie qu'un paramètre supplémentaire facultatif est utilisé.
Cette directive peut apparaître une fois ou pas du tout
\lang english
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
UpdateFormat
\begin_inset space ~
\end_inset
<format>
\end_layout
\end_inset
\lang french
spécifie le format de fichier du fichier converti.
Ce doit être le nom d'un format reconnu par LyX (voir la fenêtre de dialogue
\begin_inset Flex MenuItem
status collapsed
\begin_layout Plain Layout
\lang english
Outils\SpecialChar \menuseparator
\bar under
P
\bar default
références\SpecialChar \menuseparator
Gestion
\begin_inset space ~
\end_inset
des
\begin_inset space ~
\end_inset
fichiers\SpecialChar \menuseparator
Format
\begin_inset space ~
\end_inset
de
\begin_inset space ~
\end_inset
fichier
\end_layout
\end_inset
).
Cette directive doit apparaître une et une seule fois.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
UpdateResult
\begin_inset space ~
\end_inset
<filename>
\end_layout
\end_inset
\lang french
spécifie le nom du fichier converti.
Le nom de fichier doit être absolu.
Cette directive doit apparaître une et une seule fois.
\end_layout
\begin_layout Subsection
Définitions du préambule
\end_layout
\begin_layout Standard
La configuration du cadre externe peut contenir des définitions additionnelles
de préambule incluses dans
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
PreambleDef
\end_layout
\end_inset
\SpecialChar \ldots{}
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
PreambleDefEnd
\end_layout
\end_inset
.
Elle peuvent être utilisées par les cadres dans la section
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Format
\end_layout
\end_inset
.
\end_layout
\begin_layout Section
Le mécanisme de substitution
\end_layout
\begin_layout Standard
Quand la fenêtre d'objet externe invoque un programme externe, il le fait
selon la commande définie dans le fichier de configuration des cadres.
Ces commandes peuvent contenir diverses macros qui sont interprétées avant
l'exécution.
Les commandes sont toujours exécutées dans le répertoire du document.
\end_layout
\begin_layout Standard
Ainsi, quand un objet externe est affiché, un mécanisme de substitution
génère son nom, et la plupart des autres directives reconnaissent la substituti
on de manière similaire.
\end_layout
\begin_layout Standard
Les macros disponibles sont les suivantes :
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$AbsOrRelPathMaster
\end_layout
\end_inset
\lang french
est le est le chemin d'accès, absolu ou relatif au document maître LyX.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$AbsOrRelPathParent
\end_layout
\end_inset
\lang french
est le est le chemin d'accès, absolu ou relatif au document LyX.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$AbsPath
\end_layout
\end_inset
\lang french
est le chemin d'accès absolu.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$Basename
\end_layout
\end_inset
\lang french
est le nom du fichier sans chemin d'accès et sans suffixe.
\end_layout
\begin_layout Description
$$Contents(
\begin_inset Quotes fld
\end_inset
nom_fichier.ext
\begin_inset Quotes frd
\end_inset
) la macro dépliera le contenu du fichier de nom
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
nom_fichier.ext
\end_layout
\end_inset
.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$Extension
\end_layout
\end_inset
\lang french
est le suffixe (point inclus).
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$FName
\end_layout
\end_inset
\lang french
est le nom du fichier spécifié dans la fenêtre d'objet externe.
\lang english
\lang french
Il est soit absolu, soit relatif au document LyX.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$FPath
\end_layout
\end_inset
\lang french
la partie
\begin_inset Quotes fld
\end_inset
chemin d'accès
\begin_inset Quotes frd
\end_inset
de
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$FName
\end_layout
\end_inset
(absolu ou relatif au document LyX).
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$RelPathMaster
\end_layout
\end_inset
\lang french
est le chemin d'accès relatif au document maître LyX.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$RelPathParent
\end_layout
\end_inset
\lang french
est le chemin d'accès relatif au document LyX.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$Sysdir
\end_layout
\end_inset
\lang french
désigne le chemin absolu du répertoire système.
Typiquement utilisé pour pouvoir trouver les différents scripts auxiliaires
fournis avec LyX.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$Tempname
\end_layout
\end_inset
\lang french
Le nom et le chemin absolu d'un fichier temporaire qui sera automatiquement
effacé quand le document sera fermé, ou l'objet externe effacé.
\end_layout
\begin_layout Standard
Toutes la macros de chemin contiennent un séparateur de répertoire final,
vous pouvez donc construire par exemple le nom de fichier absolu avec
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$AbsPath$$Basename$$Extension
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
Les macros ci-dessus sont substituées dans toutes les directives sauf indiqué.
La directive
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Product
\end_layout
\end_inset
reconnaît également les substitutions suivantes si elles sont autorisées
par les directives
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Transform
\end_layout
\end_inset
et
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
TransformCommand
\end_layout
\end_inset
:
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$ResizeFront
\end_layout
\end_inset
\lang french
partie initiale de la commande de changement de taille.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$ResizeBack
\end_layout
\end_inset
\lang french
partie finale de la commande de changement de taille.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$RotateFront
\end_layout
\end_inset
\lang french
partie initiale de la commande de rotation.
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$RotateBack
\end_layout
\end_inset
\lang french
partie finale de la commande de rotation.
\end_layout
\begin_layout Standard
La valeur de la chaîne de la directive
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Option
\end_layout
\end_inset
reconnaît également les substitutions suivantes si elles sont autorisées
par les directives
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
Transform
\end_layout
\end_inset
and
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
TransformOption
\end_layout
\end_inset
:
\end_layout
\begin_layout Description
\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$Clip
\end_layout
\end_inset
\lang french
option de recadrage.
\end_layout
\begin_layout Description
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$Extra
\end_layout
\end_inset
option supplémentaire.
\end_layout
\begin_layout Description
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$Resize
\end_layout
\end_inset
option de changement de taille.
\end_layout
\begin_layout Description
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$Rotate
\end_layout
\end_inset
option de rotation.
\end_layout
\begin_layout Standard
Vous pouvez vous demander pourquoi les macros de chemin d'accès sont aussi
nombreuses.
Il y a deux raisons principales:
\end_layout
\begin_layout Enumerate
les chemins d'accès relatifs et absolus doivent rester relatifs et absolus,
respectivement.
Les utilisateurs peuvent avoir des raisons de préférer l'un ou l'autre.
Les chemins relatifs sont utiles pour des documents portables sur différentes
machines, par exemple.
Les chemins absolus peuvent être requis par certains logiciels.
\end_layout
\begin_layout Enumerate
LaTeX traite les chemins d'accès relatifs différemment de LyX et d'autres
logiciels dans des fichiers inclus encapsulés.
Pour LyX, par exemple, un chemin relatif est toujours relatif au document
qui contient le nom de fichier.
Pour LaTeX, il est toujours relatif au document maître.
Ces deux définitions sont identiques si vous n'avez qu'un seul document.,
mais diffèrent si vous avez un document maître qui inclut des sous-documents.
Ceci signifie que les chemins relatifs doivent être transformés pour être
transmis à LaTeX.
Heureusement LyX fait ceci automatiquement si vous choisissez les macros
de substitution correctes.
\end_layout
\begin_layout Standard
Donc, quelle macro faut-il choisir dans une nouvelle définition de cadre?
La règle n'est pas difficile:
\end_layout
\begin_layout Itemize
utiliser
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$AbsPath
\end_layout
\end_inset
si un chemin absolu est requis;
\end_layout
\begin_layout Itemize
utiliser
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$AbsOrRelPathMaster
\end_layout
\end_inset
si la chaîne substituée est du type entrée pour LaTeX;
\end_layout
\begin_layout Itemize
sinon utiliser
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
$$AbsOrRelPathParent
\end_layout
\end_inset
pour préserver le choix de l'utilisateur.
\end_layout
\begin_layout Standard
Des cas spéciaux existent pour lesquels cette règle n'est pas valable, et
par exemple lorsque des chemins relatifs sont requis, mais elle fonctionne
correctement d'habitude.
Un exemple de cas tordu est la directive
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
ReferencedFile latex "$$AbsOrRelPathMaster$$Basename.pstex_t"
\end_layout
\end_inset
dans le cadre Xfig indiqué ci-dessus: il n'est pas possible d'utiliser
le nom absolu parce que la copieur pour les fichiers
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
.pstex_t
\end_layout
\end_inset
nécessite le nom relatif pour réécrire le contenu du fichier.
\end_layout
\begin_layout Section
La question de la sécurité
\begin_inset CommandInset label
LatexCommand label
name "sec:La-question-de"
\end_inset
\end_layout
\begin_layout Standard
L'insertion d'objet externe crée une interface avec un paquet de programmes
externes et le fait de manière automatique, nous devons donc en examiner
les conséquences en matière de sécurité.
En particulier, comme vous avez la possibilité d'inclure vos propres noms
de fichier et/ou paramètres et qu'ils sont interprétés pour former une
commande, il semble possible de créer un document malveillant qui exécute
des commandes indésirables quand un utilisateur le visualise ou l'imprime.
C'est quelque chose que nous voulons absolument éviter.
\end_layout
\begin_layout Standard
Cependant, comme les commandes du programme externe sont définies seulement
dans le fichier de configuration des cadres, il n'y a pas de problème de
sécurité si LyX est configuré correctement avec seulement des cadres sûrs.
Ceci parce que les programmes externes sont invoqués via l'appel système
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
execvp
\end_layout
\end_inset
et non via l'appel système
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
system
\end_layout
\end_inset
.
Il n'est donc pas possible d'exécuter des commandes arbitraires via le
shell à partir du nom de fichier ou des paramètres.
\end_layout
\begin_layout Standard
Ça implique aussi qu'il y a des restrictions dans les commandes définissables
dans un cadre d'objet externe.
En particulier, les pipes et les redirections ne sont pas disponibles.
C'était obligatoire pour que LyX reste sûr.
Si vous voulez utiliser quelques-unes des fonctions du shell, vous devez
écrire un script sûr pour le faire de manière contrôlée, puis définir ce
script comme commande.
\end_layout
\begin_layout Standard
Il est possible de créer un cadre qui interagit directement avec le shell,
mais comme cela permettrait à un utilisateur malveillant d'exécuter des
commandes arbitraires en écrivant des noms de fichier et/ou des paramètres
bien choisis, nous vous recommandons d'utiliser en général des scripts
sûrs qui marchent avec l'appel système
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
execvp
\end_layout
\end_inset
d'une manière contrôlée.
Bien sûr, si vous êtes dans un environnement dans lequel vous avez confiance,
il est tentant de ne pas se fouler et d'utiliser des scripts shell ordinaires.
Si vous faites ça, sachez que vous allez
\emph on
vraiment
\emph default
créer dans votre système une faille de sécurité facile à exploiter.
Il est évident que de tels cadres non sécurisés ne seront jamais inclus
dans la distribution standard de LyX, même si nous encourageons les gens
à nous proposer de nouveaux cadres dans la tradition du logiciel libre.
Mais LyX tel que vous vous le procurez par les voies officielles de distributio
n ne contiendra jamais de cadres non sécurisés.
\end_layout
\begin_layout Standard
L'insertion d'objet externe est un outil très puissant, et vous devez faire
attention à ne pas mettre en péril la sécurité avec cette puissance.
Une légère erreur dans une seule ligne d'un script apparemment inoffensif
peut ouvrir la voie à d'énormes problèmes.
Si vous n'avez pas une compréhension claire de ce qui est en jeu, nous
vous recommandons de consulter un professionnel de la sécurité, ou de contacter
l'équipe de développement de LyX si vous vous demandez si votre cadre est
sûr ou non.
Faites le avant de l'utiliser dans un environnement que vous ne contrôlez
pas.
\end_layout
\end_body
\end_document
Reference in New Issue View Git Blame Copy Permalink