Scroll to navigation

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

NAME

ebook-convert - ebook-convert

ebook-convert lähdetiedosto kohdetiedosto [vaihtoehdot]


Muunna ekirja formaatista toiseen.

Lähdetiedosto on alkupiste ja kohdetiedosto on tulos. Molemmat on ilmoitettava komennon alkuarvoina.

Ekirjan formaatti päätellään kohdetiedoston nimen tiedostopäätteestä. Kohdetiedoston voi määritellä myös arvolla .PÄÄTE, jolloin PÄÄTE on haluttu kohdetiedoston tiedostoformaattipääte, ja tiedoston nimi muodostetaan lähdetiedostosta. Huomaa, että tiedostojen nimet eivät saa alkaa väliviivalla. Jos kohdetiedostolle ei ilmoiteta formaattia, se tulkitaan kansioksi, ja tulos on "avoin ekirja" (OEB) joka koostuu HTML-tiedostoista tuossa kansiossa. Nämä tiedostot vietäisiin normaalisti edelleen kohdetiedostoformaattiin.

Lähde- ja kohdetiedostojen jälkeen voit asettaa komentoon vaihtoehtoja toiminnon mukauttamiseksi. Vaihtoehdot riippuvat tiedostoformaateista. Saat tietoja niistä asettamalla lähde- ja kohdetiedostojen jälkeen valinta -h.

Täysi dokumentaatio toiminnolle conversion

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
  • ILME
  • 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, generic_eink, generic_eink_hd, generic_eink_large, 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_900, pocketbook_pro_912, galaxy, sony, sony300, sony900, sony-landscape, sonyt3, tablet

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ä.

Pura luodun EPUB-tiedoston sisältö osoitettuun kansioon. Kansion sisältö tyhjennetään ensin kokonaan, käytä varoen.

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.

ILME

Asetukset, joilla kontrolloidaan ulostulon ulkoasua

Translitteroi unicode-merkistö ASCII-merkeiksi. Käytä varoen - esimerkiksi "Михаил Горбачёв":n korvaa "Mikhail Gorbachiov". Jos merkistä on useampia versioita (esimerkiksi kiinan ja japanin versiot), valitaan nykyisen calibre-käyttöliittymän kielivalinta.

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.

Muunna tavalliset lainausmerkit, väliviivat ja perättäiset pisteet typografisesti oikeiksi välimerkeiksi. Katso lisätietoja: 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, "Ilme -> Muunnostyylit"-osassa muunnosikkunaa. Kun olet määritellyt säännöt, voit tallentaa ne tiedostoon "Vie"-painikkeella.

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

Tallenna käännöksen eri vaiheiden tulos määriteltyyn kansioon. Käytännöllinen jos olet epävarma missä vaiheessa käännöstä virhe tapahtuu.

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

marraskuuta 29, 2019 4.5.0