ebook-convert

ebook-convert input_file output_file [opties]

Converteer een e-book van het ene naar het andere formaat.

Het e-book uitvoerformaat wordt geraden aan de hand van de extensie van het output_file. output_file kan ook van het speciale .EXT formaat zijn, waarbij EXT de extensie is van het uitvoerbestand. In dit geval wordt de naam van het uitvoerbestand die van het invoerbestand. Let op dat de bestandsnaam niet mag beginnen met een koppelteken (-). Als, tot slot, output_file geen extensie heeft wordt deze gezien als een map en wordt een “open e-book” (OEB) bestaande uit HTML-bestanden weggeschreven in die map. Deze bestanden zijn dezelfde die normaal gezien de uitvoer plug-in zouden zijn gepasseerd.

Na specificatie van het invoer- en uitvoerbestand kan men de conversie aanpassen door een aantal opties te kiezen. De beschikbare opties hangen af van het type invoer- en uitvoerbestanden. Voor hulp kan na het kiezen van het invoer- en uitvoerbestand de -h optie worden gebruikt.

Voor de volledige documentatie van het conversiesysteem zie E-book convertie

Whenever you pass arguments to ebook-convert that have spaces in them, enclose the arguments in quotation marks. For example: “/some path/with spaces”

De opties en standaard waarden voor de opties veranderen met de de input en output waarden. U moet dus altijd controleren bij:

ebook-convert myfile.input_format myfile.output_format -h

Hier onder staan de opties die gleden voor alle conversies, gevolgd door de opties die specifiek zijn voor elk input en output formaat.

--help, -h

toon dit helpbericht en stop

--input-profile

Specificeer het invoerprofiel. Het invoerprofiel geeft het conversiesysteem informatie over hoe de informatie in het invoerdocument geïnterpreteerd moet worden. Bijvoorbeeld resolutie-afhankelijke lengtes (lengte in pixels). Mogelijkheden zijn:cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad, irexdr1000, irexdr800, kindle, msreader, mobipocket, nook, sony, sony300, sony900

--list-recipes

Namen van ingebouwde recepten weergeven. U kunt de volgende opdracht gebruiken om met behulp van een recept een e-boek te maken: eboek-converteer "Receptnaam.recipe" uitvoer.epub

--output-profile

Specificeer het uitvoerprofiel. Het uitvoerprofiel bepaalt hoe het conversiesysteem het aangemaakte document optimaliseert voor het gespecificeerde apparaat (zoals bij het aanpassen van afbeeldingen voor de schermresolutie van het apparaat). In sommige gevallen kan een uitvoerprofiel worden gebruikt om de uitvoer naar een bepaald apparaat te optimaliseren, maar dat is zelden nodig. Keuzes zijn: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_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

toon programmaversie en stop

INVOEROPTIES

Opties om de bewerking van invoerbestand mobi aan te passen

--input-encoding

Specificeer de tekencodering van het invoerbestand. Als deze optie ingesteld is, zal de codering die het document zelf bevat genegeerd worden. Vooral nuttig voor documenten die geen codering ingesteld hebben, of die een foutieve tekencodering aangeven.

UITVOEROPTIES

Opties om de bewerking van uitvoerbestand epub aan te passen

--dont-split-on-page-breaks

Schakel het splitten bij pagina-eindes uit. Normaal gesproken worden de invoerbestanden automatisch bij elk pagina-einde opgesplitst in twee bestanden. Hierdoor krijg je een uitvoer e-boek dat sneller en met minder middelen taalkundig kan worden ontleed. Het splitsen is echter traag, en als uw bronbestand een zeer groot aantal pagina-eindes bevat, moet u splitsing op pagina-eindes uitschakelen.

--epub-flatten

Deze optie is alleen nodig als u de EPUB op een FBReaderJ wilt gebruiken. Het verwijdert alle deelmappen binnen de EPUB, en zet alle bestanden op het hoogste niveau.

--epub-inline-toc

Voeg een in de tekst staande Inhoudsopgave in, die in het boek zelf komt te staan als deel van inhoud.

--epub-toc-at-end

Zet de ingevoegde in de tekst staande Inhoudsopgave aan het eind van het boek in plaats van aan het begin.

--extract-to

Extraheert de inhoud van het gegenereerd EPUB bestand naar de aangegeven map. De inhoud van de map wordt eerst gewist, dus wees voorzichtig.

--flow-size

