Provided by: calibre_6.11.0+dfsg-2_all bug

NAME

       ebook-convert - ebook-convert

          ebook-convert input_file output_file [options]

       Konwertuj e-booka z jednego formatu na inny.

       input_file  to  dane wejściowe, a output_file to dane wyjściowe. Oba muszą być podane jako
       pierwsze dwa argumenty polecenia.

       Wyjściowy format e-booka jest odgadywany  na  podstawie  rozszerzenia  pliku  output_file.
       plik_wyjściowy może mieć również specjalny format .EXT, gdzie EXT jest rozszerzeniem pliku
       wyjściowego.  W  takim  przypadku  nazwa  pliku  wyjściowego  pochodzi  od   nazwy   pliku
       wejściowego.  Zauważ,  że  nazwy plików nie mogą zaczynać się od myślnika. Wreszcie, jeśli
       plik_wyjściowy nie ma rozszerzenia, jest traktowany jako folder i  do  tego  folderu  jest
       zapisywany  „otwarty  e-book” (OEB) składający się z plików HTML. Te pliki to pliki, które
       normalnie zostałyby przekazane do wtyczki wyjściowej.

       Po określeniu pliku wejściowego i  wyjściowego  możesz  dostosować  konwersję,  określając
       różne  opcje. Dostępne opcje zależą od typów plików wejściowych i wyjściowych. Aby uzyskać
       pomoc, podaj plik wejściowy i wyjściowy, a następnie użyj opcji -h.

       Pełna dokumentacja systemu konwersji zobacz Konwersja książek

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

       Opcje  i  domyślne  wartości  są  różne w zależności od formatu wejściowego i wyjściowego,
       zawsze więc należy je sprawdzić:
          ebook-convert myfile.input_format myfile.output_format -h

       Poniżej znajdują się opcje wspólne dla wszystkich formatów, a następnie te,  które  zależą
       od formatu wejścia i wyjścia.

       • OPCJE PLIKU ŹRÓDŁOWEGOOPCJE PLIKU WYJŚCIOWEGOWYGLĄDPRZETWARZANIE HEURYSTYCZNEWYSZUKAJ I ZASTĄPWYKRYWANIE STRUKTURYSPIS TREŚCIMETADANEDEBUG

       --help, -h
              Wyświetla ten tekst pomocy i kończy działanie

       --input-profile
              Określ profil wejścia. Profil wejścia dyktuje systemowi konwersji jak interpretować
              różne  informacje  w  dokumencie  wejściowym.  Na  przykład  długości  zależne   od
              rozdzielczości  (tj.  długość w pikselach). Do wyboru jest:  cybookg3, cybook_opus,
              default, hanlinv3,  hanlinv5,  illiad,  irexdr1000,  irexdr800,  kindle,  msreader,
              mobipocket, nook, sony, sony300, sony900

       --list-recipes
              Lista  wbudowanych  źródeł. Korzystając ze źródła możesz utworzyć e-booka za pomocą
              polecenia ebook-convert "Nazwa źródła.recipe" wynik.epub

       --output-profile
              Określ  profil  wyjściowy.  Profil  wyjściowy  informuje  system   konwersji,   jak
              zoptymalizować  stworzony  dokument  dla  wybranego  urządzenia (poprzez np. zmianę
              rozmiaru obrazów na pasujący do ekranu urządzenia). W niektórych przypadkach profil
              wyjściowy  może  posłużyć do optymalizacji dla szczególnego urządzenia, ale jest to
              rzadko wymagane. Do wyboru są: cybookg3, cybook_opus, default, 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,  generic_eink,
              generic_eink_hd,    generic_eink_large,     pocketbook_inkpad3,     pocketbook_lux,
              pocketbook_hd,  pocketbook_900, pocketbook_pro_912, galaxy, sony, sony300, sony900,
              sony-landscape, sonyt3, tablet

       --version
              Wyświetla wersję programu i kończy działanie

OPCJE PLIKU ŹRÓDŁOWEGO

       Opcje sterujące przetwarzaniem pliku źródłowego mobi

       --input-encoding
              Określ kodowanie znaków dokumentu wejściowego. Jeśli  ta  opcja  zostanie  wybrana,
              wybrane kodowanie zastąpi to zadeklarowane w dokumencie. Szczególnie przydatne jest
              to w przypadku dokumentów, które nie deklarują  kodowania  lub  które  mają  błędną
              deklarację.

