'+---------------+---------------------------------------------------+
'| ###### ###### | .--. . .-. |
'| ## ## ## # | | )| ( ) o |
'| ## ## ## | |--' |--. .-. `-. . .-...--.--. .-. |
'| ###### ## | | \ | |( )( ) | ( || | |( ) |
'| ## ## | ' `' `-`-' `-'-' `-`-`|' ' `-`-'`- |
'| ## ## # | ._.' |
'| ## ###### | Sources & Documents placed in the Public Domain. |
'+---------------+---------------------------------------------------+
'| |
'| === NppThemesQB-Info.html === |
'| |
'| == General informations about my Notepad++ themes and the user |
'| == defined language (UDL) definition for QB64. |
'| |
'+-------------------------------------------------------------------+
'| Done by RhoSigma, R.Heyder, provided AS IS, use at your own risk. |
'| Find me in the QB64 Forum or mail to support@rhosigma-cw.net for |
'| any questions or suggestions. Thanx for your interest in my work. |
'+-------------------------------------------------------------------+
Here you find my personal themes as well as my QB64/QBasic user defined language (UDL) definition for Notepad++. Two different flavors are available, bright and dark.
All provided files are based on the Notepad++ release 8.1.1 with the following changes:
- changed GlobalStyles to create my theme's look and feel
- changed LexerType searchResult to match global look
- changed LexerType C, C++ and C# for my personal taste
- all other stuff is in its original state, except that colors are changed to my theme's color scheme using a best match algorithm
The QBasic/QB64 UDL does cover all keywords found in the Wiki, ie. all QBasic, QB64 and OpenGL keywords. Additionally you get all SUB/FUNCTION names defined/used in my Libraries Collection (QB64Library.7z) and the GuiTools Framework (QB64GuiTools.7z), which you can download here. However, for the purists among you there are also files with the QBasic/QB64 keywords only.
For an overview of my keyword and color associations see the Bright Theme and/or Dark Theme specification. Here you should already get an idea, which one will fit better for your display setup and visual impression. Of course, feel free to adjust the themes and/or the UDLs to fit your personal taste.
Note that the entire UDL is set to Case sensitive, hence only fully capitalized QBasic/QB64 keywords are syntax highlighted and the OpenGL words as they appear in the Wiki, all other (3rd party) keywords as is. If you'd rather like it Case insensitive, so that you can write in all lower case or even the new Camel case used in the QB64 IDE, then you can simply tick the Ignore case box in Notepad++ its UDL dialog. The only backdraw of it is that any words or variable names etc. with the syllable "rem" in it will result in highlighting the remaining line as comment. If you don't use REM, but only the apostrophe to comment, then you can simply remove the REM keyword from the Comment & Number tab in the UDL dialog to avoid this faulty effect.
Aside of the various QB64 UDL files you'll also find replacements for N++'s preinstalled Markdown UDL for both, the bright and dark themes respectively.
As an extra feature I've also modified the functionList to allow Notepad++ to scan your sources for any FUNCTION/SUB definitions and display these in the Function List panel.
Unfortunately, automatic code folding did turn out not reliable enough for
the requirements of the QBasic/QB64 Basic language, so I removed it
entirely. The Folder in Comment feature of Notepad++ is activated instead
and can be used to make your own manual folds, which are also listed in
the Function List panel. Simply write '~~~ to open a fold and '~~~~~ to
close it again. For better reference in the Function List panel you can also
add an descriptive label after the fold open marker, eg.
- '~~~ Main Loop
- code here
- '~~~~~
Start Notepad++, then use the menu (Settings > Import > Import style theme(s)) to import the files RhoSigma Bright.xml and/or RhoSigma Dark.xml from the provided copy-files\themes folder. In alternative you can just manually copy the files over into the respective folder of your N++ installation (see also Online Manual > Themes).
Select menu (Settings > Style Configurator...) and select one of the just imported themes, then click the Save & Close button.
Open the UDL dialog, either by clicking on its ToolBar icon or select it from menu (Language > Define your language...). Now click the Import button in the opened UDL dialog and select either the QB64+Lib&GuiTools UDL Bright.xml file or QB64+Lib&GuiTools UDL Dark.xml (depending on the chosen theme) from the provided copy-files\userDefineLangs folder. Close the UDL dialog and also Notepad++. In alternative you can just manually copy the file over into the respective folder of your N++ installation (see also Online Manual > UDLs).
NOTE: If you just want the QBasic/QB64 and OpenGL keywords without my additional Library/GuiTools keywords, then take the files QB64 only UDL Bright.xml or QB64 only UDL Dark.xml instead.
It may also be a good idea to remove the preinstalled Markdown UDL, which comes with Notepad++ and rather import either of my replacements (bright or dark, according to your chosen theme).
Unfortunately there's no import facility for the functionList, so just manually copy the contents of the copy-files\functionList folder over into the respective folder of your N++ installation, simply overwrite old files (see also Online Manual > FunctionList).
Now open any QBasic/QB64 source with Notepad++ and try the new language definition. It should be selected automatically for .bas, .bi and .bm files, but you could also select it manually from the Language menu. You may also add more extensions for automatic recognition in the UDL dialog.
See also Ide-Shortcuts.html for informations about how to implement the QB64 IDE/Compiler into Notepad++ its Run menu for a maximum of working pleasure and comfort.
See also Register-Icons.html for informations about how to setup default icons for your QB64 files and add Notepad++ as its default open tool.