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

       o OPTIUNI DE INTRATE

       o OP<?>IUNI DE IE<?>IRE

       o ASPECT SI COMPORTAMENT

       o PROCESARE EURISTICA

       o CAUTA <?>I INLOCUIE<?>TE

       o DETECTAREA STRUCTURII

       o CUPRINS

       o METADATA

       o DEBUG

       --help, -h
              show this help message and exit

       --input-profile
              Specifica<?>i profilul de intrare. Profilul de intrare da
              sistemului de conversie informa<?>ii asupra cum se interpreteaza
              diferite informa<?>ii din documentul de intrare. De exemplu
              lungimile dependente de rezolu<?>ie (ex. lungimile in pixeli).
              Variantele sunt: 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. 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_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
              show program's version number and exit

OPTIUNI DE INTRATE
       Op<?>iuni pentru controlul prelucrarii fi<?>ierului de intrare mobi

       --input-encoding
              Precizarea codificarii caracterelor documentului sursa.
              Selectarea acestei optiuni va suprascrie orice optiune de
              codificare prezenta in document. Este utila in special pentru
              documentele care nu declara o codificare sau care au declaratii
              eronate de codare.

OP<?>IUNI DE IE<?>IRE
       Op<?>iuni pentru controlul prelucrarii fi<?>ierului de ie<?>ire epub

       --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
              Aceasta optiune este necesara doar daca doriti sa utilizati EPUB
              cu FBReaderJ. Va aplatiza sistemul de fisiere din interiorul
              EPUB, asezand toate fisierele pe nivelul superior.

       --epub-inline-toc
              Insereaza un Cuprins ce va aparea ca parte a con<?>inutului
              car<?>ii.

       --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
              Pune Cuprinsul inserat la sfar<?>itul car<?>ii, in loc de
              inceput.

       --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 book to the specified
              folder. The contents of the folder 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
              In mod normal, daca fisierele intrate nu au nici o coperta si
              dumneavoastra nu specificati una, o coperta aleatoare va fi
              generata cu titlu, autor, etc. Aceasta optiune dezactiveaza
              generarea acestei coperti.

       --no-svg-cover
              Nu utilizati SVG pentru coperta cartii. Utilizati aceasta
              optiune daca EPUB-ul dumneavoastra urmeaza sa fie utilizat pe un
              dispozitiv care nu suporta SVG, asemenea iPhone-ului sau JetBook
              Lite. Fara aceasta optiune, asemenea dispozitive vor afisa
              coperta ca o pagina alba.

       --preserve-cover-aspect-ratio
              Cand utilizati o coperta SVG, aceasta optiune va determina
              coperta sa incadreze spatiul disponibil al ecranului, dar sa-i
              pastreze inca aspectul (raportul dintre latime si inaltime).
              Inseamna ca pot ramne margini albe la capetele de sus sau de
              jos, dar imaginea nu va fi niciodata distrusa. Fara aceasta
              optiune imaginea poate fi usor distrusa, dar nu vor exista
              margini.

       --pretty-print
              Daca este specificat, plugin-ul de ie<?>ire va incerca sa creeze
              un document cat mai usor de citit de catre utilizator. Este
              posibil sa nu aiba niciun rezultat in cazul anumitor conectoare.

       --toc-title
              Title for any generated inline table of contents.