OPCJE PLIKU WYJŚCIOWEGO

       Opcje sterujące przetwarzaniem pliku wyjściowego epub

       --dont-split-on-page-breaks
              Wyłącz   dzielenie   przy   znaku   podziału  strony.  Zwykle  pliki  wejściowe  są
              automatycznie dzielone przy każdym znaku podziału strony na dwa pliki. Dzięki  temu
              książka  wyjściowa  może  być  szybciej i wydajniej przetworzona. Jednakże, podział
              jest powolny i jeśli plik źródłowy  zawiera  dużą  ilość  znaków  podziału  strony,
              powinieneś wyłączyć podział przy znaku podziału strony.

       --epub-flatten
              Ta opcja jest wymagana tylko wtedy, gdy zamierzasz wykorzystywać EPUBa z czytnikiem
              FBReaderJ. To spłaszczy system plików wewnątrz EPUBa, umieszczając wszystkie  pliki
              na najwyższym poziomie.

       --epub-inline-toc
              Wstaw spis treści, który będzie stanowił część książki.

       --epub-toc-at-end
              Umieść wstawiany spis treści na końcu książki zamiast na początku.

       --epub-version
              Wersja   pliku   EPUB,   która  zostanie  wygenerowana.  EPUB  2  jest  najbardziej
              kompatybilny,  skorzystaj  z  EPU"B  3  jeśli  tylko  wiesz,   że   takiej   wersji
              potrzebujesz.

       --extract-to
              Wyodrębnij  zawartość  wygenerowanego  pliku EPUB do określonego folderu. Zawartość
              folderu jest najpierw usuwana, więc bądź ostrożny.

       --flow-size
              Dzielenie wszystkich plików  HTML  większych  niż  ten  rozmiar  (w  KB).  Jest  to
              konieczne,  gdyż  większość  czytników  EPUB  nie  potrafi obsłużyć plików o dużych
              rozmiarach. Domyślna wartość  260  KB  to  rozmiar  wymagany  przez  Adobe  Digital
              Editions. Ustaw na 0, aby wyłączyć dzielenie w oparciu o rozmiar.

       --no-default-epub-cover
              Zazwyczaj,  jeżeli  plik  źródłowy nie ma okładki i nie wskażesz odpowiedniej, jest
              generowana domyślna  okładka  zawierająca  tytuł,  autora  itp.  Ta  opcja  wyłącza
              tworzenie takiej okładki.

       --no-svg-cover
              Nie  używaj  SVG  do  okładki  książki.  Użyj  tej  opcji,  jeśli  twój EPUB będzie
              odczytywany na urządzeniu, które nie wspiera SVG, jak iPhone czy JetBook Lite.  Bez
              tej opcji takie urządzenia będą wyświetlać okładkę jako pustą stronę.

       --preserve-cover-aspect-ratio
              Jeśli  okładka  jest  w  postaci  grafiki SVG, włączenie tej opcji spowoduje zmianę
              rozmiaru okładki na cały dostępny obszar ekranu, zachowując jednak proporcje obrazu
              (stosunek  jego  szerokości  do  wysokości). Oznacza to, że na brzegach obrazu mogą
              pojawić się białe pasy, nie zostanie on jednak zniekształcony. Wyłączenie tej opcji
              może spowodować lekkie zniekształcenie obrazu, nie pojawią się natomiast białe pasy
              na brzegach.

       --pretty-print
              Jeśli jest określony, wtyczka spróbuje wygenerować jak najbardziej  czytelne  dane.
              Dla  niektórych  wtyczek  generujących  dane  wyjściowe  może  nie dawać to żadnych
              efektów.

       --toc-title
              Tytuł dla automatycznie wygenerowanego spisu treści.

