Mudanças entre as edições de "Predefinição:Documentação"

De Sala Virtual Brusque
Ir para navegaçãoIr para pesquisar
 
(3 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 1: Linha 1:
<div class="template-documentation">{{#ifeq:{{{heading|μ}}}|<!--*Definido mas vazio**-->
+
<div class="template-documentation"><!--
 +
 
 +
Esta é a definição literal da classe no common.css:
 +
 +
/* Para a documentação das predefinições */
 +
.template-documentation {
 +
    clear: both;
 +
    margin: 1em 0 0 0;
 +
    border: 1px solid #C0C0C0;
 +
    background-color: #ECFCF4;
 +
    padding: 1em;
 +
}
 +
 
 +
-->{{#ifeq:{{{heading|μ}}}|<!--*Definido mas vazio**-->
 
   |<!--**Nenhum**-->
 
   |<!--**Nenhum**-->
 
   |<div style="padding-bottom:3px; border-bottom: 1px solid #aaa; margin-bottom:1ex">{{#ifeq:{{{content|{{{conteúdo|μ}}}}}}|μ
 
   |<div style="padding-bottom:3px; border-bottom: 1px solid #aaa; margin-bottom:1ex">{{#ifeq:{{{content|{{{conteúdo|μ}}}}}}|μ
Linha 6: Linha 19:
 
     |<!--**/doc NÃO EXISTE**-->[[{{fullurl:{{{1|{{Documentação/nomedoc}}}}}|action=edit&preload=Predefinição:Documentação/preload}} criar]]
 
     |<!--**/doc NÃO EXISTE**-->[[{{fullurl:{{{1|{{Documentação/nomedoc}}}}}|action=edit&preload=Predefinição:Documentação/preload}} criar]]
 
   }}</span>
 
   }}</span>
   }} <span style="{{#if:{{{heading-style|}}}|{{{heading-style}}}|{{#ifeq:{{NAMESPACE}}|{{ns:template}}|font-weight: bold; font-size: 125%|font-size: 150%}}}}">{{#if:{{{heading|}}}|{{{heading}}}|[[Imagem:Template-info.svg|50px|link=Wikipedia:Documentação da predefinição]] Documentação{{#ifeq:{{NAMESPACE}}|{{ns:template}}|<nowiki> </nowiki>da predefinição}}}}</span></div>
+
   }} <span style="{{#if:{{{heading-style|}}}|{{{heading-style}}}|{{#ifeq:{{NAMESPACE}}|{{ns:template}}|font-weight: bold; font-size: 125%|font-size: 150%}}}}">{{#if:{{{heading|}}}|{{{heading}}}|[[Imagem:Template-info.png|50px|link=Wikipedia:Documentação da predefinição]] Documentação{{#ifeq:{{NAMESPACE}}|{{ns:template}}|<nowiki> </nowiki>da predefinição}}}}</span></div>
 
  }}<!--
 
  }}<!--
  
Linha 36: Linha 49:
 
}}}}
 
}}}}
 
<div style="clear: both;"></div>
 
<div style="clear: both;"></div>
</div><noinclude>
+
</div>
 
 
 
 
<!-- Adicione categorias e interwikis na documentação, não aqui. -->
 
[[als:Vorlage:Dokumentation]]
 
[[ar:قالب:توثيق]]
 
[[ba:Ҡалып:Doc]]
 
[[bar:Vorlage:Dokumentation]]
 
[[bg:Шаблон:Документация]]
 
[[bs:Šablon:Dokumentacija]]
 
[[ca:Plantilla:Ús de la plantilla]]
 
[[ckb:داڕێژە:Documentation]]
 
[[cs:Šablona:Dokumentace]]
 
[[cy:Nodyn:Doc]]
 
[[da:Skabelon:Dokumentation]]
 
[[de:Vorlage:Dokumentation]]
 
[[diq:Template:Documentation]]
 
[[dsb:Pśedłoga:Dokumentacija]]
 
[[el:Πρότυπο:Τεκμηρίωση προτύπου]]
 
[[en:Template:Documentation]]
 
[[eo:Ŝablono:Dok]]
 
[[es:Plantilla:Documentación]]
 
[[et:Mall:Dokumentatsioon]]
 
[[eu:Txantiloi:Txantiloi dokumentazioa]]
 
[[fa:الگو:توضیحات]]
 
[[fr:Modèle:Documentation]]
 
[[gl:Modelo:Uso de marcador]]
 
[[he:תבנית:תיעוד]]
 
[[hsb:Předłoha:Dokumentacija]]
 
[[hu:Sablon:Sablondokumentáció]]
 
[[hy:Կաղապար:Փաստաթղթեր]]
 
