View source for Help:ExpandTemplates/pt

<languages/>
{{PD Help Page|imported=yes}}
{{Special page}}

[[File:Screenshot Expand templates Βικιβιβλία.png|thumb|alt=Screenshot of MediaWiki for translation purposes.|<span lang="en" dir="ltr" class="mw-content-ltr">Screenshot of MediaWiki for translation purposes.</span>]]
<div class="mw-translate-fuzzy">
'''ExpandTemplates''' permite a expansão recursiva de modelos, funções e variáveis do analisador.
</div>

<span class="mw-translate-fuzzy">A página [[Special:ExpandTemplates/pt|Especial:Expandir Modelos]] tem duas caixas de inserção, uma para inserir texto da wiki, e outra para inserir o nome da página.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">It produces in the "Result" window the expanded wikitext, i.e., templates, parser functions and variables are expanded recursively; variables depending on pagename are expanded based on the supplied pagename.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">This is an intermediate result before a page is rendered after saving or pressing "Preview" (or the resulting wikitext is submitted to other processing), helpful in understanding and debugging wikitext expansion.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">It does not support [[Special:MyLanguage/Manual:Substitution|substitution]] (a separate expansion process [<nowiki/>[[Special:MyLanguage/Pre-save transforms|pre-save transformation]]] is carried out after entering wikitext in an edit window and pressing "Show preview" or "Save", but before regular parsing; the resulting wikitext can be inspected in an arbitrary edit window by pressing "Show changes", or by saving a test page and reopening the edit window).</span>
<span lang="en" dir="ltr" class="mw-content-ltr">If you need to use substitution, use the parse API instead of the ExpandTemplates API and enable pre-save transformations [to do this, set <code>pst</code> to <syntaxhighlight lang="json" inline>true</syntaxhighlight>].</span>

<span lang="en" dir="ltr" class="mw-content-ltr">In addition there is a preview area.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">However, this shows the rendered result of expanding the expanded wikitext again ({{task|T30616}}).</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Although the result is usually the same as after single expansion, it can be different if the first expansion produces braces.</span>

<span lang="en" dir="ltr" class="mw-content-ltr">The magic word '!' provides a way to allow "|" in a parameter value of a template or parser function, in particular for use in table syntax.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">This template can be used with ExpandTemplates to perform partial expansion/substitution.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
The table, using {{timw|2x}}, shows that a call with a parameter separator "|" in the form <nowiki>{{!}}</nowiki> prevents ordinary expansion; the last column shows the preview area (with the result of double expansion).
</div>

<span id="Usage"></span>
== Utilização ==
{| class="wikitable"
|-
! <span lang="en" dir="ltr" class="mw-content-ltr">original wikitext</span>
! <span lang="en" dir="ltr" class="mw-content-ltr">expanded wikitext</span>
! <span lang="en" dir="ltr" class="mw-content-ltr">rendering</span>
! <span lang="en" dir="ltr" class="mw-content-ltr">preview produced by ExpandTemplates</span>
|-
| <code><nowiki>{{2x|[[MediaWiki]] }}</nowiki></code>
| <code><nowiki>[[MediaWiki]] [[MediaWiki]] </nowiki></code>
| {{2x|[[MediaWiki]] }}
| {{2x|[[MediaWiki]] }}
|-
| <code><nowiki>{{2x{{!}}[[MediaWiki]] }}</nowiki></code>
| <code><nowiki>{{2x|[[MediaWiki]] }}</nowiki></code>
<td>{{2x{{!}}[[MediaWiki]] }}</td> <!-- use TD tag for correct rendering -->
<td>{{2x|[[MediaWiki]] }}</td>
|-
| <code><nowiki>{{2x{{!{{!}}}}[[MediaWiki]] }}</nowiki></code>
| <code><nowiki>{{2x{{!|}}[[MediaWiki]] }}</nowiki></code>
<td>{{2x{{!{{!}}}}[[MediaWiki]] }}</td>
<td>{{2x{{!|}}[[MediaWiki]] }}</td>
|}

<span id="Remove_comments"></span>
=== Remover comentários ===
<span lang="en" dir="ltr" class="mw-content-ltr">The "Remove comments" option selects whether comments are removed, not just in the final result but throughout the expansion process.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">This affects the result of parser functions: a comment in the expression of #expr or #ifexpr gives an error message unless "Remove comments" is on, and comments affect #if and ifeq.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
Example:
</div>

