Scroll to navigation

EBOOK-CONVERT(1) calibre EBOOK-CONVERT(1)

NAME

ebook-convert - ebook-convert

ebook-convert input_file output_file [options]


Convert an e-book from one format to another.

input_file is the input and output_file is the output. Both must be specified as the first two arguments to the command.

The output e-book format is guessed from the file extension of output_file. output_file can also be of the special format .EXT where EXT is the output file extension. In this case, the name of the output file is derived from the name of the input file. Note that the filenames must not start with a hyphen. Finally, if output_file has no extension, then it is treated as a folder and an "open e-book" (OEB) consisting of HTML files is written to that folder. These files are the files that would normally have been passed to the output plugin.

After specifying the input and output file you can customize the conversion by specifying various options. The available options depend on the input and output file types. To get help on them specify the input and output file and then use the -h option.

For full documentation of the conversion system see Ekirja muunnos

Whenever you pass arguments to ebook-convert that have spaces in them, enclose the arguments in quotation marks. For example: "/some path/with spaces"

Vaihtoehdot ja oletusarvot asetuksille vaihtuvat sekä lähde- että kohdeformaatin mukaan, joten tarkasta aina:

ebook-convert myfile.input_format myfile.output_format -h


Alla on kaikille formaateille yhteiset vaihtoehdot, ja niiden jälkeen kunkin formaatin käytössä olevat lähde- ja kohdevaihtoehdot.

  • INPUT-VALINNAT
  • ULOSTULO-ASETUKSET
  • ULKOASU
  • HEURISTINEN PROSESSOINTI
  • ETSI JA KORVAA
  • RAKENTEEN TUNNISTUS
  • SISÄLLYSLUETTELO
  • METATIEDOT
  • VIRHEENETSINTÄ

näytä tämä ohjeviesti ja poistu

Määritä syöttöprofiili. Syöttöprofiili antaa käännökselle järjestelmätiedot, joiden perusteella lukuisat syöttödokumentit tulkitaan. Esimerkiksi resoluution pituus (eli pituus pikseleinä). Vaihtoehdot ovat: cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad, irexdr1000, irexdr800, kindle, msreader, mobipocket, nook, sony, sony300, sony900

Luettelo sisäänrakennetuista resepteistä. Voit suorittaa muunnoksen sisäänrakennetulla reseptillä komennolla: ebook-convert "Reseptin Nimi.recipe" kohdenimi.epub

Aseta vientiprofiili. Vientiprofiilissa määritetään muunnettavan dokumentin optimointi kohdelaitteelle (kuten kuvien skaalaus näytön kokoon). Joissakin tapauksissa vientiprofiililla voidaan optimoida vienti tietylle laitteelle, mutta tämä on harvoin tarpeellista. Vaihtoehdot ovat:cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad, ipad, ipad3, irexdr1000, irexdr800, jetbook5, kindle, kindle_dx, kindle_fire, kindle_oasis, kindle_pw, kindle_pw3, kindle_voyage, kobo, msreader, mobipocket, nook, nook_color, nook_hd_plus, pocketbook_inkpad3, pocketbook_lux, pocketbook_hd, pocketbook_900, pocketbook_pro_912, galaxy, sony, sony300, sony900, sony-landscape, sonyt3, tablet, generic_eink, generic_eink_hd, generic_eink_large

näytä ohjelman versionumero ja poistu

INPUT-VALINNAT

Valinnat, jotka kontrolloivat input mobi tiedoston prosessointia

Määritä dokumentin merkkien koodaus. Valittuna tämä vaihtoehto kumoaa kaiken dokumentin itsensä määräämän koodauksen. Tämä on erityisen käyttökelpoinen sellaisten dokumenttien kanssa, jotka eivät määrää koodausta tai joiden koodaus on virheellinen.

ULOSTULO-ASETUKSET

Asetukset, joilla kontrolloidaan ulostulo epub prosessointia

