Difference between revisions of "SkibUserMacros:Command syntax of User Macros"
From Protoi Healing
(7 intermediate revisions by 2 users not shown) | |||
Line 13: | Line 13: | ||
|- | |- | ||
|'''{option 1}'''...'''{option x}''' | |'''{option 1}'''...'''{option x}''' | ||
− | |These are optional | + | |These are optional parameters, they are NOT mandatory. If one or more of these parameters are not given, the Skib will start the user macro without them. |
|- | |- | ||
|'''((free param))''' | |'''((free param))''' | ||
|This parameter enables Skib to interpret any additional given information for the user macro. On the one side this can bring big benefit, but on the other side this may force Skib to do researches and operations quite a while (maybe a few hours...), before starting the user macro. So has to be used carefully. | |This parameter enables Skib to interpret any additional given information for the user macro. On the one side this can bring big benefit, but on the other side this may force Skib to do researches and operations quite a while (maybe a few hours...), before starting the user macro. So has to be used carefully. | ||
|} | |} | ||
+ | |||
+ | |||
+ | {{Text|120}}'''A command shall always get written down like this:'''{{EndText}} | ||
+ | |||
+ | |||
+ | {{UserMacroCommandBox|'''WriteUserMacroNameHere''' <param 1>... {option 1}... }} | ||
+ | <br/><br/><br/><br/><br/> | ||
+ | |||
+ | '''Description''' | ||
+ | :Whatever the User Macro wil do... | ||
+ | |||
+ | '''<param 1>''' | ||
+ | :Whatever parameter 1 does... | ||
+ | |||
+ | '''<param x>''' | ||
+ | :Whatever parameter 2 does... | ||
+ | |||
+ | '''{option 1}''' | ||
+ | :Whatever option 1 does.. | ||
+ | |||
+ | '''{option x}''' | ||
+ | :Whatever option 2 does.. | ||
+ | |||
+ | |||
+ | Here is the wiki code for the above:<br/> | ||
+ | {{Text|80}}''(This is also included in the UserMacro page template)''{{EndText}} | ||
+ | |||
+ | <pre> | ||
+ | {{UserMacroCommandBox|'''WriteUserMacroNameHere''' <param 1>... {option 1}... }} | ||
+ | <br/><br/><br/><br/><br/> | ||
+ | |||
+ | '''Description''' | ||
+ | :Whatever the User Macro wil do... | ||
+ | |||
+ | '''<param 1>''' | ||
+ | :Whatever parameter 1 does... | ||
+ | |||
+ | '''<param x>''' | ||
+ | :Whatever parameter 2 does... | ||
+ | |||
+ | '''{option 1}''' | ||
+ | :Whatever option 1 does.. | ||
+ | |||
+ | '''{option x}''' | ||
+ | :Whatever option 2 does.. | ||
+ | </pre> |
Latest revision as of 16:38, 4 February 2017
The general syntax of Skib User Macros:
NameOfUserMacro | This is the name of the user macro. Look at Naming User Macros how to create the name for the user macro. |
<param 1>...<param x> | These are mandatory parameters for the user macro. Parameters specified in this kind must be given with the command to Skib to start the user macro. If a mandatory parameter is missing in the start command, Skib will not start the user macro at all. |
{option 1}...{option x} | These are optional parameters, they are NOT mandatory. If one or more of these parameters are not given, the Skib will start the user macro without them. |
((free param)) | This parameter enables Skib to interpret any additional given information for the user macro. On the one side this can bring big benefit, but on the other side this may force Skib to do researches and operations quite a while (maybe a few hours...), before starting the user macro. So has to be used carefully. |
A command shall always get written down like this:
Command syntax
Description
- Whatever the User Macro wil do...
<param 1>
- Whatever parameter 1 does...
<param x>
- Whatever parameter 2 does...
{option 1}
- Whatever option 1 does..
{option x}
- Whatever option 2 does..
Here is the wiki code for the above:
(This is also included in the UserMacro page template)
{{UserMacroCommandBox|'''WriteUserMacroNameHere''' <param 1>... {option 1}... }} <br/><br/><br/><br/><br/> '''Description''' :Whatever the User Macro wil do... '''<param 1>''' :Whatever parameter 1 does... '''<param x>''' :Whatever parameter 2 does... '''{option 1}''' :Whatever option 1 does.. '''{option x}''' :Whatever option 2 does..