Mostrar código-fonte de Ajuda:Guia de edição/Como usar imagens

← Ajuda:Guia de edição/Como usar imagens
Não tem permissão para editar esta página, pelos seguintes motivos:
Esta página está atualmente semiprotegida e pode ser editada somente por usuários regist(r)ados com conta confirmada.
Semiproteção é algumas vezes necessária para prevenir vandalismo a páginas populares. A maioria dos artigos pode ser editada por qualquer um.
A razão para a proteção pode ser encontrada no regist(r)o de proteção. Se não houver entradas relevantes no regist(r)o de proteção, a página pode ter sido movida depois de ser protegida.
Se você tem uma conta de usuário, entre primeiro. Se ainda não tem uma conta, pode criar uma; depois de algum tempo e algumas edições, você poderá editar páginas semiprotegidas.
Você pode discutir esta página com outros. Se notou um erro ou tem uma sugestão para uma alteração simples, faça um pedido na página de pedidos para edição de páginas protegidas. Um usuário regist(r)ado pode então fazer a alteração em seu nome.
Você pode pedir a desproteção da página, caso haja necessidade.
O seu endereço IP pertence a uma gama que foi bloqueada em todas as wikis da Wikimedia Foundation.
O bloqueio foi efetuado por ‪Jon Kolbert‬. O motivo apresentado foi Open proxy/Webhost: See the help page if you are affected .
- Início do bloqueio: 21h21min de 13 de novembro de 2023
- Expiração do bloqueio: 21h21min de 13 de novembro de 2026
O seu endereço IP atual é 2a01:7e00::f03c:95ff:feed:9834. A gama bloqueada é ‪2A01:7E00:0:0:0:0:0:0/30‬.
Inclua todos os detalhes acima em quaisquer contactos relacionados com este bloqueio, por favor.
Se você acredita que foi bloqueado por engano, você pode encontrar informações e instruções adicionais no Assistente de bloqueio de Stewards.
No momento, você só pode visualizar e copiar o conteúdo desta página.
{{Informativo/Guia de edição}}
{{Wikipédia/Guia de edição|expandir=Básico}}
{{Atalho2|WP:IMAGEM|WP:imagem}}
Neste artigo você aprenderá '''como usar imagens, áudios e vídeos na Wikipédia'''.

== Editar imagens e outros ficheiro multimédia pelo [[WP:Editor Visual|Editor Visual]] ==

{| cellpadding="15"
|-
| colspan=2 |
=== Editar imagens ===
|-
| Para inserir uma nova imagem (ou outro tipo de ficheiro multimédia), clique no ícone "<!-- {{int|visualeditor-dialogbutton-media-tooltip}} -->Imagens e multimédia" (uma imagem de montanhas) no menu "<!-- {{int|visualeditor-toolbar-insert}} -->Inserir". A imagem será incluída onde o rato estiver.
| [[Ficheiro:VisualEditor_Media_Insert_Menu-pt.png|frameless|border|200px|center]]
|-
| colspan=2 | <hr />
|-
| Ao clicar no ícone "<!-- {{int|visualeditor-dialogbutton-media-tooltip}} -->Imagens e multimédia", é aberta uma janela que procura automaticamente ficheiros multimédia relacionados com o título da página que está a editar no Wikimedia Commons.

Pode procurar por outros ficheiros multimédia ao alterar o texto no campo de pesquisa da janela.

Para escolher um ficheiro, clique na sua respetiva miniatura.

Desta forma, colocará a imagem na página que está a editar.
| [[File:VisualEditor - Media editing 2.png|frameless|border|center|500px]]
|-
| colspan=2 | <hr />
|-
| Depois da imagem que selecionou ser inserida na página, será aberta outra caixa de diálogo. A janela de média permite que insira e edite uma legenda, que pode conter formatação e hiperligações.
| [[File:VisualEditor - Media editing 6.png|frameless|border|center|400px]]
|-
| colspan=2 | <hr />
|-
| O diálogo "Média" também permite a inserção de legendas e/ou textos alternativos, para ajudarem utilizadores com leitores de ecrã, ou que possuem desabilitada a exibição de imagens nos seus navegadores.
| [[File:VisualEditor - Media editing 7.png|frameless|border|center|400px]]
|-
| colspan=2 | <hr />
|-
| Pode-se também definir vários parâmetros para a imagem na janela "<!-- {{int|visualeditor-advancedsettings-tool}} -->Configurações avançadas". Estes incluem o alinhamento, tipo e tamanho da imagem.
| [[File:VisualEditor - Media editing 8.png|frameless|border|center|400px]]
|-
| colspan=2 | <hr />
|-
| Quando terminar, clique "<!-- {{int|visualeditor-dialog-action-apply}} -->Aplicar alterações" para fechar a janela e voltar à edição da página.
| [[Ficheiro:VisualEditor_Apply_Changes-pt.png|frameless|border|center|150px]]
|-
| colspan=2 | <hr />
|-
|Ao clicar numa imagem existente, pode adicionar ou editar a sua legenda ao clicar no ícone "<!-- {{int|visualeditor-dialogbutton-media-tooltip}} -->Imagens e multimédia" que aparece abaixo da fotografia.

Pode redimensionar uma imagem existente, clicando sobre nela, e em seguida, movendo o ícone de redimensionamento (a seta de duas pontas em um ou em ambos os cantos inferiores).

Também pode arrastar e soltar uma imagem para um outro local (acima ou abaixo) da página.
| [[File:VisualEditor - Media editing 3.png|frameless|center|360px]]
|}

=== Carregar uma imagem ===

{| cellpadding="15"
|-
| <span class="mw-translate-fuzzy">Pode carregar imagens a partir de uma guia na caixa de diálogo de média.</span>
| [[File:VisualEditor - Media upload 1-pt.png|frameless|border|400px|center]]
|-
| colspan=2 | <hr />
|-
| Clique na guia "Carregar" e seleccione uma imagem de seu computador. Pode digitar o nome do ficheiro, ou arrastar uma imagem até a caixa. Se você arrastou e soltou uma imagem diretamente no editor ou colou uma da sua área de transferência, esta guia será aberta automaticamente.
| [[File:VisualEditor - Media upload 1.5.png|frameless|400px|center]]
|-
| colspan=2 | <hr />
|-
| Precisa descrever a imagem e adicionar categorias à ela e para que outras pessoas possam encontrá-la.
| [[File:VisualEditor - Media upload 2.png|frameless|400px|center]]
|-
| colspan=2 | <hr />
|-
| A imagem será inserida na página ao terminar.
|
|}