WYGLĄD

       Opcje umożliwiające kontrolę nad wyglądem pliku wyjściowego

       --asciiize
              Transliteruj znaki Unicode  do  reprezentacji  ASCII.  Używaj  ostrożnie,  ponieważ
              spowoduje to zamianę znaków Unicode na ASCII. Na przykład zamieni „Pelé” na „Pele”.
              Należy również pamiętać, że w przypadkach, gdy istnieje wiele  reprezentacji  znaku
              (znaki  wspólne  na  przykład  w  języku  chińskim  i  japońskim),  zostanie  użyta
              reprezentacja oparta na bieżącym języku interfejsu kalibru.

       --base-font-size
              Podstawowy rozmiar czcionki w pkt. Wszystkie  rozmiary  czcionek  w  wyprodukowanej
              książce  zostaną  przeskalowane  na  podstawie  tego  rozmiaru.  Wybierając większy
              rozmiar, możesz zwiększyć czcionki w wydruku i odwrotnie.  Domyślnie,  gdy  wartość
              wynosi  zero,  podstawowy  rozmiar  czcionki  jest wybierany na podstawie wybranego
              profilu wyjściowego.

       --change-justification
              Zmień justowanie. Wartość "lewy" wyrówna cały tekst do  lewej.  Wartość  "wyjustuj"
              dokona  wyjustowania  całego  tekstu.  Wartość  "oryginalny"  (domyślna) nie zmieni
              justowania w pliku źródłowym.  Weź  pod  uwagę  fakt,  że  tylko  niektóre  formaty
              obsługują justowanie.

       --disable-font-rescaling
              Nie skaluj rozmiaru czcionek.

       --embed-all-fonts
              Osadź  wszystkie  czcionki,  które  zostały  użyte w dokumencie wejściowym, ale nie
              zostały jeszcze w nim osadzone. Spowoduje to przeszukanie  systemu  w  poszukiwaniu
              potrzebnych  czcionek,  a  jeśli  zostaną  one znalezione, osadzenie ich w e-booku.
              Działa to wyłącznie w przypadku formatów, które obsługują osadzanie czcionek takich
              jak  EPUB,  AZW3,  DOCX  lub  PDF. Upewnij się, że masz licencję, jeśli nie używasz
              darmowych czcionek.

       --embed-font-family
              Osadź wybraną czcionkę w pliku książki. Czcionka jest traktowana jako "bazowa"  dla
              książki.  Jeśli  dokument  wejściowy  używa  osobnej czcionki, jego ustawienia mogą
              nadpisać tę czcionkę bazową. Można  użyć  filtrów  stylów  aby  usunąć  czcionkę  z
              dokumentu  wejściowego.  Należy  pamiętać,  że  osadzanie  czcionek  działa tylko w
              niektórych formatach, głównie EPUB, AZW3 i DOCX.

       --expand-css
              Domyślnie calibre  używa  skróconych  form  właściwości  CSS,  takich  jak  margin,
              padding,  border  itp.  Ta  opcja  spowoduje,  że zostaną użyte pełne formy zamiast
              skróconych. Pełne wersje są zawsze używane przy generowaniu  EPUBów  przy  wybranym
              jednym z profili wyjściowych Nook ponieważ Nook nie obsługuje skróconych form CSS.

       --extra-css
              Ścieżka do pliku stylów CSS lub sam CSS. Plik CSS zostanie dodany to stylów z pliku
              źródłowego, może więc zostać użyty do nadpisania tych zasad.

       --filter-css
              Oddzielana przecinkami lista właściwości CSS, które  będą  usunięte  ze  wszystkich
              arkuszy stylów. Jest to użyteczne jeśli jakieś formatowanie koliduje z ustawieniami
              na czytniku. Przykładem może być font-family, color, margin-left, margin-right.

       --font-size-mapping
              Mapowanie z rozmiarów czcionek w CSS na rozmiar w punktach. Przykładowe  ustawienia
              to:  10,12,14,16,18,20,22,24.  Są to mapowania dla rozmiarów od xx-mały do xx-duży,
              gdzie ostatni rozmiar  jest  bardzo  duży.  Algorytm  przeskalowywania  używa  tych
              rozmiarów,  aby  inteligentnie  zmieniać  wielkość czcionki. Domyślnie używane jest
              mapowanie bazujące na wybranym profilu wyjściowym.

       --insert-blank-line
              Wstaw pusty wiersz pomiędzy akapitami. Ustawienie nie będzie  działać,  jeśli  plik
              źródłowy nie używa akapitów (znaczników <p> lub <div>).

       --insert-blank-line-size
              Podaj  wysokość  pustych  wierszy  (w  em).  Puste  wiersze  między  akapitami będą
              dwukrotnie większe niż ustawiona tu wartość.

       --keep-ligatures
              Zachowuj ligatury istniejące w dokumencie. Ligatura to szczególna para znaków, taka
              jak  ff,  fi,  fl  i  inne.  Większość domyślnych czcionek w czytnikach nie zawiera
              ligatur, więc  ich  prawidłowe  wyświetlanie  jest  mało  prawdopodobne.  Domyślnie
              calibre  zamienia ligaturę na odpowiadające jej standardowe znaki. Po włączeniu tej
              opcji ligatury będą zachowywane.

       --line-height
              Wysokość  wiersza  w  punktach.  Służy  do  ustawienia  odstępu  między  sąsiednimi
              wierszami.  Jest  stosowana  tylko  w  tych  elementach,  które nie mają określonej
              własnej wysokości wiersza. W większości przypadków bardziej  użyteczna  jest  opcja
              "minimalna wysokość wiersza". Domyślnie wysokość wiersza nie jest zmieniana.

       --linearize-tables
              Niektóre  źle  zaprojektowane  dokumenty  używają tabel do rozmieszczenia tekstu na
              stronie. Często po konwersji w takich dokumentach pojawia się tekst wychodzący poza
              stronę  i  inne  błędy.  Ta opcja wydobędzie tekst z tabel i przedstawi go w sposób
              ciągły.

       --margin-bottom
              Ustaw dolny margines w pkt. Domyślnie jest %d to  ustawienie  domyślne.  Ustawienie
              wartości   mniejszej  niż  zero  spowoduje,  że  margines  nie  zostanie  ustawiony
              (ustawienie marginesu w oryginalnym dokumencie zostanie zachowane). Uwaga:  formaty
              zorientowane  na  strony,  takie jak PDF i DOCX, mają własne ustawienia marginesów,
              które mają pierwszeństwo.

       --margin-left
              Ustaw lewy margines w pkt. Domyślnie jest %d  to  ustawienie  domyślne.  Ustawienie
              wartości   mniejszej  niż  zero  spowoduje,  że  margines  nie  zostanie  ustawiony
              (ustawienie marginesu w oryginalnym dokumencie zostanie zachowane). Uwaga:  formaty
              zorientowane  na  strony,  takie jak PDF i DOCX, mają własne ustawienia marginesów,
              które mają pierwszeństwo.

       --margin-right
              Ustaw prawy margines w pkt. Domyślnie jest %d to  ustawienie  domyślne.  Ustawienie
              wartości   mniejszej  niż  zero  spowoduje,  że  margines  nie  zostanie  ustawiony
              (ustawienie marginesu w oryginalnym dokumencie zostanie zachowane). Uwaga:  formaty
              zorientowane  na  strony,  takie jak PDF i DOCX, mają własne ustawienia marginesów,
              które mają pierwszeństwo.

       --margin-top
              Ustaw górny margines w pkt. Domyślnie jest %d to  ustawienie  domyślne.  Ustawienie
              wartości   mniejszej  niż  zero  spowoduje,  że  margines  nie  zostanie  ustawiony
              (ustawienie marginesu w oryginalnym dokumencie zostanie zachowane). Uwaga:  formaty
              zorientowane  na  strony,  takie jak PDF i DOCX, mają własne ustawienia marginesów,
              które mają pierwszeństwo.

       --minimum-line-height
              Minimalna wysokość wiersza, zależna od rozmiaru czcionki wyliczonego dla  elementu.
              calibre  będzie  pilnować, aby każdy element miał wysokość wiersza nie mniejszą niż
              ustawiona wartość, niezależnie od tego, co określa  dokument  wejściowy.  Ustaw  tę
              wartość  na  zero,  aby  wyłączyć. Domyślnie wynosi ona 120%. Użyj tego ustawienia,
              zamiast bezpośredniego ustawienia wysokości wiersza, chyba że wiesz co  robisz.  Na
              przykład,  można  uzyskać  tekst  o  „podwójnym  odstępie między wierszami” poprzez
              ustawienie wartości na 240.

       --remove-paragraph-spacing
              Usuwa odstęp pomiędzy akapitami. Ustawia również wcięcie akapitu w wielkości 1.5em.
              Usuwanie  odstępu nie zadziała, jeśli plik wejściowy nie używa akapitów (znaczników
              <p> lub <div>).

       --remove-paragraph-spacing-indent-size
              Kiedy calibre usuwa puste wiersze między akapitami,  automatycznie  dodaje  wcięcia
              akapitowe,  by  umożliwić  rozpoznanie  struktury tekstu. Ta opcja określa wielkość
              wcięcia akapitowego (w em). Ustawienie  wartości  ujemnej  spowoduje,  że  zostanie
              użyta  wartość ustawiona w dokumencie źródłowym, czyli praktycznie wcięcie nie jest
              zmieniane.

       --smarten-punctuation
              Konwertuj zwykłe cudzysłowy, myślniki i wielokropki na ich poprawne  typograficznie
              odpowiedniki.       Aby       uzyskać      szczegółowe      informacje,      zobacz
              https://daringfireball.net/projects/smartypants.

       --subset-embedded-fonts
              Zredukuj osadzone czcionki. Każda osadzona czcionka zostanie zredukowana  tak,  aby
              zawierała  tylko znaki wykorzystywane w tym dokumencie. Zmniejszy to rozmiar plików
              z  czcionkami.  Przydatne  przy  korzystaniu   z   czcionek   zawierających   wiele
              niewykorzystywanych znaków.

       --transform-css-rules
              Ścieżka  do  pliku  zawierającego  reguły  przetwarzania  stylów CSS w tej książce.
              Najprostszym sposobem,  by  stworzyć  taki  plik,  jest  użycie  kreatora  reguł  w
              interfejsie  calibre.  Dostań  się  do  niego przez sekcję „Look & Fell → Transform
              styles” dialogu konwersji. Kiedy stworzysz reguły, możesz użyć przycisku "Eksport",
              aby zapisać je do pliku.

       --transform-html-rules
              Ścieżka  do  pliku  zawierającego  reguły  przekształcania kodu HTML w tej książce.
              Najłatwiejszym sposobem utworzenia  takiego  pliku  jest  skorzystanie  z  kreatora
              tworzenia  reguł  w  GUI  kalibru.  Uzyskaj  do  niego  dostęp  w  sekcji „Wygląd i
              styl->Przekształć kod HTML” w  oknie  dialogowym  konwersji.  Po  utworzeniu  reguł
              możesz użyć przycisku „Eksportuj”, aby zapisać je do pliku.

       --unsmarten-punctuation
              Przekształć   typograficzne   cudzysłowy,   myślniki   i   wielokropki   na  zwykłe
              odpowiedniki.

