Wkhtmltoimage Binary Options

Wkhtmltoimage 0.10.0 rc2 Manual Este archivo documenta wkhtmltoimage, un programa capaz de convertir documentos HTML en imágenes. Contacto Si experimenta errores o desea solicitar nuevas funciones, visite la página code. google/p/wkhtmltopdf/issues/list. Si tiene algún problema o comentario, no dude en ponerse en contacto conmigo: uuf6429gmail Licencia Copyright (C) 2010 wkhtmltopdf / wkhtmltoimage Autores. Licencia GPLv3: GNU GPL versión 3 o posterior gnu. org/licenses/gpl. html. Éste es software libre: usted es libre de cambiar y de redistribuirlo. No hay GARANTÍA, en la medida permitida por la ley. Autores Escrito por Jan Habermann, Christian Sciberras y Jakob Truelsen. Patches de Mehdi Abbad, Lyes Amazouz, Pascal Bach, Emmanuel Bouthenot, Benoit Garret y Mrio Silva. Sinopsis Opciones generales Los elementos marcados sólo están disponibles con QT parcheado. Especificación de un proxy Por defecto, la información de proxy se leerá de las variables de entorno: proxy, allproxy y httpproxy, las opciones de proxy también se pueden especificar con el conmutador - p Aquí hay algunos ejemplos (En caso de que no estés familiarizado con el BNF): El sitio web wkhtmltopdf puede descargar una versión estática de wkhtmltopdf code. google/p/wkhtmltopdf/downloads/list. Este binario estático funcionará en la mayoría de los sistemas y viene con una compilación en QT parcheado. Desafortunadamente, el binario estático no es particularmente estático, en Linux depende tanto de glibc como de openssl, además necesitará tener instalado un xserver pero no necesario. Necesitará tener fuentes diferentes instaladas, incluyendo xfonts-scalable (Type1) y msttcorefonts. Consulta la página code. google/p/wkhtmltopdf/wiki/static para obtener información sobre los problemas. Compilación Puede ocurrir que el binario estático no funcione para su sistema por una razón u otra, en ese caso puede que tenga que compilar wkhtml para imaginarse. Instalación Hay varias maneras de instalar wkhtmltoimage. Puede descargar un binario ya compilado, o puede compilar wkhtmlimagen usted mismo. Ejemplos Esta sección presenta una serie de ejemplos de cómo invocar wkhtmltoimage. Para convertir un archivo HTML remoto a PNG: Para convertir un archivo HTML local a PNG: Si necesita versiones anteriores a 0.12.0. Usted puede mirar las descargas obsoletas. Preguntas frecuentes ¿Dónde están todos los binarios específicos de distro? Los binarios de linux genéricos deben funcionar en todas las distribuciones, ya que se basan en CentOS 6 con libpng vinculados estáticamente y libjpeg. Sin embargo, en caso de vulnerabilidades en cualquier biblioteca, una nueva versión tendrá que ser similar a lo que se requería para Windows más temprano. El soporte para los binarios específicos de distro sigue estando presente en el script de compilación pero es probable que se elimine en el futuro. Mi plataforma no es compatible ¿Qué debo hacer Compile el código fuente con las instrucciones dadas anteriormente. Existen instrucciones de compilación no oficiales para SmartOS y OpenBSD. Pero todavía son un trabajo en progreso. Symantec informa de un virus WS. Reputation.1 para las compilaciones de Windows Este es un falso positivo reportado porque Symantec no ha visto este archivo antes de ver esta aclaración para details. wkhtmltopdf 0.10.0 rc2 Manual Este archivo documenta wkhtmltopdf, un programa capaz de convertir html Documentos en documentos PDF. Contacto Si experimenta errores o desea solicitar nuevas funciones, visite la página code. google/p/wkhtmltopdf/issues/list. Si tiene algún problema o comentario, no dude en ponerse en contacto conmigo: consulte madalgo. au. dk/ Funcionalidad reducida Algunas versiones de wkhtmltopdf se compilan contra una versión de QT sin los parches wkhtmltopdf. Estas versiones faltan algunas características, puede averiguar si su versión de wkhtmltopdf es una de estas ejecutando wkhtmltopdf --version si su versión está en contra de un QT sin parche, puede utilizar la versión estática para obtener toda la funcionalidad. Actualmente, la lista de funciones que sólo se admiten con el parche QT incluye: Imprimir más de un documento HTML en un archivo PDF. Se ejecuta sin un servidor X11. Agregar un esquema de documento al archivo PDF. Agregar encabezados y pies de página al archivo PDF. Generar una tabla de contenido. Agregar enlaces en el archivo PDF generado. Impresión utilizando el tipo de pantalla de medios. Desactivación de la característica de encogimiento inteligente de webkit. Licencia Copyright (C) 2010 wkhtmltopdf / wkhtmltoimage Autores. Licencia GPLv3: GNU GPL versión 3 o posterior gnu. org/licenses/gpl. html. Éste es software libre: usted es libre de cambiar y de redistribuirlo. No hay GARANTÍA, en la medida permitida por la ley. Autores Escrito por Jan Habermann, Christian Sciberras y Jakob Truelsen. Parches de Mehdi Abbad, Lyes Amazouz, Pascal Bach, Emmanuel Bouthenot, Benoit Garret y Mrio Silva. Sinopsis Objetos de documento wkhtmltopdf es capaz de colocar varios objetos en el archivo de salida, un objeto es una sola página web, una página web de cubierta o una tabla de contenido. Los objetos se colocan en el documento de salida en el orden en que se especifican en la línea de comandos, las opciones se pueden especificar en una base por objeto o en el área de opciones globales. Las opciones de la sección Opciones globales sólo se pueden colocar en el área de opciones globales. Una página de objetos coloca el contenido de una página web única en el documento de salida. Las opciones para el objeto de página se pueden colocar en las opciones globales y las áreas de opciones de página. Las opciones aplicables se pueden encontrar en las secciones Opciones de página y encabezados y opciones de pie de página. Un objeto de tapa pone el contenido de una página web de singe en el documento de salida, la página no aparece en la tabla de contenido y no tiene encabezados y pies de página. También se pueden especificar todas las opciones que se pueden especificar para un objeto de página para una cubierta. Una tabla de objeto de contenido inserta una tabla de contenido en el documento de salida. También se pueden especificar todas las opciones que se pueden especificar para un objeto de página para un toc, y también se pueden aplicar las opciones de la sección Opciones de TOC. La tabla de contenido se genera a través de XSLT lo que significa que se puede diseñar para mirar como quiera que se vea. Para obtener una ayuda de cómo hacer esto, puede volcar el documento xslt predeterminado, suministrando el --dump-default-toc-xsl, y el esquema en el que funciona al proporcionar --dump-outline, consulte la sección Opciones de esquema. Opciones globales Esquema Opciones Opciones de página Opciones de encabezado y pie de página Opciones de TOC Los elementos marcados sólo están disponibles con QT parcheado. Especificación de un proxy Por defecto, la información de proxy se leerá desde las variables de entorno: proxy, allproxy y httpproxy, las opciones de proxy también se pueden especificar con el modificador - p. A continuación, se muestran algunos ejemplos (En caso de que no esté familiarizado con el BNF): Footers And Headers Los encabezados y pies de página se pueden agregar al documento por los argumentos --header y --footer respetuosamente. En cadena de texto de encabezado y pie de página suministrada a, por ejemplo, --header-left, se sustituirán las siguientes variables. Como ejemplo, especificando la página de la página de pie de la derecha a la página de toPagequot, se obtendrá el texto quotPage x de yquot donde x es el número de la página actual ey es el número de la última página que aparecerá en la esquina superior izquierda de el documento. Los encabezados y pies de página también se pueden suministrar con documentos HTML. Como ejemplo se podría especificar --header-html header. html, y utilizar el siguiente contenido en header. html: Como se puede ver en el ejemplo, los argumentos se envían a los documentos html de encabezado / pie de página en moda. Outlines Wkhtmltopdf con parcheado qt tiene soporte para contornos PDF también conocidos como marcas de libro, esto se puede habilitar especificando el - switch de línea de salida. Los contornos se generan en base a las etiquetas lthgt, para una descripción detallada de cómo se hace esto, consulte la sección Tabla de la competencia. El árbol del esquema puede a veces ser muy profundo, si las etiquetas del lthgt se separan a generoso en el documento del HTML. Se puede usar el conmutador --outline-depth para unir esto. Tabla de contenido Se puede agregar una tabla de contenido al documento agregando un objeto toc a la línea de comandos. Por ejemplo: La tabla de contenido se genera en base a las etiquetas H de los documentos de entrada. Primero se genera un documento XML, luego se convierte a HTML usando XSLT. El documento XML generado se puede ver descargándolo en un archivo mediante el modificador --dump-outline. Por ejemplo: El documento XSLT se puede especificar mediante el modificador --xsl-style-sheet. Por ejemplo: El modificador - dump-default-toc-xsl puede utilizarse para volcar la hoja de estilo XSLT predeterminada a stdout. Este es un buen comienzo para escribir su propia hoja de estilo El documento XML está en el espacio de nombres quotcode. google/p/wkhtmltopdf/outlinequot tiene un nodo raíz llamado quotoutlinequot que contiene un número de nodos quotitemquot. Un elemento puede contener cualquier número de elemento. Estas son las subsecciones de esquema de la sección que representa el elemento. Un nodo de elemento tiene los siguientes atributos: quottitlequot el nombre de la sección. Quotpagecuot el número de página en el que se produce la sección. Quotlinkquot una URL que enlaza a la sección. QuotbackLinkquot el nombre del ancla al que la sección enlazará de nuevo. Las opciones de TOC restantes sólo afectan a la hoja de estilos predeterminada, por lo que no funcionarán cuando se especifique una hoja de estilos personalizada. Page Breaking El algoritmo de romper páginas de WebKit deja mucho que desear. Básicamente webkit hará todo en una página larga, y luego cortar en páginas. Esto significa que si tiene dos columnas de texto donde uno está desplazado verticalmente por medio de una línea. Entonces webkit cortará una línea en pedazos exhibir la mitad superior en una página. Y la mitad inferior en otra página. También romperá la imagen en dos y así sucesivamente. Si está utilizando la versión de QT parcheado, puede utilizar la propiedad CSS page-break-inside para remediar esto de alguna manera. No hay una solución fácil a este problema, hasta que esto se resuelva intente organizar sus documentos HTML de tal manera que contiene muchas líneas en las que las páginas se pueden cortar de manera limpia. Tamaños de página El tamaño de página predeterminado del documento representado es A4, pero con esta opción de tamaño de página se puede cambiar a casi cualquier otra cosa, como por ejemplo: A3, Carta y Legal. Para obtener una lista completa de tamaños de páginas admitidos, consulte doc. trolltech / 4.6 / qprinter. htmlPageSize-enum. Para un control de grano más fino sobre el tamaño de la página se pueden usar las opciones --page-height y --page-width Lectura de argumentos de stdin Si necesita convertir muchas páginas en un lote, y siente que wkhtmltopdf es un Bit a lento para iniciar, entonces debe intentar --read-args-from-stdin, Cuando --read-args-from-stdin cada línea de entrada enviada a wkhtmltopdf en stdin actuará como una invocación separada de wkhtmltopdf, con Los argumentos especificados en la línea dada combinados con los argumentos dados a wkhtmltopdf Por ejemplo uno podría hacer lo siguiente: Versión estática En el sitio web wkhtmltopdf puede descargar una versión estática de wkhtmltopdf code. google/p/wkhtmltopdf/downloads/list. Este binario estático funcionará en la mayoría de los sistemas y viene con una compilación en QT parcheado. Desafortunadamente, el binario estático no es particularmente estático, en Linux depende tanto de glibc como de openssl, además necesitará tener instalado un xserver pero no necesario. Necesitará tener fuentes diferentes instaladas, incluyendo xfonts-scalable (Type1) y msttcorefonts. Consulta la página code. google/p/wkhtmltopdf/wiki/static para obtener información sobre los problemas. Compilación Puede suceder que el binario estático no funcione para su sistema por una razón u otra, en ese caso usted puede ser que necesite compilar wkhtmltopdf usted mismo. Antes de la compilación necesitará instalar las dependencias: X11, gcc, git y openssl. En Debian / Ubuntu esto se puede hacer de la siguiente manera: En otros sistemas debe usar su propio gestor de paquetes, los paquetes pueden ser nombrados de manera diferente. En primer lugar debe comprobar la versión modificada de QT A continuación debe configurar, compilar e instalar QT, tenga en cuenta que esto tomará bastante tiempo, dependiendo de qué argumentos se utiliza para configurar qt Todo lo que se necesita ahora es, para compilar wkhtmltopdf. Ahora mostrará un binario llamado wkhtmltopdf en la carpeta actual que puede usar, opcionalmente puede instalarlo ejecutando Otros sistemas operativos y funciones avanzadas Si desea obtener más detalles o desea compilar bajo otros sistemas operativos o GNU / Linux, por favor, seecode. google / p / wkhtmltopdf / wiki / compilación. Instalación Hay varias maneras de instalar wkhtmltopdf. Puede descargar un binario ya compilado, o puede compilar wkhtmltopdf usted mismo. En Windows la forma más fácil de instalar wkhtmltopdf es descargar el instalador más reciente. En Linux puede descargar el último binario estático, sin embargo, todavía necesita instalar algunas otras piezas de software, para obtener más información sobre esto lea la sección de versión estática del manual. Ejemplos Esta sección presenta una serie de ejemplos de cómo invocar wkhtmltopdf. Para convertir un archivo HTML remoto a PDF: Para convertir un archivo HTML local a PDF: También puede convertir a archivos PS si lo desea: Produzca el archivo de ejemplo eler2.pdf: Imprimir un libro con una tabla de contenido: