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 directory and an "open e-book" (OEB) consisting of HTML files is written to that directory. 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 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"

The options and default values for the options change depending on both the input and output formats, so you should always check with:

ebook-convert myfile.input_format myfile.output_format -h


Below are the options that are common to all conversion, followed by the options specific to every input and output format.

  • FORRÁS BEÁLLÍTÁSOK
  • KIMENETI BEÁLLÍTÁSOK
  • MEGJELENÉS
  • HEURISZTIKUS FELDOLGOZÁS
  • KERESÉS ÉS CSERE
  • STRUKTÚRA FELISMERÉS
  • TARTALOMJEGYZÉK
  • METAADAT
  • HIBAKERESÉS

súgó megjelenítése és kilépés

Forrás profil megadása. Ez a konvertáláshoz szükséges adatokat is beállítja. Például felbontásfüggő hossz (hossz pixelben). A lehetőségek: cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad, irexdr1000, irexdr800, kindle, msreader, mobipocket, nook, sony, sony300, sony900

List builtin recipe names. You can create an e-book from a builtin recipe like this: ebook-convert "Recipe Name.recipe" output.epub

Specify the output profile. The output profile tells the conversion system how to optimize the created document for the specified device (such as by resizing images for the device screen size). In some cases, an output profile can be used to optimize the output for a particular device, but this is rarely necessary. Choices are: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

program verziójának megjelenítése és kilépés

FORRÁS BEÁLLÍTÁSOK

A forrás mobi fájlon végzett műveletek beállítása

A forrás dokumentum karakterkódolásának meghatározása. Ez felülírja a dokumentum eredetei beállításait. Különösen hasznos olyan dokumentumoknál, ahol nincs, vagy hibásan van beállítva a karakterkódolás.

KIMENETI BEÁLLÍTÁSOK

A epub kimenethez használható kapcsolók

Turn off splitting at page breaks. Normally, input files are automatically split at every page break into two files. This gives an output e-book that can be parsed faster and with less resources. However, splitting is slow and if your source file contains a very large number of page breaks, you should turn off splitting on page breaks.

Ez az opciók csak akkor szükséges, ha ez EPUB-ot FBReaderJ-vel szándékozik olvasni. Leegyszerűsíti az EPUB felépítését, az összes fájlt a felső szintre helyezi.

Insert an inline Table of Contents that will appear as part of the main book content.

A beillesztett Tartalomjegyzék fájlt tegye a könyv végére

The version of the EPUB file to generate. EPUB 2 is the most widely compatible, only use EPUB 3 if you know you actually need it.

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

Split all HTML files larger than this size (in KB). This is necessary as most EPUB readers cannot handle large file sizes. The default of 260KB is the size required for Adobe Digital Editions. Set to 0 to disable size based splitting.

Alapesetben, ha a forrás fájl nem tartalmaz borítót, és Ön nem ad meg egyet, akkor egy generált borító készül a könyvhöz a címmel, szerzővel stb. Ez az opció letiltja ezt az automatikusan generált borítót.

Ne használjon SVG fájlt borítónak. Ezzel az opcióval az EPUB használható lesz olyan eszközökön, amelyek nem támogatják az SVG-t, mint az iPhone vagy a JetBookLite. Enélkül az opció nélkül, az ilyen eszközök, egy üres lapot jelenítenek meg borítóként.

Ha SVG borító esetén használja ezt az opciót, akkor a borító a képernyő méretéhez lesz igazítva a méretarány megtartásával. Ez azt jelenti, hogy a a borító széleinél margó látható esetenként, de a kép nem lesz torzított. Ha nem használja ezt az opciót, akkor a borító kitölti a képernyőt, de enyhén torz lehet.

Ez egy általánosan elfogadható kimenetet hoz létre. Néhány kimeneti bővítmény esetén nincs semmilyen hatása.

A generált Tartalomjegyzék címe.