PRZETWARZANIE HEURYSTYCZNE

       Zmodyfikuj tekst i strukturę używając  wzorców.  Domyślnie  wyłączone.  Aby  włączyć  użyj
       --enable-heuristics. Poszczególne akcje mogą zostać wyłączone przy użyciu --disable-
       *
       .

       --disable-dehyphenate
              Przeanalizuj  podzielone  słowa  w  całym  dokumencie.  Dokument  jest używany jako
              słownik do ustalenia czy łączniki powinny być zachowane, czy usunięte.

       --disable-delete-blank-paragraphs
              Usuń z dokumentu puste akapity, gdy występują one pomiędzy co drugim akapitem

       --disable-fix-indents
              Zamień wcięcie składające się z wielokrotnych nierozdzielających spacji na  wcięcia
              CSS.

       --disable-format-scene-breaks
              Podziały  scen  są  wycentrowane.  Zamień  podziały  scen, które wykorzystują wiele
              wierszy na linie poziome.

       --disable-italicize-common-cases
              Sprawdź najczęściej używane wyrazy i wzorce, które są oznaczane  kursywą  i  pochyl
              je.

       --disable-markup-chapter-headings
              Wykryj niesformatowane tytuły rozdziałów i podrozdziałów. Zamień je na znaczniki h2
              i h3. To ustawienie nie wygeneruje spisu treści, ale  razem  z  detekcją  struktury
              może być użyte do jego stworzenia.

       --disable-renumber-headings
              Wyszukuje  wystąpienia  kolejnych  znaczników  <h1> lub <h2>. Znaczniki są ponownie
              numerowane, aby zapobiec podziałowi w środku nagłówka rozdziału.

       --disable-unwrap-lines
              Usuwaj podziały wierszy na podstawie użytej interpunkcji i formatowania.

       --enable-heuristics
              Włącz przetwarzanie  heurystyczne.  Ta  opcja  musi  być  włączona,  aby  nastąpiło
              jakiekolwiek przetwarzanie heurystyczne.

       --html-unwrap-factor
              Współczynnik  wykorzystywany  do  określenia  długości, przy której wiersz powinien
              pozostać nieprzełamany. Wartość powinna być z przedziału 0 do 1.  Domyślna  wartość
              to  0.4, poniżej połowy długości wiersza. W przypadku, gdy w dokumencie tylko kilka
              wierszy ma pozostać nieprzełamanych ta wartość powinna zostać zmniejszona

       --replace-scene-breaks
              Zamień  zmiany  sceny  na  określony  tekst.  Domyślnie  wykorzystany  jest   tekst
              pochodzący z dokumentu wejściowego.