Splits alle HTML-bestanden die groter zijn dan deze grootte (in kB). Dit is nodig omdat de meeste EPUB-lezers geen grote bestanden kunnen hanteren. De standaard van 260KB is de grootte vereist voor Adobe Digital Editions. Ingesteld op 0 schakelt de opsplitsing uit.

--no-default-epub-cover

Als het invoerbestand geen omslag bevat en er niet expliciet een is opgegeven zal een standaardomslag worden aangemaakt met daarop de titel, auteurs, enz. Deze optie schakelt dit uit.

--no-svg-cover

Gebruik geen SVG voor de omslag van het boek. Gebruik deze optie als uw EPUB gebruikt gaat worden op een apparaat dat SVG niet ondersteunt, zoals de iPhone of de JetBook Lite. Zonder deze optie zullen deze apparaten de omslag van het boek als een lege pagina laten zien.

--preserve-cover-aspect-ratio

Bij gebruik van een SVG-omslag zal deze optie ervoor zorgen dat de omslag het hele scherm vult, maar toch de breedte/hoogteverhouding zal behouden. Dit betekent dat er sprake kan zijn van omslagen met witte randen aan de zijkanten of de boven- en onderkant van het beeld, maar de afbeelding zal nooit vervormd worden. Zonder deze optie kan de afbeelding enigszins vervormd worden, maar zullen er geen witte randen zijn.

--pretty-print

Indien opgegeven, zal de uitvoerplug-in proberen om uitvoer te genereren die zo leesbaar mogelijk is. Het kan zijn dat dit op sommige uitvoerplug-ins geen enkel effect heeft.

--toc-title

Titel voor iedere gegenereerde in-line inhoudsopgave.

LOOK AND FEEL

Opties om uiterlijk van de uitvoer aan te passen

--asciiize

Zet unicodetekens om naar ASCII-tekens. Voorzichtig gebruiken want di zal unicode tekens vervangen door ASCII. Bijvoorbeeld: "Михаил Горбачёв" zal worden vervangen door "Mikhail Gorbachiov". Merk ook op dat als er meerdere weergaves van een teken zijn (zoals bij gedeelde tekens uit Chinees en Japans), de weergave gekozen wordt op basis van de taalinstellingen voor calibre.

--base-font-size

De basislettergrootte in pts. Alle lettergroottes in het geproduceerde boek zullen worden herschaald gebaseerd op deze instelling. Het kiezen van een groter formaat maakt de letters in de uitvoer groter, en omgekeerd. Standaard wordt de lettergrootte gebaseerd op het uitvoerprofiel dat gekozen is.

--change-justification

Wijzig tekst uitvulling. De waarde ‘links uitlijnen’ verandert alle uitgelijnde tekst in de bron naar links uitgelijnde tekst (m.a.w. niet uitgevuld). De waarde ‘tekst uitvullen’ verandert alle niet uitgevulde tekst naar uitgevuld. De waarde ‘origineel’ (de standaardwaarde) verandert de uitvulling in het bronbestand niet. Merk op dat maar een beperkt aantal uitvoerformaten uitvullen ondersteunen.

--disable-font-rescaling

Geen herschaling van lettergrootte.

--embed-all-fonts

Alle lettertypes invoegen, waaraan in het input-document wordt gerefereerd, maar nog niet zijn toegevoegd. Dit zal uw systeem doorzoeken naar de lettertypes, en indien gevonden, zullen ze toegevoegd worden. Toevoegen zal alleen werken als het formaat waarnaar u wilt converteren ingebouwde fonts ondersteunt, zoals EPUB, AZW3, DOCX of PDF. Gelieve er op toe te zien dat u de nodige licenties bezit om lettertypes toe te voegen aan dit document

--embed-font-family

Het gespecificeerde lettertype wordt ingebed in het boek. Dit bepaalt het "basis" lettertype dat gebruikt wordt voor het boek. Als het invoer document eigen lettertypes specificeert, kunnen deze het basis lettertype overschrijven. U kunt het filter "stijl informatie optie" gebruiken om lettertypes uit het invoer document te verwijderen. Opgepast: inbedden van lettertypes alleen werkt met bepaalde uitvoer indelingen, voornamelijk EPUB en AZW3.

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

Het pad naar een CSS-Stylesheet, of raw CSS. Deze CSS zal worden toegevoegd aan de stijlregels van het invoerbestand, waarbij de regels uit de CSS voorrang hebben.

--filter-css

Een door komma's gescheiden lijst van CSS-eigenschappen die zullen worden verwijderd uit alle CSS-stijlregels. Dit is handig als de aanwezigheid van enkele stijl informatie voorkomt dat het wordt overschreven op uw apparaat. Bijvoorbeeld: font-family, kleur, margin-left, margin-right

