Se si desidera ulteriore processo generato PDF, si può leggere ad una variabile: è possibile specificare tutte le opzioni wkhtmltopdf. Si può cadere - in nome di opzione. Se l'opzione senza valore, utilizzare None, il valore dict False o per. Per le opzioni ripetibili (incl. Permettono, biscotto, su misura di testa, palo, postfile, eseguire script, sostituire) è possibile utilizzare una lista o una tupla. Con l'opzione che hanno bisogno di più valori (ad esempio --custom-header Authorization segreti) possiamo usare un 2-tuple (vedi esempio sotto). Per impostazione predefinita, PDFKit mostrerà tutti gli output wkhtmltopdf. Se non volerlo, è necessario passare l'opzione tranquilla: a causa di sintassi dei comandi wkhtmltopdf, TOC e opzioni di copertura deve essere specificata separatamente. Se avete bisogno di copertura prima di TOC, utilizzare l'opzione coverfirst: è possibile specificare i file CSS esterni quando la conversione di file o stringhe utilizzando l'opzione CSS. Attenzione Si tratta di una soluzione per questo bug in wkhtmltopdf. Si dovrebbe cercare opzione --user-style-sheet prima. È inoltre possibile passare opzioni tramite meta tag nel codice HTML: ogni chiamata API prende un paramater configurazione opzionale. Questo dovrebbe essere un caso di pdfkit. configuration) chiamata API (. Prende le opzioni di configurazione come paramaters iniziali. Le opzioni disponibili sono: wkhtmltopdf - la posizione del binario wkhtmltopdf. Per impostazione predefinita PDFKit tenterà di individuare questo con la quale (su sistemi di tipo UNIX) o dove (su Windows). metatagprefix - il prefisso per PDFKit specifiche meta tag - di default questo è Esempio pdfkit - - per quando wkhtmltopdf non è il PATH: IOError: Nessun eseguibile wkhtmltopdf trovato: Assicurarsi di avere wkhtmltopdf nel PATH o impostato tramite configurazione personalizzata (vedi precedente sezione). dove wkhtmltopdf in Windows o che wkhtmltopdf su Linux dovrebbe tornare percorso reale di binario. IOError: Comando non riuscito Questo errore significa che PDFKit è stato in grado di elaborare un ingresso. Si può provare a eseguire direttamente un comando dal messaggio di errore e vedere quale errore fallimento causato (su alcune versioni wkhtmltopdf questo può essere causa di difetti di segmentazione) Salvare il. pdf generato sul disco Impostazione dell'intestazione PDFKit-save-pdf causerà PDFKit di scrivere il. pdf generato al file indicato dal valore dell'intestazione. Farà sì che il. pdf per essere salvato pathtosaved. pdf oltre ad essere inviato al client. Se il percorso non è writablenon-existant la scrittura avrà esito negativo in silenzio. L'intestazione PDFKit-save-pdf non viene mai inviato al client. problema filo singolo: In ambienti di sviluppo è comune per eseguire un unico processo server. Questo può causare problemi quando il rendering pdf wkhtmltopdf richiede di colpire di nuovo il server (per le immagini, js, css). Questo perché le richieste di risorse avranno bloccato dalla richiesta iniziale e la richiesta iniziale saranno in attesa le richieste di risorse che causano una situazione di stallo. Questo di solito non è un problema in un ambiente di produzione. Per ovviare a questo problema si consiglia di eseguire un server con i lavoratori più come passeggero o cercare di incorporare le risorse all'interno del vostro codice HTML per evitare le richieste HTTP in più. Esempio soluzione (rotaie Bundler), aggiungere unicorno al gruppo di sviluppo nel vostro gioiello Gemfile unicorno quindi eseguire fascio. Quindi, aggiungere un file configunicorn. conf con l'allora per eseguire i unicornrails app - c configunicorn. conf (da railsroot) Risorse arent inclusi nel PDF: Immagini, CSS, o non JavaScript sembra essere scaricando correttamente nel PDF. Ciò è dovuto al fatto che wkhtmltopdf non sa dove trovare quei file. Assicurarsi che si sta utilizzando percorsi assoluti (iniziare con barra) alle risorse. Se si utilizza PDFKit di generare file PDF da una fonte HTML grezzo assicurarsi di utilizzare i percorsi (sia percorsi di file o URL incluso il dominio) completi. In ambienti server restrittive della configurazione RootURL può essere quello che stai cercando per cambiare il vostro ospite risorsa. uscita Mangled nel browser: Assicurarsi che le intestazioni di risposta HTTP specificano Content-Type: applicationpdf Nota sulla PatchesPull Richieste Forcella del progetto. Imposta il tuo ambiente di sviluppo con: gem install bundler bundle install Fai la tua caratteristica aggiunta o bug fix. Aggiungere test per esso. Questo è importante, così io non romperlo in una versione futura involontariamente. Commit, non si scherza con rakefile, la versione, o la storia. (Se si vuole avere la propria versione, che va bene, ma urto versione in un impegno da sola posso ignorare quando tiro) Inviami una richiesta di pull. I punti fx per argomento rami. Copyright (c) 2010 Jared Pace. Vedere LICENZE per details. Background Dopo aver letto in giro mi è sembrato che Prawn è fuori e wkhtmltopdf è in. Sembra anche come i PDFKit e wickedpdf gemme per le rotaie sono il nuovo fresco. Così ho trovato uno screencast da Ryan su come utilizzare PDFKit. Ho installato tutto, provato wkhtmltopdf sulla CLI senza problemi, giocherellava attorno con Rails Impostazioniper eseguire più processi in modo che le opere di asset gasdotti, e tutto sembrava buono, tranne Im ancora bloccato alla fine del processo (in realtà sempre la risposta PDF da il server). Quando richiedo una versione. pdf del mio punto di vista (Im utilizzando l'opzione PDFKit Middleware) il mio browser si trova proprio lì in attesa di una risposta, ma non appena uccido delle guide elaborare il PDF mi aspettavo di ottenere solo allora si apre nel browser finestra. Ciò che dà Cosa Im OS Usando: OSX 10.8.1 Rails: 3.2.8 Rubino: 1.9.3 wkhtmltopdf: 0.11.0rc1 (anche se quando ho eseguito wkhtmltopdf - V si dice 0.10.0rc2) qt: 4.8.2 Che cosa Ive fatto utilizzato il PDFKit middleware caricando config. middleware. use PDFKit :: middleware nel mio file application. rb. inclusi gioiello PDFKit nel mio Gemfile e installato con Bundler impostare il. pdf mime-type nel mio mimetypes. rb initializer con Mime :: Type. registeralias applicationpdf. pdf aggiunto config. threadsafe per configenvironmentsdevelopment. rb per più thread così bene gasdotto conflitto pretende molto con il motore PDF testato wkhtmltopdf google google. pdf e ha generato un PDF della home page di Google come previsto provato scambiando PDFKit per wickedpdf e ha incontrato lo stesso problema (impiccagione, ma quando processo Rails viene ucciso il PDF rende come previsto) che cosa assomiglia Questa è la pagina html regolare resi da Rails (Ive offuscato i dati di clienti): Questa è l'uscita CLI da Rails quando provo a passare a localhost: 3000somepath. pdf. (L'applicazione si blocca durante l'attesa di una risposta): Quando ho finalmente uccidere il processo Rails con ctrl-c il PDF finalmente si presenta nel browser come mi aspettavo di vederlo (CSS e HTML resi correttamente, quindi le attività sembrano caricare bene) : Conclusioni So far Swapping PDFKit per wickedpdf e ottenere gli stessi risultati sembra farmi pensare il problema isnt con tali librerie, ma qualcosa a che fare con il mio ambiente di sviluppo. Ma wkhtmltopdf funziona bene dalla linea di comando, in modo che mi fa pensare che esso e QT stanno facendo il loro lavoro. Il problema deve essere in Rails. Forse Im non configurando qualcosa correttamente Richiesta d'aiuto Come faccio a determinare che cosa è esattamente il problema e come posso risolvere il problema Ill ti amo se mi potete aiutare LT3 Ive anche provato ad utilizzare un metodo alternativo di rendere il PDF (con. topdf) senza l'opzione middleware come segue (fare questo ho commentata config. middleware. use PDFKit :: middleware dal mio file application. rb): sintomi esattamente lo stesso, ma utilizzando WickedPdf attualmente. A questo punto, credo che il problema si trova con wkhtmltopdf pure. Purtroppo, nessuna delle raccomandazioni Ive stato in grado di trovare in StackGoogle ha lavorato per me. Invece, avevo bisogno di combinare diversi suggerimenti, tra cui alcuni trovati in questo post. birra disinstallazione wkhtmltopdf trovare ed eliminare tutte le copie di wkhtmltopdf in usrbin linea WickedPdf. config commento in configinitializers aggiungono config. threadsafe per development. rb rimuovere middleware e consentire spettacolo azione del controller principale per gestire le richieste pdf (potrebbe non essere necessario) aggiungere wkhtmltopdf-binario a Gemfile riavviare il server fascio potrebbe anche essere necessario aggiungere Mime :: Type. registeralias applicationpdf. pdf a configinitializersmimetypes. rb (per me, questo fa sì avvertimento: già inizializzato costante PDF) Il mio set-up è stato: Mac OSX Mountain Lion con Rails 3.2.1, WEBrick, Postgres e wkhtmltopdf-binario (0.9.9.1). ha risposto 3 aprile 13 a 23:08 provare a modificare configinitializerpdfkit. rb nel seguente modo: 29 Maggio risposto 14 at 12:15 La vostra risposta 2017 Stack Exchange, Incwkhtmltopdf 0.10.0 Manuale RC2 documenti del fascicolo wkhtmltopdf, un programma in grado di convertire documenti HTML in documenti PDF. Se si verificano errori o volete richiedere nuove funzionalità si prega di visitare code. googlepwkhtmltopdfissueslist. se avete problemi o commenti non esitate a contattarmi: vedere madalgo. au. dk funzionalità ridotte Alcune versioni di wkhtmltopdf sono compilati contro una versione di QT senza le patch wkhtmltopdf. Queste versioni mancano alcune funzionalità, è possibile scoprire se la vostra versione di wkhtmltopdf è uno di questi eseguendo wkhtmltopdf --version se la versione è contro un QT senza patch, è possibile utilizzare la versione statica per ottenere tutte le funzionalità. Attualmente la lista delle funzioni supportate solo con la patch QT comprende: la stampa di documenti più di un codice HTML in un file PDF. L'esecuzione senza un server X11. L'aggiunta di una struttura del documento al file PDF. Aggiunta di intestazioni e piè di pagina al file PDF. Generazione di una tabella di contenuti. L'aggiunta di collegamenti nel file PDF generato. Stampa con la schermata di media-tipo. La disattivazione della funzione Smart strizzacervelli di WebKit. Copyright (c) 2010 wkhtmltopdfwkhtmltoimage Autori. GPLv3 Licenza: GNU GPL versione 3 o successiva gnu. orglicensesgpl. html. Questo è software libero: siete liberi di modificarlo e ridistribuirlo. Non ci sono garanzie, nella misura consentita dalla legge. Scritto da Jan Habermann, Christian Sciberras e Jakob Truelsen. Patch di Mehdi Abbad, Lyes Amazouz, Pascal Bach, Emmanuel Bouthenot, Benoit Garret e Mrio Silva. oggetti documento wkhtmltopdf è in grado di mettere più oggetti nel file di output, un oggetto o è una singola pagina web, una pagina web copertura o una tabella di contenuti. Gli oggetti vengono messi nel documento di output nell'ordine in cui sono specificati nella riga di comando, le opzioni possono essere specificate in una base per oggetto o nella zona delle opzioni globali. Opzioni dalla sezione Opzioni globali possono essere posizionati solo nella zona delle opzioni globali una pagina di oggetti mette il contenuto di una pagina web singe nel documento di output. Opzioni per l'oggetto pagina possono essere collocati nelle opzioni globali e le aree Opzioni pagina. Le opzioni applicabili possono essere trovati in sezioni opzioni di pagina e intestazioni e piè di pagina Opzioni. A copertura degli oggetti mette il contenuto di una pagina web singe nel documento di output, la pagina non viene visualizzata nella tabella dei contenuti, e non hanno le intestazioni e piè di pagina. Tutte le opzioni che possono essere specificate per un oggetto pagina possono anche essere specificate per una copertura. Una tabella di content object inserisce una tabella di contenuti nel documento di output. Tutte le opzioni che possono essere specificate per un oggetto pagina possono essere specificate anche per un toc, altre più le opzioni dalla sezione Opzioni di TOC possono essere applicati. La tabella dei contenuti è generata tramite XSLT che significa che può essere uno stile di guardare tuttavia si desidera guardare. Per ottenere un aiutante di come fare questo si può scaricare il documento XSLT predefinito fornendo il --dump-default-toc-xsl, e il contorno funziona su fornendo --dump-contorno, vedere la sezione Opzioni di contorno. Opzioni globali Outline Opzioni pagina Opzioni intestazioni a piè di pagina e le opzioni Opzioni TOC voci contrassegnate sono disponibili solo con patch QT. Specifica di una delega da informazioni proxy predefinito sarà letto dalle variabili d'ambiente: procura, AllProxy e httpProxy, le opzioni proxy possono anche specificato con l'opzione - p Ecco alcuni esempi (Nel caso in cui non si ha dimestichezza con la BNF): piè di pagina e intestazioni le intestazioni ei piè di pagina possono essere aggiunte al documento dagli argomenti --header - e --footer rispetto. In intestazione e piè di pagina stringa fornita per esempio --header-sinistra, le seguenti variabili verranno sostituite. A titolo di esempio specificando --header-destra pagina quotPage di toPagequot, si tradurrà in testo quotPage x di yquot dove x è il numero della pagina corrente e y è il numero dell'ultima pagina, ad apparire in alto a sinistra in il documento. Le intestazioni ei piè di pagina possono essere forniti con documenti HTML. A titolo di esempio si potrebbe specificare --header-html header. html, e utilizzare il seguente contenuto in header. html: Come si può vedere dall'esempio, gli argomenti vengono inviati ai documenti HeaderFooter html della moda get. Wkhtmltopdf con qt patch ha il supporto per PDF contorni noto anche come segnalibri, questo può essere abilitata specificando l'opzione --outline. I contorni sono generati in base ai tag lthgt, per una descrizione approfondita di come questo è fatto vedere la tabella della sezione Contest. L'albero di contorno a volte può essere molto profonda, se i tag lthgt in cui la diffusione di generosi nel documento HTML. L'interruttore --outline-profondità può essere utilizzato per questo vincolato. INDICE Una tabella di contenuto può essere aggiunto al documento con l'aggiunta di un toc objectto riga di comando. Per esempio: la tabella dei contenuti è generato in base al tag H nei documenti di ingresso. Prima un documento XML viene generato, allora è convertito in HTML usando XSLT. Il documento XML generato può essere visualizzato dal dumping in un file utilizzando l'interruttore --dump-contorno. Per esempio: il documento XSLT può essere specificato con l'interruttore --xsl-foglio di stile. Per esempio: l'interruttore --dump-default-toc-XSL può essere utilizzato per scaricare il foglio di stile XSLT predefinito stdout. Questo è un buon inizio per la scrittura il proprio foglio di stile Il documento XML è nel namespace quotcode. googlepwkhtmltopdfoutlinequot ha un nodo radice chiamato quotoutlinequot che contiene una serie di nodi quotitemquot. Un elemento può contenere qualsiasi numero di voce. Queste sono le sottosezioni di contorno alla sezione La voce rappresenta. Un nodo elemento ha i seguenti attributi: quottitlequot il nome della sezione. quotpagequot il numero della pagina della sezione si verifica su. quotlinkquot un URL che collega la sezione. quotbackLinkquot il nome dell'ancoraggio della sezione collegherà di nuovo a. Le opzioni rimanenti TOC influiscono solo sul foglio di stile predefinito in modo che non funziona quando si specifica un foglio di stile personalizzato. Pagina Rompere L'algoritmo di interruzioni di pagina corrente di WebKit lascia molto a desiderare. Fondamentalmente webkit renderà tutto in una pagina lunga, e poi tagliare in su in pagine. Questo significa che se si dispone di due colonne di testo dove si è spostata in senso verticale per mezzo di una linea. Poi webkit taglierà una linea in a pezzi visualizzare la metà superiore su una sola pagina. E la metà inferiore in un'altra pagina. Sarà anche rompere immagine in due e così via. Se si utilizza la versione modificata di QT è possibile utilizzare il CSS page-break-inside proprietà di porre rimedio a questo un po '. Non esiste una soluzione facile a questo problema, fino a quando questo è risolto provare organizzare i vostri documenti HTML in modo tale che esso contiene molte linee sulle quali pagine possono essere tagliato in modo netto. Pagina dimensioni La dimensione della pagina predefinita del documento reso è A4, ma utilizzando questo --page dimensioni optionthis può essere cambiato in quasi tutto il resto, come ad esempio: A3, Letter e Legal. Per un elenco completo delle pagine supportati formati vedere doc. trolltech4.6qprinter. htmlPageSize-enum. Per un controllo più fine sulla dimensione della pagina delle opzioni --page altezza e --page larghezza possono essere utilizzati argomenti lettura da stdin Se avete bisogno di convertire un sacco di pagine in un batch, e si sente che è un wkhtmltopdf po 'di lento a partire, allora si dovrebbe provare --read-args-da-stdin, quando --read-args-da-stdin ciascuna riga di input inviati a wkhtmltopdf su stdin agirà come una invocazione separata di wkhtmltopdf, con gli argomenti specificati sulla linea data in combinazione con gli argomenti dati per wkhtmltopdf per esempio si potrebbe effettuare le seguenti operazioni: versione statica sul sito wkhtmltopdf è possibile scaricare una versione statica di wkhtmltopdf code. googlepwkhtmltopdfdownloadslist. Questo binario statico funzionerà sulla maggior parte dei sistemi e viene fornito con un accumulo di patch QT. Purtroppo il binario statico non è particolarmente statica, su Linux dipende sia glibc e OpenSSL, inoltre, è necessario disporre di un server X installato ma non è in esecuzione necessaria. Avrete bisogno di avere diversi tipi di carattere installare compreso xfonts-scalabile (Type1), e msttcorefonts. Vedere code. googlepwkhtmltopdfwikistatic di guai grida. Compilazione Può accadere che il binario statico non funziona per il sistema per un motivo o l'altro, in questo caso potrebbe essere necessario compilare wkhtmltopdf te stesso. Prima di compilazione è necessario installare le dipendenze: X11, gcc, git e OpenSSL. Su DebianUbuntu questo può essere fatto come segue: Su altri sistemi è necessario utilizzare il proprio gestore di pacchetti, i pacchetti potrebbero essere chiamati in modo diverso. In primo luogo è necessario controllare la versione modificata del QT successivo è necessario configurare, compilare e installare QT, si noti questo richiederà un po 'di tempo, a seconda di quali argomenti si usa per configurare qt tutto quello che serve ora è, per compilare wkhtmltopdf. Si mostrano ora hanno un binario chiamato wkhtmltopdf nel momento cartella che è possibile utilizzare, è possibile opzionalmente installarlo eseguendo altri sistemi operativi e funzionalità avanzate Se volete maggiori dettagli o desidera compilare sotto altri systemsother operativa poi GNULinux, si prega di seecode. googlepwkhtmltopdfwikicompilation . Installazione Ci sono diversi modi per installare wkhtmltopdf. È possibile scaricare un binario già compilato, oppure si può compilare wkhtmltopdf te stesso. Su Windows il modo più semplice per installare wkhtmltopdf è quello di scaricare l'ultima installazione. Su Linux è possibile scaricare l'ultima binario statico, ma è comunque necessario installare alcuni altri pezzi di software, per saperne di più su questo leggere la sezione versione statica del manuale. Questa sezione presenta una serie di esempi di come richiamare wkhtmltopdf. Per convertire un file HTML in PDF remota: Per convertire un file HTML locale a PDF: È inoltre possibile convertire i file PS Se vi piace: Produrre il file di esempio eler2.pdf: Stampa di un libro con una tabella di contenuti:
No comments:
Post a Comment