Poista käytöstä katkaisu sivunvaihtojen kohdalla. Tavallisesti lisätyt tiedostot katkaistaan sivunvaihtojen kohdalta erillisiin tiedostoihin. Tällainen e-kirja kyetään esittämään nopeammin ja kevyemmin. Katkaiseminen on kuitenkin hidasta ja jos lähdetiedostossa on suuri määrä sivunvaihtoja, katkaisu kannattaa poistaa käytöstä.

Tämä valinta on tarpeen, jos aikot käyttää EPUB-tiedostoa FBReaderJ:ssä. Toiminto litistää EPUBin sisäisen tiedostorakenteen, siten että kaikki tiedostot ovat pääkansiossa.

Lisää inline-sisällysluettelon, joka näkyy kirjan sisällön osana.

Lisää inline-sisällysluettelon kirjan loppuun alun sijaan.

Luotavan EPUB-tiedoston versio. EUPB 2 on yleisimmin yhteensopiva versio, käytä EPUB 3:a vain jos tiedät tarvitsevasi sitä.

Extract the contents of the generated EPUB file to the specified folder. The contents of the folder are first deleted, so be careful.

Jaa kaikki HTML-tiedostot jotka ovat tätä kokoa (KB) suurempia. Tämä on tarpeen, koska useimmat EPUB-lukijat eivät pysty käsittelemään suuria tiedostoja. Oletuskoko on %dKB, joka vaaditaan Adobe Digital Editionsiin. Aseta 0 KB estääksesi jakaminen kokonaan.

Tavallisesti, jos lähdetiedostossa ei ole kansikuvaa ja et osoita sellaista, luodaan peruskansikuva otsikosta, tekijöistä jne. Tämä valinta poistaa toiminnon.

Älä käytä kannessa SVG-kuvia. Käytä tätä asetusta jos EPUB-kirjaasi käytetään laitteessa joka ei tue SVG:itä, kuten iPhonessa tai Jetbook Litessa. Jos tätä ei ole asetettu, nämä laitteet näyttävät kannen tyhjänä sivuna.

Kun käytät SVG-kuvaa kantena, tämä valinta asettaa kannen peittämään koko näyttöalan, mutta säilyttää silti kuvasuhteen (leveyden ja korkeuden suhde). Kuvaan voi tällöin jäädä valkoiset reunukset, mutta kuva ei vääristy. Jos valintaa ei ole kytketty, kuva voi vääristyä hiemen, mutta reunuksia ei jää.

Mikäli määritelty, lisäosa yrittää luoda tuloksen, joka on mahdollisimman luettava. Ei vaikuta välttämättä muiden tulokseen vaikuttavien lisäosien toimintaan.

Luotavan inline-sisällysluettelon otsikko.

ULKOASU

Asetukset, joilla kontrolloidaan ulostulon ulkoasua

Transliterate Unicode characters to an ASCII representation. Use with care because this will replace Unicode characters with ASCII. For instance it will replace "Pelé" with "Pele". Also, note that in cases where there are multiple representations of a character (characters shared by Chinese and Japanese for instance) the representation based on the current calibre interface language will be used.

Normaali tekstin koko pisteinä (pt). Kaikki teksti tuotetaan tätä kokoa skaalaamalla. Suurempi koko suurentaa kaikkia tekstejä, ja toisinpäin. Oletuksena, jos arvona on 0, käytetään vientiprofiilissa asetettua arvoa.

Vaihda tekstin tasaus. Arvo "left" muuntaa kaiken tekstin vasemmalle tasatuksi. Arvo "justify" muuntaa kaiken tekstin tasapalstaksi. Arvo "original" (oletus) säilyttää alkuperäisen tasauksen lähdetiedostosta. Huomaa, että vain jotkin kohdeformaatit tukevat tasapalstaa.

Kytke tekstikoon skaalaus pois päältä.

Upota kaikki dokumentissa viitatut fontit jos ne eivät ole jo upotettuina. Fontteja etsitään järjestelmästäsi, ja läydetyt fontit upotetaan. Upottaminen toimii vain sitä tukevissa formaateissa, kuten EPUB, AZW3, DOCX ja PDF. Varmistathan, että sinulla on lisenssi fontin upottamiseen.