ASPECT SI COMPORTAMENT
       Op<?>iuni pentru controlul aspectului <?>i comportamentului ie<?>irii

       --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
              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
              Schimba alinierea textului. Valoarea "left" converte<?>te toate
              textele aliniate stanga-dreapta in sursa la text aliniat la
              stanga (ex. nealiniat stanga-dreapta). Valoarea "justify"
              converte<?>te textul nealiniat stanga-dreapta in text aliniat
              stanga-dreapta. Valoarea "original" (implicita) nu schimba
              alinierea din fi<?>ierul sursa. Observa<?>i ca doar anumite
              formate suporta aliniere stanga-dreapta.

       --disable-font-rescaling
              Dezactiveaza redimensionarea caracterelor.

       --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
              Fie calea spre o foaie de stiluri CSS, fie CSS brut. Acest CSS
              va fi adaugat la regulile de stil din fisierul sursa, astfel
              incat poate fi folosit pentru a suprascrie acele reguli.

       --filter-css
              A comma separated list of CSS properties that will be removed
              from all CSS style rules. This is useful if the presence of some
              style information prevents it from being overridden on your
              device. For example: font-family,color,margin-left,margin-right

       --font-size-mapping
              Punerea in legatura a numelor de fonturi CSS cu marimile in pts
              ale fonturilor. Un exemplu de configurare este:
              12,12,14,16,18,20,22,24. Acestea sunt coresponden<?>ele
              marimilor de la xx-mic la xx-mare, marimea finala fiind
              utilizata pentru fonturi foarte mari. Algoritmul de
              redimensionare a fontului folose<?>te aceste marimi pentru a
              redimensiona in mod inteligent fonturile. Implicit se
              folose<?>te coresponden<?>a bazata pe profilul de ie<?>ire pe
              care l-a<?>i ales.

       --insert-blank-line
              Introduce o linie libera intre paragrafe. Nu va func<?>iona daca
              fi<?>ierul sursa nu folose<?>te paragrafe (etichetele <p> sau
              <div>).

       --insert-blank-line-size
              Stabileste dimensiunea (inaltimea) randurilor goale introduse.
              Inaltimea randurilor dintre paragrafe va fi dublul valorii
              introduse aici.

       --keep-ligatures
              Preserve ligatures present in the input document. A ligature is
              a combined character of a pair of characters like ff, fi, fl et
              cetera. Most readers do not have support for ligatures in their
              default fonts, so they are unlikely to render correctly. By
              default, calibre will turn a ligature into the corresponding
              pair of normal characters. Note that ligatures here mean only
              unicode ligatures not ligatures created via CSS or font styles.
              This option will preserve them instead.

       --line-height
              Inal<?>imea liniei exprimata in puncte. Controleaza spa<?>ierea
              dintre liniile de text consecutive. Se aplica doar elementelor
              care nu i<?>i definesc propria inal<?>ime a liniei. In
              majoritatea cazurilor, alegearea inal<?>imii minime a liniei
              este mai utila. In mod implicit nu sunt efectuate modificari ale
              inal<?>imii liniei.

       --linearize-tables
              Cateva documente rau proiectate folosesc tabele pentru a
              controla pozi<?>ia textului in pagina. Cand sunt convertite
              aceste documente, adesea textul iese din pagina sau alte
              componente. Aceasta op<?>iune va extrage con<?>inutul din tabele
              <?>i il va prezenta in mod liniar.

       --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
              Inaltimea minima a liniei, ca un procent din dimensiunea
              fontului elementului calculat, calibre se va asigura ca fiecare
              element are o inaltime de linie cel putin egala cu aceasta
              valoare, indiferent de ceea ce documentul de intrare specifica.
              Seta<?>i la zero pentru a dezactiva. Implicit este 120%.
              Utilizati aceasta setare in preferinta specificarii inaltimii
              liniei directe, cu exceptia cazului in care stiti ce faceti. De
              exemplu, puteti obtine text "dublu spa<?>iat" daca folosi<?>i
              valoarea 240.

       --remove-paragraph-spacing
              <?>terge spa<?>iile dintre paragrafe. De asemenea fixeaza
              indentarea pe paragrafe la 1.5em. <?>tergerea spa<?>iilor nu va
              func<?>iona daca fi<?>ierul sursa nu folose<?>te paragrafe
              (etichetele <p> sau <div>).

       --remove-paragraph-spacing-indent-size
              Atunci cand calibre elimina liniile goale dintre paragrafe,
              seteaza automat un alineat la paragraf pentru a asigura o
              distinctie cat mai usoara intre paragrafe. Aceasta optiune
              controleaza marimea alineatului. Daca setati aceasta ca si
              valoare negativa, atunci alineatul din documentul de intrare
              este folosit, ceea ce inseamna ca nu se schimba alineatul.

       --smarten-punctuation
              Convert plain quotes, dashes and ellipsis to their
              typographically correct equivalents. For details, see
              https://daringfireball.net/projects/smartypants.

       --subset-embedded-fonts
              Subset all embedded fonts. Every embedded font is reduced to
              contain only the glyphs used in this document. This decreases
              the size of the font files. Useful if you are embedding a
              particularly large font with lots of unused glyphs.

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

       --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
              Converteste ghilimelele extravagante, liniile de pauza si
              elipsele in echivalentul lor simplu.

