9ab9b02e6a
[NEW_FEATURE] (Author: Christian Cuvier) Update NppHelp. [UPDATE] Update native Language files. git-svn-id: svn://svn.tuxfamily.org/svnroot/notepadplus/repository/trunk@674 f5eea248-9336-0410-98b8-ebc06183d4e3
406 lines
20 KiB
HTML
406 lines
20 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
|
|
<html><head><meta content="text/html; charset=utf-8" http-equiv="content-type"><title>Preferences</title>
|
|
<link rel="stylesheet" href="styles.css" type="text/css"></head>
|
|
<body>
|
|
<h1>Preferences</h1>
|
|
<p>You
|
|
can configure many aspects of Notepad++ using the Preferences dialog.
|
|
The dialog consists of multiple tab which contain options that are
|
|
relevant to some aspect of Notepad++ (for instance, the interface or
|
|
backup options).
|
|
<p><img style="width: 599px; height: 397px;" alt="" src="Images/Screenshots/preferences.png" usemap="#preferences">
|
|
<p>
|
|
<h2><a name="General">General</a>
|
|
</h2>
|
|
<p>The
|
|
general settings control the look of the main interface. You can
|
|
control the Tab Bar, the Tool Bar, the Status Bar and the menu from
|
|
here, as well as the current ...
|
|
<p>
|
|
<dl>
|
|
<dt>Localization:
|
|
<dd>
|
|
This dropdown list shows all the languages which you can use for Notepad++ to speak your language. If you click on one of these languages, all user interface elements are instantly translated into that language. The various localisation files are in the Localization subfolder of Notepad++'s install folder.
|
|
<dt>Tool bar:
|
|
<dd>
|
|
<ul><li>
|
|
<span class="checkbox">Hide</span>
|
|
- Check the hide checkbox to completely hide the tool bar.
|
|
The
|
|
following choices show immediate results, but sometimes a restart is
|
|
required to load the correct icons:
|
|
</li><li><span class="radio">Small
|
|
icons</span> - Notepad++ will use the small icon set for the toolbar. This
|
|
can be the built-in icon set or custom icons.</font>
|
|
</li><li><span class="radio">Big icons</span> - Notepad++ will use the large icon set for the toolbar. This
|
|
can be the built-in icon set or custom icons.
|
|
</li><li><span class="radio">Small
|
|
standard icons</span> - These are the default built-in icons. This is also
|
|
the only option that will show any tool bar icons registered by
|
|
plugins.
|
|
</li></ul>
|
|
<dt>Menu bar:
|
|
<dd><span class="checkbox">Hide</span>
|
|
- If you check this option, the menu bar will automatically hide.
|
|
To (temporarily) show the menu bar, press the Alt key or the F10 key
|
|
to give the menu focus. Selecting an option, pressing escape or
|
|
giving another window the focus will hide the menu again.
|
|
<dt>Status bar:
|
|
<dd><span class="checkbox">Show status bar</span> - Check the option to show the status bar.</font>
|
|
<dt>Tab bar:
|
|
<span style="font-weight:normal;">
|
|
<ul><li><span class="checkbox">Hide</span>
|
|
- Checking this option will hide the tab bar. You can still open
|
|
multiple documents but you have to switch using shortcuts rather that
|
|
using the tab bar.
|
|
</li><li><span class="checkbox">Multi-Line</span>
|
|
- Checking this option will cause the tab bar to draw multiple rows
|
|
of documents if they cannot all be displayed in a single row.
|
|
Otherwise a pair of scroll arrow buttons will appear. Note that the active document
|
|
will always be on the bottom row.
|
|
</li><li><span class="checkbox">Vertical</span>
|
|
- Checking this option will rotate the<font size="3"> tab bar 90°
|
|
counterclockwise and place it at the left side of the screen.
|
|
</li><li><span class="checkbox">Reduce</span>
|
|
- If checked the tab bar will use the default font and icon size.
|
|
Unchecking will cause it to use a larger font and larger icons.
|
|
</li><li>
|
|
<font size="3"><span class="checkbox">Lock</span>
|
|
- Checking this will disable the ability to sort documents by
|
|
dragging the tabs around.
|
|
</li><li><span class="checkbox">Draw the inactive tabs</span> - If checked, inactive tabs will be drawn using a
|
|
custom background color (see Settings, Styler Configurator).
|
|
</li><li><span class="checkbox">Draw
|
|
the orange top bar</span> - Checking this will draw a (by default) orange
|
|
line on top of active tabs (see Settings, Styler Configurator).
|
|
</li><li><span class="checkbox">Enable
|
|
close button on each tab</span> - Checking this will add a close button on
|
|
each tab. Clicking it will close that tab.
|
|
</li><li><span class="checkbox">Double
|
|
click to close document</span> - If checked, doubleclicking on a tab will
|
|
close it.
|
|
</li></ul></span></dl>
|
|
|
|
<h2><a name="Editing"></a>Editing</h2>
|
|
<p>These
|
|
settings affect the behaviour and look of Scintilla, the edit
|
|
component of Notepad++.
|
|
<dl>
|
|
<dt>Caret settings
|
|
<dd>
|
|
<uk><li>
|
|
<span class="label">Width</span>
|
|
- Set the width in pixels of the caret, or change it into a block
|
|
which is the size if the current character (if printable, otherwise
|
|
the size of the space character).
|
|
</li><li><span class="label">Blink
|
|
rate</span> - Change from fast (F) to slow (S). Moving all the way to slow
|
|
will stop the blinking.</font><br>You can change the caret color with the <a href="Styler%20Configurator.html#Caret_colour">Styler Configurator</a>.
|
|
</li></ul>
|
|
<dt>Multi-Editing
|
|
<dd>You can enable or disable this feature through the checkbox. This both controls the ability to select multiple areas (see <a href="Selecting.html">Selecting text</a>) and to get typed text mirrored in all the areas in the selection.
|
|
<dt>Folder margin style
|
|
<dd>The
|
|
style of the icons that indicate folding (See <a href="Folding.html">Folding</a>). Select from 4
|
|
types. The <span class="label">None</span> style hides the margin even if the document type would support it.</font>
|
|
<dt>Line wrap
|
|
<span style="font-weight:normal;">
|
|
<ul><li><span class="radio">Default</span>The wrapped part of the line
|
|
shows as several lines starting on the left margin
|
|
</li><li><span class="radio">Aligned</span>The wrapped part of the line
|
|
shows as several lines starting right below the unwrapped part.
|
|
</li><li><span class="radio">Indented</span>The wrapped part of the line
|
|
shows as several lines starting with some indentation relative to the unwrapped part.
|
|
</li></ul></span>
|
|
<dt>Vertical Edge Setting
|
|
<span style="font-weight:normal;">
|
|
<ul><li><span class="checkbox">Show
|
|
vertical edge</span> - Checking this will draw a vertical edge throughout
|
|
the document.</font>
|
|
Mode
|
|
</li><li><span class="radio">Line
|
|
mode</span> - If this mode is set, the edge will be drawn using a line in
|
|
the background
|
|
</li><li><span class="radio">Background
|
|
mode</span> - If this mode is set, the edge will be drawn by changing the
|
|
background color of characters that are past the edge. You can change the color with the <a href="Styler%20Configurator.html#Edge_colour">Styler Configurator</a>.
|
|
</li><li><span class="label">Number
|
|
of columns</span>: The distance in columns (as determined by the size of the
|
|
space character) at which the edge will be drawn.
|
|
</li></ul></span>
|
|
<dt>Other options
|
|
<span style="font-weight:normal;">
|
|
<ul><li><span class="checkbox">Display
|
|
line number margin</span> - If checked, line numbers will be drawn. You can change the color with the <a href="Styler%20Configurator.html#Line_number_margin">Styler Configurator</a>.
|
|
When shown, the line number margin can accommodate three digits, and will grow as needed to display numbers in a higher range.
|
|
</li><li><span class="checkbox">Display
|
|
bookmark margin</span> - If checked, the bookmark margin will be drawn.</li><li>
|
|
<span class="checkbox">Active
|
|
current line highlight</span> - If checked, the line at which the caret is
|
|
present will be drawn with a special background color. </font>You can change the color with the <a href="Styler%20Configurator.html#Current_line_background_colour">Styler Configurator</a>.</li></ul></span></dl>
|
|
<p>
|
|
|
|
<h2><a name="New_Document_Open_Save_directory"></a>New
|
|
Document/Default directory
|
|
</h2>
|
|
<p>These
|
|
options change the way new documents are created and what the default
|
|
Open/Save directories will be.
|
|
<p>
|
|
<dl>
|
|
<dt>New document:
|
|
<span style="font-weight:normal;">
|
|
<ul><li>
|
|
<span class="label">Encoding</span>:</font>
|
|
Allows
|
|
to choose what encoding to use (see <a href="Encoding.html">Encoding</a>).
|
|
</li><li><span class="label">Format</span>:
|
|
Allows
|
|
to choose what end-of-line format to use (see <a href="Newline%20format.html">Newline Format</a>).
|
|
</li><li><span class="label">Default language</span>: defines which highlighter will be used for any newly created document. The dropdown list mirrors the Language menu. However,
|
|
user defined languages and external languages cannot be selected.
|
|
</li></ul></span>
|
|
<dt>File
|
|
Open/Save Directory:
|
|
<dd>The File Open/Save Directory, or Default
|
|
Directory, controls what directory Notepad++ looks in when opening or
|
|
saving files. Please note that the Default
|
|
directory is not the same as the Current Directory (Working
|
|
Directory) Notepad++ uses. Do not make assumptions about Notepad++
|
|
Current Directory.
|
|
<ul><li><span class="radio">Follow
|
|
the current document</span> - If this option is selected, the default
|
|
directory will be the directory of the currently active file. If the
|
|
file is a new, unsaved document, this will be Notepad++' directory.
|
|
</li><li><span class="radio">Remember
|
|
the last operation directory</span> - If this option is selected, the
|
|
default directory will initially be the directory Notepad++ was
|
|
started in (you can control this by adjusting the shortcut you use
|
|
for Notepad++) and only change when browsing for files (to open or
|
|
save a file).
|
|
</li><li><span class="radio">Custom</span>
|
|
- The default directory can be set to a fixed path. Browse for a
|
|
path or type it yourself. If the path is invalid, Notepad++'
|
|
directory will be used. You are allowed to use Environment Variables, using the $(<i>var-name</i>) syntax as usual.
|
|
</li></ul></dl>
|
|
<p>
|
|
<h2><a name="File_Association"></a>File
|
|
Association
|
|
</h2>
|
|
<p>You
|
|
can associate files with Notepad++ so opening those files will start
|
|
Notepad++. Select a type of file, then select the desired extension
|
|
and press the left arrow to associate the file. To add a custom type
|
|
of file, select customize, enter the extension and press the <span class="button">-></span> button.
|
|
To remove the association, select the extension to dissociate and
|
|
press the arrow next to the garbage can.
|
|
<p>
|
|
|
|
<h2><a name="Language_Menu"></a>Language Menu/Tab settings
|
|
</h2>You
|
|
can select the languages that are available from the <span class="menu_item">Language</span> menu. In
|
|
the <span class="label">Available Items</span> list are the languages that are currently
|
|
visible. To hide a language form the menu, select it and press the
|
|
<span class="button">-></span> button to put it in the <span class="label">Disabled Items</span> list. Add the
|
|
language again by selecting it from the <span class="label">Disabled Items</span></font><font face="Times New Roman, serif"> list and
|
|
pressing the <span class="button"><-</span> button.</font>
|
|
<br>
|
|
The appearance of the Language menu can be further controlled by the <span class="checkbox">Make Language menu Compact</span> checkbox. When checked, languages whose names start by the same letter are grouped into a submenu, rather than being all lumped in the menu proper.
|
|
<p>
|
|
Tab settings can be adjusted on a per language basis. The right hand list has all built-in languages, as well as a topmost (Default) entry. The latter applies to all languages which don't have a custom setting, as well as to all user defined languages. The frame below allows adjusting tab settings for the selected language:
|
|
<ul><li><span class="label">Tab size</span> - Size in space characters of a tab character in the document.
|
|
</li><li><span class="checkbox">Replace
|
|
by space</span> - Checking this will cause any tabs added to be in the
|
|
form of spaces, up to the amount as determined by the Tab size
|
|
setting.</li></ul>
|
|
<p>
|
|
<h2><a name="Print"></a>Print</h2>
|
|
<p>Use
|
|
these settings to adjust the layout and colors used when printing a
|
|
document, as well as the page header and footer text. This can be any regular string or a variable that will change depending on the printed document.
|
|
<p><ul><li>
|
|
<span class="checkbox">Print
|
|
line number</span> - If selected, linenumbers will be printed aswell.</li><li>
|
|
Colour
|
|
Option:
|
|
<ul><li><span class="radio">WYSIWYG</span>
|
|
- print colours exactly as they are on the screen.</font>
|
|
</li><li><span class="radio">Invert</span>
|
|
- This will print the document with the background color inverted
|
|
(white becomes black for instance, and v.v.) and the default
|
|
foreground color inverted. All other colors will remain the same.</font>
|
|
</li><li><span class="radio">Black
|
|
on white</span> - All text will be printed black and a white background.
|
|
</li><li><span class="radio">No
|
|
background color</span> - This will print all the text colored, but any
|
|
background colors (including the default color) will be printed
|
|
white.</li></ul>
|
|
</li></ul>
|
|
<dl>
|
|
<dt>Variables
|
|
<dd>
|
|
You can use <span class="label">Variable</span>:
|
|
variable text inside the current header/footer.
|
|
There are a few default
|
|
variables listed, but you can also use any variable used by the Run
|
|
dialog (see <a href="Commands.html">Commands</a>) as well. The syntax
|
|
is the same. To add some predefined variable from the dropdown, click
|
|
<span class="button">Add</span>. The name will automatically be escaped.
|
|
<dt>Header:
|
|
<dd>Control
|
|
the header text. If any header text is present, it will be separated
|
|
from the document with a line. Use
|
|
the various edit controls to adjust the text added to the header. You can add
|
|
text in the left aligned, right aligned and centered sections.
|
|
The
|
|
controls below control the font used by the header.
|
|
<dt>Footer:
|
|
<dd>Control
|
|
the footer text. See Header for more information.
|
|
</dl>
|
|
<p>
|
|
<h2><a name="Backup_Auto-Completion"></a>Backup/Auto-Completion</font>
|
|
</h2><p>
|
|
<dl>
|
|
<dt>Backup:
|
|
<dd>Control
|
|
backup behaviour. You can instruct Notepad++ to automatically make a
|
|
backup of every file if you save any modifications.
|
|
<p><ul><li><span class="radio">None</span>
|
|
- No backups are made.
|
|
</li><li><span class="radio">Simple
|
|
backup</span> - A backup is saved to a file with the same name and .bak
|
|
added as extension (the original extension is preserved).
|
|
</li><li><span class="radio">Verbose
|
|
backup</span> - Like simple backup, but before the .bak extension a short
|
|
date and timestamp is added.
|
|
</li><li><span class="checkbox">User
|
|
custom backup directory</span> - If checked, a custom backup directory is
|
|
used instead of saving to the same directory the file resides in. If
|
|
the path is invalid the directory the file resides in will be used.</li></ul>
|
|
<dt>Auto-completion:
|
|
<dd>See
|
|
<a href="Auto%20Completion.html">Auto-Completion</a> on what Auto Completion is.
|
|
<ul><li><span class="checkbox">Enable
|
|
Auto-completion on each input</span> - If checked, Notepad++ will try to
|
|
autocomplete the current word being typed based on how much is
|
|
already written.
|
|
</li><ul><li><span class="radio">Function
|
|
Completion</span> : try to complete the current word using the list of
|
|
functions of the current language.
|
|
</li><li><span class="radio">Word
|
|
completion</span> : try to complete the current word using the words in the
|
|
document.
|
|
</li><li><span class="label">From
|
|
#th characters</span>: Enter amount of characters needed before Notepad++
|
|
tries to auto-complete the current words. Allowed values range from 1
|
|
to 9.
|
|
</li></ul><li>
|
|
<span class="checkbox">Function
|
|
parameters hint on input</span> - If checked, when a character is added
|
|
that marks the start of a list of arguments of the currently typed
|
|
function, the function parameters calltip will be shown.</font>
|
|
</li></ul></dl><p>
|
|
|
|
<h2><a name="MISC"></a>MISC</h2><p>
|
|
These
|
|
settings control other aspects of Notepad++.
|
|
<p><dl>
|
|
<dt>History File Setting:
|
|
<span style="font-weight: normal;">
|
|
<ul><li><span class="label">Max
|
|
number of history file #</span> - Any number from 0 up to 30. Controls the
|
|
amount of files that are saved in the history.
|
|
</li><li><span class="checkbox">Don't
|
|
check at launch time</span> - If checked, Notepad++ will not verify the
|
|
validity of the files in the history. If unchecked, Notepad++ will
|
|
check the existence of each file. Recommended to be turned on in case
|
|
of networked files.</li></ul></span>
|
|
<dt>Document switcher:
|
|
<span style="font-weight: normal;">
|
|
(See
|
|
<a href="Document%20Switcher.html">Document Switcher</a>)</font>
|
|
<ul><li><span class="checkbox">Enable</span>
|
|
- Enable the document switcher.</font>
|
|
</li><li><span class="checkbox">Enable
|
|
MRU behavior</span> - Enables the MRU style sort of files in the document
|
|
switcher.</li></ul></span>
|
|
<dt>Clickable link settings:
|
|
<dd>This feature optionally makes web addresses (all protocols) clickable. Double clicking opens that address in your browser, if any is
|
|
installed and registered.
|
|
<ul><li>
|
|
<span class="checkbox">Enable</span>
|
|
- If enabled, http:// addresses are clickable as soon as they have been typed and caret leaves them.
|
|
</li><li><span class="checkbox">Don't
|
|
draw underline</span> - If enabled, the address will be drawn without an
|
|
underline. Underlining is the default.</li></ul>
|
|
<dt>File Status Auto-detection:
|
|
<dd>Automatically
|
|
checks the status of each opened file when Notepad++ is activated
|
|
from the background.
|
|
<ul><li>
|
|
<span class="checkbox">Enable</span>
|
|
- Check to enable status detection.</font>
|
|
</li><li><span class="checkbox">Update
|
|
silently</span> - If a change to a file is detected (modified contents),
|
|
Notepad++ will reload the file without asking.</font>
|
|
</li><li><span class="checkbox">Scroll
|
|
to the last line after update</span> - If checked, when a file is reloaded
|
|
after an external modification is detected, it will be scrolled to
|
|
the last line (useful for tailing log files).
|
|
</li></ul>
|
|
<dt>Highlight matching tags:
|
|
<dd>Tag
|
|
highlighting is used for HTML/XML languages. When the cursor is
|
|
located inside or at a tag, corresponding tag entries will be
|
|
colorized. Change the colors using the <a href="Styler%20Configurator.html#Tags_match_highlighting">Styler Configurator</a>.
|
|
<ul><li>
|
|
<span class="checkbox">Enable</span>
|
|
- Check to enable tag highlighting.
|
|
</li><li><span class="checkbox">Highlight
|
|
tag attributes</span> - If checked, the attributes of a tag will be
|
|
colorized as well.
|
|
</li><li><span class="checkbox">Highlight
|
|
comment/php/asp zone</span> - If checked, tags inside a php/asp zone will be
|
|
matched as well.
|
|
</li></ul>
|
|
<dt>Sessions
|
|
<span style="font-weight:normal;">
|
|
<ul><li><span class="checkbox">Remember
|
|
the current session for next launch</span> - If checked, the all the files
|
|
opened in Notepad++ will be opened again if Notepad++ is closed.
|
|
</li><li>
|
|
If an extension is entered in
|
|
<span class="label">Session
|
|
file ext</span>, Notepad++ will try to open
|
|
these files as session files instead of regular files. This allows
|
|
you to simply provide a session file via the command line or any
|
|
other method of opening a file to load a session into Notepad++.
|
|
</li></ul>
|
|
<dt>Other options
|
|
<span style="font-weight:normal;">
|
|
<ul><li>
|
|
<span class="checkbox">Enable Notepad++ auto-updater</span>: If checked, Notepad++ will attempt to find about an update at startup. You have the option of postponing the upgrade if one is found.
|
|
</li><li>
|
|
<span class="checkbox">Auto-indent</span> -
|
|
If checked, adding a new line will automatically indent that line
|
|
if any line with text before it has indentation as well. The
|
|
indentation will then be matched.
|
|
</li><li>
|
|
<span class="checkbox">Minimize
|
|
to sys tray</span> - If checked, minimizing Notepad++ will cause it to be
|
|
hidden from the taskbar and an icon to be added to the system tray
|
|
(notification area). Clicking the icon will bring Notepad++ back to
|
|
the foreground.
|
|
</li><li><span class="checkbox">Smart
|
|
highlighting</span> - If checked, any word that matches the currently
|
|
selected word in the screen will be highlighted. You can control the
|
|
color using the Styler Configurator.
|
|
</li><li><span class="checkbox">Show
|
|
only filename in titlebar</span> - If checked, instead of the full path to
|
|
the active file only the filename will be displayed.
|
|
</li></ul></span>
|
|
</dl>
|
|
|
|
<map id="preferences" name="preferences"><area shape="rect" alt="" coords="11,45,84,61" href="#General" title=""><area shape="rect" alt="" coords="88,45,152,61" href="#Editing" title=""><area shape="rect" alt="" coords="156,45,325,61" href="#New_Document_Open_Save_directory" title=""><area shape="rect" alt="" coords="329,45,428,61" href="#File_Association" title=""><area shape="rect" alt="" coords="432,45,585,61" href="#Language_Menu" title=""><area shape="rect" alt="" coords="14,30,178,43" href="#Print" title=""><area shape="rect" alt="" coords="182,30,417,43" href="#Backup_Auto-Completion" title=""><area shape="rect" alt="" coords="421,30,584,43" href="#MISC" title=""></map>
|
|
</body></html> |