Diferenças entre edições de "Predefinição:Chamada para artigo (pp)"

Da Thinkfn
Linha 56: Linha 56:
 
   | <div style="color:#888888; font-size:85%">{{{autor}}}</div>
 
   | <div style="color:#888888; font-size:85%">{{{autor}}}</div>
 
   | }}</includeonly><noinclude>__NOTOC__
 
   | }}</includeonly><noinclude>__NOTOC__
Esta predefinição é usada para fazer chamadas de destaque para artigos, na página principal, deste tipo:
+
Esta predefinição é usada na página principal para fazer chamadas de destaque para artigos, deste tipo:
  
{| width=50% align=center
+
{| width=90% align=center
 
|-
 
|-
|
+
| width=33% |
 
{{chamada para artigo (pp)
 
{{chamada para artigo (pp)
 
|categoria=Biografias
 
|categoria=Biografias
Linha 70: Linha 70:
 
|y=74px
 
|y=74px
 
|posição=esquerda
 
|posição=esquerda
 +
}}
 +
| width=33% |
 +
{{chamada para artigo (pp)
 +
|categoria=Biografias
 +
|artigo=Jim Rogers
 +
|texto='''James B. Rogers, Jr.''' - mais conhecido como Jim Rogers (nascido a 19 de Outubro de 1942) é um investidor americano. Foi co-fundador, com [[George Soros]], do Quantum Fund, e criou o Rogers International Commodities Index (RICI)
 +
|autor=Incognitus, Out 2008
 +
|imagem=JimRogers.jpg
 +
|x=60px
 +
|y=74px
 +
|posição=topo
 +
}}
 +
| width=33% |
 +
{{chamada para artigo (pp)
 +
|categoria=Biografias
 +
|artigo=Jim Rogers
 +
|texto='''James B. Rogers, Jr.''' - mais conhecido como Jim Rogers (nascido a 19 de Outubro de 1942) é um investidor americano. Foi co-fundador, com [[George Soros]], do Quantum Fund, e criou o Rogers International Commodities Index (RICI)
 +
|autor=Incognitus, Out 2008
 +
|imagem=JimRogers.jpg
 +
|x=60px
 +
|y=74px
 +
|posição=direita
 
}}
 
}}
 
|}
 
|}
Linha 90: Linha 112:
  
 
==Parâmetros==
 
==Parâmetros==
* <code>categoria</code> - a [[Especial:Categorias|categoria]] do artigo. Se omitida, nada. Por exemplo, <code>Conceitos</code>.
+
Os parâmetros desta predefinição podem tomar os seguintes valores:
* <code>artigo</code> - o nome do artigo. Se omitido, nada, não será colocado um ''link'' para o artigo na imagem, nem será colocado o ''link'' para o artigo no final do texto.
+
 
* <code>texto</code> - o texto introdutório do artigo. Se omitido, nada.
+
* <code>categoria</code>
* <code>autor</code> - o [[Especial:Utilizadores|autor]] (se conhecido) do artigo e o mês (formato Mmm) e ano de criação &mdash; por exemplo, <code>Autor, Out 2007</code>. Se omitido, nada.
+
** a [[Special:Categories|categoria do artigo]] &mdash; por exemplo, <code>categoria=Conceitos</code>.
* <code>imagem</code> - o nome da [[Especial:Ficheiros|imagem]] (sem o ''namespace'') com que deseja ilustrar a categoria. Por omissão deste parâmetro será assumido o logo do Think Finance. Por exemplo, <code>Tf_logo.gif</code>.
+
** por omissão, não será mostrada qualquer categoria.
* <code>x</code> - a largura desejada para a imagem em pixéis (px). Na página principal a largura deve ser sempre <code>120px</code>. Por omissão deste parâmetro, será assumida a largura do logo do Think Finance, <code>121px</code>. Caso não tenha sido passado o parâmetro <code>imagem</code> este parâmetro é ignorado e adoptada a largura por omissão.
+
* <code>artigo</code>
* <code>y</code> - a altura desejada para a imagem em pixéis (px). Calcular desta forma: <code>120*altura original/largura original</code>. Arredondar para cima. Por omissão deste parâmetro, será assumida a altura do logo do Think Finance, <code>85px</code>. Caso não tenha sido passado o parâmetro <code>imagem</code>, este parâmetro é ignorado e adoptada a altura por omissão.
+
** o nome do artigo &mdash; por exemplo, <code>artigo=Futuro</code>.
* <code>posição</code> - pode ter os seguintes valores:
+
** por omissão, não será mostrado o ''link'' principal para um artigo (abaixo da categoria), o ''link'' da imagem não apontará para um artigo, e não será colocado o ''link'' para um artigo no final do texto.
** ''<code>esquerda</code>'' - a imagem é colocada no topo à esquerda.
+
* <code>texto</code>
** ''<code>direita</code>'' - a imagem é colocada no topo à direita. Este é o valor assumido por omissão.
+
** o texto introdutório do artigo &mdash; ver exemplos nesta página.
** ''<code>topo</code>'' - a imagem é colocada no topo, ao centro. '''''NOTA: Não implementado!'''''
+
** por omissão, não será mostrado qualquer texto.
 +
