.\" 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" "kesäkuuta 17, 2022" "5.44.0" "calibre" .SH NAME ebook-convert \- ebook-convert .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C ebook\-convert input_file output_file [options] .ft P .fi .UNINDENT .UNINDENT .sp Convert an e\-book from one format to another. .sp input_file is the input and output_file is the output. Both must be specified as the first two arguments to the command. .sp 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 \(dqopen e\-book\(dq (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. .sp 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. .sp For full documentation of the conversion system see \fI\%Ekirja muunnos\fP .sp Whenever you pass arguments to \fBebook\-convert\fP that have spaces in them, enclose the arguments in quotation marks. For example: \(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 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 .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ä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. .UNINDENT .INDENT 0.0 .TP .B \-\-epub\-inline\-toc Lisää inline\-sisällysluettelon, joka näkyy kirjan sisällön osana. .UNINDENT .INDENT 0.0 .TP .B \-\-epub\-toc\-at\-end Lisää inline\-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 Extract the contents of the generated EPUB file to the specified folder. The contents of the folder are first deleted, so be careful. .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, lisäosa yrittää luoda tuloksen, 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 inline\-sisällysluettelon otsikko. .UNINDENT .SH ULKOASU .sp Asetukset, joilla kontrolloidaan ulostulon ulkoasua .INDENT 0.0 .TP .B \-\-asciiize Transliterate Unicode characters to an ASCII representation. Use with care because this will replace Unicode characters with ASCII. For instance it will replace \fB\(dq\fPPelé\fB\(dq\fP with \fB\(dq\fPPele\fB\(dq\fP\&. 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. .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 Vaihda tekstin tasaus. Arvo \fB\(dq\fPleft\fB\(dq\fP muuntaa kaiken tekstin vasemmalle tasatuksi. Arvo \fB\(dq\fPjustify\fB\(dq\fP muuntaa kaiken tekstin tasapalstaksi. Arvo \fB\(dq\fPoriginal\fB\(dq\fP (oletus) säilyttää alkuperäisen tasauksen lähdetiedostosta. Huomaa, että vain jotkin kohdeformaatit tukevat tasapalstaa. .UNINDENT .INDENT 0.0 .TP .B \-\-disable\-font\-rescaling Kytke tekstikoon skaalaus pois päältä. .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. 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. .UNINDENT .INDENT 0.0 .TP .B \-\-extra\-css 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ä. .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\-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. .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 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. .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 Convert plain quotes, dashes and ellipsis to their typographically correct equivalents. For details, see \fI\%https://daringfireball.net/projects/smartypants\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-subset\-embedded\-fonts 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ä. .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 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 \fB\(dq\fPLook & feel\->Transform HTML\fB\(dq\fP section of the conversion dialog. Once you create the rules, you can use the \fB\(dq\fPExport\fB\(dq\fP button to save them to a file. .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. 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ä. .UNINDENT .INDENT 0.0 .TP .B \-\-disable\-renumber\-headings Etsii perättäisiä

tai

tägejä. Tägit numeroidaan uusiksi, 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 lukujen otsikoiden 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 lukujen otsikoiksi, kuten myös tägit joiden class=\fB\(dq\fPchapter\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ää metatiedot kirjan alkuun. Hyödyllistä, jos lukulaitteesi ei tue metatietojen 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 havaittua kansikuvaa erikseen määritellyn kansikuvan sijaan. .UNINDENT .INDENT 0.0 .TP .B \-\-remove\-first\-image 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. .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 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. .UNINDENT .INDENT 0.0 .TP .B \-\-level2\-toc 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. .UNINDENT .INDENT 0.0 .TP .B \-\-level3\-toc 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. .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 ulostulon metatiedoille .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 metatiedot osoitetusta OPF\-tiedostosta. Luetut metatiedot ohittavat 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 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. .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. .