nanorc.5 15.8 KB
Newer Older
Jordi Mallach's avatar
Jordi Mallach committed
1
.\" Hey, EMACS: -*- nroff -*-
2
3
.\" Copyright (C) 2003, 2004, 2005, 2006, 2007
.\" Free Software Foundation, Inc.
Jordi Mallach's avatar
Jordi Mallach committed
4
.\"
5
6
7
8
9
10
11
12
13
14
.\" Le travail d'adaptation française de cette page de manuel a été
.\" réalisé par Jean-Philippe Guérard, en 2003, 2004, 2005, 2006 et 2007.
.\" Ce travail d'adaptation est dans le domaine public. Attention, la
.\" page traduite reste soumise au droit d'auteur de ses auteurs
.\" originaux.
.\"
.\" The French translation of this document is a public domain work of
.\" Jean-Philippe Guérard. This translation work was made in 2003, 2004,
.\" 2005, 2006 and 2007. The translated man page in itself is still
.\" subject to the copyright of its original authors.
Jordi Mallach's avatar
Jordi Mallach committed
15
.\"
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
.\" This document is dual-licensed.  You may distribute and/or modify it
.\" under the terms of either of the following licenses:
.\"
.\" * The GNU General Public License, as published by the Free Software
.\"   Foundation, version 3 or (at your option) any later version.  You
.\"   should have received a copy of the GNU General Public License
.\"   along with this program.  If not, see
.\"   <http://www.gnu.org/licenses/>.
.\"
.\" * The GNU Free Documentation License, as published by the Free
.\"   Software Foundation, version 1.2 or (at your option) any later
.\"   version, with no Invariant Sections, no Front-Cover Texts, and no
.\"   Back-Cover Texts.  You should have received a copy of the GNU Free
.\"   Documentation License along with this program.  If not, see
.\"   <http://www.gnu.org/licenses/>.
Jordi Mallach's avatar
Jordi Mallach committed
31
.\"
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
.\" Ce document est publié sous une double licence. Vous pouvez
.\" le distribuer et le modifier selon les termes de l'une des deux
.\" licences ci-dessous :
.\"
.\" * La Licence publique générale GNU (GNU GPL) version 3 ou, à
.\"   votre choix, supérieure, telle que publiée par la Free
.\"   Software Foundation. Vous devriez avoir reçu une copie de la
.\"   Licence publique générale GNU avec ce programme. Si ce n'est 
.\"   pas le cas, consultez <http://www.gnu.org/licenses/>.
.\"
.\" * La Licence de documentation libre GNU (GNU FDL), version 1.2 
.\"   ou, à votre choix, supérieure, telle que publiée par la Free
.\"   Software Foundation, sans section invariante, ni texte de
.\"   première ou de quatrième de couverture. Vous devriez avoir reçu
.\"   une copie de la Licence de documentation libre GNU avec ce
.\"   programme. Si ce n'est pas le cas, consultez
.\"   <http://www.gnu.org/licenses/>.
.\"
David Lawrence Ramsey's avatar
David Lawrence Ramsey committed
50
.\" $Id$
51
.TH NANORC 5 "version 2.0.0" "29\ novembre\ 2007"
Jordi Mallach's avatar
Jordi Mallach committed
52
53
54
.\" Please adjust this date whenever revising the manpage.
.\" Merci de modifier ces dates à chaque mise à jour de cette page.

55
.SH NOM
Jordi Mallach's avatar
Jordi Mallach committed
56
57
58
59
nanorc \- fichier de configuration de l'éditeur nano du projet GNU 

