.\" Man page generated from reStructuredText. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "EBOOK-CONVERT" "1" "toukokuuta 03, 2024" "7.10.0" "calibre" .SH NAME ebook-convert \- ebook-convert .INDENT 0.0 .INDENT 3.5 .sp .EX ebook\-convert input_file output_file [options] .EE .UNINDENT .UNINDENT .sp Muunna e\-kirja muodosta toiseen. .sp input_file on tulo ja output_file on lähtö. Molemmat on määritettävä komennon kahdeksi ensimmäiseksi argumentiksi. .sp Tulostetun e\-kirjan muoto arvataan output_file tiedostopäätteestä. output_file voi olla myös erikoismuodossa . EXT, jossa EXT on tulostetiedoston tunniste. Tässä tapauksessa tulostetiedostonimi johdetaan syöttötiedoston nimestä. Huomaa, että tiedostonimet eivät saa alkaa yhdysmerkillä. Lopuksi, jos output_file tiedostolla ei ole päätettä, sitä käsitellään kansiona ja HTML\-tiedostoista koostuva \(dqavoin e\-kirja\(dq (OEB) kirjoitetaan kyseiseen kansioon. Nämä tiedostot ovat tiedostoja, jotka normaalisti olisi välitetty lähtölaajennukseen. .sp Kun olet määrittänyt syöttö\- ja tulostetiedoston, voit mukauttaa muunnosta määrittämällä erilaisia vaihtoehtoja. Käytettävissä olevat vaihtoehdot riippuvat syöttö\- ja tulostetiedostotyypeistä. Saat apua niihin määrittämällä syöttö\- ja tulostetiedoston ja käyttämällä sitten \-h\-vaihtoehtoa. .sp Muuntojärjestelmän täydellinen dokumentaatio: \X'tty: link #conversion'\fI\%E\-kirjan muuntaminen\fP\X'tty: link' .sp Aina kun annat \fBebook\-convert\fP:lle argumentteja, joissa on välilyöntejä, sulje argumentit lainausmerkkeihin. Esimerkiksi: \(dq/some path/with spaces\(dq .sp Vaihtoehdot ja oletusarvot asetuksille vaihtuvat sekä lähde\- että kohdeformaatin mukaan, joten tarkasta aina: .INDENT 0.0 .INDENT 3.5 ebook\-convert myfile.input_format myfile.output_format \-h .UNINDENT .UNINDENT .sp Alla on kaikille formaateille yhteiset vaihtoehdot, ja niiden jälkeen kunkin formaatin käytössä olevat lähde\- ja kohdevaihtoehdot. .INDENT 0.0 .IP \(bu 2 \fI\%INPUT\-VALINNAT\fP .IP \(bu 2 \fI\%ULOSTULO\-ASETUKSET\fP .IP \(bu 2 \fI\%ULKOASU\fP .IP \(bu 2 \fI\%HEURISTINEN PROSESSOINTI\fP .IP \(bu 2 \fI\%ETSI JA KORVAA\fP .IP \(bu 2 \fI\%RAKENTEEN TUNNISTUS\fP .IP \(bu 2 \fI\%SISÄLLYSLUETTELO\fP .IP \(bu 2 \fI\%METATIEDOT\fP .IP \(bu 2 \fI\%VIRHEENETSINTÄ\fP .UNINDENT .INDENT 0.0 .TP .B \-\-help, \-h näytä tämä ohjeviesti ja poistu .UNINDENT .INDENT 0.0 .TP .B \-\-input\-profile 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 .UNINDENT .INDENT 0.0 .TP .B \-\-list\-recipes Luettelo sisäänrakennetuista resepteistä. Voit suorittaa muunnoksen sisäänrakennetulla reseptillä komennolla: ebook\-convert \fB\(dq\fPReseptin Nimi.recipe\fB\(dq\fP kohdenimi.epub .UNINDENT .INDENT 0.0 .TP .B \-\-output\-profile Määritä lähtöprofiili. Tulostusprofiili kertoo muunnosjärjestelmälle, miten luotu asiakirja optimoidaan määritettyä laitetta varten. Joissakin tapauksissa lähtöprofiilia voidaan käyttää optimoimaan lähtö tietylle laitteelle, mutta tämä on harvoin tarpeen. Vaihtoehtoja ovat mm.:cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad, ipad, ipad3, irexdr1000, irexdr800, jetbook5, kindle, kindle_dx, kindle_fire, kindle_oasis, kindle_pw, kindle_pw3, kindle_scribe, 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 .UNINDENT .INDENT 0.0 .TP .B \-\-version näytä ohjelman versionumero ja poistu .UNINDENT .SH INPUT-VALINNAT .sp Valinnat, jotka kontrolloivat input mobi tiedoston prosessointia .INDENT 0.0 .TP .B \-\-input\-encoding 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. .UNINDENT .SH ULOSTULO-ASETUKSET .sp Asetukset, joilla kontrolloidaan ulostulo epub prosessointia .INDENT 0.0 .TP .B \-\-dont\-split\-on\-page\-breaks 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ä. .UNINDENT .INDENT 0.0 .TP .B \-\-epub\-flatten Tätä vaihtoehtoa tarvitaan vain, jos aiot käyttää EPUB\-tiedostoa FBReaderJ:n kanssa. Se tasaa tiedostojärjestelmän EPUB:n sisällä, jolloin kaikki tiedostot ovat ylimmällä tasolla. .UNINDENT .INDENT 0.0 .TP .B \-\-epub\-inline\-toc Lisää tekstiin sidottu sisällysluettelo, joka näkyy osana kirjan pääsisältöä. .UNINDENT .INDENT 0.0 .TP .B \-\-epub\-max\-image\-size Kuvan enimmäiskoko (leveys x korkeus). Arvo none tarkoittaa, että käytä näytön kokoa lähtöprofiilista. Arvo profile tarkoittaa, että enimmäiskokoa ei ole määritetty. Esimerkiksi arvo 100x200 aiheuttaa kaikkien kuvien koon muuttamisen siten, että niiden leveys on enintään 100 pikseliä ja korkeus enintään 200 pikseliä. Huomaa, että tämä vaikuttaa vain itse kuvatiedostojen kokoon. Mikä tahansa kuva voidaan renderöidä eri kokoisena riippuen siihen asiakirjassa käytetystä tyylistä. .UNINDENT .INDENT 0.0 .TP .B \-\-epub\-toc\-at\-end Lisää tekstiin sidottu sisällysluettelon kirjan loppuun alun sijaan. .UNINDENT .INDENT 0.0 .TP .B \-\-epub\-version Luotavan EPUB\-tiedoston versio. EUPB 2 on yleisimmin yhteensopiva versio, käytä EPUB 3:a vain jos tiedät tarvitsevasi sitä. .UNINDENT .INDENT 0.0 .TP .B \-\-extract\-to Pura luodun EPUB tiedoston sisältö määritettyyn kansioon. Kansion sisältö poistetaan ensin, joten ole varovainen. .UNINDENT .INDENT 0.0 .TP .B \-\-flow\-size 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. .UNINDENT .INDENT 0.0 .TP .B \-\-no\-default\-epub\-cover Tavallisesti, jos lähdetiedostossa ei ole kansikuvaa ja et osoita sellaista, luodaan peruskansikuva otsikosta, tekijöistä jne. Tämä valinta poistaa toiminnon. .UNINDENT .INDENT 0.0 .TP .B \-\-no\-svg\-cover Ä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. .UNINDENT .INDENT 0.0 .TP .B \-\-preserve\-cover\-aspect\-ratio 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ää. .UNINDENT .INDENT 0.0 .TP .B \-\-pretty\-print Mikäli määritelty, laajennus yrittää luoda lähdön, joka on mahdollisimman luettava. Ei vaikuta välttämättä muiden tulokseen vaikuttavien lisäosien toimintaan. .UNINDENT .INDENT 0.0 .TP .B \-\-toc\-title Luotavan tekstiin sidotun sisällysluettelon otsikko. .UNINDENT .SH ULKOASU .sp Asetukset, joilla kontrolloidaan ulostulon ulkoasua .INDENT 0.0 .TP .B \-\-asciiize Unicode\-merkkien translitterointi ASCII\-esitykseksi. Käytä varovasti, koska tämä korvaa Unicode\-merkit ASCII\-merkillä. Se korvaa esimerkiksi \fB\(dq\fPPelé\fB\(dq\fP merkillä \fB\(dq\fPPele\fB\(dq\fP\&. Huomaa myös, että tapauksissa, joissa merkistä on useita esitystapoja (esimerkiksi kiinan ja japanin yhteiset merkit), käytetään nykyisen calibre\-käyttöliittymän kielen mukaista esitystä. .UNINDENT .INDENT 0.0 .TP .B \-\-base\-font\-size 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. .UNINDENT .INDENT 0.0 .TP .B \-\-change\-justification Muuta tekstin kohdistusta. Arvo \fB\(dq\fPvasen\fB\(dq\fP muuttaa kaiken lähteen tekstin vasemmalle tasatuksi (eli tasaamattomaksi) tekstiksi. Arvo \fB\(dq\fPtasaa\fB\(dq\fP muuttaa kaiken tasoittamattoman tekstin tasoitetuksi. Arvo \fB\(dq\fPalkuperäinen\fB\(dq\fP (oletusarvo) ei muuta lähdetiedoston tekstin tasausta. Huomaa, että vain jotkin lähtöformaatit tukevat tasausta. .UNINDENT .INDENT 0.0 .TP .B \-\-disable\-font\-rescaling Poista kaikki fonttikokojen skaalaukset käytöstä. .UNINDENT .INDENT 0.0 .TP .B \-\-embed\-all\-fonts 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. .UNINDENT .INDENT 0.0 .TP .B \-\-embed\-font\-family Upota valittu fonttitiedosto kirjaan. Tästä tulee kirjan \fB\(dq\fPperusfontti\fB\(dq\fP\&. 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. .UNINDENT .INDENT 0.0 .TP .B \-\-expand\-css Oletuksena calibre käyttää CSS\-määritysten lyhennettyjä muotoja, mm. marginaali, täyte, reunus 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. .UNINDENT .INDENT 0.0 .TP .B \-\-extra\-css Joko CSS\-tyylisivun polku tai raaka CSS. Tämä CSS liitetään lähdetiedoston tyylisääntöihin, joten sitä voidaan käyttää näiden sääntöjen ohittamiseen. .UNINDENT .INDENT 0.0 .TP .B \-\-filter\-css 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 .UNINDENT .INDENT 0.0 .TP .B \-\-font\-size\-mapping CSS\-fonttien nimien yhdistäminen fonttikokoihin pisteinä. Esimerkkiasetus on 12,12,14,16,18,20,22,24. Nämä ovat yhdistelmät kokoja xx\-pieni\- xx\-suuri varten, ja viimeinen koko on valtaville fonteille. Fonttien skaalausalgoritmi käyttää näitä kokoja fonttien älykkääseen skaalaukseen. Oletusarvoisesti käytetään valitsemaasi lähtöprofiiliin perustuvaa kartoitusta. .UNINDENT .INDENT 0.0 .TP .B \-\-insert\-blank\-line Lisää tyhjä rivi kappaleiden väliin. Ei toimi, jos lähdetiedosto ei käytä kappaleita (

