Admin: uma edição

2014-11-19T12:13:56Z

uma edição

Shirayuki: Reverted edits by 191.177.142.241 (talk) to last revision by Fabsouza1

2014-09-03T21:34:37Z

Reverted edits by 191.177.142.241 (talk) to last revision by Fabsouza1

Página nova

= Imagens =
Esta página explica a sintaxe '''{{ns:image}}''' na edição de páginas. Primeiramente, você, ou outro usuário, terão que [[Help:Managing files/pt-br|carregar uma imagem]] antes de poder usá-la numa página.

As imagens armazenadas num servidor MediaWiki são normalmente apresentadas usando o [[Help:Namespaces/pt-br|espaço nominal]] <code>{{ns:File}}:</code> (embora o anterior <code>Imagem:</code> continue a ser suportado como um sinônimo) em um link do MediaWiki. O espaço nominal alternativo <code>{{ns:Media}}:</code> 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 [http://www.mediawiki.org mediawiki.org].

== Apresentação de uma imagem ==

=== Sintaxe ===
A sintaxe completa para mostrar uma imagem é:
<nowiki>[[</nowiki>{{ns:image}}:''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|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|alinhamento]] da imagem no texto: ''left'', ''right'', ''center'' ou ''none''.
** Quando o formato é ''<code>frame</code>'' ou ''<code>thumb</code>,'' o alinhamento por omissão é ''<code>right</code>,'' à direita.

* Opção do [[#Alinhamento vertical|alinhamento vertical]] da imagem no texto: ''baseline'', ''sub'', ''super'', ''top'', ''text-top'', ''middle'', ''bottom'' ou ''text-bottom''.

* Opção do [[#Tamanho e formato|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 ''<code>frame</code>,'' o tamanho é sempre ignorado.
** Se não for especificado um formato, ou este for ''<code>border</code>,'' o tamanho da imagem pode ser reduzido ou aumentado.
** Se o formato for ''<code>thumb</code>'' ou ''<code>frameless</code>,'' 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|formato]].
** Note que a imagem mantém sempre as proporções originais.

* Opção do [[#Links|link]], coloca sobre a imagem um link para um título (link interno) ou uma URL (link externo): ''link={destino}'' ({{mediawiki|rev:41727|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|texto alternativo]], para mudar a legenda do link sobre a imagem: ''alt={texto alternativo}'': ({{mediawiki|rev:41837|1.14+}})

* 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 <code><nowiki></nowiki></code> no lugar da legenda. Por exemplo, <code><nowiki>[[File:Example.jpg|20px|]]</nowiki></code> → [[File:Example.jpg|20px|]].

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

{| class="wikitable plainlinks" width=100%
|-
! width=15% | Formato
!Escreva
!Resultado
{{Help:Images/frame/pt|frame=|ex=Nenhum}}
{{Help:Images/frame/pt|frame=border|ex=''border'' (coloca uma borda fina cinzenta em redor da imagem)}}
{{Help:Images/frame/pt|frame=frame|ex=''frame'' (coloca uma moldura em redor da imagem e alinha-a à direita)}}
{{Help:Images/frame/pt|frame=thumb|ex=''thumb'' (apresenta a imagem em miniatura alinhada à direita, com o tamanho determinado pelas preferências do usuário)}}
{{Help:Images/frame/pt|frame=thumb=PD-icon.svg|ex=''thumb=nome do arquivo'' (permite usar uma imagem diferente na miniatura)}}
{{Help:Images/frame/pt|frame=frameless|ex=''frameless'' (tal como ''thumb'', respeita as preferências do usuário para a largura da imagem, mas sem moldura e sem flutuar à direita)}}
{{Help:Images/frame/pt|frame=frameless|2=border|ex=''frameless'' e ''border''}}
|}

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

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

{| class="wikitable" width=100%
! width=15% | Alinhamento
!Escreva
!Resultado
{{Help:Images/frame/pt|frame=|ex=Nenhum}}
{{Help:Images/frame/pt|frame=none|ex=''none''}}
{{Help:Images/frame/pt|frame=center|ex=''center''}}
{{Help:Images/frame/pt|frame=left|ex=''left''}}
{{Help:Images/frame/pt|frame=right|ex=''right''}}
|}

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

Nenhum <nowiki>[[</nowiki>{{ns:image}}:Example-pt.png|20px]]
baseline <nowiki>[[</nowiki>{{ns:image}}:Example-pt.png|20px|baseline]]
sub <nowiki>[[</nowiki>{{ns:image}}:Example-pt.png|20px|sub]]
super <nowiki>[[</nowiki>{{ns:image}}:Example-pt.png|20px|super]]
text-top <nowiki>[[</nowiki>{{ns:image}}:Example-pt.png|20px|text-top]]
middle <nowiki>[[</nowiki>{{ns:image}}:Example-pt.png|20px|middle]]
bottom <nowiki>[[</nowiki>{{ns:image}}:Example-pt.png|20px|bottom]]
text-bottom <nowiki>[[</nowiki>{{ns:image}}:Example-pt.png|20px|text-bottom]]

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

Nenhum [[{{ns:image}}:Example-pt.png|20px]]
baseline [[{{ns:image}}:Example-pt.png|20px|baseline]]
sub [[{{ns:image}}:Example-pt.png|20px|sub]]
super [[{{ns:image}}:Example-pt.png|20px|super]]
text-top [[{{ns:image}}:Example-pt.png|20px|text-top]]
middle [[{{ns:image}}:Example-pt.png|20px|middle]]
bottom [[{{ns:image}}:Example-pt.png|20px|bottom]]
text-bottom [[{{ns:image}}:Example-pt.png|20px|text-bottom]]

== Tamanho e formato ==
Dependendo do [[#Formato|formato]], o efeito da opção tamanho pode variar, como ilustrado abaixo.

{| class="wikitable" width=100%
! width=15% | Formato
!Tamanho reduzido (para largura 50px)
!Tamanho aumentado (para largura 410px)
{{Help:Images/size/pt|frame=|ex=Nenhum}}
{{Help:Images/size/pt|frame=border|ex=''border''}}
{{Help:Images/size/pt|frame=frame|ex=''frame'' (tamanho é ignorado, não aumenta nem reduz - mantém o tamanho original de 250px)}}
{{Help:Images/size/pt|frame=thumb|ex=''thumb'' (reduz, mas não aumenta para além do tamanho original de 250px)}}
{{Help:Images/size/pt|frame=frameless|ex=''frameless'' (reduz, mas não aumenta para além do tamanho original de 250px)}}
|}

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

{| class="wikitable plainlinks" width=100%
|-
! width=15% | Link
!Escreva
!Resultado
{{Help:Images/frame/pt|2=link=|ex=Imagem sem qualquer link}}
{{Help:Images/frame/pt|2=link=Página principal|ex=''link=Página principal'' (link interno sobre a imagem, para a página principal)}}
{{Help:Images/frame/pt|2=link=http://wikipedia.org|ex=''link=http:/wikipedia.org'' (link externo sobre a imagem, para a wikipedia.org)}}
{{Help:Images/frame/pt|frame=frame|2=link=http://wikipedia.org|ex=Formato é ''frame'' (''link'' é ignorado, link sobre a imagem é para o arquivo original)}}
{{Help:Images/frame/pt|frame=thumb|2=link=http://wikipedia.org|ex=Formato é ''thumb'' (''link'' é ignorado, link sobre a imagem é para o arquivo original)}}
|}

=== Link para a página de descrição do arquivo ===
Se colocar dois pontos (<code>:</code>) antes de <code>{{ns:image}}:</code>, a imagem não será apresentada. Em vez dela, é apresentado um link para a página de descrição do respectivo arquivo.

:<tt><nowiki>[[</nowiki>:{{ns:image}}:example-pt.png]]</tt> → [[:{{ns:image}}:example-pt.png]]
:<tt><nowiki>[[</nowiki>:{{ns:image}}:example-pt.png|Girassóis]]</tt> → [[:{{ns:image}}:example-pt.png|Girassóis]]

=== Link direto para o arquivo multimídia ===
Você pode usar o [[Help:Namespaces/pt-br|pseudo espaço nominal]] <code>{{ns:media}}:</code> para criar um link directo para um arquivo, sem passar pela página de descrição:

:<tt><nowiki>[[</nowiki>{{ns:media}}:example-pt.png]]</tt> → [[{{ns:media}}:example-pt.png]]
:<tt><nowiki>[[</nowiki>{{ns:media}}:example-pt.png|Girassóis]]</tt> → [[{{ns:media}}:example-pt.png|Girassóis]]

Em alternativa, pode usar:

:<tt><nowiki>[[</nowiki>{{#special:Filepath}}/example-pt.png]]</tt> → [[{{#special:Filepath}}/example-pt.png]]

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

:<tt><nowiki>[[</nowiki>{{#special:Filepath}}/inexistente.png]]</tt> → [[{{#special:Filepath}}/inexistente.png]]

A função do analisador sintáctico <code>[[Help:Magic words/pt-br#Dados para uso em URLs|filepath]]</code> pode ser usada para gerar uma URL externa para um arquivo:

:<tt><nowiki>{{</nowiki>filepath:example-pt.png<nowiki>}}</nowiki></tt> → {{FILEPATH:example-pt.png}}

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

{| class="wikitable plainlinks" width=100%
|-
! width=15% | Link
!Escreva
!Resultado
{{Help:Images/frame/pt|2=link=http://wikipedia.org|ex=Link externo sobre a imagem, sem texto alternativo}}
{{Help:Images/frame/pt|2=link=http://wikipedia.org|alt=Texto alternativo|ex=Link externo sobre a imagem, com 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, <code><nowiki>== Cabeçalho ==</nowiki></code>) 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 <code><nowiki> </nowiki></code> 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 <code><nowiki><gallery></nowiki></code>. A sintaxe é a seguinte:
<nowiki><gallery></nowiki>
{{ns:image}}:nome_do_arquivo.extensão|legenda
{{ns:image}}: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:
<nowiki><gallery></nowiki>
{{ns:image}}:Example-pt.png|Imagem 1
{{ns:image}}:Example-pt.png|um link para <nowiki>[[</nowiki>Help:Contents/pt-br]]
{{ns:image}}:Example-pt.png
{{ns:image}}:Example-pt.png
{{ns:image}}:Example-pt.png| <nowiki>''legenda em itálico''</nowiki>
{{ns:image}}:Example-pt.png|na página «<nowiki>{{</nowiki>PAGENAME}}»
</gallery>
cria o seguinte resultado:
<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>

=== Parâmetros da galeria ===
O elemento <code>gallery</code> aceita vários parâmetros adicionais:
<pre><gallery {parâmetros}>
{imagens}
</gallery></pre>
* <code>caption={legenda}</code>: coloca uma legenda na galeria.
* <code>widths={larguras}px</code>: define a largura das imagens. ''Note o uso do plural, <code>width'''s'''''</code>.
* <code>heights={alturas}px</code>: define a altura (máxima) das imagens.
* <code>perrow={número inteiro}</code>: define o número de imagens por linha.

Exemplo:

<nowiki><gallery widths=150px heights=150px perrow=4 caption="Galeria de Girassóis"></nowiki>
{{ns:image}}:Example-pt.png
{{ns:image}}:Example-pt.png
{{ns:image}}:Example-pt.png
{{ns:image}}:Example-pt.png
{{ns:image}}:Example-pt.png
{{ns:image}}:Example-pt.png
{{ns:image}}:Example-pt.png
{{ns:image}}:Example-pt.png
{{ns:image}}:Example-pt.png
{{ns:image}}:Example-pt.png
{{ns:image}}:Example-pt.png
</gallery>

Resultado:
<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>

== 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 [[Help:Managing files/pt-br|carregar um arquivo]]. Os administradores também podem permitir que a wiki aceite arquivos de repositórios externos, como por exemplo do [http://commons.wikimedia.org/wiki/Main_Page Wikimedia Commons].

{{admin tip/pt-br|tip=Para saber como possibilitar o carregamento de arquivos na sua wiki, consulte {{mediawiki|Manual:Configuring file uploads}}. Para possibilitar o uso de arquivos de repositórios externos, consulte {{mediawiki|Manual:Image Administration#Foreign Repositories}}.}}

== 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.
<pre>[http://url.para/uma/imagem.png]</pre>
Ou personalizando o texto:
<pre>[http://url.para/uma/imagem.png texto do link]</pre>
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:
<pre>http://url.para/uma/imagem.png</pre>

{{admin tip/pt-br|tip=Consulte {{mediawiki|Manual:$wgAllowExternalImages}} para saber como permitir que os usuárioes integrem imagens externas nas páginas.}}

{{Languages}}

[[Category:Help/pt-br]]

← Edição anterior	Edição das 12h13min de 19 de novembro de 2014
(Sem diferença)

Ajuda:Images/pt-br - Histórico de revisão

Admin: uma edição

Shirayuki: Reverted edits by 191.177.142.241 (talk) to last revision by Fabsouza1