.SH DESCRIPTION
Cette page de manuel décrit brièvement le fichier de configuration de 
60
l'éditeur \fBnano\fP GNU.
Jordi Mallach's avatar
Jordi Mallach committed
61
62
.PP
\fBnano\fP est un petit éditeur sympathique et libre, qui vise à 
63
remplacer Pico, l'éditeur par défaut du logiciel non libre Pine. 
Jordi Mallach's avatar
Jordi Mallach committed
64
65
66
\fBnano\fP ne se contentant pas de copier l'interface et l'ergonomie de 
Pico, il offre également certaines fonctionnalités manquantes (ou 
désactivées par défaut) de Pico. Ces fonctionnalités sont, par exemple, 
67
les fonctions de recherche et de remplacement et la possibilité de 
68
sauter directement à une ligne et à une colonne précise.
Jordi Mallach's avatar
Jordi Mallach committed
69
70
.PP
Le fichier \fInanorc\fP contient les paramètres par défaut de 
71
72
73
74
\fBnano\fP. Il ne doit pas être au format DOS ou Mac. Lors de son 
démarrage, nano commencera par lire le fichier de configuration général 
\fISYSCONFDIR/nanorc\fP, puis lira le fichier de configuration personnel 
de l'utilisateur \fI~/.nanorc\fP.
Jordi Mallach's avatar
Jordi Mallach committed
75
76

.SH OPTIONS
77
78
Le fichier de configuration accepte une série de commandes \fBset\fP 
(activer) et \fBunset\fP (désactiver), qui permettent de définir le 
79
80
paramétrage de nano au démarrage sans avoir à utiliser d'options de
ligne de commande. De plus, les mots clefs \fBsyntax\fP (syntaxe),
81
\fBcolor\fP (couleur) et \fBicolor\fP (couleur insensible à la casse) 
Jordi Mallach's avatar
Jordi Mallach committed
82
sont utilisés pour définir les règles de colorisation pour différents 
83
motifs de texte. \fBnano\fP lit une commande par ligne.
Jordi Mallach's avatar
Jordi Mallach committed
84

85
86
87
88
89
Les options du fichier de configuration ont priorité sur les valeurs par 
défaut utilisées par nano. Les options de la ligne de commande sont 
prioritaires par rapport aux options du fichier de configuration. Les 
options sont désactivées (unset) par défaut, sauf les options prenant un 
argument.
Jordi Mallach's avatar
Jordi Mallach committed
90

91
92
93
94
Les apostrophes («\ \fI'\fP\ ») et les guillemets droits («\ \fI"\fP\ »)
présents dans des chaînes de caractères utilisées comme paramètres n'ont 
pas besoin d'être précédées d'une barre oblique inversée
(«\ \fI\\\fP\ »). La chaîne sera terminée par le dernier guillemet 
95
droit. Par exemple, pour l'option \fBbrackets\fP, "\fI"')>]}\fP" 
96
97
correspondra à \fI"\fP, \fI'\fP, \fI)\fP, \fI>\fP, \fI]\fP et \fI}\fP.

Jordi Mallach's avatar
Jordi Mallach committed
98
99
100
Les commandes et arguments reconnus sont\ :

.TP 3
101
.B set/unset autoindent
Jordi Mallach's avatar
Jordi Mallach committed
102
103
Active l'indentation automatique.
.TP
104
.B set/unset backup
Jordi Mallach's avatar
Jordi Mallach committed
105
Crée des copies de sécurité nommées
Jordi Mallach's avatar
Jordi Mallach committed
106
107
.IR nom_du_fichier~ .
.TP
108
.B set backupdir "\fIrépertoire\fP"
109
110
111
112
113
114
115
Définit le répertoire utilisé par \fBnano\fP pour enregistrer les copies 
de sécurité uniques, si l'enregistrement de copies de sécurité est 
activé.
.TP
.B set/unset backwards
Par défaut, les recherches se font vers l'arrière.
.TP
116
117
118
119
120
121
122
123
.B set/unset boldtext
Utilise des caractères gras à la place de la vidéo inverse.
.TP
.B set brackets "\fIchaîne\fP"
Définit les caractères considérés comme des crochets fermants lors de la 
justification des paragraphes. Ces caractères ne doivent pas contenir 
d'espaces. Seules les ponctuations terminales, éventuellement suivies 
de crochets fermants, peuvent terminer une phrase.
124