tai

\-tageja). .UNINDENT .INDENT 0.0 .TP .B \-\-insert\-blank\-line\-size Aseta tyhjien lisättyjen rivien korkeus (em). Rivien korkeus on kaksi kertaa tämä arvo. .UNINDENT .INDENT 0.0 .TP .B \-\-keep\-ligatures Säilytä ligatuurit lähdetiedostosta. Ligatuuri on erityinen kahden merkin typografinen yhdistelmä, kuten ff, fi, fl jne. Useimmat e\-lukijat eivät tue ligatuureja, joten ne eivät yleensä näy oikein. Oletuksena calibre muuntaa ligatuurin vastaaviksi vakiomerkeiksi. Tämä valinta säilyttää ligatuurit. .UNINDENT .INDENT 0.0 .TP .B \-\-line\-height 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. .UNINDENT .INDENT 0.0 .TP .B \-\-linearize\-tables 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. .UNINDENT .INDENT 0.0 .TP .B \-\-margin\-bottom 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. .UNINDENT .INDENT 0.0 .TP .B \-\-margin\-left 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. .UNINDENT .INDENT 0.0 .TP .B \-\-margin\-right 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. .UNINDENT .INDENT 0.0 .TP .B \-\-margin\-top 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. .UNINDENT .INDENT 0.0 .TP .B \-\-minimum\-line\-height 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 \fB\(dq\fPtuplarivin\fB\(dq\fP saat asettamalla arvoksi 240. .UNINDENT .INDENT 0.0 .TP .B \-\-remove\-paragraph\-spacing 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 (

tai

tägi). .UNINDENT .INDENT 0.0 .TP .B \-\-remove\-paragraph\-spacing\-indent\-size 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. .UNINDENT .INDENT 0.0 .TP .B \-\-smarten\-punctuation Muunna tavalliset lainausmerkit, viivat ja ellipsit niiden typografisesti oikeiksi vastineiksi. Lisätietoja osoitteessa \X'tty: link https://daringfireball.net/projects/smartypants'\fI\%https://daringfireball.net/projects/smartypants\fP\X'tty: link'\&. .UNINDENT .INDENT 0.0 .TP .B \-\-subset\-embedded\-fonts Tiivistä kaikki upotetut fontit. Jokainen upotettu fontti pienennetään siten, että se sisältää vain tässä asiakirjassa käytetyt merkit. Tämä pienentää fonttitiedostojen kokoa. Hyödyllinen, jos upotat erityisen suuren fontin, jossa on paljon käyttämättömiä merkkejä. .UNINDENT .INDENT 0.0 .TP .B \-\-transform\-css\-rules 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, \fB\(dq\fPUlkoasu \-> Muunnostyylit\fB\(dq\fP\-osassa muunnosikkunaa. Kun olet määritellyt säännöt, voit tallentaa ne tiedostoon \fB\(dq\fPVie\fB\(dq\fP\-painikkeella. .UNINDENT .INDENT 0.0 .TP .B \-\-transform\-html\-rules Polku tiedostoon, joka sisältää säännöt tämän kirjan HTML:n muuttamiseksi. Helpoin tapa luoda tällainen tiedosto on käyttää ohjattua sääntöjen luomista calibre GUI:ssä. Siirry siihen muuntamisvalintaikkunan \fB\(dq\fPKäyttötuntuma\->Muunna HTML\fB\(dq\fP \-osiossa. Kun olet luonut säännöt, voit käyttää \fB\(dq\fPVie\fB\(dq\fP\-painiketta tallentaaksesi ne tiedostoon. .UNINDENT .INDENT 0.0 .TP .B \-\-unsmarten\-punctuation Muunna typografisesti tarkat lainausmerkit, väliviivat ja perättäiset pisteet niiden tavanomaisiksi vastineiksi. .UNINDENT .SH HEURISTINEN PROSESSOINTI .sp 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\- .nf * .fi \-valinnoilla. .INDENT 0.0 .TP .B \-\-disable\-dehyphenate Analysoi dokumentin tavutetut sanat. Dokumentin omaa sisältöä käytetään tunnistamaan tulisiko väliviiva poistaa vai säilyttää. .UNINDENT .INDENT 0.0 .TP .B \-\-disable\-delete\-blank\-paragraphs Poista tyhjät kappaleet kappaleiden välistä .UNINDENT .INDENT 0.0 .TP .B \-\-disable\-fix\-indents Muunna perättäisistä sitovista välilyönneistä tehdyt sisennykset CSS\-sisennyksiksi. .UNINDENT .INDENT 0.0 .TP .B \-\-disable\-format\-scene\-breaks Vasempaan tasatut kohtausten vaihdokset keskitetään. Korvaa useilla tyhjillä riveillä tehdyn kohtausten vaihdoksen vaakaviivalla. .UNINDENT .INDENT 0.0 .TP .B \-\-disable\-italicize\-common\-cases Etsi yleisiä sanoja sekä rakenteita joilla merkitään kursivointeja ja kursivoi nämä kohdat. .UNINDENT .INDENT 0.0 .TP .B \-\-disable\-markup\-chapter\-headings Tunnista muotoilemattomat lukujen otsikot ja alaotsikot. Muunna ne h2 ja h3 tageiksi. Tästä ei vielä muodostu sisällysluetteloa, mutta toimintoa voidaan hyödyntää rakenteen luomisessa sisällysluettelon generoimisen yhteydessä. .UNINDENT .INDENT 0.0 .TP .B \-\-disable\-renumber\-headings Etsii perättäisiä

tai

tageja. Tagit numeroidaan uudelleen, jotta lukujen otsikot eivät katkea kesken. .UNINDENT .INDENT 0.0 .TP .B \-\-disable\-unwrap\-lines Poista turhat rivinvaihdot päättelemällä kappaleet välimerkeistä ja muista muista muotoiluista. .UNINDENT .INDENT 0.0 .TP .B \-\-enable\-heuristics Ota heuristinen prosessointi käyttöön. Valinta vaaditaan, jotta heuristista prosessointia suoritetaan. .UNINDENT .INDENT 0.0 .TP .B \-\-html\-unwrap\-factor 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 .UNINDENT .INDENT 0.0 .TP .B \-\-replace\-scene\-breaks Korvaa kohtausten vaihdokset asetetulla tekstillä. Oletuksena käytetään lähdetiedoston tekstiä. .UNINDENT .SH ETSI JA KORVAA .sp Muokkaka dokumentin tekstiä ja rakennetta käyttäjän asettamilla säännöillä. .INDENT 0.0 .TP .B \-\-search\-replace 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öä. .UNINDENT .INDENT 0.0 .TP .B \-\-sr1\-replace Korvaava teksti sr1\-searchilla löydetylle tekstille. .UNINDENT .INDENT 0.0 .TP .B \-\-sr1\-search Hakulauseke (regular expression) joka korvataan sr1\-replacella. .UNINDENT .INDENT 0.0 .TP .B \-\-sr2\-replace Korvaava teksti sr2\-searchilla löydetylle tekstille. .UNINDENT .INDENT 0.0 .TP .B \-\-sr2\-search Hakulauseke (regular expression) joka korvataan sr2\-replacella. .UNINDENT .INDENT 0.0 .TP .B \-\-sr3\-replace Korvaava teksti sr3\-searchilla löydetylle tekstille. .UNINDENT .INDENT 0.0 .TP .B \-\-sr3\-search Hakulauseke (regular expression) joka korvataan sr3\-replacella. .UNINDENT .SH RAKENTEEN TUNNISTUS .sp Kontrolloi asiakirjan rakenteen automaattista tunnistusta. .INDENT 0.0 .TP .B \-\-chapter XPath\-lauseke kappaleotsikoiden poimimiseksi. Oletuksena huomioidaan

tai

tägit joissa on sanat \fB\(dq\fPchapter\fB\(dq\fP, \fB\(dq\fPbook\fB\(dq\fP, \fB\(dq\fPsection\fB\(dq\fP, \fB\(dq\fPprologue\fB\(dq\fP, \fB\(dq\fPepilogue\fB\(dq\fP tai \fB\(dq\fPpart\fB\(dq\fP kappaleiden otsikkoina, kuten myös tagit joiden luokka=\fB\(dq\fPkappale\fB\(dq\fP\&. Lauseke tulee kääntyä listaksi elementtejä. Poista otsikoiden tunnistaminen käytöstä arvolla \fB\(dq\fP/\fB\(dq\fP\&. Katso calibren käyttöohjeesta XPathin käyttöopastus. .UNINDENT .INDENT 0.0 .TP .B \-\-chapter\-mark Aseta lukujen merkintätapa. Arvo \fB\(dq\fPpagebreak\fB\(dq\fP lisää sivunvaihdot ennen lukuja. Arvo \fB\(dq\fPrule\fB\(dq\fP lisää vaakaviivan ennen lukuja. Arvo \fB\(dq\fPnone\fB\(dq\fP estää lukujen merkitsemisen ja arvo \fB\(dq\fPboth\fB\(dq\fP lisää sekä sivunvaihdon että vaakaviivan. .UNINDENT .INDENT 0.0 .TP .B \-\-disable\-remove\-fake\-margins 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. .UNINDENT .INDENT 0.0 .TP .B \-\-insert\-metadata Lisää metadata kirjan alkuun. Hyödyllistä, jos lukulaitteesi ei tue metadatan normaalia esittämistä/hakua. .UNINDENT .INDENT 0.0 .TP .B \-\-page\-breaks\-before XPath\-lauseke. Lisää sivunvaihdot ennen tiettyjä elementtejä. Poista käytöstä lausekkeella: / .UNINDENT .INDENT 0.0 .TP .B \-\-prefer\-metadata\-cover Käytä lähdetiedostosta löydettyä kansikuvaa määritetyn kannen sijasta. .UNINDENT .INDENT 0.0 .TP .B \-\-remove\-first\-image Poista e\-kirjan 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. .UNINDENT .INDENT 0.0 .TP .B \-\-start\-reading\-at 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. .UNINDENT .SH SISÄLLYSLUETTELO .sp Kontrolloi Sisällysluettelon automaattista luomista. Oletuksena, jos lähdetiedostolla on Sisällysluettelo, sitä käytetään automaattisesti luodun sijaan. .INDENT 0.0 .TP .B \-\-duplicate\-links\-in\-toc Salli sisällysluettelossa toistuvat rivit, eli samansisältöiset rivit, kunhan ne osoittavat eri kohtiin dokumentissa. .UNINDENT .INDENT 0.0 .TP .B \-\-level1\-toc XPath\-lauseke, joka määrittää kaikki tagit, jotka on lisättävä sisällysluetteloon tasolla yksi. Jos tämä määritetään, se on ensisijainen muihin automaattisen tunnistuksen muotoihin nähden. Katso esimerkkejä calibren käyttöoppaan XPath\-oppaasta. .UNINDENT .INDENT 0.0 .TP .B \-\-level2\-toc XPath\-lauseke, joka määrittää kaikki tagit, jotka on lisättävä sisällysluetteloon tasolla kaksi. Jokainen merkintä lisätään edellisen tason yksi merkinnän alle. Katso esimerkkejä calibren käyttöoppaan XPath\-oppaasta. .UNINDENT .INDENT 0.0 .TP .B \-\-level3\-toc XPath\-lauseke, joka määrittää kaikki tagit, jotka on lisättävä sisällysluetteloon tasolla kolme. Jokainen merkintä lisätään edellisen tason kaksi merkinnän alle. Katso esimerkkejä calibren käyttöoppaan XPath\-oppaasta. .UNINDENT .INDENT 0.0 .TP .B \-\-max\-toc\-links 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. .UNINDENT .INDENT 0.0 .TP .B \-\-no\-chapters\-in\-toc Älä lisää automaattisesti havaittuja lukuja sisällysluetteloon. .UNINDENT .INDENT 0.0 .TP .B \-\-toc\-filter Poista sisällysluettelosta rivit, joiden sisältö vastaa asetettua regexp\-lauseketta. Nämä rivit sekä niiden alarivit karsitaan luettelosta. .UNINDENT .INDENT 0.0 .TP .B \-\-toc\-threshold Jos lukuja löydetään vähemmän kuin tämä lukumäärä, sisällysluetteloon asetetaan linkit. Oletus: 6 .UNINDENT .INDENT 0.0 .TP .B \-\-use\-auto\-toc Yleensä, jos tiedostossa on jo sisällysluettelo, sitä käytetään automaattisesti luodun sijaan. Valinta asettaa aina käyttöön automaattisesti luodun sisällysluettelon. .UNINDENT .SH METATIEDOT .sp Asetukset lähdön metadatalle .INDENT 0.0 .TP .B \-\-author\-sort Teksti jota käytetään tekijän mukaan järjestämiseen. .UNINDENT .INDENT 0.0 .TP .B \-\-authors Aseta tekijät. Useammat tekijät erotetaan puolipisteillä. .UNINDENT .INDENT 0.0 .TP .B \-\-book\-producer Aseta kirjan tuottaja. .UNINDENT .INDENT 0.0 .TP .B \-\-comments Aseta kirjan kuvaus. .UNINDENT .INDENT 0.0 .TP .B \-\-cover Aseta kansi osoitetusta tiedostosta tai URL:stä .UNINDENT .INDENT 0.0 .TP .B \-\-isbn Anna kirjan ISBN. .UNINDENT .INDENT 0.0 .TP .B \-\-language Anna kieli. .UNINDENT .INDENT 0.0 .TP .B \-\-pubdate Aseta julkaisupäivämäärä (oletetaan käyttävän paikallista aikavyöhykettä, ellei aikavyöhykettä ilmoiteta erikseen) .UNINDENT .INDENT 0.0 .TP .B \-\-publisher Aseta kirjan julkaisija. .UNINDENT .INDENT 0.0 .TP .B \-\-rating Aseta arvosana. Luku 1\-5. .UNINDENT .INDENT 0.0 .TP .B \-\-read\-metadata\-from\-opf, \-\-from\-opf, \-m Lue metadata osoitetusta OPF\-tiedostosta. Luettu metadata ohittaa lähdetiedostosta löytyvät tiedot. .UNINDENT .INDENT 0.0 .TP .B \-\-series Aseta sarja johon kirja kuuluu. .UNINDENT .INDENT 0.0 .TP .B \-\-series\-index Aseta kirjan järjestysnumero sarjassa. .UNINDENT .INDENT 0.0 .TP .B \-\-tags Aseta kirjan tägit. Muotona pilkuin erotettu lista. .UNINDENT .INDENT 0.0 .TP .B \-\-timestamp Aseta kirja aikaleima (ei enää käytössä missään) .UNINDENT .INDENT 0.0 .TP .B \-\-title Anna otsikko. .UNINDENT .INDENT 0.0 .TP .B \-\-title\-sort Nimen muoto jota käytetään järjestämiseen. .UNINDENT .SH VIRHEENETSINTÄ .sp Asetukset, joilla muunnoksen vianmääritystä helpotetaan .INDENT 0.0 .TP .B \-\-debug\-pipeline, \-d Tallenna muuntoputken eri vaiheiden tuotokset määritettyyn kansioon. Hyödyllinen, jos et ole varma, missä vaiheessa muuntoprosessia virhe ilmenee. .UNINDENT .INDENT 0.0 .TP .B \-\-verbose, \-v 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. .UNINDENT .SH AUTHOR Kovid Goyal .SH COPYRIGHT Kovid Goyal .\" Generated by docutils manpage writer. .