Wkhtmltoimage 0.10.0 rc2 Manual Este arquivo documenta wkhtmltoimage, um programa capaz de converter documentos HTML em imagens. Se você enfrentar bugs ou quiser solicitar novos recursos, visite o site code. googlepwkhtmltopdfissueslist. Se você tiver quaisquer problemas ou comentários não hesite em contactar-me: uuf6429gmail Copyright (C) 2018 wkhtmltopdfwkhtmltoimage Autores. Licença GPLv3: GNU GPL versão 3 ou posterior gnu. orglicensesgpl. html. Este é o software livre: você é livre para mudar e redistribuí-lo. Não há GARANTIA, na medida permitida por lei. Escrito por Jan Habermann, Christian Sciberras e Jakob Truelsen. Patches de Mehdi Abbad, Lyes Amazouz, Pascal Bach, Emmanuel Bouthenot, Benoit Garret e Mrio Silva. Opções gerais Os itens marcados só estão disponíveis com o QT remendado. Especificando um Proxy Por padrão as informações de proxy serão lidas das variáveis de ambiente: proxy, allproxy e httpproxy, as opções de proxy também podem ser especificadas com a opção - p Aqui estão alguns exemplos (Caso você não esteja familiarizado com o BNF): Versão estática On O site wkhtmltopdf você pode baixar uma versão estática de wkhtmltopdf code. googlepwkhtmltopdfdownloadslist. Este binário estático funcionará na maioria dos sistemas e vem com uma compilação no QT remendado. Infelizmente, o binário estático não é particularmente estático, no Linux depende tanto do glibc como do openssl, além disso você precisará ter um servidor xserver instalado, mas não necessário. Você precisará ter fontes diferentes instaladas, incluindo xfonts-scalable (Type1) e msttcorefonts. Veja code. googlepwkhtmltopdfwikistatic para gritar problemas. Compilação Pode acontecer que o binário estático não funcione para o seu sistema por uma razão ou outra, nesse caso você pode precisar compilar wkhtmlimagem você mesmo. Instalação Existem várias maneiras de instalar wkhtmltoimage. Você pode baixar um binário já compilado, ou você pode compilar wkhtmlimagem você mesmo. Esta seção apresenta uma série de exemplos de como invocar wkhtmltoimage. Para converter um arquivo HTML remoto para PNG: Para converter um arquivo HTML local para PNG: wkhtmltopdf 0.9.6 Manual Este arquivo documenta wkhtmltopdf, um programa capaz de converter documentos html em documentos PDF. Se você enfrentar bugs ou quiser solicitar novos recursos, visite o site code. googlepwkhtmltopdfissueslist. Se tiver algum problema ou comentário, não hesite em contactar-me: ver madalgo. au. dk Funcionalidade Reduzida Algumas versões do wkhtmltopdf são compiladas contra uma versão do QT sem os patches wkhtmltopdf. Estas versões estão faltando alguns recursos, você pode descobrir se sua versão de wkhtmltopdf é um desses executando wkhtmltopdf --version se sua versão é contra um QT não aparafusado, você pode usar a versão estática para obter todas as funcionalidades. Atualmente, a lista de recursos suportados apenas com patch QT inclui: Imprimir mais de um documento HTML em um arquivo PDF. Executando sem um servidor X11. Adicionando um esboço de documento ao arquivo PDF. Adicionando cabeçalhos e rodapés ao arquivo PDF. Gerando uma tabela de conteúdo. Adicionando links no arquivo PDF gerado. Imprimir usando o tipo de mídia de tela. Desativando o recurso de redução inteligente do webkit. Copyright (C) 2008,2009 Wkhtmltopdf Autores. Licença GPLv3: GNU GPL versão 3 ou posterior gnu. orglicensesgpl. html. Este é o software livre: você é livre para mudar e redistribuí-lo. Não há GARANTIA, na medida permitida por lei. Escrito por Jakob Truelsen. Patches de Mrio Silva, Benoit Garret e Emmanuel Bouthenot. Opções gerais Cabeçalhos e opções de rodapé Tabela de opções de conteúdo Opções de destaque Os itens marcados somente estão disponíveis com o QT remendado. Especificando um Proxy Por padrão as informações de proxy serão lidas das variáveis de ambiente: proxy, allproxy e httpproxy, as opções de proxy também podem ser especificadas com a opção - p Aqui estão alguns exemplos (Se você não estiver familiarizado com o BNF): Footers And Headers Cabeçalhos e rodapés podem ser adicionados ao documento pelos argumentos --header - e - footer respeitosamente. Na cadeia de texto de cabeçalho e rodapé fornecida, por exemplo, --header-left, as seguintes variáveis serão substituídas. Como um exemplo especificando a página --Página de cabeçalho - direita de toPagequot, resultará no texto quotPágina x de yquot onde x é o número da página atual ey é o número da última página, para aparecer no canto superior esquerdo em o documento. Cabeçalhos e rodapés também podem ser fornecidos com documentos HTML. Como exemplo, pode-se especificar --header-html header. html e usar o seguinte conteúdo em header. html: Como pode ser visto a partir do exemplo, os argumentos são enviados para o headerfooter html documentos em get fashion. Wkhtmltopdf com patch qt tem suporte para contornos PDF também conhecido como marcas de livro, isso pode ser ativado especificando o - switch de linha. Os contornos são gerados com base nas tags lthgt, para uma descrição detalhada de como isso é feito, consulte a seção quotTable Of Contestquot. A árvore de estrutura de tópicos às vezes pode ser muito profunda, se as tags lthgt se espalharem para generoso no documento HTML. O parâmetro --outline-depth pode ser usado para ligar este. Quebra de página O algoritmo de quebra de página atual do WebKit deixa muito a desejar. Basicamente webkit irá tornar tudo em uma página longa, e depois cortá-lo em páginas. Isso significa que se você tem duas colunas de texto onde uma é deslocada verticalmente por meio de uma linha. Então webkit vai cortar uma linha em pedaços mostrar a metade superior em uma página. E a metade inferior em outra página. Também quebrará a imagem em dois e assim por diante. Se você estiver usando a versão corrigida do QT, poderá usar a propriedade CSS page-break-inside para remediar isso um pouco. Não há uma solução fácil para este problema, até que isso seja resolvido tentar organizar seus documentos HTML, de modo que ele contém muitas linhas em que as páginas podem ser cortadas limpa. Tamanhos de página O tamanho de página padrão do documento renderizado é A4, mas usando esta opção de tamanho de página pode ser alterada para quase qualquer outra coisa, como: A3, Carta e Legal. Para obter uma lista completa dos tamanhos de páginas suportados, consulte doc. trolltech4.6qprinter. htmlPageSize-enum. Para obter um controle mais fino sobre o tamanho da página, as opções --page-height e --page-width podem ser usadas Leitura de argumentos de stdin Se você precisa converter um monte de páginas em um lote, e você acha que wkhtmltopdf é um Bit a slow to start up, então você deve tentar --read-args-from-stdin, Quando --read-args-from-stdin cada linha de entrada enviada para wkhtmltopdf em stdin atuará como uma invocação separada de wkhtmltopdf, com Os argumentos especificados na linha dada combinada com os argumentos dados para wkhtmltopdf Por exemplo, um poderia fazer o seguinte: Versão estática No site wkhtmltopdf você pode baixar uma versão estática de wkhtmltopdf code. googlepwkhtmltopdfdownloadslist. Este binário estático funcionará na maioria dos sistemas e vem com uma compilação no QT remendado. Infelizmente, o binário estático não é particularmente estático, no Linux depende tanto do glibc como do openssl, além disso você precisará ter um servidor xserver instalado, mas não necessário. Você precisará ter fontes diferentes instaladas, incluindo xfonts-scalable (Type1) e msttcorefonts. Veja code. googlepwkhtmltopdfwikistatic para gritar problemas. Compilação Pode acontecer que o binário estático não funcione para o seu sistema por uma razão ou outra, nesse caso você pode precisar compilar wkhtmltopdf você mesmo. Antes da compilação você precisará instalar as dependências: X11, gcc, git e openssl. No DebianUbuntu isso pode ser feito da seguinte maneira: Em outros sistemas você deve usar seu próprio gerenciador de pacotes, os pacotes podem ser nomeados de forma diferente. Primeiro, você deve verificar a versão modificada do QT. Em seguida, você deve configurar, compilar e instalar o QT, observe que isso levará algum tempo, dependendo dos argumentos que você usa para configurar qt. Tudo o que é necessário agora é compilar wkhtmltopdf. Você mostra agora tem um binário chamado wkhtmltopdf na pasta atual que você pode usar, você pode opcionalmente instalá-lo executando Outros sistemas operacionais e recursos avançados Se você quiser mais detalhes ou deseja compilar em outros sistemas operacionais ou então GNULinux, por favor seecode. googlepwkhtmltopdfwikicompilation . Instalação Existem várias maneiras de instalar wkhtmltopdf. Você pode baixar um binário já compilado, ou você pode compilar wkhtmltopdf mesmo. Nas janelas, a maneira mais fácil de instalar wkhtmltopdf é fazer o download do instalador mais recente. No linux você pode baixar o último binário estático, no entanto você ainda precisa instalar algumas outras peças de software, para saber mais sobre isso leia a seção versão estática do manual. Esta seção apresenta uma série de exemplos de como invocar wkhtmltopdf. Para converter um arquivo HTML remoto em PDF: Para converter um arquivo HTML local em PDF: Você também pode converter em arquivos PS se desejar: Produza o arquivo de exemplo eler2.pdf: Este repositório contém os binários compilados estáticos do projeto wkhtmltopdf. Mais sobre a funcionalidade de wkhtmltopdf e wkthmltoimage podem ser encontrados lá. Binários para Microsoft Windows. Também instalável com compositor, pode ser encontrado aqui: githubwemersonjanuariowkhtmltopdf-windows Dica. A versão do binário é igual à tag git. Para instalar a versão mais recente, use 0.12.3. Este pacote pode ser encontrado no Packagist e instalado com o Composer. Requer o pacote para i386 com: E para amd64 com: O binário, em seguida, será localizado em: Também um link simbólico será criado na sua pasta bin configurado, por exemplo:
No comments:
Post a Comment