125
126
La valeur par défaut de cette option est\ : "\fI"')>]}\fP".

127
128
129
N.D.T.\ : reportez-vous au paragraphe sur l'option \fBpunct\fR pour 
plus d'informations.

130
131
132
133
.TP
.B set/unset casesensitive
Par défaut, les recherches ne tiennent pas compte de la casse.
.TP
134
.B set/unset const
135
Affiche en permanence la position du curseur dans la ligne d'état.
Jordi Mallach's avatar
Jordi Mallach committed
136
.TP
137
.B set/unset cut
138
139
Par défaut, coupe le texte du curseur à la fin de la ligne, au lieu de 
couper la ligne entière.
Jordi Mallach's avatar
Jordi Mallach committed
140
.TP
141
142
143
144
145
.B set fill \fIn\fP
Passe automatiquement à la ligne une fois arrivé à la colonne 
\fIn\fR. Si la valeur indiquée est de 0 ou moins, le point de passage à 
la ligne aura lieu à la taille de l'écran moins \fIn\fR. Cela permet de 
faire varier le point de passage à la ligne lorsque l'on change la 
146
taille de l'écran. La valeur par défaut est de \-8.
Jordi Mallach's avatar
Jordi Mallach committed
147
.TP
148
.B set/unset historylog
Jordi Mallach's avatar
Jordi Mallach committed
149
150
151
152
153
Active l'utilisation de
.I ~/.nano_history
pour enregistrer et relire les chaînes ayant fait l'objet d'une 
recherche ou d'un remplacement.
.TP
154
155
156
157
158
159
160
.B set matchbrackets "\fIchaîne\fP"
Définit les crochets ouvrants et fermant pour la recherche de crochets 
correspondants. Cette liste ne doit pas contenir de blancs. L'ensemble 
des crochets ouvrants doit être indiqué en premier, suivi de l'ensemble 
des crochets fermant, qui doit être dans le même ordre. La valeur par 
défaut de cette option est "\fI(<[{)>]}\fP".
.TP
161
162
163
164
165
.B set/unset morespace
Utiliser la ligne blanche située sous la ligne de titre comme espace 
supplémentaire d'édition.
.TP
.B set/unset mouse
166
167
168
169
170
171
172
173
Active l'utilisation de la souris, si elle est disponible pour votre
système. Lorsque celle-ci est activée, il est possible d'utiliser la
souris pour positionner le curseur, pour marquer le texte (avec un
double-clic) et pour lancer les fonctions correspondant aux raccourcis.
Il est possible d'utiliser la souris sous X\ Window ou en mode console
avec gpm.
.TP
.B set/unset multibuffer
174
Mode multi-espace\ : permet de charger les fichiers dans leur propre 
175
espace.
Jordi Mallach's avatar
Jordi Mallach committed
176
.TP
177
.B set/unset noconvert
Jordi Mallach's avatar
Jordi Mallach committed
178
179
Pas de conversion depuis les formats DOS et Mac.
.TP
180
.B set/unset nofollow
Jordi Mallach's avatar
Jordi Mallach committed
181
182
Ne suit pas les liens symboliques lors de l'écriture des fichiers.
.TP
183
.B set/unset nohelp
184
Désactive les lignes d'aide affichée en bas de l'écran.
Jordi Mallach's avatar
Jordi Mallach committed
185
.TP
186
187
188
.B set/unset nonewlines
Ne pas ajouter de passage à la ligne à la fin des fichiers.
.TP
189
.B set/unset nowrap
Jordi Mallach's avatar
Jordi Mallach committed
190
191
Désactive le passage automatique à la ligne.
.TP
192
.B set operatingdir "\fIrépertoire\fP"
Jordi Mallach's avatar
Jordi Mallach committed
193
194
\fBnano\fP ne lira et n'écrira des fichiers qu'à l'intérieur du 
\fIrépertoire\fP et de ses sous-répertoires. De plus, celui-ci devient 
195
196
le répertoire courant, afin que les fichiers soient lus depuis ce 
répertoire. Par défaut, cette fonction est désactivée.
Jordi Mallach's avatar
Jordi Mallach committed
197
.TP
198
.B set/unset preserve
Jordi Mallach's avatar
Jordi Mallach committed
199
200
Préserve les séquences XON et XOFF (^Q et ^S).
.TP
201
202
203
204
205
206
.B set punct "\fIchaîne\fP"
Définit les caractères interprétés comme des ponctuations terminales 
lors de la justification des paragraphes. Ces caractères ne peuvent 
inclure de blancs. Seules les ponctuations terminales, éventuellement 
suivies de crochets fermants, peuvent terminer une phrase. La valeur par 
défaut de cette option est "\fI!.?\fP".
207

