.\" Man page generated from reStructuredText. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "EBOOK-CONVERT" "1" "kwietnia 19, 2024" "7.9.0" "calibre" .SH NAME ebook-convert \- ebook-convert .INDENT 0.0 .INDENT 3.5 .sp .nf .ft B ebook\-convert input_file output_file [options] .ft P .fi .UNINDENT .UNINDENT .sp Konwertuj e\-booka z jednego formatu na inny. .sp input_file to dane wejściowe, a output_file to dane wyjściowe. Oba muszą być podane jako pierwsze dwa argumenty polecenia. .sp 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. .sp 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. .sp Pełna dokumentacja systemu konwersji zobacz \fI\%Konwersja książek\fP .sp Ilekroć przekazujesz argumenty do \fBebook\-convert\fP, które zawierają spacje, ujmuj je w cudzysłowy. Na przykład: \(dq/some path/with spaces\(dq .sp 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ć: .INDENT 0.0 .INDENT 3.5 ebook\-convert myfile.input_format myfile.output_format \-h .UNINDENT .UNINDENT .sp 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. .INDENT 0.0 .IP \(bu 2 \fI\%OPCJE PLIKU ŹRÓDŁOWEGO\fP .IP \(bu 2 \fI\%OPCJE PLIKU WYJŚCIOWEGO\fP .IP \(bu 2 \fI\%WYGLĄD\fP .IP \(bu 2 \fI\%PRZETWARZANIE HEURYSTYCZNE\fP .IP \(bu 2 \fI\%WYSZUKAJ I ZASTĄP\fP .IP \(bu 2 \fI\%WYKRYWANIE STRUKTURY\fP .IP \(bu 2 \fI\%SPIS TREŚCI\fP .IP \(bu 2 \fI\%METADANE\fP .IP \(bu 2 \fI\%DEBUG\fP .UNINDENT .INDENT 0.0 .TP .B \-\-help, \-h wyświetla ten tekst pomocy i kończy działanie .UNINDENT .INDENT 0.0 .TP .B \-\-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 .UNINDENT .INDENT 0.0 .TP .B \-\-list\-recipes Lista wbudowanych źródeł. Korzystając ze źródła możesz utworzyć e\-booka za pomocą polecenia ebook\-convert \fB\(dq\fPNazwa źródła.recipe\fB\(dq\fP wynik.epub .UNINDENT .INDENT 0.0 .TP .B \-\-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 .UNINDENT .INDENT 0.0 .TP .B \-\-version wyświetla wersję programu i kończy działanie .UNINDENT .SH OPCJE PLIKU ŹRÓDŁOWEGO .sp Opcje sterujące przetwarzaniem pliku źródłowego mobi .INDENT 0.0 .TP .B \-\-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ę. .UNINDENT .SH OPCJE PLIKU WYJŚCIOWEGO .sp Opcje sterujące przetwarzaniem pliku wyjściowego epub .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-epub\-inline\-toc Wstaw spis treści, który będzie stanowił część książki. .UNINDENT .INDENT 0.0 .TP .B \-\-epub\-max\-image\-size Maksymalny rozmiar obrazu (szerokość x wysokość). Wartość none oznacza użycie rozmiaru ekranu z profilu wyjściowego. Wartość profile 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. .UNINDENT .INDENT 0.0 .TP .B \-\-epub\-toc\-at\-end Umieść wstawiany spis treści na końcu książki zamiast na początku. .UNINDENT .INDENT 0.0 .TP .B \-\-epub\-version Wersja pliku EPUB, która zostanie wygenerowana. EPUB 2 jest najbardziej kompatybilny, skorzystaj z EPU\fB\(dq\fPB 3 jeśli tylko wiesz, że takiej wersji potrzebujesz. .UNINDENT .INDENT 0.0 .TP .B \-\-extract\-to Wyodrębnij zawartość wygenerowanego pliku EPUB do określonego folderu. Zawartość folderu jest najpierw usuwana, więc bądź ostrożny. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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ę. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-toc\-title Tytuł dla automatycznie wygenerowanego spisu treści. .UNINDENT .SH WYGLĄD .sp Opcje umożliwiające kontrolę nad wyglądem pliku wyjściowego .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-change\-justification Zmień justowanie. Wartość \fB\(dq\fPlewy\fB\(dq\fP wyrówna cały tekst do lewej. Wartość \fB\(dq\fPwyjustuj\fB\(dq\fP dokona wyjustowania całego tekstu. Wartość \fB\(dq\fPoryginalny\fB\(dq\fP (domyślna) nie zmieni justowania w pliku źródłowym. Weź pod uwagę fakt, że tylko niektóre formaty obsługują justowanie. .UNINDENT .INDENT 0.0 .TP .B \-\-disable\-font\-rescaling Nie skaluj rozmiaru czcionek. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-embed\-font\-family Osadź wybraną czcionkę w pliku książki. Czcionka jest traktowana jako \fB\(dq\fPbazowa\fB\(dq\fP 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. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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 .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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

