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 folder and an "open e-book" (OEB) consisting of HTML files is written to that folder. 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 Conversio de llibres electronics 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 es possible comprovar-ho amb: ebook-convert myfile.input_format myfile.output_format -h A continuacio es detallen les opcions comunes a totes les conversions, seguides per les opcions especifiques de cada format d'entrada i de sortida. o OPCIONS D'ENTRADA o OPCIONS DE SORTIDA o APARENCA o PROCESSAMENT HEURISTIC o CERCA I SUBSTITUCIO o DETECCIO DE L'ESTRUCTURA o TAULA DEL CONTINGUT o METADADES o DEPURACIO --help, -h mostra aquest missatge d'ajuda i surt --input-profile Especifica el perfil d'entrada. El perfil d'entrada proporciona informacio al sistema de conversio de com interpretar informacio diversa del document d'entrada. Per exemple, longituds depenent de la resolucio (longitud en pixels). Les opcions son: 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 electronic a partir d'una recepta integrada aixi: <> sortida.epub --output-profile Especifica el perfil de sortida. El perfil de sortida li diu al sistema de conversio com ha d'optimitzar el document creat per al dispositiu especificat. En alguns casos es pot utilitzar un perfil de sortida per optimitzar la sortida per a un dispositiu particular, pero no sol ser necessari. Les opcions son:cybookg3, cybook_opus, default, generic_eink, generic_eink_large, generic_eink_hd, hanlinv3, hanlinv5, illiad, ipad, ipad3, irexdr1000, irexdr800, jetbook5, kindle, kindle_dx, kindle_fire, kindle_oasis, kindle_pw, kindle_pw3, kindle_scribe, kindle_voyage, kobo, msreader, mobipocket, nook, nook_color, nook_hd_plus, pocketbook_inkpad3, pocketbook_lux, pocketbook_hd, pocketbook_900, pocketbook_pro_912, galaxy, sony, sony300, sony900, sony-landscape, sonyt3, tablet --version mostra el numero de versio del programa i surt OPCIONS D'ENTRADA Opcions per a controlar el processament del fitxer d'entrada mobi --input-encoding Especifiqueu la codificacio de caracters del document d'entrada. Aquesta opcio anul.lara qualsevol codificacio que pugui estar indicada al document. Es particularment util per a documents que no indiquen cap codificacio o ho fan incorrectament. OPCIONS DE SORTIDA Opcions per a controlar el processament de la sortida epub --dont-split-on-page-breaks Desactiva les divisions als salts de linia. Normalment, els fitxers d'entrada es divideixen en dos automaticament a cada salt de pagina. Aixi s'obte un llibre electronic que es pot analitzar mes rapidament i amb menys recursos. La divisio pero, es lenta i si el vostre fitxer d'origen conte un gran nombre de salts de pagina, haurieu de desactivar la divisio als salts de pagina. --epub-flatten Nomes es necessita aquesta opcio si voleu utilitzar l'EPUB amb FBReaderJ. Aplanara el sistema de fitxers de dins l'EPUB i posara tots els fitxers al nivell superior. --epub-inline-toc Insereix una taula del contingut en linia que apareixera com a part del contingut principal del llibre. --epub-max-image-size The maximum image size (width x height). A value of none means use the screen size from the output profile. A value of profile means no maximum size is specified. For example, a value of 100x200 will cause all images to be resized so that their width is no more than 100 pixels and their height is no more than 200 pixels. Note that this only affects the size of the actual image files themselves. Any given image may be rendered at a different size depending on the styling applied to it in the document. --epub-toc-at-end Posa la taula del contingut en linia inserida al final del llibre en lloc del comencament. --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 folder. The contents of the folder are first deleted, so be careful. --flow-size Divideix tots els fitxers HTML mes grans d'aquesta mida (en KB). Aixo es necessari, ja que la majoria de lectors EPUB no poden gestionar fitxers grans. El valor per defecte de 260KB, que es la mida requerida per Adobe Digital Editions. Establiu-ho a 0, per a inhabilitar la divisio en funcio de la mida. --no-default-epub-cover Si el fitxer d'entrada no te portada i no n'especifiqueu cap, es genera una portada per defecte amb titol, autors... Aquesta opcio inhabilita la generacio d'aquesta portada. --no-svg-cover No utilitzis cap portada SVG. Utilitzeu aquesta opcio si el vostre EPUB s'utilitzara en un dispositiu que no te suport per a SVG, com ara l'iPhone o el JetBook Lite. Sense aquesta opcio, aquests dispositius mostraran una portada en blanc. --preserve-cover-aspect-ratio Quan s'utilitza una portada SVG, aquesta opcio fa que s'escali per a cobrir l'area de pantalla disponible, pero encara preservara la seva relacio d'aspecte (relacio entre l'amplada i l'altura). Aixo significa que pot haver-hi vores blanques als costats o a la part superior i inferior de la imatge, pero la imatge no es distorsiona mai. Sense aquesta opcio, la imatge pot estar una mica distorsionada, pero no hi haura vores. --pretty-print Si s'especifica, el connector de sortida intentara generar una sortida que sigui el mes llegible possible. Pot ser que no tingui cap efecte en alguns connectors de sortida. --toc-title Titol per a qualsevol taula del contingut generada automaticament. APARENCA Opcions per a controlar l'aparenca de la sortida --asciiize Transliterate Unicode characters to an ASCII representation. Use with care because this will replace Unicode characters with ASCII. For instance it will replace "Pele" with "Pele". Also, note that in cases where there are multiple representations of a character (characters shared by Chinese and Japanese for instance) the representation based on the current calibre interface language will be used. --base-font-size La mida de lletra base en pts. Totes les mides de lletra al llibre produit canviaran en base a aquesta mida. Escollir una mida mes gran podeu fer les lletres mes gran a la sortida i viceversa. Per defecte, quan el valor es zero, la mida de lletra base es tria en base al perfil de sortida triat. --change-justification Canvia l'alineacio del text. Un valor d'"esquerra" converteix tot el text alineat a l'origen en text alineat a l'esquerra (es a dir, no alineat). Un valor d'"alineat" converteix tot el text no alineat en text alineat. Un valor d'"original" (el predeterminat) no canvia l'alineacio del fitxer d'origen. Tingues en compte que nomes alguns formats de sortida son compatibles amb l'alineacio. --disable-font-rescaling Inhabilita tots els canvis d'escala de les mides de les lletres. --embed-all-fonts Incrusta cadascuna de les lletres referenciades al document d'entrada que encara no estan incrustades. Es fara una cerca de les lletres al sistema i, si es troben, s'incrustaran. La incrustacio nomes funciona si el format que esteu convertint es compatible amb lletres incrustades, com ara EPUB, AZW3 o PDF. Assegureu-vos que teniu la llicencia adequada per a la incrustacio de les lletres utilitzades en aquest document. --embed-font-family Incrusta la familia de la lletra especificada al llibre. Aixo especifica la lletra <> que s'utilitza per al llibre. Si el document d'entrada especifica les seves propies lletres, es poden substituir amb aquesta lletra base. Podeu utilitzar l'opcio de la informacio del filtre d'estils per suprimir lletres del document d'entrada. Tingueu en compte que la incrustacio de lletres nomes 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 <>, <>, <>, etc. Aquesta opcio fara 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. --extra-css Qualsevol cami a un full d'estil CSS o CSS en brut. Aquest CSS s'annexara a les regles d'estil del fitxer d'origen, aixi 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. Es util si la presencia d'alguna informacio d'estil no permet la substitucio al vostre dispositiu. Per exemple: font-family,color,margin-left,margin-right --font-size-mapping Mapatge a partir de noms de lletra de CSS a mides de lletra en pts. Un parametre d'exemple es 12,12,14,16,18,20,22,24. Aquests son els mapatges per a les mides xx-petita a xx-gran, amb la mida final sent per lletres enormes. L'algoritme de canvi de lletra utilitza aquestes mides per canviar lletres de manera intel.ligent. Per defecte s'utilitza un mapatge basat en el perfil de sortida triat. --insert-blank-line Insereix una linia en blanc entre paragrafs. No funcionara si el fitxer d'origen no utilitza paragrafs (etiquetes

o

). --insert-blank-line-size Estableix l'alcada de les linies en blanc inserides (en unitats em). L'alcada de les linies entre paragrafs sera el doble del valor que s'estableixi aqui. --keep-ligatures Preserva les lligadures presents al document d'entrada. Una lligadura es una renderitzacio especial d'un parell de caracters com ara ff, fi, fl.... La majoria dels lectors no admeten les lligadures en les seves lletres predeterminades, per aquest motiu es poc probable que les renderitzin correctament. Per defecte, calibre canvia una lligadura pel seu parell corresponent de caracters normals. Aquesta opcio fa que les lligadures en preservin en lloc seu. --line-height L'alcada de linia en punts. Controla l'espaiat entre linies consecutives de text. Nomes s'aplica a elements que no defineixen la seva alcada de linia. A la majoria de casos es mes util l'opcio de l'alcada minima de linia. Per defecte no es manipula l'alcada de linia. --linearize-tables Alguns documents mal dissenyats utilitzen taules per controlar la disposicio del text a la pagina. Quan es converteixen sovint hi ha desplacaments del text fora de la pagina i altres artefactes. Aquesta opcio extreu el contingut de les taules i el presenta de forma lineal. --margin-bottom Estableix el marge inferior en pts. Per defecte es 5.0. Establir-lo en menys de zero fara que no hi hagi marge (els ajusts del marge del document original es conservaran). Atencio: Els formats orientats a pagines, com PDF o DOCX, tenen els seus propis ajusts del marge i aquests tenen preferencia. --margin-left Estableix el marge esquerre en pts. Per defecte es 5.0. Establir-lo en menys de zero fara que no hi hagi marge (els ajusts del marge del document original es conservaran). Atencio: Els formats orientats a pagines, com PDF o DOCX, tenen els seus propis ajusts del marge i aquests tenen preferencia. --margin-right Estableix el marge dret en pts. Per defecte es 5.0. Establir-lo en menys de zero fara que no hi hagi marge (els ajusts del marge del document original es conservaran). Atencio: Els formats orientats a pagines, com PDF o DOCX, tenen els seus propis ajusts del marge i aquests tenen preferencia. --margin-top Estableix el marge superior en pts. Per defecte es 5.0. Establir-lo en menys de zero fara que no hi hagi marge (els ajusts del marge del document original es conservaran). Atencio: Els formats orientats a pagines, com PDF o DOCX, tenen els seus propis ajusts del marge i aquests tenen preferencia. --minimum-line-height L'alcada minima de la linia, com a un percentatge de la mida de la lletra calculada de l'element. Calibre s'assegurara que cada element tingui una alcada de linia d'almenys aquest ajust, independentment del que especifiqui el document d'entrada. Zero per a inhabilitar-ho. Per defecte es 120%. Utilitzeu aquest ajust en lloc de l'especificacio directa de l'alcada de la linia, llevat que sapigueu el que esteu fent. Per exemple, podeu assolir text a <> amb l'establiment del valor a 240. --remove-paragraph-spacing Elimina l'espaiat entre paragrafs. Tambe estableix un sagnat als paragrafs d'1.5 em. L'eliminacio de l'espaiat no funcionara si el fitxer d'origen no utilitza paragrafs (etiquetes

o

). --remove-paragraph-spacing-indent-size Quan calibre suprimeix les linies en blanc entre paragrafs, estableix automaticament un sagnat per assegurar-se que es puguin distingir be els paragrafs. Aquesta opcio controla l'amplada del sagnat (en unitats em). Si s'estableix un valor negatiu, s'utilitza el sagnat especificat al document d'entrada, es a dir, calibre no canvia el sagnat. --smarten-punctuation Convert plain quotes, dashes and ellipsis to their typographically correct equivalents. For details, see https://daringfireball.net/projects/smartypants. --subset-embedded-fonts Subconjunt de totes les lletres incrustades. Es redueixen totes les lletres incrustades perque nomes continguin els caracters utilitzats al document. Aixo redueix la mida dels fitxers de les lletres. Es util si incrusteu una lletra especialment gran amb molts caracters que no s'utilitzen. --transform-css-rules Cami al fitxer que conte les regles per transformar els estils CSS del llibre. La manera mes facil de crear aquest tipus de fitxer es utilitzar l'assistent de creacio de regles a la interficie grafica d'usuari. Podeu accedir-hi a la seccio del dialeg de conversio a <Transformacio dels estils>>. Un cop hagiu creat les regles, empreu el boto <> per desar-les en un fitxer. --transform-html-rules Path to a file containing rules to transform the HTML 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 HTML" section of the conversion dialog. Once you create the rules, you can use the "Export" button to save them to a file. --unsmarten-punctuation Converteix les cometes, els guions i els punts suspensius als seus equivalents senzills. PROCESSAMENT HEURISTIC Modifica el text i l'estructura del document amb els patrons habituals. Inhabilitat per defecte. Utilitzeu --enable-heuristics per a habilitar-ho. Les accions individuals es poden inhabilitar amb les opcions --disable- * . --disable-dehyphenate Analitza les paraules amb guio de tot el document. S'utilitza el mateix document com a diccionari per determinar si s'han de mantenir o suprimir els guions. --disable-delete-blank-paragraphs Suprimeix els paragrafs buits del document si aquests estan intercalats entre qualsevol altre paragraf --disable-fix-indents Converteix els sagnats creats amb blocs de diversos espais seguits en sagnats CSS. --disable-format-scene-breaks Els marcadors de salt d'escena alineats a l'esquerra se centren. Se suprimeixen els salts d'escena amb diverses linies en blanc per linies horitzontals. --disable-italicize-common-cases Cerca paraules i patrons que solen estar en cursiva i posar-los-hi. --disable-markup-chapter-headings Detecta els encapcalaments i els subencapcalaments sense format dels capitols i canvia'ls a etiquetes h2 i h3. Aquest ajust no creara una taula del contingut, pero es pot utilitzar conjuntament amb la deteccio de l'estructura per crear-ne una. --disable-renumber-headings Cerca la presencia de sequencies d'etiquetes