208
N.D.T.\ : ce réglage permet, lors de la justification, de conserver
209
2\ espaces au lieu d'une derrière les ponctuations terminales, ce qui 
210
correspond aux normes typographiques anglo-saxonnes, mais n'a pas lieu 
211
d'être en français. Pour le français, le plus simple est d'indiquer, 
212
dans le fichier nanorc, une chaîne vide pour ce paramètre.
213
.TP
Jordi Mallach's avatar
Jordi Mallach committed
214
.B set/unset quickblank
215
216
Effacement rapide de la ligne d'état. Les messages affichés par la ligne
d'état disparaîtront après une frappe clavier au lieu de 25.
217
.TP
218
.B set quotestr "\fIchaîne\fP"
Jordi Mallach's avatar
Jordi Mallach committed
219
220
221
Définit le préfixe par défaut utilisé pour les citations dans les 
courriers électroniques. Ce préfixe est utilisé pour réaliser une 
justification correcte de ces citations. Il s'agira, si votre système le 
222
permet, d'une expression rationnelle étendue. Dans le cas 
Jordi Mallach's avatar
Jordi Mallach committed
223
contraire, il s'agira d'une chaîne de texte brut. Si vous disposez des 
224
225
226
expressions rationnelles, la valeur par défaut de cette option sera 
"\fI^([\ \\t]*[#:>\\|}])+\fP", sinon, ce sera ">\ ". Notez que le
«\ \\t\ » ci-dessus correspond à un caractère de tabulation.
Jordi Mallach's avatar
Jordi Mallach committed
227
.TP
228
.B set/unset rebinddelete
229
230
231
232
233
Interprète différemment la touche «\ Supprimer\ », afin que les touches 
«\ Effacement arrière\ » et «\ Supprimer\ » fonctionnent correctement. 
Vous ne devriez avoir besoin de cette option que si, sur votre système, 
la touche «\ Effacement arrière\ » produit l'effet de la touche «\ 
Supprimer\ ».
234
.TP
Jordi Mallach's avatar
Jordi Mallach committed
235
236
237
238
239
240
.B set/unset rebindkeypad
Interprète les touches du pavé numérique afin qu'elles fonctionnent 
toutes correctement. Vous ne devriez utiliser cette option que si ce 
n'est pas le cas, car nano ne sera plus capable d'utiliser la souris 
correctement lorsque cette option sera activée.
.TP
241
.B set/unset regexp
242
243
Utilise par défaut des expressions rationnelles étendues pour les 
recherches.
Jordi Mallach's avatar
Jordi Mallach committed
244
.TP
245
.B set/unset smarthome
246
247
248
249
250
251
Rend plus malin le fonctionnement de la touche «\ Début\ ». Lorsque
cette touche est pressée à n'importe quel endroit excepté au tout début
du texte d'une ligne (i.\ e. au premier caractère non blanc), le curseur
se positionnera au début du texte de la ligne (qu'il soit en avant ou en 
arrière). Si le curseur est déjà là, il se placera au vrai début de la 
ligne.
252
.TP
253
.B set/unset smooth
Jordi Mallach's avatar
Jordi Mallach committed
254
255
Active le défilement ligne-par-ligne du texte.
.TP
256
.B set speller "\fIprogramme\fP"
Jordi Mallach's avatar
Jordi Mallach committed
257
258
259
Utilise le correcteur orthographique \fIprogramme\fP au lieu du 
correcteur intégré, qui s'appuie sur \fIspell\fP.
.TP
260
261
.B set/unset suspend
Autorise à suspendre \fBnano\fP.
Jordi Mallach's avatar
Jordi Mallach committed
262
.TP
263
.B set tabsize \fIn\fP
264
265
266
267
268
Utilise une taille de tabulation de \fIn\fP colonnes. Cette valeur doit 
être strictement supérieure à 0. La valeur par défaut est de\ 8.
.TP
.B set/unset tabstospaces
Convertit les tabulations clavier en espaces.
Jordi Mallach's avatar
Jordi Mallach committed
269
.TP
270
.B set/unset tempfile
271
272
S'il a été modifié, le fichier sera sauvegardé automatiquement en 
quittant, sans demande de confirmation.
Jordi Mallach's avatar
Jordi Mallach committed
273
.TP
274
.B set/unset view
275
Interdit de modifier les fichiers.
Jordi Mallach's avatar
Jordi Mallach committed
276
.TP
277
.B set whitespace "\fIchaîne\fP"
278
Définit les deux caractères utilisés pour afficher les premiers 
279
280
caractères des tabulations et des espaces. Ces deux caractères doivent 
être mono-colonne.
281
.TP
Jordi Mallach's avatar
Jordi Mallach committed
282
283
284
285
.B set/unset wordbounds
Détection plus précise des limites de mots, obtenue en considérant les
caractères de ponctuation comme faisant partie des mots.
.TP
286
.B syntax "\fIchaîne\fP" ["\fImotif_de_fichier\fP" ... ]
Jordi Mallach's avatar
Jordi Mallach committed
287
Définit une syntaxe nommée \fIchaîne\fP qui pourra être activé via 
288
289
290
291
292
l'option \fB-Y\fP (ou \fB--syntax\fP) ou qui sera automatiquement 
activée si le nom du fichier en cours correspond à l'expression 
rationnelle étendue \fImotif_de_fichier\fP. Toutes les instructions 
suivantes de colorisation \fBcolor\fP ou \fBicolor\fP s'appliqueront à 
cette syntaxe, jusqu'à la définition d'une nouvelle syntaxe.
Jordi Mallach's avatar
Jordi Mallach committed
293
294
295
296
297
298
299

