EBOOK-CONVERT(1) calibre 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 wejsciowe, a output_file to dane wyjsciowe. Oba
musza byc podane jako pierwsze dwa argumenty polecenia.
Wyjsciowy format e-booka jest odgadywany na podstawie rozszerzenia
pliku output_file. plik_wyjsciowy moze miec rowniez specjalny format
.EXT, gdzie EXT jest rozszerzeniem pliku wyjsciowego. W takim przypadku
nazwa pliku wyjsciowego pochodzi od nazwy pliku wejsciowego. Zauwaz, ze
nazwy plikow nie moga zaczynac sie od myslnika. Wreszcie, jesli
plik_wyjsciowy nie ma rozszerzenia, jest traktowany jako folder i do
tego folderu jest zapisywany ,,otwarty e-book" (OEB) skladajacy sie z
plikow HTML. Te pliki to pliki, ktore normalnie zostalyby przekazane do
wtyczki wyjsciowej.
Po okresleniu pliku wejsciowego i wyjsciowego mozesz dostosowac
konwersje, okreslajac rozne opcje. Dostepne opcje zaleza od typow
plikow wejsciowych i wyjsciowych. Aby uzyskac pomoc, podaj plik
wejsciowy i wyjsciowy, a nastepnie uzyj opcji -h.
Pelna dokumentacja systemu konwersji zobacz Konwersja ksiazek
Ilekroc przekazujesz argumenty do ebook-convert, ktore zawieraja
spacje, ujmuj je w cudzyslowy. Na przyklad: "/some path/with spaces"
Opcje i domyslne wartosci sa rozne w zaleznosci od formatu wejsciowego
i wyjsciowego, zawsze wiec nalezy je sprawdzic:
ebook-convert myfile.input_format myfile.output_format -h
Ponizej znajduja sie opcje wspolne dla wszystkich formatow, a nastepnie
te, ktore zaleza od formatu wejscia i wyjscia.
o OPCJE PLIKU ZRODLOWEGO
o OPCJE PLIKU WYJSCIOWEGO
o WYGLAD
o PRZETWARZANIE HEURYSTYCZNE
o WYSZUKAJ I ZASTAP
o WYKRYWANIE STRUKTURY
o SPIS TRESCI
o METADANE
o DEBUG
--help, -h
wyswietla ten tekst pomocy i konczy dzialanie
--input-profile
Okresl profil wejscia. Profil wejscia dyktuje systemowi
konwersji jak interpretowac rozne informacje w dokumencie
wejsciowym. Na przyklad dlugosci zalezne od rozdzielczosci (tj.
dlugosc 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 zrodel. Korzystajac ze zrodla mozesz utworzyc
e-booka za pomoca polecenia ebook-convert "Nazwa zrodla.recipe"
wynik.epub
--output-profile
Okresl profil wyjsciowy. Profil wyjsciowy stanowi informacje dla
systemu konwersji jak zoptymalizowac tworzony dokument dla
wybranego urzadzenia. W niektorych przypadkach profil wyjsciowy
moze posluzyc do optymalizacji dla konkretnego urzadzenia, 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
wyswietla wersje programu i konczy dzialanie
OPCJE PLIKU ZRODLOWEGO
Opcje sterujace przetwarzaniem pliku zrodlowego mobi
--input-encoding
Okresl kodowanie znakow dokumentu wejsciowego. Jesli ta opcja
zostanie wybrana, wybrane kodowanie zastapi to zadeklarowane w
dokumencie. Szczegolnie przydatne jest to w przypadku
dokumentow, ktore nie deklaruja kodowania lub ktore maja bledna
deklaracje.
OPCJE PLIKU WYJSCIOWEGO
Opcje sterujace przetwarzaniem pliku wyjsciowego epub
--dont-split-on-page-breaks
Wylacz dzielenie przy znaku podzialu strony. Zwykle pliki
wejsciowe sa automatycznie dzielone przy kazdym znaku podzialu
strony na dwa pliki. Dzieki temu ksiazka wyjsciowa moze byc
szybciej i wydajniej przetworzona. Jednakze, podzial jest
powolny i jesli plik zrodlowy zawiera duza ilosc znakow podzialu
strony, powinienes wylaczyc podzial przy znaku podzialu strony.
--epub-flatten
Ta opcja jest wymagana tylko wtedy, gdy zamierzasz wykorzystywac
EPUBa z czytnikiem FBReaderJ. To splaszczy system plikow
wewnatrz EPUBa, umieszczajac wszystkie pliki na najwyzszym
poziomie.
--epub-inline-toc
Wstaw spis tresci, ktory bedzie stanowil czesc ksiazki.
--epub-max-image-size
Maksymalny rozmiar obrazu (szerokosc x wysokosc). Wartosc none
oznacza uzycie rozmiaru ekranu z profilu wyjsciowego. Wartosc
profile oznacza, ze nie okreslono maksymalnego rozmiaru. Na
przyklad wartosc 100x200 spowoduje, ze rozmiar wszystkich
obrazow zostanie zmieniony tak, aby ich szerokosc nie
przekraczala 100 pikseli, a wysokosc nie przekraczala 200
pikseli. Nalezy pamietac, ze wplywa to tylko na rozmiar samych
plikow graficznych. Dowolny obraz moze byc renderowany w innym
rozmiarze w zaleznosci od stylizacji zastosowanej do niego w
dokumencie.
--epub-toc-at-end
Umiesc wstawiany spis tresci na koncu ksiazki zamiast na
poczatku.
--epub-version
Wersja pliku EPUB, ktora zostanie wygenerowana. EPUB 2 jest
najbardziej kompatybilny, skorzystaj z EPU"B 3 jesli tylko
wiesz, ze takiej wersji potrzebujesz.
--extract-to
Wyodrebnij zawartosc wygenerowanego pliku EPUB do okreslonego
folderu. Zawartosc folderu jest najpierw usuwana, wiec badz
ostrozny.
--flow-size
Dzielenie wszystkich plikow HTML wiekszych niz ten rozmiar (w
KB). Jest to konieczne, gdyz wiekszosc czytnikow EPUB nie
potrafi obsluzyc plikow o duzych rozmiarach. Domyslna wartosc
260 KB to rozmiar wymagany przez Adobe Digital Editions. Ustaw
na 0, aby wylaczyc dzielenie w oparciu o rozmiar.
--no-default-epub-cover
Zazwyczaj, jezeli plik zrodlowy nie ma okladki i nie wskazesz
odpowiedniej, jest generowana domyslna okladka zawierajaca
tytul, autora itp. Ta opcja wylacza tworzenie takiej okladki.
--no-svg-cover
Nie uzywaj SVG do okladki ksiazki. Uzyj tej opcji, jesli twoj
EPUB bedzie odczytywany na urzadzeniu, ktore nie wspiera SVG,
jak iPhone czy JetBook Lite. Bez tej opcji takie urzadzenia beda
wyswietlac okladke jako pusta strone.
--preserve-cover-aspect-ratio
Jesli okladka jest w postaci grafiki SVG, wlaczenie tej opcji
spowoduje zmiane rozmiaru okladki na caly dostepny obszar
ekranu, zachowujac jednak proporcje obrazu (stosunek jego
szerokosci do wysokosci). Oznacza to, ze na brzegach obrazu moga
pojawic sie biale pasy, nie zostanie on jednak znieksztalcony.
Wylaczenie tej opcji moze spowodowac lekkie znieksztalcenie
obrazu, nie pojawia sie natomiast biale pasy na brzegach.
--pretty-print
Jesli jest okreslony, wtyczka sprobuje wygenerowac jak
najbardziej czytelne dane. Dla niektorych wtyczek generujacych
dane wyjsciowe moze nie dawac to zadnych efektow.
--toc-title
Tytul dla automatycznie wygenerowanego spisu tresci.
WYGLAD
Opcje umozliwiajace kontrole nad wygladem pliku wyjsciowego
--asciiize
Transliteruj znaki Unicode do reprezentacji ASCII. Uzywaj
ostroznie, poniewaz spowoduje to zamiane znakow Unicode na
ASCII. Na przyklad zamieni ,,Pele" na ,,Pele". Nalezy rowniez
pamietac, ze w przypadkach, gdy istnieje wiele reprezentacji
znaku (znaki wspolne na przyklad w jezyku chinskim i japonskim),
zostanie uzyta reprezentacja oparta na biezacym jezyku
interfejsu calibre.
--base-font-size
Podstawowy rozmiar czcionki w pkt. Wszystkie rozmiary czcionek w
wyprodukowanej ksiazce zostana przeskalowane na podstawie tego
rozmiaru. Wybierajac wiekszy rozmiar, mozesz zwiekszyc czcionki
w wydruku i odwrotnie. Domyslnie, gdy wartosc wynosi zero,
podstawowy rozmiar czcionki jest wybierany na podstawie
wybranego profilu wyjsciowego.
--change-justification
Zmien justowanie. Wartosc "lewy" wyrowna caly tekst do lewej.
Wartosc "wyjustuj" dokona wyjustowania calego tekstu. Wartosc
"oryginalny" (domyslna) nie zmieni justowania w pliku zrodlowym.
Wez pod uwage fakt, ze tylko niektore formaty obsluguja
justowanie.
--disable-font-rescaling
Nie skaluj rozmiaru czcionek.
--embed-all-fonts
Osadz wszystkie czcionki, ktore zostaly uzyte w dokumencie
wejsciowym, ale nie zostaly jeszcze w nim osadzone. Spowoduje to
przeszukanie systemu w poszukiwaniu potrzebnych czcionek, a
jesli zostana one znalezione, osadzenie ich w e-booku. Dziala to
wylacznie w przypadku formatow, ktore obsluguja osadzanie
czcionek takich jak EPUB, AZW3, DOCX lub PDF. Upewnij sie, ze
masz licencje, jesli nie uzywasz darmowych czcionek.
--embed-font-family
Osadz wybrana czcionke w pliku ksiazki. Czcionka jest traktowana
jako "bazowa" dla ksiazki. Jesli dokument wejsciowy uzywa
osobnej czcionki, jego ustawienia moga nadpisac te czcionke
bazowa. Mozna uzyc filtrow stylow aby usunac czcionke z
dokumentu wejsciowego. Nalezy pamietac, ze osadzanie czcionek
dziala tylko w niektorych formatach, glownie EPUB, AZW3 i DOCX.
--expand-css
Domyslnie calibre uzywa skroconych form wlasciwosci CSS, takich
jak margin, padding, border itp. Ta opcja spowoduje, ze zostana
uzyte pelne formy zamiast skroconych. Pelne wersje sa zawsze
uzywane przy generowaniu EPUBow przy wybranym jednym z profili
wyjsciowych Nook poniewaz Nook nie obsluguje skroconych form
CSS.
--extra-css
Sciezka do pliku stylow CSS lub sam CSS. Plik CSS zostanie
dodany to stylow z pliku zrodlowego, moze wiec zostac uzyty do
nadpisania tych zasad.
--filter-css
Oddzielana przecinkami lista wlasciwosci CSS, ktore beda
usuniete ze wszystkich arkuszy stylow. Jest to uzyteczne jesli
jakies formatowanie koliduje z ustawieniami na czytniku.
Przykladem moze byc font-family, color, margin-left,
margin-right
--font-size-mapping
Mapowanie z rozmiarow czcionek w CSS na rozmiar w punktach.
Przykladowe ustawienia to: 10,12,14,16,18,20,22,24. Sa to
mapowania dla rozmiarow od xx-maly do xx-duzy, gdzie ostatni
rozmiar jest bardzo duzy. Algorytm przeskalowywania uzywa tych
rozmiarow, aby inteligentnie zmieniac wielkosc czcionki.
Domyslnie uzywane jest mapowanie bazujace na wybranym profilu
wyjsciowym.
--insert-blank-line
Wstaw pusty wiersz pomiedzy akapitami. Ustawienie nie bedzie
dzialac, jesli plik zrodlowy nie uzywa akapitow (znacznikow
lub
).
--insert-blank-line-size
Podaj wysokosc pustych wierszy (w em). Puste wiersze miedzy
akapitami beda dwukrotnie wieksze niz ustawiona tu wartosc.
--keep-ligatures
Zachowuj ligatury istniejace w dokumencie. Ligatura to
szczegolna para znakow, taka jak ff, fi, fl i inne. Wiekszosc
domyslnych czcionek w czytnikach nie zawiera ligatur, wiec ich
prawidlowe wyswietlanie jest malo prawdopodobne. Domyslnie
calibre zamienia ligature na odpowiadajace jej standardowe
znaki. Po wlaczeniu tej opcji ligatury beda zachowywane.
--line-height
Wysokosc wiersza w punktach. Sluzy do ustawienia odstepu miedzy
sasiednimi wierszami. Jest stosowana tylko w tych elementach,
ktore nie maja okreslonej wlasnej wysokosci wiersza. W
wiekszosci przypadkow bardziej uzyteczna jest opcja "minimalna
wysokosc wiersza". Domyslnie wysokosc wiersza nie jest
zmieniana.
--linearize-tables
Niektore zle zaprojektowane dokumenty uzywaja tabel do
rozmieszczenia tekstu na stronie. Czesto po konwersji w takich
dokumentach pojawia sie tekst wychodzacy poza strone i inne
bledy. Ta opcja wydobedzie tekst z tabel i przedstawi go w
sposob ciagly.
--margin-bottom
Ustaw dolny margines w pkt. Domyslnie jest %d to ustawienie
domyslne. Ustawienie wartosci mniejszej niz zero spowoduje, ze
margines nie zostanie ustawiony (ustawienie marginesu w
oryginalnym dokumencie zostanie zachowane). Uwaga: formaty
zorientowane na strony, takie jak PDF i DOCX, maja wlasne
ustawienia marginesow, ktore maja pierwszenstwo.
--margin-left
Ustaw lewy margines w pkt. Domyslnie jest %d to ustawienie
domyslne. Ustawienie wartosci mniejszej niz zero spowoduje, ze
margines nie zostanie ustawiony (ustawienie marginesu w
oryginalnym dokumencie zostanie zachowane). Uwaga: formaty
zorientowane na strony, takie jak PDF i DOCX, maja wlasne
ustawienia marginesow, ktore maja pierwszenstwo.
--margin-right
Ustaw prawy margines w pkt. Domyslnie jest %d to ustawienie
domyslne. Ustawienie wartosci mniejszej niz zero spowoduje, ze
margines nie zostanie ustawiony (ustawienie marginesu w
oryginalnym dokumencie zostanie zachowane). Uwaga: formaty
zorientowane na strony, takie jak PDF i DOCX, maja wlasne
ustawienia marginesow, ktore maja pierwszenstwo.
--margin-top
Ustaw gorny margines w pkt. Domyslnie jest %d to ustawienie
domyslne. Ustawienie wartosci mniejszej niz zero spowoduje, ze
margines nie zostanie ustawiony (ustawienie marginesu w
oryginalnym dokumencie zostanie zachowane). Uwaga: formaty
zorientowane na strony, takie jak PDF i DOCX, maja wlasne
ustawienia marginesow, ktore maja pierwszenstwo.
--minimum-line-height
Minimalna wysokosc wiersza, zalezna od rozmiaru czcionki
wyliczonego dla elementu. calibre bedzie pilnowac, aby kazdy
element mial wysokosc wiersza nie mniejsza niz ustawiona
wartosc, niezaleznie od tego, co okresla dokument wejsciowy.
Ustaw te wartosc na zero, aby wylaczyc. Domyslnie wynosi ona
120%. Uzyj tego ustawienia, zamiast bezposredniego ustawienia
wysokosci wiersza, chyba ze wiesz co robisz. Na przyklad, mozna
uzyskac tekst o ,,podwojnym odstepie miedzy wierszami" poprzez
ustawienie wartosci na 240.
--remove-paragraph-spacing
Usuwa odstep pomiedzy akapitami. Ustawia rowniez wciecie akapitu
w wielkosci 1.5em. Usuwanie odstepu nie zadziala, jesli plik
wejsciowy nie uzywa akapitow (znacznikow
lub
).
--remove-paragraph-spacing-indent-size
Kiedy calibre usuwa puste wiersze miedzy akapitami,
automatycznie dodaje wciecia akapitowe, by umozliwic rozpoznanie
struktury tekstu. Ta opcja okresla wielkosc wciecia akapitowego
(w em). Ustawienie wartosci ujemnej spowoduje, ze zostanie uzyta
wartosc ustawiona w dokumencie zrodlowym, czyli praktycznie
wciecie nie jest zmieniane.
--smarten-punctuation
Konwertuj zwykle cudzyslowy, myslniki i wielokropki na ich
poprawne typograficznie odpowiedniki. Aby uzyskac szczegolowe
informacje, zobacz
https://daringfireball.net/projects/smartypants.
--subset-embedded-fonts
Zredukuj osadzone czcionki. Kazda osadzona czcionka zostanie
zredukowana tak, aby zawierala tylko znaki wykorzystywane w tym
dokumencie. Zmniejszy to rozmiar plikow z czcionkami. Przydatne
przy korzystaniu z czcionek zawierajacych wiele
niewykorzystywanych znakow.
--transform-css-rules
Sciezka do pliku zawierajacego reguly przetwarzania stylow CSS w
tej ksiazce. Najprostszym sposobem, by stworzyc taki plik, jest
uzycie kreatora regul w interfejsie calibre. Dostan sie do niego
przez sekcje ,,Look & Fell -> Transform styles" dialogu
konwersji. Kiedy stworzysz reguly, mozesz uzyc przycisku
"Eksport", aby zapisac je do pliku.
--transform-html-rules
Sciezka do pliku zawierajacego reguly przeksztalcania kodu HTML
w tej ksiazce. Najlatwiejszym sposobem utworzenia takiego pliku
jest skorzystanie z kreatora tworzenia regul w GUI calibre.
Uzyskaj do niego dostep w sekcji ,,Wyglad i styl->Przeksztalc
kod HTML" w oknie dialogowym konwersji. Po utworzeniu regul
mozesz uzyc przycisku ,,Eksportuj", aby zapisac je do pliku.
--unsmarten-punctuation
Przeksztalc typograficzne cudzyslowy, myslniki i wielokropki na
zwykle odpowiedniki.
PRZETWARZANIE HEURYSTYCZNE
Zmodyfikuj tekst i strukture uzywajac wzorcow. Domyslnie wylaczone. Aby
wlaczyc uzyj --enable-heuristics. Poszczegolne akcje moga zostac
wylaczone przy uzyciu --disable-
*
.
--disable-dehyphenate
Przeanalizuj podzielone slowa w calym dokumencie. Dokument jest
uzywany jako slownik do ustalenia czy laczniki powinny byc
zachowane, czy usuniete.
--disable-delete-blank-paragraphs
Usun z dokumentu puste akapity, gdy wystepuja one pomiedzy co
drugim akapitem
--disable-fix-indents
Zamien wciecie skladajace sie z wielokrotnych nierozdzielajacych
spacji na wciecia CSS.
--disable-format-scene-breaks
Podzialy scen sa wycentrowane. Zamien podzialy scen, ktore
wykorzystuja wiele wierszy na linie poziome.
--disable-italicize-common-cases
Sprawdz najczesciej uzywane wyrazy i wzorce, ktore sa oznaczane
kursywa i pochyl je.
--disable-markup-chapter-headings
Wykryj niesformatowane tytuly rozdzialow i podrozdzialow. Zamien
je na znaczniki h2 i h3. To ustawienie nie wygeneruje spisu
tresci, ale razem z detekcja struktury moze byc uzyte do jego
stworzenia.
--disable-renumber-headings
Wyszukuje wystapienia kolejnych znacznikow
lub .
Znaczniki sa ponownie numerowane, aby zapobiec podzialowi w
srodku naglowka rozdzialu.
--disable-unwrap-lines
Usuwaj podzialy wierszy na podstawie uzytej interpunkcji i
formatowania.
--enable-heuristics
Wlacz przetwarzanie heurystyczne. Ta opcja musi byc wlaczona,
aby nastapilo jakiekolwiek przetwarzanie heurystyczne.
--html-unwrap-factor
Wspolczynnik wykorzystywany do okreslenia dlugosci, przy ktorej
wiersz powinien pozostac nieprzelamany. Wartosc powinna byc z
przedzialu 0 do 1. Domyslna wartosc to 0.4, ponizej polowy
dlugosci wiersza. W przypadku, gdy w dokumencie tylko kilka
wierszy ma pozostac nieprzelamanych ta wartosc powinna zostac
zmniejszona
--replace-scene-breaks
Zamien zmiany sceny na okreslony tekst. Domyslnie wykorzystany
jest tekst pochodzacy z dokumentu wejsciowego.
WYSZUKAJ I ZASTAP
Modyfikuj tekst dokumentu i jego strukture, uzywajac wzorow
zdefiniowanych przez uzytkownika.
--search-replace
Sciezka do pliku zawierajacego wyrazenia regularne wyszukiwania
i zamiany. Plik musi zawierac naprzemiennie wiersze wzorca
wyszukiwania i zamiany (wiersz zamiany moze byc pusty).
Wyrazenie musi byc poprawnym wyrazeniem regularnym Pythona, a
plik musi byc kodowany w UTF-8.
--sr1-replace
Tekst, ktory zastapi ciag znaleziony za pomoca sr1-search.
--sr1-search
Wzorzec (wyrazenie regularne), ktory ma zostac zastapiony przez
sr1-replace.
--sr2-replace
Tekst, ktory zastapi ciag znaleziony za pomoca sr2-search.
--sr2-search
Wzorzec (wyrazenie regularne), ktory ma zostac zastapiony przez
sr2-replace.
--sr3-replace
Tekst, ktory zastapi ciag znaleziony za pomoca sr3-search.
--sr3-search
Wzorzec (wyrazenie regularne), ktory ma zostac zastapiony przez
sr3-replace.
WYKRYWANIE STRUKTURY
Kontrola autodetekcji struktury dokumentu.
--chapter
Wyrazenie XPath do wykrywania tytulow rozdzialow. Domyslnie
znaczniki lub zawierajace slowa ,,rozdzial",
,,ksiazka", ,,sekcja", ,,prolog", ,,epilog" lub ,,czesc" sa
traktowane jako tytuly rozdzialow, jak rowniez wszelkie
znaczniki, ktore maja klasa = ,,rozdzial". Uzyte wyrazenie musi
byc oceniane jako lista elementow. Aby wylaczyc wykrywanie
rozdzialow, uzyj wyrazenia ,,/". Wiecej informacji na temat
korzystania z tej funkcji mozna znalezc w samouczku XPath w
podreczniku uzytkownika calibre.
--chapter-mark
Okresl jak zaznaczac wykryte rozdzialy. Wartosc "pagebreak"
dzieli strone miedzy rozdzialami. Wartosc "linia" wstawia linie
przed rozdzialem. Wartosc "brak" wylacza zaznaczanie rozdzialow,
a "wszystko" wlacza linie i podzial strony jednoczesnie.
--disable-remove-fake-margins
Niektore dokumenty okreslaja marginesy strony poprzez okreslenie
lewego i prawego marginesu dla kazdego akapitu indywidualnie.
calibre sprobuje wykryc i usunac te marginesy. Czasami moze to
spowodowac usuniecie marginesow, ktore nie powinny zostac
usuniete. W takim przypadku mozesz wylaczyc usuwanie.
--insert-metadata
Wstaw metadane na poczatku ksiazki. Jest to przydatne, jesli
czytnik nie obsluguje bezposrednio wyswietlania/wyszukiwania
metadanych.
--page-breaks-before
Wyrazenie XPath. Przelamanie stron zostanie wprowadzone przed
odnalezionymi elementami. Aby wylaczyc te funkcje podaj: /
--prefer-metadata-cover
Preferuj okladke z pliku zrodlowego w stosunku do wybranej
okladki.
--remove-first-image
Usun pierwszy obrazek ze zrodlowej ksiazki. Opcja przydaje sie
jesli ksiazka zawiera obrazek okladki, ktory nie jest
identyfikowany jako okladka. W efekcie jesli dodasz swoja
okladke, w calibre ksiazka bedzie miala dwie okladki, jesli nie
ustawisz tej opcji.
--start-reading-at
Wyrazenie XPath do wykrywania lokalizacji w dokumencie, w ktorej
nalezy rozpoczac czytanie. Niektore programy do czytania
e-bookow (przede wszystkim Kindle) uzywaja tej lokalizacji jako
miejsca otwierania ksiazki. Wiecej informacji na temat
korzystania z tej funkcji mozna znalezc w samouczku XPath w
podreczniku uzytkownika calibre.
SPIS TRESCI
Kontroluje automatyczne generowanie spisu tresci. Domyslnie, jesli plik
zrodlowy ma juz spis tresci, to ma on pierwszenstwo przed tym
wygenerowanym automatycznie.
--duplicate-links-in-toc
Umozliwia umieszczenie powtarzajacych sie pozycji przy tworzeniu
spisu tresci z odsylaczy w dokumencie na przyklad kilka razy
tego samego slowa, odsylajacego w rozne miejsca.
--level1-toc
Wyrazenie XPath okreslajace znaczniki, ktore powinny zostac
dodane do spisu tresci na pierwszym poziomie. Jesli wyrazenie
zostanie dodane, ma pierwszenstwo przed innymi sposobami
autodetekcji. Wiecej informacji na temat XPath znajduje sie w
sekcji XPath Tutorial, w podreczniku uzytkownika calibre.
--level2-toc
Wyrazenie XPath okreslajace znaczniki, ktore powinny zostac
dodane do spisu tresci na drugim poziomie. Kazdy element jest
dodawany w hierarchii pod poprzednim elementem pierwszego
poziomu. Wiecej informacji na temat XPath znajduje sie w sekcji
XPath Tutorial, w podreczniku uzytkownika calibre.
--level3-toc
Wyrazenie XPath okreslajace znaczniki, ktore powinny zostac
dodane do spisu tresci na trzecim poziomie. Kazdy element jest
dodawany w hierarchii pod poprzednim elementem drugiego poziomu.
Wiecej informacji na temat XPath znajduje sie w sekcji XPath
Tutorial, w podreczniku uzytkownika calibre.
--max-toc-links
Maksymalna liczba odnosnikow do wstawienia do spisu tresci.
Ustaw te wartosc na 0, aby wylaczyc. Domyslnie ustawienie: 50.
Odnosniki sa dodawane do spisu tresci tylko jesli odnaleziono
mniej rozdzialow niz okreslony prog.
--no-chapters-in-toc
Nie dodawaj automatycznie wykrytych rozdzialow do spisu tresci.
--toc-filter
Usuwa te pozycje ze spisu tresci, ktorych tytuly pasuja do
okreslonego wyrazenia. Zostana usuniete pasujace i wszystkie ich
podrzedne pozycje.
--toc-threshold
Jesli zostanie wykryte mniej rozdzialow niz podano, odnosniki sa
dodawane do spisu tresci. Domyslnie: 6
--use-auto-toc
Zazwyczaj, jezeli plik zrodlowy ma juz spis tresci, jest on
wykorzystywany zamiast wygenerowanego automatycznie. Z ta opcja
zawsze uzywany jest wygenerowany automatycznie spis tresci.
METADANE
Opcje odpowiedzialne za ustawienia metadanych w plikach wyjsciowych
--author-sort
Lancuch znakow uzywany przy sortowaniu po autorze.
--authors
Wpisz autorow. Jesli jest wiecej niz jeden, nalezy oddzielic ich
znakami ampersand ("&").
--book-producer
Podaj producenta ksiazki (w Polsce nie praktykowane).
--comments
Ustaw opis dla e-booka.
--cover
Ustaw okladke wybierajac plik lub podajac adres URL
--isbn Wpisz numer ISBN ksiazki.
--language
Podaj jezyk.
--pubdate
Ustaw date publikacji (zaklada sie, ze znajduje sie w lokalnej
strefie czasowej, chyba ze strefa czasowa jest wyraznie
okreslona)
--publisher
Ustaw wydawce e-booka.
--rating
Wpisz ocene. Musi to byc cyfra pomiedzy 1 a 5.
--read-metadata-from-opf, --from-opf, -m
Odczytaj metadane z wybranego pliku OPF. Metadane odczytane z
tego pliku nadpisza wszystkie metadane pliku zrodlowego.
--series
Wybierz serie, do ktorych nalezy ta ksiazka.
--series-index
Podaj numer ksiazki w cyklu.
--tags Wpisz etykiety dla ksiazki. Kolejne etykiety oddzielaj
przecinkami.
--timestamp
Ustaw stempel czasowy ksiazki (nie uzywane nigdzie indziej)
--title
Wpisz tytul.
--title-sort
Wersja tytulu uzywana przy sortowaniu.
DEBUG
Opcje pomocy przy debugowaniu konwersji
--debug-pipeline, -d
Zapisz dane wyjsciowe z roznych etapow potoku konwersji w
okreslonym folderze. Przydatne, jesli nie masz pewnosci, na
ktorym etapie procesu konwersji wystepuje blad.
--verbose, -v
Poziom komunikatow. Im wiecej razy jest podany, tym komunikaty
beda obszerniejsze. Podanie parametru dwa razy to maksymalna
ilosc informacji, raz - normalna, a przy braku parametru
komunikaty beda zawieraly minimum informacji.
AUTHOR
Kovid Goyal
COPYRIGHT
Kovid Goyal
7.10.0 maja 03, 2024 EBOOK-CONVERT(1)