WYSZUKAJ I ZASTĄP

       Modyfikuj   tekst  dokumentu  i  jego  strukturę,  używając  wzorów  zdefiniowanych  przez
       użytkownika.

       --search-replace
              Ścieżka do pliku zawierającego wyrażenia regularne  wyszukiwania  i  zamiany.  Plik
              musi  zawierać  naprzemiennie wiersze wzorca wyszukiwania i zamiany (wiersz zamiany
              może być pusty). Wyrażenie musi być poprawnym wyrażeniem regularnym Pythona, a plik
              musi być kodowany w UTF-8.

       --sr1-replace
              Tekst, który zastąpi ciąg znaleziony za pomocą sr1-search.

       --sr1-search
              Wzorzec (wyrażenie regularne), który ma zostać zastąpiony przez sr1-replace.

       --sr2-replace
              Tekst, który zastąpi ciąg znaleziony za pomocą sr2-search.

       --sr2-search
              Wzorzec (wyrażenie regularne), który ma zostać zastąpiony przez sr2-replace.

       --sr3-replace
              Tekst, który zastąpi ciąg znaleziony za pomocą sr3-search.

       --sr3-search
              Wzorzec (wyrażenie regularne), który ma zostać zastąpiony przez sr3-replace.

WYKRYWANIE STRUKTURY

       Kontrola autodetekcji struktury dokumentu.

       --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
              Określ jak zaznaczać wykryte rozdziały. Wartość "pagebreak"  dzieli  stronę  między
              rozdziałami. Wartość "linia" wstawia linię przed rozdziałem. Wartość "brak" wyłącza
              zaznaczanie rozdziałów, a "wszystko" włącza linie i podział strony jednocześnie.

       --disable-remove-fake-margins
              Niektóre dokumenty określają marginesy strony poprzez określenie lewego  i  prawego
              marginesu  dla  każdego  akapitu indywidualnie. calibre spróbuje wykryć i usunąć te
              marginesy. Czasami może to  spowodować  usunięcie  marginesów,  które  nie  powinny
              zostać usunięte. W takim przypadku możesz wyłączyć usuwanie.

       --insert-metadata
              Wstaw  metadane na początku książki. Jest to przydatne, jeśli czytnik nie obsługuje
              bezpośrednio wyświetlania/wyszukiwania metadanych.

       --page-breaks-before
              Wyrażenie  XPath.  Przełamanie  stron  zostanie  wprowadzone  przed   odnalezionymi
              elementami. Aby wyłączyć tę funkcję podaj: /

       --prefer-metadata-cover
              Preferuj okładkę z pliku źródłowego w stosunku do wybranej okładki.

       --remove-first-image
              Usuń  pierwszy  obrazek  ze  źródłowej  książki.  Opcja  przydaje się jeśli książka
              zawiera obrazek okładki, który nie jest  identyfikowany  jako  okładka.  W  efekcie
              jeśli  dodasz swoją okładkę, w calibre książka będzie miała dwie okładki, jeśli nie
              ustawisz tej opcji.

       --start-reading-at
              Wyrażenie XPath wykrywające miejsce w tekście, od którego należy  zacząć  czytanie.
              Niektóre programy do czytania ebooków (szczególnie Kindle) używają tej lokacji jako
              miejsca, w którym otwierają książkę. Więcej informacji można znaleźć w sekcji XPath
              Tutorial, w podręczniku calibre.

