* fr/Customization.lyx

* fr/Extended.lyx:
	- updates by Jean-Pierre

git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/branches/BRANCH_1_6_X@34829 a592a061-630c-0410-9148-cb99ea01b6c8
This commit is contained in:
Jürgen Spitzmüller 2010-07-10 08:09:14 +00:00
parent 572f38cf03
commit 55145779ca
3 changed files with 10902 additions and 9495 deletions

View File

@ -1,4 +1,4 @@
#LyX 1.6.4svn created this file. For more info see http://www.lyx.org/
#LyX 1.6.7svn created this file. For more info see http://www.lyx.org/
\lyxformat 345
\begin_document
\begin_header
@ -855,7 +855,7 @@ RépUtilisateur
Ces répertoires sont complètement indépendants (mais lisez la suite).
Notez que la variable d'environnement
\family typewriter
LYX_USERDIR_VER
LYX_USERDIR_16x
\family default
a exactement le même rôle.
\end_layout
@ -3344,21 +3344,6 @@ default
Gérer de nouvelles classes de document
\end_layout
\begin_layout Standard
\lang english
There are two situations you are likely to encounter when wanting to support
a new LaTeX document class, involving LaTeX2e class (
\family typewriter
.cls
\family default
) and style (
\family typewriter
.sty
\family default
) files.
\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
@ -6975,477 +6960,6 @@ L'insertion d'objet externe est un outil très puissant, et vous devez faire
pas.
\end_layout
\begin_layout Chapter
Le Serveur LyX
\end_layout
\begin_layout Section
Introduction
\end_layout
\begin_layout Standard
Le serveur LyX est une méthode implémentée dans LyX qui permet à d'autres
programmes de dialoguer avec, d'invoquer des commandes LyX et d'obtenir
de l'information à propos de son état interne.
Tout ceci n'est destiné qu'aux utilisateurs avancés, qui devraient le trouver
utile.
\end_layout
\begin_layout Section
Démarrer le Serveur LyX
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
begin{sloppypar}
\end_layout
\end_inset
Le serveur LyX fonctionne par l'intermédiaire d'une paire de tubes.
Ils sont habituellement disposés dans votre répertoire
\family typewriter
$HOME
\family default
et portent les noms
\family typewriter
\begin_inset Quotes fld
\end_inset
.lyxpipe.in
\begin_inset Quotes frd
\end_inset
\family default
et
\family typewriter
\begin_inset Quotes fld
\end_inset
.lyxpipe.out
\begin_inset Quotes frd
\end_inset
\family default
.
Les programmes externes écrivent dans
\family typewriter
.lyxpipe.in
\family default
et lisent les données dans
\family typewriter
.lyxpipe.out
\family default
.
La racine de ces deux noms peut être définie dans la fenêtre
\family sans
Éditer\SpecialChar \menuseparator
Préférences\SpecialChar \menuseparator
Entrées\SpecialChar \menuseparator
Répertoires
\family default
, par exemple
\begin_inset Quotes fld
\end_inset
\family typewriter
/home/mon_home/.lyxpipe
\family default
\begin_inset Quotes frd
\end_inset
.
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
end{sloppypar}
\end_layout
\end_inset
\end_layout
\begin_layout Standard
LyX ajoutera les extensions
\family typewriter
\begin_inset Quotes fld
\end_inset
.in
\begin_inset Quotes frd
\end_inset
\family default
et
\family typewriter
\begin_inset Quotes fld
\end_inset
.out
\begin_inset Quotes frd
\end_inset
\family default
pour créer les tubes.
Le réglage ci-dessus a aussi pour effet d'activer le serveur LyX.
Si l'un des ces tubes existe déjà, LyX supposera qu'un autre processus
LyX est déjà en route et ne démarrera pas le serveur.
Pour faire tourner plusieurs processus LyX avec des serveurs en même temps,
vous devez changer la configuration entre le démarrage des deux programmes.
\end_layout
\begin_layout Standard
Si vous développez un programme client, il vous sera peut-être utile d'activer
les informations de déboguage du serveur LyX.
Pour cela, démarrez LyX avec la commande
\family typewriter
lyx -dbg 8192
\family default
.
\end_layout
\begin_layout Standard
Attention : si LyX se plante, il peut ne pas avoir enlevé les tubes ; dans
ce cas vous devez les enlever à la main.
Si LyX démarre et que les tubes existent déjà, il ne démarrera pas de serveur.
\end_layout
\begin_layout Standard
À part ça, il y a quelques points à savoir :
\end_layout
\begin_layout Itemize
À la fois le client et le serveur doivent tourner sur des machines UNIX
ou OS/2.
Il n'est pour l'instant pas possible de communiquer entre LyX sur UNIX
et des clients sur OS/2 ou vice versa.
\end_layout
\begin_layout Itemize
Sur OS/2, un seul client à la fois peut se connecter sur le serveur LyX.
\end_layout
\begin_layout Itemize
Sur OS/2, les clients doivent ouvrir le tube d'entrée (
\family typewriter
.lyxpipe.in
\family default
) en mode
\family typewriter
O_WRONLY
\family default
.
\end_layout
\begin_layout Standard
Vous pouvez trouver un exemple complet de client écrit en C dans la distribution
source sous le nom
\family typewriter
development/server_monitor.c
\family default
.
\end_layout
\begin_layout Section
Communication normale
\end_layout
\begin_layout Standard
Pour émettre un appel LyX, le client écrit une ligne de texte ASCII dans
le tube d'entrée, selon le format suivant :
\end_layout
\begin_layout LyX-Code
LYXCMD:
\emph on
nom_client
\emph default
:
\emph on
fonction
\emph default
:
\emph on
paramètre
\end_layout
\begin_layout Standard
Ici
\family typewriter
\emph on
nom_client
\family default
\emph default
est un nom que le client peut choisir arbitrairement.
LyX rappelle ce nom s'il envoie une réponse un client peut donc répartir
les réponses aux différentes requêtes.
\end_layout
\begin_layout Standard
\family typewriter
\emph on
fonction
\family default
\emph default
est la fonction que vous voulez faire exécuter à LyX.
C'est la commande que vous auriez entrée dans le minibuffer.
\end_layout
\begin_layout Standard
\family typewriter
\emph on
paramètre
\family default
\emph default
est un paramètre optionnel qui n'est utile que pour certaines fonctions
(par exemple
\begin_inset Quotes fld
\end_inset
self-insert
\begin_inset Quotes frd
\end_inset
qui insère le paramètre comme du texte à la position du curseur).
\end_layout
\begin_layout Standard
La réponse de LyX arrive dans le tube de sortie sous la forme :
\end_layout
\begin_layout LyX-Code
INFO:
\emph on
nom_client
\emph default
:
\emph on
fonction
\emph default
:
\emph on
données
\end_layout
\begin_layout Standard
\family typewriter
\emph on
nom_client
\family default
\emph default
et
\family typewriter
\emph on
fonction
\family default
\emph default
sont les mêmes que dans la requête, tandis que
\family typewriter
\emph on
données
\family default
\emph default
contient des informations plus ou moins utiles selon la façon avec laquelle
la commande s'est exécutée.
Certaines commandes renvoient des informations à propos de l'état interne
de LyX, comme
\begin_inset Quotes fld
\end_inset
font-state
\begin_inset Quotes frd
\end_inset
, tandis que d'autres ne renvoient rien.
Ça signifie alors que l'exécution s'est bien passée.
\end_layout
\begin_layout Standard
En cas d'erreurs, la réponse de LyX aura la forme :
\end_layout
\begin_layout LyX-Code
ERROR:
\emph on
nom_client
\emph default
:
\emph on
fonction
\emph default
:
\emph on
message_d'erreur
\end_layout
\begin_layout Standard
où le
\family typewriter
\emph on
message_d'erreur
\family default
\emph default
doit expliquer pourquoi la commande a échoué.
\end_layout
\begin_layout Standard
Exemples :
\end_layout
\begin_layout LyX-Code
echo "LYXCMD:test:beginning-of-buffer:" >~/.lyxpipe.in
\end_layout
\begin_layout LyX-Code
echo "LYXCMD:test:get-xy:" >~/.lyxpipe.in
\begin_inset Newline newline
\end_inset
read a <~/.lyxpipe.out
\begin_inset Newline newline
\end_inset
echo $a
\end_layout
\begin_layout Section
Notification
\end_layout
\begin_layout Standard
LyX peut notifier aux clients les événements qui se produisent de manière
asynchrone.
Pour l'instant il ne le fait que si l'utilisateur associe une séquence
de touches à la fonction
\begin_inset Quotes fld
\end_inset
notify
\begin_inset Quotes frd
\end_inset
.
Voici le format de ce que LyX envoie :
\end_layout
\begin_layout LyX-Code
NOTIFY:
\emph on
séquence_touches
\end_layout
\begin_layout Standard
\family typewriter
\emph on
séquence_touches
\family default
\emph default
est la représentation imprimée de la séquence de touches réellement tapée
par l'utilisateur.
\end_layout
\begin_layout Standard
Ce mécanisme peut servir pour étendre l'ensemble des commandes LyX et implémente
r des macros : associez certaines séquences de touches à
\begin_inset Quotes fld
\end_inset
notify
\begin_inset Quotes frd
\end_inset
, démarrez un client qui écoute le tube de sortie, traite la commande selon
la séquence et démarre une fonction qui peut utiliser des appels et des
requêtes LyX pour envoyer une commande ou une série de commandes à LyX.
\end_layout
\begin_layout Section
Le Protocole Serveur LyX
\end_layout
\begin_layout Standard
LyX implémente un protocole simple qui peut servir à la gestion de session.
Tous les messages sont de la forme :
\end_layout
\begin_layout LyX-Code
LYXSRV:
\emph on
nom_client
\emph default
:
\emph on
message_protocole
\end_layout
\begin_layout Standard
\family typewriter
\emph on
message_protocole
\family default
\emph default
peut être
\begin_inset Quotes fld
\end_inset
hello
\begin_inset Quotes frd
\end_inset
ou
\begin_inset Quotes fld
\end_inset
bye
\begin_inset Quotes frd
\end_inset
.
Si un client reçoit
\begin_inset Quotes fld
\end_inset
hello
\begin_inset Quotes frd
\end_inset
, c'est que LyX l'informe qu'il écoute ses messages, s'il reçoit
\begin_inset Quotes fld
\end_inset
bye
\begin_inset Quotes frd
\end_inset
, c'est que LyX est en train de s'arrêter.
\end_layout
\begin_layout Chapter
\start_of_appendix
Raccourcis
@ -13992,7 +13506,7 @@ math-matrix 3 3
\begin_inset Formula $\begin{array}{ccc}
\\\\\end{array}$
\end{array}$
\end_inset
.

File diff suppressed because it is too large Load Diff

View File

@ -61,7 +61,8 @@ What's new
- Updated Japanese Additional LyX Features manual.
- Updated French User's Guide, Embedded Objects and Math manual.
- Updated French User's Guide, Additional LyX Features, Embedded Objects
and Math manual as well as the French LaTeX Configuration overview.
- Updated LaTeX Configuration overview.