Getting Started

Rusark Inc

Getting Started

This page serves as a frequently updated guide to installing this utility, as well as providing download links and instructions on the various components this utility uses. Got here by accident? Go back to the Home Page.

IMPORTANT! For a hands-free installation of all the compilers, Notepad++ and NCandE altogether, go to the Downloads page and select the latest Extra installer. Be sure to apply the Standalone installer afterwards if the Standalone version is more recent than the Extra installer.

Standalone Installer - The Standalone installer installs and integrates NCandE with an existing Notepad++ installation automatically. It also automatically upgrades any older versions of NCandE on the system. Go to the Downloads page and get it now!

NOTE: The Standalone installer and Portable zip will work best if the rest of the components/compilers have been installed as described below.

System Requirements

To get this utility to work properly, you must meet the necessary System Requirements, as well as have installed the necessary compilers.

System

Requirements for your system are as follows:

  • Windows XP/Vista/7
  • 32 or 64 bit (not 128 bit!)
  • 512 MB of RAM
  • Up to 650 MB of free Hard Drive space*

*NCandE itself is less than 150 KB, however the compilers and other components which are downloaded from the web may add up to 650 MB. Don't worry though - support for many more languages will be added before Hard Drive space requirements will need to increase significantly. Additionally, only languages that are needed should be downloaded - NCandE will inform you that you are missing the necessary compilers if you try to compile code for which you do not have the compilers for.

Programs

The following program(s) must be installed and configured:

Only one of the following languages needs to be installed:

The next section will explain how to configure and download the latest and greatest versions of these components.

Configuration

The configuration for the necessary components follows. Last updated on 2/15/2013.

Notepad++

  • Version 6.3
    • Visit this page.
    • Click the large green "Download" button, save the file, and run it.
    • Install all settings at default values.

JDK - Java SE Development Kit

  • Version 7 update 13
    • Visit this page and click on the link as shown in the image below.
      Java SE JDK 7u13
    • Select the 32-bit Windows installation (if you have a 64-bit system, then select the 64-bit link)
      32-bit Windows Installation
    • Install into the default directory.
      • There are various possible locations where the default JDK directory could be installed. Most likely, it will either be installed in C:\Program Files (x86)\Java\jdk1.7.0_06\ (if you have a 64-bit system) or in C:\Program Files\Java\jdk1.7.0_06\ if you have a 32-bit system, or used the 64-bit installer.
      • NCandE automatically detects the location of your Java installation - make sure you only have one JDK installation, though! Otherwise, the older JDK compiler will be utilized.

Python for Windows

  • Version 2.7.3 or higher (version 3.x recommended)
    • Visit this page and click on version 2.7.3 for Python for Windows.
    • Alternatively, you may click on the latest 3.x version of Python.
    • Save the installer, and run it.
    • Make sure the "Install for all users" option is selected. Click Next at the following screen:
      Welcome Screen
    • Keep all settings as default, and click Next.
      Installation Directory
    • Leave settings at default, and click Next.
      Customization Screen
    • Let it install its files. Do NOT click "Cancel".
      Installing Progress
      Installation Completed
    • Don't worry about which version of Python to install - NCandE automatically detects the location of your Python installation. Just make sure you only have one version installed! Otherwise, the older Python compiler will be utilized.

Lua for Windows

  • Latest Version
    • Visit this page and click on the latest version (Version 5.1.4-46 as of 2/13/13)
    • Save the installer.
    • Click Next at the following screen after running the installer:
      Welcome Screen
    • Accept the License agreement, and click on Next.
      License Agreement
    • Leave the default directory, and click on Next.
      Installation Directory
    • IMPORTANT! Disable the script editor. Ensure everything else is enabled, and click Next.
      Customization Screen
    • Leave the default name, and click on Next.
      Name Screen
    • Deselect all options, and click on Next.
      Shortcut Screen
    • Let it install its files. Do NOT click "Cancel".
      Installing Progress
    • Deselect all options, and click Finish. No more configuration for Lua!
      Installation Completed

MinGW for Windows

  • Latest Version
    • Visit this page and click on the upmost link (labelled "mingw-get-inst-20120426" as of 08/30/12)
      Installation Directory
    • Select the executable file, labelled "mingw-get-inst-20120426.exe"
      File Directory
    • Download the installer, and run it.
    • Click Next until you reach this screen. Select the first option, then click Next.
      Repository Selection
    • When you reach the component selection screen, ensure that at the very least the C++ compiler is select.
      Component Selection
      • Future versions of NCandE will eventually be able to compile and execute all languages included in the MinGW installation, so selecting all of them will not cause issues; rather, it will enhance the capabilities of Notepad++ as NCandE develops further.
    • Finish the installation with the default options on each screen. No more configuration for MinGW!

The next section will explain how to apply NCandE to Notepad++.

Install NCandE

Finally, we're installing the final component which make all the others work inside Notepad++

  • Visit the Downloads page and download the latest Standalone installer of NCandE. It will automatically integrate NCandE into Notepad++.
  • Alternatively, you can download the latest Portable version of NCandE, and follow the instructions below.

  • In your Notepad++ installation directory, right-click NCandE 2.0 (Portable).zip and select extract.

  • Rename the extracted folder to "NCandE"
  • Open this folder, and run the configure tool inside
  • Select Auto-Configure
  • You can verify the paths by navigating the menu and viewing all settings for both executing and compiling
  • Start up Notepad++
  • Click on the "Run" menu, and select the "Run..." option. You may also press the F5 key instead
  • Depending on whether python is installed on the system, in the textfield, paste this exact code to connect the configure tool:

$(NPP_DIRECTORY)\NCandE\configure.bat

== OR ==

$(NPP_DIRECTORY)\NCandE\configure.pyw

  • Click on the "Save" button
  • Give your command a name to indicate that the configuration tool is opening. For example, "Configure NCandE 2.0"
  • Click "OK," then close the "Run..." screen
  • Reopen the "Run..." screen by following the steps above, or by pressing F5
  • In the textfield, paste this exact code to compile the file:

$(NPP_DIRECTORY)\NCandE\compile.bat "$(EXT_PART)" "$(NAME_PART)" "$(FILE_NAME)" "$(CURRENT_DIRECTORY)" "$(FULL_CURRENT_PATH)"

  • Click on the "Save" button
  • Give your command a name to indicate that the file is compiling. For example, "Build"
  • Select a memorable shortcut to use this command. For example, CTRL + SHIFT + B
  • Click "OK," then close the "Run..." screen
  • Reopen the "Run..." screen by following the steps above, or by pressing F5
  • In the textfield, paste this exact code to execute the compiled file:

$(NPP_DIRECTORY)\NCandE\execute.bat "$(EXT_PART)" "$(NAME_PART)" "$(FILE_NAME)" "$(CURRENT_DIRECTORY)" "$(FULL_CURRENT_PATH)"

  • Click on the "Save" button
  • Give your command a name to indicate that the file is executing. For example, "Execute"
  • Select a memorable shortcut to use this command. For example, CTRL + SHIFT + E
  • Click "OK," then close the "Run..." screen

You are done! If everything is set up correctly, you should now be able to compile and execute all supported file types.

Example

NOTE: If the language you are attempting to compile is not natively supported, then feel free to add it to NCandE by utilizing the "Add a language" option in the Configuration Tool. If you think the language deserves native support, make a language request on the Discussion page.


Related

Wiki: Home
Wiki: Images for Guides

Get latest updates about Open Source Projects, Conferences and News.

Sign up for the SourceForge newsletter:

JavaScript is required for this form.





No, thanks