Predefinição:Chamada para artigo (pp)

Da Thinkfn
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.