RV – Template

From Bohemia Interactive Community
Jump to navigation Jump to search
m ([ → |)
(Add Category:Templates and description, displayName and sortKey parameters)
Line 2: Line 2:
| COMMAND
| COMMAND
| FUNCTION =
| FUNCTION =
__NOTOC__ __NOEDITSECTION__
__NOTOC__ __NOEDITSECTION__{{#ifeq:{{uc:{{NAMESPACE}}}}|TEMPLATE||{{DISPLAYTITLE:{{{displayTitle|{{PAGENAMEE}}}}}}}}}<!--
{{DISPLAYTITLE:{{#ifeq: {{uc:{{FULLPAGENAME}}}} | TEMPLATE:RV | {{FULLPAGENAMEE}} | {{PAGENAMEE}} }} }}<!--
-->{{DEFAULTSORT:{{{sortKey|{{uc:{{#replace:{{#replace:{{PAGENAMEE}}|BIS_fnc_|}}|BIN_fnc_|}}}}}}}}}<!--
-->{{DEFAULTSORT:{{uc:{{#replace:{{#replace:{{PAGENAMEE}}|BIS_fnc_|}}|BIN_fnc_|}}}}}}<!--
--><div class="_description {{#ifeq:{{lc:{{{type}}}}}|command|cmd|fnc}}">
--><div class="_description {{#ifeq:{{lc:{{{type}}}}}|command|cmd|fnc}}">
<div class="top-icons"><!--
<div class="top-icons"><!--
Line 239: Line 238:


== Usage ==
== Usage ==
{{<nowiki/>RV|'''''type='''''|''other arguments''}}
{{<nowiki/>RV|'''type='''|''other parameters, see below''}}
* type: (named argument, case-insensitive) "command" or "function"
* meta information:
** '''type''': (named argument, case-insensitive) "command" or "function"
** displayTitle: (Optional, default <tt>{{<nowiki/>PAGENAMEE}}</tt> (encoded page name, i.e with underscores)) use to force page's displayTitle (e.g <tt>diag_log (Arma 2)</tt>)
** '''sortKey''': (Optional, default commandName or functionName without BIS/BIN_fnc_ prefix) use to force category's sort key
* '''primary parameters:'''
** game1: (can be unnamed parameter '''1''') short game name - same as [[Template:Name|Name]] template input format. e.g ofp, tkoh, arma3, etc.
** version1: (Optional, default empty (unknown)) (can be version or unnamed parameter '''2''') number in [[Template:GVI]] template format: '''<Major>.<Minor>'''. e.g 1.46, 1.75, 1.86 etc.
** arg: (Optional, default empty) argument locality definition - same as [[Template:EffArg|EffArg]] template input format. e.g local, loc or global, glob
** eff: (Optional, default empty) effects locality definition - same as [[Template:EffArg|EffArg]] template input format. e.g local, loc or global, glob
** serverExec: (Optional, default empty) if provided, will display the {{ServerExec}} icon informing the command must be run on the server
** descr: (can be unnamed parameter '''3''') the command description
** gr1..gr5: (Optional, default empty) [https://community.bistudio.com/wiki?title=Category:Scripting_Commands_by_Functionality&redirect=no Command groups]. '''Case sensitive'''.
** s1: (Optional, default <tt>{{<nowiki/>PAGENAMEE}}</tt>; can be unnamed parameter '''4''') command syntax with named parameters. e.g {{Inline code|unit1 '''setDammage''' 1}}
** p1..20: (Optional, default empty) command parameters with description
** r1: (Optional, default [[Nothing]]) (can be unnamed parameter '''5''') syntax's return value
** x1..10: (Optional, default {{Template|Example needed}}) command examples (to be put between <nowiki><code></code></nowiki> tags where needed)
** seealso: (Optional, default <tt>[[:Category:See also needed|See also needed]]</tt>) (can be unnamed param '''6''') list of related links in wiki format, separated by comma or space. e.g <nowiki>[[setDir]] [[setPos]]</nowiki>
* '''secondary parameters:'''
** mp: (Optional, default empty) if provided, will show a Multiplayer note under the description
** pr: (Optional, default empty) if provided, will show a Problems note under the description
** game2..5: (Optional, default empty) same as ''game1''
** version2..5: (Optional, default empty) same as ''version1'', for the corresponding ''game#''
** s2..6: (Optional, default empty) Alternative syntaxes 1 to 5 (see ''s1'')
** p21..120: (Optional, default empty) Alternative syntaxes parameters ('''20''' each: p21..40, p41..60, p61..80, p81..100, p101..120)
** r2..r6: (Optional, default empty) Alternative syntaxes' return value (see ''r1'')
 
== Automatic categories ==
{| class="wikitable"
! Command
! Function
|- style="vertical-align: top"
|
* <tt>[[:Category:Scripting Commands]]</tt>
* <tt>Category:''game'': Scripting Commands</tt> (e.g [[:Category:{{arma2}}: Scripting Commands]])
* <tt>Category:''game1'': Introduced in v''version'''1'''''</tt> (e.g [[:Category:{{arma3}}: Introduced in v1.00|Category:'''{{arma3}}''': Introduced in v'''1.00''']])
* <tt>''game'''1''''': New Scripting Commands</tt> category (e.g [[:Category:{{arma2}}: New Scripting Commands|Category:'''{{arma2}}''': New Scripting Commands]])
<!-- * <tt>[[:Category:Introduced with Arma 3 Development Branch]]</tt> if ''game1'' is <tt>arma3dev</tt> not yet -->
|
* <tt>[[:Category:Functions]]</tt>
* <tt>Category:''game'': Functions</tt> (e.g [[:Category:{{arma2}}: Functions]])
* <tt>Category:''game'''1''''': Introduced in v''version'''1'''''</tt> (e.g [[:Category:{{arma3}}: Introduced in v1.00|Category:'''{{arma3}}''': Introduced in v'''1.00''']])
* <tt>''game'''1''''': New Functions</tt> category (e.g [[:Category: {{arma2}}: New Functions|Category: '''{{arma2}}''': New Functions]])
<!--* <tt>[[:Category:Introduced with Arma 3 Development Branch]]</tt> if ''game1'' is <tt>arma3dev</tt> not yet, and most probably won't -->
|}


== Examples ==
== Examples ==
Line 342: Line 384:
}}
}}
</pre>
</pre>
</noinclude>
[[Category:Templates|{{uc:{{PAGENAME}}}}]]</noinclude>

Revision as of 22:19, 14 January 2021

Commands/Functions documentation template.

Usage

{{RV|type=|other parameters, see below}}

  • meta information:
    • type: (named argument, case-insensitive) "command" or "function"
    • displayTitle: (Optional, default {{PAGENAMEE}} (encoded page name, i.e with underscores)) use to force page's displayTitle (e.g diag_log (Arma 2))
    • sortKey: (Optional, default commandName or functionName without BIS/BIN_fnc_ prefix) use to force category's sort key
  • primary parameters:
    • game1: (can be unnamed parameter 1) short game name - same as Name template input format. e.g ofp, tkoh, arma3, etc.
    • version1: (Optional, default empty (unknown)) (can be version or unnamed parameter 2) number in Template:GVI template format: <Major>.<Minor>. e.g 1.46, 1.75, 1.86 etc.
    • arg: (Optional, default empty) argument locality definition - same as EffArg template input format. e.g local, loc or global, glob
    • eff: (Optional, default empty) effects locality definition - same as EffArg template input format. e.g local, loc or global, glob
    • serverExec: (Optional, default empty) if provided, will display the Template:ServerExec icon informing the command must be run on the server
    • descr: (can be unnamed parameter 3) the command description
    • gr1..gr5: (Optional, default empty) Command groups. Case sensitive.
    • s1: (Optional, default {{PAGENAMEE}}; can be unnamed parameter 4) command syntax with named parameters. e.g unit1 setDammage 1
    • p1..20: (Optional, default empty) command parameters with description
    • r1: (Optional, default Nothing) (can be unnamed parameter 5) syntax's return value
    • x1..10: (Optional, default {{Example needed}}) command examples (to be put between <code></code> tags where needed)
    • seealso: (Optional, default See also needed) (can be unnamed param 6) list of related links in wiki format, separated by comma or space. e.g [[setDir]] [[setPos]]
  • secondary parameters:
    • mp: (Optional, default empty) if provided, will show a Multiplayer note under the description
    • pr: (Optional, default empty) if provided, will show a Problems note under the description
    • game2..5: (Optional, default empty) same as game1
    • version2..5: (Optional, default empty) same as version1, for the corresponding game#
    • s2..6: (Optional, default empty) Alternative syntaxes 1 to 5 (see s1)
    • p21..120: (Optional, default empty) Alternative syntaxes parameters (20 each: p21..40, p41..60, p61..80, p81..100, p101..120)
    • r2..r6: (Optional, default empty) Alternative syntaxes' return value (see r1)

Automatic categories

Command Function

Examples

Code Result
{{RV}} -no type provided-
{{RV|type=abc}} -wrong type provided-
{{RV|type=command}}
Hover & click on the images for descriptions

Description

Description:
Template:Stub

Syntax

Syntax:
RV
Template:Command/params Template:Command/paramsTemplate:Command/paramsTemplate:Command/paramsTemplate:Command/paramsTemplate:Command/params

Examples

Examples:
Template:Example needed

Additional Information

See also:
See also needed
Groups:
Uncategorised

Notes

i
Only post proven facts here. Report bugs on the Feedback Tracker and discuss on the Arma Discord or on the Forums.
{{RV|type=function}}
Hover & click on the images for descriptions

Description

Description:
Template:Stub
Execution:
call

Syntax

Syntax:
RV
Template:Command/params Template:Command/paramsTemplate:Command/paramsTemplate:Command/paramsTemplate:Command/paramsTemplate:Command/params

Examples

Examples:
Template:Example needed

Additional Information

See also:
See also needed
Groups:
Uncategorised

Notes

i
Only post proven facts here. Report bugs on the Feedback Tracker and discuss on the Arma Discord or on the Forums.

Template

{{RV|type=Command

|game1=
|game2=
|game3=
|game4=
|game5=

|version1=
|version2=
|version3=
|version4=
|version5=

|arg=
|eff=
|serverExec=

|gr1=
|gr2=
|gr3=
|gr4=
|gr5=

|descr=

|mp=

|pr=

|s1=

|p1=

|p2=

|p3=

|p4=

|p5=

|p6=

|p7=

|p8=

|p9=

|p10=

|p11=

|p12=

|p13=

|p14=

|p15=

|p16=

|p17=

|p18=

|p19=

|p20=

|r1=

|x1=

|seealso=
}}