Template:Lua autodoc

Template documentation[view] [edit] [history] [purge]

Usage

{{Lua autodoc|file=Module name}}

Examples

{{Lua autodoc|file=Docbunto|code=yes}} yields: Template:Ctop

Package items

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( mod_name, options ) (function)

Docbunto taglet parser for Scribunto modules.

Parameters:

mod_name Module page name (without namespace). (string; optional)

options Configuration options. (table; optional)

Errors:

'Lua source code not found in $1' (string; line 971)

'documentation markup for Docbunto not found in $1' (string; line 977)

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.

{{Lua autodoc|file=Example|code=yes}} yields: Template:Ctop

Package items

example.hello( frame ) (function)

Hello world function

Parameter: frame current frame (table)

Returns: Hello world

example.hello_to( frame ) (function)

Hello world function

Parameters:

frame current frame (table)

frame.args[1] name (string)

Returns: Hello world

example.count_fruit( frame ) (function)

Counts fruit

Parameters:

frame current frame (table)

frame.args.bananas number of bananas (string)

frame.args.apples number of apples (string)

Returns: Number of apples and bananas

example.Name2( frame ) (function)

Name2

Parameter: frame current frame (table)

Returns: Some output

{{Lua autodoc|file=Sandbox|code=yes}} yields: Template:Ctop Template:Cbot

Template data

No description.

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

The above documentation is transcluded from Template:Lua autodoc/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this template.