PROCESARE EURISTICA
       Modifica textul si structura documentului folosind modele comune.
       Aceasta optiune este dezactivata in mod implicit. Folositi
       --enable-heuristics pentru a o activa. Actiuni individuale pot fi
       dezactivate cu optiunile --disable-
       *
       .

       --disable-dehyphenate
              Analizati cuvintele despartite in silabe din intregul document.
              Documentul in sine este folosit ca un dictionar pentru a
              determina daca cratimele ar trebui sa fie pastrate sau
              eliminate.

       --disable-delete-blank-paragraphs
              Elimina paragrafele goale din document atunci cand acestea
              exista intre fiecare alte paragrafe.

       --disable-fix-indents
              Schimba indentatia creata din multiple entita<?>i de spa<?>iu
              neintrerupte in paragrafe CSS.

       --disable-format-scene-breaks
              Separatorii de text aliniati la stanga vor fi aliniati la
              centru. Inlocuiti separatorii de text care folosesc linii goale
              multiple cu reguli orizontale.

       --disable-italicize-common-cases
              Cauta cuvinte comune si tipare care denota caractere cursive si
              tipare<?>te-le cursiv.

       --disable-markup-chapter-headings
              Detecteaza titlurile <?>i sub-titlurile neformatate. Modifica-le
              in etichete de tip h2 <?>i h3. Aceasta setare nu va crea un
              cuprins, dar poate fi folosita impreuna cu detectarea structurii
              pentru a crea unul.

       --disable-renumber-headings
              Cauta evenimente secventale ale etichetelor <h1> sau <h2>.
              Etichetele sunt renumerotate pentru a preveni scindarea in
              mijlocul capitolului.

       --disable-unwrap-lines
              Desfa<?>oara liniile folosind semne de punctua<?>ie <?>i alte
              indicii de formatare.

       --enable-heuristics
              Activa<?>i procesarea euristica. Aceasta op<?>iune trebuie sa
              fie activata pentru ca orice procesare euristica sa aiba loc.

       --html-unwrap-factor
              Scara utilizata pentru a determina lungimea la care o linie ar
              trebui sa fie desfa<?>urata. Valorile valide sunt zecimale intre
              0 <?>i 1. Valoarea implicita este de 0,4 , tocmai sub lungimea
              mediana a liniei. In cazul in care doar cateva linii in document
              necesita desfa<?>urare aceasta valoare ar trebui sa fie redusa

       --replace-scene-breaks
              Inlocuieste intreruperile textului cu textul specificat. In mod
              prestabilit, se utilizeaza textul din document.

CAUTA <?>I INLOCUIE<?>TE
       Modifica textul <?>i structura documentului folosind tipare definite de
       catre utilizator.

       --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
              Inlocuieste textul gasit prin cautarea sr1-search.

       --sr1-search
              Modelul de cautare (expresia regulata) va fi inlocuit cu
              sr1-replace.

       --sr2-replace
              Inlocuieste textul gasit prin cautarea sr2-search.

       --sr2-search
              Modelul de cautare (expresia regulata) va fi inlocuit cu
              sr2-replace.

       --sr3-replace
              Inlocuieste textul gasit prin cautarea sr3-search.

       --sr3-search
              Modelul de cautare (expresia regulata) va fi inlocuit cu
              sr3-replace.

