Predefinição:Citar(pp)/doc

Use a predefinição {{citar(pp)}} 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.

A forma desta 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:

	Frase a citar
	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:

	Esta predefinição só deve ser usada na página Thinkfn Discussão:Página principal/Citação. Obrigado.
	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):

	Frase a citar
	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:

	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.