Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Added description for mimetype and terminalOptions (Unix shortcut options).

...

TODO
AttributeDescriptionRequired
type

Specifies the type of shortcut. Valid values are:

  • application
    Creates a shortcut to start any application (native, Java, or shell-script). The GUI-System will launch this Application through its native shell or application launcher. In this case, note that the right workingDirectory is always important on Unix platforms. If the user's PATH environment variable does not contain the application path, this application will not run unless workingDirectory specifies the application path. The "current path" placeholder (i.e. '.') must exist on the PATH, as is the case by default on most systems. Consult the Unix manuals for more details.
  • link
    Creates a shortcut to open a URL in the user's default web browser. In this case, the url attribute must be set.
Yes
urlSpecifies a locally installed HTML file, other file with a known MIME type (e.g. plain text), or a WWW URL (e.g. http://izpack.org/). This value is translated through the variable substitutor, so variables such as $INSTALL_PATH (for local documents) can be used.Yes, if type=link
mimeType
Note

TODO

 mimetype

Specifies the MIME type for links pointing to local files when using type=link.

No; recommended if type=link and url points to a local file.
encodingThis should always set to UTF-8.Yes
terminalSet to true to allow the user to see the console output of a program (e.g. in Java applications "System.out").No; defaults to false.
terminalOptions
Note

Specifies attributes for terminal windows when terminal=true (see man pages for setterm).

No
KdeSubstUIDThis is the sudo option for a shortcut. If set to true, you will be asked for the password of the KdeUsername.

No; defaults to false

KdeUsernameThe username with correct sudo permissions where KdeSubstUID is true. This is root in most cases.No; defaults to root.
createForAllIf a user with administrative rights, such as root, performs the installation, set to true to make this shortcut appear to other users as well as root.No; defaults to false.
categories

The category in the Desktop Application Menu where the shortcut will be placed. Here are some sample categories and their apps. For more examples, examine the desktop files in /usr/share/applications in the target environment.

  • Categories="Application;Network;WebDevelopment;" - Nvu
  • Categories="Qt;Development;GUIDesigner;" - QtDesigner3
  • Categories="Application;System;" - VMwareServer-console
  • Categories="Network;WebBrowser;" - Opera
  • Categories="Development;Debugger;" - DDD debugger
  • Categories="Development;IDE;" - Eclipse IDE
  • Categories="SystemSetup;X-SuSE-Core-System;" - Yast2
  • Categories="System;Archiving;" - Sesam archiving
  • Categories="System;Database;" - MySQL Administrator
No; no default.
tryexecSpecifies a command to pass through 'raw' to the operating system.No; default is to use target and (where present) commandLine

...