Ajuda:Images/pt-br

Imagens

Esta página explica a sintaxe Arquivo na edição de páginas. Primeiramente, você, ou outro usuário, terão que carregar uma imagem antes de poder usá-la numa página.

As imagens armazenadas num servidor MediaWiki são normalmente apresentadas usando o espaço nominal Arquivo: (embora o anterior Imagem: continue a ser suportado como um sinônimo) em um link do MediaWiki. O espaço nominal alternativo Mídia: também pode ser usado para referir o conteúdo do arquivo original (para apresentação ou para fazer o download em separado, fora de uma página do MediaWiki).

Tipos de arquivos multimídia suportados para imagens

A extensão no nome dos arquivos (após mapeamento para minúsculas) é usada para determinar o tipo de arquivos multimídia que são suportados para imagens e também para obter internamente as dimensões preferidas para esse tipo:

• .svg : imagem escalável no formato Standard Vector Graphics (especificado pelo W3 Consortium).
• .jpg ou .jpeg : imagem em bitmap, comprimida no formato padronizado JPEG (este formato de compressão com perdas é mais apropriado para fotografias).
• .png : imagem em bitmap, no formato Portable Network Graphics (especificado pelo W3 Consortium).
• .gif : imagem em bitmap no formato ultrapassado Graphics Interchange Format.

  Note que as animações de imagens GIF com vários fotogramas só são presentemente suportadas se a imagem não for reduzida a uma miniatura; se não, só o primeiro fotograma é apresentado.

• .pdf : documentos de várias páginas no formato Portable Document Format (inicialmente especificado pela Adobe).
• .djvu : documentos de várias páginas em bitmap no formato DejaVu (normalmente, digitalizações de livros).

  Por omissão, só será apresentada a primeira páginas de arquivos .pdf e .djvu.

Podem também ser suportados outros tipos de arquivos multimídia, dependendo da versão da sua instalação do MediaWiki. Se deseja aprofundar este assunto, consulte os requisitos de instalação, a documentação dessa versão e a documentação no site mediawiki.org.

Apresentação de uma imagem

Sintaxe

A sintaxe completa para mostrar uma imagem é:

 [[Arquivo:nome do arquivo.extensão|opções|legenda]]

onde «opções» pode ser nenhuma, uma, ou mais das seguintes, separadas por uma barra vertical (|):

• Opção do formato da imagem: border, frame, thumb ou frameless.
  • border coloca uma borda fina cinzenta em redor da imagem.
  • frame coloca uma moldura em redor da imagem e alinha-a à direita.
  • thumb apresenta a imagem em miniatura alinhada à direita - o tamanho é determinado pelas preferências do usuário.
    • thumb={nome de arquivo} permite usar uma imagem diferente na miniatura.
  • frameless, tal como thumb, respeita as preferências do usuário para a largura da imagem, mas sem moldura e sem flutuar à direita.

• Opção do alinhamento da imagem no texto: left, right, center ou none.
  • Quando o formato é frame ou thumb, o alinhamento por omissão é right, à direita.

• Opção do alinhamento vertical da imagem no texto: baseline, sub, super, top, text-top, middle, bottom ou text-bottom.

• Opção do tamanho da imagem, redimensiona-a para a largura e altura especificadas, em pixels: {largura}x{altura}px.
  • É possível especificar só a largura, com {largura} px, ou só a altura, com x{altura}px.
  • Se o formato for frame, o tamanho é sempre ignorado.
  • Se não for especificado um formato, ou este for border, o tamanho da imagem pode ser reduzido ou aumentado.
  • Se o formato for thumb ou frameless, o tamanho pode ser reduzido, mas não aumentado para além do original.
  • Se não for especificado um tamanho, aplica-se o ilustrado na seção formato.
  • Note que a imagem mantém sempre as proporções originais.

• Opção do link, coloca sobre a imagem um link para um título (link interno) ou uma URL (link externo): link={destino} (1.14+)
  • link= mostra a imagem sem qualquer link.
  • Note que link não pode ser usado em conjunto com thumb porque thumb é sempre suposto conduzir à versão maior da imagem. Adicionalmente, link também não pode ser usado com frame.

