Help:Images/pt

= Imagens = Esta página explica a sintaxe     na edição de páginas. Você, ou outro utilizador, terão primeiro de ter carregado uma imagem antes de poder usá-la numa página.

Sintaxe
A sintaxe completa para mostrar uma imagem é: {opções} 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 utilizador.
 * thumb={nome de ficheiro} permite usar uma imagem diferente na miniatura.
 * frameless, tal como thumb, respeita as preferências do utilizador 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 secçã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 ficheiros 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 uma dada opção não corresponde a nenhuma das possibilidades listadas acima, é assumido que se trata do texto para a legenda da imagem. A legenda pode conter links e outros elementos de formatação. Se não for fornecida nenhuma legenda, normalmente uma é automaticamente criada com o nome do ficheiro; caso deseje forçar que não apareça legenda nenhuma, utilize  no lugar da legenda.

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 ficheiro
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 ficheiro.

Girassóis

resulta no seguinte:

Girassóis

Link directo para o ficheiro
Pode usar o pseudo espaço nominal «   » para criar um link directo para um ficheiro, sem passar pela sua página de descrição.

Girassóis

resulta no seguinte:

Girassóis

Também pode usar:

/example-pt.png

que pode ser usado para criar um link para um ficheiro inexistente. Também pode usar:

que gera uma URL externa para o ficheiro:

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 em redor da imagem. Dependendo da resolução do seu browser, o fluir do texto em redor da imagem pode causar que um cabeçalho de secção (por exemplo, ) seja colocado à direita da imagem, em vez de abaixo dela, como pode ser esperado pelo utilizador. O fluir do texto pode ser interrompido colocando  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 ficheiros e um utilizador tem de  carregar um ficheiro. Os administradores também podem permitir que a wiki aceite ficheiros de repositórios externos, como por exemplo do Wikimedia Commons.

Ficheiros noutros sites
Pode criar um link para um ficheiro 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