DETECTAREA STRUCTURII
       Controleaza detectarea automata a structurii documentului.

       --add-alt-text-to-img
              When an <img> tag has no alt attribute, check the associated
              image file for metadata that specifies alternate text, and use
              it to fill in the alt attribute. The alt attribute improves
              accessibility by providing text descriptions for users who
              cannot see or fully interpret visual content.

       --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
              Specifica<?>i cum sa marca<?>i capitolele detectate. Valoarea
              "pagebreak" va introduce sfar<?>ituri de pagina inaintea
              capitolelor. Valoarea  "rule" va introduce o linie inainte de
              capitole. Valoarea "none" va dezactiva marcarea capitolului <?>i
              valoarea "both" va folosi atat sfar<?>iturile de pagina cat <?>i
              liniile pentru marcarea capitolelor.

       --disable-remove-fake-margins
              Unele documente specifica bordura paginii prin specificarea
              marginilor drepte si stangi pe fiecare paragraf in parte.
              calibre va incerca sa identifice si sa inlature aceste margini.
              Uneori, aceasta actiune poate cauza indepartarea unor margini
              care nu trebuiau scoase. In acest caz, puteti dezactiva
              scoaterea.

       --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
              An XPath expression. Page breaks are inserted before the
              specified elements. To disable use the expression: /

       --prefer-metadata-cover
              Prefera utilizarea copertii detectate in fisierul sursa in loc
              de coperta specificata.

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

CUPRINS
       Controlul generarii automate a cuprinsului. Implicit, daca fi<?>ierul
       sursa are un cuprins, acesta va fi folosit de regula pentru cuprinsul
       celui generat automat.

       --duplicate-links-in-toc
              When creating a TOC from links in the input document, allow
              duplicate entries, i.e. allow more than one entry with the same
              text, provided that they point to a different location.

       --level1-toc
              XPath expression that specifies all tags that should be added to
              the Table of Contents at level one. If this is specified, it
              takes precedence over other forms of auto-detection. See the
              XPath Tutorial in the calibre User Manual for examples.

       --level2-toc
              XPath expression that specifies all tags that should be added to
              the Table of Contents at level two. Each entry is added under
              the previous level one entry. See the XPath Tutorial in the
              calibre User Manual for examples.

       --level3-toc
              XPath expression that specifies all tags that should be added to
              the Table of Contents at level three. Each entry is added under
              the previous level two entry. See the XPath Tutorial in the
              calibre User Manual for examples.

       --max-toc-links
              Numarul maxim de legaturi de introdus in cuprins. Pune<?>i 0
              pentru a-l dezactiva. Implicit este: 50. Legaturile sunt
              adaugate la cuprins daca numarul-prag de capitole detectate nu a
              fost atins.

       --no-chapters-in-toc
              Nu adauga capitolele auto-detectate la cuprins.

       --toc-filter
              Sterge intrarile din cuprins ale caror titluri corespund
              expresiilor regulate specifice. Intrarile corespondente si toti
              fiii lor sunt sterse.

       --toc-threshold
              Daca sunt detectate mai putine capitole decat numarul acesta,
              atunci se adauga legaturi la cuprins. Implicit: 6

       --use-auto-toc
              In mod normal daca fisierul sursa are deja un cuprins acesta
              este preferat fata de cel generat automat. Cu aceasta optiune
              cel generat automat este folosit intotdeauna.

METADATA
       Op<?>iuni pentru precizarea metadatelor la ie<?>ire

       --author-sort
              Sir de caractere care trebuie utilizat la sortarea dupa autor.

       --authors
              Introduceti autorii. Autorii multipli trebuie separati prin "&".

       --book-producer
              Indica producatorul car<?>ii.

       --comments
              Set the e-book description.

       --cover
              Seteaza coperta catre fisierul sau URL specificat.

       --isbn Indica<?>i numarul ISBN al car<?>ii.

       --language
              Indica limba.

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

       --publisher
              Set the e-book publisher.

       --rating
              Stabiliti evaluarea personala a cartii. Ar trebui sa fie un
              numar intre 1 si 5.

       --read-metadata-from-opf, --from-opf, -m
              Citeste metadatele din fisierul OPF specificat. Metadatele
              citite din acest fisier vor suprascrie orice metadata din
              fisierul sursa.

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

       --series-index
              Setati indexul cartii in aceasta serie

       --tags Introduce<?>i etichetele pentru carte. Ar trebui sa fie o lista
              separata prin virgule.

       --timestamp
              Indica data car<?>ii (nu mai este folosita nicaieri)

       --title
              Stabileste titul.

       --title-sort
              Versiunea titlului de folosit pentru sortare.

DEBUG
       Op<?>iuni pentru asistarea depanarii conversiei

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

AUTHOR
       Kovid Goyal

COPYRIGHT
       Kovid Goyal

8.0.1                           martie 21, 2025               EBOOK-CONVERT(1)