SPIS TREŚCI

       Kontroluje  automatyczne  generowanie  spisu treści. Domyślnie, jeśli plik źródłowy ma już
       spis treści, to ma on pierwszeństwo przed tym wygenerowanym automatycznie.

       --duplicate-links-in-toc
              Umożliwia umieszczenie powtarzających się pozycji przy  tworzeniu  spisu  treści  z
              odsyłaczy  w  dokumencie  na  przykład kilka razy tego samego słowa, odsyłającego w
              różne miejsca.

       --level1-toc
              Wyrażenie XPath określające znaczniki, które powinny zostać dodane do spisu  treści
              na  pierwszym  poziomie.  Jeśli  wyrażenie  zostanie dodane, ma pierwszeństwo przed
              innymi sposobami autodetekcji. Więcej informacji na  temat  XPath  znajduje  się  w
              sekcji XPath Tutorial, w podręczniku użytkownika calibre.

       --level2-toc
              Wyrażenie  XPath określające znaczniki, które powinny zostać dodane do spisu treści
              na drugim poziomie.  Każdy  element  jest  dodawany  w  hierarchii  pod  poprzednim
              elementem  pierwszego  poziomu.  Więcej  informacji  na  temat XPath znajduje się w
              sekcji XPath Tutorial, w podręczniku użytkownika calibre.

       --level3-toc
              Wyrażenie XPath określające znaczniki, które powinny zostać dodane do spisu  treści
              na  trzecim  poziomie.  Każdy  element  jest  dodawany  w hierarchii pod poprzednim
              elementem drugiego poziomu. Więcej informacji na temat XPath znajduje się w  sekcji
              XPath Tutorial, w podręczniku użytkownika calibre.

       --max-toc-links
              Maksymalna  liczba odnośników do wstawienia do spisu treści. Ustaw tę wartość na 0,
              aby wyłączyć. Domyślnie ustawienie: 50. Odnośniki są dodawane do spisu treści tylko
              jeśli odnaleziono mniej rozdziałów niż określony próg.

       --no-chapters-in-toc
              Nie dodawaj automatycznie wykrytych rozdziałów do spisu treści.

       --toc-filter
              Usuwa  te  pozycje ze spisu treści, których tytuły pasują do określonego wyrażenia.
              Zostaną usunięte pasujące i wszystkie ich podrzędne pozycje.

       --toc-threshold
              Jeśli zostanie wykryte mniej rozdziałów niż podano, odnośniki są dodawane do  spisu
              treści. Domyślnie: 6

       --use-auto-toc
              Zazwyczaj,  jeżeli plik źródłowy ma już spis treści, jest on wykorzystywany zamiast
              wygenerowanego  automatycznie.  Z  tą  opcją  zawsze  używany   jest   wygenerowany
              automatycznie spis treści.

