more info

git-svn-id: https://svn.code.sf.net/p/nsis/code/NSIS/trunk@1473 212acab6-be3b-0410-9dea-997c60f758d6
This commit is contained in:
joostverburg 2002-10-26 17:39:25 +00:00
parent 0e2536d6e9
commit bbc2dfe43a

View file

@ -48,6 +48,15 @@ table
background-color: #FFFFFF; background-color: #FFFFFF;
} }
.bold
{
font-size: 10pt;
font-family: Verdana, Arial, Helvetica, sans-serif;
font-weight: bold;
color: #303030;
background-color: #FFFFFF;
}
.header .header
{ {
font-size: 14pt; font-size: 14pt;
@ -56,6 +65,15 @@ table
color: #7A7272; color: #7A7272;
background-color: #FFFFFF; background-color: #FFFFFF;
} }
.subheader
{
font-size: 11pt;
font-family: Verdana, Arial, Helvetica, sans-serif;
font-weight: bold;
color: #303030;
background-color: #FFFFFF;
}
.footer .footer
{ {
@ -68,6 +86,18 @@ table
background-color: #FFFFFF; background-color: #FFFFFF;
} }
a:link, a:visited, a:active
{
color: #294F75;
text-decoration: none;
}
a:hover
{
color: #182634;
text-decoration: none;
}
</style> </style>
</head> </head>
@ -91,39 +121,84 @@ table
like the wizards of recent Windows versions. This new interface like the wizards of recent Windows versions. This new interface
also features new icons (designed by adni18) and a description also features new icons (designed by adni18) and a description
area on the component select dialog.</p> area on the component select dialog.</p>
<p class="text">To use this new UI for for installer, you need <p class="text">To use this new interface for for installer, you need
to add some code to your NSIS script. Read this document for more info!</p> to add some code to your NSIS script. Read this document for more info!</p>
<p class="header">Requirements</p> <p class="header">Requirements</p>
<p class="text"><a href="http://nsis.sourceforge.net">NSIS 2 beta 0 (or later)</a></p> <p class="text"><a href="http://nsis.sourceforge.net">NSIS 2 beta 0 (or later)</a></p>
<p class="header">Screenshot</p> <p class="header">Screenshot</p>
<p class="text"><img src="Screenshot.png" width="504" height="391" alt=""></p> <p class="text"><img src="Screenshot.png" width="504" height="391" alt=""></p>
<p class="header">How to use</p> <p class="header">How to use</p>
<p class="text">Have a look at the basic example script, Basic.nsi. <p class="text">The Modern UI has a macro system, so most of the code
This is an example of how the use this interface for your NSIS is already written for you!</p>
installer. The macro system also has multilanguage support, <p class="text"><span class="subheader">Basic Macro System</span><br>
see MultiLanguage.nsi for a multilanguage example. And if you For most scripts, you can use the basic macro system. The basic
want to use Install Options (for extra pages in your installer, macro system inserts all code and functions for you. For an example,
like Start Menu folder selection etc.) have a look at InstallOptions.nsi, have a look at <a href="..\..\Examples\Modern UI\Basic.nsi">Basic.nsi</a>.<br><br>
which is an example of the new Install Options macro system.</p> To remove certain default NSIS pages (such as the License page),
<p class="text">If you have an installer with a lot of subsections remove a define before the language files (for example, remove
or long section names, use the modern2.exe UI, which has a larger !define MUI_LICENSEPAGE), and remove the other instruction for
treeview for the component selection. To use modern2.exe, change the page (for example, LicenseData).</p>
the first parameter of the MUI_INTERFACE macro.</p> <p class="text"><span class="subheader">Advanced Macro System, Install Options</span><br>
<p class="header">Customize the interface</p> If you want put your code in certain NSIS functions or want to
<p class="text">To change elements on the dialogs, modify modern.exe use custom installer pages, use the Advanced Macro System.
or modern2.exe in the Contrib\UIs folder using a a resource The code will still be inserted using the macro's, but
editor such as <a href="http://www.users.on.net/johnson/resourcehacker/">Resource you can customize a lot of things, add your own code or
Hacker</a>.</p> add new pages.<br>
<p class="text">The 'Loading Setup' text on the splash screen which Using the Install Options macro's, it's also very easy to use
custom pages in your installer.<br>
Have a look at <a href="..\..\Examples\Modern UI\InstallOptions.nsi">
InstallOptions.nsi</a> for an example of the Install Options
and the Advanced Macro System.</p>
<p class="text"><span class="subheader">Multilanguage installers</span><br>
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.<br>
See <a href="..\..\Examples\Modern UI\MultiLanguage.nsi">MultiLanguage.nsi</a>
for a multilanguage example using the Basic Macro System.
<p class="header">The interface</p>
<p class="text"><span class="subheader">Modern.exe and modern2.exe</span><br>
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.</p>
<p class="text"><span class="subheader">Change interface settings</span><br>
You can change the settings of the interface
by usings defines before you insert the MUI_INTERFACE macro.<br>
Example: !define MUI_UI "${NSISDIR}\Contrib\UIs\modern2.exe"<br>
If you don't define a setting, the default will be used.<br><br>
The following settings are available: <i>(default)</i><br>
<span class="bold">MUI_ICON</span> <i>(${NSISDIR}\Contrib\Icons\modern-install.ico)</i>
- The icon of the instaleller<br>
<span class="bold">MUI_UNICON</span> <i>(${NSISDIR}\Contrib\Icons\modern-uninstall.ico)</i>
- The icon of the uninstaleller<br>
<span class="bold">MUI_CHECKBITMAP</span> <i>(${NSISDIR}\Contrib\Icons\modern.bmp)</i>
- The bitmap with images for the checks of the
component select treeview.<br>
<span class="bold">MUI_UI</span> <i>(${NSISDIR}\Contrib\UIs\modern.exe)</i>
- The interface file with the dialog resources<br>
<span class="bold">MUI_FONT</span> <i>(Tahoma)</i>
- The font of the installer and uninstaller<br>
<span class="bold">MUI_INSTALLCOLORS</span> <i>(/windows)</i>
- The hexadecimal colors of the details screen ("foreground" "background")<br>
<span class="bold">MUI_PROGRESSBAR</span> <i>(smooth)</i>
- The style of the progress bar ("colored" to use the MUI_INSTALLCOLORS or ""
for a old-school windows look)</p>
<p class="text"><span class="subheader">Customize the dialogs</span><br>
To change elements on the dialogs, modify modern.exe or modern2.exe in the
Contrib\UIs folder using a a resource editor such as
<a href="http://www.users.on.net/johnson/resourcehacker/">Resource Hacker</a>.<br><br>
The 'Loading Setup' text on the splash screen which
is being displayed when the installer is starting (Verifying is being displayed when the installer is starting (Verifying
installer, Unpacking data when using COMPRESS_WHOLE) cannot installer, Unpacking data when using COMPRESS_WHOLE) cannot
be changed by the script, because the installer is not started be changed by the script, because the installer is not started
yet when this dialog is being displayed. If you want to change yet when this dialog is being displayed. If you want to change
this text, modify dialog 111 of modern(2).exe.</p> this text, modify dialog 111 of modern(2).exe.<br>
<p class="text">To 'verifying installer' and 'unpacking data' The 'verifying installer' and 'unpacking data' texts are defined in
texts are defined in the language header file of the NSIS exehead the language header file of the NSIS exehead (Source\exehead\lang.h).
(Source\exehead\lang.h). To change them, you need to edit this To change them, you need to edit this file and recompile NSIS.</p>
file and recompile NSIS.</p>
<p class="header">Version history</p> <p class="header">Version history</p>
<ul> <ul>
<li class="text">1.3 - October 26, 2002 <li class="text">1.3 - October 26, 2002
@ -134,7 +209,8 @@ table
<li>Small bugfixes & typo corrections <li>Small bugfixes & typo corrections
<li>SetPage function should be set using defines <li>SetPage function should be set using defines
<li>Different NextPage/PrevPage/FinishHeader macro's for install/uninstall <li>Different NextPage/PrevPage/FinishHeader macro's for install/uninstall
<li>Icon/UI paths can be set using defines (no MUI_INTERFACE_ABSOLUTEPATH anymore) <li>Interface settings can be definend (for example, MUI_ICON), no parameters
for MUI_INTERFACE anymore
</ul> </ul>
<li class="text">1.21 - September 30, 2002 <li class="text">1.21 - September 30, 2002
<ul> <ul>