--font-size-mapping

Omzetten van CSS-lettertypenamen naar lettergroottes in pts. Een voorbeeld van instelling is 12,12,14,16,18,20,22,24. Dit zijn de omzettingen voor de groottes xx-small tot xx-large, met de laatste grootte voor enorme letters. Het algoritme voor lettertypeherschaling gebruikt deze lettergroottes om de letters intelligent aan te passen. Standaard worden de instellingen van het gekozen uitvoerprofiel gebruikt.

--insert-blank-line

Voeg een lege regel toe tussen alinea's. Dit werkt niet als het bronbestand geen alinea's gebruikt (<p>- of <div>-tags).

--insert-blank-line-size

Stel de hoogte van de ingevoegde blanco regels in (in em). De hoogte van de regels tussen paragrafen is het dubbele van wat u hier insteld.

--keep-ligatures

Behoud aanwezige bindingen in het invoer document. Een binding is een speciale weergave van een tekenpaar zoals ff, fi, fl enz. De meeste e-readers bieden geen ondersteuning voor bindingen in hun standaard lettertypes, dus worden ze waarschijnlijk niet juist weergegeven. Standaard zal Calibre een ligatuur omzetten in het overeenkomstige paar normale tekens. Deze optie wordt daarna behouden.

--line-height

De lijnhoogte in pts. Regelt de vrije ruimte tussen opeenvolgende tekstregels. Geldt alleen voor elementen die hun eigen lijnhoogte niet bepalen. Meestal is het opgeven van de minimale lijnhoogte nuttiger. Standaard wordt de lijnhoogte niet aangepast.

--linearize-tables

Sommige slecht-ontworpen documenten gebruiken tabellen om de lay-out van tekst op de pagina te beïnvloeden. Wanneer deze documenten geconverteerd worden hebben ze vaak vreemde fouten, zoals tekst die langer is dan de pagina. Deze optie zal de inhoud uit de tabellen halen en deze achter elkaar weergeven.

--margin-bottom

Set the bottom margin in pts. Default is 5.0. Setting this to less than zero will cause no margin to be set (the margin setting in the original document will be preserved). Note: Page oriented formats such as PDF and DOCX have their own margin settings that take precedence.

--margin-left

Set the left margin in pts. Default is 5.0. Setting this to less than zero will cause no margin to be set (the margin setting in the original document will be preserved). Note: Page oriented formats such as PDF and DOCX have their own margin settings that take precedence.

--margin-right

Set the right margin in pts. Default is 5.0. Setting this to less than zero will cause no margin to be set (the margin setting in the original document will be preserved). Note: Page oriented formats such as PDF and DOCX have their own margin settings that take precedence.

--margin-top

Set the top margin in pts. Default is 5.0. Setting this to less than zero will cause no margin to be set (the margin setting in the original document will be preserved). Note: Page oriented formats such as PDF and DOCX have their own margin settings that take precedence.

--minimum-line-height

De minimale hoogte van een regel, als percentage van de berekende lettergrootte van het element. Calibre zorgt ervoor dat ieder element een regelhoogte heeft van op zijn minst deze instelling, onafhankelijk van wat het ingevoerde document specificeert. Zet op nul om te negeren. De standaardwaarde is 120%. Gebruik deze instelling liever dan de rechtstreekse regelhoogte-instelling, tenzij u weet wat u doet. Om bijvoorbeeld dubbele regelafstand te verkrijgen zet u deze instelling op 240.

--remove-paragraph-spacing

Verwijder witregels tussen alinea's. Stelt ook inspringen met 1.5em in voor alinea's. Witregels verwijderen werkt niet als het invoerbestand geen alinea's gebruikt (<p>- of <div>-tags).

--remove-paragraph-spacing-indent-size

Als calibre lege regels tussen paragrafen verwijderd, zal automatisch een paragraaf insprong worden toegevoegd om de paragraaf makkelijk te kunnen onderscheiden. Deze optie stelt de breedte van die insprong (in em) in. Als y deze waarde negatief instelt, zal de insprong-waarde gebruikt worden die is opgegeven in het bestand. Oftewel, calibre zal de insprong niet aanpassen.

--smarten-punctuation

Zet gewone aanhalingstekens, streepjes en ellipsis (weglatingsteken) om in hun typografisch juiste equivalenten. Voor details: https://daringfireball.net/projects/smartypants

--subset-embedded-fonts

