Readme - Gibraltar 1.0 Build 07
Last Updated: 9 Jan 2016
1. Main information
Gibraltar is an easy-to-configure installer for Windows, based on the .NET Framework. Gibraltar uses a script (install.cfg) to copy, register, and create shortcuts for programs.
2.Folders and files
The Blank Installer and Blank Installer (Sectioned) folders contain a "blank slate" installer with which to shape your installer. The only difference between the two is the Sectioned folder’s install.cfg contains a section template as well.
The Example App Installer and Example App Installer (Sectioned) folders provide an example installer to base your installer on. The only difference between the two is the Sectioned folder’s installer is sectioned, with examples of required and optional components.
Documentation contains annotated install.cfg and .lng files to help you get a hang of the different segments and values.
Notepad++ UDL Plugins contains two User Defined Language files that allow Notepad++ to recognise the syntax for the install.cfg and .lng files. A guide for installing the files can be found below.
Finally, the Self Extracting Archive Tutorial.rtf file contains a guide for packaging your setup files into a 7Zip Self Extracting Archive so that your users only need to worry about one file.
3. Installing Notepad++ UDL plugins
To install the Notepad++ User Defined Language files, follow these steps:
- Open Notepad++.
- Click Language on the menu bar, and select Define your language….
- From the dialog that appears, click on the Import… button.
- Navigate to the location where you extracted Gibraltar into, select the Notepad++ UDL Plugins folder, and double-click the GibraltarSetupFile.xml file.
- Click the Import… button again, navigate to the same folder, and double-click the Gibraltar Language File.xml file.
- Restart Notepad++.
When you click Language on the menu bar, you should now see Gibraltar Language File and Gibraltar Setup File on the menu bar.
When you want to edit install.cfg with syntax highlighting, all you need to do is open the file and select Language > Gibraltar Setup File.
When you want to edit a .lng file with syntax highlighting, all you need to do is open the file and select Language > Gibraltar Language File.
4. Known Issues
4.1 An error occurs when Gibraltar is run from a file share or server.
This only occurs if Gibraltar’s executable itself is run directly from a file share. If you run a self-extracting executable from a file share that is configured to launch Gibraltar after extracting it, the error will not occur, as Gibraltar will have been extracted to your Temporary Files folder.
Workaround: copy the Gibraltar folder to your hard drive and run it there.