Template:Function2: Difference between revisions

From Kolmafia
Jump to navigation Jump to search
No edit summary
Add missing description for function1.param1.type
 
(20 intermediate revisions by the same user not shown)
Line 1: Line 1:
<includeonly>{{TOCright}}{{DISPLAYTITLE:{{{name}}}()}}{{#if: {{{needscode|}}}|{{CodeRequest}}}}{{#if: {{{improvecode|}}}|{{CodeRequest|better=yes}}}}
<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}}}}
==Function Syntax==
<h2>Function Syntax</h2>
{{#if: {{{function1.return_type|}}}
{{#if: {{{function1.return_type|}}}
   |<p>{{FunctionDeclaration|name={{{name}}}|func=1|desc=yes}}</p>}}
   |<p>{{FunctionDeclaration|name={{{name}}}|func=1|desc=yes|param_desc=yes}}</p>}}
{{#if: {{{function2.return_type|}}}
{{#if: {{{function2.return_type|}}}
   |<p>{{FunctionDeclaration|name={{{name}}}|func=2|desc=yes}}</p>}}
   |<p>{{FunctionDeclaration|name={{{name}}}|func=2|desc=yes|param_desc=yes}}</p>}}
{{#if: {{{function3.return_type|}}}
{{#if: {{{function3.return_type|}}}
   |<p>{{FunctionDeclaration|name={{{name}}}|func=3|desc=yes}}</p>}}
   |<p>{{FunctionDeclaration|name={{{name}}}|func=3|desc=yes|param_desc=yes}}</p>}}
{{#if: {{{function4.return_type|}}}
{{#if: {{{function4.return_type|}}}
   |<p>{{FunctionDeclaration|name={{{name}}}|func=4|desc=yes}}</p>}}
   |<p>{{FunctionDeclaration|name={{{name}}}|func=4|desc=yes|param_desc=yes}}</p>}}
{{#if: {{{function5.return_type|}}}
{{#if: {{{function5.return_type|}}}
   |<p>{{FunctionDeclaration|name={{{name}}}|func=5|desc=yes}}</p>}}
   |<p>{{FunctionDeclaration|name={{{name}}}|func=5|desc=yes|param_desc=yes}}</p>}}
 