MEGJELENÉS

A kimeneti formátum megjelenítésének beállításai

Unicode karakterek ASCII kódolása. Óvatosan használja, mert az unicode karaktereket ASCII-val helyettesíti. Például a "Михаил Горбачёв" helyett „Mikhail Gorbachiov” lesz. Megjegyzendő, hogy ahol egy betűnek több megfelelője lehet (például kínai és japán betűknél), ott a Calibre felületének megfelelő lesz használva.

The base font size in pts. All font sizes in the produced book will be rescaled based on this size. By choosing a larger size you can make the fonts in the output bigger and vice versa. By default, when the value is zero, the base font size is chosen based on the output profile you chose.

Szöveg rendezés módosítása. A „left” érték minden sorkizárt szöveget balra igazít. A „justify” érték minden igazítatlan szöveget sorkizárttá tesz. Az „original” (alapértelmezett) érték nem változtatja a forrás rendezettségét. Megjegyzendő, hogy csak néhány kimeneti formátum támogatja a rendezéseket.

A betűk átméretezésének tiltása.

Embed every font that is referenced in the input document but not already embedded. This will search your system for the fonts, and if found, they will be embedded. Embedding will only work if the format you are converting to supports embedded fonts, such as EPUB, AZW3, DOCX or PDF. Please ensure that you have the proper license for embedding the fonts used in this document.

Embed the specified font family into the book. This specifies the "base" font used for the book. If the input document specifies its own fonts, they may override this base font. You can use the filter style information option to remove fonts from the input document. Note that font embedding only works with some output formats, principally EPUB, AZW3 and DOCX.

By default, calibre will use the shorthand form for various CSS properties such as margin, padding, border, etc. This option will cause it to use the full expanded form instead. Note that CSS is always expanded when generating EPUB files with the output profile set to one of the Nook profiles as the Nook cannot handle shorthand CSS.

Külső CSS fájl teljes útvonala vagy CSS kód. Ezek a szabályok felülírják a forrásfájlban lévő stílusokat.

A minden CSS szabályból eltávolítani kívánt CSS tulajdonságok vesszővel tagolt listája. Ez hasznos lehet, ha néhány stílus információt az olvasó eszköz nem tud kezelni, felülírni, vagy figyelmen kívül hagyni. Például: font-family,color,margin-left,margin-right

CSS betűnevek megfeleltetése betűméret pontoknak. Vegyük például a 12,12,14,16,18,20,22,24 méreteket. Ezek fognak megfelelni az xx-small-tól az xx-large méreteknek. A betű átméretező algoritmus intelligensen behelyettesíti a megfelelő méreteket. Alapértelmezett: a kimeneti profilban beállított értékek.

Egy üres sor beillesztése a bekezdések közé. Nem működik, ha a forrásfájl nem használ bekezdéseket (<p> vagy <div> címkéket).

A beillesztendő üres sorok magassága (em-ben). A bekezdések között ennek az értéknek a kétszerese lesz, mert eléjük és utánuk is beszúrásra kerül.

Ligatúrák megőrzése a forrás dokumentumban. A ligatúra egy betűpár különleges megjelenése, például: ff, fi, fl, stb. A legtöbb olvasó nem támogatja a ligatúrákat az alap betűtípusaikban, így nem valószínű, hogy helyesen jelennének meg. Alapból a Calibre a ligatúrákat normál betűpárra cseréli. Ez az opció megtartja őket.

Sormagasság pontban. Megadja az egymást követő sorok közti távolságot. Csak azokra az elemekre vonatkozik, amik nem adják meg a sormagasságot. Legtöbb esetben a minimális sormagasság használata célszerűbb. Alapból nincs sormagasság módosítás.

Néhány rosszul megtervezett dokumentumban szükségtelenül alkalmaznak táblázatokat a szöveg formázására. Ezeknél a fájloknál a táblázatokban lévő szöveg gyakran nem fér ki a lapra. Ez az opció kinyeri a táblázat tartalmát és soros szöveggé alakítja azt.

