Predefinição:Tlx/doc
Aspeto
- Esta documentação é transcluída nas páginas das predefinições
{{Lpx}}
,{{Lpxc}}
,{{Lpxm}}
e{{Lpxw}}
{{tlx|template|first parameter|second|third|fourth|fifth|sixth|seventh|eight|ninth}}
→ {{template|first parameter|second|third|fourth|fifth|sixth|seventh|eight|ninth}}
Objetivo e nomenclatura
[editar código-fonte]Mnemonicamente 'Template link expanded'... depois
Template link'
{{tl}}
- Esta predefinição leva outro template-name e alguns associados pipe-tricked (numerados) parâmetros (ou 'parâmetros de passagem'), e os exibe como uma 'demonstração de exemplo' de como a predefinição template-name pode ser codificada, literalmente. Seu uso principal é na instrução e documentação.
- Especificidades: Até cinco parâmetros de passagem (palavras-chave numeradas ou nowiki) para o modelo especificado são exibidos como 'espaços reservados', e mais de 5 parâmetros podem ser exibidos usando uma barra vertical codificada ( como em "|..."). Um parâmetro de palavra-chave pode ser usado, quando marcado como uma palavra-chave nowiki: "<nowiki>siz=10<\nowiki>" com cada parâmetro de palavra-chave cercado por "<nowiki>" tags; ver Exemplos na base. Para mais detalhes, ver esta página de discussão.
- Exceções: Se o modelo pretendido listar vários parâmetros/palavras-chave, então talvez este modelo deva realmente não ser usado, e apenas codificar o uso com
<code><nowiki></code>, por exemplo: <code><nowiki><code><nowiki>{{Anytemplate|arg1=23|siz=250px|other parameters...}}</nowiki></code>
. Se for desejado um display vertical, com parâmetros em suas próprias linhas, isso também pode ser feito manualmente desta maneira, ou feito mais rapidamente com<pre>...</pre>
.
- Se não houver parâmetros adicionais, exceto
'template name' ({{{1}}}),
apresenta o mesmo que a semelhante {{Tl}} predefinição macro -- um link azul aninhado em chaves -- o mesmo que um usuário aplicaria o modelo sem parâmetros, mas com uma fonte e espaçamento notavelmente mais claros na maioria dos navegadores modernos.
- Comparativamente,
{{Tl}}
não terá ou exibirá parâmetros adicionais e, por motivos técnicos menores, pode ser preferido para mera listagem e referência em páginas longas envolvendo muitas expansões de predefinição.
{{Tlx}}
tem um parâmetro nomeado subst. Definir este parâmetro para qualquer cadeia de caracteres de comprimento 1 ou maior colocará a cadeia de caracteres "subst:" antes do nome da predefinição, vinculada a Ajuda:Substituição. Isso é útil para indicar quando um modelo deve ser substituído. Por exemplo{{Tlx|Welcome|subst=Y}}
exibirá{{subst:Welcome}}
.
- Além disso, Tlx terá um parâmetro 'nomeado' 'SISTER' para vincular o interwiki a outros projetos irmãos, como um destes exemplos: '|SISTER=W:', 'Tlx|SISTER=M:', 'Tlx|SISTER=Q:', 'Tlx|SISTER=S:', permitindo documentação ou discurso sobre uma predefinição através dos limites interwiki. Pequenas predefinições de cartucho ou conveniência de 'front-end'
{{Tlxw}}
and{{Tlxm}}
são predefinições de auxílio à digitação disponíveis no Meta para substituição automática em discussões sobre predefinições na Wikipédia ou no Meta.
Esse uso também se aplica a variações de predefinições compatíveis com interwiki:
- {{Tlxc}} -- que contém links para predefinições na Wikimedia Commons (O Commons).
- {{Tlxm}} -- que contém links para predefinições no Meta
- {{Tlxw}} -- que contém links para predefinições na Wikipédia
Documentação
[editar código-fonte]{{Tlx/doc}} é uma generalização de Predefinição:Tlxw, Predefinição:Tlxw, etcétera com indiscutivelmente melhor saída legível. Isso depende do navegador, mas muito estreitos os usos de "{", "|", "}" em conjunto com links pode ser difícil de ler.
Uso
[editar código-fonte]{{Tlx/doc|template name}}
{{Tlx/doc|template name|param}}
{{Tlx/doc|template name|1|2|3}}
{{Tlx/doc|template name|1|2|3|more}}
{{Tlx/doc|template name|param=value}}
Até três espaços reservados para parâmetros da predefinição especificada
Exemplos
[editar código-fonte]- Nota
- Nos projetos irmãos de origem, en.wikipedia e Meta, X0, X1, X2,..., X9 são predefinições de caixa de areia para experimentação em predefinições envolvidas que precisam estar no espaço da predefinição. Existe uma instalação de software de limpeza automática que pode ser usada para duplicar a instalação em outros projetos irmãos.
Código | Resultado | Observação |
---|---|---|
{{Tlx|x0}}
|
{{x0}}
|
|
{{Tlx|Abc}}
|
{{Abc}}
|
|
{{Tlx|ABC}}
|
{{ABC}}
|
|
{{Tlx|AbC}}
|
{{AbC}}
|
|
{{Tlx|x1|one}}
|
{{x1|one}}
|
|
{{Tlx|x2|one|two}}
|
{{x2|one|two}}
|
|
{{Tlx|x3|1
|
{{x3|1|2|3}}
|
|
{{Tlx|x4|1
|
SISTER=W:|x4|1|2|3|4}} | acima de 5 parâmetros, então ... |
{{Tlx|x4|1
|
{{x4|1|2|3|4}}
|
| para mais
|
{{Tlx|x1|x=u}}
|
{{x1}}
|
= não funcionará |
{{Tlx|x1|x=u}}
|
{{x1|x=u}}
|
= está tudo bem
|
{{Tlx|x1|x{{=}}u}}
|
{{x1|x=u}}
|
{{=}} está tudo bem
|
{{Tlx|x1|<nowiki>x=u</nowiki>}}
|
{{x1|x=u}}
|
nowiki pegajoso está tudo bem |
{{Tlx|x2| |two}}
|
{{x2|two}}
|
vazio não funcionará |
{{Tlx|x2| |two}}
|
{{x2| |two}}
|
  está tudo bem
|
{{Tlx|x2| |two}}
|
{{x2| |two}}
|
está tudo bem
|
{{Tlx|x2| | two}}
|
{{x2| | two}}
|
| está tudo bem
|
{{Tlx|x2| {{!}} two}}
|
{{x2| | two}}
|
{{!}} está duvidoso
|
{{Tlx|x2|2=|3=two}}
|
{{x2|two}}
|
vazio realmente não funciona |
{{Tlx|x2|2=one|two}}
|
{{x2|two}}
|
duas substituições "2=one" |
{{Tlx|x2|3=two|2=one}}
|
{{x2|one|two}}
|
da direita para a esquerda tudo bem |
Ver também
[editar código-fonte]{{Ligação para predefinição}}
- para criar ligações para outras predefinições sem a necessidade de parâmetros;{{Lpu}}
ou{{tlu}}
– para ligações semelhantes a páginas que não são predefinições;{{Lpp}}
ou{{tlp}}
– para indicar a necessidade de um parâmetro;{{Lps}}
ou{{tls}}
– para indicar que a predefinição deve ser substituída;{{Tn}}
- igual a Predefinição:Tld mas com os colchetes como parte do link;{{tlf}}
ou{{tld}}
ou{{tlc}}
- para citar a predefinição sem o link para a mesma;