wkhtmltoimage 0.10.0 rc2 Manuell Den här filen dokumenterar wkhtmltoimage, ett program som kan konvertera HTML-dokument till bilder. Om du upplever fel eller vill begära nya funktioner, besök code. googlepwkhtmltopdfissueslist. Om du har några problem eller kommentarer, var god kontakta mig: uuf6429gmail Copyright (C) 2010 wkhtmltopdfwkhtmltoimage Författare. Licens GPLv3: GNU GPL version 3 eller senare gnu. orglicensesgpl. html. Detta är fri programvara: du är fri att ändra och omfördela den. Det finns INGEN GARANTI, i den utsträckning som lag tillåts. Skriven av Jan Habermann, Christian Sciberras och Jakob Truelsen. Patches av Mehdi Abbad, Lyes Amazouz, Pascal Bach, Emmanuel Bouthenot, Benoit Garret och Mrio Silva. Allmänna alternativ De markerade objekten är endast tillgängliga med patched QT. Ange en proxy Som standard kommer proxyinformation att läsas från miljövariablerna: proxy, allproxy och httpproxy, proxyalternativ kan också anges med - p-omkopplaren Här är några exempel (om du inte är bekant med BNF): Statisk version På På wkhtmltopdf-webbplatsen kan du ladda ner en statisk version av wkhtmltopdf code. googlepwkhtmltopdfdownloadslist. Denna statiska binära kommer att fungera på de flesta system och kommer med en inbyggd plåst QT. Tyvärr är det statiska binäret inte särskilt statiskt. På Linux beror det på både glibc och openssl, dessutom behöver du ha en xserver installerad men inte nödvändig att köra. Du måste ha olika skrifter installerade inklusive xfonts-skalbar (Type1) och msttcorefonts. Se code. googlepwkhtmltopdfwikistatic för problem att skrika. Sammanställning Det kan hända att det statiska binäret inte fungerar för ditt system av någon anledning eller det andra, i så fall kanske du behöver kompilera wkhtmltoimage själv. Installation Det finns flera sätt att installera wkhtmltoimage. Du kan ladda ner en redan sammanställd binär, eller du kan kompilera wkhtmltoimage själv. I det här avsnittet presenteras ett antal exempel på hur man använder wkhtmltoimage. Att konvertera en fjärr HTML-fil till PNG: Att konvertera en lokal HTML-fil till PNG: wkhtmltopdf 0.9.6 Manuell Denna fildokument wkhtmltopdf, ett program som kan konvertera html-dokument till PDF-dokument. Om du upplever fel eller vill begära nya funktioner, besök code. googlepwkhtmltopdfissueslist. Om du har några problem eller kommentarer är du välkommen att kontakta mig: se madalgo. au. dk Minskad funktionalitet Vissa versioner av wkhtmltopdf kompileras mot en version av QT utan wkhtmltopdf-patchar. Dessa versioner saknar vissa funktioner, du kan ta reda på om din version av wkhtmltopdf är en av dessa genom att köra wkhtmltopdf --version om din version är emot en omladdad QT, kan du använda den statiska versionen för att få all funktionalitet. För närvarande innehåller listan över funktioner som endast stöds med patch QT: Skriv ut mer än ett HTML-dokument i en PDF-fil. Running utan en X11-server. Lägga till en dokumentbeskrivning till PDF-filen. Lägga till rubriker och sidfot i PDF-filen. Skapa en innehållsförteckning. Lägga till länkar i den genererade PDF-filen. Utskrift med skärmmedietypen. Inaktivera smarta krympningsfunktionen i webkit. Upphovsrätt (C) 2008,2009 Wkhtmltopdf Författare. Licens GPLv3: GNU GPL version 3 eller senare gnu. orglicensesgpl. html. Detta är fri programvara: du är fri att ändra och omfördela den. Det finns INGEN GARANTI, i den utsträckning som lag tillåts. Skriven av Jakob Truelsen. Patches av Mrio Silva, Benoit Garret och Emmanuel Bouthenot. Allmänna Alternativ Huvud och sidfot Alternativ för innehåll Innehåll Alternativ Alternativ Alternativ Markerade är endast tillgängliga med patched QT. Ange en proxy Som standard läs proxyinformation från miljövariablerna: proxy, allproxy och httpproxy, proxyalternativ kan också anges med - p-omkopplaren Här är några exempel (om du inte är bekant med BNF): Footers And Headers Rubriker och sidfot kan läggas till i dokumentet med respekt för --header - och - footer-argumenten. I textrubrik för sidhuvud och sidfot tillförs till t. ex. --header-left, kommer följande variabler att ersättas. Som ett exempel som specificerar - header-right quotPage-sidan till toPagequot kommer resultatet att resultera i texten quotPage x of yquot där x är numret på den aktuella sidan och y är numret på den sista sidan, visas i det övre vänstra hörnet i dokumentet. Rubriker och sidfot kan också levereras med HTML-dokument. Som ett exempel kan man ange - header-html header. html och använd följande innehåll i header. html: Som kan ses från exemplet skickas argumenten till headerfooter html-dokumenten i få mode. Wkhtmltopdf med patched qt har stöd för PDF-konturer, även kända som bokmärken, det här kan aktiveras genom att ange --outline-omkopplaren. Skisserna genereras baserat på lthgt-taggarna, för en djupgående beskrivning av hur det här görs, se avsnittet "Kontraktskvot". Skissens träd kan ibland vara väldigt djupt om lthgt-taggarna spreds till generösa i HTML-dokumentet. Utgående djupomkopplare kan användas för att binda detta. Sidbrytning Den aktuella sidbrytningsalgoritmen för WebKit lämnar mycket att önska. I grund och botten kommer webkit att göra allt till en lång sida och klippa upp det på sidor. Det betyder att om du har två kolumner med text där man flyttas vertikalt med en halv linje. Då kommer webkit att skära en linje i stycken, visa den övre halvan på en sida. Och den nedersta halvan på en annan sida. Det kommer också att bryta bilden i två och så vidare. Om du använder den patched versionen av QT kan du använda CSS-sidan-bryta-in-egenskapen för att åtgärda detta något. Det finns ingen enkel lösning på det här problemet, tills det löser sig, försök organisera dina HTML-dokument så att det innehåller många rader på vilka sidor som kan skäras rent. Sidstorlekar Den ursprungliga sidstorleken på det gjorda dokumentet är A4, men med hjälp av denna sidformat kan det ändras till nästan allt annat, till exempel: A3, Letter and Legal. För en fullständig lista över stödda sidstorlekar, se doc. trolltech4.6qprinter. htmlPageSize-enum. För en mer fin kornad kontroll över sidstorleken kan sidhöjd och sidbreddsalternativ användas. Läsning av argument från stdin Om du behöver konvertera många sidor i en sats och du känner att wkhtmltopdf är en lite för att sakta för att starta, då ska du försöka - läs-args-från-stdin, När --read-args-from-stdin varje rad av inmatning som skickas till wkhtmltopdf på stdin kommer att fungera som en separat invigning av wkhtmltopdf, med de argument som anges på den angivna raden i kombination med argumenten som ges till wkhtmltopdf Till exempel kan man göra följande: Statisk version På wkhtmltopdf-webbplatsen kan du hämta en statisk version av wkhtmltopdf code. googlepwkhtmltopdfdownloadslist. Denna statiska binära kommer att fungera på de flesta system och kommer med en inbyggd plåst QT. Tyvärr är det statiska binäret inte särskilt statiskt. På Linux beror det på både glibc och openssl, dessutom behöver du ha en xserver installerad men inte nödvändig att köra. Du måste ha olika skrifter installerade inklusive xfonts-skalbar (Type1) och msttcorefonts. Se code. googlepwkhtmltopdfwikistatic för problem att skrika. Sammanställning Det kan hända att det statiska binäret inte fungerar för ditt system av någon anledning eller det andra, i så fall kanske du behöver kompilera wkhtmltopdf själv. Innan du sammanställer måste du installera beroenden: X11, Gcc, Git och OpenSl. På DebianUbuntu kan detta göras enligt följande: På andra system måste du använda din egen pakethanterare, paketen kan namngöras annorlunda. Först måste du kolla in den modifierade versionen av QT. Nästa måste du konfigurera, kompilera och installera QT. Observera att det tar ganska lång tid beroende på vilka argument du använder för att konfigurera qt. Allt som behövs nu är att kompilera wkhtmltopdf. Du visar nu att en binär heter wkhtmltopdf i den aktuella mappen som du kan använda. Du kan eventuellt installera den genom att köra Andra operativa system och avancerade funktioner Om du vill ha mer information eller vill kompilera under andra operativa system andra än GNULinux, vänligen seecode. googlepwkhtmltopdfwikicompilation . Installation Det finns flera sätt att installera wkhtmltopdf. Du kan ladda ner en redan sammanställd binär, eller du kan kompilera wkhtmltopdf själv. På Windows är det enklaste sättet att installera wkhtmltopdf att ladda ner det senaste installationsprogrammet. På linux kan du ladda ner det senaste statiska binäret, men du behöver fortfarande installera några andra program, för att läsa mer om detta, läs den statiska versionen av handboken. I det här avsnittet presenteras ett antal exempel på hur man använder wkhtmltopdf. Så här konverterar du en HTML-fil till PDF: Så här konverterar du en lokal HTML-fil till PDF: Du kan också konvertera till PS-filer om du vill: Producera eler2.pdf-provfilen: Det här arkivet innehåller de statiska kompilerade binärerna från wkhtmltopdf-projektet. Mer om funktionaliteten för wkhtmltopdf och wkthmltoimage finns där. Binarier för Microsoft Windows. även installerbar med kompositör, finns här: githubwemersonjanuariowkhtmltopdf-windows Hint. Den binära versionen är lika med git-taggen. För att installera den senaste versionen, använd 0.12.3. Detta paket finns på Packagist och installerat med Kompositör. Kräver paketet för i386 med: Och för amd64 med: Binären kommer då att ligga på: Dessutom skapas en symlink i din konfigurerade bin-mapp, till exempel:
No comments:
Post a Comment