ebook-convert - ebook-convert
ebook-convert input_file output_file [alternativ]
Konvertera en e-bok från ett format till ett annat.
input_file är inmatningsfilen och output_file är
utmatningsfilen. Båda måste anges som de två
första argumenten i kommandot.
Utmatningsformatet för e-boken uppskattas utifrån
filändelsen i output_file. output_file kan även ges
specialformatet .EXT, där EXT är
utmatningsfilsändelsen. Om det används kommer namnet på
utmatningsfilen att härledas från namnet på
inmatningsfilen. Observera att filnamnen inte får börja med
bindestreck. Om ingen filinsticksmodul har angivits för
utmatningsfilen, så behandlas den som en katalog till vilken en
"Öppen e-bok" (OEB) bestående av HTML filer kommer
att skrivas. Dessa filer är de filer som normalt sett skulle ha
skickats till utmatningsinsticksmodulen.
Efter att ha angivit in- och utmatningsfilerna kan du anpassa
konverteringen genom att ange olika alternativ. Vilka alternativ som
är tillgängliga beror på in- och utmatningsfiltyperna.
För att få hjälp med dem, ange in- och
utmatningsfilerna och lägg därefter till alternativet -h.
För fullständig dokumentation om
konverteringssystemet, gå till conversion
När du skickar argument till ebook-convert som har
mellanslag i dem, bifoga argumenten i citattecken. Till exempel: "/some
path/with spaces"
Alternativen och standardvärden för
ändringsalternativ beror på både inmatning- och
utmatningsformat, därför bör du alltid kolla med:
ebook-convert myfile.input_format myfile.output_format -h
Nedan finns alternativen som är vanliga vid all
konvertering följt av alternativen unika för varje inmatning-
och utmatningsformat.
- ALTERNATIV FÖR INMATNING
- ALTERNATIV FÖR UTMATNING
- UTSEENDE OCH KÄNSLA
- HEURISTISK BEARBETNING
- SÖK OCH ERSÄTT
- STRUKTURDETEKTERING
- INNEHÅLLSFÖRTECKNING
- METADATA
- FELSÖK
- --input-profile
- Ange inmatningsprofilen. Profilen ger information till
konverteringssystemet om hur information i inmatning ska tolkas. Till
exempel upplösningsberoende längder (d.v.s. längder i
pixlar). Alternativen är:cybookg3, cybook_opus, default, hanlinv3,
hanlinv5, illiad, irexdr1000, irexdr800, kindle, msreader, mobipocket,
nook, sony, sony300, sony900
- --list-recipes
- Lista inbyggda receptnamn. Du kan skapa en e-bok från ett inbyggt
recept så här: ebook-convert
"Receptnamn.recipe" utmatning.epub
- --output-profile
- Ange utmatningsprofil. Utmatningsprofilen anger för
konverteringssystem hur optimering kan ske av det skapade dokumentet
för den angivna enheten (såsom ändring av bildstorlek
för enhetens skärmstorlek). I vissa fall kan en
utmatningsprofil användas för att optimera resultatet
för en viss enhet, men det är sällan
nödvändigt. Alternativen är: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
- visar programmets versionsnummer och avsluta
ALTERNATIV FÖR INMATNING
Alternativ för att anpassa bearbetningen av ingående
mobi fil
- --input-encoding
- Ange teckenkodning för inmatningsdokumentet. Det här
alternativet åsidosätter eventuell teckenkodning som
dokumentet själv anger. Särskilt användbart
för dokument som inte deklarerar en kodning eller som har felaktiga
kodningsdeklarationer.
ALTERNATIV FÖR UTMATNING
Alternativ för att anpassa bearbetningen av utmatning
epub
- --dont-split-on-page-breaks
- Inaktivera delning vid sidbrytningar. Normalt delas inmatningsfilen
automatiskt vid varje sidbrytning i två filer. Detta ger en utmatad
e-bok som kan tolkas snabbare och med mindre resurser. Att dela är
dock långsamt och om din källfil innehåller ett
mycket stort antal sidbrytningar bör du inaktivera delning vid
sidbrytning.
- --epub-flatten
- Det här alternativet behövs endast om du tänker
använda EPUB med FBReaderJ. Det plattar ut filsystemet inuti EPUB
och lägger alla filer i den översta nivån.
- --epub-inline-toc
- Infoga en innehållsförteckning som kommer att visas som en
del av bokens innehåll.
- --epub-toc-at-end
- Lägg den infogade innehållsförteckningen i slutet av
boken istället för i början.
- --epub-version
- Versionen av EPUB-filen som ska genereras. EPUB 2 är den mest
kompatibla, använd endast EPUB 3 om du vet att du faktiskt
behöver det.
- Packa upp innehållet i den genererade EPUB filen till den angivna
katalogen. Innehållet i katalogen först tas bort, så
var försiktig.
- --flow-size
- Dela alla HTML-filer som är större än denna storlek
(i KiB). Detta är nödvändigt eftersom de flesta
EPUB-läsenheter inte kan hantera stora filer. Standardvärdet
260KB är den storlek som krävs för Adobe Digital
Editions. Satt till 0 för stänga av storleksbaserad
delning.
- --no-default-epub-cover
- Om inmatningsfilen inte har något omslag och du inte anger ett,
skapas normalt ett standardomslag genererats med titel, författare,
o.s.v. Med det här alternativet aktiverat skapas inga
standardomslag.
- --no-svg-cover
- Använd inte SVG-grafik till omslag. Använd om din EPUB-fil
kommer att användas på enheter som inte stöder SVG,
t.ex. iPhone och JetBook Lite. Om det här alternativet inte
väljs, kommer dessa enheter att visa ett tomt omslag.
- --preserve-cover-aspect-ratio
- När man använder ett SVG-omslag kommer det här
alternativet att leda till att omslaget skalas om för att
täcka det tillgängliga skärmområdet, men
bevarar fortfarande dess bildförhållande
(förhållande mellan bredd och höjd). Det
innebär att det kan finnas vita kanter på sidorna eller
på toppen och botten av bilden, men bilden kommer aldrig att
förvrängas. Om det här alternativet inaktiveras, kan
bilden bli en aning förvrängd, men det kommer inte finnas
några ramar.
- --pretty-print
- Om detta anges, kommer insticksmodulen att försöka skapa
utskrifter som är så läsliga som möjligt.
Detta kanske inte har någon effekt för vissa instick
för utmatning.
- --toc-title
- Titel för alla genererade infogade
innehållsförteckningar.
Alternativ för att anpassa utmatningens utseende och
känsla
- --asciiize
- Translitterera Unicode-tecken till en ASCII-representation. Används
med försiktighet, eftersom detta kommer att ersätta
Unicode-tecken med ASCII. Till exempel kommer det att ersätta
"Михаил
Горбачёв"
med "Mikhail Gorbachiov". Tänk också
på att i de fall där det finns flera representationer av ett
tecken (exempelvis tecken som delas av kinesiska och japanska) kommer
representationen som grundar sig på aktuella
calibre-gränssnittsspråket att användas.
- --base-font-size
- Grundteckenstorleken i punkter. Alla teckenstorlekar i den producerade
boken kommer att skalas om baserat på den här storleken.
Genom att välja en större storlek kan du få
teckensnittet i utmatningen större och vice versa. Som standard,
när värdet är noll kommer grundteckenstorleken
för teckensnitt att väljas baserat på
utmatningsprofilen du väljer.
- --change-justification
- Ändra textjusteringen. Värdet
"vänster" konverterar all marginaljusterad
text i källan till vänsterjusterad text (d.v.s. ojusterad).
Med värdet "justera" konverteras all
ojusterad text till mariginaljusterad. Värdet
"original" (standard) behåller de
inställningar för justering som anges i källfilen.
Observera att endast vissa format stöder mariginaljustering.
- --embed-all-fonts
- Bädda in varje teckensnitt som refereras i inmatningsdokumentet som
inte redan är inbäddat. Detta kommer att söka i ditt
system efter teckensnitt och om de påträffas, kommer de att
bäddas in. Inbäddning fungerar bara om det format du
konverterar till stöder inbäddade teckensnitt, t.ex. EPUB,
AZW3, DOCX eller PDF. Se till att du har rätt licens för att
bädda in teckensnitt som används i detta dokument.
- --embed-font-family
- Bädda in den angivna teckensnittsfamiljen i boken. Här anges
"bas"-teckensnitt som används för
boken. Om inmatningsdokumentet specificerar sina egna teckensnitt, kan de
åsidosätta detta grundteckensnitt. Du kan använda
informationsalternativet filterformat för att ta bort teckensnitt
från inmatningsdokumentet. Observera att bädda in
teckensnitt endast fungerar med vissa utmatningsformat, främst
EPUB, AZW3 och DOCX.
- --expand-css
- Som standard kommer Calibre använda stenografiformen för
olika CSS-egenskaper såsom marginal, utfyllnad, kanter, etc. Det
här alternativet kommer att få den att använda hela
expanderade formen istället. Observera att CSS alltid är
expanderat vid generering av EPUB-filer med utgångsprofilen
inställd på en av Nook profiler eftersom Nook inte kan
hantera stenografi CSS.
- Antingen sökvägen till ett CSS-formatmall eller rå
CSS. Denna CSS läggs till i formatreglerna från
källfilen, så den kan användas för att
åsidosätta dessa regler.
- --filter-css
- En kommaseparerad lista över CSS-egenskaper som kommer att tas bort
från alla CSS-formatregler. Detta är användbart om
förekomsten av viss formatinformation förhindrar att den
åsidosätts på din enhet. Till exempel:
font-family,color,margin-left,margin-right
- --font-size-mapping
- Kartlägger CSS-teckensnittsnamn till teckenstorlekar i punkter. En
exempelinställning är 12,12,14,16,18,20,22,24. Detta
konverterar storlekarna xx-liten till xx-stor, den sista storleken
används för enorma teckensnitt. Omskalningsalgoritmen
använder dessa storlekar för att på ett smart
sätt skala om teckensnitten. Som standard används en
kartläggning baserad på din valda utmatningsprofil.
- --insert-blank-line
- Infoga en blankrad mellan stycken. Fungerar inte om källfilen inte
använder stycken (<p>-eller <div>- markeringar).
- --insert-blank-line-size
- Ställ in höjden på infogade tomma rader (i EM).
Höjden på raderna mellan punkterna blir det dubbla av
värdet som ställs in här.
- --keep-ligatures
- Bevara ligaturer som finns i inmatningsdokumentet. En ligatur är en
speciell framställning ett teckenpar som ff, fi, fl och så
vidare. De flesta läsenheter saknar stöd för
ligaturer i deras standardteckensnitt så det är osannolikt
att de återges korrekt. Som standard konverterar calibre en ligatur
till motsvarande par av vanliga tecken. Det här alternativet kommer
att bevara ligaturerna istället.
- --line-height
- Radavståndet i punkter. Anpassar avståndet mellan på
varandra följande textrader. Gäller endast element som inte
definierar sitt eget radavstånd. I de flesta fall är det
minsta radavståndet valet mer användbart. Som standard
utför ingen ändring i radavstånd.
- --linearize-tables
- Vissa dokument med dålig formgivning använder tabeller
för att anpassa textflödet på sidan. När dessa
dokument konverteras finns ofta text som går utanför sidan
och andra artefakter. Det här alternativet kommer att packa upp
innehållet från tabellerna och presentera det
linjärt.
- --margin-bottom
- Ställ in nedre marginalen i punkter. Standard är 5.0. Om du
ställer in det här till mindre än noll kommer ingen
marginal att ställas in (marginalinställningen i
originaldokumentet bevaras). Observera: Sidorienterade format som PDF och
DOCX har egna marginalinställningar som har
företräde.
- --margin-left
- Ställ in vänstra marginalen i punkter. Standard är
5.0. Om du ställer in det här till mindre än noll
kommer ingen marginal att ställas in (marginalinställningen
i originaldokumentet bevaras). Observera: Sidorienterade format som PDF
och DOCX har egna marginalinställningar som har
företräde.
- --margin-right
- Ställ in högra marginalen i punkter. Standard är 5.0.
Om du ställer in det här till mindre än noll kommer
ingen marginal att ställas in (marginalinställningen i
originaldokumentet bevaras). Observera: Sidorienterade format som PDF och
DOCX har egna marginalinställningar som har
företräde.
- --margin-top
- Ställ in övre marginalen i punkter. Standard är 5.0.
Om du ställer in det här till mindre än noll kommer
ingen marginal att ställas in (marginalinställningen i
originaldokumentet bevaras). Observera: Sidorienterade format som PDF och
DOCX har egna marginalinställningar som har
företräde.
- --minimum-line-height
- Den minsta radavståndet, som andel av elementets beräknat
m.h.a. teckenstorlek. calibre kommer att säkerställa att
varje element har en radavstånd av minst denna inställning,
oavsett vad det ingående dokument specificerar. Sätt till
noll för att inaktivera. Standard är 120%. Använd den
här inställningen istället för det direkt
angivna radavståndet såvida inte du vet vad du gör.
Till exempel kan du uppnå "dubbelt
radavstånd" i texten genom att sätta detta till
240.
- --remove-paragraph-spacing
- Ta bort avståndet mellan styckena. Drar även in
första raden på det nya stycket med 1,5 em.
Avståndsavlägsnande fungerar inte om källfilen inte
använder stycken (<p> eller <div> taggar).
- --remove-paragraph-spacing-indent-size
- När calibre tar bort tomma rader mellan stycken, anger det
automatiskt ett styckeindrag, för att se till att styckeindelningen
syns tydligt. Det här alternativet bestämmer bredden
för indraget (i em). Om du anger ett negativt värde kommer
indraget som anges i inmatningsdokumentet användas, det vill
säga, calibre ändrar inte indraget.
- --smarten-punctuation
- Konvertera rena citat, bindestreck och ellips till deras typografiskt
korrekta motsvarigheter. För detaljer, se
https://daringfireball.net/projects/smartypants
- --subset-embedded-fonts
- Använd delmängd av alla inbäddade teckensnitt. Varje
inbäddat teckensnitt reduceras till endast innehålla de
glyfer som används i detta dokument. Detta minskar storleken
på teckensnittsfiler. Användbart om du bäddar in ett
särskilt stort teckensnitt med massor av oanvända
glyfer.
- --transform-css-rules
- Sökvägen till en fil som innehåller regler för
att förändra CSS-format i denna bok. Det enklaste
sättet att skapa en sådan fil är att använda
guiden för att skapa regler i calibre gränssnittet.
Gå till det i "Utseende och känsla->Omvandla
format" avsnittet i konverteringsdialogrutan. När du
har skapat reglerna, kan du använda knappen
"Exportera" för att spara dem till en
fil.
- --unsmarten-punctuation
- Konvertera snitsiga citat, streck och specialtecken till deras
motsvarigheter i vanlig text.
Ändra dokumenttexten och strukturen med vanliga
mönster. Inaktiverad som standard. Använd --enable-heuristics
för att aktivera. Individuella åtgärder kan inaktiveras
med alternativen --disable-
*
.
- --disable-dehyphenate
- Analysera avstavade ord i hela dokumentet. Själva dokumentet
används som en ordlista för att avgöra om bindestreck
ska behållas eller tas bort.
- --disable-fix-indents
- Vändningsindrag som skapats från flera icke-brytande
mellanslag enheter i CSS indrag.
- --disable-format-scene-breaks
- Vänsterjusterade scenbrytningsmarkörer är centrerade.
Ersätt mjuka scenbrytningar som använder flera tomma rader
med horisontella linjer.
- --disable-markup-chapter-headings
- Identifiera oformaterade huvud- och underrubriker. Ändra dem till
H2- och H3-taggar. Den här inställningen kommer inte att
skapa en innehållsförteckning, men kan användas i
kombination med strukturidentifiering för att skapa ett.
- --disable-renumber-headings
- Letar efter förekomster av sekventiella <h1> eller
<h2>-taggar. Taggarna ska numreras för att förhindra
uppdelning i mitten av kapitelrubrikerna.
- --enable-heuristics
- Aktivera heuristisk bearbetning. Denna möjlighet måste anges
för någon heuristisk bearbetning ske.
- --html-unwrap-factor
- Skala som används för att bestämma längden
på vilken en rad ska radbrytas. Giltiga värden är ett
decimaltal mellan 0 och 1. Standard är 0,4, precis under
medianlinjelängden. Om bara några få rader i
dokumentet kräver radbrytning bör detta värde
minskas
- --replace-scene-breaks
- Ersätt scenbrytningar med den angivna texten. Som standard
är texten från inmatningsdokumentet som används.
Ändra dokumenttexten och strukturen med
användardefinierade mönster.
- --search-replace
- Sökvägen till en fil som innehåller reguljära
uttryck för att söka och ersätta. Filen måste
innehålla alternerande rader av reguljära uttryck
följt av ersättande mönster (vilket kan vara en tom
rad). Det reguljära uttrycket ska vara i Python-regex-syntax och
filen måste vara UTF-8-kodad.
- --sr1-replace
- Ersättning för att ersätta texten som hittades med
SR1-sökning.
- --sr1-search
- Sökmönster (reguljära uttryck) att ersätta med
SR1-ersättning.
- --sr2-replace
- Ersättning för att ersätta texten funnen med
SR2-sökning.
- --sr2-search
- Sökmönster (reguljära uttryck) att ersätta med
SR2-ersättning.
- --sr3-replace
- Ersättning för att ersätta texten hittades med
SR3-sökning.
- --sr3-search
- Sökmönster (reguljära uttryck) att ersätta med
SR3-ersättning.
Anpassa automatisk identifiering av dokumentets struktur.
- --chapter
- Ett XPath-uttryck för att upptäcka kapitelrubrikerna.
Standardinställningen är att överväga
<h1>- eller <h2>-markeringar som innehåller orden
"chapter", "book",
"section", "prologue",
"epilogue" eller "part"
som kapitelrubriker samt eventuella markeringar som har
class="chapter". Uttrycket som används
måste utvärderas till en lista med element. För att
inaktivera upptäckt av kapitel, använd uttrycket
"/". Se XPath-introduktionen i
användarhandboken för calibre för ytterligare
hjälp med att använda den här funktionen.
- --chapter-mark
- Anger hur upptäckta kapitel markeras. Värdet
"pagebreak" infogar en sidbrytning före
kapitel. Värdet "rule" infogar en blankrad
före kapitel. Värdet "none"
inaktiverar kapitelmarkering och om värdet
"both" anges kommer både sidbrytningar och
blankrader att markera kapitel.
- --disable-remove-fake-margins
- Vissa dokument anger sidmarginaler genom att ange en vänster- och
höger marginal på varje enskild punkt. calibre kommer att
försöka upptäcka och ta bort dessa marginaler. Ibland
kan detta orsaka avlägsnande av marginaler som inte borde ha tagits
bort. I detta fall kan du inaktivera borttagning.
- --insert-metadata
- Infoga bokens metadata i början av boken. Används om din
läsenhet inte kan visa eller söka efter metadata
direkt.
- --page-breaks-before
- Ett XPath-uttryck. Sidbrytningar infogas före de angivna elementen.
För att inaktivera använd uttrycket: /
- --remove-first-image
- Ta bort den första bilden från den inmatade e-boken.
Praktiskt om inmatningsdokumentet har en omslagsbild som inte identifieras
som ett omslag. Om du anger ett omslag i calibre kommer det resulterande
dokumentet ha två omslagsbilder om du inte markerar det här
alternativet.
- --start-reading-at
- Ett XPath-uttryck för att upptäcka den plats i dokumentet
där du vill börja läsa. Vissa
e-bokläsarprogram (framförallt Kindle) använder denna
plats som position för att öppna boken. Se
XPath-introduktionen i användarhandboken för calibre
för ytterligare hjälp med att använda den här
funktionen.
Anpassa hur innehållsförteckningen genereras. Om
källfilen har en innehållsförteckning, kommer denna att
användas istället för den automatiskt genererade.
- --duplicate-links-in-toc
- När du skapar en innehållsförteckning från
länkar i inmatningsdokumentet, tillåt dubbla poster, d.v.s.
tillåt mer än en post med samma text, förutsatt att
de pekar på en annan plats.
- --level1-toc
- XPath-uttryck som anger alla markeringar som ska läggas till i
innehållsförteckningen på nivå ett. Om detta
anges, får de prioritet över andra former av automatisk
detektering. Se XPath-introduktionen i användarhandboken för
calibre för exempel.
- --level2-toc
- XPath-uttryck som anger alla markeringar som ska läggas till i
innehållsförteckningen på nivå två.
Varje post läggs till under den tidigare nivån en post. Se
XPath-introduktionen i användarhandboken för calibre
för exempel.
- --level3-toc
- XPath-uttryck som anger alla markeringar som ska läggas till i
innehållsförteckningen på nivå tre. Varje post
läggs till under den tidigare nivån två post. Se
XPath introduktionen i användarhandboken för calibre
för exempel.
- --max-toc-links
- Högst antal länkar för att infoga i
innehållsförteckningen. Ställ in på 0
för att inaktivera. Standard är: 50. Länkarna
läggs endast till innehållsförteckningen om antalet
upptäckta kapitel är lägre än
tröskelvärdet.
- --toc-filter
- Ta bort poster från innehållsförteckningen vilkas
titlar matchar det angivna reguljära uttrycket. Matchande poster
och alla deras skapelser tas bort.
- --toc-threshold
- Om färre än detta antal kapitel identifieras, så
läggs länkar i innehållsförteckningen.
Default: 6
- --use-auto-toc
- Om källfilen redan har en innehållsförteckning,
används normalt denna i stället för den automatiskt
genererade. Med det här alternativet används alltid den
automatiskt genererade.
Alternativ för att ställa in metadata i
utmatning
- --authors
- Ange författarna. Flera författare ska avgränsas med
&-tecken.
- --cover
- Ange omslag till angivna filer eller URL
- --pubdate
- Ange publiceringsdatum (antas vara i den lokala tidszonen, såvida
inte tidszonen uttryckligen anges)
- --rating
- Ange betyg. Bör vara ett nummer mellan 1 och 5.
- --series
- Ange serien denna e-bok tillhör.
- --series-index
- Ange bokens index i denna serie.
- --tags
- Ange taggar för boken. Skall vara en kommaseparerad lista.
- --timestamp
- Ange bokens tidsstämpel (används inte längre
någonstans)
- --title-sort
- Versionen av titeln som ska användas för sortering.
Alternativ för att hjälpa till att felsöka
konverteringen
- --debug-pipeline,
-d
- Spara utmatning från olika skeden av konverteringssekvensen till
den angivna mappen. Användbart om du är osäker i
vilket skede av konverteringsprocessen ett problem uppstår.
- --verbose,
-v
- Nivå på informationsnivån. Ange flera gånger
för ökad informationsnivå. Att ange den två
gånger resulterar i full informationsnivån, en gång i
medelinformationsnivån och noll gånger i minsta
nivån.