Manual:Image administration/pt

Este artigo descreve como MediaWiki manipula e armazena imagens, e dá algumas informações sobre como o configurar.

O mesmo se aplica a qualquer outro tipo de arquivo que possa ser carregado. Uma vez que todos os arquivos são armazenados com um artigo correspondente no namespace imagem, e que é identificado como uma imagem.

Envio e uso de imagens
Veja: Help:Images

Permitindo o envio de imagens
Para fazer o envio de imagens, três condições têm de ser preenchidas:


 * 1) O MediaWiki deve ter o envio ativado. Altere em $wgEnableUploads para true.
 * 2) O tipo de arquivo deve ser permitido. Mais informações: $wgFileExtensions.
 * 3) O usuário tem que estar conectado no sitio.

Imagens são enviadas com o Specialpage Upload.

Veja: Manual:Configuring file uploads, Manual:Mime type detection'''

Parâmetros relevantes para a manipulação de imagens
Esses parâmetros são relevantes:
 * Configuração de imagem
 * Configuração do caminho
 * Configuração de envio

Thumb em imagens
MediaWiki's prorrogando a sintaxe permite que imagens sejam automaticamente 'miniaturizadas' (verManual:Configuring file uploadsgeral para ajudar no envio de arquivos).

Uma imagem com thumb exige o ImageMagick ou GD library. ImageMagick é recomendado, uma vez que produz uma melhor qualidade nos thumbnails; ele pode ser baixado a partir de imagemagick.org. GD podem ser descarregados a partir de libgd.org. Nenhuma destas fazem parte do padrão MediaWiki instalação, embora PHP pode vir com GD.

Para versões mais antigas do Mediawiki (antes da 1.10.0) definir: $wgUseImageResize para true para permitir thumbnailing. Em versões mais recentes isto não é necessário.

Se você utilizar o ImageMagick, definir $wgUseImageMagick como true em LocalSettings.php. Certifique-se de que o $wgImageMagickConvertCommand aponta para a variável (absoluta) localização do comando para converter a sua instalação e que o comando é executável pelo servidor.

SVG
MediaWiki suporta imagem em renderização SVG: se ativada, imagens em SVG podem ser usadas como outras imagem: eles serão automaticamente prestados como um PNG e miniaturizadas como necessária na mosca.

Para ativar o suporte a SVG:

batik, ersvg. Se o conversor do programa não está no caminho do sistema, você tem que especificar o diretório que contém o programa usando $wgSVGConverterPath.
 * 1) Para permitir o envio de arquivos SVG no LocalSettings.php file: $wgFileExtensions[] = 'svg'; Note que irá recusar MediaWiki SVG arquivos contendo JavaScript, por uma questão fundamental de segurança. Para evitar alguns enganos, definir $wgAllowTitlesInSVG = true;. Se você receber uma mensagem de erro dizendo o arquivo está corrompido, certifique-se que o tipo de detecção está funcionando corretamente.
 * 2) Altere $wgSVGConverter para o renderizador que pretende utilizar. Opções disponíveis são: ImageMagick,sodipodi,inkscape,


 * librsvg é muito preciso e rápido. Tem uma grande cadeia de dependências, de modo que você pode não querer se incomodar com isso, a menos que você tenha um repositório para inclui-la e resolver as dependências para você. Os projectos Wikimedia utilizam rsvg.
 * Batik é o mais preciso SVG renderizador disponível. Baseia-se no Java. Também é muito mais lento do que rsvg. Veja SVG benchmarks.
 * Inkscape também faz um trabalho de SVGs preciso, a metade da velocidade de rsvg, mas foi projetado para uso interativo gráfico - ele exige um writable diretório home para o usuário que o executa. Uma vez que irá estar a ser executado como usuário www ou algo semelhante, que tentará criar .inkscape/ e .Gnome2/ diretórios na casa do correspondente diretório, e irá falhar silenciosamente se não for capaz de renderizar. Inkscape é preferível à rsvg (a) em Windows (que vem como um pacote autônomo) ou (b) se tiver importante SVGs traçada no Inkscape que não tornam corretamente em rsvg.
 * Sodipodi é como programa de Inkscape. As mesmas considerações valem.
 * mageMagick converte SVGs. Também lento. Este é o padrão, mas evitá-lo, se possível.
 * A maioria dos navegadores da web atual salvo Internet Explorer pode exibir SVGs diretamente, mas imprecisamente rápido (cerca bem como ImageMagick). Usando librsvg para tornar SVGs a um PNG vai dar resultados mais precisos. Directa SVG exibição não é suportado em MediaWiki por omissão.

Apagando imagens
Imagens, como páginas wiki, só podem ser excluído por sysops (a menos que os direitos de usuários tenham sido alterados). Supressão de imagens é feita mediante a supressão da descrição associada na página (ou clicando no link "excluir em todas as versões").

Apagando um revisão individual
Se uma imagem tiver sido alterada, existe uma revisão da história da imagem, que é mostrada na página da imagem. Cada revisão tem um link "excluir". Se este for clicado, a revisão e os arquivos são excluídos permanentemente.

((página da imagem (aka descrição da página) revisão e revisão da imagem são coisas distintas.

Informações sobre revisões de velhas imagens são armazenadas no oldimage table.

Restauro de imagens
Em versões anteriores ao MediaWiki versão 1,8, a opção de excluir imagens/arquivos não pode ser desfeita (apenas a descrição associados a página pode ser restaurada).

De MediaWiki versão 1,8 até 1,10, arquivos excluídos de imagens/arquivos (e, portanto, sua restauração) está desabilitado por padrão, mas pode ser ativada por definição em: $wgSaveDeletedFiles = true.

Desde MediaWiki versão 1,11, que é ativado por padrão, e $wgSaveDeletedFiles é desaprovado. Em vez disso, o comportamento é controlado por $wgFileStore.

Informações sobre suprimido imagens são armazenadas no filearchive table.

Armazenamento de dados
Quando a imagem é carregada, várias coisas que são criadas:


 * 1) Um artigo no namespace imagem com o nome exato do arquivo, por exemplo, Imagem: MyPicture.png. Este artigo é armazenado e comporta-se como qualquer outro artigo.
 * 2) O próprio arquivo está armazenado em uma pasta do sistema de hospedagem (unix).
 * 3) Se o arquivo for maior do que 800px ou superior a 600px, de um polegar com tanto 800px largura ou altura 600px será criada. O polegar é armazenada na pasta pathofwiki/images/thumb/x/xy/MyPicture.png/MyPicture.png. Cada polegar recebe a sua própria pasta com o nome da imagem original. Todas as vezes que você crie um polegar ou redimensionadas imagem dentro de um artigo, outro polegar é criada e armazenada aqui, prefixado por sua largura em px, por exemplo, 800px-MyPicture.png.

MediaWiki cria várias subpastas na pasta imagens: x/xy, em que:
 * X: 0 a F
 * Xy: com x igual a x da pasta superior e y: 0 a F.

Estas subpastas será exibido apenas se você tiver $wgHashedUploadDirectory = true (padrão). Xy são os dois primeiros caracteres do md5 hash da imagem final.

Pastas
Todos os arquivos gráficos são armazenados em uma pasta separada. Padrão é pathofwiki/images/x/xy/MyPicture.png. Veja $wgUploadPath para mais detalhes.

Descrição da/imagem subpastas:

Nota: Se $wgHashedUploadDirectory = true, MediaWiki usa a estrutura de diretório o/a/ab/foo.png. Se escolhida para false, essas pastas não serão criadas e todas as imagens são armazenadas no diretório da própria imagem (isto poupa cerca de 3 MB de espaço em disco).


 * 0-f/x0-xf: Este é o lugar para o armazenamento original os arquivos de imagem (versão mais recente).
 * Archive/0-f/x0-xf: Este é o lugar para o armazenamento de imagem original, que foram substituídas por versões mais recentes.
 * Temp/0-f/x0-xf: utilizado para fazer upload de imagem. Freqüentemente arquivos antigos continuam aqui. Deverão ser suprimidos regularmente (por razões de espaço). (Bug descrição: Quando você fazer o upload de uma foto, é armazenado na primeira temp e depois transferido. Se a imagem já existe, o usuário recebe um aviso . Se ele depois clicar em cancelar, o processo de carregamento é interrompido, mas a imagem permanece na pasta temp.)
 * Thumb/0-f/x0-xf: corresponde a 0-f: Miniaturas (gerado automaticamente), para as imagens em 0-f. Se estes se perder, eles são automaticamente regenerado. Se você excluir toda a pasta polegar, irá construir-se. Você pode passar com alguns problemas de cache.

Tabelas do banco de dados

 * O artigo Image:MyPicture.png: é armazenada como qualquer artigo na página, o texto, revisão etc
 * table image: Mantém alguns meta dados como o tamanho da imagem. Não contém o link para o arquivo. Este é provavelmente calculado pelo nome do arquivo e da razão pela qual não é possível mover artigos no namespace imagem.
 * table imagelinks: Mantém as informações no artigo de uma imagem que está sendo utilizada. (Isso poderia ter sido armazenado em pagelinks, mas alguém decidiu criar uma outra tabela.)
 * table oldimage: Este é o arquivo de imagens que foram substituídos por versões mais recentes. Nota: Imagens excluídas não são armazenadas aqui, são excluídos permanentemente (ou, em versões mais recentes do MediaWiki, mudou-se para o filearchive).
 * table filearchive: detém a informação sobre as imagens apagadas.

Espaço usado
Fotos necessitam consideravelmente mais espaço do que artigos. Os seguintes cálculos assumir um bloco de tamanho 4KB com Linux / Unix servidores.

A configuração padrão é $wgHashedUploadDirectory = true.

Necessidades de espaço para todos os diretórios:


 * Imagem diretórios: 0-f/x0-f: max. 16 * 16 = 256 diretórios = 256 * 4 KB = 1024 KB
 * Arquivo diretórios: 0-f/x0-f: max. 16 * 16 = 256 diretórios = 256 * 4 KB = 1024 KB
 * Polegar diretórios: 0-f/x0-f: max. 16 * 16 = 256 diretórios = 256 * 4 KB = 1024 KB
 * Temp diretórios: 0-f/x0-f: max. 16 * 16 = 256 diretórios = 256 * 4 KB = 1024 KB

Portanto, o montante de base do espaço necessário, sem qualquer imagens carregadas é de 4 MB.

Para cada foto que precisamos:
 * O tamanho do arquivo de imagem original + 2 KB média overhead

Para imagens com uma altura de mais de 600 pixels de largura ou mais de 800 pixels:
 * Tamanho da miniatura criado (s) + 2 KB média overhead (cada)
 * Diretório para miniatura (4KB) (cada um tem a sua própria imagem miniatura diretório)

Exemplos:
 * Imagem 20778 Byte png (pequena dimensão, não polegar): 24 KB para a imagem: Total 24 KB
 * Imagem jpeg 123,000 Byte (grande porte, auto polegar): 124 KB para a imagem, 4KB para o polegar diretório, 64 KB para o polegar: Total: 192 KB

Acesso aos arquivos
Os arquivos enviados são geralmente servidos diretamente pelo servidor, e não através do mediawiki. Embora possa haver um nível mínimo de segurança através da obscuridade caminho com criptografia (ex. /c/c4/...) veja $wgHashedUploadDirectory está definido, o caminho pode ser facilmente calculado a partir do arquivo Nome e não fornece proteção na verdade.

Limitar o acesso a usuários autorizados, ver Image Authorisation

Licença
Uma característica dos MediaWiki permite a Special:Upload Page para agilizar licenciamento de imagens. A página da Wikipedia's para envio de imagens tem um licenciamento com uma caixa abaixo do sumário da imagem. Este recurso está desativado no padrão MediaWiki. Para ativar esse recurso um sysop precisa editar Licenças no namespace MediaWiki. Exemplo: MediaWiki:Licenses

Licenças esperadas de um determinado formato em uma lista de wikis.

Linha 1 vai produzir "Licença de texto" e substituir a licença 1 modelo na imagem e transclude licença página 2. Linha 2 irá mostrar uma acinzentado cabeçalho com o texto "Cabeçalho 1:" Linha 3 irá produzir "Atribuição Compartilhamento 2,5" e transclude modelo cc-by-sa-2,5 na imagem page.

Para informações pormenorizadas do mundo real veja o exemplo, http://pt.wikipedia.org/wiki/MediaWiki:Licenses

Versão do MediaWiki
Isto aplica-se a:
 * MediaWiki 1.9.x e acima
 * Outras versões não foram confirmadas