Uitdunnen van alle ingebedde lettertypes. Elk ingebed lettertype is beperkt tot de tekens gebruikt in dit document. Dit beperkt de omvang van de lettertype bestanden. Bruikbaar wanneer u een zeer uitgebreid lettertype wilt insluiten met veel ongebruikte tekens.

--transform-css-rules

Het pad naar een bestand dat regels bevat om de CSS stijlen in dit boek te transformeren… De handigste weg om zo'n bestand aan te maken is de wizard te gebruiken om regels op te stellen. U vindt deze onder de knop "Boeken converteren" onder de rubriek "Uiterlijk & gedrag > Transformeer stijlen" Eens u regels heeft aangemaakt gebruikt u de functie "exporteren" om ze op te slaan in een bestand.

--unsmarten-punctuation

Vervang mooie aanhalingstekens, punten en afbrekingstekens met de 'platte tekst' equivalenten.

HEURISTISCHE VERWERKING

Bewerk de tekst van het document en de struktuur, gebruikmakend van algemene patronen. Standaard uitgeschakeld. Gebruik –enable-heuristics om in te schakelen. Individuele taken kunnen worden uitgeschakeld met de –disable-* opties.

--disable-dehyphenate

Analyseer de afgebroken woorden. Het document zelf dient als woordenboek om te bepalen of het afbreekteken als liggend streepje moet worden behouden.

--disable-delete-blank-paragraphs

Verwijder lege alinea's als ze elke tweede alinea voorkomen

--disable-fix-indents

Maak van indentatie aangeduid door ‘non-breaking spaces’ CSS-indentatie.

--disable-format-scene-breaks

Links uitgelijnde breekpuntmarkeringen worden gecentreerd. Vervang opeenvolgende lege regels door horizontale lijnen.

--disable-italicize-common-cases

Zoek naar veelgebruikte woorden en patronen die duiden op cursief en maak deze cursief.

--disable-markup-chapter-headings

Detecteer onopgemaakte hoofdstuk- en deelkoppen en verander deze in h2- en h3-tags. Deze optie genereert zelf geen inhoudsopgave, maar kan samen met structuurdetectie gebruikt worden om er een te maken.

--disable-renumber-headings

Zoek naar opeenvolgende <h1>- of <h2>-tags. Deze worden hernummerd om te voorkomen dat hoofdstuktitels opgedeeld worden.

--disable-unwrap-lines

Verwijder harde regeleinden op basis van interpunctie en andere opmaak hints.

--enable-heuristics

Heuristische verwerking gebruiken. Zonder deze optie wordt geen enkele heuristische verwerking uitgevoerd.

--html-unwrap-factor

Schaal om te bepalen vanaf welke lengte harde regeleinden moeten worden verwijderd. Geldige waarde is een decimaal getal tussen 0 en 1. De standaardwaarde is 0.4, iets minder dan de mediaan van de regellengte. Als maar bij weinig regels de harde regeleinden hoeven worden verwijderd, kunt u beter een lagere waarde kiezen

--replace-scene-breaks

Vervang breekpunten door de aangegeven tekst. Standaard wordt de tekst uit het invoerbestand gebruikt.

ZOEK EN VERVANG

Wijzig de tekst en structuur van het document m.b.v. gebruiker-gedefinieerde patronen.

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

sr1 vervangen door.

Zoekpatroon (regexp) dat vervangen moet worden door sr1.

--sr2-replace

sr2 vervangen door.

Zoekpatroon (regexp) dat vervangen moet worden door sr2.

--sr3-replace

sr3 vervangen door.

Zoekpatroon (regexp) dat vervangen moet worden door sr3.

STRUCTUUR DETECTIE

Stel de auto-detectie van de documentstructuur in.

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

Specificeer hoe gedetecteerde hoofdstukken moeten worden gemarkeerd. Een waarde "pagebreak" zal een nieuwe pagina beginnen voor nieuwe hoofdstukken. Een waarde "rule" zal een streep toevoegen voor hoofdstukken. Een waarde "none" zal hoofdstukmarkering uitschakelen, en een waarde "both" zal zowel nieuwe pagina's als strepen gebruiken om hoofdstukken te markeren.

--disable-remove-fake-margins

In sommige documenten worden voor elke alinea apart linker- en rechtermarges opgegeven. calibre tracht deze te verwijderen, maar soms worden daardoor marges verwijderd die niet weg mogen. In dat geval kan margeverwijdering uitgeschakeld worden.

--insert-metadata

Insert the book metadata at the start of the book. This is useful if your e-book reader does not support displaying/searching metadata directly.

--page-breaks-before

