summaryrefslogtreecommitdiff
path: root/Master/tlpkg/texworks/texworks-help/TeXworks-manual/fr/UsageavancelesScripts.html
blob: e89543530bebfb8fc2fa1c24b6fd82e413b27a1e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"  
  "http://www.w3.org/TR/html4/loose.dtd">  
<html xml:lang="fr" > 
<head><title>6 Usage avance : les Scripts</title> 
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> 
<meta name="generator" content="TeX4ht (http://www.tug.org/tex4ht/)"> 
<meta name="originator" content="TeX4ht (http://www.tug.org/tex4ht/)"> 
<!-- info,2,imgdir:images/,sec-filename,next,index=2,url-enc,html --> 
<meta name="src" content="index.tex"> 
<link rel="stylesheet" type="text/css" href="index.css"> 
</head><body 
>
<!--l. 5--><p class="noindent" ><div id="container"> <!--l. 5--><div class="crosslinks"><p class="noindent">[<a 
href="Audeladecemanuel.html" >next</a>] [<a 
href="Allerplusloinautresoutils.html" >prev</a>] [<a 
href="Allerplusloinautresoutils.html#tailAllerplusloinautresoutils.html" >prev-tail</a>] [<a 
href="#tailUsageavancelesScripts.html">tail</a>] [<a 
href="index.html#UsageavancelesScripts.html" >up</a>] </p></div>
<!--l. 5--><p class="indent" >   <div class="chapternumber">6</div><h1><a 
 id="x37-380006"></a>Usage avancé<span class="frenchb-nbsp">&#x00A0;</span>: les Scripts</h1><a 
 id="dx37-38001"></a>
   <h3 class="sectionHead"><span class="titlemark">6.1   </span> <a 
 id="x37-390006.1"></a>Introduction à la création de scripts</h3>
<!--l. 9--><p class="noindent" >Tous les utilitaires et les fonctions décrits jusqu&#8217;ici sont par défaut incorporés à T<sub>E</sub>Xworks.
Bien que certains peuvent être configurés ou adaptés jusqu&#8217;à un certain
point, ils sont prévus pour répondre aux besoins communs à une grande
audience. Cependant, le monde T<sub>E</sub>X est très grand et diversifié. Afin de permettre
aux utilisateurs de répondre à leurs besoins spéciaux &#8211; de mettre du
texte en gras jusqu&#8217;à remplir les exigences spéciales pour le prochain
livre ou article scientifique que vous désirez écrire &#8211;, les fonctionnalités
de base de T<sub>E</sub>Xworks peuvent être augmentées ou modifiées par l&#8217;utilisation de
scripts.
<!--l. 11--><p class="indent" >   Les scripts sont de simples fichiers texte que vous pouvez ouvrir, lire,
modifier dans tout éditeur de texte (y compris T<sub>E</sub>Xworks bien entendu). Ils sont
écrits dans un langage de script particulier qui est essentiellement un
langage de programmation. Au moment de l&#8217;écriture du manuel, T<sub>E</sub>Xworks supporte
QrScript <span class="footnote-mark"><a 
href="index38.html#fn1x7"><sup class="textsuperscript">1</sup></a></span><a 
 id="x37-39001f1"></a>
(inclus dans T<sub>E</sub>Xworks) et Lua (avec un module additionnel).Pour voir quels sont les
langages de script disponibles sur votre système, utilisez l&#8217;option <em><b>Scripts</b></em><span 
class="lmsy-10x-x-120">&#x2192;</span><em><b>Scripts
pour TeXworks</b></em><span 
class="lmsy-10x-x-120">&#x2192;</span><em><b>À propos des Scripts...</b></em>.
<!--l. 14--><p class="indent" >   Écrire des scripts<a 
 id="dx37-39002"></a> va au-delà de la portée de ce manuel, mais est documenté
ailleurs <span class="footnote-mark"><a 
href="index39.html#fn2x7"><sup class="textsuperscript">2</sup></a></span><a 
 id="x37-39003f2"></a>.