* <code>autor</code>
 +
** o [[Special:Listusers|autor do artigo]], se conhecido, e a data de criação &mdash; por exemplo, <code>autor=Hermes, Out 2007</code>.
 +
** por omissão, não será mostrado qualquer autor ou data.
 +
* <code>imagem</code>
 +
** <code>imagem=nenhuma</code> - não é mostrada qualquer imagem
 +
** o [[Especial:Imagelist|nome da imagem]] (sem o ''namespace'') com que deseja ilustrar a categoria &mdash; por exemplo, <code>imagem=Tf_logo.gif</code>.
 +
** por omissão, será assumido o logo do Think Finance.
 +
* <code>x</code>
 +
** a largura desejada para a imagem em pixéis (px) &mdash; na página principal a largura deve ser sempre <code>x=120px</code>.
 +
** por omissão, será assumida a largura <code>x=120px</code>.
 +
** ''NOTA: caso não tenha sido passado o parâmetro <code>imagem</code>, o parâmetro <code>x</code> é ignorado e adoptada a largura por omissão.''
 +
* <code>y</code>
 +
** a altura desejada para a imagem em pixéis (px) &mdash; para manter proporções, calcular desta forma: <code>x*''altura original da imagem/largura original da imagem''</code> e arredondar para cima.
 +
** por omissão, será assumida a altura <code>y=85px</code>.
 +
** ''NOTA: caso não tenha sido passado o parâmetro <code>imagem</code>, o parâmetro <code>y</code> é ignorado e adoptada a altura por omissão.''
 +
* <code>posição</code>
 +
** <code>posição=esquerda</code> - a imagem é colocada no topo à esquerda.
 +
** <code>posição=direita</code> - a imagem é colocada no topo à direita.
 +
** <code>posição=topo</code> - a imagem é colocada no topo, ao centro.
 +
** por omissão, o valor assumido é <code>posição=direita</code>.
  
 
==Exemplo==
 
==Exemplo==
O exemplo da introdução foi conseguido com o seguinte código:
+
Os exemplos acima são obtidos com o seguinte código:
  
 
:<code><nowiki>{{chamada para artigo (pp)</nowiki><br /><nowiki>
 
:<code><nowiki>{{chamada para artigo (pp)</nowiki><br /><nowiki>
Linha 115: Linha 157:
 
| posição=esquerda</nowiki><br /><nowiki>
 
| posição=esquerda</nowiki><br /><nowiki>
 
}}</nowiki></code>
 
}}</nowiki></code>
 +
 +
fazendo variar o parâmetro <code>posição</code> entre <code>posição=esquerda</code>, <code>posição=topo</code> e <code>posição=direita</code>, respectivamente.
  
 
==Casos de teste==
 
==Casos de teste==

Revisão das 08h51min de 30 de outubro de 2008

