@page @{ ViewData["title"] = "Syntax"; ViewData["page-support"] = "Syntax"; }

Syntax Rules for Configuration Files


This chapter describes the syntax rules for configuration file.

Tip: When there is an error, it is recorded in the log file (shell.log).

@*

You can place any number of varabiles in an menu. varabiles can be placed in the var, or in the dynamic body section of an menu, or in both.

*@

The following rules apply to the syntax of configuration file (shell.shl):

shell.shl structure
shell 
{
    // global variables
    var
    {
        // variables content
        variable-name = variable-value
        ...
    }
	
    default
    {
        // defaults content
        default-name = default-value
        default-name = [default-value, default-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   ... )
            ...
        }
        ...
    }
}

Breaking Long Lines
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')
    }
}
@*
Example
shell 
{
     var
    {
        hello_world = 'Hello World!'
    }
	
    static
    {
        // remove items
        item(find='restore' vis=hidden)
        item(find='give access to' vis=hidden)

        // show only on extended with shift key
        item(find='send to' vis=extended)
        item(find='new' vis=extended)

        // remove or extend multiple items by one line
        item(find='delete|format|rename|paste' vis=extended)
        
        // change title
        item(find='defender' title='Scan with Defender')
		
        // change image
        item(find='copy' image=#dd0000)
        
        // change image, title
        item(find='open with' image=#dd0000 title='Open...')
    }
	
    dynamic
    {
	  item(title=@@hello_world cmd=@@msg(hello_world))
	  separator
	  item(title='Command prompt' cmd='cmd.exe' args='/k echo @@hello_world')
	  separator
	  menu(title='Sub menu')
	  {
	      item(title='Open Paint' cmd='paint.exe' arg=@@sel.path)
	      separator
	      item(title='Open Notepad' cmd='notepad.exe' arg='"@@sel.path"')
	  }
    }
}
*@