Template:GuiCommand

Usage
This template is the main tool to document GuiCommands. It should be inserted in documentation pages right after the  and   tags. See the sample on the right.

Parameters are specified with values after the equals sign:.

The required parameters are:

Other parameters may be omitted or their value left empty.

Required parameters
The following parameters are required.


 * Name
 * The properly capitalized name of the command to be documented.
 * The name is used to retrieve the icon graphic  or   from the wiki repository.


 * Workbenches
 * One or more workbenches in FreeCAD that the command and icon can be found in. It should be an internal link to the workbench page, used like this:

Part

The portion to the left of the pipe  is the page name, and the portion to the right is the displayed text. This example will display as Part.

Optional Parameters
The following parameters are optional. If they are not included in the template, they will default to None, or a dash (-).


 * MenuLocation
 * The location of the command in the FreeCAD menu structure. Please use the proper right arrow symbol (→) rather than ->.


 * Shortcut
 * The default keyboard shortcut to launch the command in FreeCAD, for example,.


 * Version
 * The FreeCAD version number in which the command was first introduced, for example, . There is no need to add the specific revision number, only the major version. Use this parameter for all new commands included in the documentation.


 * SeeAlso
 * Optional links to other related commands and Wiki pages, for example,.


 * Icon
 * An image file different from  or   for the icon. This can be used to include a specific icon that is not named after the command, for example,


 * Empty
 * If  no icon is displayed. This is done to document commands that don't have an icon, for example, commands from menus, and functions that can't be accessed from the graphical user interface.

Localization
The code required for this template is different if you are using a localized version. For more information see the Localization page.

First, a localized version of this template must exist or be created.

The localized template must be named:

Template:GuiCommand/AA

where  is the letter code for the desired language, for example   indicates French. These are the ISO 639-1 language codes, and not country codes.

The method for calling the localized GuiCommand template is:

In the example above the  parameter is critical. allows the correct icon file to be displayed;  displays the correct localized version of the command documentation.

GuiCommand model
For a complete example of how to document a GuiCommand, see GuiCommand model.