• Opção de texto alternativo, para mudar a legenda do link sobre a imagem: alt={texto alternativo}: (1.14+)

• Casos especiais:
  • page=1: Mostra inicialmente a página especificada, ao apresentar arquivos djvu ou pdf.

As opções podem ser fornecidas em qualquer ordem. Se as opções fornecidas entrarem em conflito mútuo, a aplicada será a última, excepto nas opções do formato, onde a prioridade é frame, thumb e frameless e/ou border.

Se um parâmetro não corresponde a nenhuma das possibilidades listadas acima, é assumido que se trata do texto para a legenda da imagem. A legenda é mostrada sob a imagem nos formatos frame e thumb, ou aparece como uma legenda flutuante, quando o ponteiro é colocado sobre a imagem, nos formatos border, frameless ou se o formato for omitido. Nos formatos frame e thumb o texto da legenda pode conter links, outros elementos de formatação de texto wiki e transclusão. Nas outras opções, a legenda não mostra links nem elementos de formatação, mas pode usar-se transclusão no conteúdo da legenda.

Se não for fornecida nenhuma legenda, normalmente é automaticamente criada uma legenda flutuante com o nome do arquivo; caso deseje impedir que apareça qualquer legenda, utilize <span title=""></span> no lugar da legenda. Por exemplo, [[File:Example.jpg|20px|<span title=""></span>]] → Arquivo:Example.jpg.

Formato

A tabela seguinte ilustra o efeito dos formatos disponíveis.

Formato	Escreva	Resultado

Quando a altura de uma imagem em miniatura é maior do que a sua largura e fica demasiado pronunciada, tente a opção upright, que tenta ajustar a imagem para um tamanho mais desejável.

Alinhamento

A tabela seguinte ilustra o efeito dos alinhamentos disponíveis.

Alinhamento	Escreva	Resultado

Alinhamento vertical

Os seguintes exemplos ilustram o efeito dos alinhamentos verticais disponíveis.

Nenhum [[Arquivo:Example-pt.png|20px]]
baseline [[Arquivo:Example-pt.png|20px|baseline]]
sub [[Arquivo:Example-pt.png|20px|sub]]
super [[Arquivo:Example-pt.png|20px|super]]
text-top [[Arquivo:Example-pt.png|20px|text-top]]
middle [[Arquivo:Example-pt.png|20px|middle]]
bottom [[Arquivo:Example-pt.png|20px|bottom]]
text-bottom [[Arquivo:Example-pt.png|20px|text-bottom]]

resulta no seguinte (o texto foi sublinhado para tornar o resultado mais claro):

Nenhum 20px baseline 20px sub 20px super 20px text-top 20px middle 20px bottom 20px text-bottom 20px

Tamanho e formato

Dependendo do formato, o efeito da opção tamanho pode variar, como ilustrado abaixo.

Formato	Tamanho reduzido (para largura 50px)	Tamanho aumentado (para largura 410px)

Links

A tabela seguinte ilustra a colocação de um link sobre a imagem.

Link	Escreva	Resultado

Link para a página de descrição do arquivo

Se colocar dois pontos (:) antes de Arquivo:, a imagem não será apresentada. Em vez dela, é apresentado um link para a página de descrição do respectivo arquivo.

[[:Arquivo:example-pt.png]] → Arquivo:example-pt.png

[[:Arquivo:example-pt.png|Girassóis]] → Girassóis

Link direto para o arquivo multimídia

Você pode usar o pseudo espaço nominal Mídia: para criar um link directo para um arquivo, sem passar pela página de descrição:

[[Mídia:example-pt.png]] → Mídia:example-pt.png

[[Mídia:example-pt.png|Girassóis]] → Girassóis

Em alternativa, pode usar:

[[Especial:Diretório de arquivo/example-pt.png]] → Especial:Diretório de arquivo/example-pt.png

