From Wikipedia, the free encyclopedia
(Redirected from Template:Docbunto )
This template uses Lua :
{{Lua autodoc |file=Module name}}
{{Lua autodoc |file=Docbunto|code=yes}}
yields:
docbunto._main(args)
(function )
Entrypoint for the module in a format easier for other modules to call.
Parameter : args
Module arguments. (table )
Returns : Module documentation output. (string )
docbunto.main(frame)
(function )
Entrypoint for the module.
Parameter : frame
Module frame. (table )
Returns : Module documentation output. (string )
docbunto.build(modname , options )
(function )
Scribunto documentation generator entrypoint.
Parameters :
modname
Module page name (without namespace). Default: second-level subpage. (string ; optional)
options
Configuration options. (table ; optional)
options.all
Include local items in documentation. (boolean ; optional)
options.autodoc
Whether this is being called automatically to fill in missing documentation. (boolean ; optional)
options.boilerplate
Removal of boilerplate (license block comments). (boolean ; optional)
options.caption
Infobox image caption. (string ; optional)
options.code
Only document Docbunto code items - exclude article infobox and lede from rendered documentation. Permits article to be edited in VisualEditor. (boolean ; optional)
options.colon
Format tags with a :
suffix and without the @
prefix. This bypasses the "doctag soup" some authors complain of. (boolean ; optional)
options.image
Infobox image. (string ; optional)
options.noluaref
Don't link to the Lua reference manual for types. (boolean ; optional)
options.plain
Disable Markdown formatting in documentation. (boolean ; optional)
options.preface
Preface text to insert between lede & item documentation, used to provide usage and code examples. (string ; optional)
options.simple
Limit documentation to descriptions only. Removes documentation of subitem tags such as @param
and @field
(see list ). (boolean ; optional)
options.sort
Sort documentation items in alphabetical order. (boolean ; optional)
options.strip
Remove table index in documentation. (boolean ; optional)
options.ulist
Indent subitems as <ul>
lists (LDoc/JSDoc behaviour). (boolean ; optional)
docbunto.taglet(modname , options )
(function )
Docbunto taglet parser for Scribunto modules.
Parameters :
modname
Module page name (without namespace). (string ; optional)
options
Configuration options. (table ; optional)
Errors :
'Lua source code not found in $1' (string ; line 938)
'documentation markup for Docbunto not found in $1' (string ; line 944)
Returns : Module documentation data. (table )
docbunto.doclet(data, options )
(function )
Doclet renderer for Docbunto taglet data.
Parameters :
data
Taglet documentation data. (table )
options
Configuration options. (table ; optional)
Returns : Wikitext documentation output. (string )
docbunto.tags
(table )
Token dictionary for Docbunto tags. Maps Docbunto tag names to tag tokens.
Multi-line tags use the 'M'
token.
Multi-line preformatted tags use the 'ML'
token.
Identifier tags use the 'ID'
token.
Single-line tags use the 'S'
token.
Flags use the 'N'
token.
Type tags use the 'T'
token.
Template parameters[ Edit template data ]
This template prefers block formatting of parameters.
Parameter Description Type Status Module Name 1
file
Module page name (without namespace).
Default: First sub-page of the "Global Lua Modules" root page or the top-level page name.
String suggested Infobox Image image
Infobox image.
File optional Caption caption
Infobox image caption.
Content optional All all
Include private items in documentation.
Default false Boolean optional Boilerplate boilerplate
Removal of boilerplate (license block comments).
Default false Boolean optional Code code
Only document Docbunto code items - exclude article infobox and lede from rendered documentation.
Default false Boolean optional Colon colon
Parses tags with a `:` suffix and without the `@` prefix. This bypasses the "doctag soup" some authors complain of.
Default false Boolean optional No Lua Reference noluaref
Don't link to the Lua reference manual for types.
Default false Boolean optional Plain plain
Disable Markdown formatting in documentation.
Default false Boolean optional Simple simple
Limit documentation to descriptions only. Removes documentation of subitem tags such as `@param` and `@field`.
Default false Boolean optional Sort sort
Sort documentation items in alphabetical order instead of source code order.
Default false Boolean optional Strip strip
Remove table index in documentation.
Default false Boolean optional UList ulist
Indent subitems as `<ul>` lists (LDoc/JSDoc behaviour) instead of `<dl>` list.
Default false Boolean optional Preface preface
Preface text to insert between lede & item documentation, used to provide usage and code examples.
Content suggested