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

Da Thinkfn
< Predefinição:Chamada para artigo (pp)
 
(7 edições intermédias não estão a ser mostradas.)
Linha 13: Linha 13:
 
| imagem=JimRogers.jpg
 
| imagem=JimRogers.jpg
 
| imagem aponta para=
 
| imagem aponta para=
 +
| imagem aponta para url=
 
| x=60px
 
| x=60px
 
| y=74px
 
| y=74px
Linha 28: Linha 29:
 
| imagem=JimRogers.jpg
 
| imagem=JimRogers.jpg
 
| imagem aponta para=
 
| imagem aponta para=
 +
| imagem aponta para url=
 
| x=60px
 
| x=60px
 
| y=74px
 
| y=74px
Linha 43: Linha 45:
 
| imagem=JimRogers.jpg
 
| imagem=JimRogers.jpg
 
| imagem aponta para=
 
| imagem aponta para=
 +
| imagem aponta para url=
 
| x=60px
 
| x=60px
 
| y=74px
 
| y=74px
Linha 53: Linha 56:
 
==Uso==
 
==Uso==
 
Copie a seguinte definição para o seu texto e preencha os parâmetros.
 
Copie a seguinte definição para o seu texto e preencha os parâmetros.
 
+
{{chamada para artigo (pp)/par}}
:<code><nowiki>{{ chamada para artigo (pp) </nowiki><br /><nowiki>
+
| categoria= </nowiki><br /><nowiki>
+
| artigo= </nowiki><br /><nowiki>
+
| alternativo= </nowiki><br /><nowiki>
+
| texto= </nowiki><br /><nowiki>
+
| autor= </nowiki><br /><nowiki>
+
| imagem= </nowiki><br /><nowiki>
+
| imagem aponta para= </nowiki><br /><nowiki>
+
| x= </nowiki><br /><nowiki>
+
| y= </nowiki><br /><nowiki>
+
| posição= </nowiki><br /><nowiki>
+
}}</nowiki></code>
+
  
 
==Parâmetros==
 
==Parâmetros==
Linha 73: Linha 64:
 
** a [[Special:Categories|categoria do artigo]] &mdash; por exemplo, <code>categoria=Conceitos</code>.
 
** a [[Special:Categories|categoria do artigo]] &mdash; por exemplo, <code>categoria=Conceitos</code>.
 
** por omissão, não será mostrada qualquer categoria.
 
** por omissão, não será mostrada qualquer categoria.
 +
 
* <code>artigo</code>
 
* <code>artigo</code>
 
** o nome do artigo &mdash; por exemplo, <code>artigo=Futuro</code>.
 
** o nome do artigo &mdash; por exemplo, <code>artigo=Futuro</code>.
 
** 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.
 
** 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>alternativo</code>
 
* <code>alternativo</code>
** um nome alternativo para ser mostrado em vez do nome do artigo &mdash; por exemplo, se o nome do artigo é extenso, como em <code>artigo=Newsletter e.conomia.info, Edição 057, 27 OUT 2008</code>, pode apresentar uma alternativa mais curta usando <code>link=Edição 057, 27 Out 2008</code>.
+
** um nome alternativo para ser mostrado em vez do nome do artigo &mdash; por exemplo, se o nome do artigo é extenso, como em <code>artigo=Newsletter e.conomia.info, Edição 057, 27 OUT 2008</code>, pode apresentar uma alternativa mais curta usando <code>alternativo=Edição 057, 27 Out 2008</code>.
 
** por omissão, é usado o nome do artigo.
 
** por omissão, é usado o nome do artigo.
 
** ''NOTA: caso não tenha sido passado o parâmetro <code>artigo</code>, o parâmetro <code>alternativo</code> é ignorado e não aparece.''
 
** ''NOTA: caso não tenha sido passado o parâmetro <code>artigo</code>, o parâmetro <code>alternativo</code> é ignorado e não aparece.''
 +
 
* <code>texto</code>
 
* <code>texto</code>
 
** o texto introdutório do artigo &mdash; ver exemplos nesta página e na página de testes.
 
** o texto introdutório do artigo &mdash; ver exemplos nesta página e na página de testes.
 