Esta predefinição é usada na página principal para fazer chamadas de destaque para artigos, deste tipo:

James B. Rogers, Jr. - mais conhecido como Jim Rogers (nascido a 19 de Outubro de 1942) é um investidor americano. Foi co-fundador, com George Soros, do Quantum Fund, e criou o Rogers International Commodities Index (RICI) (...)
Incognitus, Out 2008
James B. Rogers, Jr. - mais conhecido como Jim Rogers (nascido a 19 de Outubro de 1942) é um investidor americano. Foi co-fundador, com George Soros, do Quantum Fund, e criou o Rogers International Commodities Index (RICI) (...)
Incognitus, Out 2008
James B. Rogers, Jr. - mais conhecido como Jim Rogers (nascido a 19 de Outubro de 1942) é um investidor americano. Foi co-fundador, com George Soros, do Quantum Fund, e criou o Rogers International Commodities Index (RICI) (...)
Incognitus, Out 2008

A predefinição coloca uma imagem numa determinada posição e formata o texto à volta dessa imagem, mesmo dentro de tabelas. O link da imagem é direccionado para o artigo, em vez de para a própria imagem. No final do texto é colocado outro link para o artigo.

Uso

Copie a seguinte definição para o seu texto e preencha os parâmetros.

{{chamada para artigo (pp)
| categoria=
| artigo=
| texto=
| autor=
| imagem=
| x=
| y=
| posição=
}}

Parâmetros

Os parâmetros desta predefinição podem tomar os seguintes valores:

  • categoria
    • a categoria do artigo — por exemplo, categoria=Conceitos.
    • por omissão, não será mostrada qualquer categoria.
  • artigo
    • o nome do artigo — por exemplo, artigo=Futuro.
    • por omissão, não será mostrado o link principal para um artigo (abaixo da categoria), o link da imagem não apontará para um artigo, e não será colocado o link para um artigo no final do texto.
  • texto
    • o texto introdutório do artigo — ver exemplos nesta página.
    • por omissão, não será mostrado qualquer texto.
  • autor
    • o autor do artigo, se conhecido, e a data de criação — por exemplo, autor=Hermes, Out 2007.
    • por omissão, não será mostrado qualquer autor ou data.
  • imagem
    • imagem=nenhuma - não é mostrada qualquer imagem
    • o nome da imagem (sem o namespace) com que deseja ilustrar a categoria — por exemplo, imagem=Tf_logo.gif.
    • por omissão, será assumido o logo do Think Finance.
  • x
    • a largura desejada para a imagem em pixéis (px) — na página principal a largura deve ser sempre x=120px.
    • por omissão, será assumida a largura x=120px.
    • NOTA: caso não tenha sido passado o parâmetro imagem, o parâmetro x é ignorado e adoptada a largura por omissão.
  • y
    • a altura desejada para a imagem em pixéis (px) — para manter proporções, calcular desta forma: x*altura original da imagem/largura original da imagem e arredondar para cima.
    • por omissão, será assumida a altura y=85px.
    • NOTA: caso não tenha sido passado o parâmetro imagem, o parâmetro y é ignorado e adoptada a altura por omissão.
  • posição
    • posição=esquerda - a imagem é colocada no topo à esquerda.
    • posição=direita - a imagem é colocada no topo à direita.
    • posição=topo - a imagem é colocada no topo, ao centro.
    • por omissão, o valor assumido é posição=direita.

Exemplo

Os exemplos acima são obtidos com o seguinte código:

{{chamada para artigo (pp)
| categoria=Biografias
| artigo=Jim Rogers
| texto='''James B. Rogers, Jr.''' - mais conhecido como Jim Rogers (nascido a 19 de Outubro de 1942) é um investidor americano. Foi co-fundador, com [[George Soros]], do Quantum Fund, e criou o Rogers International Commodities Index (RICI)
| autor=Incognitus, Out 2008
| imagem=JimRogers.jpg
| x=60px
| y=74px
| posição=esquerda
}}

