.\" 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" "lutego 14, 2025" "7.26.0" "calibre"
.SH NAME
ebook-convert \- ebook-convert
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ebook\-convert input_file output_file [options]
.EE
.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ł 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 <p> lub <div>).
.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
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ć.
.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 <p> lub <div>).
.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 \X'tty: link https://daringfireball.net/projects/smartypants'\fI\%https://daringfireball.net/projects/smartypants\fP\X'tty: link'\&.
.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 <h1> lub <h2>. 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 \-\-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 jest używany przez czytniki ekranu do pomocy osobom niedowidzącym.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-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.
.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.
.