[[ia:Patrono:Documentation]]
 
[[id:Templat:Dokumentasi]]
 
[[it:Template:Man]]
 
[[ja:Template:Documentation]]
 
[[ko:틀:틀 설명문서]]
 
[[ku:Şablon:Belgekirin]]
 
[[la:Formula:Documentation]]
 
[[ltg:Taiss:Dokumentaceja]]
 
[[ml:ഫലകം:വിവരണം]]
 
[[nds-nl:Mal:Dokumentatie]]
 
[[nl:Sjabloon:Sjabdoc]]
 
[[no:Mal:Dokumentasjon]]
 
[[nso:Template:Documentation]]
 
[[pl:Szablon:Dokumentacja]]
 
[[ro:Format:Documentație]]
 
[[ru:Шаблон:Doc]]
 
[[simple:Template:Documentation]]
 
[[sk:Šablóna:Dokumentácia]]
 
[[sl:Predloga:Dokumentacija]]
 
[[sq:Stampa:Dokumentacion]]
 
[[sr:Шаблон:Документација]]
 
[[stq:Foarloage:Dokumentation]]
 
[[sv:Mall:Dokumentation]]
 
[[sw:Kigezo:Documentation]]
 
[[te:మూస:Documentation]]
 
[[tl:Suleras:Documentation]]
 
[[tpi:Template:Template doc]]
 
[[tr:Şablon:Belgeleme]]
 
[[tt:Калып:Doc]]
 
[[uk:Шаблон:Документація]]
 
[[ur:سانچہ:Documentation]]
 
[[war:Template:Documentation]]
 
[[yo:Àdàkọ:Aṣàlàyé]]
 
[[zh:Template:Documentation]]
 
</noinclude>
 

Edição atual tal como às 14h52min de 12 de março de 2012

[editar] [purgar] Template-info.png Documentação da predefinição

Esta predefinição mostra uma caixa de "Documentação da predefinição" tal como a que está a ver neste momento, cujo conteúdo é importado de outra página.

Utilização

<noinclude>{{Documentação}}</noinclude>
  1. Adicione <noinclude>{{Documentação}}</noinclude> logo abaixo do código da predefinição que você quer documentar e salve a modificação.
  2. Na caixa de documentação que surge na página da predefinição, clique em criar. Será criada uma página de documentação a partir de um modelo, com nome equivalente a Predefinição:nome da predefinição/doc. Introduza o texto da documentação nesta página.
  3. As categorias e interwikis das predefinições devem ser adicionadas na página da documentação respectiva e não na página da predefinição. As categorias e interwikis devem ser colocadas dentro das tags <includeonly> </includeonly>.

Outras opções de uso

Qualquer página /doc

<noinclude>{{Documentação|Predefinição:Qualquer página/doc}}</noinclude>

Contéudo na mesma linha

<noinclude>{{Documentação|conteúdo=Esta é uma documentação}}</noinclude>

Contéudo na mesma linha com links [ver] e [editar]

<noinclude>{{Documentação
|1= Predefinição:Qualquer página/doc
|conteúdo= {{Predefinição:Qualquer página/doc|parâmetros}}
}}</noinclude>

Boas práticas

  • Uma destas opções de código deve ser adicionada logo após o texto da predefinição, sem nenhum espaço antes da tag "<noinclude>" (o que causaria um espaço extra nas páginas onde a predefinição é usada). Parâmetros adicionais podem ser usados como mostrado acima para transcluir uma página de documentação arbitrária.
  • Se a página de documentação inclui tags "<includeonly>" ou "<noinclude>" como parte da documentação, substitua o "<" por "&lt;" ou coloque-as entre <nowiki></nowiki>.

Personalizando

Em casos especiais é possível personalizar a apresentação:

  • {{documentação|heading= ...}} − altera o texto do título da documentação. Se for definida como vazia, o título inteiro, incluindo o link [editar], também desaparecerão.

Funções

A utilização da {{Documentação}} nas predefinições possibilita que elas sejam protegidas quando necessário, não impedindo que qualquer um edite a documentação, categorias e interwikis, uma vez que ficam em um página à parte.

Caso a página de documentação não exista, clicando-se no link [criar] é gerado um modelo pré-carregado com o formato básico para uma página de documentação, facilitando o processo.

Ver também

Informações sobre documentação de predefinições
Família de predefinições de documentação
Predefinição:Documentação/doc (afluentes, editar)
Predefinição:Documentação/Ver também (afluentes, editar)
Predefinição:Documentação/nomedoc (afluentes, editar)
Predefinição:Documentação/preload (afluentes, editar)
Documentação ancestral do Meta Wiki