Debian Codegraph @

man-pages/ms/man1/ebook-convert.1

raw
1 .\" Man page generated from reStructuredText
2 .\" by the Docutils 0.22.4 manpage writer.
3 .
4 .
5 .nr rst2man-indent-level 0
6 .
7 .de1 rstReportMargin
8 \\$1 \\n[an-margin]
9 level \\n[rst2man-indent-level]
10 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
11 -
12 \\n[rst2man-indent0]
13 \\n[rst2man-indent1]
14 \\n[rst2man-indent2]
15 ..
16 .de1 INDENT
17 .\" .rstReportMargin pre:
18 . RS \\$1
19 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
20 . nr rst2man-indent-level +1
21 .\" .rstReportMargin post:
22 ..
23 .de UNINDENT
24 . RE
25 .\" indent \\n[an-margin]
26 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
27 .nr rst2man-indent-level -1
28 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
29 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
30 ..
31 .TH "EBOOK-CONVERT" "1" "September 18, 2026" "9.15.0" "calibre"
32 .SH NAME
33 ebook-convert \- ebook-convert
34 .INDENT 0.0
35 .INDENT 3.5
36 .sp
37 .EX
38 ebook\-convert input_file output_file [options]
39 .EE
40 .UNINDENT
41 .UNINDENT
42 .sp
43 Convert an e\-book from one format to another.
44 .sp
45 input_file is the input and output_file is the output. Both must be specified as the first two arguments to the command.
46 .sp
47 The output e\-book format is guessed from the file extension of output_file. output_file can also be of the special format .EXT where EXT is the output file extension. In this case, the name of the output file is derived from the name of the input file. Note that the filenames must not start with a hyphen. Finally, if output_file has no extension, then it is treated as a folder and an \(dqopen e\-book\(dq (OEB) consisting of HTML files is written to that folder. These files are the files that would normally have been passed to the output plugin.
48 .sp
49 After specifying the input and output file you can customize the conversion by specifying various options. The available options depend on the input and output file types. To get help on them specify the input and output file and then use the \-h option.
50 .sp
51 For full documentation of the conversion system see
52 E\-book conversion \%<#\:conversion>
53 .sp
54 Whenever you pass arguments to \fBebook\-convert\fP that have spaces in them, enclose the arguments in quotation marks. For example: \(dq/some path/with spaces\(dq
55 .sp
56 Pilihan dan nilai lalai bagi perubahan pilihan bergantung pada kedua\-dua
57 format input dan output, jadi anda seharusnya sentiasa semak dengan:
58 .INDENT 0.0
59 .INDENT 3.5
60 .sp
61 .EX
62 ebook\-convert myfile.input_format myfile.output_format \-h
63 .EE
64 .UNINDENT
65 .UNINDENT
66 .sp
67 Dibawah merupakan pilihan umum untuk semua penukaran, diikuti dengan
68 pilihan khusus untuk setiap format input dan output.
69 .INDENT 0.0
70 .IP \(bu 2
71 PILIHAN INPUT
72 .IP \(bu 2
73 PILIHAN OUTPUT
74 .IP \(bu 2
75 PENAMPILAN
76 .IP \(bu 2
77 PEMPROSESAN HEURISTIK
78 .IP \(bu 2
79 GELINTAR DAN GANTI
80 .IP \(bu 2
81 PENGESANAN STRUKTUR
82 .IP \(bu 2
83 ISI KANDUNGAN
84 .IP \(bu 2
85 DATA META
86 .IP \(bu 2
87 NYAHPEPIJAT
88 .UNINDENT
89 .INDENT 0.0
90 .TP
91 .B \-\-help, \-h
92 tunjuk mesej bantuan ini dan keluar
93 .UNINDENT
94 .INDENT 0.0
95 .TP
96 .B \-\-input\-profile
97 Nyatakan profil input. Profil input memberikan maklumat sistem penukaran bagaimana hendak tafsir pelbagai maklumat di dalam dokumen input. Sebagai contoh resolusi bergantung pada panjang (iaitu panjang dalam piksel). Pilihan adalah: cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad, irexdr1000, irexdr800, kindle, msreader, mobipocket, nook, sony, sony300, sony900
98 .UNINDENT
99 .INDENT 0.0
100 .TP
101 .B \-\-list\-recipes
102 Senaraikan nama resepi terbina\-dalam. Anda boleh cipta satu e\-buku melalui resepi terbina\-dalam seperti ini: ebook\-convert \fB\(dq\fPRecipe Name.recipe\fB\(dq\fP output.epub
103 .UNINDENT
104 .INDENT 0.0
105 .TP
106 .B \-\-output\-profile
107 Nyatakan profil output. Profil output memberitahu sisten penukaran bagaimana hendak optimumkan dokumen yang dihasilkan untuk peranti tertentu. Dalam sesetengah situasi, satu profil output boleh digunakan untuk optimumkan output bagi peranti tersebut, tetapi ia jarang berlaku. Pilihan adalah:cybookg3, cybook_opus, default, generic_eink, generic_eink_large, generic_eink_hd, 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, pocketbook_inkpad3, pocketbook_lux, pocketbook_hd, pocketbook_900, pocketbook_pro_912, galaxy, sony, sony300, sony900, sony\-landscape, sonyt3, tablet
108 .UNINDENT
109 .INDENT 0.0
110 .TP
111 .B \-\-version
112 tunjuk nombor versi program dan keluar
113 .UNINDENT
114 .SH PILIHAN INPUT
115 .sp
116 Pilihan untuk mengawal pemprosesan fail input mobi
117 .INDENT 0.0
118 .TP
119 .B \-\-input\-encoding
120 Tentukan pengkodan aksara bagi dokumen yang di inputkan. Jika di setkan, pilihan ini akan membatalkan sebarang pengkodan yang diinyatakan oleh dokumen itu sendiri. Ia sangat berguna bagi dokumen\-dokumen yang tidak menyatakan pengkodannya atau yang mempunyai kesilapan pernyataan pengkodan.
121 .UNINDENT
122 .SH PILIHAN OUTPUT
123 .sp
124 Pilihan untuk mengawal pemprosesan fail output epub
125 .INDENT 0.0
126 .TP
127 .B \-\-dont\-split\-on\-page\-breaks
128 Matikan pemisahan pada hentian halaman. Biasanya fail input dipisah secara automatik pada setiap hentian halaman menjadi dua fail. Ini memberikan e\-buku output yang boleh dihurai lebih pantas dengan kurang penggunaan sumber. Walaubagaimanapun, pemisahan adalah perlahan dan jika fail sumber anda mengandungi jumlah hentian halaman yang sangat besar, anda patut mematikan pemisahan hentian halaman.
129 .UNINDENT
130 .INDENT 0.0
131 .TP
132 .B \-\-epub\-flatten
133 Pilihan ini hanya diperlukan jika anda berniat untuk guna EPUB dengan FBReaderJ. Ia akan ratakan sistem fail yang ada di dalam EPUB, meletakkan semua fail dalam aras tertinggi.
134 .UNINDENT
135 .INDENT 0.0
136 .TP
137 .B \-\-epub\-inline\-toc
138 Sisip Isi Kandunagan dalaman yang akan muncul sebagai sebahagian dari kandungan buku utama.
139 .UNINDENT
140 .INDENT 0.0
141 .TP
142 .B \-\-epub\-max\-image\-size
143 The maximum image size (width x height). A value of profile means use the screen size from the output profile. A value of none means no maximum size is specified. For example, a value of 100x200 will cause all images to be resized so that their width is no more than 100 pixels and their height is no more than 200 pixels. Note that this only affects the size of the actual image files themselves. Any given image may be rendered at a different size depending on the styling applied to it in the document.
144 .UNINDENT
145 .INDENT 0.0
146 .TP
147 .B \-\-epub\-toc\-at\-end
148 Letak Isi Kandungan dalam garis dipenghujung buku selain di permulaan.
149 .UNINDENT
150 .INDENT 0.0
151 .TP
152 .B \-\-epub\-version
153 Versi fail EPUB yang dijana. EPUB 2 adalah yang paling serasi, hanya guna EPUB 3 jika anda benar\-benar memerlukannya.
154 .UNINDENT
155 .INDENT 0.0
156 .TP
157 .B \-\-extract\-to
158 Extract the contents of the generated book to the specified folder. The contents of the folder are first deleted, so be careful.
159 .UNINDENT
160 .INDENT 0.0
161 .TP
162 .B \-\-flow\-size
163 Pisah semua fail HTML yang lebih besar dari saiz ini (dalam KB). Ia perlu kerana kebanyakan pembaca EPUB tidak dapat kendalikan saiz fail besar. Lalai 260KB adalah saiz yang diperlukan untuk Adobe Digital Editions. Tetapkan pada 0 untuk lumpuhkan pembahagian berasaskan saiz.
164 .UNINDENT
165 .INDENT 0.0
166 .TP
167 .B \-\-no\-default\-epub\-cover
168 Biasanya jika fail input tidak mempunyai kulit luar dan anda tidak nyatakan, kulit lalai dijana dengan tajuk, pengarang, dll. Pilihan ini lumpuhkan penjanaan kulit buku ini.
169 .UNINDENT
170 .INDENT 0.0
171 .TP
172 .B \-\-no\-svg\-cover
173 Jangan guna SVG untuk kulit buku. Guna pilihan ini jika EPUB anda akan diguna dalam peranti yang tidak menyokong format SVG, seperti iPhone atau JetBook Lite. Tanpa pilihan ini, peranti tersebut akan paparkan kulit buku sebagai muka kosong.
174 .UNINDENT
175 .INDENT 0.0
176 .TP
177 .B \-\-preserve\-cover\-aspect\-ratio
178 Bila menggunakan kulit hadapan SVG, pilihan ini akan menyebabkan kulit hadapan diskalakan untuk meliputi kawasan skrin yang ada, tetapi masih mengekalkan nisbah bidangnya (nisbah lebar terhadap tinggi). Ini bermaksud akan wujud sempadan putih disisi atau atas dan bawah imej, tetapi imej tidak akan diherotkan. Tanpa pilihan ini imej akan menjadi sedikit herot, tetapi sempadan tidak akan wujud.
179 .UNINDENT
180 .INDENT 0.0
181 .TP
182 .B \-\-pretty\-print
183 Jika dinyatakan, pemalam output akan cuba cipta output yang boleh dibaca manusia. Mungkin tidak memberi kesan kepada beberapa pemalam output.
184 .UNINDENT
185 .INDENT 0.0
186 .TP
187 .B \-\-toc\-title
188 Title for any generated inline table of contents.
189 .UNINDENT
190 .SH PENAMPILAN
191 .sp
192 Pilihan untuk mengawal penampilan output
193 .INDENT 0.0
194 .TP
195 .B \-\-asciiize
196 Transliterate Unicode characters to an ASCII representation. Use with care because this will replace Unicode characters with ASCII. For instance it will replace \fB\(dq\fPPelé\fB\(dq\fP with \fB\(dq\fPPele\fB\(dq\fP\&. Also, note that in cases where there are multiple representations of a character (characters shared by Chinese and Japanese for instance) the representation based on the current calibre interface language will be used.
197 .UNINDENT
198 .INDENT 0.0
199 .TP
200 .B \-\-base\-font\-size
201 The base font size in pts. All font sizes in the produced book will be rescaled based on this size. By choosing a larger size you can make the fonts in the output bigger and vice versa. By default, when the value is zero, the base font size is chosen based on the output profile you chose.
202 .UNINDENT
203 .INDENT 0.0
204 .TP
205 .B \-\-change\-justification
206 Ubah kewajaran teks. Nilai \fB\(dq\fPkiri\fB\(dq\fP tukar semua teks terwajar di dalam sumber menjadi teks terjajar kiri (iaitu. tidak terwajar). Nilai \fB\(dq\fPwajar\fB\(dq\fP tukar semua teks tidak terwajar menjadi terwajar. Nilai \fB\(dq\fPasal\fB\(dq\fP (lalai) tidak mengubah kewajaran fail sumber. Perhatian hanya beberapa format output menyokong kewajaran.
207 .UNINDENT
208 .INDENT 0.0
209 .TP
210 .B \-\-disable\-font\-rescaling
211 Lumpuhkan semua penskalaan semula saiz fon.
212 .UNINDENT
213 .INDENT 0.0
214 .TP
215 .B \-\-embed\-all\-fonts
216 Benamkan setiap fon yang dirujuk dalam dokumen input tetapi sebenarnya tidak dibenam. Ia akan menggelintar fon tersebut dalam sistem anda, dan jika temui, ia akan dibenamkan. Pembenaman hanya berlaku jika format yang anda tukar menyokong fon terbenam, seperti EPUB, AZW3, DOCX atau PDF. Sila pastikan anda mempunyai lesen untuk membenamkan fon tersebut untuk digunakan dalam dokumen ini.
217 .UNINDENT
218 .INDENT 0.0
219 .TP
220 .B \-\-embed\-font\-family
221 Benamkan keluarga fon tertentu ke dalam buku. Ini menyatakan fon \fB\(dq\fPdasar\fB\(dq\fP yang digunakan untuk buku. Jika dokumen input menyatakan fonnya sendiri, ia mungkin membatalkan fon dasar ini. Anda boleh guna pilihan maklumat gaya penapis untuk membuang fon dari dokumen input. Perhatian pembenaman fon hanya berfungsi dengan beberapa format output, biasanya EPUB, AZW3 dan DOCX.
222 .UNINDENT
223 .INDENT 0.0
224 .TP
225 .B \-\-expand\-css
226 Secara lalai, calibre akan guna kependekan untuk pelbagai sifat CSS seperti margin, pemadatan, sempadan, dll. Pilihan ini akan menyebabkan ia gunakan bentuk penuh. Perhatian CSS sentiasa dikembangkan bila menjana fail EPUB dengan profil output ditetapkan pada salah satu profil Nook kerana Nook tidak dapat kendalikan kependekan CSS.
227 .UNINDENT
228 .INDENT 0.0
229 .TP
230 .B \-\-extra\-css
231 Sama ada laluan ke lembaran gaya CSS atau CSS mentah. CSS ini akan ditambah ke peraturan gaya dari fail sumber, supaya ia boleh digunakan untuk batalkan peraturan tersebut.
232 .UNINDENT
233 .INDENT 0.0
234 .TP
235 .B \-\-filter\-css
236 Satu senarai dipisah tanda koma sifat CSS akan dibuang dari semua peraturan gaya CSS. Ia berguna jika kehadiran beberapa maklumat gaya menghalang ia dari dibatalkan oleh peranti anda. Contohnya: font\-family,color,margin\-left,margin\-right
237 .UNINDENT
238 .INDENT 0.0
239 .TP
240 .B \-\-font\-size\-mapping
241 Pemetaan dari nama fon CSS ke saiz fon dalam pt. Contoh penetapan ialah 12,12,14,16,18,20,22,24. Ini merupakan pemetaan untuk saiz xx\-small sehinggalah xx\-large, dengan saiz akhir merupakan fon amat besar. Algoritma penskalaan semula fon gunakan saiz ini untuk skalakan semula fon secara pintar. Lalai ialah guna pemetaan berdasarkan pada profil output yang anda pilih.
242 .UNINDENT
243 .INDENT 0.0
244 .TP
245 .B \-\-insert\-blank\-line
246 Sisip baris kosong diantara perenggan. Tidak akan berfungsi jika fail sumber tidak guna perenggan (tag <p> atau <div>).
247 .UNINDENT
248 .INDENT 0.0
249 .TP
250 .B \-\-insert\-blank\-line\-size
251 Tetapkan tinggi baris kosong yang disisip (dalam em). Tinggi baris diantara perenggan akan menjadi dua kali ganda nilai yang ditetapkan di sini.
252 .UNINDENT
253 .INDENT 0.0
254 .TP
255 .B \-\-keep\-ligatures
256 Preserve ligatures present in the input document. A ligature is a combined character of a pair of characters like ff, fi, fl et cetera. Most readers do not have support for ligatures in their default fonts, so they are unlikely to render correctly. By default, calibre will turn a ligature into the corresponding pair of normal characters. Note that ligatures here mean only unicode ligatures not ligatures created via CSS or font styles. This option will preserve them instead.
257 .UNINDENT
258 .INDENT 0.0
259 .TP
260 .B \-\-line\-height
261 Tinggi baris dalam pt. Kawal jarak diantara baris berturutan teks. Hanya laksana pada unsur yang tidak takrif tinggi baris mereka sendiri. Dalam kebanyakan kes, pilihan tinggi baris minimum adalah lebih berguna. Secara lalai tiada manipulasi tinggi baris dibuat.
262 .UNINDENT
263 .INDENT 0.0
264 .TP
265 .B \-\-linearize\-tables
266 Sesetengah dokumen direka teruk dengan jadual yang mana ia mengawal bentangan teks dalam halaman. Bila menukar dokumen ini biasanya teks terkeluar dari halaman dan ada artifak lain. Pilihan ini akan mengekstrak kandungan dari jadual dan persembahkannya dalam fesyen linear.
267 .UNINDENT
268 .INDENT 0.0
269 .TP
270 .B \-\-margin\-bottom
271 Tetapkan margin bawah dalam pts. Lalai ialah 5.0. Tetapan ini adalah kurang dari sifar yang akan menyebabkan tiada margin ditetapkan (tetapan margin dalam dokumen asal akan dikekalkan). Perhatian: Format berorientasikan halmaan seperti PDF dan DOCX mempunyai tetapan margin mereka masing\-masing.
272 .UNINDENT
273 .INDENT 0.0
274 .TP
275 .B \-\-margin\-left
276 Tetapkan margin kiri dalam pts. Lalai ialah 5.0. Tetapan ini adalah kurang dari sifar yang akan menyebabkan tiada margin ditetapkan (tetapan margin dalam dokumen asal akan dikekalkan). Perhatian: Format berorientasikan halmaan seperti PDF dan DOCX mempunyai tetapan margin mereka masing\-masing.
277 .UNINDENT
278 .INDENT 0.0
279 .TP
280 .B \-\-margin\-right
281 Tetapkan margin kanan dalam pts. Lalai ialah 5.0. Tetapan ini adalah kurang dari sifar yang akan menyebabkan tiada margin ditetapkan (tetapan margin dalam dokumen asal akan dikekalkan). Perhatian: Format berorientasikan halmaan seperti PDF dan DOCX mempunyai tetapan margin mereka masing\-masing.
282 .UNINDENT
283 .INDENT 0.0
284 .TP
285 .B \-\-margin\-top
286 Tetapkan margin atas dalam pts. Lalai ialah 5.0. Tetapan ini adalah kurang dari sifar yang akan menyebabkan tiada margin ditetapkan (tetapan margin dalam dokumen asal akan dikekalkan). Perhatian: Format berorientasikan halmaan seperti PDF dan DOCX mempunyai tetapan margin mereka masing\-masing.
287 .UNINDENT
288 .INDENT 0.0
289 .TP
290 .B \-\-minimum\-line\-height
291 Tinggi baris minimum, sebagai peratus unsur saiz fon yang dikira. calibre akan pastikan yang mana setiap unsur mempunyai tinggi baris sekurang\-kurangnya ikut tetapan ini, tidak menuruti apakah input dokumen tentukan. Tetapkan sifar untuk lumpuhkan. Lalai ialah 120%. Guna tetapan ini dalam keutamaan ke spesifikasi tinggi baru, melainkan anda tahu apa yang anda buat. Contohnya, anda boleh dapat teks \fB\(dq\fPberjarak ganda dua\fB\(dq\fP dengan menetapkannya menjadi 240.
292 .UNINDENT
293 .INDENT 0.0
294 .TP
295 .B \-\-remove\-paragraph\-spacing
296 Buang penjarakan diantara perenggan. Juga tetapkan inden pada perenggan sebanyak 1.5em. Pembuangan penjarakan tidak berfungsi jika fail sumber tidak guna perenggan (tag <p> atau <div>).
297 .UNINDENT
298 .INDENT 0.0
299 .TP
300 .B \-\-remove\-paragraph\-spacing\-indent\-size
301 Bila calibre membuang baris kosong diantara perenggan, ia tetapkan inden perenggan secara automatik untuk memastikan perenggan mudah dikenalpasti. Pilihan ini mengawal lebar inden tersebut (dalam em). Jika anda tetapkan nilainya negatif, maka inden yang dinyatakan dalam dokumen input akan digunakan, iaitu calibre tidak mengubah indentasinya.
302 .UNINDENT
303 .INDENT 0.0
304 .TP
305 .B \-\-smarten\-punctuation
306 Convert plain quotes, dashes and ellipsis to their typographically correct equivalents. For details, see: \%<https://\:daringfireball\:.net/\:projects/\:smartypants>\&.
307 .UNINDENT
308 .INDENT 0.0
309 .TP
310 .B \-\-subset\-embedded\-fonts
311 Sebset semua fon terbenam. Setiap fon terbenam dikurangkan hanya untuk mengandungi glif yang diguna dalam dokumen ini. Ia kurangkan saiz fail fon. Berguna jika anda membenamkan fon besar tertentu yang mengandungi banyak glif yang tidak perlu.
312 .UNINDENT
313 .INDENT 0.0
314 .TP
315 .B \-\-transform\-css\-rules
316 Laluan ke fail yang mengandungi peraturan pengubah gaya CSS dalam buku ini. Cara termudah mencipta fail sebegitu adalah dengan menggunakan bestari untuk mencipta peraturan di dalam GUI calibre. Capai ia dalam seksyen \fB\(dq\fPPenampilan\->Ubah gaya\fB\(dq\fP bagi dialog pertukaran. Seusai anda mewujudkan peraturan, anda boleh guna butang \fB\(dq\fPEksport\fB\(dq\fP untuk menyimpannya ke dalam fail.
317 .UNINDENT
318 .INDENT 0.0
319 .TP
320 .B \-\-transform\-html\-rules
321 Path to a file containing rules to transform the HTML in this book. The easiest way to create such a file is to use the wizard for creating rules in the calibre GUI. Access it in the \fB\(dq\fPLook & feel\->Transform HTML\fB\(dq\fP section of the conversion dialog. Once you create the rules, you can use the \fB\(dq\fPExport\fB\(dq\fP button to save them to a file.
322 .UNINDENT
323 .INDENT 0.0
324 .TP
325 .B \-\-unsmarten\-punctuation
326 Tukar petikan, sengkang dan elipsis yang pelik mengikut format piawainya.
327 .UNINDENT
328 .SH PEMPROSESAN HEURISTIK
329 .sp
330 Ubah suai teks dan struktur dokumen menggunakan corak umum. Dilumpuhkan secara lalai. Guna \-\-enable\-heuristics untuk dibenarkan. Tindakan individu boleh dilumpuhkan dengan pilihan \-\-disable\-
331 .nf
332 *
333 .fi
334 \&.
335 .INDENT 0.0
336 .TP
337 .B \-\-disable\-dehyphenate
338 Analisis perkataan bersempang menyeluruhi dokumen. Dokumen itu sendiri digunakan sebagai kamus untuk tentukan sama ada tanda sempang seharusnya dikekalkan atau dibuang.
339 .UNINDENT
340 .INDENT 0.0
341 .TP
342 .B \-\-disable\-delete\-blank\-paragraphs
343 Buang perenggan kosong dari dokumen bila ia wujud diantara setiap perenggan lain
344 .UNINDENT
345 .INDENT 0.0
346 .TP
347 .B \-\-disable\-fix\-indents
348 Hidupkan identasi yang dicipta dari entiti jarak tidak\-henti berbilang ke dalam inden CSS.
349 .UNINDENT
350 .INDENT 0.0
351 .TP
352 .B \-\-disable\-format\-scene\-breaks
353 Penanda hentian adegan terjajar kiri adalah dijajar tengah. Ganti hentian adegan lembut yang guna baris kosong berbilang dengan peratusan mengufuk.
354 .UNINDENT
355 .INDENT 0.0
356 .TP
357 .B \-\-disable\-italicize\-common\-cases
358 Cari perkataan dan corak umum yang diwakili dengan condong dan kecondongan mereka.
359 .UNINDENT
360 .INDENT 0.0
361 .TP
362 .B \-\-disable\-markup\-chapter\-headings
363 Kesan pengepala dan sub pengepala bab. Ubah ia menjadi tag h2 dan h3. Tetapan ini tidak akan hasilkan TOC, tetapi boleh digunakan di dalam konjuksi dengan pengesanan struktur jika mahu membinanya.
364 .UNINDENT
365 .INDENT 0.0
366 .TP
367 .B \-\-disable\-renumber\-headings
368 Cari kemunculan jujukan tag <h1> atau <h2>. Tag dinombor semula untuk menghindari pemisahan ditengah\-tengah pengepala bab.
369 .UNINDENT
370 .INDENT 0.0
371 .TP
372 .B \-\-disable\-unwrap\-lines
373 Nyahlilit baris menggunakan tanda baca dan lain\-lain tanda pemformatan.
374 .UNINDENT
375 .INDENT 0.0
376 .TP
377 .B \-\-enable\-heuristics
378 Benarkan pemprosesan heuristik. Pilihan ini mesti ditetapkan untuk mana\-mana pemprosesan heuristik untuk dijalankan.
379 .UNINDENT
380 .INDENT 0.0
381 .TP
382 .B \-\-html\-unwrap\-factor
383 Skala yang digunakan untuk menentukan panjang yang mana baris patut tidak dililit. Nilai yang sah adalah desimal diantara 0 hingga 1. Lalai ialah 0.4, sedikit dibawah panjang baris median. Jika hanya beberapa baris di dalam dokumen memerlukan penyahlilitaan, nilai ini patut dikurangkan.
384 .UNINDENT
385 .INDENT 0.0
386 .TP
387 .B \-\-replace\-scene\-breaks
388 Ganti hentian adegan dengan teks yang dinyatakan. Secara lalai, teks dari dokumen input digunakan.
389 .UNINDENT
390 .SH GELINTAR DAN GANTI
391 .sp
392 Ubahsuai teks dan struktur dokumen menggunakan corak ditakrif pengguna.
393 .INDENT 0.0
394 .TP
395 .B \-\-search\-replace
396 Laluan ke fail yang mengandungi ungkapan nalar gelintar dan ganti. Fail mesti mengandungi bari alternatif bagi ungkapan nalar yang diikuti oleh corak penggantian (yang boleh jadi baris kosong). Ungkapan nalar mesti dalam sintaks ungkapan nalar Python dan fail mesti terenkod UTF\-8.
397 .UNINDENT
398 .INDENT 0.0
399 .TP
400 .B \-\-sr1\-replace
401 Penggantian untuk ganti teks yang ditemui dengan sr1\-search.
402 .UNINDENT
403 .INDENT 0.0
404 .TP
405 .B \-\-sr1\-search
406 Gelintar corak (ungkapan nalar) yang diganti dengan sr1\-replace.
407 .UNINDENT
408 .INDENT 0.0
409 .TP
410 .B \-\-sr2\-replace
411 Penggantian untuk ganti teks yang ditemui dengan sr2\-search.
412 .UNINDENT
413 .INDENT 0.0
414 .TP
415 .B \-\-sr2\-search
416 Gelintar corak (ungkapan nalar) yang diganti dengan sr2\-replace.
417 .UNINDENT
418 .INDENT 0.0
419 .TP
420 .B \-\-sr3\-replace
421 Penggantian untuk ganti teks yang ditemui dengan sr3\-search.
422 .UNINDENT
423 .INDENT 0.0
424 .TP
425 .B \-\-sr3\-search
426 Gelintar corak (ungkapan nalar) yang diganti dengan sr3\-replace.
427 .UNINDENT
428 .SH PENGESANAN STRUKTUR
429 .sp
430 Kawal pengesanan\-automatik struktur dokumen.
431 .INDENT 0.0
432 .TP
433 .B \-\-add\-alt\-text\-to\-img
434 When an <img> tag has no alt attribute, check the associated image file for metadata that specifies alternate text, and use it to fill in the alt attribute. The alt attribute improves accessibility by providing text descriptions for users who cannot see or fully interpret visual content.
435 .UNINDENT
436 .INDENT 0.0
437 .TP
438 .B \-\-chapter
439 Ungkapan XPath untuk mengesan tajuk bab. Lalai ialah dengan menganggap tag <h1> atau <h2> yang mengandungi perkataan \fB\(dq\fPchapter\fB\(dq\fP,\fB\(dq\fPbook\fB\(dq\fP,\fB\(dq\fPsection\fB\(dq\fP, \fB\(dq\fPprologue\fB\(dq\fP, \fB\(dq\fPepilogue\fB\(dq\fP, atau \fB\(dq\fPpart\fB\(dq\fP sebahagian dari tajuk bab serta mana\-mana tag yang mempunyai class=\fB\(dq\fPchapter\fB\(dq\fP\&. Ungkapan digunakan mesti menilai senarai unsur. Untuk lumpuhkan pengesanan bab, guna ungkapan \fB\(dq\fP/\fB\(dq\fP\&. Sila rujuk Tutorial XPath di dalam Panduan Pengguna calibre untuk bantuan lanjut berkenaan penggunaan fitur ini.
440 .UNINDENT
441 .INDENT 0.0
442 .TP
443 .B \-\-chapter\-mark
444 Nyatakan bagaimana hendak tanda bab yang dikesan. Nilai \fB\(dq\fPpagebreak\fB\(dq\fP akan menyisip hentian halaman sebelum bab. Nilai \fB\(dq\fPrule\fB\(dq\fP akan menyisip satu baris sebelum bab. Nilai \fB\(dq\fPnone\fB\(dq\fP akan lumpuhkan penandaan bab dan nilai \fB\(dq\fPboth\fB\(dq\fP akan guna kedua\-dua hentian halaman dan baris untuk menanda bab.
445 .UNINDENT
446 .INDENT 0.0
447 .TP
448 .B \-\-disable\-remove\-fake\-margins
449 Sesetengah dokumen nyatakan margin halaman dengan menyatakan margin kiri dan kanan pada setiap perenggan secara individu. Calibre akan cuba mengesan dan membuang margin ini. Kadangkala, ia menyebabkan pembuangan margin yang tidak sepatutnya dibuang. Dalam situasi ini anda boleh lumpuhkan pembuangan tersebut.
450 .UNINDENT
451 .INDENT 0.0
452 .TP
453 .B \-\-insert\-metadata
454 Sisip data meta buku pada permulaan buku. Ia berguna jika pembaca e\-buku anda tidak menyokong papar/gelintar data meta secara langsung.
455 .UNINDENT
456 .INDENT 0.0
457 .TP
458 .B \-\-page\-breaks\-before
459 Ungkapan XPath. Hentian halaman disisip sebelum unsur yang dinyatakan. Untuk lumpuhkan penggunaan ungkapan: /
460 .UNINDENT
461 .INDENT 0.0
462 .TP
463 .B \-\-prefer\-metadata\-cover
464 Guna kulit hadapan yang dikesan dari fail sumber dalam keutamaan ke kulit hadapan yang dinyatakan.
465 .UNINDENT
466 .INDENT 0.0
467 .TP
468 .B \-\-remove\-first\-image
469 Buang imej pertama dari e\-buku input. Berguna jika dokumen input mempunyai imej kulit buku yang tidak dikenalpasti sebagai kulit buku. Dalam situasi ini, jika anda tetapkan kulit buku dalam calibre, dokumen output akan mempunyai dua imej kulit buku jika anda tidak nyatakan pilihan ini.
470 .UNINDENT
471 .INDENT 0.0
472 .TP
473 .B \-\-start\-reading\-at
474 Ungkapan XPath untuk mengesan lokasi dalam dokumen untuk mula membaca. Sesetengah program membaca e\-buku (umumnya Kindle) gunakan lokasi ini sebagai kedudukan untuk membuka buku. Sila rujuk tutorial XPath di dalam Panduan Pengguna calibre untuk bantuan lanjutan berkenaan penggunaan fitur ini.
475 .UNINDENT
476 .SH ISI KANDUNGAN
477 .sp
478 Kawal penjanaan automatik Isi Kandungan. Secara lalai, jika fail sumber mempunyai Isi Kandungan, ia akan digunakan dalam keutamaan ke yang terjana secara automatik.
479 .INDENT 0.0
480 .TP
481 .B \-\-duplicate\-links\-in\-toc
482 Bila mencipta TOC dari pautan dalam dokumen input, benarkan masukan berganda, iaitu benarkan lebih dari satu masukan dengan teks yang sama, yang mana ia menuju ke lokasi yang berbeza.
483 .UNINDENT
484 .INDENT 0.0
485 .TP
486 .B \-\-level1\-toc
487 Ungkapan XPath yang menyatakan semua tag perlu ditambah ke dalam Senarai Kandungan pada aras satu. Jika ia dinyatakan, ia mendahului lain\-lain bentuk auto\-pengesanan. Sila rujuk Tutorial XPath dalam Panduan Pengguna calibre untuk lihat contoh.
488 .UNINDENT
489 .INDENT 0.0
490 .TP
491 .B \-\-level2\-toc
492 Ungkapan XPath yang menyatakan semua tag perlu ditambah ke dalam Senarai Kandungan pada aras dua. Setiap masukan ditambah di bawah masukan aras satu sebelum ini. Sila rujuk Tutorial XPath dalam Panduan Pengguna calibre untuk lihat contoh.
493 .UNINDENT
494 .INDENT 0.0
495 .TP
496 .B \-\-level3\-toc
497 Ungkapan XPath yang menyatakan semua tag perlu ditambah ke dalam Senarai Kandungan pada aras tiga. Setiap masukan ditambah di bawah masukan aras dua sebelum ini. Sila rujuk Tutorial XPath dalam Panduan Pengguna calibre untuk lihat contoh.
498 .UNINDENT
499 .INDENT 0.0
500 .TP
501 .B \-\-max\-toc\-links
502 Bilangan pautan maksimum disisip ke dalam TOC. Tetapkan 0 untuk lumpuhkan. Lalai ialah: 50. Pautan hanya ditambah ke TOC jika kurang dari ambang bilangan bab telah dikesan.
503 .UNINDENT
504 .INDENT 0.0
505 .TP
506 .B \-\-no\-chapters\-in\-toc
507 Jangan tambah bab dikesan\-sendiri ke Isi Kandungan.
508 .UNINDENT
509 .INDENT 0.0
510 .TP
511 .B \-\-toc\-filter
512 Buang masukan dari Isi Kandungan yang mana tajuk sepadan dengan ungkapan nalar yang dinyatakan. Masukan yang sepadan dan semua anaknya akan dibuang.
513 .UNINDENT
514 .INDENT 0.0
515 .TP
516 .B \-\-toc\-threshold
517 Jika lebih sedikit berbanding bilangan bab ini dikesan, maka pautan ditambah ke Isi Kandungan. Lalai: 6
518 .UNINDENT
519 .INDENT 0.0
520 .TP
521 .B \-\-use\-auto\-toc
522 Biasanya, jika fail sumber sudah mempunyai Senarai Kandungan, ia digunakan dalam keutamaan untuk auto\-jana. Dengan pilihan ini, auto\-jana sentiasa digunakan.
523 .UNINDENT
524 .SH DATA META
525 .sp
526 Pilihan untuk tetapkan data meta dalam output
527 .INDENT 0.0
528 .TP
529 .B \-\-author\-sort
530 Rentetan yang digunakan bila mengisih ikut pengarang.
531 .UNINDENT
532 .INDENT 0.0
533 .TP
534 .B \-\-authors
535 Tetapkan pengarang. Pengarang berbilang seharusnya dipisah dengan tanda ampersand.
536 .UNINDENT
537 .INDENT 0.0
538 .TP
539 .B \-\-book\-producer
540 Tetapkan pengeluar buku.
541 .UNINDENT
542 .INDENT 0.0
543 .TP
544 .B \-\-comments
545 Tetapkan keterangan e\-buku.
546 .UNINDENT
547 .INDENT 0.0
548 .TP
549 .B \-\-cover
550 Tetapkan kulit hadapan fail atau URL yang dinyatakan.
551 .UNINDENT
552 .INDENT 0.0
553 .TP
554 .B \-\-isbn
555 Tetapkan ISBN buku.
556 .UNINDENT
557 .INDENT 0.0
558 .TP
559 .B \-\-language
560 Tetapkan bahasa.
561 .UNINDENT
562 .INDENT 0.0
563 .TP
564 .B \-\-pubdate
565 Tetapkan tarikh penerbitan (dianggap dalam zon waktu setempat, melainkan zon waktu dinyatakan secara eksplisit)
566 .UNINDENT
567 .INDENT 0.0
568 .TP
569 .B \-\-publisher
570 Tetapkan penerbit e\-buku.
571 .UNINDENT
572 .INDENT 0.0
573 .TP
574 .B \-\-rating
575 Tetapkan penarafan. Seharusnya nombor diantara 1 hingga 5.
576 .UNINDENT
577 .INDENT 0.0
578 .TP
579 .B \-\-read\-metadata\-from\-opf, \-\-from\-opf, \-m
580 Baca data meta dari fail OPF yang dinyatakan. Data meta dibaca dari fail ini akan membatalkan mana\-mana data meta dalam fail sumber.
581 .UNINDENT
582 .INDENT 0.0
583 .TP
584 .B \-\-series
585 Tetapkan siri e\-buku ini berasal.
586 .UNINDENT
587 .INDENT 0.0
588 .TP
589 .B \-\-series\-index
590 Tetapkan indeks buku dalam siri ini.
591 .UNINDENT
592 .INDENT 0.0
593 .TP
594 .B \-\-tags
595 Tetapkan tag untuk buku. Seharusnya senarai dipisah dengan tanda koma.
596 .UNINDENT
597 .INDENT 0.0
598 .TP
599 .B \-\-timestamp
600 Tetapkan setem masa buku (tiada lagi digunakan)
601 .UNINDENT
602 .INDENT 0.0
603 .TP
604 .B \-\-title
605 Tetapkan tajuk.
606 .UNINDENT
607 .INDENT 0.0
608 .TP
609 .B \-\-title\-sort
610 Versi tajuk yang digunakan untuk pengisihan.
611 .UNINDENT
612 .SH NYAHPEPIJAT
613 .sp
614 Pilihan untuk bantu dengan menyahpepijat pertukaran
615 .INDENT 0.0
616 .TP
617 .B \-\-debug\-pipeline, \-d
618 Save the output from different stages of the conversion pipeline to the specified folder. Useful if you are unsure at which stage of the conversion process a bug is occurring.
619 .UNINDENT
620 .INDENT 0.0
621 .TP
622 .B \-\-verbose, \-v
623 Aras kejelaan. Nyatakan berapa kali untuk lebih kejelaan. Menyatakan dua kali akan hasilkan kejelaan penuh, sekali kejelaan sederhana dan sifar paling kurang kejelaan.
624 .UNINDENT
625 .SH Author
626 Kovid Goyal
627 .SH Copyright
628 Kovid Goyal
629 .\" End of generated man page.