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

Da Thinkfn
Linha 68: Linha 68:
 
#if: {{{autor|}}}
 
#if: {{{autor|}}}
 
   | <div style="color:#888888; font-size:85%">{{{autor}}}</div>
 
   | <div style="color:#888888; font-size:85%">{{{autor}}}</div>
   | }}</includeonly><noinclude>__NOTOC__
+
   | }}</includeonly><noinclude>{{documentation}}
 
Esta predefinição é usada na página principal para fazer chamadas de destaque para artigos, deste tipo:
 
Esta predefinição é usada na página principal para fazer chamadas de destaque para artigos, deste tipo:
  

Revisão das 19h40min de 4 de dezembro de 2008

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


Esta é a página do código desta predefinição. O texto abaixo vem da página da documentação. A categoria vem da página de categoria (não categorize esta página). Todos os parâmetros que a predefinição aceita estão listados na página de parâmetros e o seu uso é explicado na documentação. Se quiser alterar o código, faça-o na página de desenvolvimento. Verifique as suas alterações na página de testes. Quando terminar a alteração, peça a um administrador que migre o código de desenvolvimento para cá.

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.
[editar documentação]

Documentação

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=
| alternativo=
| texto=
| autor=
| imagem=
| imagem aponta para=
| imagem aponta para url=
| x=
| y=
| posição=
}}

Parâmetros

Os parâmetros 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.
  • alternativo
    • um nome alternativo para ser mostrado em vez do nome do artigo — por exemplo, se o nome do artigo é extenso, como em artigo=Newsletter e.conomia.info, Edição 057, 27 OUT 2008, pode apresentar uma alternativa mais curta usando alternativo=Edição 057, 27 Out 2008.
    • por omissão, é usado o nome do artigo.
    • NOTA: caso não tenha sido passado o parâmetro artigo, o parâmetro alternativo é ignorado e não aparece.
  • texto
    • o texto introdutório do artigo — ver exemplos nesta página e na página de testes.
    • 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
    • o nome da imagem (sem o namespace) com que deseja ilustrar a categoria — por exemplo, imagem=Tf_logo.gif.
    • se não existir nenhuma imagem na wiki com o nome passado, é assumido que foi passada uma URL externa para uma imagem e é usada como tal.
    • imagem=nenhuma - não é mostrada qualquer imagem.
    • por omissão, será assumido o logo do Think Finance.
  • imagem aponta para
    • o nome do artigo interno da wiki para o qual o link da imagem deve apontar, caso seja pretendido que aponte para outra página que não a do parâmetro artigo.
    • por omissão, a imagem aponta para a página do parâmetro artigo.
  • imagem aponta para url
    • a url para a qual o link da imagem deve apontar, caso seja pretendido que aponte para uma página externa na internet — por exemplo, imagem aponta para url=http://economico.sapo.pt/forumbolsa/.
    • NOTA: quando se aponta uma imagem desta forma, o título que é exibido sempre que o ponteiro é colocado sobre a imagem, mostra a url em si. É possível mostrar outro título, adicionando <span title="Título pretendido"> após a url — por exemplo, imagem aponta para url=http://economico.sapo.pt/forumbolsa/ <span title="Fórum de bolsa Think Finance">.
    • por omissão, a imagem aponta para a página do parâmetro imagem aponta para.
  • x
    • a largura desejada para a imagem em pixels (px)</code>.
    • por omissão, será assumida a largura x=140px.
    • 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 pixels (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=50px.
    • NOTA: caso não tenha sido passado o parâmetro imagem, o parâmetro y é ignorado e adoptada a altura por omissão.
    • NOTA: na fonte da página principal, a categoria tem 16px de altura e o texto 17px, portanto, se existir uma categoria, a altura da imagem deve ser um múltiplo de 17 pixels a partir da categoria (16, 33, 50, 67, 84, 101, 118, 135, 152, 169, etc.).
  • 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 no topo desta página foram criados 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, para colocar a imagem em diferentes posições. Mais exemplos podem ser encontrados na página de testes. 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=
| alternativo=
| texto=
| autor=
| imagem=
| imagem aponta para=
| 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.
  • alternativo
    • um nome alternativo para ser mostrado em vez do nome do artigo — por exemplo, se o nome do artigo é extenso, como em artigo=Newsletter e.conomia.info, Edição 057, 27 OUT 2008, pode apresentar uma alternativa mais curta usando link=Edição 057, 27 Out 2008.
    • por omissão, é usado o nome do artigo.
    • NOTA: caso não tenha sido passado o parâmetro artigo, o parâmetro alternativo é ignorado e não aparece.
  • 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.
  • imagem aponta para
    • o nome do artigo para o qual o link da imagem deve apontar, caso seja pretendido que aponte para outra página que não a do parâmetro artigo.
    • por omissão, a imagem aponta para a página do parâmetro artigo.
  • 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
| alternativo=
| 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
| imagem aponta para=
| 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
| alternativo=
| 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=
| imagem aponta para=
| 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
| alternativo=
| 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=
| imagem aponta para=
| 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

Com o parâmetro alternativo

Quando o parâmetro alternativo é fornecido, é usado no link principal para o artigo em vez do parâmetro artigo. Por exemplo:

{{ chamada para artigo (pp)
| categoria=Biografias
| artigo=Jim Rogers
| alternativo=Usar em vez de 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=
| imagem aponta para=
| 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=
| alternativo=Usar em vez de 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=
| imagem aponta para=
| 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

Com o parâmetro imagem aponta para

Quando o parâmetro imagem aponta para é fornecido, o link da imagem apontará para a página fornecida, mesmo que não tenha sido fornecida uma imagem. Por exemplo:

{{ chamada para artigo (pp)
| categoria=Biografias
| artigo=
| alternativo=Usar em vez de 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=
| imagem aponta para=Derivado
| 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 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=
| alternativo=Usar em vez de 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=
| imagem=
| imagem aponta para=Derivado
| 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)

Sem imagem

Quando o parâmetro imagem é imagem=nenhuma não deve ser mostrada qualquer imagem. Por exemplo:

{{ chamada para artigo (pp)
| categoria=
| artigo=
| alternativo=Usar em vez de 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=
| imagem=nenhuma
| imagem aponta para=Derivado
| 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)