STI:MediaWiki:Ajuda:Imagens
Introdução
Esta página explica a sintaxe da imagem ao editar o wiki. Normalmente, você ou outro usuário deve fazer upload de uma imagem antes de poder usá-la em uma página.
As imagens armazenadas em um servidor MediaWiki geralmente são renderizadas usando o File:prefixo de namespace (mas o Image:prefixo de namespace legado ainda é suportado como sinônimo) como o destino de um link do MediaWiki. O Media:prefixo de namespace alternativo também pode ser usado para fazer referência ao conteúdo do arquivo de mídia original (para renderizá-lo ou baixá-lo separadamente, de qualquer página do MediaWiki).
Tipos de mídia suportados para imagens
Os seguintes formatos de arquivo são suportados por padrão:
- .jpg ou .jpeg - imagem bitmap compactada no formato JPEG padrão (este formato com perdas é mais adequado para fotografias).
- .png - imagem de bitmap no formato Portable Network Graphics (especificado pelo W3 Consortium ).
- .gif - imagem de bitmap no formato de intercâmbio de gráficos legado .
Outros formatos usados na Wikimedia e normalmente ativados em outros lugares (podem exigir uma configuração extra além do que é ativado por padrão):
- .svg - imagem escalável no formato Scalable Vector Graphics (especificado pelo Consórcio W3 ). Veja o Manual: Administração de Imagens # SVG .
- .tiff - Formato de imagem marcada. Freqüentemente usado para fotografias de arquivo de alta resolução. Freqüentemente usado com Extension: PagedTiffHandler .
- .ogg, .oga, .ogv - multimédia Ogg (áudio ou vídeo). Não é um formato de imagem, mas tratado de forma semelhante.
Freqüentemente usado com extensão: TimedMediaHandler
- .pdf - documentos com várias páginas no Portable Document Format (inicialmente especificado pela Adobe ).
Freqüentemente usado em conjunto com Extension: PdfHandler
- .djvu - documentos de bitmap com várias páginas no formato DejaVu (na maioria das vezes, digitalizações de livros).
Outros tipos de mídia podem ser suportados, mas pode não ser possível exibi-los embutidos.
Renderizando uma única imagem
Sintaxe
A sintaxe completa para exibir uma imagem é:
-
-
- [[File:Nomedoarquivo.extensão|legenda]]
-
Onde as opções devem ser separados por barras verticais ( | ):
- Opção de formato: borda e/ou sem moldura, moldura, thumbnail(ou miniatura). Se houver várias opções, a renderização da imagem pode ser inesperada. Ele controla como a imagem renderizada é formatada e incorporada no resto da página.
- Opção de redimensionamento:
-
-
- x {width} px - redimensiona a imagem para caber na largura máxima fornecida em pixels, sem restringir sua altura. (Apenas valores de pixel de número inteiro são suportados. Um caractere de espaço entre o valor de largura e "px" é permitido.)
- x {height} px - redimensiona a imagem para caber na altura máxima em pixels, sem restringir sua largura. Somente valores de pixel de número inteiro são suportados. Um caractere de espaço entre o valor da largura e "px" é permitido.
- x {width} y {height} px - redimensiona a imagem para caber na largura e altura fornecidas em pixels. Somente valores de pixel de número inteiro são suportados. Um caractere de espaço entre o valor da largura e "px" é permitido.
- upright - redimensiona uma imagem para caber em dimensões razoáveis, de acordo com as preferências do usuário (adequado para imagens cuja altura é maior do que a largura). A configuração |upright=1.0|exibirá a imagem na largura de imagem padrão do usuário. |upright=2.0|irá exibir a imagem com o dobro da largura padrão do usuário.
-
-
-
- A imagem sempre manterá sua proporção de aspecto. Imagens em tipos de mídia não escalonáveis podem ter seu tamanho reduzido, mas não aumentadas; por exemplo, imagens de bitmap não podem ser aumentadas. A configuração upright não requer um sinal de igual, ou seja, |upright 2.0| funciona da mesma forma que |upright=2.0|. Quando usado sem um valor ou sinal de igual (por exemplo, |upright|), o padrão é |upright=0.75|(embora |upright=|seja o mesmo que |upright=1.0|). Se |upright|e estiverem presentes, o primeiro será ignorado.
-
-
-
- Se houver um caractere de espaço entre "upright" e o sinal de igual (por exemplo ), ou se o valor "upright" contiver caracteres não numéricos, o valor será ignorado. O tamanho máximo padrão depende do formato e das dimensões internas da imagem (de acordo com seu tipo de mídia).
-
- Opção de alinhamento horizontal: left, right, center, none. Se várias dessas opções estiverem presentes, apenas a primeira será usada. Controla o alinhamento horizontal (e estilos embutidos / em bloco ou flutuantes) da imagem em um texto (sem valor padrão).
- Opção de alinhamento vertical: baseline, sub, super, top, text-top, middle, bottom, text-bottom. Controla o alinhamento vertical de uma imagem embutida não flutuante com o texto antes ou depois da imagem e no mesmo bloco (o alinhamento vertical padrão é o meio ).
- Opção de link:
-
-
- link = {target} - Permite alterar o destino (para um título de página arbitrário ou URL) do link gerado, ativável na superfície da imagem renderizada.
- link = (com um valor vazio) - ( MediaWiki 1.14+ ) Exibe uma imagem sem qualquer link ativável. Se houver um caractere de espaço entre linke o sinal de igual, a instrução do link será tratada como uma legenda. Incluir alguns equivalentes de caracteres HTML, como %22for ", pode fazer com que a instrução do link seja tratada como uma legenda.
-
- Outras opções específicas:
-
-
- alt = {texto alternativo} - ( MediaWiki 1.14+ ) Define o texto alternativo (mapeia para o atributo HTML alt="..."do elemento <img /> gerado ) de uma imagem que será renderizada se a imagem referenciada não puder ser baixada e incorporada, ou se a mídia de suporte deve usar o texto de descrição alternativo (por exemplo, ao usar um leitor de Braille ou com opções de acessibilidade definidas pelo usuário em seu navegador). Se houver um caractere de espaço entre alte o sinal de igual, a instrução alt será tratada como uma legenda.
- page = {number} - Renderiza o número de página especificado (atualmente aplicável apenas ao mostrar um arquivo .djvu ou .pdf).
- lang = {código de idioma} - (MediaWiki 1.22+) Para arquivos SVG contendo instruções <switch> variando em um atributo systemLanguage , seleciona o idioma para renderizar o arquivo. O padrão é o idioma da página (o padrão é o idioma padrão do projeto na maioria dos projetos ).
-
-
-
- Se um parâmetro não corresponder a nenhuma das outras possibilidades, será considerado o texto da legenda. Se mais de uma string sem parâmetro estiver presente, a string sem parâmetro final será usada como legenda. O texto da legenda é mostrado abaixo da imagem em formatos de miniatura e moldura ou como texto de dica de ferramenta em qualquer outro formato. O texto da legenda exibido nos formatos miniatura e moldura pode conter links wiki e outras formatações. As extensões do MediaWiki podem adicionar opções adicionais.
-
-
-
- Se 'alt' não for especificado e uma legenda for fornecida, o texto alternativo será criado automaticamente a partir da legenda, sem formatação, exceto quando no modo miniatura ou quadro , uma vez que a legenda já pode ser lida por leitores de tela nesse caso.
-
Visão geral: as duas etapas básicas
A inclusão de imagens, áudios e vídeos nos artigos da MediaWiki envolve duas etapas básicas:
-
- Localizar a imagem, porque uma imagem só pode ser incluída em um artigo se já tiver sido enviada previamente para o servidor local. Especial:Carregar_arquivo
-
-
-
- Pesquisar se já há uma imagem adequada para o que desejamos ilustrar OU
- Se ainda não houver a imagem que queremos incluir, nós mesmos a incluirmos OU
- Apontarmos através de hiperlinks para outros sites. Note, que para este caso a imagem deve estar sob uma licença livre e que não é de boa prática carregar imagens de outros sites / servidores sem autorização do detentor dos direitos ou que estas imagens podem ser descontinuadas sem aviso prévio.
-
-
Para fins informativos a Wikipedia utiliza a 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 Wikipedia. Isto objetiva ter não apenas um centralizador multimídia, mas também diminuir a sobrecarga do browser ao acessar algum conteúdo da Wikipédia, em suma permite:
-
-
- visualizar galerias de imagens existente no Commons. O Commons tem esse objetivo, 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.
-
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. "
| Campos da Sintaxe : Características e Seus Possíveis Valores | |||
|---|---|---|---|
| Nome | Tipo | Valores | Explicação |
| nome do
arquivo-imagem |
Necessário | vários | Nome do arquivo-imagem proveniente. O sufixo que indica o formato do arquivo (.jpg, .gif, etc) também deve ser incluído. |
| tipo | Opcional (recomendado usar "thumb") |
thumb
|
É a melhor opção, mesmo para apresentar imagens maiores. Características :
As demais opções têm os problemas destacados em vermelho, a seguir. |
frame
|
| ||
| nenhuma definição |
| ||
frameless
|
Semelhante a "thumb" mas com as seguintes diferenças :
| ||
| moldura | Opcional | borda(ou border)
|
Mostra uma borda simples ao redor da imagem. |
| posição horizontal | Opcional | esquerda(ou left)
|
Mostra a imagem à esquerda, na linha seguinte ao texto que a antecede. O texto que a segue fica em volta da imagem. |
centro(ou center)
|
Mostra a imagem no centro da tela, na linha seguinte ao texto que a antecede. O texto que a segue fica embaixo da imagem. | ||
direita(ou right)
|
Mostra a imagem à direita, na linha seguinte ao texto que a antecede. O texto que a segue fica em volta da imagem. | ||
nenhum(ou none)
|
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 <br style="clear:both;">
neste ponto. | ||
| alinhamento vertical | Opcional (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) |
baseline
|
Alinha a parte inferior da imagem com a linha de base. |
meio(ou middle)
|
(Esta opção) 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. | ||
sub
|
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 "X2". | ||
super
|
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 "X2". | ||
text-top
|
Alinha o topo da imagem com topo do texto. | ||
text-bottom
|
Alinha a parte inferior da imagem com a parte inferior do texto. | ||
acima(ou top)
|
Alinha o topo da imagem com o topo da linha contendo o texto. | ||
abaixo(ou bottom)
|
Alinha a parte inferior da imagem com a parte inferior da linha contendo o texto. | ||
| tamanho | Opcional | ||
| (não especificado) | Caso esta variável não seja preenchida, é utilizado o tamanho da imagem original, até um máximo pré-definido de :
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. 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 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:
| ||
Largurapx(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. | ||
xAlturapx(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. | ||
LarguraxAlturapx(Ex: 100x150px) |
Opção, em geral, desnecessária, substituível por uma das duas anteriores, com a vantagem da clareza. 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. 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. | ||
upright
|
Escala uma imagem a 75% da largura normal do thumbnail, aproximando o valor para o múltiplo mais próximo de 10 pixels. | ||
upright=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. | ||
| ligação para outra página | Opcional (não pode ser utilizado com thumb ou frame e raramente deve ser utilizado por dificultar o acesso à 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 a página de descrição da mesma. |
ligação=Página(ou link=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. | ||
ligação=(ou link=)
|
Nenhum hiperlink é criado. Ao clicar na imagem, nenhuma ação será executada. | ||
| texto alternativo | Opcional | alt="Texto
|
Utiliza Texto como texto alternativo para a imagem. |
| legenda | Opcional (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 legenda é 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 thumb ou frame, a imagem é alinhada por definição à direita.
Importante: Para maiores informações para tratamento de imagem em modo avançado consulte:
|
| ||