Az alsó margó beállítása pontokban. Alapértelmezés 5.0, Ha nulla értékre állítja be, akkor nem lesz margó (az eredeti dokumentum margóbeállítása megmarad). Megjegyzés: Az oldalorientált formátumok, például a PDF és a DOCX saját margó beállításokkal rendelkeznek, amelyek elsőbbséget élveznek.

A bal oldali margó beállítása pontokban. Alapértelmezés %ddefault. Ha nulla értékre állítja be, akkor nem lesz margó (az eredeti dokumentum margóbeállítása megmarad). Megjegyzés: Az oldalorientált formátumok, például a PDF és a DOCX saját margó beállításokkal rendelkeznek, amelyek elsőbbséget élveznek.

A jobb oldali margó beállítása pontokban. Alapértelmezés %ddefault. Ha nulla értékre állítja be, akkor nem lesz margó (az eredeti dokumentum margóbeállítása megmarad). Megjegyzés: Az oldalorientált formátumok, például a PDF és a DOCX saját margó beállításokkal rendelkeznek, amelyek elsőbbséget élveznek.

A felső margó beállítása pontokban. Alapértelmezés 5.0. Ha nulla értékre állítja be, akkor nem lesz margó (az eredeti dokumentum margóbeállítása megmarad). Megjegyzés: Az oldalorientált formátumok, például a PDF és a DOCX saját margó beállításokkal rendelkeznek, amelyek elsőbbséget élveznek.

Minimális sormagasság, az elem számolt betűméretének százaléka. A Calibre biztosítja, hogy minden elem, legalább az itt megadott érték legyen, a forrás dokumentumban megadottól függetlenül. Állítsa 0-ra a kikapcsoláshoz. Alapérték: 120%. Közvetlen sormagasság megadására is használható. Duplán széthúzott szöveg érhető el például 240-re állítva az értéket.

Bekezdések közötti szünet eltüntetése. Egyúttal a behúzást is 1.5-re állítja. Ez a funkció nem működik, ha a forrás fájl nem használ bekezdéseket (<p> vagy <div> HTML címkéket).

Amikor a Calibre eltávolítja az üres sorokat, automatikusan behúzással látja a következő bekezdést a könnyebb olvashatóság érdekében. Ez az opció ennek a behúzásnak a beállítására szolgál (em-ben). Ha az értéket negatívra állítja, akkor a Calibre nem módosítja a behúzást.

Sima idézőjelek, ívelt karakterek konvertálása tipográfiai megfelelőjükre. További részletek: https://daringfireball.net/projects/smartypants

Minden beágyazott betűtípus csak azokat a betűket fogja tartalmazni, melyek szükségesek a könyvhöz. Ez csökkenti a betűfájl méretét. Hasznos lehet, ha nagyméretű betűtípus fájlokat használ, melyek sok, nem használt karaktert is tartalmaznak.

Path to a file containing rules to transform the CSS styles 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 styles" section of the conversion dialog. Once you create the rules, you can use the "Export" button to save them to a file.

Az elegánsabb, szebb írásjelek (idézőjel, gondolatjel, stb.) egyszerűbb megfelelőit használja.

HEURISZTIKUS FELDOLGOZÁS

A dokumentum szövegének és felépítésének módosítása megadott minták alapján. Alapértelmezetten ki van kapcsolva. Engedélyezéshez ezt használja: --enable-heuristics, letiltáshoz ezt: --disable-

*

.

Elemzi az elválasztott szavakat a dokumentumban. Maga a dokumentum szolgál szótárként annak meghatározásához, hogy az elválasztójel szükséges vagy eltávolítandó.

Üres bekezdések eltávolítása a dokumentumból, ha más, nem üres bekezdések között vannak