ici nous ne discuterons que leur installation et leur utilisation.
<!--l. 16--><p class="indent" >   T<sub>E</sub>Xworks distingue deux types de scripts<span class="frenchb-nbsp">&#x00A0;</span>: des scripts autonomes et des scripts liés. Le
but premier des scripts autonomes est d&#8217;ajouter des fonctionnalités au
programme. Si vous avez besoin d&#8217;une nouvelle fonction, comme mettre un texte
sélectionné en gras, il faut choisir un script autonome. Ces scripts apparaissent
comme une option dans le menu <em><b>Scripts</b></em> et vous pouvez les exécuter simplement
en cliquant sur cette option de menu (ou en utilisant un raccourci clavier, si le
script en fournir un).
                                                                          

                                                                          
<!--l. 18--><p class="indent" >   Les scripts liés, par ailleurs, sont destinés à étendre des fonctions existantes de
T<sub>E</sub>Xworks. Ils sont liés dans le code à des endroits spécifiques, par exemple après
que le processus de composition soit terminé ou après qu&#8217;un fichier aie
été chargé, et peuvent ajouter ou modifier ce que T<sub>E</sub>Xworks est en train de faire.
UN exemple de cela serait un script qui analyserait un fichier que l&#8217;on
vient de charger et définirait la langue de correction orthographique en
se basant sur les commandes de <span class="obeylines-h"><span class="verb"><span 
class="ec-lmtt-12">babel</span></span></span> trouvées dans le document. Dès
lors, les scripts liés n&#8217;apparaissent pas dans le menu <em><b>Scripts</b></em> mais sont au
contraire chargés automatiquement lorsque la fonction de T<sub>E</sub>Xworks qu&#8217;ils modifient est
utilisée.
<!--l. 20--><p class="indent" >   Vous pouvez facilement déterminer quel type de scripts vous avez en ouvrant
le fichier de script. Près du début du fichier vous devriez trouver une ligne
semblable à 
   <div class="fancyvrb" id="fancyvrb18"><a 
 id="x37-39005r1"></a><span 
class="ec-lmtt-10x-x-109">//</span><span 
class="ec-lmtt-10x-x-109">&#x00A0;Type:</span><span 
class="ec-lmtt-10x-x-109">&#x00A0;standalone</span></div>
<!--l. 24--><p class="noindent" >Comme alternative &#8211; une fois que le script est installé &#8211;, vous pouvez utiliser la boîte
de dialogue obtenue par <em><b>Scripts</b></em><span 
class="lmsy-10x-x-120">&#x2192;</span><em><b>Scripts pour T<sub>E</sub>Xworks</b></em><span 
class="lmsy-10x-x-120">&#x2192;</span><em><b>Gérer les Scripts</b></em> pour afficher
cette information/
   <h3 class="sectionHead"><span class="titlemark">6.2   </span> <a 
 id="x37-400006.2"></a>Installer des Scripts</h3>
<a 
 id="dx37-40001"></a>
