From bbc2dfe43abd217bb3502a3d62a1f6bdfcce8378 Mon Sep 17 00:00:00 2001 From: joostverburg Date: Sat, 26 Oct 2002 17:39:25 +0000 Subject: [PATCH] more info git-svn-id: https://svn.code.sf.net/p/nsis/code/NSIS/trunk@1473 212acab6-be3b-0410-9dea-997c60f758d6 --- Contrib/Modern UI/Readme.html | 124 +++++++++++++++++++++++++++------- 1 file changed, 100 insertions(+), 24 deletions(-) diff --git a/Contrib/Modern UI/Readme.html b/Contrib/Modern UI/Readme.html index b28998e0..f098501f 100644 --- a/Contrib/Modern UI/Readme.html +++ b/Contrib/Modern UI/Readme.html @@ -48,6 +48,15 @@ table background-color: #FFFFFF; } +.bold + { + font-size: 10pt; + font-family: Verdana, Arial, Helvetica, sans-serif; + font-weight: bold; + color: #303030; + background-color: #FFFFFF; + } + .header { font-size: 14pt; @@ -56,6 +65,15 @@ table color: #7A7272; background-color: #FFFFFF; } + +.subheader + { + font-size: 11pt; + font-family: Verdana, Arial, Helvetica, sans-serif; + font-weight: bold; + color: #303030; + background-color: #FFFFFF; + } .footer { @@ -68,6 +86,18 @@ table background-color: #FFFFFF; } +a:link, a:visited, a:active + { + color: #294F75; + text-decoration: none; + } + +a:hover + { + color: #182634; + text-decoration: none; + } + @@ -91,39 +121,84 @@ table like the wizards of recent Windows versions. This new interface also features new icons (designed by adni18) and a description area on the component select dialog.

-

To use this new UI for for installer, you need +

To use this new interface for for installer, you need to add some code to your NSIS script. Read this document for more info!

Requirements

NSIS 2 beta 0 (or later)

Screenshot

How to use

-

Have a look at the basic example script, Basic.nsi. - This is an example of how the use this interface for your NSIS - installer. The macro system also has multilanguage support, - see MultiLanguage.nsi for a multilanguage example. And if you - want to use Install Options (for extra pages in your installer, - like Start Menu folder selection etc.) have a look at InstallOptions.nsi, - which is an example of the new Install Options macro system.

-

If you have an installer with a lot of subsections - or long section names, use the modern2.exe UI, which has a larger - treeview for the component selection. To use modern2.exe, change - the first parameter of the MUI_INTERFACE macro.

-

Customize the interface

-

To change elements on the dialogs, modify modern.exe - or modern2.exe in the Contrib\UIs folder using a a resource - editor such as Resource - Hacker.

-

The 'Loading Setup' text on the splash screen which +

The Modern UI has a macro system, so most of the code + is already written for you!

+

Basic Macro System
+ For most scripts, you can use the basic macro system. The basic + macro system inserts all code and functions for you. For an example, + have a look at Basic.nsi.

+ To remove certain default NSIS pages (such as the License page), + remove a define before the language files (for example, remove + !define MUI_LICENSEPAGE), and remove the other instruction for + the page (for example, LicenseData).

+

Advanced Macro System, Install Options
+ If you want put your code in certain NSIS functions or want to + use custom installer pages, use the Advanced Macro System. + The code will still be inserted using the macro's, but + you can customize a lot of things, add your own code or + add new pages.
+ Using the Install Options macro's, it's also very easy to use + custom pages in your installer.
+ Have a look at + InstallOptions.nsi for an example of the Install Options + and the Advanced Macro System.

+

Multilanguage installers
+ The Modern UI has full multilanguage support and also uses + language files which can be translated easily. You can find the + language files in the Contrib\Modern UI\Language files folder. + There are already a lot of translations available, but you can + also make your own translation.
+ See MultiLanguage.nsi + for a multilanguage example using the Basic Macro System. +

The interface

+

Modern.exe and modern2.exe
+ There are two different version of the interface. + Modern.exe contains the dialogs of the standard interface. + If you have an installer with a lot of subsections + or long section names, use modern2.exe, which has a different + component-selection page.

+

Change interface settings
+ You can change the settings of the interface + by usings defines before you insert the MUI_INTERFACE macro.
+ Example: !define MUI_UI "${NSISDIR}\Contrib\UIs\modern2.exe"
+ If you don't define a setting, the default will be used.

+ The following settings are available: (default)
+ MUI_ICON (${NSISDIR}\Contrib\Icons\modern-install.ico) + - The icon of the instaleller
+ MUI_UNICON (${NSISDIR}\Contrib\Icons\modern-uninstall.ico) + - The icon of the uninstaleller
+ MUI_CHECKBITMAP (${NSISDIR}\Contrib\Icons\modern.bmp) + - The bitmap with images for the checks of the + component select treeview.
+ MUI_UI (${NSISDIR}\Contrib\UIs\modern.exe) + - The interface file with the dialog resources
+ MUI_FONT (Tahoma) + - The font of the installer and uninstaller
+ MUI_INSTALLCOLORS (/windows) + - The hexadecimal colors of the details screen ("foreground" "background")
+ MUI_PROGRESSBAR (smooth) + - The style of the progress bar ("colored" to use the MUI_INSTALLCOLORS or "" + for a old-school windows look)

+

Customize the dialogs
+ To change elements on the dialogs, modify modern.exe or modern2.exe in the + Contrib\UIs folder using a a resource editor such as + Resource Hacker.

+ The 'Loading Setup' text on the splash screen which is being displayed when the installer is starting (Verifying installer, Unpacking data when using COMPRESS_WHOLE) cannot be changed by the script, because the installer is not started yet when this dialog is being displayed. If you want to change - this text, modify dialog 111 of modern(2).exe.

-

To 'verifying installer' and 'unpacking data' - texts are defined in the language header file of the NSIS exehead - (Source\exehead\lang.h). To change them, you need to edit this - file and recompile NSIS.

+ this text, modify dialog 111 of modern(2).exe.
+ The 'verifying installer' and 'unpacking data' texts are defined in + the language header file of the NSIS exehead (Source\exehead\lang.h). + To change them, you need to edit this file and recompile NSIS.

Version history

  • 1.21 - September 30, 2002