<pre>
{{#expr:<!--p-->3}}

{{#ifeq:<!--p-->3|3|1|0}}

{{#if:<!--p-->|1|0}}
</pre>

<div lang="en" dir="ltr" class="mw-content-ltr">
Normal expansion, and ExpandTemplates with "Remove comments" on:
</div>

{{#expr:<!--p-->3}}

{{#ifeq:<!--p-->3|3|1|0}}

{{#if:<!--p-->|1|0}}

<div lang="en" dir="ltr" class="mw-content-ltr">
Full substitution, and ExpandTemplates with "Remove comments" off:
</div>

<strong class="error"><span class="Pfunc_expr_unexpected_operator">Expression error: Unexpected &lt; operator</span></strong>

0

1

<span id="XML_parse_tree"></span>
=== Árvore de análise XML ===
<span lang="en" dir="ltr" class="mw-content-ltr">Optionally the XML parse tree (the [[w:Document Object Model|XML DOM]] representation of the wikitext, also called document tree or DOM tree) is shown (see also {{ll|Manual:Preprocessor_DOM.php}}).</span>
<span lang="en" dir="ltr" class="mw-content-ltr">For example:</span>

<pre>a [[b|c]]
{{CURRENTYEAR}}
{{{{{a}}}}}
{{#ifeq:2|3|a|b}}
{{#switch:a|a=3|b=4|a=5}}
{{a|b|c=d[[e|f]]g|h}}
{{{a|b}}}
{{#tag:nowiki|a=b}}
{{#tag:nowiki|aeb}}</pre>

<span lang="en" dir="ltr" class="mw-content-ltr">gives</span>

<syntaxhighlight lang="html">
<root>a [[b|c]]
<template lineStart="1"><title>CURRENTYEAR</title></template>
<template lineStart="1"><title><tplarg><title>a</title></tplarg></title></template>
<template lineStart="1"><title>#ifeq:2</title><part><name index="1"/><value>3</value></part><part><name index="2"/><value>a</value></part><part><name index="3"/><value>b</value></part></template>
<template lineStart="1"><title>#switch:a</title><part><name>a</name>=<value>3</value></part><part><name>b</name>=<value>4</value></part><part><name>a</name>=<value>5</value></part></template>
<template lineStart="1"><title>a</title><part><name index="1"/><value>b</value></part><part><name>c</name>=<value>d[[e|f]]g</value></part><part><name index="2"/><value>h</value></part></template>
<tplarg lineStart="1"><title>a</title><part><name index="1"/><value>b</value></part></tplarg></root>
<template lineStart="1"><title>#tag:nowiki</title><part><name>a</name>=<value>b</value></part></template>
<template lineStart="1"><title>#tag:nowiki</title><part><name index="1"/><value>aeb</value></part></template>
</syntaxhighlight>

<span lang="en" dir="ltr" class="mw-content-ltr">Thus:</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">The result shows a stage in processing before actual evaluation.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Thus even names of variables, parser functions, and templates have not been determined.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Also, the colon and "#" are not detected yet, so no distinction is made between variables, parser functions, and templates, let alone that there would be distinction between existing and non-existing variables, parser functions, and templates.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Therefore:</span>
**<span lang="en" dir="ltr" class="mw-content-ltr">Distinction is made between parameter items with and without "=", even though for some items of some parser functions it is treated as plain text after all.</span>
**<span lang="en" dir="ltr" class="mw-content-ltr">"|a=b|a=c" is not reduced yet to "|a=c" because the fact that the left sides are equal is only known after their evaluation, and also because this reduction depends on the evaluation of ''title''.</span> <span lang="en" dir="ltr" class="mw-content-ltr">For example, for titles of the form <code>#switch:</code>.., "|a=b|a=c" is equivalent to "|a=b" after all.</span>
*<span lang="en" dir="ltr" class="mw-content-ltr">A pair of double rectangular brackets shields "|" from being interpreted as a parameter separator, but links are not shown separately in the tree.</span>

<span id="Input_text_in_URL"></span>
=== Inserir texto no URL ===
<span lang="en" dir="ltr" class="mw-content-ltr">The wikitext serving as input can also be put in the URL, e.g., using [[m:Special:MyLanguage/Help:URL#URLs_in_external_links|urlencode]], <code><nowiki>{{fullurl:special:ExpandTemplates|wpInput={{urlencode:{{texpr{{!}}abc}}}}}}</nowiki></code> gives {{fullurl:special:ExpandTemplates|wpInput={{urlencode:{{texpr{{!}}abc}}}}}}.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">{{cnw|{|{!}|}|}}, using [[Special:MyLanguage/Help:Extension:ParserFunctions#Escaping_pipe_characters_in_tables|&lcub;&lcub;!&rcub;&rcub;]], prevents the template texpr from expanding in the URL, and also prevents "|" from being interpreted as a separator of the parameter of urlencode from a dummy second parameter.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">It can also be used in a template call without parameters, albeit that in the input box of ExpandTemplates this becomes a template with unnamed parameter {{{1}}} being the empty string instead of undefined; e.g. <code><nowiki>{{fullurl:special:ExpandTemplates|wpInput={{tc{{!}}}}}}</nowiki></code>.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">This does not work for variables and parser functions, use percent codes for one pair of braces instead (see wikitext); for the ParserFunctions prefix "#" use %23:</span>

{{canonicalurl:special:ExpandTemplates|wpInput={{((}}CURRENTTIME{{))}}}}.

{{canonicalurl:special:ExpandTemplates|wpInput={{((}}%23expr:2*3{{))}}}}.
<span id="Example"></span>
==== Exemplo ====

<span id="Query_parameters"></span>
===== Parâmetros de consulta =====
* wpContextTitle=pagetitle
* wpGenerateRawHtml=true
* wpGenerateXml=true
* wpInput=
* wpRemoveComments=true
* wpRemoveNowiki=true
URL:
*{{canonicalurl:special:ExpandTemplates|wpInput=a&wpRemoveComments=true&wpRemoveNowiki=true&wpGenerateXml=true&wpContextTitle=pagetitle&wpGenerateRawHtml=true}}

<span id="Customizing"></span>
== Personalização ==
;<span lang="en" dir="ltr" class="mw-content-ltr">Adjusting the box width</span>
<span lang="en" dir="ltr" class="mw-content-ltr">By default the width of the input and result box is only 11 characters.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">You may want to change this to full width by adding something like the following to your CSS:</span>

<syntaxhighlight lang=css>
textarea {
    border: 1px solid #2f6fab;
    color: Black;
    background-color: white;
    width: 100%;
    padding: 0.1em;
    overflow: auto;
}
</syntaxhighlight>

<span id="See_also"></span>
== Consulte também ==
* [[m:MediaWiki:Expand templates intro|Introduction into ExpandTemplates]]
* [[Special:MyLanguage/API:expandtemplates|API:expandtemplates]]

{{Special_page}}

[[Category:Special Pages{{#translation:}}]]
[[Category:Help{{#translation:}}]]