La syntaxe nommée \fInone\fP (aucune) est réservée\ ; si elle est 
indiquée dans la ligne de commande, cela revient à ne définir aucune 
syntaxe. La syntaxe nommée \fIdefault\fP (par défaut) est spéciale, elle 
ne nécessite aucun motif de \fImotif_de_fichier\fP, et s'applique aux 
fichiers ne correspondant à aucun des \fImotif_de_fichier\fP des autres 
syntaxes.
Jordi Mallach's avatar
Jordi Mallach committed
300
301
302
.TP
.B color \fIcouleur_texte\fP[,\fIcouleur_fond\fP] "\fImotif\fP" ...
Pour la syntaxe en cours, affiche toutes les expressions correspondant à 
303
304
305
306
307
308
309
l'expression rationnelle étendue \fImotif\fP en utilisant la couleur de 
texte \fIcouleur_texte\fP et la couleur de fond \fIcouleur_fond\fP, 
l'une de ces deux couleurs au moins devant être définie. Les couleurs 
acceptées par \fBnano\fP pour le texte et le fond sont\ : \fIwhite\fP 
(blanc), \fIblack\fP (noir), \fIred\fP (rouge), \fIblue\fP (bleu), 
\fIgreen\fP (vert), \fIyellow\fP (jaune), \fImagenta\fP, et \fIcyan\fP. 
Pour la couleur du texte, vous pouvez ajouter à ces couleurs le préfixe 
310
311
312
313
314
315
316
317
\fIbright\fP (lumineux) pour obtenir une couleur plus lumineuse. Si 
votre terminal est capable de gérer la transparence, ne pas spécifier de 
\fIcouleur_fond\fP indique à \fBnano\fP d'essayer d'utiliser un fond 
transparent.
.TP
.B icolor \fIcouleur_texte\fP[,\fIcouleur_fond\fP] "\fImotif\fP" ...
Comme ci-dessus, mais la recherche des motifs est effectuée sans tenir 
compte de la casse.
Jordi Mallach's avatar
Jordi Mallach committed
318
319
.TP
.B color \fIcouleur_texte\fP[,\fIcouleur_fond\fP] start="\fImotif_début\fP" end="\fImotif_fin\fP"
320
321
322
Affiche les expressions commençant par l'expression rationnelle étendue 
\fImotif_début\fP et se terminant par l'expression rationnelle étendue 
\fImotif_fin\fP en utilisant la couleur de texte \fIcouleur_texte\fP 
323
324
325
326
327
328
329
330
331
et la couleur de fond \fIcouleur_fond\fP, l'une de ces deux couleurs au 
moins devant être définie. Cela permet à la colorisation syntaxique de 
s'étendre sur plusieurs lignes. Notez que toutes les occurrences 
successives de \fImotif_début\fP après le \fImotif_début\fP initial 
seront surlignées jusqu'à la prochaine instance de \fImotif_fin\fP.
.TP
.B icolor \fIcouleur_texte\fP[,\fIcouleur_fond\fP] start="\fImotif_début\fP" end="\fImotif_fin\fP"
Comme ci-dessus, mais la recherche des motifs est effectuée sans tenir 
compte de la casse.
332
333
334
335
336
.TP
.B include "\fIfichier_de_syntaxes\fP"
Lit le fichier \fIfichier_de_syntaxes\fP contenant une liste 
autosuffisante de définitions de syntaxes. Ce fichier ne doit contenir 
que des commandes \fBsyntax\fP, \fBcolor\fP et \fBicolor\fP.
Jordi Mallach's avatar
Jordi Mallach committed
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356