Upota valittu fonttitiedosto kirjaan. Tästä tulee kirjan "perusfontti". Jos lähdetiedostossa on omat fonttinsa, ne voivat ohittaa tämän fontin. Voit käyttää tyyliasetusten suodatusta lähdetiedoston fonttien poistamiseen. Huomaa, että fontin upottaminen toimii vain joissakin formaateissa, kuten EPUB, AZW3 ja DOCX.

Oletuksena calibre käyttää CSS-määritysten lyhennettyjä muotoja, mm. margin, padding, border jne. Valinta kytkee käyttöön täydet, laajennetut muodot. Nook ei pysty käsittelemään lyhennettyjä muotoja, ja Nookin muunnosprofiilit käyttävät aina laajennettua muotoa EPUB-tiedostoissa.

Polku CSS-stylesheetiin tai suoraan CSS:ää. Tämä CSS lisätään lähdetiedoston tyylisääntöihin, jotta se voi ohittaa noita sääntöjä.

Pilkuin erotettu lista CSS-määreitä, jotka poistetaan kaikista CSS-säännöistä. Hyödyllistä, jos jonkin tyylimäärityksen ohittaminen ei muuten onnistu. Esimerkiksi: font-family,color,margin-left,margin-right

CSS-tekstikokojen vastavuus tekstikokoihin pisteinä (pt). Esimerkkiarvo on 12,12,14,16,18,20,22,24, joka vastaa kokoja xx-small->xx-large. Tekstinskaalausalgoritmi käyttää näitä kokoja tekstikoon älykkääseen skaalaukseen. Oletuksena käytetään vastaavuutta, joka perustuu valitsemaasi vientiprofiiliin.

Lisää tyhjä rivi kappaleiden väliin. Ei toimi, jos lähdetiedosto ei käytä kappaleita (<p> tai <div> -tageja).

Aseta tyhjien lisättyjen rivien korkeus (em). Rivien korkeus on kaksi kertaa tämä arvo.

Säilytä ligatuurit lähdetiedostosta. Ligatuuri on erityinen kahden merkin typografinen yhdistelmä, kuten ff, fi, fl jne. Useimmat elukijat eivät tue ligatuureja, joten ne eivät yleensä näy oikein. Oletuksen calibre muuntaa ligatuurin vastaaviksi vakiomerkeiksi. Tämä valinta säilyttää ligatuurit.

Rivinkorkeus pisteinä (pt). Tekstirivien välistys. Koskee vain elementtejä, jotka eivät määrittele omaa rivinkorkeuttaan. Useimmiten minimirivinkorkeus on hyödyllisempi asetus. Oletuksena ei suoriteta mitään rivinkorkeuden muokkausta.

Jotkin huonosti suunnitellut dokumentit käyttävät taulukoita tekstin asetteluun sivulle. Muunnoksessa niiden rivit usein venyvät sivun ulkopuolelle yms. Tämä valinta purkaa sisällön taulukoista ja esittää sen rivitetyssä muodossa.

Aseta alamarginaali pisteinä (pt). Oletus on 5.0. Nollaa pienempi luku estää marginaalin asettamisen (jolloin säilytetään alkuperäisen dokumentin marginaali). Huom: Sivupohjaisilla formaateilla kuten DOCX ja PDF on omat marginaalisetuksensa, jotka ohittavat tämän.

Aseta vasen marginaali pisteinä (pt). Oletus on 5.0. Nollaa pienempi luku estää marginaalin asettamisen (jolloin säilytetään alkuperäisen dokumentin marginaali). Huom: Sivupohjaisilla formaateilla kuten DOCX ja PDF on omat marginaalisetuksensa, jotka ohittavat tämän.

