Arch manual pages

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

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

--help, -h
ennek a súgónak a megjelenítése és kilépés

--input-profile
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-recipes
List builtin recipe names. You can create an e-book from a builtin recipe like this: ebook-convert "Recipe Name.recipe" output.epub

--output-profile
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

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

A forrás mobi fájlon végzett műveletek beállítása
--input-encoding
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.

A epub kimenethez használható kapcsolók
--dont-split-on-page-breaks
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.

--epub-flatten
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.

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

--epub-toc-at-end
A beillesztett Tartalomjegyzék fájlt tegye a könyv végére

--epub-version
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-to
Extract the contents of the generated EPUB file to the specified directory. The contents of the directory are first deleted, so be careful.

--flow-size
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.

--no-default-epub-cover
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.

--no-svg-cover
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.

--preserve-cover-aspect-ratio
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.

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

--toc-title
A generált Tartalomjegyzék címe.

A kimeneti formátum megjelenítésének beállításai
--asciiize
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.

--base-font-size
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.

--change-justification
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.

--disable-font-rescaling
A betűk átméretezésének tiltása.

--embed-all-fonts
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-font-family
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.

--expand-css
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.

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

--filter-css
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

--font-size-mapping
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.

--insert-blank-line
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).

--insert-blank-line-size
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.

--keep-ligatures
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.

--line-height
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.

--linearize-tables
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.

--margin-bottom
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.

--margin-left
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.

--margin-right
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.

--margin-top
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.

--minimum-line-height
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.

--remove-paragraph-spacing
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).

--remove-paragraph-spacing-indent-size
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.

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

--subset-embedded-fonts
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.

--transform-css-rules
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.

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

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-
*
.
--disable-dehyphenate
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ó.

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

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

--disable-format-scene-breaks
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.

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

--disable-markup-chapter-headings
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.

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

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

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

--html-unwrap-factor
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.

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

A dokumentum szövegének és felépítésének módosítása felhasználó által megadott minták alapján.
--search-replace
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.

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

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

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

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

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

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

Dokumentum-struktúra automatikus felismerése.
--chapter
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.

--disable-remove-fake-margins
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.

--insert-metadata
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.

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

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

--remove-first-image
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.

--start-reading-at
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.

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.
--duplicate-links-in-toc
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

--level1-toc
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.

--level2-toc
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.

--level3-toc
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.

--max-toc-links
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.

--no-chapters-in-toc
Ne adja hozzá az automatikusan felismert fejezeteket a tartalomjegyzékhez.

--toc-filter
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.

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

--use-auto-toc
Á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.

A kimenet metaadat beállításai
--author-sort
A szerző alapján történő rendezéskor használandó karakterlánc.

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

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

--comments
A könyv leírása.

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

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

--language
Nyelv megadása.

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

--publisher
A könyv kiadója.

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

--read-metadata-from-opf, --from-opf, -m
Metaadatok olvasása a meghatározott OPF fájlból. Ez felülírja a forrásfájl összes metaadatát.

--series
Set the series this e-book belongs to.

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

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

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

--title
Könyvcím megadása.

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

A hibakereséshez használható opciók
--debug-pipeline, -d
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.

--verbose, -v
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.

Kovid Goyal

Kovid Goyal
október 08, 2019 4.1.0