Een XPath uitdrukking. Pagina splitsing wordt toegevoegd voor de aangegeven elementen. Om uit te schakelen gebruikt u de uitdrukking: /

--prefer-metadata-cover

Gebruik de in het bronbestand gedetecteerde omslag en niet de opgegeven omslag.

--remove-first-image

Remove the first image from the input e-book. Useful if the input document has a cover image that is not identified as a cover. In this case, if you set a cover in calibre, the output document will end up with two cover images if you do not specify this option.

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

INHOUDSOPGAVE

Configureer het automatisch aanmaken van de inhoudsopgave. Standaard zal, indien aanwezig, de inhoudsopgave van het invoerbestand gebruikt worden, in plaats van de automatisch aangemaakte inhoudsopgave.

Als een inhoudsopgave wordt gemaakt uit links in het invoer-bestand zijn

--level1-toc

XPath-expressie waarmee alle tags worden toegevoegd aan de inhoudsopgave op niveau een. Deze optie gaat boven andere vormen van auto-detectie. Zie ook de voorbeelden in de XPath-handleiding in de Calibre-handleiding.

--level2-toc

XPath-expressie waarmee alle tags worden toegevoegd aan de inhoudsopgave op niveau twee. Elke toevoeging komt onder de vorige vermelding op niveau een. Zie ook de voorbeelden in de XPath-handleiding in de Calibre-handleiding.

--level3-toc

XPath-expressie waarmee alle tags worden toegevoegd aan de inhoudsopgave op niveau drie. Elke toevoeging komt onder de vorige vermelding op niveau twee. Zie ook de voorbeelden in de XPath-handleiding in de Calibre-handleiding.

Maximaal aantal snelkoppelingen dat aan de inhoudsopgave toegevoegd mag worden. Gebruik 0 om uit te schakelen. Standaard is: 50. Snelkoppelingen worden alleen aan de inhoudsopgave toegevoegd als minder dan dit aantal hoofdstukken werd gedetecteerd.

--no-chapters-in-toc

Voeg geen automatisch gedetecteerde hoofdstukken aan de inhoudsopgave toe.

--toc-filter

Verwijder regels uit de inhoudsopgave waarvan de titels overeenkomen met de opgegeven reguliere uitdrukking. Overeenkomende regels en alle onderliggende regels worden verwijderd.

--toc-threshold

Als het aantal gedetecteerde hoofdstukken kleiner is dan dit getal worden links aan de inhoudsopgave toegevoegd. Standaard: 6

--use-auto-toc

Normaal gesproken wordt de inhoudsopgave van het invoerbestand gebruikt in plaats van een automatisch gemaakte inhoudsopgave. Met deze optie zal de automatisch aangemaakte versie altijd gebruikt worden.

METADATA

Opties om metadata voor de uitvoer in te stellen

--author-sort

De string die gebruikt wordt bij het sorteren op auteur.

--authors

Geef de auteurs op. Meerdere auteurs moeten met een ampersand (&) van elkaar gescheiden worden.

--book-producer

Geef de producent op.

--comments

Stel de e-book omschrijving in.

--cover

Stel de omslag in met het opgegeven bestand of URL

--isbn

Geef het ISBN van het boek op.

--language

De taal instellen.

--pubdate

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

--publisher

Stel de e-book uitgever in.

--rating

Waardering geven. Moet een getal tussen de 1 en 5 zijn.

--read-metadata-from-opf, --from-opf, -m

Lees metadata uit het opgegeven OPF-bestand. Metadata die hieruit worden gelezen krijgt voorrang over metadata uit het bronbestand.

--series

Stel de reeks in waartoe dit e-boek behoort.

--series-index

Geef de index van dit boek in de reeks op.

--tags

Geef de labels voor het boek op. Dit moet een door komma's gescheiden lijst zijn.

--timestamp

Maak tijdstempel voor boek (wordt nergens meer gebruikt)

--title

Geef de titel op.

--title-sort

De versie van de titel die wordt gebruikt bij het sorteren.

FOUTOPSPORING

Opties om te helpen bij het vinden van fouten bij de conversie

--debug-pipeline, -d

Bewaar de uitvoer van verschillende stadia van de conversielijn in de opgegeven map. Nuttig als u niet zeker weet tijdens welke stap in het conversieproces een fout optreedt.

--verbose, -v

Niveau van detail informatie uitvoer. Specifieer meerdere malen voor meer details. Indien het twee maal wordt meegegeven zal er een volledig detail gegeven worden, eenmaal medium details, en geen enkele keer de minimale details.