Template:GuiCommand: Difference between revisions
(→Localization: added section concerning localization use, added languages template, other minor edits) |
(→32px {{{Name}}}: added do not remove comment to noinclude tag) |
||
Line 26: | Line 26: | ||
[[Category:Command Reference]] |
[[Category:Command Reference]] |
||
<noinclude> <!-- Note to editors: Do Not Remove This Line. --> |
|||
<noinclude> |
|||
==Usage== |
==Usage== |
Revision as of 16:48, 16 February 2013
[[Image:{{{Name}}}.png|32px]] {{{Name}}} |
Menu location |
---|
{{{MenuLocation}}} |
Workbenches |
{{{Workbenches}}} |
Default shortcut |
None |
See also |
None |
Usage
This Template is the main anchor on documenting GuiCommands. It should be inserted as the first line in new documents.
The minimum code required for this template usage is: (sample result to right)
{{GuiCommand|Name=SampleCommand|MenuLocation=Sample -> Command...|Workbenches=Wb1,Wb2}}
SampleCommand
Menu location
Sample -> Command...
Workbenches
Wb1,Wb2
Default shortcut
DefaultShortcut
See also
OtherTopic
Minimum Parameters
The following parameters are used in the format [parameter]=[value], with each parameter in the list separated by a pipe symbol (|):
- Name
- The properly capitalized name of the command to be documented.
- The name is also used to retrieve the Icon graphic in .PNG format from the WIKI repository.
- MenuLocation
- The location of the command in the FreeCAD menu structure.
- Workbenches
- One or more workbenches in FreeCAD that the command and icon can be found on.
Optional Parameters
The following parameters are optional. If they are not included in the template code, they will default to a value of "None".
- Shortcut
- The default Keyboard shortcut as found in FreeCAD.
- SeeAlso
- Optional link to other related topics.
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 /AA is the 2 letter code for the desired language, for example /fr = French localization. - The method for calling the localized GuiCommand template in a GuiCommand document is:
{{GuiCommand/AA|Name=SampleCommand|Name/AA=SampleCommand/AA|MenuLocation=Sample -> Commande...|Workbenches=Wb1,Wb2}}
where /AA is the 2 letter code for the desired language, for example /fr = French localization.- In the sample code above, the Name parameter format is critical. The Name=SampleCommand allows the correct icon file to be displayed, which is not normally localized. The Name/AA=SampleCommand/AA displays the correct localized version of the GUI command documentation.
- Make sure you add the localized version of this template to the Languages list below.