lub

). .UNINDENT .INDENT 0.0 .TP .B \-\-insert\-blank\-line\-size Podaj wysokość pustych wierszy (w em). Puste wiersze między akapitami będą dwukrotnie większe niż ustawiona tu wartość. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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 \fB\(dq\fPminimalna wysokość wiersza\fB\(dq\fP\&. Domyślnie wysokość wiersza nie jest zmieniana. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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

lub

). .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-smarten\-punctuation Konwertuj zwykłe cudzysłowy, myślniki i wielokropki na ich poprawne typograficznie odpowiedniki. Aby uzyskać szczegółowe informacje, zobacz \fI\%https://daringfireball.net/projects/smartypants\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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 \fB\(dq\fPEksport\fB\(dq\fP, aby zapisać je do pliku. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-unsmarten\-punctuation Przekształć typograficzne cudzysłowy, myślniki i wielokropki na zwykłe odpowiedniki. .UNINDENT .SH PRZETWARZANIE HEURYSTYCZNE .sp 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\- .nf * .fi \&. .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-disable\-delete\-blank\-paragraphs Usuń z dokumentu puste akapity, gdy występują one pomiędzy co drugim akapitem .UNINDENT .INDENT 0.0 .TP .B \-\-disable\-fix\-indents Zamień wcięcie składające się z wielokrotnych nierozdzielających spacji na wcięcia CSS. .UNINDENT .INDENT 0.0 .TP .B \-\-disable\-format\-scene\-breaks Podziały scen są wycentrowane. Zamień podziały scen, które wykorzystują wiele wierszy na linie poziome. .UNINDENT .INDENT 0.0 .TP .B \-\-disable\-italicize\-common\-cases Sprawdź najczęściej używane wyrazy i wzorce, które są oznaczane kursywą i pochyl je. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-disable\-renumber\-headings Wyszukuje wystąpienia kolejnych znaczników

lub

. Znaczniki są ponownie numerowane, aby zapobiec podziałowi w środku nagłówka rozdziału. .UNINDENT .INDENT 0.0 .TP .B \-\-disable\-unwrap\-lines Usuwaj podziały wierszy na podstawie użytej interpunkcji i formatowania. .UNINDENT .INDENT 0.0 .TP .B \-\-enable\-heuristics Włącz przetwarzanie heurystyczne. Ta opcja musi być włączona, aby nastąpiło jakiekolwiek przetwarzanie heurystyczne. .UNINDENT .INDENT 0.0 .TP .B \-\-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 .UNINDENT .INDENT 0.0 .TP .B \-\-replace\-scene\-breaks Zamień zmiany sceny na określony tekst. Domyślnie wykorzystany jest tekst pochodzący z dokumentu wejściowego. .UNINDENT .SH WYSZUKAJ I ZASTĄP .sp Modyfikuj tekst dokumentu i jego strukturę, używając wzorów zdefiniowanych przez użytkownika. .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-sr1\-replace Tekst, który zastąpi ciąg znaleziony za pomocą sr1\-search. .UNINDENT .INDENT 0.0 .TP .B \-\-sr1\-search Wzorzec (wyrażenie regularne), który ma zostać zastąpiony przez sr1\-replace. .UNINDENT .INDENT 0.0 .TP .B \-\-sr2\-replace Tekst, który zastąpi ciąg znaleziony za pomocą sr2\-search. .UNINDENT .INDENT 0.0 .TP .B \-\-sr2\-search Wzorzec (wyrażenie regularne), który ma zostać zastąpiony przez sr2\-replace. .UNINDENT .INDENT 0.0 .TP .B \-\-sr3\-replace Tekst, który zastąpi ciąg znaleziony za pomocą sr3\-search. .UNINDENT .INDENT 0.0 .TP .B \-\-sr3\-search Wzorzec (wyrażenie regularne), który ma zostać zastąpiony przez sr3\-replace. .UNINDENT .SH WYKRYWANIE STRUKTURY .sp Kontrola autodetekcji struktury dokumentu. .INDENT 0.0 .TP .B \-\-chapter Wyrażenie XPath do wykrywania tytułów rozdziałów. Domyślnie znaczniki

lub

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. .UNINDENT .INDENT 0.0 .TP .B \-\-chapter\-mark Określ jak zaznaczać wykryte rozdziały. Wartość \fB\(dq\fPpagebreak\fB\(dq\fP dzieli stronę między rozdziałami. Wartość \fB\(dq\fPlinia\fB\(dq\fP wstawia linię przed rozdziałem. Wartość \fB\(dq\fPbrak\fB\(dq\fP wyłącza zaznaczanie rozdziałów, a \fB\(dq\fPwszystko\fB\(dq\fP włącza linie i podział strony jednocześnie. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-insert\-metadata Wstaw metadane na początku książki. Jest to przydatne, jeśli czytnik nie obsługuje bezpośrednio wyświetlania/wyszukiwania metadanych. .UNINDENT .INDENT 0.0 .TP .B \-\-page\-breaks\-before Wyrażenie XPath. Przełamanie stron zostanie wprowadzone przed odnalezionymi elementami. Aby wyłączyć tę funkcję podaj: / .UNINDENT .INDENT 0.0 .TP .B \-\-prefer\-metadata\-cover Preferuj okładkę z pliku źródłowego w stosunku do wybranej okładki. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .SH SPIS TREŚCI .sp 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. .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-no\-chapters\-in\-toc Nie dodawaj automatycznie wykrytych rozdziałów do spisu treści. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-toc\-threshold Jeśli zostanie wykryte mniej rozdziałów niż podano, odnośniki są dodawane do spisu treści. Domyślnie: 6 .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .SH METADANE .sp Opcje odpowiedzialne za ustawienia metadanych w plikach wyjściowych .INDENT 0.0 .TP .B \-\-author\-sort Łańcuch znaków używany przy sortowaniu po autorze. .UNINDENT .INDENT 0.0 .TP .B \-\-authors Wpisz autorów. Jeśli jest więcej niż jeden, należy oddzielić ich znakami ampersand (\fB\(dq\fP&\fB\(dq\fP). .UNINDENT .INDENT 0.0 .TP .B \-\-book\-producer Podaj producenta książki (w Polsce nie praktykowane). .UNINDENT .INDENT 0.0 .TP .B \-\-comments Ustaw opis dla e\-booka. .UNINDENT .INDENT 0.0 .TP .B \-\-cover Ustaw okładkę wybierając plik lub podając adres URL .UNINDENT .INDENT 0.0 .TP .B \-\-isbn Wpisz numer ISBN książki. .UNINDENT .INDENT 0.0 .TP .B \-\-language Podaj język. .UNINDENT .INDENT 0.0 .TP .B \-\-pubdate Ustaw datę publikacji (zakłada się, że znajduje się w lokalnej strefie czasowej, chyba że strefa czasowa jest wyraźnie określona) .UNINDENT .INDENT 0.0 .TP .B \-\-publisher Ustaw wydawcę e\-booka. .UNINDENT .INDENT 0.0 .TP .B \-\-rating Wpisz ocenę. Musi to być cyfra pomiędzy 1 a 5. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-series Wybierz serie, do których należy ta książka. .UNINDENT .INDENT 0.0 .TP .B \-\-series\-index Podaj numer książki w cyklu. .UNINDENT .INDENT 0.0 .TP .B \-\-tags Wpisz etykiety dla książki. Kolejne etykiety oddzielaj przecinkami. .UNINDENT .INDENT 0.0 .TP .B \-\-timestamp Ustaw stempel czasowy książki (nie używane nigdzie indziej) .UNINDENT .INDENT 0.0 .TP .B \-\-title Wpisz tytuł. .UNINDENT .INDENT 0.0 .TP .B \-\-title\-sort Wersja tytułu używana przy sortowaniu. .UNINDENT .SH DEBUG .sp Opcje pomocy przy debugowaniu konwersji .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .SH AUTHOR Kovid Goyal .SH COPYRIGHT Kovid Goyal .\" Generated by docutils manpage writer. .