Fierelier/notepad-plus-plus-legacy
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
2a299689b4
notepad-plus-plus-legacy/PowerEditor/misc/npp.help/HTML/Styler Configurator.html

237 lines
9.7 KiB
HTML
Raw Normal View History

[ADD] Add npp help binary and source files. Signed-off-by: Don HO <don.h@free.fr> git-svn-id: svn://svn.tuxfamily.org/svnroot/notepadplus/repository/trunk@504 f5eea248-9336-0410-98b8-ebc06183d4e3
2009-07-02 12:45:08 +00:00
<!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
&amp; 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:
[BUG_FIXED] Fix getting fonts problem under Chines/Korean/Japanese environment. [BUG_FIXED] Fix wrong File encoding auto-detection problem : binary file is detected as UTF-16 big-endian. [UPDATE] (Author : Christian Cuvier) Update NppHelp to v5.5. git-svn-id: svn://svn.tuxfamily.org/svnroot/notepadplus/repository/trunk@539 f5eea248-9336-0410-98b8-ebc06183d4e3
2009-09-19 21:43:11 +00:00
<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.
[ADD] Add npp help binary and source files. Signed-off-by: Don HO <don.h@free.fr> git-svn-id: svn://svn.tuxfamily.org/svnroot/notepadplus/repository/trunk@504 f5eea248-9336-0410-98b8-ebc06183d4e3
2009-07-02 12:45:08 +00:00
<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-&gt;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>
Reference in New Issue Copy Permalink