ebook-convert - ebook-convert
ebook-convert input_file output_file [options]
Conversió d'un format de llibre a un altre.
input_file és el fitxer d'entrada i output_file el de
sortida. S'han d'especificar els dos com als primers dos arguments de
l'ordre.
El format de llibre de sortida es dedueix de l'extensió
d'output_file. output_file també pot ser del format especial .EXT on
EXT és l'extensió del fitxer de sortida. En aquest cas, el nom
del fitxer de sortida es deriva del nom del fitxer d'entrada. Tingueu en
compte que els noms de fitxer no poden començar amb un guió.
Per acabar, si output_file no té extensió, es tracta com una
carpeta i es desa un "open book" (OEB) format per fitxers HTML a
la carpeta. Aquests fitxers són els que normalment haurien passat al
connector de sortida.
Després d'especificar el fitxer d'entrada i de sortida
podeu personalitzar la conversió especificant diverses opcions. Les
opcions disponibles depenen dels tipus de fitxer d'entrada i de sortida. Per
obtenir ajuda d'això, especifiqueu el fitxer d'entrada i de sortida
amb l'opció -h.
Per a la documentació completa del sistema de
conversió vegeu conversion
Sempre que passeu arguments a ebook-convert i aquests
tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple:
"/some path/with spaces"
Les opcions i els valors predeterminats per al canvi d'opcions
depenen del format d'entrada com del format de sortida, per tant, sempre
és possible comprovar-ho amb:
ebook-convert myfile.input_format myfile.output_format -h
A continuació es detallen les opcions comunes a totes les
conversions, seguides per les opcions específiques de cada format
d'entrada i de sortida.
- OPCIONS D'ENTRADA
- OPCIONS DE SORTIDA
- APARENÇA
- PROCESSAMENT HEURÍSTIC
- CERCA I SUBSTITUCIÓ
- DETECCIÓ DE L'ESTRUCTURA
- TAULA DEL CONTINGUT
- METADADES
- DEPURACIÓ
- --input-profile
- Especifica el perfil d'entrada. El perfil d'entrada
proporciona informació al sistema de conversió de com
interpretar informació diversa del document d'entrada. Per
exemple, longituds depenent de la resolució (longitud en
píxels). Les opcions són:cybookg3, cybook_opus, default,
hanlinv3, hanlinv5, illiad, irexdr1000, irexdr800, kindle, msreader,
mobipocket, nook, sony, sony300, sony900
- --list-recipes
- Llista els noms de les receptes integrades. Podeu crear un llibre
electrònic a partir d'una recepta integrada així:
«Nom de la recepta.recipe» sortida.epub
- --output-profile
- Especifica el perfil de sortida. El perfil de sortida li diu al sistema de
conversió com ha d'optimitzar el document creat per al
dispositiu especificat (com ara amb el canvi de mida de les imatges per a
la mida de pantalla del dispositiu). En alguns casos es pot utilitzar un
perfil de sortida per optimitzar la sortida per a un dispositiu
particular, però no sol ser necessari. Les opcions
són: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
- mostra el número de versió del programa i surt
Opcions per controlar el processament del fitxer d'entrada
mobi
- --input-encoding
- Especifiqueu la codificació de caràcters del document
d'entrada. Aquesta opció anul·larà qualsevol
codificació que pugui estar indicada al document. És
particularment útil per a documents que no indiquen cap
codificació o ho fan incorrectament.
Opcions per a controlar el processament de la sortida epub
- --dont-split-on-page-breaks
- Desactiva les divisions als salts de línia. Normalment, els fitxers
d'entrada es divideixen en dos automàticament a cada salt de
pàgina. Així s'obté un llibre
electrònic que es pot analitzar més ràpidament i amb
menys recursos. La divisió però, és lenta i si el
vostre fitxer d'origen conté un gran nombre de salts de
pàgina, hauríeu de desactivar la divisió als salts de
pàgina.
- --epub-flatten
- Només es necessita aquesta opció si voleu utilitzar
l'EPUB amb FBReaderJ. Aplanarà el sistema de fitxers de dins
l'EPUB i posarà tots els fitxers al nivell superior.
- --epub-inline-toc
- Insereix una taula del contingut en línia que apareixerà com
a part del contingut principal del llibre.
- --epub-toc-at-end
- Posa la taula del contingut en línia inserida al final del llibre
en lloc del començament.
- --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.
- Extreu el contingut del fitxer EPUB generat al directori especificat.
Compte, abans s'esborrarà el contingut del directori.
- --flow-size
- Divideix tots els fitxers HTML més grans d'aquesta mida (en
KB). Això és necessari, ja que la majoria de lectors EPUB no
poden gestionar fitxers grans. El valor per defecte de 260KB, que
és la mida requerida per Adobe Digital Editions. Establiu-ho a 0,
per a inhabilitar la divisió en funció de la mida.
- --no-default-epub-cover
- Si el fitxer d'entrada no té portada i no
n'especifiqueu cap, es genera una portada per defecte amb
títol, autors... Aquesta opció inhabilita la
generació d'aquesta portada.
- --no-svg-cover
- No utilitzis cap portada SVG. Utilitzeu aquesta opció si el vostre
EPUB s'utilitzarà en un dispositiu que no té suport
per a SVG, com ara l'iPhone o el JetBook Lite. Sense aquesta
opció, aquests dispositius mostraran una portada en blanc.
- --preserve-cover-aspect-ratio
- Quan s'utilitza una portada SVG, aquesta opció fa que
s'escali per cobrir l'àrea de pantalla disponible,
però encara preservarà la seva relació
d'aspecte (relació entre l'amplada i
l'altura). Això significa que pot haver bores blanques als
costats o a la part superior i inferior de la imatge, però la
imatge mai es distorsiona. Sense aquesta opció, la imatge pot estar
una mica distorsionada, però no hi haurà bores.
- --pretty-print
- Si s'especifica, el connector de sortida intentarà generar
una sortida que sigui el més llegible possible. Pot ser que no
tingui cap efecte en alguns connectors de sortida.
- --toc-title
- Títol per a qualsevol taula del contingut generada
automàticament.
Opcions per controlar l'aparença de la sortida
- --asciiize
- Transcriu els caràcters unicode a una representació ASCII.
Utilitzeu-ho amb compte perquè això substituirà els
caràcters amb ASCII. Per exemple, substituirà
«Михаил
Горбачёв»
per «Mikhail Gorbachiov». Tingueu també en compte que
en casos que hi ha diverses representacions d'un caràcter
(per exemple caràcters compartits pel xinès i el
japonès) s'utilitzarà la representació basada
en la llengua actual de la interfície de calibre.
- --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
- Modifica el valor d'alineació del text. El valor
«esquerra» converteix l'alineació de tot el
text de l'origen en text alineat a l'esquerra (no
justificat). El valor «justificat» converteix tot el text no
justificat en text justificat. El valor «original» (per
defecte) no modifica l'alineació del fitxer d'origen.
Només alguns formats de sortida són compatibles amb
l'alineació.
- --embed-all-fonts
- Incrusta cadascuna de les lletres referenciades al document
d'entrada que encara no estan incrustades. Es farà una cerca
de les lletres al sistema i, si es troben, s'incrustaran. La
incrustació només funciona si el format que esteu convertint
és compatible amb lletres incrustades, com ara EPUB, AZW3 o PDF.
Assegureu-vos que teniu la llicència adequada per a la
incrustació de les lletres utilitzades en aquest document.
- --embed-font-family
- Incrusta la família de la lletra especificada al llibre.
Això especifica la lletra «base» que
s'utilitza per al llibre. Si el document d'entrada
especifica les seves pròpies lletres, es poden substituir amb
aquesta lletra base. Podeu utilitzar l'opció de la
informació del filtre d'estils per suprimir lletres del
document d'entrada. Tingueu en compte que la incrustació de
lletres només funciona amb alguns formats de sortida, principalment
EPUB, AZW3 i DOCX.
- --expand-css
- Per defecte, calibre utilitza la forma abreujada per a diverses propietats
CSS, com ara «margin», «padding»,
«border», etc. Aquesta opció farà que
s'utilitzi la forma estesa. Tingueu en compte que el CSS
s'expandeix sempre quan es generen els fitxers EPUB amb el perfil
de sortida establert a un dels perfils Nook, ja que els Nook no poden
gestionar el CSS abreujat.
- Qualsevol camí a un full d'estil CSS o CSS en brut. Aquest
CSS s'annexarà a les regles d'estil del fitxer
d'origen, així es pot utilitzar per anul·lar aquelles
regles.
- --filter-css
- Una llista separada per comes de propietats CSS que se suprimiran de totes
les regles d'estil CSS. És útil si la
presència d'alguna informació d'estil no
permet la substitució al vostre dispositiu. Per exemple:
font-family,color,margin-left,margin-right
- --font-size-mapping
- Mapatge a partir dels noms de les lletres del CSS en mides de lletres en
punts. Un exemple d'establiment és 12,12,14,16,18,20,22,24.
Aquests són els mapatges per a les mides des de xx-petita fins a
xx-gran, amb una mida final per a les lletres enormes. L'algorisme
de canvi d'escala de la lletra utilitza aquestes mides per a un
canvi intel·ligent d'escala de les lletres. Per defecte
s'utilitza un mapatge basat en el perfil de sortida que heu
triat.
- --insert-blank-line
- Insereix una línia en blanc entre paràgrafs. No funciona si
el fitxer d'origen no indica els paràgrafs (amb les
etiquetes <p> o <div>).
- --insert-blank-line-size
- Estableix l'alçada de les línies en blanc inserides
(en unitats em). L'alçada de les línies entre
paràgrafs serà el doble del valor que s'estableixi
aquí.
- --keep-ligatures
- Preserva les lligadures presents al document d'entrada. Una
lligadura és una renderització especial d'un parell
de caràcters com ara ff, fi, fl.... La majoria dels lectors no
admeten les lligadures en les seves lletres predeterminades, per aquest
motiu és poc probable que les renderitzin correctament. Per
defecte, calibre canvia una lligadura pel seu parell corresponent de
caràcters normals. Aquesta opció fa que les lligadures en
preservin en lloc seu.
- --line-height
- L'alçada de línia en punts. Controla l'espaiat
entre línies consecutives de text. Només s'aplica a
elements que no defineixen la seva alçada de línia. A la
majoria de casos és més útil l'opció de
l'alçada mínima de línia. Per defecte no es
manipula l'alçada de línia.
- --linearize-tables
- Alguns documents mal dissenyats utilitzen taules per controlar la
disposició del text a la pàgina. Quan es converteixen sovint
hi ha desplaçaments del text fora de la pàgina i altres
artefactes. Aquesta opció extreu el contingut de les taules i el
presenta de forma lineal.
- --margin-bottom
- Estableix el marge inferior en pts. Per defecte és 5.0. Establir-lo
en menys de zero farà que no hi hagi marge (els ajusts del marge
del document original es conservaran). Atenció: Els formats
orientats a pàgines, com PDF o DOCX, tenen els seus propis ajusts
del marge i aquests tenen preferència.
- --margin-left
- Estableix el marge esquerre en pts. Per defecte és 5.0. Establir-lo
en menys de zero farà que no hi hagi marge (els ajusts del marge
del document original es conservaran). Atenció: Els formats
orientats a pàgines, com PDF o DOCX, tenen els seus propis ajusts
del marge i aquests tenen preferència.
- --margin-right
- Estableix el marge dret en pts. Per defecte és 5.0. Establir-lo en
menys de zero farà que no hi hagi marge (els ajusts del marge del
document original es conservaran). Atenció: Els formats orientats a
pàgines, com PDF o DOCX, tenen els seus propis ajusts del marge i
aquests tenen preferència.
- --margin-top
- Estableix el marge superior en pts. Per defecte és 5.0. Establir-lo
en menys de zero farà que no hi hagi marge (els ajusts del marge
del document original es conservaran). Atenció: Els formats
orientats a pàgines, com PDF o DOCX, tenen els seus propis ajusts
del marge i aquests tenen preferència.
- --minimum-line-height
- L'alçada mínima de la línia, com a un
percentatge de la mida de la lletra calculada de l'element. Calibre
s'assegurarà que cada element tingui una alçada de
línia d'almenys aquest ajust, independentment del que
especifiqui el document d'entrada. Zero per a inhabilitar-ho. Per
defecte és 120%. Utilitzeu aquest ajust en lloc de
l'especificació directa de l'alçada de la
línia, llevat que sapigueu el que esteu fent. Per exemple, podeu
assolir text a «doble espai» amb l'establiment del
valor a 240.
- --remove-paragraph-spacing
- Elimina l'espaiament entre paràgrafs. També insereix
un sagnat als paràgrafs d'1.5 em. L'eliminació
de l'espaiament no funcionarà si el fitxer d'origen
no conté paràgrafs (amb les etiquetes <p> o
<div>).
- --remove-paragraph-spacing-indent-size
- Quan calibre suprimeix les línies en blanc entre paràgrafs,
estableix automàticament un sagnat per assegurar-se que es puguin
distingir bé els paràgrafs. Aquesta opció controla
l'amplada del sagnat (en unitats em). Si s'estableix un
valor negatiu, s'utilitza el sagnat especificat al document
d'entrada, és a dir, calibre no canvia el sagnat.
- --smarten-punctuation
- Converteix les cometes, els guions i els punts suspensius als seus
equivalents tipogràfics correctes. Vegeu
https://daringfireball.net/projects/smartypants per a més
detalls
- --subset-embedded-fonts
- Subconjunt de totes les lletres incrustades. Es redueixen totes les
lletres incrustades perquè només continguin els
caràcters utilitzats al document. Això redueix la mida dels
fitxers de les lletres. És útil si incrusteu una lletra
especialment gran amb molts caràcters que no
s'utilitzen.
- --transform-css-rules
- Camí al fitxer que conté les regles per transformar els
estils CSS del llibre. La manera més fàcil de crear aquest
tipus de fitxer és utilitzar l'assistent de creació
de regles a la interfície gràfica d'usuari. Podeu
accedir-hi a la secció del diàleg de conversió a
«Aparença->Transformació dels estils». Un
cop hàgiu creat les regles, empreu el botó
«Exporta» per desar-les en un fitxer.
Modifica el text i l'estructura del document utilitzant patrons
habituals. Inhabilitat per defecte. Utilitzeu --enable-heuristics per
habilitar-ho. Es pot inhabilitar les accions individuals amb les opcions
--disable-
*
.
- --disable-dehyphenate
- Analitza les paraules amb guió de tot el document.
S'utilitza el mateix document com a diccionari per determinar si
s'han de mantenir o suprimir els guions.
- --disable-format-scene-breaks
- Els marcadors de salt d'escena alineats a l'esquerra se
centren. Se suprimeixen els salts d'escena amb diverses
línies en blanc per línies horitzontals.
- --disable-markup-chapter-headings
- Detecta els encapçalaments i els sub-encapçalaments sense
format dels capítols i canvia'ls a etiquetes h2 i h3. Aquest
ajust no crearà una taula del contingut, però es pot
utilitzar conjuntament amb la detecció de l'estructura per
crear-ne una.
- --disable-renumber-headings
- Cerca la presència de seqüències d'etiquetes
<h1> o <h2>. Es torna a numerar les etiquetes per evitar una
divisió al mig dels encapçalaments dels
capítols.
- --enable-heuristics
- Habilita el processament heurístic. S'ha d'activar
aquesta opció per tal de poder fer qualsevol processament
heurístic.
- --html-unwrap-factor
- Escala utilitzada per determinar la longitud en què s'ha de
suprimir el salt de línia. Els valors vàlids són un
decimal entre 0 i 1. El valor per defecte és 0.4, just per sota de
la longitud mitjana de la línia. Si únicament hi ha molt
poques línies al document que requereixin la supressió del
salt de línia, aleshores s'hauria de reduir aquest
valor
- --replace-scene-breaks
- Reemplaça els salts d'escena pel text especificat. Per
defecte s'utilitza el text del document d'entrada.
Modifica el text i l'estructura del document mitjançant els
patrons definits per l'usuari.
- --search-replace
- Camí a un fitxer que conté les expressions regulars de cerca
i substitució. El fitxer ha de contenir línies alternants
d'expressions regulars seguides per un patró de
substitució (que pot ser una línia buida).
L'expressió regular ha de ser expressions regulars de Python
i han d'estar codificades en UTF-8.
- --sr1-replace
- Text de substitució del que es trobi amb sr1-search.
- --sr1-search
- Patró de cerca (expressió regular) que se substituirà
per sr1-replace.
- --sr2-replace
- Text de substitució del que es trobi amb sr2-search.
- --sr2-search
- Patró de cerca (expressió regular) que se substituirà
per sr2-replace.
- --sr3-replace
- Text de substitució del que es trobi amb sr3-search.
- --sr3-search
- Patró de cerca (expressió regular) que se substituirà
per sr3-replace.
Controla l'autodetecció de l'estructura del document.
- --chapter
- Una expressió XPath per detectar títols de capítols.
Per defecte, s'assumeix que les etiquetes <h1> o <h2>
contenen les paraules «capítol»,
«llibre», «secció»,
«pròleg», «epíleg» o
«part» com a títols de capítol, així
com qualsevol etiqueta que tingui class=«capítol».
L'expressió que s'utilitzi ha d'equivaler a
una llista d'elements. Per desactivar la detecció de
capítols, utilitzeu l'expressió «/».
Vegeu l'assistent de XPath al manual d'usuari de calibre per
a més informació.
- --chapter-mark
- Especifica com s'ha de marcar els capítols detectats. El
valor «pagebreak» insereix un salt de pàgina abans
dels capítols. El valor «rule» insereix una
línia abans dels capítols. El valor «none»
inhabilita les marques dels capítols i el valor
«both» insereix un salt de pàgina i una línia
per marcar els capítols.
- --disable-remove-fake-margins
- Alguns documents especifiquen els marges de pàgina amb un marge a
la dreta i a l'esquerra per a cada paràgraf. Calibre pot
intentar detectar i suprimir aquests marges. A vegades es poden suprimir
marges que no s'haurien d'haver eliminat, en aquest cas es
pot inhabilitar la supressió.
- --insert-metadata
- Insereix les metadades del llibre a l'inici. Això és
útil si el vostre lector de llibres electrònics no disposa
de cerca o visualització de metadades directament.
- --page-breaks-before
- Una expressió XPath. S'insereixen salts de pàgina
abans dels elements especificats. Per inhabilitar-ho utilitzeu
l'expressió: /
- --prefer-metadata-cover
- Estableix la portada detectada al fitxer d'origen de forma
preferent a la portada indicada.
- --remove-first-image
- Elimina la primera imatge del llibre seleccionat. És útil si
el document seleccionat té una imatge de portada que no està
marcada com a tal. En aquest cas, si no s'estableix una portada a
calibre, el document resultant en tindrà dues, llevat que
s'especifiqui aquesta opció.
- --start-reading-at
- Una expressió XPath per detectar el lloc del document on
s'ha de començar la lectura. Alguns programes de lectura (el
més remarcable el Kindle) utilitzen aquest lloc com a la
posició que s'ha d'obrir el llibre. Vegeu
l'assistent de XPath al manual d'usuari de calibre per a
més informació.
Controla la generació automàtica de la taula del
contingut. Si el fitxer d'origen conté una taula del contingut,
s'utilitzarà preferentment aquest en lloc del generat
automàticament.
- --duplicate-links-in-toc
- Quan es crea una taula del contingut a partir dels enllaços al
document d'entrada permet que hi hagin entrades duplicades,
és a dir, permet més d'una entrada amb el mateix
text, sempre que apuntin a una ubicació diferent.
- --level1-toc
- Expressió XPath que especifica totes les etiquetes s'han
d'afegir al primer nivell de la taula del contingut. Si
s'especifica, té prioritat sobre les altres formes de
detecció automàtica. Vegeu alguns exemples a la guia
d'aprenentatge de XPath del manual d'usuari de calibre.
- --level2-toc
- Expressió XPath que especifica totes les etiquetes s'han
d'afegir al segon nivell de la taula del contingut. Cada entrada
s'afegeix a sota de l'entrada de primer nivell
prèvia. Vegeu alguns exemples a la guia d'aprenentatge de
XPath del manual d'usuari de calibre.
- --level3-toc
- Expressió XPath que especifica totes les etiquetes s'han
d'afegir al tercer nivell de la taula del contingut. Cada entrada
s'afegeix a sota de l'entrada de segon nivell prèvia.
Vegeu alguns exemples a la guia d'aprenentatge de XPath del manual
d'usuari de calibre.
- --max-toc-links
- Nombre màxim d'enllaços per afegir a la taula del
contingut. Establiu-lo a 0 per a inhabilitar-ho. Per defecte és:
50. Els enllaços s'afegeixen a la taula del contingut si es
detecta menys capítols que el nombre d'aquest llindar.
- --toc-filter
- Suprimeix les entrades de la taula del contingut quan els seus
títols coincideixin amb l'expressió indicada. Se
suprimiran les entrades coincidents i els seus subapartats.
- --toc-threshold
- Si el nombre de capítols detectats és menor que aquest
s'afegeixen els enllaços a la taula del contingut. Per
defecte 6
- --use-auto-toc
- Normalment s'utilitza preferentment la taula del contingut del
fitxer d'origen, si existeix, al generat automàticament. Amb
aquesta opció sempre s'utilitza el generat
automàticament.
Opcions per assignar metadades a la sortida
- --author-sort
- La cadena que s'utilitzarà en l'ordenació per
autor.
- --authors
- Estableix els autors. Si hi ha diversos autors, s'han de separar
amb una "&".
- Estableix la descripció del llibre.
- --cover
- Estableix la portada a partir del fitxer o URL especificat
- --isbn
- Estableix l'ISBN del llibre.
- --pubdate
- Estableix la data de publicació (s'assumeix que és
zona horària local, llevat que s'especifiqui una altra
explícitament)
- --rating
- Estableix la valoració. Ha de ser un nombre entre 1 i 5.
- --series
- Estableix la sèrie que pertany el llibre.
- --series-index
- Estableix l'índex del llibre en aquesta sèrie.
- --tags
- Estableix les etiquetes per al llibre. Ha de ser una llista separada per
comes.
- --timestamp
- Estableix la marca horària del llibre (ja no s'utilitza
enlloc més)
- --title-sort
- La versió del títol que s'utilitzarà per a
l'ordenació.
Opcions per ajudar a la depuració de la
conversió
- --debug-pipeline,
-d
- Desa la sortida de les diferents etapes de la canonada de conversió
al directori especificat. És útil si no esteu segur en quina
etapa del procés de conversió hi ha un error.
- --verbose,
-v
- Nivell de detall. Augmenteu-ho per aconseguir més detall. Si
s'augmenta dues vegades dóna com a resultat detall complet,
una vegada, detall mitjà, i cap resulta en el menor detall.