237 lines
9.7 KiB
HTML
237 lines
9.7 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>Styler Configurator</title>
|
|
<link rel="stylesheet" href="styles.css" type="text/css">
|
|
</head>
|
|
<body>
|
|
<h1>Styler Configurator
|
|
</h1>
|
|
<p>The
|
|
styler configurator is primarily used to control the appearance of
|
|
the text in Notepad++, but it also allows you to tweak some of the
|
|
other aspects that have a user configurable color. <p><img style="width: 756px; height: 391px;" alt="" src="Images/Screenshots/styler_config.png"><p>The styler
|
|
configurator has two lists. The left list (<span class="label">Language</span>) contains all the
|
|
languages that can be styled, as well as other items with some color setting:
|
|
<ul><li> Global Styles: controls the user interface colors.
|
|
</li><li>Search results: The text of the <a href="Search%window.html">Search results window</a>
|
|
</li><li>DOS style: Highlighting text as if displayed on a command.vom/cmd.exe shell window.
|
|
</li></ul><p>
|
|
The list on the right
|
|
(<span class="label">Style</span>) has all the configurable styles for the selected language.
|
|
<p>
|
|
For
|
|
most languages it is straightforward what each property does, so only
|
|
the global setup and the exceptions are mentioned here.
|
|
<p><dl>
|
|
<dt>Validation:
|
|
<span style="font-weight:normal;">
|
|
<ul><li>
|
|
<span class="button">Save
|
|
& Close</span>: Store all style information and close the dialog.</li><li>
|
|
<span class="button">Cancel</span>:
|
|
Revert any changes made and close the dialog. Same as closing the
|
|
dialog.</li></ul></span>
|
|
<dt>Dialog options:
|
|
<dd>
|
|
<span class="checkbox">Transparency</span>
|
|
enable transparent dialog. The slider controls the amount of
|
|
transparency. Note that transparency is only available on Windows
|
|
2000 and later.
|
|
<dt>Style themes:
|
|
<dd></span>A style theme is a complete collection of style properties (see below), foa all languages and global settings. At any given time, one theme is active, and you can change it at any time using the dropdown list at the top of the dialog. The list is read at startup from the themes\ configuration subfolder, but you can add to it later using the <span class="Menu">Preferences -> Import -> Import theme file(s)</span> command.
|
|
<dt>Style properties:
|
|
<dd>All styles have some properties assigned to them. Som
|
|
styles have properties that others do not have, such as a background
|
|
color. If a property is not available it is simply greyed out.
|
|
<dl>
|
|
<dt>Colors:
|
|
<dd>Clicking
|
|
on the color box shows a popup with a few default colors. Clicking on
|
|
those will change the color to that. Click <span class="button">More Colours...</span> to
|
|
manually specify a color. Either color can be rightclicked upon, if enabled, to
|
|
leave the color property 'blank'. The style will then use the default
|
|
color instead.
|
|
<ul><li>
|
|
<span class="label">Foreground
|
|
color</span>: The 'main' color. For text this is the color of the
|
|
characters.
|
|
</li><li><span class="label">Background color</span>: For text this is the background 'filler' color.
|
|
</li></ul>
|
|
<dt>Fonts:
|
|
<span style="font-weight:normal;">
|
|
<ul><li>
|
|
<span class="label">Font
|
|
Name</span>: The font to use when drawing the text. Leave blank to use the
|
|
default.
|
|
</li><li><span class="label">Font
|
|
size</span>: Size of the font (in points) to use when drawing text. Leave
|
|
blank to use the default.
|
|
</li><li><span class="checkbox">Bold</span>:
|
|
Check if you want to use bold text.
|
|
</li><li><span class="checkbox">Italic</span>:
|
|
Check if you want to use italic text.
|
|
</li><li><span class="checkbox">Underline</span>:
|
|
Check if you want to use underlined text.
|
|
</li></ul></dl></dl>
|
|
<p>
|
|
If
|
|
a regular language is selected, two edit controls are shown:
|
|
<ul><li>
|
|
<span class="label">Default
|
|
ext.</span>: default file extensions associated with this language. If a
|
|
file is opened with that extension, Notepad++ will switch to that
|
|
language.
|
|
</li><li><span class="label">User
|
|
ext.</span>: user definable list of extensions (space separated).
|
|
</li></ul>
|
|
<p>
|
|
When
|
|
a style is selected that has special keywords assigned to it,
|
|
selecting that style will also display two extra edit controls:
|
|
<ul><li>
|
|
<span class="label">Default
|
|
keywords</span>: These are the keywords used by default of the given
|
|
language.
|
|
</li><li><span class="label">User
|
|
Define keywords</span>: These are (space separated) keywords you can enter
|
|
yourself to supplement the default ones.
|
|
The
|
|
style will then only be applied if a word in the text equals to the
|
|
keywords (variations can occur depending on the language, because
|
|
syntax can be different).</li></ul>
|
|
<p>
|
|
|
|
<h3>Special languages:</h3>
|
|
<p>
|
|
<h4>Global
|
|
Styles: (default styles + user interface styles)</h4>
|
|
<p>
|
|
<img style="width: 756px; height: 391px;" alt="" src="Images/Screenshots/styler_config_default.png"><p>
|
|
<dl>
|
|
<dt>Global
|
|
Override
|
|
<dd> This style can override every single other style, and
|
|
has a few options beside the default style properties. Each checkbox
|
|
below the default styling options specifies what global property to
|
|
apply. If a property is blank the style will not be applied (however
|
|
bold, italic and underline do globally disable those properties if
|
|
unchecked but enabled).
|
|
<dt>Default
|
|
Style
|
|
<dd>Default style properties to base other styles on. Leaving
|
|
properties blank results in undefined behavior.
|
|
<dt><a name="Indent_Guideline_Style"></a>Indent
|
|
Guideline
|
|
<dd>Colors to use for the indent guideline. The
|
|
guideline is made of alternating colors, these can be specified using
|
|
the fore- and background color options.
|
|
<dt><a name="Brace_Highlight_Style"></a>Brace
|
|
Highlight Style
|
|
<dd>Highlighted braces use this style. All properties
|
|
can be adjusted.
|
|
<dt>Bad
|
|
brace colour
|
|
<dd>If brace highlighting fails because no matching
|
|
brace can be found, the brace is drawn with this style.
|
|
<dt><a name="Current_line_background_colour"></a>Current
|
|
line background colour
|
|
<dd>Control the background color of the active
|
|
line highlight if it is enabled. Cannot be set to blank value.
|
|
<dt>Selected
|
|
text colour
|
|
<dd>Color of the background of selected text. Cannot be
|
|
set to blank value.
|
|
<dt><a name="Caret_colour"></a>Caret
|
|
colour
|
|
<dd>Color of the caret. Cannot be set to blank value.
|
|
<dt><a name="Edge_colour"></a>Edge
|
|
colour
|
|
<dd>Color of the vertical edge. Cannot be set to blank value.
|
|
<dt><a name="Line_number_margin"></a>Line
|
|
number margin
|
|
<dd>Controls the style of the line number margin. All
|
|
properties can be adjusted. This also controls the background of the
|
|
bookmark margin.
|
|
<dt><a name="Fold"></a>Fold
|
|
<dd>Controls the color of the fold indicators (not the margin
|
|
itself). Cannot be set to blank values.
|
|
<dt>Fold
|
|
Margin
|
|
<dd>Controls the colors of the fold margin background. Fore-
|
|
and background color alternate in a checkerboard pattern with each
|
|
pixel.
|
|
<dt><a name="White_space_symbol"></a>White
|
|
space symbol
|
|
<dd>Controls the foreground color of whitespace. This is
|
|
only visible if the drawing of whitespace characters is enabled or
|
|
any style that is applied to whitespace is set to underlined. Cannot
|
|
be set to blank value.
|
|
<dt><a name="Smart_Highlighting"></a>Smart
|
|
Highlighting;
|
|
<dd>When enabled, applies to all occurrences of the text beeing selected.
|
|
<dt><a name="Find_Mark_Style"></a>Mark style #
|
|
<dd># is between 1 and 5. This setting will define the highlighting used in conjunction with <span class="menu_item">Search-&gr;Mark All->Using #st style</span>
|
|
<dt><a name="Find_Mark_Style"></a>Find
|
|
Mark Style;
|
|
<dd>When <span class="checkbox">Style token found</span> is checked on the Find dialog, and the <span class="button">Find all</span> is executed, applies to all occurrences of matched pattern.
|
|
<dt><a name="Incremental_highlight_all"></a>Incremental
|
|
highlight all;
|
|
<dd>Applies when incremental search is in progress.
|
|
<dt><a name="Tags_match_highlighting"></a>Tags
|
|
match highlighting;
|
|
<dd>When enabled, applies to the tags that match.
|
|
<dt>Tags
|
|
attribute
|
|
<dd>Controls the background color used for said property.
|
|
Cannot be set to blank value.
|
|
<dt><a name="Active_tab_focused"></a>Active
|
|
tab focused
|
|
<dd>Determines the color used fore the line (if enabled)
|
|
drawn on the active tab of the active view. Cannot be set to blank
|
|
value.
|
|
<dt>Active
|
|
tab unfocused
|
|
<dd>Determines the color used fore the line (if
|
|
enabled) drawn on the active tab of the inactive view. Cannot be set
|
|
to blank value.
|
|
<dt>Active
|
|
tab text
|
|
<dd>Foreground color of the text for an active tab. Cannot
|
|
be set to blank value.
|
|
<dt>Inactive
|
|
tabs
|
|
<dd>Foreground color controls the color of the text of inactive
|
|
tabs. Background color controls the color that is used to fill the
|
|
tab with if inactive tabs, if drawing of inactive tabs is enabled.
|
|
</dl>
|
|
<p>
|
|
<a name="Search_result"><h4>Search
|
|
result</h4>
|
|
<p>Controls
|
|
the appearance of search results when shown in the <a href="Search%20window.html">search results window</a>:
|
|
<p>
|
|
<dl>
|
|
<dt>Default:
|
|
<dd>All text in the window which is not highlighted uing another style
|
|
<dt>Search Header
|
|
<dd>The topmost line, wich shows the search pattern, number of files and number of hits
|
|
<dt>File Header
|
|
<dd>Shows the file name and number of hits on that file
|
|
<dt>Line Number
|
|
<dd>Clickable line numbers which lead straight to the match
|
|
<dt>Hit Word
|
|
<dd>The match itself
|
|
<dt>Selected Line
|
|
<dd>Any selected text
|
|
<dt>Current line background colour
|
|
<dd>How this line shows. Right click the color to suppress this highlighting.
|
|
</dl>
|
|
<p>
|
|
<h4>Dos Style</h4>
|
|
<p>
|
|
The
|
|
Dos language uses a special font called MSLINEDRAW to enable
|
|
“box-art” for files written in the old Dos codepage. You can only
|
|
control the fore- and background color of the text (applied to all
|
|
the text). The font properties are derived from the default style
|
|
(with the exception of the font name, which is always MSLINEDRAW).
|
|
</body></html> |