.SH FICHIERS
.TP
.I $SYSCONFDIR/nanorc
Fichier de configuration général
.TP
.I ~/.nanorc
Fichier de configuration personnel

.SH VOIR AUSSI
.PD 0
.TP
\fBnano\fP(1)
.PP
\fI/usr/share/doc/nano/examples/nanorc.sample\fP (ou son équivalent sur 
votre système)

.SH AUTEUR
Chris Allegretta <chrisa@asty.org> et d'autres (voir les fichiers
\fIAUTHORS\fP et \fITHANKS\fP pour plus d'information). Cette page de
357
358
manuel a été initialement rédigée par Jordi Mallach <jordi@gnu.org> pour
le système Debian (mais elle peut être utilisée par d'autres).
Jordi Mallach's avatar
Jordi Mallach committed
359
360

.SH TRADUCTION
361
Cette adaptation française a été réalisée par Jean-Philippe\ Guérard
362
363
364
<jean-philippe.guerard@tigreraye.org> le 29\ novembre\ 2007 à partir de
la version 1.56 du 11\ octobre\ 2007 de la page de manuel de nanorc 
(pour la version 2.0.0 de nano). Cette page a été relue par Gérard 
365
Delafond.
366
367
368
369
370
371
372

Un maximum de soin a été apporté lors de l'élaboration de cette
traduction\ ; néanmoins, quelques imperfections peuvent subsister. Si
vous en rencontrez, que ce soit dans la version française ou dans la
version originale, n'hésitez pas à les signaler à l'auteur ou au
traducteur.

Jordi Mallach's avatar
Jordi Mallach committed
373
La version originale la plus à jour de ce document est toujours 
374
consultable via la commande\ :
375

376
LANGUAGE=en man nano