que também cria links para arquivos, mesmo que estes não existam:

[[Especial:Diretório de arquivo/inexistente.png]] → Especial:Diretório de arquivo/inexistente.png

A função do analisador sintáctico filepath pode ser usada para gerar uma URL externa para um arquivo:

{{filepath:example-pt.png}} →

Texto alternativo

A tabela seguinte ilustra o uso de um texto alternativo.

Link	Escreva	Resultado

Impedir que o texto flua

Ocasionalmente, é desejável impedir que o texto flua ao redor da imagem. Dependendo da resolução do seu browser, a fluidez do texto ao redor da imagem pode fazer com que um cabeçalho de seção (por exemplo, == Cabeçalho ==) seja colocado à direita da imagem, em vez de abaixo dela, como pode ser esperado pelo usuário. A fluidez do texto pode ser interrompida inserindo-se <br style="clear: both" /> antes do texto que deve começar depois da imagem.

Galeria de imagens

É fácil criar uma galeria de miniaturas (não é possível com outras imagens), usando o elemento <gallery>. A sintaxe é a seguinte:

<gallery>
Arquivo:nome_do_arquivo.extensão|legenda
Arquivo:nome_do_arquivo.extensão|legenda
{...}
</gallery>

Note que no elemento galeria não se coloca os parênteses rectos nos links das imagens.

As legendas são opcionais e podem conter links ou outros elementos de formatação.

Por exemplo:

<gallery>
Arquivo:Example-pt.png|Imagem 1
Arquivo:Example-pt.png|um link para [[Help:Contents/pt-br]]
Arquivo:Example-pt.png
Arquivo:Example-pt.png
Arquivo:Example-pt.png| ''legenda em itálico''
Arquivo:Example-pt.png|na página «{{PAGENAME}}»
</gallery>

cria o seguinte resultado:

• Example-pt.png

  Imagem 1

• Example-pt.png

  um link para Help:Contents/pt

• Example-pt.png
• Example-pt.png
• Example-pt.png

  legenda em itálico

• Example-pt.png

  na página «Images/pt-br»

Parâmetros da galeria

O elemento gallery aceita vários parâmetros adicionais:

<gallery {parâmetros}>
{imagens}
</gallery>

• caption={legenda}: coloca uma legenda na galeria.
• widths={larguras}px: define a largura das imagens. Note o uso do plural, widths.
• heights={alturas}px: define a altura (máxima) das imagens.
• perrow={número inteiro}: define o número de imagens por linha.

Exemplo:

<gallery widths=150px heights=150px perrow=4 caption="Galeria de Girassóis">
Arquivo:Example-pt.png
Arquivo:Example-pt.png
Arquivo:Example-pt.png
Arquivo:Example-pt.png
Arquivo:Example-pt.png
Arquivo:Example-pt.png
Arquivo:Example-pt.png
Arquivo:Example-pt.png
Arquivo:Example-pt.png
Arquivo:Example-pt.png
Arquivo:Example-pt.png
</gallery>

Resultado:

• Galeria de Girassóis
• Example-pt.png
• Example-pt.png
• Example-pt.png
• Example-pt.png
• Example-pt.png
• Example-pt.png
• Example-pt.png
• Example-pt.png
• Example-pt.png
• Example-pt.png
• Example-pt.png

Requisitos

Antes de poder usar imagens nas suas páginas, um administrador da wiki precisa de activar o carregamento de arquivos e um usuário tem de carregar um arquivo. Os administradores também podem permitir que a wiki aceite arquivos de repositórios externos, como por exemplo do Wikimedia Commons.

Arquivos em outros sites

Pode criar um link para um arquivo externo disponível online usando a mesma sintaxe que usa para criar um link para uma página da internet.

[http://url.para/uma/imagem.png]

Ou personalizando o texto:

[http://url.para/uma/imagem.png texto do link]

Se tiver sido possibilitada na sua wiki a integração de imagens externas nas páginas, pode fazê-lo simplesmente, inserindo a URL da imagem:

http://url.para/uma/imagem.png