https://github.com/joshraphael/npp-rascript
Notepad++ plugin to define RAScript grammar
https://github.com/joshraphael/npp-rascript
notepad-plus-plus notepad-plusplus-plugin npp npp-plugin rascript ratools
Last synced: 5 days ago
JSON representation
Notepad++ plugin to define RAScript grammar
- Host: GitHub
- URL: https://github.com/joshraphael/npp-rascript
- Owner: joshraphael
- License: mit
- Created: 2025-08-10T19:04:53.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-11-01T21:34:42.000Z (8 months ago)
- Last Synced: 2026-02-09T06:48:54.817Z (5 months ago)
- Topics: notepad-plus-plus, notepad-plusplus-plugin, npp, npp-plugin, rascript, ratools
- Language: C++
- Homepage:
- Size: 69.3 KB
- Stars: 1
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# npp-rascript
Notepad++ plugin to define RAScript grammar
[](https://github.com/joshraphael/npp-rascript/blob/main/LICENSE)
[](https://github.com/joshraphael/npp-rascript/actions/workflows/release.yaml)
[](https://github.com/joshraphael/npp-rascript/actions/workflows/test.yaml)
[](https://github.com/joshraphael/npp-rascript/tags)
[](https://github.com/joshraphael/npp-rascript/archive/main.zip)
## Setup
This plugin pulls the raw source code from [notepad-plus-plus](https://github.com/notepad-plus-plus/notepad-plus-plus) using git submodules. You can use the pre-defined make commands to build the DLL of the plugin and move it to your plugins folder. A provided [RAScript.vcxproj](RAScript.vcxproj) file is also included for those that use Windows to build this module.
**Note:** If building on Windows, be sure to generate the [files located in the templates folder](templates/) over to the `src/` folder before trying to build, you can use the provided [scripts/generate.ps1](scripts/generate.ps1) powershell script
## Debugging
The plugin has printing enabled when compiled in debug mode, use the `-DDEBUG` flag to enable printing. To view the logs you need to have a progam like [DebugView](https://learn.microsoft.com/en-us/sysinternals/downloads/debugview) running so it can capture the logging output and display it for you. The makefile has some pre-existing commands to help get started using `make debug`
### LSP
This language uses [rascript-language-server](https://github.com/joshraphael/rascript-language-server) to handle language hints and code tools, download the latest release and place the file somewhere you can remember on your computer (ex: `C:\Users\joshraphael\rascript-language-server_v0.0.1_win-x64.exe`)
Install the [NppLspClient](https://github.com/Ekopalypse/NppLspClient) plugin and place it in your plugins folder. When starting up Notepad++ after installation go to `Plugins > NppLspClient > Open configuration file` and paste in the following configuration for RAScript
```toml
[lspservers."rascript"]
mode = "io"
executable = 'C:\Users\joshraphael\rascript-language-server_v0.0.1_win-x64.exe'
auto_start_server = true
```
Save and restart your editor and your RAScripts should start getting code tools.
## Make Commands
| Title | Command | Parameters | Description |
|--------------------------|----------------------|------------|--------------------------------------------------------|
| Compile 64-bit Plugin | `make compile-x64` | None | Builds the x64 version of the plugin |
| Compile 32-bit Plugin | `make compile-Win32` | None | Builds the Win32 version of the plugin |
| Linux Dependencies | `make deps` | None | Download the Linux binaries to build a Windows C++ DLL |
| Start Debug Print Window | `make debug` | None | Start DebugView to view logs (under wine defaults) |
| Install | `make install` | None | Install the extension locally (under wine defaults) |
| Generate Linux files | `make generate` | None | Generate files based on Linux OS |
| Generate Windows files | `make generate-win` | None | Generate files based on Windows OS |