Module:RQ:pi:Sai Kam Mong/documentation

Invoking this module as {{#invoke:RQ:pi:Sai Kam Mong|quote|a|b|c|passages=xxx}} is equivalent to invoking a template as {{{{yyy}} quote|a|b|c}}, for some yyy, so please read that template for usage. If the argument passages is omitted, the effect is equivalent to invoking the template as {{RQ:pi:Sai Kam Mong quote|a|b|c}}.

The templates and modules for the use of this come in sets of three - a citation selection template, a data module, and a display template.

The citation selection template simply invokes this module's function quote; module invocations are not allowed in the main space pages, but must be wrapped in a template. This function accesses and manipulates the data in the data module, while the display template can function independently of it and the the data.

Wiktionary requests that each template and module have a documentation page. For the first two, boilerplate templates {{RQ:pi:Sai Kam Mong/quote boilerplate|human-language-documented|data-module-name|sample-page-no|sample-passage-id|sample-word-number|passages=data-module-name}} and {{RQ:pi:Sai Kam Mong/passage boilerplate|human-language-documented|data-module-name|sample-page-no|sample-passage-id|sample-word-number}} provide most of this documentation. The boilerplate templates require that name of the citation slection template be the name of the data module augmented by the word 'quote'. The display template's documentation is less stereotyped, and adaptation of one set's to a new set's must be done manually. Adapting the example looks daunting, but is not as difficult as it looks. The trick is to start from the bottom and work up.

Existing sets include:

Citation selection template	Data module	Display template
{{RQ:pi:N3207 quote}}	{{Module:RQ:pi:N3207}}	{{RQ:pi:N3207}}
{{RQ:pi:Phaya Luang Maha Sena quote}}	{{Module:RQ:pi:Phaya Luang Maha Sena}}	{{RQ:pi:Phaya Luang Maha Sena}}
{{RQ:pi:Sai Kam Mong quote}}	{{Module:RQ:pi:Sai Kam Mong/passages}}	{{RQ:pi:Sai Kam Mong}}
{{RQ:pi:Thai chant book quote}}	{{Module:RQ:pi:Thai chant book}}	{{RQ:pi:Thai chant book}}
{{RQ:pi:U17106 quote}}	{{Module:RQ:pi:U17106}}	{{RQ:pi:U17106}}

If creating a new set, the 'Sai Kam Mong' set would be a bad set to start from, as for historical reasons, it has different and confusing naming conventions. Some of these issues are worked round by the defaults in the documentation templates.