<!-- === Editar galerias multimédia ===

{| cellpadding="15"
|-
| Para adicionar uma nova galeria, clique no ícone "{{int|visualeditor-mwgallerydialog-title}}" (um conjunto de fotografias) no menu "{{int|visualeditor-toolbar-insert}}". (Caso este ícone não seja mostrado no menu, significa que a sua wiki local decidiu adiar a implementação desta funcionalidade no Editor Visual.)
| [[{{lm|VisualEditor - Gallery1|png|-}}|frameless|border|150px|center]]
|-
| colspan=2 | <hr />
|-
| Para editar uma galeria existente com o Editor Visual, clique na mesma. De seguida, na parte inferior da galeria, clique no ícone (um conjunto de fotos) para abrir o editor da galeria e mostrar a lista completa de imagens incluídas na mesma.
| [[{{lm|VisualEditor - Gallery2|png|-}}|frameless|border|center|500px]]
|-
| Isto fará abrir a janela de inserção da galeria, que é actualmente uma simples caixa que funciona de forma semelhante à marcação de wiki-texto. Para adicionar novas imagens à sua galeria, deve incluir o nome do ficheiro, seguido de uma barra (<code><nowiki>|</nowiki></code>) e da legenda que deseja inserir à imagem. Cada imagem na galeria deve estar na sua própria linha. Pode ainda editar esta lista para remover e/ou reorganizar imagens ou para alterar as legendas.

<div class="mw-translate-fuzzy">
Quando clicar no botão "$dialogdone", sairá do editor de galerias. Depois, pode visualizar as mudanças, uma vez que a galeria será agora mostrada aos leitores.
</div>

<div class="mw-translate-fuzzy">
Lembre-se que sair do editor não grava as alterações. Tal como acontece com outras alterações feitas com o Editor Visual, deve gravar a página inteira para guardar o seu trabalho.
</div>
| [[{{lm|VisualEditor - Gallery3|png|-}}|frameless|border|center|400px]]
|} -->
==Visão geral: as duas etapas básicas==
A inclusão de imagens, áudios e vídeos nos artigos da Wikipedia envolve duas etapas básicas:

* '''Localizar a imagem no [https://commons.wikimedia.org/wiki/Main_Page Wikimedia Commons]''', porque uma imagem só pode ser incluída em um artigo da Wikipédia se já tiver sido enviada previamente para a Wikimedia Commons (o [[Wikimedia Commons]] é, basicamente, um site de armazenamento de imagens, áudios e vídeos que estão sob licença livre, de propriedade da Wikimedia, a mesma fundação que também possui e administra a Wikipédia). Há duas alternativas básicas para fazer esta localização:
** Pesquisar se já há no Wikimedia Commons uma imagem adequada para o que desejamos ilustrar (podem ser quase todas imagens da Wikipédia em outros idiomas - a seção 'Problemas e soluções', no final desta página, explica porque algumas poucas imagens não podem)  OU
** Se ainda não houver no Wikimedia Commons a imagem que queremos incluir, nós mesmos a enviaremos para o Wikimedia Commons, o que é denominado adiante de '[[Ajuda:Guia de edição/Como usar imagens#Como carregar uma nova imagem no Wikimedia Commons|carregar uma imagem]]'. Note que a imagem deve estar sob uma licença livre e que não é legal e nem permitido carregar imagens de outros ''sites'' / servidores sem autorização do detentor dos direitos.

* '''Incluir a imagem previamente carregada no Wikimedia Commons''' (por nós mesmos ou por qualquer outra pessoa) '''no artigo que desejamos ilustrar'''.
Veja, a seguir, como realizar cada uma destas etapas.


Observação: Até o dia 3 de novembro de 2006, era possível carregar arquivos imagens e multimídia diretamente na Wikipédia em português. Mas isto limitava o uso destes arquivos apenas nos artigos escritos em português. Já um arquivo multimídia enviado para a Wikimedia Commons pode ser usado em artigos escritos em qualquer idioma na Wikipédia, o que faz dela um melhor destino. (O nome 'Commons' foi escolhido, exatamente, porque os seus recursos são comuns, de todos, disponíveis para todas as Wikipédias.) Por meio de uma votação, a comunidade Wikipédia em português decidiu, então, que todos os carregamentos posteriores teriam de ser feitos no Commons.

== Formas de pesquisar se já há, no Wikimedia Commons, uma imagem adequada para o que queremos ilustrar==

Para fazer esta pesquisa, utilize um ou mais dos métodos a seguir:

=== Método 1: verificar artigos na Wikipédia sobre o mesmo tema mas em outras línguas ===
Este é o método mais fácil. Se artigos sobre o mesmo tema em outras línguas tiverem imagens, em princípio podemos usá-las no artigo Wikipédia em português. No entanto, algumas imagens nos artigos em outras línguas não estão alojadas no Commons, e nesse caso não é possível usar essas imagens na Wikipédia em português.