<!--l. 29--><p class="noindent" >Un mot de mise en garde<span class="frenchb-nbsp">&#x00A0;</span>: n&#8217;installez pas des scripts d&#8217;une source qui n&#8217;a pas
votre confiance<span class="frenchb-thinspace">&#x00A0;</span>! Avant d&#8217;installer des scripts, vous devez être sûrs que le fichier
que vous êtes sur le point d&#8217;installer fait bien ce que vous attendez. Les scripts
sont très puissants &#8211; ils peuvent faire pratiquement tout ce qu&#8217;un programme
normal peut faire. Ainsi, bien qu&#8217;il y aie des précautions de sécurité inclues dans T<sub>E</sub>Xworks,
vous devez cependant savoir que des scripts pourraient endommager votre
ordinateur et causer (entre autres) des crashs et la perte de données. En
particulier, les scripts peuvent lire, créer et modifier de façon arbitraire des
fichiers sur votre disque dur.
<!--l. 31--><p class="indent" >   Cela étant dit, installer des scripts est très simple. Les fichiers de script sont
généralement installés dans <span class="path">&#x003C;ressources&#x003E;/scripts</span> ou un sous-dossier de celui-ci.
Ces sous-dossiers apparaissent dans le menu <em><b>Scripts</b></em>, de sorte qu&#8217;on peut les
utiliser pour grouper et classer les scripts. Ceci est particulièrement utile si vous
utilisez beaucoup de scripts différents qui rendraient autrement le menu <em><b>Scripts</b></em>
très confus. Une façon facile d&#8217;ouvrir le dossier <span class="path">scripts</span> est l&#8217;option de menu
<em><b>Scripts</b></em><span 
class="lmsy-10x-x-120">&#x2192;</span><em><b>Scripts pour T<sub>E</sub>Xworks</b></em><span 
class="lmsy-10x-x-120">&#x2192;</span><em><b>Montrer le Dossier des Scripts</b></em>.
<!--l. 33--><p class="indent" >   Comme les scripts sont généralement de simples fichiers texte, ils ne
nécessitent dès lors pas d&#8217;installateurs particuliers. Pour les installer, copiez ou
                                                                          

                                                                          
décompressez (s&#8217;il s&#8217;agit d&#8217;une archive comme un fichier .zip) simplement le fichier
script &#8211; et tous les autres fichiers nécessaires que vous avez reçus &#8211; dans
<span class="path">&#x003C;ressources&#x003E;/scripts</span> ou un sous-dossier de celui-ci.
<!--l. 35--><p class="indent" >   Après avoir installé un nouveau fichier script, il faut en informer T<sub>E</sub>Xworks. Il
scrute automatiquement pour trouver tous les scripts au démarrage, vous
pouvez donc fermer toutes les fenêtre de T<sub>E</sub>Xworks et relancer l&#8217;application. Une
alternative est fournie l&#8217;option de menu <em><b>Scripts</b></em><span 
class="lmsy-10x-x-120">&#x2192;</span><em><b>Scripts pour T<sub>E</sub>Xworks</b></em><span 
class="lmsy-10x-x-120">&#x2192;</span><em><b>Recharger la
liste des Scripts</b></em> qui re-balayera tous les scripts sans interférer avec le
programme.
<!--l. 37--><p class="indent" >   Vous pouvez aussi désactiver les scripts (ou tout un dossier de scripts) si vous
le désirez. Ceci peut être utile si vous n&#8217;avez pas besoin de certains scripts
pendant quelque temps et que vous ne voulez pas qu&#8217;ils encombrent le menu
<em><b>Scripts</b></em>, sans vouloir cependant tout-à-fait les supprimés. Ou si vous voulez
empêcher des scripts liés de s&#8217;exécuter automatiquement. Pour faire cela, ouvrez
le dialogue « Gérer les Scripts » par <em><b>Scripts</b></em><span 
class="lmsy-10x-x-120">&#x2192;</span><em><b>Scripts pour T<sub>E</sub>Xworks</b></em><span 
class="lmsy-10x-x-120">&#x2192;</span><em><b>Gérer les Scripts</b></em><a 
 id="dx37-40002"></a>.
Décochez simplement le script que vous voulez désactiver et il ne vous gênera
plus.
<!--l. 39--><p class="noindent" >
   <h3 class="sectionHead"><span class="titlemark">6.3   </span> <a 
 id="x37-410006.3"></a>Utiliser les Scripts</h3>
<a 
 id="dx37-41001"></a>
<!--l. 41--><p class="noindent" >Utiliser un script est simple. Les scripts liés sont exécutés automatiquement &#8211;
vous ne devez rien faire. Les scripts autonomes apparaissent dans le menu
<em><b>Scripts</b></em> ou l&#8217;un de ses sous-menus. Si vous ne trouvez pas un script que
vous cherchez ou si vous trouvez un script dont vous ne connaissez pas
l&#8217;usage, vous pouvez utiliser le dialogue « Gérer les Scripts » pour avoir des
informations supplémentaires (comme l&#8217;auteur, une brève description, etc.) à son
sujet.
<!--l. 43--><p class="indent" >   Certains scripts doivent faire tourner d&#8217;autres programmes sur votre système.
Un exemple serait un script qui ouvre le pdf dans votre visualisateur par
défaut, par exemple pour imprimer. Comme exécuter des commandes
arbitraires peuvent dans certains cas être particulièrement dangereux,
cette fonctionnalité est désactivée par défaut. Vous remarquerez cela
lorsqu&#8217;une boîte de dialogue s&#8217;ouvrira subitement pour vous informer
d&#8217;une erreur dans le script ou si un message similaire est affiché dans la
barre de statut. Pour permettre aux scripts d&#8217;exécuter des commandes
système, ouvrez la boîte de s préférences par <em><b>Édition</b></em><span 
class="lmsy-10x-x-120">&#x2192;</span><em><b>Préférences...</b></em>. Là
                                                                          

                                                                          
allez à l&#8217;onglet « Scripts » et cochez l&#8217;option « Autoriser les scripts à
exécuter des commandes Système ». Si vous voulez de nouveau désactiver
cette fonction, il suffit de la décocher. Notez que cette fonction est valide
pour tous les scripts de la même façon &#8211; il n&#8217;y a pas actuellement de
moyen de n&#8217;autoriser l&#8217;exécution de commandes pour certains scripts
seulement.
                                                                          

                                                                          
                                                                          

                                                                          
                                                                          

                                                                          
   <!--l. 5--><div class="crosslinks"><p class="noindent">[<a 
href="Audeladecemanuel.html" >next</a>] [<a 
href="Allerplusloinautresoutils.html" >prev</a>] [<a 
href="Allerplusloinautresoutils.html#tailAllerplusloinautresoutils.html" >prev-tail</a>] [<a 
href="UsageavancelesScripts.html" >front</a>] [<a 
href="index.html#UsageavancelesScripts.html" >up</a>] </p></div>
<!--l. 5--><p class="indent" >   <a 
 id="tailUsageavancelesScripts.html"></a>  </div> 
</body></html>