sample.nanorc.in 9.11 KB
Newer Older
1
## Sample initialization file for GNU nano.
2
3
4
5
6
7
##
## Please note that you must have configured nano with --enable-nanorc
## for this file to be read!  Also note that this file should not be in
## DOS or Mac format, and that characters specially interpreted by the
## shell should not be escaped here.
##
8
## To make sure an option is disabled, use "unset <option>".
9
10
11
12
13
14
15
16
17
##
## For the options that take parameters, the default value is given.
## Other options are unset by default.
##
## Quotes inside string parameters don't have to be escaped with
## backslashes.  The last double quote in the string will be treated as
## its end.  For example, for the "brackets" option, ""')>]}" will match
## ", ', ), >, ], and }.

18
19
## Silently ignore problems with unknown directives in the nanorc file.
## Useful when your nanorc file might be read on systems with multiple
20
## versions of nano installed (e.g. your home directory is on NFS).
21
22
# set quiet

23
24
25
26
## When soft line wrapping is enabled, make it wrap lines at blanks
## (tabs and spaces) instead of always at the edge of the screen.
# set atblanks

27
28
29
## Use auto-indentation.
# set autoindent

30
## Back up files to the current filename plus a tilde.
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
# set backup

## The directory to put unique backup files in.
# set backupdir ""

## Do backwards searches by default.
# set backwards

## Use bold text instead of reverse video text.
# set boldtext

## The characters treated as closing brackets when justifying
## paragraphs.  They cannot contain blank characters.  Only closing
## punctuation, optionally followed by closing brackets, can end
## sentences.
# set brackets ""')>]}"

48
## Do case-sensitive searches by default.
49
50
# set casesensitive

51
## Constantly display the cursor position in the status bar.  Note that
52
## this overrides "quickblank".
53
# set constantshow
54
## (The old form, 'const', is deprecated.)
55

56
57
58
## Use cut-from-cursor-to-end-of-line by default.
# set cutfromcursor
## (The old form, 'cut', is deprecated.)
59
60

## Set the line length for wrapping text and justifying paragraphs.
61
62
## If the value is 0 or less, the wrapping point will be the screen
## width less this number.
63
64
# set fill -8

65
## Remember the used search/replace strings for the next session.
66
67
# set historylog

68
## Make the justify command kill whitespace at the end of lines.
69
70
# set justifytrim

71
72
73
## Display line numbers to the left of the text.
# set linenumbers

74
## Enable vim-style lock-files.  This is just to let a vim user know you
75
## are editing a file [s]he is trying to edit and vice versa.  There are
76
## no plans to implement vim-style undo state in these files.
77
78
# set locking

79
80
81
82
83
## The opening and closing brackets that can be found by bracket
## searches.  They cannot contain blank characters.  The former set must
## come before the latter set, and both must be in the same order.
# set matchbrackets "(<[{)>]}"

84
## Use the blank line below the title bar as extra editing space.
85
86
87
88
89
90
91
92
# set morespace

## Enable mouse support, if available for your system.  When enabled,
## mouse clicks can be used to place the cursor, set the mark (with a
## double click), and execute shortcuts.  The mouse will work in the X
## Window System, and on the console when gpm is running.
# set mouse

93
94
## Switch on multiple file buffers (inserting a file will put it into
## a separate buffer).
95
96
97
98
99
100
101
102
# set multibuffer

## Don't convert files from DOS/Mac format.
# set noconvert

## Don't display the helpful shortcut lists at the bottom of the screen.
# set nohelp

103
104
105
106
## Don't pause between warnings at startup.  Which means that only the
## last one will be readable (when there are multiple ones).
# set nopauses

107
108
109
110
111
112
113
114
115
## Don't add newlines to the ends of files.
# set nonewlines

## Don't wrap text at all.
# set nowrap

## Set operating directory.  nano will not read or write files outside
## this directory and its subdirectories.  Also, the current directory
## is changed to here, so any files are inserted from this dir.  A blank
116
## string means the operating-directory feature is turned off.
117
118
# set operatingdir ""

119
## Remember the cursor position in each file for the next editing session.
120
121
# set positionlog
## (The old form, 'poslog', is deprecated.)
122

123
124
125
126
127
128
129
130
131
## Preserve the XON and XOFF keys (^Q and ^S).
# set preserve

## The characters treated as closing punctuation when justifying
## paragraphs.  They cannot contain blank characters.  Only closing
## punctuation, optionally followed by closing brackets, can end
## sentences.
# set punct "!.?"

132
## Do quick status-bar blanking.  Status-bar messages will disappear after
133
## 1 keystroke instead of 26.  Note that "constantshow" overrides this.
134
135
136
137
# set quickblank

## The email-quote string, used to justify email-quoted paragraphs.
## This is an extended regular expression if your system supports them,
138
139
## otherwise a literal string.
## If you have extended regular expression support, the default is:
140
# set quotestr "^([ 	]*[#:>\|}])+"
141
## Otherwise:
142
143
144
145
146
147
148
149
150
151
152
# set quotestr "> "