o

. Es torna a numerar les etiquetes per evitar una divisio al mig dels encapcalaments dels capitols. --disable-unwrap-lines Suprimeix els salts de linia mitjancant la puntuacio i altres indicis de formatacio. --enable-heuristics Habilita el processament heuristic. S'ha d'activar aquesta opcio per a poder fer qualsevol processament heuristic. --html-unwrap-factor Escala utilitzada per determinar la longitud en que una linia s'hauria d'ajustar. Els valors valids son un decimal entre 0 i 1. Per defecte es 0.4, just per sota de la longitud mitjana de la linia. Si nomes algunes linies del document necessiten ajustar-se aquest valor s'hauria de reduir --replace-scene-breaks Reemplaca els salts d'escena pel text especificat. Per defecte s'utilitza el text del document d'entrada. CERCA I SUBSTITUCIO Modifica el text i l'estructura del document mitjancant els patrons definits per l'usuari. --search-replace Cami a un fitxer que conte les expressions regulars de cerca i substitucio. El fitxer ha de contenir linies alternants d'expressions regulars seguides per un patro de substitucio (que pot ser una linia buida). L'expressio regular ha de ser expressions regulars de Python i han d'estar codificades en UTF-8. --sr1-replace Text de substitucio del que es trobi amb sr1-search. --sr1-search Patro de cerca (expressio regular) que se substituira per sr1-replace. --sr2-replace Text de substitucio del que es trobi amb sr2-search. --sr2-search Patro de cerca (expressio regular) que se substituira per sr2-replace. --sr3-replace Text de substitucio del que es trobi amb sr3-search. --sr3-search Patro de cerca (expressio regular) que se substituira per sr3-replace. DETECCIO DE L'ESTRUCTURA Controla l'autodeteccio de l'estructura del document. --chapter Una expressio XPath per detectar els titols dels capitols. Per defecte es considera

