Pdfkit wkhtmltopdf binary options

Wkhtmltoimage 0.10.0 rc2 Manual Este arquivo documenta wkhtmltoimage, um programa capaz de converter documentos HTML em imagens. Contato Se você experimentar bugs ou quiser solicitar novos recursos, visite code. google/p/wkhtmltopdf/issues/list. Se você tiver quaisquer problemas ou comentários, não hesite em contactar-me: uuf6429gmail Licença Copyright (C) 2010 wkhtmltopdf / wkhtmltoimage Autores. Licença GPLv3: GNU GPL versão 3 ou posterior gnu. org/licenses/gpl. Este é um software livre: você é livre para mudar e redistribuí-lo. Não existe GARANTIA, na medida permitida por lei. Autores Escrita por Jan Habermann, Christian Sciberras e Jakob Truelsen. Patches de Mehdi Abbad, Lyes Amazouz, Pascal Bach, Emmanuel Bouthenot, Benoit Garret e Mrio Silva. Sinopse Opções gerais Os itens marcados só estão disponíveis usando o QT remendado. Especificando um Proxy Por padrão, as informações de proxy serão lidas a partir 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): O site wkhtmltopdf você pode baixar uma versão estática de wkhtmltopdf code. google/p/wkhtmltopdf/downloads/list. 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. Consulte code. google/p/wkhtmltopdf/wiki/static para obter informações sobre 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. Instalação Existem várias maneiras de instalar wkhtmltoimage. Você pode baixar um binário já compilado, ou você pode compilar wkhtmlimagem você mesmo. Exemplos 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. Contato Se você experimentar bugs ou quiser solicitar novos recursos, visite code. google/p/wkhtmltopdf/issues/list. Se tiver algum problema ou comentário, não hesite em contactar-me: consulte madalgo. au. dk/ Funcionalidade Reduzida Algumas versões do wkhtmltopdf são compiladas contra uma versão do QT sem os patches wkhtmltopdf. Essas versões estão faltando alguns recursos, você pode descobrir se a sua versão de wkhtmltopdf é um desses executando wkhtmltopdf --version se sua versão é contra um QT unpatched, 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. Em execução sem um servidor X11. Adicionando um esboço de documento ao arquivo PDF. Adicionando cabeçalhos e rodapés ao arquivo PDF. Gerando um sumário. Adicionando links no arquivo PDF gerado. Imprimir usando o tipo de mídia de tela. Desativando o recurso de redução inteligente do webkit. Licença Copyright (C) 2008,2009 Wkhtmltopdf Autores. Licença GPLv3: GNU GPL versão 3 ou posterior gnu. org/licenses/gpl. Este é um software livre: você é livre para mudar e redistribuí-lo. Não existe GARANTIA, na medida permitida por lei. Autores Escrita por Jakob Truelsen. Patches de Mrio Silva, Benoit Garret e Emmanuel Bouthenot. Sinopse Opções gerais Cabeçalhos e opções de rodapé Tabela de opções de conteúdo Opções de destaque Os itens marcados só estão disponíveis usando 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 (No caso de você não estar 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 quotPage 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 cabeçalho - header-html e usar o seguinte conteúdo no cabeçalho: Como pode ser visto no exemplo, os argumentos são enviados para o cabeçalho / rodapé html documentos em get fashion. Outlines 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 de saída. 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ê tiver duas colunas de texto onde um é deslocado verticalmente por meio de uma linha. Então webkit vai cortar uma linha em pedaços exibir 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 de forma 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. trolltech / 4.6 / qprinterPageSize-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 lento para iniciar, então você deve tentar --read-args-from-stdin, Quando --read-args-from-stdin cada linha de entrada enviada para wkhtmltopdf on stdin irá 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. google/p/wkhtmltopdf/downloads/list. 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. Consulte code. google/p/wkhtmltopdf/wiki/static para obter informações sobre 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 talvez você precise compilar wkhtmltopdf. Antes da compilação você precisará instalar dependências: X11, gcc, git e openssl. No Debian / Ubuntu 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. Depois, 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ê 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 GNU / Linux, por favor, seecode. google / p / wkhtmltopdf / wiki / compilação. Instalação Existem várias maneiras de instalar wkhtmltopdf. Você pode baixar um binário já compilado, ou você pode compilar wkhtmltopdf você 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 de versão estática do manual. Exemplos Esta seção apresenta uma série de exemplos de como invocar wkhtmltopdf. Para converter um arquivo HTML remoto para PDF: Para converter um arquivo HTML local para PDF: Você também pode converter para arquivos PS, se quiser: Produza o arquivo de amostra eler2.pdf: pdfkit 0.5.0 Wkhtmltopdf wrapper python para converter html para pdf usando O motor de renderização webkit e qt Python 2 e 3 wrapper para wkhtmltopdf utilidade para converter HTML para PDF usando Webkit. Esta versão é adaptada da biblioteca Ruby PDFKit, por isso, graças a eles. A Versão de Aviso de Instalação nos repos do debian / ubuntu reduziu a funcionalidade (porque foi compilada sem os patches QT do wkhtmltopdf), como adicionar contornos, cabeçalhos, rodapés, TOC etc. Estas opções você deve instalar estático binário de wkhtmltopdf site ou você pode usar este script. Windows e outras opções: verifique a página inicial wkhtmltopdf para instaladores binários Uso Para tarefas simples: Você pode passar uma lista com vários URLs ou arquivos: Também você pode passar um arquivo aberto: Se você deseja processar o PDF gerado, pode lê-lo para um : Você pode especificar todas as opções de wkhtmltopdf. Você pode colocar no nome da opção. Se opção sem valor, use Nenhum, Falso ou para o valor de dict: Por padrão, o PDFKit mostrará toda a saída wkhtmltopdf. Se você não quiser, você precisa passar opção silenciosa: Devido à sintaxe de comando wkhtmltopdf, as opções TOC e Cover devem ser especificadas separadamente: Você pode especificar arquivos CSS externos ao converter arquivos ou strings usando a opção css. Aviso Esta é uma solução para este erro no wkhtmltopdf. Você deve tentar a opção user-style-sheet primeiro. Você também pode passar quaisquer opções através de meta tags em seu HTML: Configuração Cada chamada de API tem um parâmetro de configuração opcional. Esta deve ser uma instância da chamada da API do pdfkit. configuration (). Faz exame das opções da configuração como paramaters iniciais. As opções disponíveis são: wkhtmltopdf - a localização do binário wkhtmltopdf. Por padrão, o pdfkit tentará localizar este usando o qual (em sistemas de tipo UNIX) ou onde (no Windows). Metatagprefix - o prefixo para pdfkit específicas meta tags - por padrão isso é pdfkit - Exemplo - para quando wkhtmltopdf não está em PATH: Solução de problemas IOError: Não wkhtmltopdf executável encontrado: Certifique-se de que você tem wkhtmltopdf no seu PATH ou definir através de configuração personalizada Seção anterior). Onde wkhtmltopdf no Windows ou que wkhtmltopdf no Linux deve retornar o caminho real para o binário. IOError: Comando Falha Este erro significa que o PDFKit não conseguiu processar uma entrada. Você pode tentar executar diretamente um comando a partir da mensagem de erro e ver o erro causado falha (em algumas versões wkhtmltopdf isso pode ser causado por falhas de segmentação) Changelog 0.5.0 Permitir passando vários arquivos css Corrigir problemas com codificações de arquivo externo Erro de aumento quando X Servidor está faltando em sistemas nix Fix testes que foi quebrado com a última versão wkhtmltopdf Atualização README 0.4.1 Mais fácil configuração de configuração personalizada Atualização README 0.4.0 Permitir passar objetos semelhantes a arquivos Capacidade de retornar PDF como uma string Permitir a especificação do usuário de configuração API chamadas Agora retorna True em bugfixes de sucesso 0.3.0 Suporte ao Python 3 0.2.4 Adicionar atualização do histórico setup. py 0.2.3 Corrigir a instalação com o setup. py Atualizar README Se você deseja processar o PDF gerado, você pode lê-lo para uma variável: Especifique todas as opções de wkhtmltopdf. Você pode drop - in opção nome. Se opção sem valor, use None, False ou para valor de dict. Para opções repetíveis (incluindo permitir, cookies, custom-header, post, postfile, run-script, replace) você pode usar uma lista ou uma tupla. Com a opção que precisa de vários valores (por exemplo, --custom-header Authorization secret), podemos usar um 2-tuple (veja o exemplo abaixo). Por padrão, o PDFKit mostrará toda a saída wkhtmltopdf. Se você não quiser, você precisa passar a opção silenciosa: Devido à sintaxe de comando wkhtmltopdf, as opções TOC e Cover devem ser especificadas separadamente. Se você precisar de cobertura antes do TOC, use a opção coverfirst: Você pode especificar arquivos CSS externos ao converter arquivos ou strings usando a opção css. Aviso Esta é uma solução para este erro no wkhtmltopdf. Você deve tentar usar a opção --user-style-sheet primeiro. Você também pode passar todas as opções através de meta tags em seu HTML: Cada chamada de API tem um parâmetro de configuração opcional. Esta deve ser uma instância da chamada da API do pdfkit. configuration (). Faz exame das opções da configuração como paramaters iniciais. As opções disponíveis são: wkhtmltopdf - a localização do binário wkhtmltopdf. Por padrão, o pdfkit tentará localizar este usando o qual (em sistemas de tipo UNIX) ou onde (no Windows). Metatagprefix - o prefixo para pdfkit específicas meta tags - por padrão, este é pdfkit - Exemplo - para quando wkhtmltopdf não está em PATH: IOError: Não wkhtmltopdf executável encontrado: Certifique-se de que você tem wkhtmltopdf em seu PATH ou definir através de configuração personalizada seção). Onde wkhtmltopdf no Windows ou que wkhtmltopdf no Linux deve retornar o caminho real para o binário. IOError: Comando Falha Este erro significa que o PDFKit não conseguiu processar uma entrada. Você pode tentar executar diretamente um comando a partir da mensagem de erro e ver o erro causado falha (em algumas versões wkhtmltopdf isso pode ser causado por falhas de segmentação) Salvando o. pdf gerado em disco Definir o cabeçalho PDFKit-save-pdf fará com que o PDFKit escreva O. pdf gerado para o arquivo indicado pelo valor do cabeçalho. Fará com que o arquivo. pdf seja salvo em path / to / saved. pdf além de ser enviado de volta para o cliente. Se o caminho não for gravável / inexistente, a escrita falhará silenciosamente. O cabeçalho PDFKit-save-pdf nunca é enviado de volta para o cliente. Problema de thread único: em ambientes de desenvolvimento, é comum executar um único processo de servidor. Isso pode causar problemas ao renderizar seu pdf requer wkhtmltopdf para bater seu servidor novamente (para imagens, js, css). Isso ocorre porque as solicitações de recursos serão bloqueadas pela solicitação inicial ea solicitação inicial estará aguardando as solicitações de recursos causando um bloqueio. Isso geralmente não é um problema em um ambiente de produção. Para contornar esse problema, você pode querer executar um servidor com vários funcionários como o Passenger ou tentar incorporar seus recursos dentro de seu HTML para evitar solicitações HTTP extras. Exemplo de solução (rails / bundler), adicione unicórnio ao grupo de desenvolvimento em seu unicórnio gem Gemfile, em seguida, executar bundle. Em seguida, adicione um arquivo config / unicorn. conf com Then para executar o aplicativo unicornrails - c config / unicorn. conf (from railsroot) Os recursos não estão incluídos no PDF: Imagens, CSS ou JavaScript não parecem estar baixando corretamente no PDF. Isto é devido ao fato de que wkhtmltopdf não sabe onde encontrar esses arquivos. Certifique-se de que está a utilizar caminhos absolutos (iniciar com a barra invertida) para os seus recursos. Se você estiver usando o PDFKit para gerar PDFs a partir de uma fonte HTML bruta, certifique-se de usar caminhos completos (caminhos de arquivos ou URLs incluindo o domínio). Em ambientes de servidor restritivos a configuração rooturl pode ser o que você está procurando para alterar seu host de ativos. Mangled no navegador: Certifique-se de que seus cabeçalhos de resposta HTTP especificam Content-Type: application / pdf Nota sobre Patches / Pull Requests Fork do projeto. Configure seu ambiente de desenvolvimento com: gem install bundler bundle install Faça sua adição de recursos ou correção de bugs. Adicione testes para ele. Isso é importante para que eu não quebrá-lo em uma versão futura, sem intenção. Confie, não mexa com rakefile, versão ou histórico. (Se você quiser ter sua própria versão, isso é bom, mas a versão bump em um commit por si mesmo, eu posso ignorar quando eu puxar) Envie-me um pedido pull. Pontos de bônus para ramos tópicos. Copyright (c) 2010 Jared Pace. Consulte LICENÇA para obter detalhes.