{{{description}}}
{{{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|}}}|
==CLI Equivalent==
<h2>CLI Equivalent</h2>
{{{cli_equiv}}}}}
{{{cli_equiv}}}}}
{{#if: {{{see_also|}}}|{{{see_also|}}}}}
{{#if: {{{see_also|}}}|{{{see_also|}}}}}
{{#if: {{{more_info|}}}|
{{#if: {{{more_info|}}}|
==More Information==
<h2>More Information</h2>
{{{more_info}}}}}
{{{more_info}}}}}
{{#if: {{{special|}}}|
{{#if: {{{special|}}}|
==Special==
<h2>Special</h2>
{{{special}}}}}
{{{special}}}}}
[[Category:Ash Functions]]
[[Category:Ash Functions]]
Line 63: Line 62:
       "type": "line",
       "type": "line",
       "example": "url"
       "example": "url"
    },
    "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": {
     "function1.param1.description": {
Line 122: Line 127:


==Notes==
==Notes==
This template is not meant to be used directly, but rather through the use of <pre>{{{format|User:Philmasterplus/TemplateSandbox2}}}</pre> in a data-driven function page.
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:
Use this as the starting point for a data-driven function page:


{| class="wikitable" style="font-family: monospace; white-space: pre"
<pre>
|-
&lt;onlyinclude&gt;{{{{{format|Function2}}}
| <nowiki><onlyinclude>{{{{{format|Function2}}}
|name=
|name=
|function1.return_type=
|function1.return_type=
Line 134: Line 138:
|function1.param1=
|function1.param1=
|function1.param1.type=
|function1.param1.type=
|function1.param2.optional=
|function1.param1.optional=
|function1.param2.default=
|function1.param1.default=
|function1.param1.description=
|function1.param1.description=
|function1.param2=
|function1.param2=
Line 161: Line 165:
|function2.param1=
|function2.param1=
|function2.param1.type=
|function2.param1.type=
|function2.param2.optional=
|function2.param1.optional=
|function2.param2.default=
|function2.param1.default=
|function2.param1.description=
|function2.param1.description=
|function2.param2=
|function2.param2=
Line 188: Line 192:
|function3.param1=
|function3.param1=
|function3.param1.type=
|function3.param1.type=
|function3.param2.optional=
|function3.param1.optional=
|function3.param2.default=
|function3.param1.default=
|function3.param1.description=
|function3.param1.description=
|function3.param2=
|function3.param2=
Line 215: Line 219:
|function4.param1=
|function4.param1=
|function4.param1.type=
|function4.param1.type=
|function4.param2.optional=
|function4.param1.optional=
|function4.param2.default=
|function4.param1.default=
|function4.param1.description=
|function4.param1.description=
|function4.param2=
|function4.param2=
Line 242: Line 246:
|function5.param1=
|function5.param1=
|function5.param1.type=
|function5.param1.type=
|function5.param2.optional=
|function5.param1.optional=
|function5.param2.default=
|function5.param1.default=
|function5.param1.description=
|function5.param1.description=
|function5.param2=
|function5.param2=
Line 268: Line 272:
|code1={{CodeSample
|code1={{CodeSample
   |title=Code Samples
   |title=Code Samples
   |description=Visits your private character sheet.
   |description=
   |code=
   |code=
   |moreinfo=
   |moreinfo=
}}
}}
|code2={{CodeSample
|code2={{CodeSample
   |description=Visits your private character sheet.
   |description=
   |code=
   |code=
   |moreinfo=
   |moreinfo=
}}
}}
|code3={{CodeSample
|code3={{CodeSample
   |description=Visits your private character sheet.
   |description=
   |code=
   |code=
   |moreinfo=
   |moreinfo=
}}
}}
|code4={{CodeSample
|code4={{CodeSample
   |description=Visits your private character sheet.
   |description=
   |code=
   |code=
   |moreinfo=
   |moreinfo=
}}
}}
|code5={{CodeSample
|code5={{CodeSample
   |description=Visits your private character sheet.
   |description=
   |code=
   |code=
   |moreinfo=
   |moreinfo=
Line 297: Line 301:
|special=
|special=
|{{{1|}}}
|{{{1|}}}
}}</onlyinclude>
}}&lt;/onlyinclude&gt;
<!-- Add an appropriate function subcategory here, e.g. [[Category:Adventuring]],
&lt;!-- Add an appropriate function subcategory here, e.g. [[Category:Adventuring]],
     then delete this comment --></nowiki></div>
     then delete this comment --&gt;
|}
</pre>


Data-driven function pages are incompatible with old-style function pages (i.e. ones that use [[Template:FunctionPage]]).
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.

Template parameters[Edit template data]

ParameterDescriptionTypeStatus
ASH function namename

Name of the ASH function. This should match the function page name.

Example
visit_url
Linerequired
Descriptiondescription

Long description that covers all functions. Note: Use <p></p> to separate paragraphs, because double line breaks don't work

Contentrequired
Function 1, descriptionfunction1.description

Short description for the overloaded function 1 (and so on for functions 2 through 3)

Example
Visits a web page and returns its HTML source.
Contentrequired
Function 1, return typefunction1.return_type

Return type of the overloaded function 1.

Example
buffer
Linerequired
Function 1, parameter 1function1.param1

Name of the parameter 1 of the overloaded function 1 (and so on for parameters 2 through 5).

Example
url
Lineoptional
Function 1, parameter 1 typefunction1.param1.type

Data type of the parameter 1 of the overloaded function 1.

Example
int
Lineoptional
Function 1, parameter 1 descriptionfunction1.param1.description

Description of parameter 1 of the overloaded function 1.

Example
URL of the page to visit. If a relative URL is provided, it is treated as an in-game page.
Contentoptional
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.

Example
yes
Lineoptional
Function 1, parameter 1 default valuefunction1.param1.default

If this is specified, function1.param1.optional must be "yes"

Example
""
Lineoptional
Example code 1code1

Example code showing how to use this function. Use [[Template:CodeSample]] to create sample code. (Same for code2 through code5)

Contentoptional
Equivalent gCLI commandcli_equiv

If provided, must be a gCLI command that provides functionality equivalent to this function.

Lineoptional
See Also sectionsee_also

If provided, this is used as the content for the See Also section. Use [[Template:SeeAlso]] to build a See Also section.

Contentoptional
More Information sectionmore_info

If provided, this is used as the content for the More Information section

Contentoptional
Special sectionspecial

If provided, this is used as the content for the Special section

Contentoptional
Needs code samples?needscode

If set to "yes", adds a "needs code samples" banner and categorizes the page under [[Category:Needs Code Sample]].

Lineoptional
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]].

Lineoptional

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).