METADANE

       Opcje odpowiedzialne za ustawienia metadanych w plikach wyjściowych

       --author-sort
              Łańcuch znaków używany przy sortowaniu po autorze.

       --authors
              Wpisz  autorów. Jeśli jest więcej niż jeden, należy oddzielić ich znakami ampersand
              ("&").

       --book-producer
              Podaj producenta książki (w Polsce nie praktykowane).

       --comments
              Ustaw opis dla e-booka.

       --cover
              Ustaw okładkę wybierając plik lub podając adres URL

       --isbn Wpisz numer ISBN książki.

       --language
              Podaj język.

       --pubdate
              Ustaw datę publikacji (zakłada się, że znajduje się w  lokalnej  strefie  czasowej,
              chyba że strefa czasowa jest wyraźnie określona)

       --publisher
              Ustaw wydawcę e-booka.

       --rating
              Wpisz ocenę. Musi to być cyfra pomiędzy 1 a 5.

       --read-metadata-from-opf, --from-opf, -m
              Odczytaj  metadane  z wybranego pliku OPF. Metadane odczytane z tego pliku nadpiszą
              wszystkie metadane pliku źródłowego.

       --series
              Wybierz serie, do których należy ta książka.

       --series-index
              Podaj numer książki w cyklu.

       --tags Wpisz etykiety dla książki. Kolejne etykiety oddzielaj przecinkami.

       --timestamp
              Ustaw stempel czasowy książki (nie używane nigdzie indziej)

       --title
              Wpisz tytuł.

       --title-sort
              Wersja tytułu używana przy sortowaniu.

DEBUG

       Opcje pomocy przy debugowaniu konwersji

       --debug-pipeline, -d
              Zapisz dane wyjściowe z różnych etapów  potoku  konwersji  w  określonym  folderze.
              Przydatne,  jeśli  nie  masz pewności, na którym etapie procesu konwersji występuje
              błąd.

       --verbose, -v
              Poziom komunikatów. Im więcej razy jest podany, tym komunikaty będą  obszerniejsze.
              Podanie  parametru  dwa razy to maksymalna ilość informacji, raz - normalna, a przy
              braku parametru komunikaty będą zawierały minimum informacji.

AUTHOR

       Kovid Goyal

COPYRIGHT

       Kovid Goyal