Diferenças entre edições de "Predefinição:Citar(pp)/doc"

Da Thinkfn
< Predefinição:Citar(pp)

Deprecated: The each() function is deprecated. This message will be suppressed on further calls in /home1/thinkfnw/public_html/wiki/includes/diff/DairikiDiff.php on line 390
(Nova página: Use a predefinição <code><nowiki>{{citar(pp)}}</nowiki></code> exclusivamente para fazer citações na página Thinkfn Discussão:Página principal/Citação, cujo conteúdo é i...)
 
Linha 1: Linha 1:
Use a predefinição <code><nowiki>{{citar(pp)}}</nowiki></code> exclusivamente para fazer citações na página [[Thinkfn Discussão:Página principal/Citação]], cujo conteúdo é incluído na [[página principal]]. Esta predefinição impõe certas formatações ao texto, específicas à formatação da página principal e à sua integração em tabelas. Não deve, portanto, ser usada nos artigos normais pois alterações futuras poderão ter efeitos inesperados nos artigos.
+
<noinclude>{{documentation}}</noinclude>
 +
Use esta predefinição exclusivamente para fazer citações na página [[Thinkfn Discussão:Página principal/Citação]], cujo conteúdo é incluído na [[página principal]]. A predefinição impõe certas formatações ao texto, específicas à formatação da página principal e à sua integração em tabelas. Não deve, portanto, ser usada nos artigos normais pois alterações futuras poderão ter efeitos inesperados nos artigos.
  
A forma desta predefinição é:
+
A forma da predefinição é:
  
 
:<code><nowiki>{{citar(pp)|frase|autor}}</nowiki></code>
 
:<code><nowiki>{{citar(pp)|frase|autor}}</nowiki></code>

Revisão das 10h47min de 21 de março de 2009

Predefinição
código | documentação | categoria | parâmetros | desenvolvimento | testes


Esta é a página da documentação. O texto abaixo será sempre apresentado na página do código, para que quem consulte o código da predefinição veja também a documentação.

Nota: Se está a criar esta página pela primeira vez, ela já foi pré-preenchida com o modelo que deve seguir. Siga-o, por favor. Não categorize esta página. Coloque a categoria da predefinição na página da categoria.

Use esta predefinição exclusivamente para fazer citações na página Thinkfn Discussão:Página principal/Citação, cujo conteúdo é incluído na página principal. A predefinição impõe certas formatações ao texto, específicas à formatação da página principal e à sua integração em tabelas. Não deve, portanto, ser usada nos artigos normais pois alterações futuras poderão ter efeitos inesperados nos artigos.

A forma da predefinição é:

{{citar(pp)|frase|autor}}

Tanto no parâmetro frase como no parâmetro autor podem ser incluídos links para artigos. Não use quaisquer códigos de formatação nestes parâmetros.

Exemplo

Por exemplo:

{{citar(pp)|Frase a citar|Autor}}

resulta na seguinte citação:

Início de citação Frase a citar Fim de citação
Autor

Exemplo 2

Podem ser usados links tanto na frase a citar como no autor. Por exemplo:

{{citar(pp)|Esta predefinição só deve ser usada na página [[Thinkfn Discussão:Página principal/Citação]]. Obrigado.|Equipa do [[Think Finance]]}}

resulta no seguinte:

Início de citação Esta predefinição só deve ser usada na página Thinkfn Discussão:Página principal/Citação. Obrigado. Fim de citação
Equipa do Think Finance

Casos de teste

Os seguintes exemplos são casos de teste, usados pela equipa do Think Finance no desenvolvimento e manutenção desta predefinição. Permitem testar o comportamento da predefinição em casos limite. Mesmo nestes casos, a predefinição deverá ter um comportamento elegante para o leitor.

Sem argumentos

{{citar(pp)}}

resulta no seguinte (a próxima linha deverá estar vazia):

Demasiados argumentos

{{citar(pp)|Frase a citar|Autor|parâmetro 3}}

resulta no seguinte (parâmetros em excesso devem ser ignorados):

Início de citação Frase a citar Fim de citação
Autor

Quebra de linha

{{citar(pp)|Uma quebra de linha deverá acontecer sempre que a frase a citar seja extensa e, portanto, exceda em comprimento a largura do ecrã do leitor. Deverá ser esse o caso nesta frase, a menos que o leitor disponha de um ecrã invulgarmente largo.|No que concerne o autor, normalmente quer-se referir apenas o seu nome. No entanto, por vezes é vantajoso incluir um texto para contextualizar a citação. Se esse texto for extenso, acontece isto.}}

resulta no seguinte:

Início de citação Uma quebra de linha deverá acontecer sempre que a frase a citar seja extensa e, portanto, exceda em comprimento a largura do ecrã do leitor. Deverá ser esse o caso nesta frase, a menos que o leitor disponha de um ecrã invulgarmente largo. Fim de citação
No que concerne o autor, normalmente quer-se referir apenas o seu nome. No entanto, por vezes é vantajoso incluir um texto para contextualizar a citação. Se esse texto for extenso, acontece isto.