Skip to content

Commit af4bb8a

Browse files
authored
improve the toolbarIcons description
- Add the link to the v8.4.2 release page with the legacy icon set instructions. - Add the "troubleshooting" based on my experiment in [this forum discussion](https://community.notepad-plus-plus.org/topic/23099/how-do-i-customize-the-toolbar/2) where the 32x32 will be "pixelated" if you first load the large custom icons with a "small" icon option selected, then switch to "large"
1 parent dfdca66 commit af4bb8a

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

content/docs/config-files.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -312,8 +312,10 @@ Aside from the `toolbarIcons.xml` file, you need to create icons. You will popu
312312
4. Go into `toolbarIcons\` folder and create a new folder with the exact name of the icon set name you provided in `icoFolderName`, for example `[toolbarIcons.xml's folder]\toolbarIcons\myAwesomeIcons\`.
313313
5. Put all your customized icons into `[toolbarIcons.xml's folder]\toolbarIcons\myAwesomeIcons\`.
314314
6. Now it is the magic moment: Relaunch Notepad++ and you'll see your icon set instead of the default icons.
315-
- This overrides the icons for any of the **Settings > Preferences > General > Toolbar** icon-set selections
315+
- This overrides the icons for any of the **Settings > Preferences > General > Toolbar** icon-set selections.
316316
- If you have **Settings > Preferences > General > Toolbar** set to any of the three "small" choices, it will scale the icon to 16x16; if you use one of the two "large" choices, it will scale to 32x32. So if you are going to use a "large" icon set, you should make sure the icons are defined as 32x32.
317+
- The [v8.4.2 release page](https://notepad-plus-plus.org/news/v842-released/) allows you to download a bundle that contains the legacy 32x32 icon set along with the necessary `toolbarIcons.xml`; unzip that bundle into the directory described on that page (equivalent to the main configuration folder [Note 2]), restart Notepad++, and you will have the old 32x32 "standard (large)" icons back.
318+
- Troubleshooting: if you started Notepad++ with one of the "small" choices selected but have 32x32 icons in your custom icons, it will scale them to 16x16, which is fine for small modes; but if you switch to a "large" option, it might scale the 16x16 back to 32x32 rather than using the true-32x32 from the icon file, which makes for a pixelated ("klunky") large icon: if this happens, leave it with "large" selected, then exit Notepad++ completely and restart: on the subsequent starts, it will use the full 32x32 resolution.
317319

318320
Note:
319321
1. The content of `toolbarIcons.xml` is following:

0 commit comments

Comments
 (0)