Suponha que você quer adicionar outras imagens ao artigo ''[[água]]''. Usando este método, você faria o seguinte:
* Abra o artigo [[água]], da Wikipédia.
* Clique em uma das ligações presentes na parte inferior da barra lateral esquerda, por exemplo, na ligação <span style="color:blue;">English</span>. Abre-se o artigo [[:en:Water|Water]], da Wikipédia em inglês. (Estas ligações na parte de baixo de barra esquerda são denominados '[[Ajuda:Guia de edição/Interwikis|interwikis]]', porque abrem o artigo correspondente na Wikipédia da respectiva língua.)
* No artigo da Wikipédia inglesa, clique na imagem que deseja incluir no artigo em português (se houver alguma). Aparece a página desta imagem com o seu nome na parte superior.
* Verifique se existe, embaixo da imagem, uma caixa semelhante à apresentada a seguir:<br style="clear: both">
{{fmbox
| type  = system
| id    = mw-sharedupload
| image = [[Imagem:Commons-logo.svg|35px|link=$2|Clique para ver a imagem original no Commons]]
| style = margin-bottom: 2em; margin-top: 2em; border:3px solid #1E90FF;background-color:white;
| text  = <div>
Esta imagem provém do [[:commons:Commons:Bem-vindo|Wikimedia Commons]], um acervo de [[Licença livre|conteúdo livre]] da [[Wikimedia Foundation]] que pode ser utilizado por outros projetos.
*<span class=plainlinks style="color:#36B;">'''Ver imagem original no Wikimedia Commons'''</span> para mais informações.
* [[:commons:Commons:Reutilização de conteúdo fora da Wikimedia|Como usar esta imagem fora da Wikipédia]].
*Para usar esta imagem numa página da Wikipédia inserir: <span style="white-space:nowrap;"><nowiki>[[Imagem:</nowiki>Exemplo.svg<nowiki>|miniatura|180px|Legenda]]</nowiki></span>
</div>
}}
: Esta caixa informa que a imagem está armazenada no Commons. Portanto, se esta caixa existir, a imagem poderá ser usada no artigo em português. A seção 'Como incluir em um artigo a imagem já localizada no Wikimedia Commons' explica como. Por outro lado, se esta caixa não existir, a imagem está localizada na Wikipédia em inglês e só pode ser utilizada nela, não na Wikipédia em português.