** por omissão, não será mostrado qualquer texto.
 
** por omissão, não será mostrado qualquer texto.
 +
 
* <code>autor</code>
 
* <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>.
 
** 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.
 
** por omissão, não será mostrado qualquer autor ou data.
 +
 
* <code>imagem</code>
 
* <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>.
 
** o [[Especial:Imagelist|nome da imagem]] (sem o ''namespace'') com que deseja ilustrar a categoria &mdash; por exemplo, <code>imagem=Tf_logo.gif</code>.
 +
** 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.
 +
** <code>imagem=nenhuma</code> - não é mostrada qualquer imagem.
 
** por omissão, será assumido o logo do Think Finance.
 
** por omissão, será assumido o logo do Think Finance.
 +
 
* <code>imagem aponta para</code>
 
* <code>imagem aponta para</code>
** 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 <code>artigo</code>.
+
** 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 <code>artigo</code>.
 
** por omissão, a imagem aponta para a página do parâmetro <code>artigo</code>.
 
** por omissão, a imagem aponta para a página do parâmetro <code>artigo</code>.
 +
 +
* <code>imagem aponta para url</code>
 +
** a ''url'' para a qual o ''link'' da imagem deve apontar, caso seja pretendido que aponte para uma página externa na internet &mdash; por exemplo, <code><nowiki>imagem aponta para url=http://economico.sapo.pt/forumbolsa/</nowiki></code>.
 +
** ''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 <code><nowiki><span title="Título pretendido"></nowiki></code> após a ''url'' &mdash; por exemplo, <code><nowiki>imagem aponta para url=http://economico.sapo.pt/forumbolsa/ <span title="Fórum de bolsa Think Finance"></nowiki></code>.''
 +
** por omissão, a imagem aponta para a página do parâmetro <code>imagem aponta para</code>.
 +
 
* <code>x</code>
 
* <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>.
+
** a largura desejada para a imagem em pixels (px)</code>.
** por omissão, será assumida a largura <code>x=120px</code>.
+
** por omissão, será assumida a largura <code>x=140px</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.''
 
** ''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>
 
* <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.
+
** a altura desejada para a imagem em pixels (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>.
+
** por omissão, será assumida a altura <code>y=50px</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.''
 
** ''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.''
 +
** ''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.).''
 +
 
* <code>posição</code>
 
* <code>posição</code>
 
** <code>posição=esquerda</code> - a imagem é colocada no topo à esquerda.
 
** <code>posição=esquerda</code> - a imagem é colocada no topo à esquerda.
Linha 110: Linha 117:
 
Os exemplos no topo desta página foram criados com o seguinte código:
 
Os exemplos no topo desta página foram criados com o seguinte código:
  
:<code><nowiki>{{ chamada para artigo (pp)</nowiki><br /><nowiki>
+
<nowiki>{{ chamada para artigo (pp)
| categoria=Biografias</nowiki><br /><nowiki>
+
| categoria=Biografias
| artigo=Jim Rogers</nowiki><br /><nowiki>
+
| artigo=Jim Rogers
| alternativo=</nowiki><br /><nowiki>
+
| 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)
| 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)</nowiki><br /><nowiki>
+
| autor=Incognitus, Out 2008
| autor=Incognitus, Out 2008</nowiki><br /><nowiki>
+
| imagem=JimRogers.jpg
| imagem=JimRogers.jpg</nowiki><br /><nowiki>
+
| x=60px
| imagem aponta para= </nowiki><br /><nowiki>
+
| y=74px
| x=60px</nowiki><br /><nowiki>
+
| posição=esquerda
| y=74px</nowiki><br /><nowiki>
+
}}</nowiki>
| posição=esquerda</nowiki><br /><nowiki>
+
}}</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, para colocar a imagem em diferentes posições. Mais exemplos podem ser encontrados na página de testes.
+
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, para colocar a imagem em diferentes posições. Mais exemplos podem ser encontrados na [[Predefinição:Chamada para artigo (pp)/tst|página de testes]].

Edição atual desde as 15h27min de 2 de julho de 2010

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.

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.