Aseta oikea marginaali pisteinä (pt). Oletus on 5.0. Nollaa pienempi luku estää marginaalin asettamisen (jolloin säilytetään alkuperäisen dokumentin marginaali). Huom: Sivupohjaisilla formaateilla kuten DOCX ja PDF on omat marginaalisetuksensa, jotka ohittavat tämän.

Aseta ylämarginaali pisteinä (pt). Oletus on 5.0. Nollaa pienempi luku estää marginaalin asettamisen (jolloin säilytetään alkuperäisen dokumentin marginaali). Huom: Sivupohjaisilla formaateilla kuten DOCX ja PDF on omat marginaalisetuksensa, jotka ohittavat tämän.

Rivinkorkeuden minimi, prosenttiarvona lasketusta tekstielementin korkeudesta. calibre tarkastaa, että kaikilla elementeillä on vähintään tämä rivinkorkeus, riippumatta lähdetiedoston asetuksista. Aseta 0 poistaaksesi käytöstä. Oletus on 120%. Käytä tätä asetusta suoran rivikorkeuden sijaan, ellet ole varma että haluat tehdä toisin. Esimerkiksi "tuplarivin" saat asettamalla arvoksi 240.

Poista kappaleiden väliset tyhjät rivit. Asettaa myös 1.5 em sisennyksen kappaleisiin. Välistyksen poistaminen ei toimi, jos lähdetiedosto ei käytä kappaleita (<p> tai <div> tägi).

Kun calibre poistaa tyhjiä rivejä kappaleiden välistä, se asettaa myös kappalesisennyksen, jotta kappaleet ovat erotettavissa. Arvo asettaa sisennyksen leveyden (em). Jos asetat negatiivisen arvon, säilytetään lähdetiedoston kappalesisennys.

Convert plain quotes, dashes and ellipsis to their typographically correct equivalents. For details, see https://daringfireball.net/projects/smartypants.

Osita kaikki upotetut fontit. Kaikki fontit rajataan vain dokumentissa käytettyihin merkkeihin. Tämä pienentää fonttitiedostojen kokoa. Etenkin erittäin suuria fonttitiedostoja käyttäessä tämä on hyvin hyödyllistä.

Polku tiedostoon jossa on sääntöjä käytettäväksi kirjan CSS-tyylien muunnoksessa. Helpoin tapa tällaisen tiedoston luomiseen on käyttää graafisen käyttöliittymän aputoimintoa sääntöjen luomiseen, "Ulkoasu -> Muunnostyylit"-osassa muunnosikkunaa. Kun olet määritellyt säännöt, voit tallentaa ne tiedostoon "Vie"-painikkeella.

Path to a file containing rules to transform the HTML in this book. The easiest way to create such a file is to use the wizard for creating rules in the calibre GUI. Access it in the "Look & feel->Transform HTML" section of the conversion dialog. Once you create the rules, you can use the "Export" button to save them to a file.

Muunna typografisesti tarkat lainausmerkit, väliviivat ja perättäiset pisteet niiden tavanomaisiksi vastineiksi.

HEURISTINEN PROSESSOINTI

Muokkaa dokumentin tekstiä ja rakennetta yleisillä sääntömalleilla. Oletuksen poissa käytöstä. Käytä --enable-heuristics ottaaksesi käyttöön. Yksittäisiä toimintoja voi sammuttaa --disable-

*

-valinnoilla.

Analysoi dokumentin tavutetut sanat. Dokumentin omaa sisältöä käytetään tunnistamaan tulisiko väliviiva poistaa vai säilyttää.

Poista tyhjät kappaleet kappaleiden välistä.

Muunna perättäisistä sitovista välilyönneistä tehdyt sisennykset CSS-sisennyksiksi.

Vasempaan tasatut kohtausten vaihdokset keskitetään. Korvaa useilla tyhjillä riveillä tehdyn kohtausten vaihdoksen vaakaviivalla.

Etsi yleisiä sanoja sekä rakenteita joilla merkitään kursivointeja ja kursivoi nämä kohdat.

