notepad-plus-plus-legacy/PowerEditor/misc/npp.help/HTML/Preferences.html

403 lines
20 KiB
HTML
Raw Normal View History

<!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.
</dl>
<p>
The
following options are changed per view (See <a href="Multi%20View.html">Multi View</a>). Select the
view to adjust form the combo box.
<p><dl>
<dt>Folder margin style
<dd>The
style of the icons that indicate folding (See <a href="Folding.html">Folding</a>). Select from 4
types.</font>
<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/Open Save 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">-&gt;</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">-&gt;</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">&lt;-</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 starting with http:// 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>