https://github.com/notepad-plus-plus/nppthemes
Notepad++ Themes Collection
https://github.com/notepad-plus-plus/nppthemes
Last synced: 6 months ago
JSON representation
Notepad++ Themes Collection
- Host: GitHub
- URL: https://github.com/notepad-plus-plus/nppthemes
- Owner: notepad-plus-plus
- License: gpl-3.0
- Created: 2022-09-02T01:52:28.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-03-17T21:46:52.000Z (about 1 year ago)
- Last Synced: 2025-03-30T17:11:09.309Z (about 1 year ago)
- Language: Python
- Homepage:
- Size: 128 KB
- Stars: 82
- Watchers: 9
- Forks: 20
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Notepad++ Themes Collection
Notepad++ ships with around 20 [themes](https://npp-user-manual.org/docs/themes/) available to define the formatting rules for normal text and syntax highlighting. However, users can create their own themes, or get themes from somewhere else.
To facilitate sharing of user-created themes, the Notepad++ Developers have create this Themes Collection to house the XML files for the user-created themes.
## Using a Theme from this Collection
For now, you have to manually download and install a Theme from this Collection.
1. Download the XML file from the [`themes/`](./themes) folder of this Collection.
- From the [`themes/`](./themes) folder, click on the name of the theme's XML file.
- From the file's page, click on either the "Raw" button (which will take you to a page where you can copy/paste the raw contents), or even easier, just click on the copy raw contents button, which will immediately place the raw contents in your clipboard for pasting.
- Do _not_ just right click to try to download the file from the [directory listing on GitHub](./themes), as either of those right-click actions will download the GitHub web page for that file (which is _not_ the Theme's XML file and will _not_ work).
2. Import the file by placing the file in your `themes\` folder
- For most installations, the easiest place to put a new theme is in the `%AppData%\Notepad++\themes\` folder.
- If you have multiple users on the same computer, and want the theme available to all users on that machine, put it into `C:\Program Files\Notepad++\themes\` (or `C:\Program Files (x86)\Notepad++\themes` for a 32-bit Notepad++)
- For portable installations, instead put the themes in the `themes\` sub-folder under the directory where your portable `notepad++.exe` resides
3. Restart Notepad++
4. Select the theme from the [Preferences > Style Configurator](https://npp-user-manual.org/docs/preferences/#style-configurator) dialog
It is also possible to use the menu entry [Settings > Import > Import Style Themes...](https://npp-user-manual.org/docs/preferences/#other-settings-menu-entries) and select a Theme XML file from your computer instead of steps 2-3 above; Notepad++ will then install it in the right place.
## Submitting your Theme to the Collection
### Theme Best Practices
- Include a comment block near the top of the theme, listing things including
- Name of the Theme
- Author (you)
- Date of creation or last modification
- Any other credits or acknowledgements or notes you'd like the user to see when downloading
- When possible, make use of "background inheritance" (set `colorStyle="1"` in the raw XML or right click on the **Background colour** input in the Style Configurator) so that styles for various language markups inherit the **Default Style**'s background colour -- this will mean that a user of your theme only has to change one entry to get the background to change on hundreds of style entries. The [99er theme](https://github.com/notepad-plus-plus/nppThemes/blob/main/themes/99er.xml) includes the steps used to do that in a bulk search-and-replace to the raw XML.
See the [default styler](https://github.com/notepad-plus-plus/notepad-plus-plus/blob/master/PowerEditor/src/stylers.model.xml) and the [themes included with Notepad++ distributions](https://github.com/notepad-plus-plus/notepad-plus-plus/tree/master/PowerEditor/installer/themes) for good examples of Themes.
### Submission Process
You can submit your Theme file(s) into this repo if you would like to share it with the general public.
To do so, you may either:
- Create a Pull Request: create your own fork of this repository; add the new theme XML file to the themes folder your fork; and finally, create the Pull Request (PR).
- or Create a new Issue: go to the [issues](../../issues) page for this repository, click on the **New issue** button, give it a meaningful issue name, and attach the theme's .XML file to the issue, then submit the issue.
The Theme Collection team will validate your theme (using manual review and/or automated tools), and will decide whether or not to accept your submission. Following the Best Practices (above) will help ensure your submitted Theme is added into the Collection.
### HOW TO Submit Pull Request
Since many contributors are not GitHub experts, we have added in this section to make it easier for you to submit your file in a Pull Request (PR)
0. Create a GitHub account
- Without an account, you cannot submit a PR
2. Create a **fork** of the Themes Collection
- Click the **Fork** label/icon from the [main Notepad++ Themes Collection page](https://github.com/notepad-plus-plus/nppThemes)
- 
- If you already have a fork, use **Sync Fork > Update Branch** to make sure your fork is up-to-date with the main Collection
3. Make your changes:
- Upload the Theme's XML file to the `themes/` folder _in your fork_
4. Create a PR from your fork
- from your fork's master branch, after you've made the changes above,
- click the down arrow on **Contribute**
- select **Open Pull Request**
- fill out your description for the PR, and submit the PR
## Theme Maintenance
All Themes in the Themes Collection are maintained by the Notepad++ user base, purely on a volunteer basis.
The original author of a given Theme is encouraged to return and make updates to the themes as necessary -- for example, when Notepad++ adds new languages to the available lexers, it would be helpful if the original Theme author would come back and add in the definitions for those languages with the colors of their Theme.
However, as this is a user-based Collection, and all the Themes are released as open source, they can be modified by other users... so if you see that your favorite Theme from this Collection is missing one or more lexer languages, feel free to add those languages into the theme, and create a PR (or attach the updated XML to an issue) to update that Theme with the new languages, so that the Themes in this Collection are kept as up-to-date with Notepad++ as possible.
The administrators of the Themes Collection are _not_ responsible for maintaining the individual themes. They are here to facilitate adding Themes to the collection, not to do the work of creating and maintaining Themes. Do not expect to create an issue of "fix the colors in Theme XXX" or "add language ZZZ to all the themes"; such issues are likely to be rejected.
## Automatic License
Any Theme uploaded to the Collection is automatically released under the terms of the GPL v3, as put forth in the Collection's [LICENSE](./LICENSE) file. If you do not want to publish your Theme under that license, do not submit it to this Collection.