Tunnista muotoilemattomat lukujen otsikot ja alaotsikot. Muuntaa ne h2 ja h3 tägeiksi. Tästä ei vielä muodostu sisällysluetteloa, mutta toimintoa voidaan hyödyntää rakenteen luomisessa sisällyluettelon generoimisen yhteydessä.

Etsii perättäisiä <h1> tai <h2> tägejä. Tägit numeroidaan uusiksi, jotta lukujen otsikot eivät katkea kesken.

Poista turhat rivinvaihdot päättelemällä kappaleet välimerkeistä ja muista muista muotoiluista.

Ota heuristinen prosessointi käyttöön. Valinta vaaditaan, jotta heuristista prosessointia suoritetaan.

Pituuden suhdeluku, jolla arvioida mistä riveistä tulisi poistaa rivitys. Käyvät arvot ovat desimaalilukuja välillä 0-1. Oletus on 0.4, hiukan rivipituuksien mediaanin alapuolella. Jos vain harvoista dokumentin riveistä tarvitsee poistaa rivitys, tarvitaan pienempi suhdeluku.

Korvaa kohtausten vaihdokset asetetulla tekstillä. Oletuksena käytetään lähdetiedoston tekstiä.

ETSI JA KORVAA

Muokkaka dokumentin tekstiä ja rakennetta käyttäjän asettamilla säännöillä.

Polku tiedostoon jossa on etsi ja korvaa -regular expressionit. Tiedoston tulee muodostua perättäisistä riveistä, hakulauseke ja korvauslauseke (joka voi olla myös tyhjä rivi). Lausekkeen tulee noudattaa Python regex -syntaksia ja tiedoston tulee käyttää UTF-8-merkistöä.

Korvaava teksti sr1-searchilla löydetylle tekstille.

Hakulauseke (regular expression) joka korvataan sr1-replacella.

Korvaava teksti sr2-searchilla löydetylle tekstille.

Hakulauseke (regular expression) joka korvataan sr2-replacella.

Korvaava teksti sr3-searchilla löydetylle tekstille.

Hakulauseke (regular expression) joka korvataan sr3-replacella.

RAKENTEEN TUNNISTUS

Kontrolloi asiakirjan rakenteen automaattista tunnistusta.

XPath-lauseke lukujen otsikoiden poimimiseksi. Oletuksena huomioidaan <h1> tai <h2> tägit joissa on sanat "chapter", "book", "section", "prologue", "epilogue" tai "part" lukujen otsikoiksi, kuten myös tägit joiden class="chapter". Lauseke tulee kääntyä listaksi elementtejä. Poista otsikoiden tunnistaminen käytöstä arvolla "/". Katso calibren käyttöohjeesta XPathin käyttöopastus.

--chapter-mark
Aseta lukujen merkintätapa. Arvo "pagebreak" lisää sivunvaihdot ennen lukuja. Arvo "rule" lisää vaakaviivan ennen lukuja. Arvo "none" estää lukujen merkitsemisen ja arvo "both" lisää sekä sivunvaihdon että vaakaviivan.

Joissakin dokumenteissa oikea ja vasen marginaali on ilmoitettu jokaiselle kappaleelle erikseen. calibre pyrkii etsimään ja poistamaan tällaiset marginaalit. Joskus kuitenkin poistuu vääriä marginaaliasetuksia Voit estää poiston tällä valinnalla.

Lisää metatiedot kirjan alkuun. Hyödyllistä, jos lukulaitteesi ei tue metatietojen normaalia esittämistä/hakua.

XPath-lauseke. Lisää sivunvaihdot ennen tiettyjä elementtejä. Poista käytöstä lausekkeella: /

Käytä lähdetiedostosta havaittua kansikuvaa erikseen määritellyn kansikuvan sijaan.

Poista ekirjan ensimmäinen kuva. Hyödyllistä, jos lähdetiedostossa on kansikuva, jota ei tunnisteta kanneksi. Jos asetat oman kansikuvan sen sijaan, tämä valinta estää kahden kannen muodostumisen kirjaan.

