====== Manipulação de Imagens e Mídia ======

Você pode enviar e embutir outros arquivos em páginas [[doku>DokuWiki]] com a [[wiki:syntax#images_and_other_files|Sintaxe de Imagens]]. Enquanto as imagens e mídia Flash são exibidas diretamente na página, outros arquivos (tais como documentos PDF) têm apenas links ao documento. Veja [[doku>mime]] para informações detalhadas.

{{:wiki:mediamanager.png?200 |O Gerenciador de mídias}}

{{http://dokuwiki.org/lib/images/toolbar/image.png}} O envio de novos arquivos é feito com o [[doku>media manager|Gerenciador de mídias]] executado da [[doku>toolbar|Barra de ferramentas]]. 

Use o formulário para enviar o arquivo. Opcionalmente, pode renomeá-lo mas, assegure-se de manter a extensão correta. Se você usar novos [[doku>namespaces]] no nome, estes serão automaticamente criados.

__Nota__: Se o administrador habilitou o suporte de [[doku>ACL|Listas de controle de acesso]], o envio de arquivos pode estar restrito a alguns usuários. Aqueles sem a devida permissão não verão o formulário de envio.

A forma como é embutida a imagem pode ser influenciada por parâmetros adicionados ao URL dela após um __ponto de interrogação__ (?). Múltiplos parâmetros são separados por um __e comercial__ (&).
===== Redimensionando =====
O DokuWiki pode redimensionar as imagens através de dois métodos. Por padrão, usa o suporte da biblioteca libGD do PHP, se estiver instalada. Mas melhores resultados podem ser obtidos com a ferramenta de linha de comando [[config:im_convert|imagemagick]].

Com libGD, o redimensionamento pode falhar se não tiver disponível memória suficiente ou o formato da imagem não for suportado pela versão instalada de libGD.

Para redimensionar imagens externas, elas têm de estar no cache do seu servidor. Para isso, você deve permitir ao [[doku>DokuWiki]] executar o download de arquivos externos, aumentando o tamanho da restrição da opção de configuração [[config:fetchsize]].

Para redimensionar proporcionalmente uma imagem informe a largura pretendida em pixels:

  {{wiki:dokuwiki-128.png?20}}

{{wiki:dokuwiki-128.png?20 }} Esta imagem será redimensionada para a largura de 20 pixels.

Se informar largura e altura, a imagem será redimensionada para a altura exata, ignorando a relação de proporcionalidade:

  {{wiki:dokuwiki-128.png?20x50}}

{{wiki:dokuwiki-128.png?20x50 }} Esta imagem será redimensionada para a largura de 20 pixels e a altura de 50 pixels.

No DokuWiki 2009-02-14 ou mais recente, informar a largura e altura resultará em corte da imagem antes do redimensionamento para evitar distorção da imagem redimensionada.

===== Links =====
O [[doku>DokuWiki]] permite embutir imagens na página com link para uma página com os detalhes dela ou uma página que a contenha em tamanho real. Tambem permite inserir imagens sem link para qualquer outra página.

Por padrão, clicar numa imagem abre uma página de detalhes criada pelo modelo do programa __detail.php__. O __detail.php__ padrão mostra uma versão maior da imagem com uma lista dos metadados EXIF e IPTC contidos nela (tais como título, autor, data de geração etc.), alem de outras informações descritivas.

A sintaxe abaixo embute na página uma imagem em tamanho real; clicar na imagem produz uma página de detalhes com os metadados dela:

  {{wiki:dokuwiki-128.png}}

{{wiki:dokuwiki-128.png?20}} Tente clicar nesta imagem para ver a página de detalhes.

Você tambem pode clicar na imagem da página de detalhes para obter ainda outra página apenas com a imagem em tamanho real. Frequentemente, você embutirá uma imagem numa página em tamanho reduzido para mostrá-la na página de detalhes em tamanho médio, de modo que apenas o link direto final mostre-a em tamanho real.

Tambem, você pode embutir uma imagem numa página de modo que, clicando nela leva diretamente à página da imagem em tamanho real. Isto é chamado link direto, indicado com a opção __direct__:

  {{wiki:dokuwiki-128.png?direct}}

{{wiki:dokuwiki-128.png?20&direct }}Tente clicar nesta imagem para ver a página do link direto.

Tambem é possível embutir uma imagem numa página sem o link para qualquer outra página. Isto é obtido com a opção __nolink__ como segue:

  {{wiki:dokuwiki-128.png?nolink}}

{{wiki:dokuwiki-128.png?20&nolink }}Tente clicar nesta imagem. Nenhum resultado, certo?

Você pode combinar os parâmetros de redimensionamento e __nolink__ escrevendo um __&__ entre eles:

  {{wiki:dokuwiki-128.png?nolink&100}}

{{wiki:dokuwiki-128.png?nolink&100}}

Se você apenas quer oferecer um link para a imagem sem mostrá-la, use a opção __linkonly__:

  {{wiki:dokuwiki-128.png?linkonly}}

{{wiki:dokuwiki-128.png?linkonly}} Este é apenas um link para a imagem.

===== Imagens Dinâmicas =====

Algumas vezes, você pode querer embutir uma imagem dinâmica como
[[http://kalsey.com/tools/buttonmaker/button.php?barPosition=50&leftText=Dynamic&leftTextColor=ffffff&rightText=IMG&rightTextPosition=54|this one]]

Com o método usual:

  {{http://kalsey.com/tools/buttonmaker/button.php?barPosition=50&leftText=Dynamic&leftTextColor=ffffff&rightText=IMG&rightTextPosition=54}}

não funciona:

{{http://kalsey.com/tools/buttonmaker/button.php?barPosition=50&leftText=Dynamic&leftTextColor=ffffff&rightText=IMG&rightTextPosition=54}}

Isso é devido ao [[DokuWiki]] supor que uma imagem termina com ''.gif'',''.jpg'' ou ''.png'' e este arquivo termina com ''.php''. O truque é acrescentar um parâmetro CGI adicional como este: __&.png__ -- o CGI ignorará o parâmetro desconhecido mas o DokuWiki pensará que se trata de uma imagem.

Você tambem precisará acrescentar um __ponto de interrogação__ (?) no fim de tudo ou o [[doku>DokuWiki]] pensará que o parâmetro CGI é uma opção de cache.

{{http://kalsey.com/tools/buttonmaker/button.php?barPosition=50&leftText=Dynamic&leftTextColor=ffffff&rightText=IMG&rightTextPosition=54&.png?}}


  {{http://kalsey.com/tools/buttonmaker/button.php?barPosition=50&leftText=Dynamic&leftTextColor=ffffff&rightText=IMG&rightTextPosition=54&.png?}}


Você pode encontar ferramentas de construção de botões em:
  * http://www.yugatech.com/make.php
  * http://kalsey.com/tools/buttonmaker/

===== Removendo Mídia =====

Às vezes, é necessário excluir arquivos de mídia do servidor. Para isso, o recurso [[doku>ACL|Listas de controle de acesso]] deve estar habilitado e o usuário que quer excluir os arquivos tem de ter a suficiente permissão. Os arquivos podem ser excluidos, clicando no ícone da lixeira do [[doku>mediamanager|Gerenciador de mídias]].

Veja tambem: [[doku>faq:deletemedia|excluindo arquivos de mídia]]


===== Links de imagens =====

Para links de imagens a outros recursos, simplesmente use o __pipe__ (|) na imagem, como faria com qualquer outro texto.

Por exemplo:   [[http://www.google.com|{{wiki:dokuwiki-128.png}}]]

  Por exemplo:  [[http://www.google.com|{{wiki:dokuwiki-128.png}}]]


Se o link é uma mídia local (como um .pdf), você pode usar a sintaxe seguinte:
  
Por exemplo:   [[this>_media/wiki:dokuwiki-128.png|{{wiki:dokuwiki-128.png}}]]

   Por exemplo:   [[this>_media/wiki:dokuwiki-128.png|{{wiki:dokuwiki-128.png}}]]

===== Cache =====

Para melhorar o desempenho para o usuário, o [[doku>DokuWiki]] tenta inserir no cache as imagens externas. Se você quer usar uma imagem externa sem o cache, pode adicionar o parâmetro __nocache__:

  {{http://de3.php.net/images/php.gif?nocache}}

Você pode combinar o __nocache__ com o redimensionamento:

  {{http://de3.php.net/images/php.gif?300x50&nocache}}

Requisitar um servidor externo em cada carga de página não é muito educado. Em vez, você pode usar o parâmetro __recache__ para permitir ao [[doku>DokuWiki]] reinserir a imagem no cache no intervalo especificado em [[config:cachetime|opção de configuração cachetime]]:

    {{http://de3.php.net/images/php.gif?recache}}