o

etiquetes que contenen les paraules "capitol", "llibre", "seccio", "proleg", "epileg" o "part" aixi com titols de capitol i qualsevol etiqueta que tingui class="capitol". L'expressio utilitzada s'ha d'equiparar a una llista d'elements. Per inhabilitar la deteccio de capitols, utilitzeu l'expressio "/". Vegeu el tutorial XPath al manual d'usuari de calibre per mes ajuda sobre aquesta funcio. --chapter-mark Especifica com s'ha de marcar els capitols detectats. El valor <> insereix un salt de pagina abans dels capitols. El valor <> insereix una linia abans dels capitols. El valor <> inhabilita les marques dels capitols i el valor <> insereix un salt de pagina i una linia per marcar els capitols. --disable-remove-fake-margins Alguns documents especifiquen els marges de pagina amb un marge a la dreta i a l'esquerra per a cada paragraf. 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 supressio. --insert-metadata Insereix les metadades del llibre a l'inici. Aixo es util si el vostre lector de llibres electronics no disposa de cerca o visualitzacio de metadades directament. --page-breaks-before Una expressio XPath. Els salts de pagina s'insereixen abans dels elements especificats. Per inhabilitar utilitzeu l'expressio: / --prefer-metadata-cover Estableix la portada detectada al fitxer d'origen de forma preferent a la portada indicada. --remove-first-image Suprimeix la primera imatge del llibre electronic d'entrada. Util si el document d'entrada te una imatge de portada que no s'identifica com a portada. En aquest cas, si establiu una portada a calibre, el document de sortida tindra dues imatges de portada si no especifiqueu aquesta opcio. --start-reading-at Una expressio XPath per detectar el lloc del document on s'ha de comencar la lectura. Alguns programes de lectura (el mes remarcable el Kindle) utilitzen aquest lloc com a la posicio que s'ha d'obrir el llibre. Vegeu l'assistent de XPath al manual d'usuari de calibre per a mes informacio. TAULA DEL CONTINGUT Controla la generacio automatica d'una taula de continguts. Per defecte, si el fitxer d'origen te una taula de continguts, s'utilitzara aquesta abans que la generada automaticament. --duplicate-links-in-toc Quan es crea una taula del contingut a partir dels enllacos al document d'entrada permet que hi hagin entrades duplicades, es a dir, permet mes d'una entrada amb el mateix text, sempre que apuntin a una ubicacio diferent. --level1-toc Expressio XPath que especifica totes les etiquetes s'han d'afegir al primer nivell de la taula del contingut. Si s'especifica, te prioritat sobre les altres formes de deteccio automatica. Vegeu alguns exemples a la guia d'aprenentatge de XPath del manual d'usuari de calibre. --level2-toc Expressio 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 previa. Vegeu alguns exemples a la guia d'aprenentatge de XPath del manual d'usuari de calibre. --level3-toc Expressio 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 previa. Vegeu alguns exemples a la guia d'aprenentatge de XPath del manual d'usuari de calibre. --max-toc-links Nombre maxim d'enllacos per afegir a la taula del contingut. Establiu-lo a 0 per a inhabilitar-ho. Per defecte es: 50. Els enllacos s'afegeixen a la taula del contingut si es detecta menys capitols que el nombre d'aquest llindar. --no-chapters-in-toc No afegeixis els capitols detectats automaticament a la taula del contingut. --toc-filter Suprimeix les entrades de la taula del contingut quan els seus titols coincideixin amb l'expressio indicada. Se suprimiran les entrades coincidents i els seus subapartats. --toc-threshold Si el nombre de capitols detectats es menor que aquest s'afegeixen els enllacos 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 automaticament. Amb aquesta opcio sempre s'utilitza el generat automaticament. METADADES Opcions per a assignar metadades a la sortida --author-sort La cadena que s'utilitzara en l'ordenacio per autor. --authors Estableix els autors. Diversos autors haurien d'estar separats per "&". --book-producer Estableix el productor del llibre. --comments Estableix la descripcio del llibre. --cover Estableix la portada a partir del fitxer o URL especificat --isbn Estableix l'ISBN del llibre. --language Estableix la llengua. --pubdate Estableix la data de publicacio (s'assumeix que es zona horaria local, llevat que s'especifiqui una altra explicitament) --publisher Estableix l'editorial del llibre. --rating Estableix la valoracio. Hauria de ser un nombre entre l'1 i el 5. --read-metadata-from-opf, --from-opf, -m Llegeix les metadades del fitxer OPF especificat. Les metadades que es llegeixin d'aquest fitxer substituiran les metadades del fitxer d'origen. --series Estableix la serie que pertany el llibre. --series-index Estableix l'index del llibre en aquesta serie. --tags Estableix les etiquetes per al llibre. Hauria de ser una llista separada per comes. --timestamp Estableix la marca horaria del llibre (ja no s'utilitza enlloc mes) --title Estableix el titol. --title-sort La versio del titol que s'utilitzara per a l'ordenacio. DEPURACIO Opcions per a ajudar a la depuracio de la conversio --debug-pipeline, -d Save the output from different stages of the conversion pipeline to the specified folder. Useful if you are unsure at which stage of the conversion process a bug is occurring. --verbose, -v Nivell de detall. Especifiqueu diverses vegades per un detall mes gran. Si s'especifica dues vegades el resultat sera un detall complet; una vegada, detall mitja, i cap vegada, el minim de detall. AUTHOR Kovid Goyal COPYRIGHT Kovid Goyal 7.10.0 de maig 03, 2024 EBOOK-CONVERT(1)