A több nem-törhető szóközzel létrehozott behúzásokat alakítsa CSS behúzássá.

A balra rendezett fejezet elválasztók középre rendezettek lesznek. A több üres sort is tartalmazó fejezet elválasztókat lecseréli vízszintes vonalra.

Dőlt szövegre utaló szavak és minták keresése, és a találatok dőltté tétele.

Ismerje fel a formázatlan fejezet címeket és alcímeket. Változtassa őket h2 és h3 tag-ekké. Ez a beállítás nem hoz létre Tartalomjegyzéket, de később használható a „Struktúra felismerés” módban egy létrehozásához.

Az egymást követő <h1> és <h2> HTML tag-eket rendezi sorba, hogy a címsorokban ne legyen törés.

Sortördelés megszüntetése az írásjelek és egyéb formázások használatával.

Heurisztikus feldolgozás. Ezt be kell kapcsolni, hogy bármilyen heurisztikus feldolgozás megtörténjen.

Arány meghatározása, ahonnan egy sor tördelése megszüntetendő. Az érvényes értékek 0 és 1 között vannak. Az alap 0.4, ami a fél sornál egy kicsit rövidebb. Ha csak pár sort kellene egysorossá tenni a dokumentumban, akkor érdemes csökkenteni ezt az értéket.

Fejezet elválasztók cseréje a kiválasztott szövegre. Alapértelmezettként a forrás dokumentumban szereplő kerül alkalmazásra.

KERESÉS ÉS CSERE

A dokumentum szövegének és felépítésének módosítása felhasználó által megadott minták alapján.

Path to a file containing search and replace regular expressions. The file must contain alternating lines of regular expression followed by replacement pattern (which can be an empty line). The regular expression must be in the Python regex syntax and the file must be UTF-8 encoded.

Helyettesítő szöveg az első reguláris kifejezéssel talált szöveg cseréjére

Az első csere mintája (reguláris kifejezés)

Helyettesítő szöveg a második reguláris kifejezéssel talált szöveg cseréjére

A második csere mintája (reguláris kifejezés)

Helyettesítő szöveg a harmadik reguláris kifejezéssel talált szöveg cseréjére

A harmadik csere mintája (reguláris kifejezés)

STRUKTÚRA FELISMERÉS

Dokumentum-struktúra automatikus felismerése.

An XPath expression to detect chapter titles. The default is to consider <h1> or <h2> tags that contain the words "chapter", "book", "section", "prologue", "epilogue" or "part" as chapter titles as well as any tags that have class="chapter". The expression used must evaluate to a list of elements. To disable chapter detection, use the expression "/". See the XPath Tutorial in the calibre User Manual for further help on using this feature.

--chapter-mark
A felismert fejezetekre alkalmazandó formázás. A lehetséges értékek: „pagebreak” - sortörés beillesztése minden fejezet elé; „rule” - egy vízszintes vonal beillesztése minden fejezet elé; „none” - egyiket se alkalmazza; „both” - sortörés és vonal alkalmazása egyszerre.

Egyes dokumentumok a bal és jobb margót minden bekezdésnél külön adják meg. A Calibre megpróbálja ezt felismerni és eltávolítani a felesleges margókat. Néha a szükséges margók is törlődnek. Ilyenkor ezzel ki lehet kapcsolni az eltávolítást.

Beilleszti a könyv metaadatait a könyv elejére. Ez akkor hasznos, ha az e-könyv olvasója nem támogatja a metaadatok közvetlen megjelenítését/keresését.

Egy XPath kifejezés. A megadott elem elé oldaltörés lesz beillesztve. A tiltásához használja a következő kifejezést: /

Inkább a forrásfájlban található borítót használja a beállított borító helyett, ha elérhető

Távolítsa el az első képet a forrás e-könyvből. Hasznos, ha a forrás dokumentum borítója nem megfelelő. Ha a borítót a Calibre-vel állítja be, a kimeneti dokumentum két borítót tartalmazna, e lehetőség hiányában.

