Help:Images/pt-br

= Imagens = Esta página explica a sintaxe     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  (embora o anterior   continue a ser suportado como um sinônimo) em um link do MediaWiki. O espaço nominal alternativo  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.

Sintaxe
A sintaxe completa para mostrar uma imagem é: 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 é   ou  , o alinhamento por omissão é  , à 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  , o tamanho é sempre ignorado.
 * Se não for especificado um formato, ou este for  , o tamanho da imagem pode ser reduzido ou aumentado.
 * Se o formato for   ou  , 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}
 * 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}:


 * 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  no lugar da legenda. Por exemplo,  →.

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

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

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

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

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

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

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

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

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

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


 *  :    :example-pt.png &rarr;     :example-pt.png
 *  Girassóis &rarr; Girassóis

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


 *      :example-pt.png &rarr;     :example-pt.png
 *  Girassóis &rarr; Girassóis

Em alternativa, pode usar:


 *  /example-pt.png &rarr; /example-pt.png

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


 *  /inexistente.png &rarr; /inexistente.png

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


 *   &rarr;

Texto alternativo
A tabela seguinte ilustra o uso de um texto alternativo.

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, ) 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  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. A sintaxe é a seguinte:

Parâmetros da galeria
O elemento  aceita vários parâmetros adicionais:

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.  Ou personalizando o texto: 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