fazendo variar o parâmetro posição entre posição=esquerda, posição=topo e posição=direita, respectivamente.

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 o parâmetro imagem

Quando o parâmetro imagem é omitido, o logo do Think Finance é usado. Mesmo que sejam passados os parâmetros x e y estes devem ser ignorados e os respectivos valores por omissão (que são os do logo Think Finance) adoptados. O link da imagem deve continuar a ser o do artigo. Por exemplo:

{{chamada para artigo (pp)
| categoria=Biografias
| artigo=Jim Rogers
| texto='''James B. Rogers, Jr.''' - mais conhecido como Jim Rogers (nascido a 19 de Outubro de 1942) é um investidor americano. Foi co-fundador, com [[George Soros]], do Quantum Fund, e criou o Rogers International Commodities Index (RICI)
| autor=Incognitus, Out 2008
| imagem=
| x=500px
| y=200px
| posição=esquerda
}}

Resulta no seguinte:

James B. Rogers, Jr. - mais conhecido como Jim Rogers (nascido a 19 de Outubro de 1942) é um investidor americano. Foi co-fundador, com George Soros, do Quantum Fund, e criou o Rogers International Commodities Index (RICI) (...)
Incognitus, Out 2008

Sem o parâmetro posição

Quando o parâmetro posição é omitido, a posição da imagem por omissão será sempre à direita. Por exemplo:

{{chamada para artigo (pp)
| categoria=Biografias
| artigo=Jim Rogers
| texto='''James B. Rogers, Jr.''' - mais conhecido como Jim Rogers (nascido a 19 de Outubro de 1942) é um investidor americano. Foi co-fundador, com [[George Soros]], do Quantum Fund, e criou o Rogers International Commodities Index (RICI)
| autor=Incognitus, Out 2008
| imagem=
| x=500px
| y=200px
| posição=
}}

Resulta no seguinte:

James B. Rogers, Jr. - mais conhecido como Jim Rogers (nascido a 19 de Outubro de 1942) é um investidor americano. Foi co-fundador, com George Soros, do Quantum Fund, e criou o Rogers International Commodities Index (RICI) (...)
Incognitus, Out 2008

Sem o parâmetro artigo

Quando o parâmetro artigo é omitido, o link da imagem deve ser para a própria imagem. O link com o nome do artigo e o link para o artigo no final do texto desaparecem. Por exemplo:

{{chamada para artigo (pp)
| categoria=Biografias
| artigo=
| texto='''James B. Rogers, Jr.''' - mais conhecido como Jim Rogers (nascido a 19 de Outubro de 1942) é um investidor americano. Foi co-fundador, com [[George Soros]], do Quantum Fund, e criou o Rogers International Commodities Index (RICI)
| autor=Incognitus, Out 2008
| imagem=
| x=500px
| y=200px
| posição=
}}

Resulta no seguinte:

140px
James B. Rogers, Jr. - mais conhecido como Jim Rogers (nascido a 19 de Outubro de 1942) é um investidor americano. Foi co-fundador, com George Soros, do Quantum Fund, e criou o Rogers International Commodities Index (RICI)
Incognitus, Out 2008

Sem os restantes parâmetros

Quando também os parâmetros categoria e autor são omitidos, temos um simples texto ilustrado com uma figura. Por exemplo:

{{chamada para artigo (pp)
| categoria=
| artigo=
| texto='''James B. Rogers, Jr.''' - mais conhecido como Jim Rogers (nascido a 19 de Outubro de 1942) é um investidor americano. Foi co-fundador, com [[George Soros]], do Quantum Fund, e criou o Rogers International Commodities Index (RICI)
| autor=
| imagem=
| x=500px
| y=200px
| posição=
}}

Resulta no seguinte:

140px
James B. Rogers, Jr. - mais conhecido como Jim Rogers (nascido a 19 de Outubro de 1942) é um investidor americano. Foi co-fundador, com George Soros, do Quantum Fund, e criou o Rogers International Commodities Index (RICI)