Template:Scribunto/doc

From Hârn
Jump to navigation Jump to search

Usage[edit source]

This helps with the creation of doc pages for Lua metamodules that reference the Scribunto manual or specific function within it.

{{scribunto
|<!--anchor-->
|<!--link text-->
}}

If an anchor is provided, the link will be wrapped in TAG. For example:

{{scribunto|mw.html.create}}

produces this link:  mw.html.create

{{scribunto|HTML_library|mw.html}}

produces this link: mw.html

Advanced[edit source]

|self= and |args=[edit source]

You may also use |self={{PAGENAME}} to reference your own functions and |args= to specify args, like so:

{{scribunto|self=Buffer/doc|:_all|args=...}}

produces this link:  Buffer:_all( ... )

If the first char matches the pattern ^[:%.] then title specified by |self= will be inserted in front, minus any subpages, unless escaped with the \ char:

{{scribunto|self=Example\/testcases/doc|.test1|args=string}}

produces:  Example/testcases.test1( string )

no 'main'[edit source]

If your module has no "main" method (e.g. Module:Buffer), you can pass the escape char \ as the first char in the function name to make a self-reference:

{{scribunto|self=Buffer/doc|\|args=...}}

produces:  Buffer( ... )' If the second parameter contains ***, then the first param will be substituted (or the self-reference, as applicable):

{{scribunto|self=Buffer|\|require('Module:***')|args=...}}

require('Module:Buffer')( ... )

args2 and args3[edit source]

Use to specify up to 3 argument variations.

{{scribunto|table.insert|args=table, value|args2=table, pos, value}}

table.insert( table, value )
table.insert( table, pos, value )

|plain=[edit source]

If set to anything, the result will no longer be wrapped in TAG.

See also[edit source]

External links[edit source]