Template:Function2: Difference between revisions
No edit summary |
Add missing description for function1.param1.type |
||
(46 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
<includeonly>{{TOCright}}{{DISPLAYTITLE:{{{name}}} | <includeonly>{{TOCright}}{{DISPLAYTITLE:{{{name}}}}}{{#if: {{{needscode|}}}|{{CodeRequest}}}}{{#if: {{{improvecode|}}}|{{CodeRequest|better=yes}}}} | ||
{{#if: {{{name|}}}||{{error|Parameter 'name' is missing for User:Philmasterplus/TemplateSandbox2}}}} | {{#if: {{{name|}}}||{{error|Parameter 'name' is missing for User:Philmasterplus/TemplateSandbox2}}}} | ||
<h2>Function Syntax</h2> | |||
{{#if: {{{function1.return_type|}}} | {{#if: {{{function1.return_type|}}} | ||
|<p>{{FunctionDeclaration|name={{{name}}}|func=1|desc=yes|param_desc=yes}}</p>}} | |||
|{{ | {{#if: {{{function2.return_type|}}} | ||
}} | |<p>{{FunctionDeclaration|name={{{name}}}|func=2|desc=yes|param_desc=yes}}</p>}} | ||
{{#if: {{{function3.return_type|}}} | |||
|<p>{{FunctionDeclaration|name={{{name}}}|func=3|desc=yes|param_desc=yes}}</p>}} | |||
{{#if: {{{function4.return_type|}}} | |||
|<p>{{FunctionDeclaration|name={{{name}}}|func=4|desc=yes|param_desc=yes}}</p>}} | |||
{{#if: {{{function5.return_type|}}} | |||
|<p>{{FunctionDeclaration|name={{{name}}}|func=5|desc=yes|param_desc=yes}}</p>}} | |||
{{{description}}} | |||
|< | |||
|< | |||
|< | |||
|< | |||
}} | |||
{{#if: {{{code1|}}}|{{{code1}}}}}{{#if: {{{code2|}}}|{{{code2}}}}}{{#if: {{{code3|}}}|{{{code3}}}}}{{#if: {{{code4|}}}|{{{code4}}}}}{{#if: {{{code5|}}}|{{{code5}}}}} | {{#if: {{{code1|}}}|{{{code1}}}}}{{#if: {{{code2|}}}|{{{code2}}}}}{{#if: {{{code3|}}}|{{{code3}}}}}{{#if: {{{code4|}}}|{{{code4}}}}}{{#if: {{{code5|}}}|{{{code5}}}}} | ||
{{#if: {{{cli_equiv|}}}| | {{#if: {{{cli_equiv|}}}| | ||
<h2>CLI Equivalent</h2> | |||
{{{cli_equiv}}}}} | {{{cli_equiv}}}}} | ||
{{#if: {{{see_also|}}}|{{{see_also|}}}}} | {{#if: {{{see_also|}}}|{{{see_also|}}}}} | ||
{{#if: {{{more_info|}}}| | {{#if: {{{more_info|}}}| | ||
<h2>More Information</h2> | |||
{{{more_info}}}}} | {{{more_info}}}}} | ||
{{#if: {{{special|}}}| | {{#if: {{{special|}}}| | ||
<h2>Special</h2> | |||
{{{special}}}}} | {{{special}}}}} | ||
[[Category:Ash Functions]] | [[Category:Ash Functions]] | ||
Line 63: | Line 28: | ||
<templatedata> | <templatedata> | ||
{ | { | ||
"description": "Replacement for Template:FunctionPage. Must be used with function pages | "description": "Replacement for Template:FunctionPage. Must be used with data-driven function pages.", | ||
"params": { | "params": { | ||
"name": { | "name": { | ||
Line 72: | Line 37: | ||
"example": "visit_url" | "example": "visit_url" | ||
}, | }, | ||
"function1. | "description": { | ||
"label": "Function 1, | "label": "Description", | ||
"description": "Short description for the | "description": "Long description that covers all functions. Note: Use <p></p> to separate paragraphs, because double line breaks don't work", | ||
"required": true, | |||
"type": "content" | |||
}, | |||
"function1.description": { | |||
"label": "Function 1, description", | |||
"description": "Short description for the overloaded function 1 (and so on for functions 2 through 3)", | |||
"required": true, | |||
"type": "content", | "type": "content", | ||
"example": "Visits a web page and returns its HTML source." | "example": "Visits a web page and returns its HTML source." | ||
Line 80: | Line 52: | ||
"function1.return_type": { | "function1.return_type": { | ||
"label": "Function 1, return type", | "label": "Function 1, return type", | ||
"description": "Return type of the | "description": "Return type of the overloaded function 1.", | ||
"required": true, | "required": true, | ||
"type": "line", | "type": "line", | ||
"example": "buffer" | "example": "buffer" | ||
}, | }, | ||
"function1. | "function1.param1": { | ||
"label": "Function 1, parameter 1", | "label": "Function 1, parameter 1", | ||
"description": "Name of the parameter 1 of the | "description": "Name of the parameter 1 of the overloaded function 1 (and so on for parameters 2 through 5).", | ||
"type": "line", | "type": "line", | ||
"example": "url" | "example": "url" | ||
}, | }, | ||
"function1. | "function1.param1.type": { | ||
"label": "Function 1, parameter 1 type", | |||
"description": "Data type of the parameter 1 of the overloaded function 1.", | |||
"type": "line", | |||
"example": "int" | |||
}, | |||
"function1.param1.description": { | |||
"label": "Function 1, parameter 1 description", | "label": "Function 1, parameter 1 description", | ||
"description": "Description of parameter 1 of the | "description": "Description of parameter 1 of the overloaded function 1.", | ||
"type": "content", | "type": "content", | ||
"example": "URL of the page to visit. If a relative URL is provided, it is treated as an in-game page." | "example": "URL of the page to visit. If a relative URL is provided, it is treated as an in-game page." | ||
}, | }, | ||
"function1. | "function1.param1.optional": { | ||
"label": "Function 1, parameter 1 is optional?", | "label": "Function 1, parameter 1 is optional?", | ||
"description": " | "description": "\"yes\" = optional. Any non-empty string will do, but please use \"yes\" to make standardization easier.", | ||
"type": "line", | |||
"type": " | "example": "yes" | ||
"example": " | |||
}, | }, | ||
"function1. | "function1.param1.default": { | ||
"label": "Function 1, parameter 1 default value", | "label": "Function 1, parameter 1 default value", | ||
"description": " | "description": "If this is specified, function1.param1.optional must be \"yes\"", | ||
"type": "line", | "type": "line", | ||
"example": " | "example": "\"\"" | ||
}, | |||
"code1": { | |||
"label": "Example code 1", | |||
"description": "Example code showing how to use this function. Use [[Template:CodeSample]] to create sample code. (Same for code2 through code5)", | |||
"type": "content" | |||
}, | |||
"cli_equiv": { | |||
"label": "Equivalent gCLI command", | |||
"description": "If provided, must be a gCLI command that provides functionality equivalent to this function.", | |||
"type": "line" | |||
}, | |||
"see_also": { | |||
"label": "See Also section", | |||
"description": "If provided, this is used as the content for the See Also section. Use [[Template:SeeAlso]] to build a See Also section.", | |||
"type": "content" | |||
}, | |||
"more_info": { | |||
"label": "More Information section", | |||
"description": "If provided, this is used as the content for the More Information section", | |||
"type": "content" | |||
}, | |||
"special": { | |||
"label": "Special section", | |||
"description": "If provided, this is used as the content for the Special section", | |||
"type": "content" | |||
}, | |||
"needscode": { | |||
"label": "Needs code samples?", | |||
"description": "If set to \"yes\", adds a \"needs code samples\" banner and categorizes the page under [[Category:Needs Code Sample]].", | |||
"type": "line" | |||
}, | |||
"improvecode": { | |||
"label": "Needs improved code samples?", | |||
"description": "If set to \"yes\", adds a \"needs better code samples\" banner and categorizes the page under [[Category:Needs Code Sample]].", | |||
"type": "line" | |||
} | } | ||
} | } | ||
} | } | ||
</templatedata> | </templatedata> | ||
==Notes== | |||
This template is not meant to be used directly, but rather through the use of <pre>{{{format|Function2}}}</pre> in a data-driven function page. | |||
Use this as the starting point for a data-driven function page: | |||
<pre> | |||
<onlyinclude>{{{{{format|Function2}}} | |||
|name= | |||
|function1.return_type= | |||
|function1.description= | |||
|function1.param1= | |||
|function1.param1.type= | |||
|function1.param1.optional= | |||
|function1.param1.default= | |||
|function1.param1.description= | |||
|function1.param2= | |||
|function1.param2.type= | |||
|function1.param2.optional= | |||
|function1.param2.default= | |||
|function1.param2.description= | |||
|function1.param3= | |||
|function1.param3.type= | |||
|function1.param3.optional= | |||
|function1.param3.default= | |||
|function1.param3.description= | |||
|function1.param4= | |||
|function1.param4.type= | |||
|function1.param4.optional= | |||
|function1.param4.default= | |||
|function1.param4.description= | |||
|function1.param5= | |||
|function1.param5.type= | |||
|function1.param5.optional= | |||
|function1.param5.default= | |||
|function1.param5.description= | |||
|function2.return_type= | |||
|function2.description= | |||
|function2.param1= | |||
|function2.param1.type= | |||
|function2.param1.optional= | |||
|function2.param1.default= | |||
|function2.param1.description= | |||
|function2.param2= | |||
|function2.param2.type= | |||
|function2.param2.optional= | |||
|function2.param2.default= | |||
|function2.param2.description= | |||
|function2.param3= | |||
|function2.param3.type= | |||
|function2.param3.optional= | |||
|function2.param3.default= | |||
|function2.param3.description= | |||
|function2.param4= | |||
|function2.param4.type= | |||
|function2.param4.optional= | |||
|function2.param4.default= | |||
|function2.param4.description= | |||
|function2.param5= | |||
|function2.param5.type= | |||
|function2.param5.optional= | |||
|function2.param5.default= | |||
|function2.param5.description= | |||
|function3.return_type= | |||
|function3.description= | |||
|function3.param1= | |||
|function3.param1.type= | |||
|function3.param1.optional= | |||
|function3.param1.default= | |||
|function3.param1.description= | |||
|function3.param2= | |||
|function3.param2.type= | |||
|function3.param2.optional= | |||
|function3.param2.default= | |||
|function3.param2.description= | |||
|function3.param3= | |||
|function3.param3.type= | |||
|function3.param3.optional= | |||
|function3.param3.default= | |||
|function3.param3.description= | |||
|function3.param4= | |||
|function3.param4.type= | |||
|function3.param4.optional= | |||
|function3.param4.default= | |||
|function3.param4.description= | |||
|function3.param5= | |||
|function3.param5.type= | |||
|function3.param5.optional= | |||
|function3.param5.default= | |||
|function3.param5.description= | |||
|function4.return_type= | |||
|function4.description= | |||
|function4.param1= | |||
|function4.param1.type= | |||
|function4.param1.optional= | |||
|function4.param1.default= | |||
|function4.param1.description= | |||
|function4.param2= | |||
|function4.param2.type= | |||
|function4.param2.optional= | |||
|function4.param2.default= | |||
|function4.param2.description= | |||
|function4.param3= | |||
|function4.param3.type= | |||
|function4.param3.optional= | |||
|function4.param3.default= | |||
|function4.param3.description= | |||
|function4.param4= | |||
|function4.param4.type= | |||
|function4.param4.optional= | |||
|function4.param4.default= | |||
|function4.param4.description= | |||
|function4.param5= | |||
|function4.param5.type= | |||
|function4.param5.optional= | |||
|function4.param5.default= | |||
|function4.param5.description= | |||
|function5.return_type= | |||
|function5.description= | |||
|function5.param1= | |||
|function5.param1.type= | |||
|function5.param1.optional= | |||
|function5.param1.default= | |||
|function5.param1.description= | |||
|function5.param2= | |||
|function5.param2.type= | |||
|function5.param2.optional= | |||
|function5.param2.default= | |||
|function5.param2.description= | |||
|function5.param3= | |||
|function5.param3.type= | |||
|function5.param3.optional= | |||
|function5.param3.default= | |||
|function5.param3.description= | |||
|function5.param4= | |||
|function5.param4.type= | |||
|function5.param4.optional= | |||
|function5.param4.default= | |||
|function5.param4.description= | |||
|function5.param5= | |||
|function5.param5.type= | |||
|function5.param5.optional= | |||
|function5.param5.default= | |||
|function5.param5.description= | |||
|description= | |||
|code1={{CodeSample | |||
|title=Code Samples | |||
|description= | |||
|code= | |||
|moreinfo= | |||
}} | |||
|code2={{CodeSample | |||
|description= | |||
|code= | |||
|moreinfo= | |||
}} | |||
|code3={{CodeSample | |||
|description= | |||
|code= | |||
|moreinfo= | |||
}} | |||
|code4={{CodeSample | |||
|description= | |||
|code= | |||
|moreinfo= | |||
}} | |||
|code5={{CodeSample | |||
|description= | |||
|code= | |||
|moreinfo= | |||
}} | |||
|see_also={{SeeAlso|}} | |||
|cli_equiv= | |||
|more_info= | |||
|special= | |||
|{{{1|}}} | |||
}}</onlyinclude> | |||
<!-- Add an appropriate function subcategory here, e.g. [[Category:Adventuring]], | |||
then delete this comment --> | |||
</pre> | |||
Data-driven function pages are incompatible with old-style function pages (i.e. ones that use [[Template:FunctionPage]]). | |||
[[Category:Basic Templates]] | |||
</noinclude> | </noinclude> |
Latest revision as of 14:10, 13 July 2021
Replacement for Template:FunctionPage. Must be used with data-driven function pages.
Parameter | Description | Type | Status | |
---|---|---|---|---|
ASH function name | name | Name of the ASH function. This should match the function page name.
| Line | required |
Description | description | Long description that covers all functions. Note: Use <p></p> to separate paragraphs, because double line breaks don't work | Content | required |
Function 1, description | function1.description | Short description for the overloaded function 1 (and so on for functions 2 through 3)
| Content | required |
Function 1, return type | function1.return_type | Return type of the overloaded function 1.
| Line | required |
Function 1, parameter 1 | function1.param1 | Name of the parameter 1 of the overloaded function 1 (and so on for parameters 2 through 5).
| Line | optional |
Function 1, parameter 1 type | function1.param1.type | Data type of the parameter 1 of the overloaded function 1.
| Line | optional |
Function 1, parameter 1 description | function1.param1.description | Description of parameter 1 of the overloaded function 1.
| Content | optional |
Function 1, parameter 1 is optional? | function1.param1.optional | "yes" = optional. Any non-empty string will do, but please use "yes" to make standardization easier.
| Line | optional |
Function 1, parameter 1 default value | function1.param1.default | If this is specified, function1.param1.optional must be "yes"
| Line | optional |
Example code 1 | code1 | Example code showing how to use this function. Use [[Template:CodeSample]] to create sample code. (Same for code2 through code5) | Content | optional |
Equivalent gCLI command | cli_equiv | If provided, must be a gCLI command that provides functionality equivalent to this function. | Line | optional |
See Also section | see_also | If provided, this is used as the content for the See Also section. Use [[Template:SeeAlso]] to build a See Also section. | Content | optional |
More Information section | more_info | If provided, this is used as the content for the More Information section | Content | optional |
Special section | special | If provided, this is used as the content for the Special section | Content | optional |
Needs code samples? | needscode | If set to "yes", adds a "needs code samples" banner and categorizes the page under [[Category:Needs Code Sample]]. | Line | optional |
Needs improved code samples? | improvecode | If set to "yes", adds a "needs better code samples" banner and categorizes the page under [[Category:Needs Code Sample]]. | Line | optional |
Notes
This template is not meant to be used directly, but rather through the use of
{{{format|Function2}}}
in a data-driven function page.
Use this as the starting point for a data-driven function page:
<onlyinclude>{{{{{format|Function2}}} |name= |function1.return_type= |function1.description= |function1.param1= |function1.param1.type= |function1.param1.optional= |function1.param1.default= |function1.param1.description= |function1.param2= |function1.param2.type= |function1.param2.optional= |function1.param2.default= |function1.param2.description= |function1.param3= |function1.param3.type= |function1.param3.optional= |function1.param3.default= |function1.param3.description= |function1.param4= |function1.param4.type= |function1.param4.optional= |function1.param4.default= |function1.param4.description= |function1.param5= |function1.param5.type= |function1.param5.optional= |function1.param5.default= |function1.param5.description= |function2.return_type= |function2.description= |function2.param1= |function2.param1.type= |function2.param1.optional= |function2.param1.default= |function2.param1.description= |function2.param2= |function2.param2.type= |function2.param2.optional= |function2.param2.default= |function2.param2.description= |function2.param3= |function2.param3.type= |function2.param3.optional= |function2.param3.default= |function2.param3.description= |function2.param4= |function2.param4.type= |function2.param4.optional= |function2.param4.default= |function2.param4.description= |function2.param5= |function2.param5.type= |function2.param5.optional= |function2.param5.default= |function2.param5.description= |function3.return_type= |function3.description= |function3.param1= |function3.param1.type= |function3.param1.optional= |function3.param1.default= |function3.param1.description= |function3.param2= |function3.param2.type= |function3.param2.optional= |function3.param2.default= |function3.param2.description= |function3.param3= |function3.param3.type= |function3.param3.optional= |function3.param3.default= |function3.param3.description= |function3.param4= |function3.param4.type= |function3.param4.optional= |function3.param4.default= |function3.param4.description= |function3.param5= |function3.param5.type= |function3.param5.optional= |function3.param5.default= |function3.param5.description= |function4.return_type= |function4.description= |function4.param1= |function4.param1.type= |function4.param1.optional= |function4.param1.default= |function4.param1.description= |function4.param2= |function4.param2.type= |function4.param2.optional= |function4.param2.default= |function4.param2.description= |function4.param3= |function4.param3.type= |function4.param3.optional= |function4.param3.default= |function4.param3.description= |function4.param4= |function4.param4.type= |function4.param4.optional= |function4.param4.default= |function4.param4.description= |function4.param5= |function4.param5.type= |function4.param5.optional= |function4.param5.default= |function4.param5.description= |function5.return_type= |function5.description= |function5.param1= |function5.param1.type= |function5.param1.optional= |function5.param1.default= |function5.param1.description= |function5.param2= |function5.param2.type= |function5.param2.optional= |function5.param2.default= |function5.param2.description= |function5.param3= |function5.param3.type= |function5.param3.optional= |function5.param3.default= |function5.param3.description= |function5.param4= |function5.param4.type= |function5.param4.optional= |function5.param4.default= |function5.param4.description= |function5.param5= |function5.param5.type= |function5.param5.optional= |function5.param5.default= |function5.param5.description= |description= |code1={{CodeSample |title=Code Samples |description= |code= |moreinfo= }} |code2={{CodeSample |description= |code= |moreinfo= }} |code3={{CodeSample |description= |code= |moreinfo= }} |code4={{CodeSample |description= |code= |moreinfo= }} |code5={{CodeSample |description= |code= |moreinfo= }} |see_also={{SeeAlso|}} |cli_equiv= |more_info= |special= |{{{1|}}} }}</onlyinclude> <!-- Add an appropriate function subcategory here, e.g. [[Category:Adventuring]], then delete this comment -->
Data-driven function pages are incompatible with old-style function pages (i.e. ones that use Template:FunctionPage).