===Método 2: pesquisar na ''homepage'' do Commons===
* Vá à [http://commons.wikimedia.org homepage do site ‘Wikimedia Commons’], no endereço http://commons.wikimedia.org.
* Faça uma busca na caixa de texto no canto superior direito, que contém a palavra ‘Search’, como se fizesse uma busca no Google. Note que a maioria das imagens no Commons encontram-se descritas em inglês e você obterá mais resultados se pesquisar com palavras inglesas (por exemplo usar "water" em vez de "água"). Surgem algumas das imagens já enviadas, se houverem.
* Verifique se, no final da 1.ª linha, há a frase ‘... possui uma <span style="color:blue;">galeria de imagens</span>’ (ou ‘... has a <span style="color:blue;">gallery of images</span>’), onde o texto em azul é uma ligação. Se houver, clique-o para acessar as demais imagens disponíveis.

===Método 3: pesquisar na página de pesquisa do Commons===
Vá à página [[commons:Special:Search]] e introduza as palavras a pesquisar. Note, mais uma vez, que a maioria das imagens no Commons encontram-se descritas em inglês e você obterá mais resultados se pesquisar com palavras inglesas (por exemplo usar "water" em vez de "água").

===Método 4: explorar as categorias de imagens do Commons===
Este método tem 2 inconvenientes :
* não lista as imagens que não foram categorizadas, ao serem carregadas
* as categorias encontram-se em língua inglesa.

Para explorar as categorias aceda à página [[commons:Category:Images]] e navegue pelas subcategorias.

Para outros métodos de pesquisa no Commons, por exemplo através do Google, consulte a página [[:commons:Commons:Pesquisa|como pesquisar no Commons]].

== Como carregar uma nova imagem no Wikimedia Commons ==
Consulte a página [[Ajuda:Como carregar ficheiros no Commons|Como carregar ficheiros no Commons]].

== Como incluir em um artigo a imagem já localizada no Wikimedia Commons ==

=== O método e a sintaxe ===
Para incluir em um artigo da Wikipedia uma imagem previamente carregada no Commons, faça o seguinte :
* Abra a página do artigo e clique na aba ‘Editar’, no alto do artigo, ou em uma das ligações [editar], à direita de cada um dos títulos. Surge a página de edição do artigo ou de uma das suas seções.
* Posicione o cursor no local onde deseja incluir a imagem e
* Inclua um código com uma das duas sintaxes a seguir :

:*'''Sintaxe simplificada rápida :'''
::Apenas substitua os 2 nomes de campo em negrito e itálico do código seguinte pelos devidos valores :
::::<code><nowiki>[[Imagem:</nowiki></code>'''''nome-do-arquivo-imagem no Wikimedia Commons'''''<code>|</code>thumb<code>|</code>'''''legenda'''''<code>]]</code>

::Observe o seguinte :
::* Não há espaço antes nem após cada uma das barras verticais que separam os campos e
::* O nome do arquivo imagem ''diferencia'' maiúsculas e minúsculas. Exemplo: Se o nome do arquivo é Imagem.jpg, nem imagem.jpg e nem Imagem.JPG irão localizá-lo.

::Exemplo: <code><nowiki>[[Imagem:Ottoman Empire 1914 h.PNG|miniatura|O Império Otomano em 1914]]</nowiki></code>
::Obs: O prefixo "Ficheiro:" pode ser trocado por "Imagem:" ou "Arquivo:".<ref>Os prefixos "Imagem:", "Arquivo:", "File:" e "Image:" são reconhecidos pelo MediaWiki e apontam todos para o domínio "Ficheiro:"</ref>

:*'''Sintaxe completa :'''
::Proporciona controle total. Use os campos que quiser do código, substituindo os seus nomes em negrito e itálico pelos devidos valores. A tabela da próxima seção informa quais valores podem ser atribuídos a cada campo. Elimine os campos que não quiser usar. Somente o campo ‘Imagem:nome-do-arquivo-imagem’ é obrigatório. Os outros são opcionais e podem ser incluídos em qualquer ordem.
::::<code><nowiki>[[Imagem:</nowiki></code>'''''nome-do-arquivo-imagem no Wikimedia Commons'''''<code>|</code>'''''tipo'''''<code>|</code>'''''legenda'''''<code>|alt=</code>'''''texto alternativo'''''<code>|</code>'''''moldura'''''<code>|</code>'''''posição horizontal'''''<code>|</code>'''''alinhamento vertical'''''<code>|</code>'''''tamanho'''''<code>|link=</code>'''''ligação para outra página'''''<code>]]</code>

::Observe o seguinte :
::* Não há espaço antes nem após cada uma das barras verticais que separam os campos e
::* O nome do arquivo imagem ''diferencia'' maiúsculas e minúsculas. Exemplo: Se o nome do arquivo é Imagem.jpg, nem imagem.jpg e nem Imagem.JPG irão localizá-lo.
::Exemplo: <code><nowiki>[[Imagem:Ottoman Empire 1914 h.PNG|miniatura|O Império Otomano em 1914|alt=Império Otomano em 1914|direita|x300px|link=Império Otomano]]</nowiki></code>

Para incluir arquivos de áudio e de vídeo, há uma sintaxe extra. Veja-a na seção [[#Sintaxe para multimídias|Sintaxe para multimídias]].

=== Valores dos campos da sintaxe ===

Veja, a seguir, os valores possíveis para cada uma das definições da sintaxe completa e os seus efeitos na apresentação da imagem.

{| class="wikitable"
! colspan="4" | Campos da Sintaxe : Características e Seus Possíveis Valores
|-
! width="15%" | Nome
! width="15%" | Tipo
! width="10%" | Valores
! Explicação
|-
| '''''nome do'''''
'''''arquivo-imagem'''''
|Necessário
| ''vários''
|Nome do arquivo-imagem proveniente dos servidores do Commons ou da Wikipédia em português. O sufixo que indica o formato do arquivo (.jpg, .gif etc.) também deve ser incluído.
|-
| rowspan="4" | '''''tipo'''''
| rowspan="4" | Opcional<br />(recomendado usar "thumb")
|<code>thumb</code>
|É a melhor opção, mesmo para apresentar imagens maiores. Características :
* Mostra a legenda.
* Mostra uma moldura ao redor da imagem.
* Se não for definida uma posição, alinha a imagem à direita.
As demais opções têm os problemas destacados em vermelho, a seguir.
|-
|<code>frame</code>
|
* <span style="color:red;">Se for atribuído, o valor atribuído para 'tamanho' não tem efeito.</span> Mostra a imagem no tamanho original.
* Mostra a legenda sob a imagem.
* Mostra uma borda em torno da imagem.
|-
|nenhuma definição
|
* <span style="color:red;">Não mostra a legenda.</span>
* Não mostra uma borda ao redor da imagem.
* Mantém o tamanho original da imagem.
|-
|<code>frameless</code>
|Semelhante a "thumb" mas com as seguintes diferenças :
* <span style="color:red;">Não mostra a legenda.</span>
* Não inclui a borda ao redor da imagem.
|-
|'''''moldura'''''
|Opcional<br />
|<code>borda</code><br />(ou <code>border</code>)
|Mostra uma borda simples ao redor da imagem.
|-
| rowspan="6" |'''''posição horizontal'''''
| rowspan="6" |Opcional
|<code>esquerda</code><br />(ou <code>left</code>)
|Mostra a imagem à esquerda, na linha seguinte ao texto que a antecede. O texto que a segue fica em volta da imagem.
|-
|<code>centro</code><br />(ou <code>center</code>)
|Mostra a imagem no centro da tela, na linha seguinte ao texto que a antecede. O texto que a segue fica embaixo da imagem.
|-
|<code>direita</code><br />(ou <code>right</code>)
|Mostra a imagem à direita, na linha seguinte ao texto que a antecede. O texto que a segue fica em volta da imagem.
|-
|<code>nenhum</code><br />(ou <code>none</code>)
|Mostra a imagem à esquerda, na linha seguinte ao texto que a antecede. O texto que a segue fica embaixo da imagem.
|-
|nenhuma definição
|Mostra a imagem na mesma linha do texto que a antecede e que a segue, a princípio centralizada verticalmente nesta linha, ou seja, metade para cima e metade para baixo da linha. Mas esta posição vertical pode ser alterada com o 'alinhamento vertical', explicado a seguir.
|-
|Terminar o fluxo de texto em torno da imagem
|Quando a imagem é colocada na posição esquerda ou direita, pode-se determinar um ponto a partir do qual o texto seguinte deixa de ser apresentado ao lado da imagem, deslocando-se para baixo da imagem. Para isto, deve-se incluir <code><nowiki><br style="clear:both;"></nowiki></code> neste ponto.
|-
| rowspan="8" |'''''alinhamento vertical'''''
| rowspan="8" |Opcional<br />(disponível apenas para imagens que não recebem nenhuma definição para a 'posição horizontal', ou seja, que são apresentadas na mesma linha do texto)
|<code>baseline</code>
|Alinha a parte inferior da imagem com a [[linha de base (tipografia)|linha de base]].
|-
|<code>meio</code><br />(ou <code>middle</code>)
|(Esta opção defecto) Alinha o centro da imagem com a linha de base mais metade da altura do texto, de modo que a imagem dique verticalmente centralizada com o texto.
|-
|<code>sub</code>
|Alinha a parte inferior da imagem ao mesmo nível da parte inferior de um texto subscrito, tal como a parte inferior do "2" em "X<sub>2</sub>".
|-
|<code>super</code>
|Alinha a parte inferior da imagem ao mesmo nível da parte inferior de um texto sobrescrito, tal como a parte inferior do "2" em "X<sup>2</sup>".
|-
|<code>text-top</code>
|Alinha o topo da imagem com topo do texto.
|-
|<code>text-bottom</code>
|Alinha a parte inferior da imagem com a parte inferior do texto.
|-
|<code>acima</code><br />(ou <code>top</code>)
|Alinha o topo da imagem com o topo da linha contendo o texto.
|-
|<code>abaixo</code><br />(ou <code>bottom</code>)
|Alinha a parte inferior da imagem com a parte inferior da linha contendo o texto.
|-
| rowspan="7" |'''''tamanho'''''
| rowspan="7" |Opcional<br />
|-
|(não especificado)
|Caso esta variável não seja preenchida, é utilizado o tamanho da imagem original, até um máximo pré-definido de :
* 800x600 pixels em páginas de descrição de imagens, e
* largura de 180 pixels em imagens dentro de molduras.
Estes tamanhos podem ser alterados nas preferências do utilizador, na opção "ficheiros".
Regra geral, '''não se deve''' especificar a largura da imagem, de forma a que o tamanho das imagens possa ser definido nas preferências do utilizador.<ref name="tamanho">'''Tamanho da Imagem:''' deve-se evitar especificar o tamanho, de forma a que este possa ser definido nas preferências do utilizador. Desse modo, por exemplo, um utilizador que visualize a Wikipédia num monitor de 21" pode definir nas preferências a visualização de imagens em miniatura a 300 pixels enquanto que outro utilizador num monitor de 17" pode usar o pré-definido a 180 pixels. Caso se defina manualmente o tamanho da imagem nos artigos, a definição do tamanho das preferências não funcionará nesses artigos. No entanto, em casos especiais é necessário especificar o tamanho:
*em predefinições, pois as imagens sem tamanho definido poderiam sair da tabela;
*em imagens com gráficos ou diagramas de pouca definição, ou demasiado complexos para uma imagem pequena, sendo necessário aumentar o tamanho para se compreender o assunto;
*em imagens panorâmicas, devido a relação largura-altura da imagem</ref> Por padrão, a largura das imagens é de 180 pixels.
|-
|<code>Largura</code>px <br />(Ex: 100px)
|Especifica a largura da imagem em pixels. A altura é automaticamente ajustada para manter a mesma proporção entre ela e a largura na imagem original.
|-
|x<code>Altura</code>px <br />(Ex: x100px)
|Especifica a altura da imagem em pixels. A largura é automaticamente ajustada para manter a mesma proporção entre ela e a altura na imagem original.
|-
|<code>Largura</code>x<code>Altura</code>px <br />(Ex: 100x150px)
|Opção, em geral, desnecessária, substituível por uma das duas anteriores, com a vantagem da clareza.<ref>Essa opção pode ser útil na confecção de predefinições para fazer a seleção automática do tamanho da imagem, de modo que a estética da predefinição (como uma caixa de informação, por exemplo) não seja prejudicada.</ref> A imagem manterá a mesma proporção largura/altura da imagem original. Mostra a imagem em um dos 2 valores definidos, que é selecionado automaticamente, de forma que ela não será maior do que a largura e nem do que a altura definidas.
|-
| <code>upright</code>
| Escala uma imagem a 75% da largura normal do thumbnail, aproximando o valor para o múltiplo mais próximo de 10 pixels.
|-
| <code>upright=</code>'''Fator'''
| Ajusta o tamanho do "thumbnail" para '''Fator''' vezes o tamanho padrão do "thumbnail", aproximando o valor para o múltiplo mais próximo de 10 pixels.
|-
| rowspan="3"|'''''ligação para outra página'''''
| rowspan="3"|Opcional<br>(não pode ser utilizado com thumb ou frame e raramente deve ser utilizado por dificultar aceder à página da imagem com as informações)
| (não especificado)
| Caso não se preencha este campo, ao clicar na imagem, o usuário será levado à sua respectiva página de descrição.
|-
| <code>ligação=</code>'''Página'''<br />(ou <code>link=</code>'''Página''')
| A imagem funciona como uma ligação de hipertexto: ao clicar na imagem, o usuário será levado ao artigo '''Página'''. Caso '''Página''' seja uma ligação URL, a imagem atuará como uma ligação externa, levando o usuário a outro sítio web.
|-
| <code>ligação=</code><br />(ou <code>link=</code>)
| Nenhuma ligação é criada. Ao clicar na imagem, nenhuma ação será executada.
|-
|'''''texto alternativo'''''
|Opcional<br />
| <code>alt=</code>'''Texto'''
| Utiliza '''Texto''' como texto alternativo para a imagem. Ver [[Wikipedia:Texto alternativo para imagens]].
|-
|'''''legenda'''''
|Opcional<br />(recomendado usar)
| ''qualquer texto que não for reconhecido dentro da sintaxe de imagens''
| Para imagens "thumbnail", "thumb", ou "frame", utiliza o texto como legenda. Para os outros tipos de imagem, especifica o texto como atributo alt, exceto se a opção de texto alternativo for especificada (nesse caso a leganda é ignorada).
|}

Nota: o campo '''''posição''''' define o alinhamento horizontal da imagem. Quando não se preenche este campo, a imagem é alinhada por definição à esquerda, quando se preenche o campo '''''moldura''''' com os valores <code>thumb</code> ou <code>frame</code>, a imagem é alinhada por definição à direita.

=== Exemplos recomendados ===
{| border="2" cellpadding="4" cellspacing="0" style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; font-size: 95%; line-height: 15px;"
|-
!Descrição
! width="35%" |Se escrever
! width="40%" |Aparece
|- valign="top"
| '''Em artigos'''<br />De forma geral, em artigos da Wikipédia deve-se usar a variável <code>thumb</code> e incluir uma legenda descritiva. No entanto não se deve especificar o largura da imagem, de forma a que o tamanho das imagens possa ser definido nas preferências do utilizador.<ref name="tamanho"/> Por padrão, a largura máxima das imagens é de 180 pixels.
|<nowiki>[[Imagem:Chalk stub.png|miniatura|Cubo de giz.]]</nowiki>
| style="background: #ffffff;" | [[Imagem:Chalk stub.png|miniatura|Cubo de giz.]]
|- valign="top"
| '''Em páginas de discussão - ligação a imagem'''<br />É possível utilizar uma [[Wikipedia:Ligação interna|ligação interna]] da imagem, sem que esta seja mostrada. Por regra, não deve ser utilizado em artigos enciclopédicos, mas apenas em [[Wikipedia:Página de discussão|páginas de discussão]] ou páginas internas da Wikipédia. Consegue-se esta funcionalidade acrescentando dois pontos (:)  antes de "Imagem".
|Encontrei esta <nowiki>[[Imagem:Chalk stub.png]]</nowiki>.
| style="background: #ffffff;" | Encontrei esta [[Imagem:Chalk stub.png]].
|- valign="top"
| '''Em páginas de discussão - ligação a imagem com texto personalizado'''<br />Funcionamento similar ao exemplo anterior, mas com a descrição personalizada.
|Encontrei uma <nowiki>[[Imagem:Chalk stub.png|imagem de um cubo de giz]]</nowiki>.
| style="background: #ffffff;" | Encontrei uma [[Imagem:Chalk stub.png|imagem de um cubo de giz]].
|- valign="top"
|'''Somente Podendo ser usado em artigos''' - quando se trata de imagens com conteúdo que possa ser considerado ofensivo a alguns como imagens de guerras, eróticas ou grotescas, mas devidamente identificado como imagem (''imagem'').
|Encontrei uma imagem de um cubo de giz. <nowiki>([[Imagem:Chalk stub.png|''imagem'']])</nowiki>
| style="background: #ffffff;" | Encontrei uma imagem de um cubo de giz. ([[Imagem:Chalk stub.png|''imagem'']])
|}

=== Outros exemplos ===
{| border="2" cellpadding="4" cellspacing="0" style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; font-size: 95%; line-height: 15px;"
|-
!Descrição
! width="35%" |Se escrever
! width="40%" |Aparece
|- valign="top"
| '''Galeria de imagens'''<br />Opção que permite dispôr um determinado número de imagens com uma grelha de 4 imagens em largura e as restantes imagens especificadas em altura. No caso de existirem menos de 4 imagens, estas ficam também alinhadas entre si. A legenda é opcional, não sendo ainda possível especificar o tamanho das imagens. De forma geral, deve-se evitar o uso de galerias em artigos.<ref>'''Galeria de imagens:''' deve-se evitar o uso em artigos por diversas razões:
*o artigo pode ficar extremamente "pesado" para o ''browser'' carregar a página;
*para visualizar galerias de imagens existe o Commons. O Commons tem esse objectivo, enquanto que a Wikipédia usa só algumas imagens para ilustrar os textos;
*as imagens em artigos da Wikipédia têm como função ilustrar e ajudar a compreender o assunto sobre o qual trata e não o contrário.</ref>
|<nowiki>
<gallery></nowiki><br /><nowiki>
Imagem:Chalk stub.png|Imagem com [[legenda]].</nowiki><br /><nowiki>
Imagem:Chalk stub.png</nowiki><br /><nowiki>
</gallery></nowiki>
| style="background: #ffffff;" |
<gallery>
Imagem:Chalk stub.png|Imagem com [[legenda]].
Imagem:Chalk stub.png
</gallery>
|- valign="top"
| '''Borda'''<br />Utilizando a variável <code>border</code> a imagem é rodeada por uma borda. Deve-se usar normalmente em predefinições que utilizem imagens com lados a branco (como a [[:Imagem:Flag of Japan.svg|bandeira do Japão]]) de forma a destacar do fundo branco. A imagem fica alinhada por defeito à esquerda.
|<nowiki>[[Imagem:Chalk stub.png|borda]]</nowiki>
| style="background: #ffffff;" |
[[Imagem:Chalk stub.png|borda]]
|- valign="top"
| '''Posição horizontal 'nenhum''''<br />Utilizando a variável <code>nenhum</code>, a imagem fica à esquerda, na linha seguinte ao texto que a antecede. O texto que a segue fica embaixo da imagem.
|Texto antes da imagem. <nowiki>[[Imagem:Chalk stub.png|nenhum]]</nowiki> Texto após a imagem.
| style="background: #ffffff;" |
Texto antes da imagem. [[Imagem:Chalk stub.png|nenhum]] Texto após a imagem.
|- valign="top"
| '''Posição horizontal não definida'''<br />A imagem aparece na mesma linha do texto que a antecede e que a segue, a princípio centralizada verticalmente nesta linha, o que pode ser alterada com o 'alinhamento vertical'.
|Texto antes da imagem. <nowiki>[[Imagem:Chalk stub.png]]</nowiki> Texto após a imagem.
| style="background: #ffffff;" |
Texto antes da imagem. [[Imagem:Chalk stub.png]] Texto após a imagem.
|- valign="top"
| '''Terminar o fluxo de texto em torno da imagem, quando ela é colocada na posição esquerda ou direita'''<br />Usando-se <code><nowiki><br style="clear:both;"></nowiki></code>, pode-se também determinar que o texto seguinte deixe de ser apresentado ao lado da imagem, deslocando-se para baixo da imagem.
|Texto antes da imagem.<nowiki><br style="clear:both;"></nowiki><nowiki>[[Imagem:Chalk stub.png|esquerda]]</nowiki> Texto após a imagem. <nowiki><br style="clear:both;"></nowiki> Texto abaixo da imagem.
| style="background: #ffffff;" |
Texto antes da imagem.<br style="clear:both;">[[Imagem:Chalk stub.png|esquerda]] <br />Texto após a imagem.<br style="clear:both;">Texto abaixo da imagem.
|}

===Mais exemplos===
Os exemplos que se seguem são para demonstração do funcionamento da sintaxe, e regra geral não devem ser aplicados dessa forma.
{| border="2" cellpadding="4" cellspacing="0" style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; font-size: 95%; line-height: 15px;"
|-
!Descrição
! width="35%" |Se escrever
! width="40%" |Aparece
|- valign="top"
| '''Imagem sem formatação'''<br />É possível usar uma imagem na sintaxe mais simples, mas não é aconselhável.
|<nowiki>[[Imagem:Chalk stub.png]]</nowiki>
| style="background: #ffffff;" | [[Imagem:Chalk stub.png]]
|- valign="top"
| '''Legenda e texto alternativo ''(Alt)'''''<br />Recomenda-se que se preencha sempre estes campos, por motivos de [[acessibilidade]]. Este texto é utilizado, por exemplo por navegadores que "leem" para invisuais, sem esse texto alternativo não sabem do que se trata a imagem. Este tipo de texto surge alguns segundos depois de se posicionar o cursor sobre a imagem. No caso de não se especificar o texto alternativo, este é substituído pelo nome da imagem (o que não é recomendável). Segue-se um exemplo de ambos os casos (posicionar o cursor sobre as imagens para perceber a diferença).
|<nowiki>[[Imagem:Chalk stub.png]]</nowiki><br /><br /><nowiki>[[Imagem:Chalk stub.png|Um cubo de giz.]]</nowiki>
| style="background: #ffffff;" |
{|
| [[Imagem:Chalk stub.png]]
| [[Imagem:Chalk stub.png|Um cubo de giz.]]
|}
|- valign="top"
| '''Posição à esquerda'''
|<nowiki>[[Imagem:Chalk stub.png|esquerda]]</nowiki>
| style="background: #ffffff;" |[[Imagem:Chalk stub.png|esquerda]]
|- valign="top"
| '''Posição horizontal ao centro'''
|<nowiki>[[Imagem:Chalk stub.png|centro]]</nowiki>
| style="background: #ffffff;" | Texto antes da imagem. Texto antes da imagem. Texto antes da imagem.[[Imagem:Chalk stub.png|centro]]Texto após a imagem. Texto após a imagem. Texto após a imagem.

|- valign="top"
| '''Posição à direita'''
|<nowiki> [[Imagem:Chalk stub.png|direita]]</nowiki>
| style="background: #ffffff;" | [[Imagem:Chalk stub.png|direita]]
|- valign="top"
| '''Tamanho da imagem'''<br />Pode-se reduzir ou aumentar o tamanho da imagem. Especifica-se o tamanho indicando a largura em px (pixels). Deve-se evitar definir o tamanho da imagem.<ref name="tamanho"/>
|<nowiki>[[Imagem:Chalk stub.png|30px]]</nowiki><br /><br /><nowiki>[[Imagem:Chalk stub.png|80px]]</nowiki>
| style="background: #ffffff;" | [[Imagem:Chalk stub.png|30px]][[Imagem:Chalk stub.png|80px]]
|- valign="top"
| '''Molduras'''<br />A imagem é apresentada numa moldura, com a opção de mostrar uma legenda, assim como especificar o tamanho da imagem e o alinhamento. Pode-se utilizar a variável ''frame'' que mostra a imagem em tamanho real, mesmo que se especifique o tamanho (o tamanho é ignorado); já a variável ''thumb'' pode ter dois resultados: se se especificar também tamanho, a imagem é apresentada nesse tamanho, caso contrário é apresentada com uma largura máxima de 180 px (caso a imagem seja menor, é apresentada no tamanho real); notar que o tamanho de 180 px pode ser outro caso seja alterado nas preferências do utilizador.
|<nowiki>[[Imagem:Chalk stub.png|border|Imagem "border"]]</nowiki><br /><nowiki>[[Imagem:Chalk stub.png|frameless|Imagem "frameless"]]</nowiki><br /><nowiki>[[Imagem:Chalk stub.png|miniatura|Imagem "thumb"]]</nowiki><br /><nowiki>[[Imagem:Chalk stub.png|frame|Imagem "frame"]]</nowiki>
| style="background: #ffffff;" | [[Imagem:Chalk stub.png|border|Imagem "border"]][[Imagem:Chalk stub.png|frameless|Imagem "frameless"]][[Imagem:Chalk stub.png|miniatura|Imagem "thumb"]][[Imagem:Chalk stub.png|frame|Imagem "frame"]]
|}

== Sintaxe para multimídias ==
A sintaxe ficheiros multimídia possuem os mesmos parâmetros que as imagens, e algumas adicionais.

=== Ficheiros de áudio (Ogg) ===
; ''Ícone de descrição do ficheiro'' : "<code>noicon</code>". Não apresenta o ícone que liga o ficheiro de som a página de descrição da mesma.

Normalmente os ficheiros de som em [[Ogg]] são utilizados nas páginas da Wikipédia utilizando a [[:Predefinição:Escute]] ou predefinições relacionas. No entanto, também é possível apresentar ficheiros de áudio sem qualquer predefinição.
{| class=wikitable
!&nbsp;!!Código!!Resultado
|-
|1.||<tt><nowiki>[[Imagem:Accordion chords-01.ogg]]</nowiki></tt>
|[[Imagem:Accordion chords-01.ogg]]
|-
|2.||<tt><nowiki>[[Imagem:Accordion chords-01.ogg|noicon]]</nowiki></tt>
|[[Imagem:Accordion chords-01.ogg|noicon]]
|-
|3.||<tt><nowiki>[[Imagem:Accordion chords-01.ogg|noicon|90px]]</nowiki></tt>
|[[Imagem:Accordion chords-01.ogg|noicon|90px]]
|}

Note que nenhum desses exemplos proporcionam ligação para [[Ajuda:Guia de consulta e reprodução/Introdução à mídia]], e os exemplos 2 e 3 fornecem apenas ligação para os ficheiros em si.

Quando deseja-se apresentar os ficheiros com ligações para sua página de descrição é necessário utilizar o seguinte método
{| class=wikitable
!&nbsp;!!Código!!Saída
|-
|1.||<tt><nowiki>[[Imagem:Accordion chords-01.ogg|90px|noicon|esquerda]] [[:Imagem:Accordion chords-01.ogg|Accordion chords]]</nowiki></tt>
|[[Imagem:Accordion chords-01.ogg|90px|noicon|esquerda]] [[:Imagem:Accordion chords-01.ogg|Accordion chords]]
|-
|2.||<tt><nowiki>[[:Imagem:Accordion chords-01.ogg|Accordion chords]] [[Imagem:Accordion chords-01.ogg|90px|noicon|direita]]</nowiki></tt>
|[[:Imagem:Accordion chords-01.ogg|Accordion chords]] [[Imagem:Accordion chords-01.ogg|90px|noicon|direita]]
|-
|3.||<tt><nowiki>[[:Imagem:Accordion chords-01.ogg|Accordion chords]] [[Imagem:Accordion chords-01.ogg|90px|noicon]]</nowiki></tt>
|[[:Imagem:Accordion chords-01.ogg|Accordion chords]] [[Imagem:Accordion chords-01.ogg|90px|noicon]]
|}
Note que o alinhamento vertical e o botão de "play" não funciona, nem é possível apresentar o botão play com texto.

=== Ficheiros de som (MIDI) ===
[[Multimédia:K520.mid]]

=== Ficheiros de vídeo (Ogg) ===
Para apresentar um vídeo com uma legenda use <code><nowiki>[[Imagem:First flights in aviation history.ogg|frame|nenhum|alt=texto altentivo|texto de legenda]]</nowiki></code>.
[[Imagem:First flights in aviation history.ogg|frame|nenhum|alt=texto alternativo|texto de legenda]]

'''Mais sintaxe para vídeos'''
; ''Imagem inicial'' : "<code>thumbtime='''Tempo'''</code>". Utiliza o frame do vídeo em um dado tempo como image inicial do vídeo (antes da visualização). '''Tempo''' pode ser tanto o número de segundos ou horas, minutos e segundos separados por dois pontos. Sem o parâmetro thumbtime, um frame da metade do vídeo é utilizado por padrão. Por exemplo, utilizando o vídeo acima:

{|
|[[Imagem:First flights in aviation history.ogg|esquerda|miniatura|thumbtime=21|[[Santos Dumont]] aos 21 segundos de vídeo. A sintaxe de tempo usando segundos é "21"]]
|[[Imagem:First flights in aviation history.ogg|centro|miniatura|thumbtime=0:23|Monoplano visto aos 23 seconds. A sintaxe de tempo usando minutos e segundos é: "0:23"]]
|[[Imagem:First flights in aviation history.ogg|direita|miniatura|thumbtime=0:0:33|Aeroplano visto aos 33 segundos. A sintaxe de tempo usando horas, minutos e segundos é: "0:0:33"]]
|}
{{-}}

No caso de vídeos com tamanho muito pequeno, utilize thumb e o campo tamanho para ampliá-lo.

<code><nowiki>[[Imagem:cal16x16check_vdnocnoafr1len2.avi.q10.ogv|inline|esquerda]] [[Imagem:cal16x16check_vdnocnoafr1len2.avi.q10.ogv|direita|miniatura|128px]]</nowiki></code>

;Resultado
[[Imagem:cal16x16check_vdnocnoafr1len2.avi.q10.ogv|inline|esquerda]] [[Imagem:cal16x16check_vdnocnoafr1len2.avi.q10.ogv|direita|miniatura|128px]]
{{-}}

== Problemas e soluções ==
*'''Posso fazer um pedido para alguém arranjar uma imagem para pôr num artigo?''' Sim, para isso aceda a [[Wikipedia:Imagens pedidas]] e coloque aí o seu pedido da imagem em falta e o nome do artigo.
*'''Algumas imagens no formato SVG não aparecem nas miniaturas.''' Isso deve-se a um ''bug'' do ''software'' MediaWiki a ser solucionado pelos programadores.
*'''Se tiver outras questões''' coloque a sua dúvida no [[Wikipedia:Café dos novatos]].

== Ver também ==
{{correlatos
|wikiquote=Ajuda:Como usar imagens
|wikilivros=Ajuda:Adicionando novas imagens
|wikinotícias=Ajuda:Como usar imagens
|wikcionario=Wikcionário:Como usar imagens
}}
* [[Wikipedia:Política de imagens|Política de imagens]]
* [[Ajuda:Como carregar ficheiros no Commons|Como carregar ficheiros no Commons]]
* [[mw:Extension:ImageMap]] - Extenção ImageMap do MediaWiki, que permite a adição de várias ligações hipertextos em uma mesma imagem, ao clicar em posições específicas da mesma.

==Notas==
{{Atalho2|WP:GALERIA}}
<references/>

[[Categoria:!Política de imagens|#]]
[[Categoria:!Guia de edição|Imagens]]
[[Categoria:!Acessibilidade]]
[[Categoria:!Ajuda:Como]]
Predefinições utilizadas nesta página:
Predefinição:!- (ver código-fonte) (apenas autorrevisores)
Predefinição:- (ver código-fonte) (apenas autorrevisores)
Predefinição:Ambox/styles.css (ver código-fonte) (apenas autorrevisores)
Predefinição:Atalho/styles.css (ver código-fonte) (apenas confirmados)
Predefinição:Atalho2 (ver código-fonte) (apenas confirmados)
Predefinição:Correlatos (ver código-fonte) (apenas autorrevisores)
Predefinição:Fmbox (ver código-fonte) (apenas administradores)
Predefinição:Informativo (ver código-fonte) (apenas confirmados)
Predefinição:Informativo/Guia de edição (editar)
Predefinição:Limpar (ver código-fonte) (apenas autorrevisores)
Predefinição:Menu lateral ocultável (ver código-fonte) (apenas autorrevisores)
Predefinição:No redirect (ver código-fonte) (apenas confirmados)
Predefinição:Nobold (ver código-fonte) (apenas autorrevisores)
Predefinição:Nobold/styles.css (ver código-fonte) (apenas autorrevisores)
Predefinição:Ombox (ver código-fonte) (apenas autorrevisores)
Predefinição:Page (editar)
Predefinição:Wikipédia/Guia de edição (ver código-fonte) (apenas confirmados)
Módulo:Arguments (ver código-fonte) (apenas autorrevisores)
Módulo:Atalho (ver código-fonte) (apenas confirmados)
Módulo:Atalho/configuração (ver código-fonte) (apenas confirmados)
Módulo:Message box (ver código-fonte) (apenas autorrevisores)
Módulo:Message box/configuration (ver código-fonte) (apenas autorrevisores)
Módulo:Navbar (ver código-fonte) (apenas autorrevisores)
Módulo:Redirect (ver código-fonte) (apenas confirmados)
Módulo:Sidebar (ver código-fonte) (apenas autorrevisores)
Módulo:Yesno (ver código-fonte) (apenas autorrevisores)
Voltar para Ajuda:Guia de edição/Como usar imagens.
Obtida de "https://pt.wikipedia.org/wiki/Ajuda:Guia_de_edição/Como_usar_imagens"