XPath-lauseke lukemisen aloituskohdan löytämiseen dokumentista. Jotkin lukuohjelmat (etenkin Kindle) käyttävät tätä kohtaa kirjan avaamiseen. Katso lisäominaisuuksia XPath-opastuksesta calibre-käyttöohjeesta.

SISÄLLYSLUETTELO

Kontrolloi Sisällysluettelon automaattista luomista. Oletuksena, jos lähdetiedostolla on Sisällysluettelo, sitä käytetään automaattisesti luodun sijaan.

Salli sisällysluettelossa toistuvat rivit, eli samansisältöiset rivit, kunhan ne osoittavat eri kohtiin dokumentissa.

XPath-lauseke joka määrittää kaikki tägit joiden tulee esiintyä sisällysluettelon tasolla 1. Asetus tässä ohittaa kaikki muut automaattisesti tunnistetut otsikot. Katso calibren käyttöohjeesta XPathin käyttöopastus.

XPath-lauseke joka määrittää kaikki tägit joiden tulee esiintyä sisällysluettelon tasolla 2. Tasot sijoittuvat vastaavan ylemmän tason alle. Katso calibren käyttöohjeesta XPathin käyttöopastus.

XPath-lauseke joka määrittää kaikki tägit joiden tulee esiintyä sisällysluettelon tasolla 3. Tasot sijoittuvat vastaavan ylemmän tason alle. Katso calibren käyttöohjeesta XPathin käyttöopastus.

Maksimimäärä linkkejä sisällysluettelossa. 0 poistaa rajan käytöstä. Oletus: 50. Linkit lisätään sisällysluetteloon vain jos lukuja on tätä arvoa vähemmän.

Älä lisää automaattisesti havaittuja lukuja sisällysluetteloon.

Poista sisällysluettelosta rivit, joiden sisältö vastaa asetettua regexp-lauseketta. Nämä rivit sekä niiden alarivit karsitaan luettelosta.

Jos lukuja löydetään vähemmän kuin tämä lukumäärä, sisällysluetteloon asetetaan linkit. Oletus: 6

Yleensä, jos tiedostossa on jo sisällysluettelo, sitä käytetään automaattisesti luodun sijaan. Valinta asettaa aina käyttöön automaattisesti luodun sisällysluettelon.

METATIEDOT

Asetukset ulostulon metatiedoille

Teksti jota käytetään tekijän mukaan järjestämiseen.

Aseta tekijät. Useammat tekijät erotetaan puolipisteillä.

Aseta kirjan tuottaja.

Aseta kirjan kuvaus.

Aseta kansi osoitetusta tiedostosta tai URL:stä.

Anna kirjan ISBN

Anna kieli

Aseta julkaisupäivämäärä (oletetaan käyttävän paikallista aikavyöhykettä, ellei aikavyöhykettä ilmoiteta erikseen)

Aseta kirjan julkaisija.

Aseta arvosana. Luku 1-5

Lue metatiedot osoitetusta OPF-tiedostosta. Luetut metatiedot ohittavat lähdetiedostosta löytyvät tiedot.

Aseta sarja johon kirja kuuluu.

--series-index
Aseta kirjan järjestysnumero sarjassa.

Aseta kirjan tägit. Muotona pilkuin erotettu lista.

Aseta kirja aikaleima (ei enää käytössä missään)

Anna otsikko

--title-sort
Nimen muoto jota käytetään järjestämiseen.

VIRHEENETSINTÄ

Asetukset, joilla muunnoksen vianmääritystä helpotetaan

Save the output from different stages of the conversion pipeline to the specified folder. Useful if you are unsure at which stage of the conversion process a bug is occurring.

Kuvausten tarkkuustaso. Useampi määrittely tuottaa yksityiskohtaisemmat kuvaukset. Kaksinkertainen asetus tuottaa täyden tarkkuustason, yksi kerta keskimääräisen ja nolla kertaa vähäisimman tarkkuustason.

AUTHOR

Kovid Goyal

COPYRIGHT

Kovid Goyal

elokuuta 12, 2022 6.3.0