Help:Images/pt

Nota importante: Ao gravar esta página, concorda em publicar a sua contribuição no domínio público. Caso não queira ou não possa fazê-lo, devido a restrições de licenças, por favor, não a edite. Esta é uma das páginas de ajuda no domínio público, que podem ser livremente copiadas para qualquer wiki ou distribuídas com o MediaWiki; consulte Ajuda para ver as restantes e Copiar para saber como copiá-las para a sua wiki.

Imagens

Esta página explica a sintaxe File 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.

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

Tipo de ficheiros multimédia suportados para imagens

A extensão no nome dos ficheiros (após mapeamento para minúsculas) é usada para determinar o tipo de ficheiros 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 ficheiros .pdf e .djvu.

Podem também ser suportados outros tipos de ficheiros multimédia, dependendo da versão da sua instalação 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 é:

 [[File:nome do ficheiro.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 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 é 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 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} (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 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 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 ficheiro; 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>]] → .

Formato

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

Formato	Escreva	Resultado
Nenhum	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. [[File:example-pt.png|legenda]] Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.
border (coloca uma borda fina cinzenta em redor da imagem)	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. [[File:example-pt.png|border|legenda]] Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.
frame (coloca uma moldura em redor da imagem e alinha-a à direita)	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. [[File:example-pt.png|frame|legenda]] Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. legenda Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.
thumb (apresenta a imagem em miniatura alinhada à direita, com o tamanho determinado pelas preferências do utilizador)	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. [[File:example-pt.png|thumb|legenda]] Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. legenda Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.
thumb=nome do ficheiro (permite usar uma imagem diferente na miniatura)	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. [[File:example-pt.png|thumb=PD-icon.svg|legenda]] Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. legenda Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.
frameless (tal como thumb, respeita as preferências do utilizador para a largura da imagem, mas sem moldura e sem flutuar à direita)	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. [[File:example-pt.png|frameless|legenda]] Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.
frameless e border	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. [[File:example-pt.png|frameless|border|legenda]] Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.

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
Nenhum	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. [[File:example-pt.png|legenda]] Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.
none	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. [[File:example-pt.png|none|legenda]] Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.
center	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. [[File:example-pt.png|center|legenda]] Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.
left	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. [[File:example-pt.png|left|legenda]] Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.
right	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. [[File:example-pt.png|right|legenda]] Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.

Alinhamento vertical

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

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

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

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

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)
Nenhum	[[File:example-pt.png|50px]]	[[File:example-pt.png|410px]]
border	[[File:example-pt.png|border|50px]]	[[File:example-pt.png|border|410px]]
frame (tamanho é ignorado, não aumenta nem reduz - mantém o tamanho original de 250px)	[[File:example-pt.png|frame|50px]]	[[File:example-pt.png|frame|410px]]
thumb (reduz, mas não aumenta para além do tamanho original de 250px)	[[File:example-pt.png|thumb|50px]]	[[File:example-pt.png|thumb|410px]]
frameless (reduz, mas não aumenta para além do tamanho original de 250px)	[[File:example-pt.png|frameless|50px]]	[[File:example-pt.png|frameless|410px]]

Links

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

Link	Escreva	Resultado
Imagem sem qualquer link	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. [[File:example-pt.png|link=|legenda]] Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.
link=Página principal (link interno sobre a imagem, para a página principal)	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. [[File:example-pt.png|link=Página principal|legenda]] Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.
link=http:/wikipedia.org (link externo sobre a imagem, para a wikipedia.org)	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. [[File:example-pt.png|link=http://wikipedia.org|legenda]] Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.
Formato é frame (link é ignorado, link sobre a imagem é para o ficheiro original)	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. [[File:example-pt.png|frame|link=http://wikipedia.org|legenda]] Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. legenda Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.
Formato é thumb (link é ignorado, link sobre a imagem é para o ficheiro original)	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. [[File:example-pt.png|thumb|link=http://wikipedia.org|legenda]] Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. legenda Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.

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

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

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

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

Link directo para o ficheiro multimédia

Pode usar o pseudo espaço nominal Media: para criar um link directo para um ficheiro, sem passar pela página de descrição:

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

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

Em alternativa, pode usar:

[[Special:FilePath/example-pt.png]] → Special:FilePath/example-pt.png

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

[[Special:FilePath/inexistente.png]] → Special:FilePath/inexistente.png

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

{{filepath:example-pt.png}} → //upload.wikimedia.org/wikipedia/mediawiki/3/3b/Example-pt.png

Texto alternativo

A tabela seguinte ilustra o uso de um texto alternativo.

Link	Escreva	Resultado
Link externo sobre a imagem, sem texto alternativo	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. [[File:example-pt.png|link=http://wikipedia.org|legenda]] Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.
Link externo sobre a imagem, com texto alternativo	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. [[File:example-pt.png|link=http://wikipedia.org|alt=Texto alternativo|legenda]] Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.	Texto antes, texto antes, texto antes, texto antes, texto antes, texto antes, texto antes e texto antes. Texto após, texto após, texto após, texto após, texto após, texto após, texto após e texto após.

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, == Cabeçalho ==) seja colocado à direita da imagem, em vez de abaixo dela, como pode ser esperado pelo utilizador. O fluir do texto pode ser interrompido colocando <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>
File:nome_do_ficheiro.extensão|legenda
File:nome_do_ficheiro.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>
File:Example-pt.png|Imagem 1
File:Example-pt.png|um link para [[Help:Contents/pt]]
File:Example-pt.png
File:Example-pt.png
File:Example-pt.png| ''legenda em itálico''
File:Example-pt.png|na página «{{PAGENAME}}»
</gallery>

cria a seguinte:

• 

  Imagem 1

• 

  um link para Help:Contents/pt

• 
• 
• 

  legenda em itálico

• 

  na página «Images/pt»

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">
File:Example-pt.png
File:Example-pt.png
File:Example-pt.png
File:Example-pt.png
File:Example-pt.png
File:Example-pt.png
File:Example-pt.png
File:Example-pt.png
File:Example-pt.png
File:Example-pt.png
File:Example-pt.png
</gallery>

Resultado:

• Galeria de Girassóis
• 
• 
• 
• 
• 
• 
• 
• 
• 
• 
• 

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.

Dica para administradores: Para saber como possibilitar o carregamento de ficheiros na sua wiki, consulte Manual:Configuring file uploads. Para possibilitar o uso de ficheiros de repositórios externos, consulte Manual:Image Administration#Foreign Repositories.

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.

[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

Dica para administradores: Consulte Manual:$wgAllowExternalImages para saber como permitir que os utilizadores integrem imagens externas nas páginas.

[Diferenças no original em inglês desde a última sincronização]