An XPath expression to detect the location in the document at which to start reading. Some e-book reading programs (most prominently the Kindle) use this location as the position at which to open the book. See the XPath tutorial in the calibre User Manual for further help using this feature.

TARTALOMJEGYZÉK

Az automatikus Tartalomjegyzék-generálás beállítása. Alapértelmezettként, ha a forrásfájl tartalmaz Tartalomjegyzéket, az kerül felhasználásra az automatikusan generált helyett.

Többszörös bejegyzések engedélyezése. Pl. ha egy könyv több azonos Tartalomjegyzék szöveget tartalmaz, de azok különböző helyre mutatnak

XPath kifejezés, amely megadja azokat a „címkéket” (tags), melyek a Tartalomjegyzék első szintjére kerülnek. Tanulmányozza az XPath oktatóanyagot a Calibre Felhasználói kézikönyvében további információkért.

XPath kifejezés, amely megadja azokat a „címkéket” (tags), melyek a Tartalomjegyzék második szintjére kerülnek. Tanulmányozza az XPath oktatóanyagot a Calibre Felhasználói kézikönyvében a további információkért.

XPath kifejezés, amely megadja azokat a „címkéket” (tags), melyek a Tartalomjegyzék harmadik szintjére kerülnek. Tanulmányozza az XPath oktatóanyagot a Calibre Felhasználói kézikönyvében a további információkért.

A tartalomjegyzékbe beilleszthető linkek maximális száma. Állítsa 0-ra a letiltáshoz. Alapértelmezett: 50. Csak akkor lesznek beszúrva a linkek, ha a számuk kisebb a beállítottnál.

Ne adja hozzá az automatikusan felismert fejezeteket a tartalomjegyzékhez.

A megadott reguláris kifejezésnek megfelelő bejegyzések eltávolítása a Tartalomjegyzékből. Az alárendelt, kapcsolódó bejegyzések is törölve lesznek.

Ha ennél kevesebb fejezet detektálható automatikusan, akkor a tartalomjegyzékben a bejegyzések linkek legyenek. Alapértelmezett: 6

Általában ha a forrásfájl tartalmaz Tartalomjegyzéket, az kerül felhasználásra az automatikusan generált helyett. Ezzel a beállítással mindig az automatikusan generált lesz használva.

METAADAT

A kimenet metaadat beállításai

A szerző alapján történő rendezéskor használandó karakterlánc.

Adja meg a szerzőt. Több szerző esetén pontosvesszővel kell elválasztani azokat.

Könyv gyártójának megadása.

A könyv leírása.

A borítót a megadott fájl vagy URL alapján állítása be

Könyv ISBN azonosítójának megadása.

Nyelv megadása.

Set the publication date (assumed to be in the local timezone, unless the timezone is explicitly specified)

A könyv kiadója.

Értékelés. 1 és 5 közötti számnak kell lennie.

Metaadatok olvasása a meghatározott OPF fájlból. Ez felülírja a forrásfájl összes metaadatát.

Set the series this e-book belongs to.

--series-index
Könyv sorszámának megadása a sorozaton belül.

Könyv címkéinek megadása. Ez egy vesszővel elválasztott lista legyen.

Könyv időbélyeg megadása (már nem használt)

Könyvcím megadása.

--title-sort
A rendezéshez használandó könyvcím verzió.

HIBAKERESÉS

A hibakereséshez használható opciók

A konvertálás egyes szakaszainak mentése a megadott mappába. Hasznos lehet, ha nem tudja, melyik szakasznál keletkezett a konvertálási hiba.

Level of verbosity. Specify multiple times for greater verbosity. Specifying it twice will result in full verbosity, once medium verbosity and zero times least verbosity.

AUTHOR

Kovid Goyal

COPYRIGHT

Kovid Goyal

November 29, 2019 4.5.0