Module:Xpd

This module is invoked from Template:Xpds, Template:Xpdp, Template:Xpdws and Template:Xpdwp (w = show wikitext produced, s = same line, p = new paragraph), expansion demo templates that show the call of a variable, parser function or template, optionally its resulting wikitext, and the latter's rendering. It is also invoked from Template:Xpdplains and Template:Xpdplainp, templates that show plain wikitext and its rendering. They are used for testing and documenting variables, parser functions, templates, and wikitext and html features. The technical notes below apply partly to all templates, partly to the first four only.

For parameters with explicit positive integer names the integer is reduced by 1 in the result (just like for implicit names, due to the position taken by the template name in the calls of the templates xpds and xpdp).

Expressions for parameter values are replaced by their results.

Without affecting the result the template call is written in a normalized form:

• Values of named parameters are trimmed.
• Definitions of parameters with implicit or explicit positive integer names are ordered in ascending order. Explicit names among them are removed. These parameters are put before the remaining ones. Multiple definitions of the same parameter are replaced by the final one.
• In the parameter names and values (after the expansion mentioned above) any braces, pipes and/or equal signs are changed into {{(}}, {{)}}, {{!}}, and {{=}}, so that the parsing of the call is kept intact.

Examples:

---

{{xpds|Foreach|SeeHook|abc|4= ParserBeforeStrip |5= ParserAfterStrip |delim= / }} gives:

{{Foreach|SeeHook|abc|ParserBeforeStrip|ParserAfterStrip|delim=/}} → [[Manual:Hooks/abc{{#translation:}}|abc]]/[[Manual:Hooks/ParserBeforeStrip{{#translation:}}|ParserBeforeStrip]]/[[Manual:Hooks/ParserAfterStrip{{#translation:}}|ParserAfterStrip]]

---

Wikitext on the left

To display on the left-hand side the wikitext and not the rendering of the parameter values, some adjustments are made at that side:

• & is replaced by &
• square brackets are replaced by [ and ]
• newlines are replaced by <br>
• spaces are replaced by  

Examples:

---

{{2x|[[abc]]     }} → abc abc

---

{{xpds|2x|[[abc]] }} →

{{2x|[[abc]] }} → abc abc

---

{{2x|*abc
}} →

• abc
• abc

---

{{2x| a{{!}}b }} → a|b a|b

---

{{2x| a{{=}}b }} → a=b a=b

---

{{2x| a{{(}}{{(}}b }} → a{{b a{{b

---

{{2x| a{{)}}{{)}}b }} → a}}b a}}b

---

Limitation

Parameters with explicit or implicit positive integer names have to form a set {1, 2, .. k} without gaps. A template call with for example an undefined parameter 1 and a defined parameter 2 is not supported (where an undefined parameter should not be confused with a parameter which is assigned as value the empty string, these are supported):

{{xpds|2x|3=abc}} gives: {{2x|abc}} → abcabc

See also

• Module:Xpd
• m:Template:Xpd/doc

Notes

---

-- Expansion demo, like [[Template:Xpd]]

local p = {}

function p.f(frame, showwikitext, sep)
    local pframe, w = frame:getParent(), { '{{' }
    
    for n,v in pairs( pframe.args ) do
        if type(n) == "string" then
            table.insert( w, table.concat({ '|', p.unexpand(n), '=', p.unexpand(v) }) )
        elseif n ~= 1 then
            table.insert( w, table.concat({ '|', p.unexpand(v) }) )
        else
            table.insert( w, 2, v )
        end
    end
    
    table.insert( w, '}}' )
    w = table.concat( w )
    
    local xpw = frame:preprocess( w )
    
    w = table.concat({ '<code>', p.swt(w), '</code> → ' })
    
    if showwikitext then
        w = table.concat({ w, sep, '<code>', p.swt( xpw ), '</code> → ' })
    end
    
    w = table.concat( { w, xpw }, sep )
    return w
end
 
function p.s(frame) return p.f(frame, false, '') end
function p.p(frame) return p.f(frame, false, '\n\n') end
function p.ws(frame) return p.f(frame, true, '') end
function p.wp(frame) return p.f(frame, true, '\n\n') end

function p.unexpand(w)
    local w1 = string.gsub( w, '[{}|=]', {
        ['{'] = '{{(}}',
        ['}'] = '{{)}}',
        ['|'] = '{{!}}',
        ['='] = '{{=}}',
    }):gsub( 'lbrace', '{{(}}' ):gsub( 'rbrace', '{{)}}' )
    return w1
end
  
function p.swt(w)
    local w1 = string.gsub( w, '[&<>%[%] \n\']', {
        ['&'] = '&amp;',
        ['<'] = '&lt;',
        ['>'] = '&gt;',
        ['['] = '&#91;',
        [']'] = '&#93;',
        ["'"] = '&#39;',
        [' '] = '&nbsp;',
        ['\n'] = '<br/>',
    })
    return w1
end

function p.plain(frame, sep)
    local w = frame:getParent().args[1]
    return table.concat({ '<code>', p.swt( p.unexpand( w ) ), '</code> → ', sep, w  })
end

function p.plains(frame) return p.plain(frame, '') end
function p.plainp(frame) return p.plain(frame, '\n\n') end

return p