Last modified on 12 February 2014, at 13:20

Help:Images/pt-br

ImagensEdit

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

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 imagemEdit

SintaxeEdit

A sintaxe completa para mostrar uma imagem é:

 [[File: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.
  • 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>]].

FormatoEdit

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 upright, que tenta ajustar a imagem para um tamanho mais desejável.

AlinhamentoEdit

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


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.

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.


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.

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.


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.

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.


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.

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.

Alinhamento verticalEdit

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 Example-pt.png baseline Example-pt.png sub Example-pt.png super Example-pt.png text-top Example-pt.png middle Example-pt.png bottom Example-pt.png text-bottom Example-pt.png

Tamanho e formatoEdit

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]]
Example-pt.png

[[File:example-pt.png|410px]]
Example-pt.png


border

[[File:example-pt.png|border|50px]]
Example-pt.png

[[File:example-pt.png|border|410px]]
Example-pt.png


frame

(tamanho é ignorado, não aumenta nem reduz - mantém o tamanho original de 250px)

[[File:example-pt.png|frame|50px]]

Example-pt.png

[[File:example-pt.png|frame|410px]]

Example-pt.png


thumb

(reduz, mas não aumenta para além do tamanho original de 250px)

[[File:example-pt.png|thumb|50px]]

Example-pt.png

[[File:example-pt.png|thumb|410px]]

Example-pt.png


frameless

(reduz, mas não aumenta para além do tamanho original de 250px)

[[File:example-pt.png|frameless|50px]]
Example-pt.png

[[File:example-pt.png|frameless|410px]]
Example-pt.png

LinksEdit

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

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

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

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

Link direto para o arquivo multimídiaEdit

Você pode usar o pseudo espaço nominal Media: para criar um link directo para um arquivo, 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 arquivos, 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 arquivo:

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

Texto alternativoEdit

A tabela seguinte ilustra o uso de um texto alternativo.

Impedir que o texto fluaEdit

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 imagensEdit

É 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_arquivo.extensão|legenda
File: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>
File:Example-pt.png|Imagem 1
File:Example-pt.png|um link para [[Help:Contents/pt-br]]
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 o seguinte resultado:

Parâmetros da galeriaEdit

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:

RequisitosEdit

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.

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

Arquivos em outros sitesEdit

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
Tools.svg Dica para wiki admins: Consulte Manual:$wgAllowExternalImages para saber como permitir que os usuárioes integrem imagens externas nas páginas.
Língua: English  • العربية • català • čeština • Deutsch • Zazaki • español • suomi • français • Bahasa Indonesia • italiano • 日本語 • 한국어 • português • português do Brasil • română • русский • slovenčina • Tiếng Việt • 中文