This chapter describes the syntax rules for the configuration files.
The main configuration file shell.nss (or shell.shl
in older installations) is located in the installation directory of
Shell, depending on your installation method.
=) sign are optional and are ignored.( ).
shell.log, which is also located in
your installation directory.).
The global section shell{} may have the following subsections:
shell
{
// global variables
var // variables
{
// variables content
variable-name = variable-value
...
}
set // settings
{
theme
{
set-name = set-value
...
}
set-name = set-value
set-name = [set-value, set-value, ...]
...
}
images
{
id = value
"item 1" = value
id1,id2, id3, "item 2" = value
....
}
// static items
static
{
// static items content
item ( property-name = property-value ... )
...
}
// dynamic items
dynamic
{
// dynamic items content
item ( property-name = property-value ... )
separator [( property-name = property-value ... )]
menu ( property-name = property-value ... )
{
var // local variables
{
variable-name = variable-value
...
}
item ( property-name = property-value ... )
...
}
...
}
}
For best readability, users often like to avoid lines longer than 80 characters. single quotes also allow break up a line.
shell
{
dynamic
{
item(title='Command prompt'
cmd='cmd.exe')
}
}
To better organise the configuration file, parts of the configuration can be saved in separate files. These are then imported using the import tag. With this method, it is also possible to import the same file as a sort of "module" into different parts of the configuration. A convenient way to include the same sub-menu in different locations..
The general syntax is as follows:
shell
{
[ %section% ] import %path%
}
Where
%section% is the name of a section. Optional. If given, it must be one
of
%path% is a string literal, that returns the path to the
config file that shall be imported. This can be a relative path to the location of the file where the import tag is used, or it can be an absolute path. Expressions are
supported when using single quotes.
There are effectively two different ways this tag is applied, depending on whether the optional
%section% is given:
shell
{
// import an entire section
%section% import %path%
}
In this case, the content of the file found at %path% will be imported into a newly
created section{}.
The result would then look like so:
shell
{
// import an entire section
section {
/* content of the imported file goes here! Do not include
*
* section {
* }
*
* in your imported file!
*/
}
}
This syntax may be used only in the following places:
shell import %path%var import %path%set import %path%images import %path%static import %path%dynamic import %path%theme import %path%background import
%path%item import
%path%border import
%path%tip import %path%exclude import
%path%static import %path%dynamic import
%path%shell
{
section {
// come code might go here. Optional.
// import of a partial section
import %path%
// some more content might go here. Optional.
}
}
In this case, the content of the file found at %path% will be imported into the already
existing section{}.
The result would then look like so:
shell
{
section {
// come code might go here. Optional.
// import of a partial section
/* content of the imported file goes here! Do not include
*
* section {
* }
*
* in your imported file!
*/
// some more content might go here. Optional.
}
}
This syntax may be used nearly anywhere: