You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- Update version listed in _index
- add SAS to list of built-in languages, including command-line `-l` options
- (update entire command-line `-l` list)
- Describe the new DirectWrite preferences
- Describe new `toolbarButtonsConf.xml`
closes#766
Copy file name to clipboardexpand all lines: content/_index.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ type: docs
6
6
Notepad++ User Manual
7
7
=======
8
8
9
-
This **Notepad++ User Manual** describes the Notepad++ application v8.x (currently up to v8.7.7).
9
+
This **Notepad++ User Manual** describes the Notepad++ application v8.x (currently up to v8.7.8).
10
10
11
11
The documentation is built collaboratively, and [your contribution is very welcome](https://github.com/notepad-plus-plus/npp-usermanual), following our [contribution guidelines](https://github.com/notepad-plus-plus/npp-usermanual/blob/master/CONTRIBUTION.md).
Copy file name to clipboardexpand all lines: content/docs/config-files.md
+15
Original file line number
Diff line number
Diff line change
@@ -347,6 +347,21 @@ If you previously had a v7.9-or-earlier style function list entry in `functionLi
347
347
5. Copy the `<parser...>...</parser>` section from the old `functionList.xml` to the `functionList\blah.xml`
348
348
- Please note that the `blah.xml` should _not_ contain a `<parsers>` section, _just_ the `<parser>` section. It will cause problems with the Function List if you wrap it in the `<parsers>...</parsers>` block. Make sure it ends up with the structure described above.
This configuration file allows you to override the visibility of any of the default or plugin toolbar icons. (New to v8.7.8)
353
+
354
+
The installation directory comes with a file called `toolbarButtonsConf_example.xml`: you can copy that to `%APPDATA%\Notepad++\toolbarButtonsConf.xml` (or other appropriate [Config Files Location](#configuration-files-location)). Once copied, edit `toolbarButtonsConf.xml`, edit it (see details below), and save, then restart Notepad++ to see the changes go into effect.
355
+
356
+
Set the `<Standard hideAll="...">` attribute to `yes` or `no` to decide whether or not to hide all of the built-in toolbar icons. Set `<Plugin hideAll="...">` attribute to `yes` or `no` to decide whether or not to hide all of the toolbar icons from all plugins.
357
+
358
+
You can change the `hide="no"` to `hide="yes"` (or vice versa) on any of the `<Button>` elements to toggle the visibility on specific toolbar buttons.
359
+
360
+
- For the `<Standard>` buttons, you can edit the `hide` or `name` attribute values, but **do not** edit the `index` or `id` values (which are required in order to properly map ). The `name` is based on the default English name for that command, but you can change that value if it helps you understand which command you are editing -- the `name="..."` value you set will _not_ affect the Notepad++ GUI at all.
361
+
- For the `<Plugin>` buttons, you can edit the `hide` value to be `yes` or `no` as appropriate; and the name, as with `<Standard>` buttons, is solely for your reference and never used by Notepad++.
362
+
- The _order_ of the `<Button>` tags corresponds exactly to the order that the plugin buttons are on the toolbar; there is no `index` or `id` attribute to help with mapping, and the `name` is ignored (and is just a useful reference for you).
363
+
- You must keep the `hide="yes"` entries lined up with the appropriate plugin buttons, as you install or upgrade your plugins, otherwise you will likely end up hiding the wrong buttons at some point.
364
+
350
365
## Toolbar Icon Customization: `toolbarIcons.xml`
351
366
352
367
This configuration file allows you to override the current toolbar icons. (New to v8.4.2) This allows you do define your own set of icons to use on the toolbar, and is useful (for example) if none of the five different icon sets available through **Settings > Preferences > General > Toolbar** are sufficient for your needs.
Copy file name to clipboardexpand all lines: content/docs/preferences.md
+22-14
Original file line number
Diff line number
Diff line change
@@ -561,16 +561,24 @@ A variety of settings that didn't fit elsewhere
561
561
-`Minimize / Close to`**system tray**: Place the Notepad++ icon on the system tray (instead of the task bar) when the Notepad++ application is minimized or closed. (New to v8.7.2.)
562
562
- The dropdown is new to v8.7.1. In previous versions, there was just a checkbox for `☐ Minimize to system tray`, and there was no `Close to` option available.
563
563
- For more details on the System Tray behavior, see [User Interface > System Tray](../user-interface/#system-tray).
564
+
***Direct Write rendering mode** dropdown
565
+
- DirectWrite will help in displaying characters even if the active font doesn't have a glyph.
566
+
- There are four options (new to v8.7.8):
567
+
-`GDI (most compatible)`: This version is "most compatible", but it's because it doesn't have any of the features available in the other DirectWrite choices.
568
+
-`DirectWrite (default)`: This is the "normal" DirectWrite mode, and matches `☑ Use DirectWrite` from v8.7.7 and earlier. This is the default for a new installation of Notepad++.
569
+
-`DirectWrite (retain frames)`: Use this if it works best for you, or if you've been asked to try "DirectWrite (retain frames)".
570
+
-`DirectWrite (draw to GDI DC)`: Use this if it works best for you, or if you've been asked to try "DirectWrite (draw to GDI DC)".
571
+
- If you have having trouble rendering certain glyphs for Unicode characters (like various Asian characters or emoji), or having trouble with other rendering issues, you may want to try each of the four settings, to see which works best for you.
572
+
- Before v8.7.8, this was a checkbox: `☐ Use DirectWrite (May improve rendering special characters, need to restart Notepad++)`: Enables DirectWrite drawing.
573
+
- Unchecked is equivalent to the v8.7.8 `GDI (most compatible)`; checked is equivalent to v8.7.8 `DirectWrite (default)`.
574
+
- The modified rendering may affect the clarity or readability of the characters for some users or systems (for some users, it increases readability; for others, it decreases readability).
575
+
- Before v8.6, DirectWrite was off by default (this option was not checkmarked). Since v8.6, DirectWrite has been on by default (this option is checkmarked).
576
+
- Some users notice performance issues when this is checkmarked; those affected may uncheckmark this option.
577
+
- Staring in v8.6.9, this option will be automatically disabled on Windows Server (which cannot use DirectWrite).
564
578
*`☐ Enable Notepad++ auto-updater`: Will automatically download updates from the official website, once the development team has decided it's time to push an update to users. If unchecked, you will have to manually download the installer from the official website yourself.
565
579
*`☐ Mute all sounds`: When unchecked, a sound will provide feedback on certain actions (example: a search action in [**Find / Replace dialog**](../searching/#dialog-based-searching) results in the text not being encountered); when checked, Notepad++ will remain silent for those actions.
566
580
*`☐ Autodetect character encoding`: When opening a new file, try to algorithmically determine what character encoding should be used. (Other Encoding settings can be found in the [New Document](#new-document) tab of the **Preferences** Dialog.)
567
581
*`☐ Show only filename in title bar`: Use just the file name (instead of the full path) of the active file in the Notepad++ title bar.
568
-
*`☐ Use DirectWrite (May improve rendering special characters, need to restart Notepad++)`: Enables DirectWrite drawing.
569
-
* DirectWrite will help in displaying characters even if the active font doesn't have a glyph.
570
-
* The modified rendering may affect the clarity or readability of the characters for some users or systems (for some users, it increases readability; for others, it decreases readability).
571
-
* Before v8.6, DirectWrite was off by default (this option was not checkmarked). Since v8.6, DirectWrite has been on by default (this option is checkmarked).
572
-
* Some users notice performance issues when this is checkmarked; those affected may uncheckmark this option.
573
-
* Staring in v8.6.9, this option will be automatically disabled on Windows Server (which cannot use DirectWrite).
574
582
*`☐ Enable Save All confirm dialog`: When the Save All command is issued, will pop up a dialog to confirm you really want to save all: **Yes** will Save All; **No** will not save all _this time_, but will ask again next time; **Always yes** will save all _and_ will uncheck this preference so that Save All will stop asking for confirmation in the future.
575
583
*`Session file ext.`: Enter a file extension (without the `.`). When you open a file with this extension (whether from Windows file associations, or from the Notepad++ **File > Open** or similar), Notepad++ will treat the file as a session file, and open the files from that session, rather than showing and editing the contents of the file. This will honor the [Multi-Instance](#multi-instance) settings.
576
584
*`Workspace file ext.`: Enter a file extension (without the `.`). When you open a file with this extension (whether from Windows file associations, or from the Notepad++ **File > Open** or similar), Notepad++ will treat the file as a workspace file, and open that workspace, rather than showing and editing the contents of the file. This will honor the [Multi-Instance](#multi-instance) settings.
@@ -581,7 +589,7 @@ The Style Configurator dialog has three regions: Select theme, language and styl
581
589
582
590
The "Select theme:" pulldown allows you to select which theme you want. [Themes](../themes/) are pre-defined sets of formatting rules, which often try to use a consistent color scheme between languages.
583
591
584
-
The "Language:" selection list lets you select whether you want to set the formatting for "Global Styles", or a specific [programming language](../programing-languages/) that you want to set the highlighting for. The "Style:" selection list lets you select which highlighting rule to edit for the given language.
592
+
The "Language:" pulldown (it was a selection list before v8.7.8) lets you select whether you want to set the formatting for "Global Styles", or a specific [programming language](../programing-languages/) that you want to set the highlighting for. The "Style:" selection list lets you select which highlighting rule to edit for the given language.
585
593
586
594
On all but "Language: Global Styles", there will also be a "Default ext." box, which is an un-editable list of the default file extensions associated with that Language; and the "User ext." box, where you can add a user-defined list of additional extensions (space separated, don't use the . in the extension), which says which other extensions you want to apply this language's formatting to. (Please note that any changes you make in the Style Configurator dialog box for a specific language only applies to that language and only applies to the selected [theme](../themes/): If you add a user-defined extension to a language in the `Default (stylers.xml)` theme, it will not affect the list of user-defined extensions for that language in any of the other themes.)
587
595
@@ -599,13 +607,6 @@ Unlike most of the other items listed in the "Languages" column, which are langu
599
607
600
608
Some of these styles apply to the background only, some apply to the foreground only, and some apply to both.
601
609
602
-
***Global override**[background and foreground] ⇒ This style has a series of checkboxes, which allow you to choose which attributes of the override-style will apply to everything; any that are checked will override even the per-language settings; any that are not checked will not use the global-override settings for that attribute.
603
-
- Global override takes precedence over any other color or font defined elsewhere, and will mask any per-language settings.
604
-
- Unless you want to turn off all syntax highlighting for all the programming languages, you likely don't want to use the `Global override` settings.
605
-
- Do not use this if all you are trying to do is set the color for Normal Text files (`.txt`): for those, use the `Default style` below.
606
-
- Starting in v8.7.1, there is a `What is Global override?` link which you can hover over to find out more about the global overrides; and new installations and new portable copies will have **Global override** at the _end_ of the list of **Global Styles** instead of the beginning, to better emphasize that **Global override** is more drastic than you usually need.
607
-
- If you upgrade from an older version of Notepad++ to v8.7.1 or newer, the **Global override** will not necessarily be moved to the end of the list.
608
-
- In such a case, or even if you are in an older version of Notepad++, you can edit [`%AppData%\Notepad++\stylers.xml` (or your active theme file)](../config-files/#highlighting-schemes-stylersxml) following the advice for [editing configuration files](../config-files/#editing-configuration-files), and move the `<WidgetStyle name="Global override" ... />` element from the top of the `<GlobalStyles>` section to the end of that section; after saving, exiting Notepad++, and restarting the app, **Global override** will be moved to the end of the list.
609
610
***Default style**[background and foreground] ⇒ This sets the base font and colors for all languages -- so any unstyled text will use these settings.
610
611
- As described previously, `Default Style` is used to set the color for Normal Text (`.txt` files, and anything else that isn't highlighted by a lexer).
611
612
- Also, as described a few paragraphs earlier, the highlighters for specific languages will inherit from this `Default Style` for things like font and possibly color, if there is no value defined for that language.
@@ -651,6 +652,13 @@ Some of these styles apply to the background only, some apply to the foreground
651
652
***Document map**[background and foreground] ⇒ The foreground color will be semi-transparently overlayed over the miniature version of text that's currently visible in the editor; the background color will be semi-transparently overlayed over the miniature version of the text that isn't currently visible in the editor (this style is new to v8.1.5).
652
653
***EOL Custom Color**[background and foreground] ⇒ Sets the colors for the `CR`, `LF`, and `CRLF` indicators, which are also influenced by the [**Settings > Preferences > Editing > EOL** settings](#editing-1). The "Go to settings" link will take you to [Preferences > Editing](#editing-1) so you can change **EOL** settings.
653
654
***Non-printing characters Custom Color**[background and foreground] ⇒ Sets the colors for the symbols for the Non-Printing Characters, which are also influenced by the [**Settings > Preferences > Editing > Non-Printing Characters** settings](#editing-1). The "Go to settings" link will take you to [Preferences > Editing](#editing-1) so you can change **Non-Printing Characters** settings. (Previously labled as **NPC Custom Color**.)
655
+
***Global override**[background and foreground] ⇒ This style has a series of checkboxes, which allow you to choose which attributes of the override-style will apply to everything; any that are checked will override even the per-language settings; any that are not checked will not use the global-override settings for that attribute.
656
+
- Global override takes precedence over any other color or font defined elsewhere, and will mask any per-language settings.
657
+
- Unless you want to turn off all syntax highlighting for all the programming languages, you likely don't want to use the `Global override` settings.
658
+
- Do not use this if all you are trying to do is set the color for Normal Text files (`.txt`): for those, use the `Default style` below.
659
+
- Starting in v8.7.1, there is a `What is Global override?` link which you can hover over to find out more about the global overrides; and new installations and new portable copies will have **Global override** at the _end_ of the list of **Global Styles** instead of the beginning, to better emphasize that **Global override** is more drastic than you usually need.
660
+
- If you upgrade from an older version of Notepad++ to v8.7.1 or newer, the **Global override** will not necessarily be moved to the end of the list.
661
+
- In such a case, or even if you are in an older version of Notepad++, you can edit [`%AppData%\Notepad++\stylers.xml` (or your active theme file)](../config-files/#highlighting-schemes-stylersxml) following the advice for [editing configuration files](../config-files/#editing-configuration-files), and move the `<WidgetStyle name="Global override" ... />` element from the top of the `<GlobalStyles>` section to the end of that section; after saving, exiting Notepad++, and restarting the app, **Global override** will be moved to the end of the list.
0 commit comments