## Fix Backspace/Delete confusion problem.
# set rebinddelete

## Fix numeric keypad key confusion problem.
# set rebindkeypad

## Do extended regular expression searches by default.
# set regexp

153
154
155
156
## Put the cursor on the highlighted item in the file browser;
## useful for people who use a braille display.
# set showcursor

157
158
159
160
161
162
163
164
165
166
## Make the Home key smarter.  When Home is pressed anywhere but at the
## very beginning of non-whitespace characters on a line, the cursor
## will jump to that beginning (either forwards or backwards).  If the
## cursor is already at that position, it will jump to the true
## beginning of the line.
# set smarthome

## Use smooth scrolling as the default.
# set smooth

167
## Enable soft line wrapping (AKA full-line display).
168
169
# set softwrap

170
## Use this spelling checker instead of the internal one.  This option
171
## does not have a default value.
172
173
174
175
176
177
178
179
180
181
182
# set speller "aspell -x -c"

## Allow nano to be suspended.
# set suspend

## Use this tab size instead of the default; it must be greater than 0.
# set tabsize 8

## Convert typed tabs to spaces.
# set tabstospaces

183
## Save automatically on exit; don't prompt.
184
185
# set tempfile

David Lawrence Ramsey's avatar
David Lawrence Ramsey committed
186
## Disallow file modification.  Why would you want this in an rcfile? ;)
187
188
189
190
191
# set view

## The two single-column characters used to display the first characters
## of tabs and spaces.  187 in ISO 8859-1 (0000BB in Unicode) and 183 in
## ISO-8859-1 (0000B7 in Unicode) seem to be good values for these.
192
193
194
195
## The default when in a UTF-8 locale:
# set whitespace "»·"
## The default otherwise:
# set whitespace ">."
196

197
## Detect word boundaries differently by treating punctuation
198
## characters as parts of words.
199
200
# set wordbounds

201
202
203
204
205
## The characters (besides alphanumeric ones) that should be considered
## as parts of words.  This option does not have a default value.  When
## set, it overrides option 'set wordbounds'.
# set wordchars "<_>."

206

207
## Paint the interface elements of nano.
208
## These are examples; by default there are no colors.
209
210
# set titlecolor brightwhite,blue
# set statuscolor brightwhite,green
211
212
213
214
215
216
217
218
219
# set numbercolor cyan
# set keycolor cyan
# set functioncolor green
## In root's .nanorc you might want to use:
# set titlecolor brightwhite,red
# set statuscolor brightwhite,red
# set numbercolor magenta
# set keycolor brightmagenta
# set functioncolor magenta
220
221
222


## Setup of syntax coloring.
223
224
225
226
227
228
229
230
231
232
233
234
235
236
##
## Format:
##
## syntax "short description" ["filename regex" ...]
##
## The "none" syntax is reserved; specifying it on the command line is
## the same as not having a syntax at all.  The "default" syntax is
## special: it takes no filename regexes, and applies to files that
## don't match any other syntax's filename regexes.
##
## color foreground,background "regex" ["regex"...]
## or
## icolor foreground,background "regex" ["regex"...]
##
237
238
## "color" will do case-sensitive matches, while "icolor" will do
## case-insensitive matches.
239
240
241
242
243
244
245
246
247
248
249
250
##
## Valid colors: white, black, red, blue, green, yellow, magenta, cyan.
## For foreground colors, you may use the prefix "bright" to get a
## stronger highlight.
##
## To use multi-line regexes, use the start="regex" end="regex"
## [start="regex" end="regex"...] format.
##
## If your system supports transparency, not specifying a background
## color will use a transparent color.  If you don't want this, be sure
## to set the background color to black or white.
##
251
252
253
254
## All regexes should be extended regular expressions.
##
## If you wish, you may put your syntax definitions in separate files.
## You can make use of such files as follows:
255
##
256
## include "/path/to/syntax_file.nanorc"
257
##
258
259
260
261
## Unless otherwise noted, the name of the syntax file (without the
## ".nanorc" extension) should be the same as the "short description"
## name inside that file.  These names are kept fairly short to make
## them easier to remember and faster to type using nano's -Y option.
262
##
263
## To include all existing syntax definitions, you can do:
264
265
266
# include "@PKGDATADIR@/*.nanorc"


267
## Key bindings.
268
## See nanorc(5) (section REBINDING KEYS) for more details on this.
269
##
270
271
272
273
274
275
276
## The following five functions are not bound to any key by default.
## You may wish to choose different keys than the ones suggested here.
# bind ^S savefile main
# bind M-Q findprevious main
# bind M-W findnext main
# bind M-B cutwordleft main
# bind M-N cutwordright main
277

278
## Set this if your Backspace key sends Del most of the time.
279
# bind Del backspace all