EBOOK-CONVERT(1)

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 <#conversion>

Ilekroć przekazujesz argumenty do ebook-convert, które zawierają spacje, ujmuj je w cudzysłowy. Na przykład: "/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ŁOWEGO

    •   OPCJE PLIKU WYJŚCIOWEGO

    •   WYGLĄD

    •   PRZETWARZANIE HEURYSTYCZNE

    •   WYSZUKAJ I ZASTĄP

    •   WYKRYWANIE STRUKTURY

    •   SPIS TREŚCI

    •   METADANE

    •   DEBUG

    --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 stanowi informację dla systemu konwersji jak zoptymalizować tworzony dokument dla wybranego urządzenia. W niektórych przypadkach profil wyjściowy może posłużyć do optymalizacji dla konkretnego urządzenia, ale to jest rzadko wymagane. Do wyboru jest: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-max-image-size
        Maksymalny rozmiar obrazu (szerokość x wysokość). Wartość profile oznacza użycie rozmiaru ekranu z profilu wyjściowego. Wartość none oznacza, że nie określono maksymalnego rozmiaru. Na przykład wartość 100x200 spowoduje, że rozmiar wszystkich obrazów zostanie zmieniony tak, aby ich szerokość nie przekraczała 100 pikseli, a wysokość nie przekraczała 200 pikseli. Należy pamiętać, że wpływa to tylko na rozmiar samych plików graficznych. Dowolny obraz może być renderowany w innym rozmiarze w zależności od stylizacji zastosowanej do niego w dokumencie.

    --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ść wygenerowanej książki do określonego folderu. Zawartość folderu zostanie najpierw usunięta, więc należy zachować ostrożność.

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

    --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
        Zachowuje ligatury obecne w dokumencie wejściowym. Ligatura to połączony znak pary znaków, takich jak ff, fi, fl itp. Większość czytników nie obsługuje ligatur w swoich domyślnych czcionkach, więc jest mało prawdopodobne, aby były one poprawnie renderowane. Domyślnie calibre zamieni ligaturę w odpowiadającą jej parę normalnych znaków. Należy pamiętać, że ligatury oznaczają tutaj tylko ligatury Unicode, a nie ligatury utworzone za pomocą CSS lub stylów czcionek. Ta opcja spróbuje je zachować.

    --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
        Convert plain quotes, dashes and ellipsis to their typographically correct equivalents. For details, see: <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 calibre. 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.

    --add-alt-text-to-img
        Gdy znacznik <img> nie ma atrybutu alt, sprawdź powiązany plik obrazu pod kątem metadanych określających tekst alternatywny i użyj go do wypełnienia atrybutu alt. Atrybut alt poprawia dostępność poprzez dostarczanie opisów tekstowych dla użytkowników, którzy nie mogą zobaczyć lub w pełni zinterpretować treści wizualnych.

    --chapter
        Wyrażenie XPath do wykrywania tytułów rozdziałów. Domyślnie znaczniki <h1> lub <h2> zawierające słowa „rozdział”, „książka”, „sekcja”, „prolog”, „epilog” lub „część” są traktowane jako tytuły rozdziałów, jak również wszelkie znaczniki, które mają klasa = „rozdział”. Użyte wyrażenie musi być oceniane jako lista elementów. Aby wyłączyć wykrywanie rozdziałów, użyj wyrażenia „/”. Więcej informacji na temat korzystania z tej funkcji można znaleźć w samouczku XPath w podręczniku użytkownika calibre.

    --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 do wykrywania lokalizacji w dokumencie, w której należy rozpocząć czytanie. Niektóre programy do czytania e-booków (przede wszystkim Kindle) używają tej lokalizacji jako miejsca otwierania książki. Więcej informacji na temat korzystania z tej funkcji można znaleźć w samouczku XPath w podręczniku użytkownika 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