Debian Codegraph @

man-pages/ru/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" "сентября 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 [параметры]
39 .EE
40 .UNINDENT
41 .UNINDENT
42 .sp
43 Преобразовать электронную книгу из одного формата в другой.
44 .sp
45 input_file \- это вход, а output_file \- это выход. Оба должны быть указаны в качестве первых двух аргументов команды.
46 .sp
47 Выходной формат электронной книги определяется расширением файла output_file. Выходной_файл также может иметь специальный формат .EXT, где EXT \- это расширение выходного файла. В этом случае имя выходного файла происходит от имени входного файла. Обратите внимание, что имена файлов не должны начинаться с дефиса. Наконец, если output_file не имеет расширения, он рассматривается как папка, и в эту папку записывается «открытая электронная книга» (OEB), состоящая из файлов HTML. Эти файлы \- это файлы, которые обычно передаются в плагин вывода.
48 .sp
49 После указания файла ввода и вывода вы можете настроить конвертацию, указав различные параметры. Доступные параметры зависят от типов входных и выходных файлов. Чтобы получить справку по ним, укажите входной и выходной файл, а затем используйте параметр \-h.
50 .sp
51 Полную документацию по системе конвертации см.
52 Конвертирование книг \%<#\:conversion>
53 .sp
54 Когда вы передаёте аргументы с пробелами в \fBebook\-convert\fP, заключайте их в кавычки. Напр.: \(dq/some path/with spaces\(dq
55 .sp
56 Параметры и значения по умолчанию для свойств/ параметров изменяются в зависимости и их от входного и выходного форматов, так что Вы всегда должны выполнять проверку ::
57 ebook\-convert myfile.input_format myfile.output_format \-h
58 Ниже приведены параметры общие для всех преобразований, а за ними следуют параметры, специфичные для каждого входного и выходного формата.
59 .INDENT 0.0
60 .IP \(bu 2
61 ВХОДНЫЕ НАСТРОЙКИ
62 .IP \(bu 2
63 ВЫХОДНЫЕ НАСТРОЙКИ
64 .IP \(bu 2
65 ВИД И ФУНКЦИИ
66 .IP \(bu 2
67 ЭВРИСТИЧЕСКАЯ ОБРАБОТКА
68 .IP \(bu 2
69 НАЙТИ И ЗАМЕНИТЬ
70 .IP \(bu 2
71 ОПРЕДЕЛЕНИЕ СТРУКТУРЫ
72 .IP \(bu 2
73 ОГЛАВЛЕНИЕ
74 .IP \(bu 2
75 МЕТАДАННЫЕ
76 .IP \(bu 2
77 ОТЛАДКА
78 .UNINDENT
79 .INDENT 0.0
80 .TP
81 .B \-\-help, \-h
82 показать это сообщение и выйти
83 .UNINDENT
84 .INDENT 0.0
85 .TP
86 .B \-\-input\-profile
87 Указать профиль ввода. Профиль ввода указывает конвертеру, как интерпретировать различную информацию внутри исходного документа. Напр., длина зависит от разрешения (длина в пикселях). Варианты: cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad, irexdr1000, irexdr800, kindle, msreader, mobipocket, nook, sony, sony300, sony900
88 .UNINDENT
89 .INDENT 0.0
90 .TP
91 .B \-\-list\-recipes
92 Список встроенных имен рецептов. Вы можете создать электронную книгу из встроенного рецепта, подобного этому: ebook\-convert \fB\(dq\fPRecipe Name.recipe\fB\(dq\fP output.epub
93 .UNINDENT
94 .INDENT 0.0
95 .TP
96 .B \-\-output\-profile
97 Выбор профиля вывода. Профиль вывода определяет параметры оптимизации преобразуемого документа для выбранного типа устройств. В некоторых случаях (редко), профиль вывода определяет параметры оптимизации для конкретного устройства. Доступные профили: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, pocketbook_inkpad3, pocketbook_lux, pocketbook_hd, pocketbook_900, pocketbook_pro_912, galaxy, sony, sony300, sony900, sony\-landscape, sonyt3, tablet, generic_eink, generic_eink_hd, generic_eink_large
98 .UNINDENT
99 .INDENT 0.0
100 .TP
101 .B \-\-version
102 показать версию программы и выйти
103 .UNINDENT
104 .SH ВХОДНЫЕ НАСТРОЙКИ
105 .sp
106 Опции для контроля обработки входного файла mobi
107 .INDENT 0.0
108 .TP
109 .B \-\-input\-encoding
110 Укажите кодировку исходного документа. Если установить эту опцию, то любая исходная кодировка будет переопределена. Особенно полезно для документов, в которых кодировка не указана или указана неверно.
111 .UNINDENT
112 .SH ВЫХОДНЫЕ НАСТРОЙКИ
113 .sp
114 Настройки для контроля обработки выходного файла epub
115 .INDENT 0.0
116 .TP
117 .B \-\-dont\-split\-on\-page\-breaks
118 Отключить разбиение по разрывам страниц. Обычно входные файлы автоматически разбиваются на два файла при каждом разрыве страницы. Это даёт выходную книгу, которая может обрабатываться быстрее и с меньшими затратами ресурсов. Однако разбиение выполняется медленно, и если исходный файл содержит очень большое количество разрывов страниц, следует отключить разбиение по разрывам страниц.
119 .UNINDENT
120 .INDENT 0.0
121 .TP
122 .B \-\-epub\-flatten
123 Этот параметр нужен только если вы планируете использовать EPUB с FBReaderJ. Он упрощает файловую систему внутри EPUB, помещая все файлы в корневой каталог.
124 .UNINDENT
125 .INDENT 0.0
126 .TP
127 .B \-\-epub\-inline\-toc
128 Вставить встроенное оглавление, которое будет отображаться как часть основного содержимого книги.
129 .UNINDENT
130 .INDENT 0.0
131 .TP
132 .B \-\-epub\-max\-image\-size
133 Максимальный размер изображения (ширина x высота). Значение profile означает использование размера экрана из выходного профиля. Значение none — максимальный размер не указан. Напр., значение 100x200 — изменение размера всех изображений так чтобы их ширина была не больше 100 пикселей, а высота — не больше 200 пикселей. Обратите внимание, что это влияет только на размер самих файлов изображений. Любое данное изображение может отображаться в другом размере в зависимости от стиля, применённого к нему в документе.
134 .UNINDENT
135 .INDENT 0.0
136 .TP
137 .B \-\-epub\-toc\-at\-end
138 Поместить встроенное оглавление в конце книги, а не в начале.
139 .UNINDENT
140 .INDENT 0.0
141 .TP
142 .B \-\-epub\-version
143 Версия создаваемого файла EPUB. EPUB 2 наиболее совместим, используйте EPUB 3 только если вы точно знаете, что он вам нужен.
144 .UNINDENT
145 .INDENT 0.0
146 .TP
147 .B \-\-extract\-to
148 Извлечь содержимое созданной книги в указанную папку. Содержимое папки предварительно удаляется, так что будьте осторожны.
149 .UNINDENT
150 .INDENT 0.0
151 .TP
152 .B \-\-flow\-size
153 Разбивать все HTML\-файлы, превышающие этот размер (в КБ). Это необходимо, так как большинство программ для чтения EPUB не могут обрабатывать большие файлы. Значение по умолчанию 260 КБ — это размер, требуемый для Adobe Digital Editions. Установите 0, чтобы отключить разбиение по размеру.
154 .UNINDENT
155 .INDENT 0.0
156 .TP
157 .B \-\-no\-default\-epub\-cover
158 Обычно если входной файл не имеет обложки и вы не указываете её, создаётся обложка по умолчанию с названием, авторами и т.д. Этот параметр отключает создание такой обложки.
159 .UNINDENT
160 .INDENT 0.0
161 .TP
162 .B \-\-no\-svg\-cover
163 Не использовать SVG для обложки книги. Используйте этот параметр, если ваш EPUB будет использоваться на устройстве, не поддерживающем SVG, например iPhone или JetBook Lite. Без этого параметра на таких устройствах обложка будет отображаться как пустая страница.
164 .UNINDENT
165 .INDENT 0.0
166 .TP
167 .B \-\-preserve\-cover\-aspect\-ratio
168 При использовании обложки SVG этот параметр масштабирует обложку для заполнения доступной области экрана, но сохраняет соотношение сторон. Это означает, что по бокам или сверху и снизу могут быть белые поля, но изображение никогда не будет искажено. Без этого параметра изображение может быть слегка искажено, но полей не будет.
169 .UNINDENT
170 .INDENT 0.0
171 .TP
172 .B \-\-pretty\-print
173 Если отмечено, модуль вывода попытается форматировать вывод в удобном для чтения виде. Может не работать на некоторых модулях вывода.
174 .UNINDENT
175 .INDENT 0.0
176 .TP
177 .B \-\-toc\-title
178 Заголовок для любого создаваемого встроенного оглавления.
179 .UNINDENT
180 .SH ВИД И ФУНКЦИИ
181 .sp
182 Опции для контроля за внешним видом выходного файла
183 .INDENT 0.0
184 .TP
185 .B \-\-asciiize
186 Транслитерировать символы Юникода в ASCII. Используйте с осторожностью, символы Юникода будут заменены на ASCII. Напр., «Pelé» заменится на «Pele». Также обратите внимание, что в случаях, когда существует несколько представлений символа (напр., символов, используемых в китайском и японском языках), будет использоваться представление, основанное на текущем языке интерфейса Calibre.
187 .UNINDENT
188 .INDENT 0.0
189 .TP
190 .B \-\-base\-font\-size
191 Размер базового шрифта в pt. Все размеры шрифтов в выпущенной книге будут перемасштабированы на основе этого размера. Выбирая больший размер, вы можете увеличить шрифты на выходе и наоборот. По умолчанию, когда значение равно нулю, размер базового шрифта выбирается на основе выбранного профиля вывода.
192 .UNINDENT
193 .INDENT 0.0
194 .TP
195 .B \-\-change\-justification
196 Изменить выравнивание текста. Значение \fB\(dq\fPВлево\fB\(dq\fP преобразует все выравнивание текста из источника в выравнивание по левому краю (то есть не выравненому). Значение \fB\(dq\fPВыровнять\fB\(dq\fP преобразует весь не выровненный текст в выровненный. Значение \fB\(dq\fPоригинал\fB\(dq\fP (по умолчанию) не изменяет выравнивание в исходном файле. Обратите внимание, что только некоторые выходные форматы поддерживают выравнивание.
197 .UNINDENT
198 .INDENT 0.0
199 .TP
200 .B \-\-disable\-font\-rescaling
201 Запретить масштабирование шрифтов.
202 .UNINDENT
203 .INDENT 0.0
204 .TP
205 .B \-\-embed\-all\-fonts
206 Встроить каждый шрифт, который содержится в исходном документе, но ещё не встроен. Используемые шрифты \- искать в вашей системе и встроить их, если найдены. Встраивание будет работать только если формат, в который вы конвертируете, поддерживает встраиваемые шрифты. Напр. EPUB, AZW3, DOCX и PDF. Убедитесь, что у вас есть лицензия на встраиваемые шрифты, используемые в этом документе.
207 .UNINDENT
208 .INDENT 0.0
209 .TP
210 .B \-\-embed\-font\-family
211 Встроить определённое семейство шрифтов в книгу. Устанавливает «основной» шрифт книги. Если в исходном документе заданы собственные шрифты, они, вероятно, переопределят основной шрифт. Вы можете использовать опцию фильтрации стилей для удаления шрифтов исходного документа. Заметьте, что встраивание шрифтов работает только с некоторыми выходными форматами, преимущественно EPUB, AZW3 и DOCX.
212 .UNINDENT
213 .INDENT 0.0
214 .TP
215 .B \-\-expand\-css
216 По умолчанию calibre будет использовать сокращенную форму для различных свойств CSS, таких как margin, padding, border и т.п. Этот параметр включает использование полной расширенной формы. Обратите внимание, что CSS всегда расширяется при создании файлов EPUB с профилем вывода на Nook, поскольку Nook не может обрабатывать сокращенный CSS.
217 .UNINDENT
218 .INDENT 0.0
219 .TP
220 .B \-\-extra\-css
221 Введите путь к таблице стилей CSS или чистый CSS. Эта CSS будет включена в правила стиля исходного файла, поэтому она может быть использована для переопределения этих правил.
222 .UNINDENT
223 .INDENT 0.0
224 .TP
225 .B \-\-filter\-css
226 Разделённый запятой список CSS\-свойств, которые должны быть удалены изо всех правил CSS. Это полезно, если настройка одного из стилей мешает ему быть изменённым на вашем устройстве. Напр.: font\-family, color, margin\-left, margin\-right
227 .UNINDENT
228 .INDENT 0.0
229 .TP
230 .B \-\-font\-size\-mapping
231 Сопоставления имён шрифтов и размеров (в пунктах) из CSS. Напр., строка настроек выглядит так: 12,12,14,16,18,20,22,24. Это сопоставления для размеров от xx\-small до xx\-large, с последним размером для огромных шрифтов. Алгоритм масштабирования шрифтов использует эти размеры для правильного масштабирования. По умолчанию используются настройки выбранного профиля.
232 .UNINDENT
233 .INDENT 0.0
234 .TP
235 .B \-\-insert\-blank\-line
236 Вставить пустую строку между абзацами. Не будет работать, если в исходном документе абзацы (теги <p> или <div>) не используются.
237 .UNINDENT
238 .INDENT 0.0
239 .TP
240 .B \-\-insert\-blank\-line\-size
241 Установить высоту вставляемых пустых строк (в em). Высота строк между абзацами будет в два раза превышать заданное значение.
242 .UNINDENT
243 .INDENT 0.0
244 .TP
245 .B \-\-keep\-ligatures
246 Сохраните лигатуры, присутствующие во входном документе. Лигатура — это комбинированный символ пары символов, таких как ff, fi, fl и т. д. Большинство программ чтения не поддерживают лигатуры в шрифтах по умолчанию, поэтому они вряд ли будут отображаться правильно. По умолчанию calibre превратит лигатуру в соответствующую пару обычных символов. Обратите внимание, что под лигатурами здесь подразумеваются только лигатуры Юникода, а не лигатуры, созданные с помощью CSS или стилей шрифта. Вместо этого эта опция сохранит их.
247 .UNINDENT
248 .INDENT 0.0
249 .TP
250 .B \-\-line\-height
251 Высота строки в пунктах. Определяет расстояние между двумя соседними строками текста. Применяется только к элементам, у которых не определена высота строки. В большинстве случаев лучше всего оставлять минимальное значение. По умолчанию никакие действия с высотой строк не производятся.
252 .UNINDENT
253 .INDENT 0.0
254 .TP
255 .B \-\-linearize\-tables
256 Некоторые плохо форматированные документы используют таблицы для управления расположением текста на странице. При конвертации этих документов текст зачастую становится неудобочитаемым. Эта опция указывает, что нужно извлекать содержимое из таблиц и представлять его в линейном виде.
257 .UNINDENT
258 .INDENT 0.0
259 .TP
260 .B \-\-margin\-bottom
261 Установить нижнюю границу в пт (пунктах). По умолчанию — 5.0. Установка значения меньше нуля приведёт к отсутствию границы (настройка полей в исходном документе будет сохранена). Примечание. Ориентированные на страницы форматы, такие как PDF и DOCX, имеют свои собственные настройки полей.
262 .UNINDENT
263 .INDENT 0.0
264 .TP
265 .B \-\-margin\-left
266 Установить левую границу в пт (пунктах). По умолчанию — 5.0. Установка значения меньше нуля приведёт к отсутствию границы (настройка полей в исходном документе будет сохранена). Примечание. Ориентированные на страницы форматы, такие как PDF и DOCX, имеют свои собственные настройки полей.
267 .UNINDENT
268 .INDENT 0.0
269 .TP
270 .B \-\-margin\-right
271 Установить правую границу в пт (пунктах). По умолчанию — 5.0. Установка значения меньше нуля приведёт к отсутствию границы (настройка полей в исходном документе будет сохранена). Примечание. Ориентированные на страницы форматы, такие как PDF и DOCX, имеют свои собственные настройки полей.
272 .UNINDENT
273 .INDENT 0.0
274 .TP
275 .B \-\-margin\-top
276 Установить верхнюю границу в пт (пунктах). По умолчанию — 5.0. Установка значения меньше нуля приведёт к отсутствию границы (настройка полей в исходном документе будет сохранена). Примечание. Ориентированные на страницы форматы, такие как PDF и DOCX, имеют свои собственные настройки полей.
277 .UNINDENT
278 .INDENT 0.0
279 .TP
280 .B \-\-minimum\-line\-height
281 Минимальная высота строки в процентах от вычисленного размера шрифта элемента. Calibre позаботится о том, чтобы каждый элемент имел высоту строки не менее заданной, независимо от того, что указано во входящем документе. Для отключения задайте ноль. По умолчанию — 120%. Использование данной настройки предпочтительнее, чем прямое указание высоты строки, кроме случая, когда Вы точно понимаете свои действия. Напр., «двойной интервал» получается при значении 240.
282 .UNINDENT
283 .INDENT 0.0
284 .TP
285 .B \-\-remove\-paragraph\-spacing
286 Удалить промежутки между абзацами и установить отступ абзаца в 1.5em. Удаление промежутков не будет работать, если в исходном документе абзацы (теги <p> или <div>) не используются.
287 .UNINDENT
288 .INDENT 0.0
289 .TP
290 .B \-\-remove\-paragraph\-spacing\-indent\-size
291 Когда Calibre удаляет пустые строки между абзацами, то автоматически расставляет красные строки, чтобы абзацы визуально выделялись. Эта опция устанавливает величину отступа (в em). Если установлена отрицательная величина, используется размер отступа, указанный в документе.
292 .UNINDENT
293 .INDENT 0.0
294 .TP
295 .B \-\-smarten\-punctuation
296 Преобразуйте простые кавычки, тире и многоточия в их типографически корректные эквиваленты. Подробную информацию см.: \%<https://\:daringfireball\:.net/\:projects/\:smartypants>\&.
297 .UNINDENT
298 .INDENT 0.0
299 .TP
300 .B \-\-subset\-embedded\-fonts
301 Сократить все внедрённые шрифты. Каждый внедрённый шрифт будет содержать только используемые в документе символы. Это уменьшает размер файла шрифтов. Полезно если вы внедряете объёмный шрифт с большим количеством неиспользуемых символов.
302 .UNINDENT
303 .INDENT 0.0
304 .TP
305 .B \-\-transform\-css\-rules
306 Путь к файлу, содержащему правила для преобразования стилей CSS в этой книге. Самый простой способ создать такой файл \- использовать мастер для создания правил в графическом интерфейсе calibre. Получите доступ к нему в разделе Оформление\->Стили трансформации из диалогового окна преобразования. После создания правил вы можете использовать кнопку «Экспорт», чтобы сохранить их в файле.
307 .UNINDENT
308 .INDENT 0.0
309 .TP
310 .B \-\-transform\-html\-rules
311 Путь к файлу, содержащему правила трансформации HTML в этой книге. Простейший способ создать такой файл \- использовать мастер для создания правил в графическом интерфейсе calibre. Доступ к нему можно получить в разделе «Внешний вид \- Преобразование HTML» диалогового окна конвертации. После создания правил вы можете использовать кнопку «Экспорт», чтобы сохранить их в файл.
312 .UNINDENT
313 .INDENT 0.0
314 .TP
315 .B \-\-unsmarten\-punctuation
316 Преобразовать нестандартные кавычки, тире и многоточия в их обычные эквиваленты.
317 .UNINDENT
318 .SH ЭВРИСТИЧЕСКАЯ ОБРАБОТКА
319 .sp
320 Изменить текст документа и структуру используя общие шаблоны. По умолчанию выключено. Используйте \-\-enable\-heuristics чтобы включить. Отдельные действия могут быть отключены с помощью настройки \-\-disable\-
321 .nf
322 *
323 .fi
324 \&.
325 .INDENT 0.0
326 .TP
327 .B \-\-disable\-dehyphenate
328 Анализировать переносы слов в документе. В качестве словаря для определения, оставить или убрать перенос, используется сам документ.
329 .UNINDENT
330 .INDENT 0.0
331 .TP
332 .B \-\-disable\-delete\-blank\-paragraphs
333 Убрать пустые абзацы, когда они встречаются между другими абзацами
334 .UNINDENT
335 .INDENT 0.0
336 .TP
337 .B \-\-disable\-fix\-indents
338 Преобразовать отступы, состоящие из повторяющихся неразрывных пробелов, в CSS\-отступы.
339 .UNINDENT
340 .INDENT 0.0
341 .TP
342 .B \-\-disable\-format\-scene\-breaks
343 Выравненные по левому краю разрывы сцены выравниваются по центру. Заменяет мягкий разрыв сцены из нескольких пустых линий на горизонтальные линии.
344 .UNINDENT
345 .INDENT 0.0
346 .TP
347 .B \-\-disable\-italicize\-common\-cases
348 Искать общие слова и шаблоны, обозначающие курсив, и преобразовывать в курсивное написание.
349 .UNINDENT
350 .INDENT 0.0
351 .TP
352 .B \-\-disable\-markup\-chapter\-headings
353 Определять неформатированные заголовки разделов и подзаголовки. Менять их на теги h2 и h3. Эта настройка не создаёт оглавление, но может быть использована совместно с функцией определения структуры для его создания.
354 .UNINDENT
355 .INDENT 0.0
356 .TP
357 .B \-\-disable\-renumber\-headings
358 Искать последовательные вхождения тегов <h1> или <h2>. Теги перенумеровываются, чтобы предотвратить разбиение заголовков разделов посередине.
359 .UNINDENT
360 .INDENT 0.0
361 .TP
362 .B \-\-disable\-unwrap\-lines
363 Отмена переноса строк с учётом знаков препинания и другой информации о форматировании.
364 .UNINDENT
365 .INDENT 0.0
366 .TP
367 .B \-\-enable\-heuristics
368 Разрешить эвристическую обработку. Эту опцию нужно включить для выполнения любого вида эвристической обработки.
369 .UNINDENT
370 .INDENT 0.0
371 .TP
372 .B \-\-html\-unwrap\-factor
373 Коэффициент для определения длины, при которой строка должна быть соединена. Допускаются десятичные значения между 0 и 1. Значение по умолчанию составляет 0,4, чуть меньше средней длины строки. Если только несколько строк в документе требуют соединения, то это значение должно быть уменьшено.
374 .UNINDENT
375 .INDENT 0.0
376 .TP
377 .B \-\-replace\-scene\-breaks
378 Заменить разрывы сцен определённым текстом. По умолчанию используется текст из входного документа.
379 .UNINDENT
380 .SH НАЙТИ И ЗАМЕНИТЬ
381 .sp
382 Изменить содержание и структуру документа используя пользовательский шаблон.
383 .INDENT 0.0
384 .TP
385 .B \-\-search\-replace
386 Путь к файлу, содержащему регулярные выражения для поиска и замены. Файл должен содержать чередующиеся строки регулярного выражения, за которым следует шаблон замены (который может быть пустой строкой). Регулярное выражение должно быть в синтаксисе regex Python, и файл должен быть в кодировке UTF\-8.
387 .UNINDENT
388 .INDENT 0.0
389 .TP
390 .B \-\-sr1\-replace
391 Текст, на который будут заменяться найденные тексты, соответствующие первому выражению поиска.
392 .UNINDENT
393 .INDENT 0.0
394 .TP
395 .B \-\-sr1\-search
396 Шаблон поиска (регулярное выражение), заменяемый на первый текст замены.
397 .UNINDENT
398 .INDENT 0.0
399 .TP
400 .B \-\-sr2\-replace
401 Текст, на который будут заменяться найденные тексты, соответствующие второму выражению поиска.
402 .UNINDENT
403 .INDENT 0.0
404 .TP
405 .B \-\-sr2\-search
406 Шаблон поиска (регулярное выражение), заменяемый на второй текст замены.
407 .UNINDENT
408 .INDENT 0.0
409 .TP
410 .B \-\-sr3\-replace
411 Текст, на который будут заменяться найденные тексты, соответствующие третьему выражению поиска.
412 .UNINDENT
413 .INDENT 0.0
414 .TP
415 .B \-\-sr3\-search
416 Шаблон поиска (регулярное выражение), заменяемый на третий текст замены.
417 .UNINDENT
418 .SH ОПРЕДЕЛЕНИЕ СТРУКТУРЫ
419 .sp
420 Управление автоопределением структуры документа.
421 .INDENT 0.0
422 .TP
423 .B \-\-add\-alt\-text\-to\-img
424 Если у <img> тега нет атрибута alt, проверьте связанный файл изображения на наличие метаданных, определяющих альтернативный текст, и используйте их для заполнения атрибута alt. Атрибут alt улучшает доступность, предоставляя текстовые описания для пользователей, которые не могут видеть или полностью интерпретировать визуальный контент.
425 .UNINDENT
426 .INDENT 0.0
427 .TP
428 .B \-\-chapter
429 Выражение XPath для определения названий глав. По умолчанию следует учитывать теги <h1> или <h2>, содержащие слова \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 или \fB\(dq\fPpart\fB\(dq\fP\&. В качестве заголовков глав, а также любых тегов, которые имеют класс=\fB\(dq\fPchapter\fB\(dq\fP\&. Используемое выражение должно оценивать список элементов. Чтобы отключить обнаружение глав, используйте выражение \fB\(dq\fP/\fB\(dq\fP\&. Более подробную информацию об использовании этой функции см. В учебнике по XPath в руководстве пользователя calibre.
430 .UNINDENT
431 .INDENT 0.0
432 .TP
433 .B \-\-chapter\-mark
434 Указать, как помечать найденные главы. Значение «pagebreak» будет вставлять разрывы страниц после глав. Значение «rule» будет вставлять горизонтальную линию перед главами. Значение «none» отключит разметку глав, а значение «both» будет вставлять и разрывы страниц, и пустые строки.
435 .UNINDENT
436 .INDENT 0.0
437 .TP
438 .B \-\-disable\-remove\-fake\-margins
439 В некоторых документах поля страницы задаются с помощью установки левого и правого поля для каждого отдельного абзаца. Calibre постарается найти и удалить такие поля. Иногда это может привести к удалению тех полей, которые удалять не следует. В таком случае вы можете отключить удаление.
440 .UNINDENT
441 .INDENT 0.0
442 .TP
443 .B \-\-insert\-metadata
444 Вставить метаданные книги в начале книги. Это полезно, если ваша читалка не поддерживает отображение/поиск метаданных напрямую.
445 .UNINDENT
446 .INDENT 0.0
447 .TP
448 .B \-\-page\-breaks\-before
449 XPath\-выражение. Разрывы страниц вставляются перед указанными элементами. Для отключения выражения используйте : /
450 .UNINDENT
451 .INDENT 0.0
452 .TP
453 .B \-\-prefer\-metadata\-cover
454 Использовать обложку, полученную из исходного файла, вместо заданной.
455 .UNINDENT
456 .INDENT 0.0
457 .TP
458 .B \-\-remove\-first\-image
459 Удалить первое изображение из входной электронной книги. Полезно, если входной документ имеет изображение, которое не обозначено как обложка. В этом случае, если вы установите обложку в calibre, выходной документ будет иметь две обложки, если вы не укажете эту опцию.
460 .UNINDENT
461 .INDENT 0.0
462 .TP
463 .B \-\-start\-reading\-at
464 Выражение XPath для определения местоположения в документе, с которого следует начать чтение. Некоторые читалки (в первую очередь Kindle) используют это местоположение в качестве позиции для открытия книги. Дополнительную информацию об этой функции см. в учебнике по XPath в руководстве пользователя calibre.
465 .UNINDENT
466 .SH ОГЛАВЛЕНИЕ
467 .sp
468 Управление автоматическим созданием оглавления. По умолчанию, если в исходном файле есть оглавление, оно предпочитается созданному автоматически.
469 .INDENT 0.0
470 .TP
471 .B \-\-duplicate\-links\-in\-toc
472 Разрешить дублирующиеся записи при создании оглавления из ссылок в исходном документе, т. е. разрешить записи с одинаковым текстом, если они указывают на разные места.
473 .UNINDENT
474 .INDENT 0.0
475 .TP
476 .B \-\-level1\-toc
477 XPath\-выражение, которое определяет все теги, которые должны быть добавлены в оглавление на первом уровне. Если эта опция определена, то она имеет преимущество над другими видами автоматического обнаружения. Смотрите инструкцию к XPath в руководстве пользователя Calibre, чтобы увидеть примеры.
478 .UNINDENT
479 .INDENT 0.0
480 .TP
481 .B \-\-level2\-toc
482 XPath\-выражение, которое определяет все теги, которые должны быть добавлены в оглавление на втором уровне. Каждая запись добавляется под записью предыдущего уровня. Смотрите инструкцию к XPath в руководстве пользователя Calibre, чтобы увидеть примеры.
483 .UNINDENT
484 .INDENT 0.0
485 .TP
486 .B \-\-level3\-toc
487 XPath\-выражение, которое определяет все теги, которые должны быть добавлены в оглавление на третьем уровне. Каждая запись добавляется под записью предыдущего уровня. Смотрите инструкцию к XPath в руководстве пользователя Calibre, чтобы увидеть примеры.
488 .UNINDENT
489 .INDENT 0.0
490 .TP
491 .B \-\-max\-toc\-links
492 Максимальное количество ссылок, вносимых в оглавление. Поставьте 0 для отключения. По умолчанию 50. Ссылки добавляются в оглавление только если количество найденных глав меньше порогового.
493 .UNINDENT
494 .INDENT 0.0
495 .TP
496 .B \-\-no\-chapters\-in\-toc
497 Не добавлять автоматически определённые главы в содержание.
498 .UNINDENT
499 .INDENT 0.0
500 .TP
501 .B \-\-toc\-filter
502 Удалить из оглавления записи, названия которых соответствуют указанному регулярному выражению. Удалятся также все дочерние элементы таких записей.
503 .UNINDENT
504 .INDENT 0.0
505 .TP
506 .B \-\-toc\-threshold
507 Если обнаружено меньшее число глав, чем указано, то ссылки добавляются в содержание. По умолчанию: 6
508 .UNINDENT
509 .INDENT 0.0
510 .TP
511 .B \-\-use\-auto\-toc
512 Обычно, если в исходном файле уже есть оглавление, оно предпочитается созданному автоматически. С этой опцией всегда используется автоматически созданное оглавление.
513 .UNINDENT
514 .SH МЕТАДАННЫЕ
515 .sp
516 Настройки для установки метаданных выходного файла
517 .INDENT 0.0
518 .TP
519 .B \-\-author\-sort
520 Строка, используемая при сортировке по авторам.
521 .UNINDENT
522 .INDENT 0.0
523 .TP
524 .B \-\-authors
525 Указать авторов. Несколько авторов должны быть разделены амперсандами (&).
526 .UNINDENT
527 .INDENT 0.0
528 .TP
529 .B \-\-book\-producer
530 Установить создателя книги.
531 .UNINDENT
532 .INDENT 0.0
533 .TP
534 .B \-\-comments
535 Установить описание электронной книги.
536 .UNINDENT
537 .INDENT 0.0
538 .TP
539 .B \-\-cover
540 Установить обложку для указанного файла или URL
541 .UNINDENT
542 .INDENT 0.0
543 .TP
544 .B \-\-isbn
545 Указать ISBN книги.
546 .UNINDENT
547 .INDENT 0.0
548 .TP
549 .B \-\-language
550 Установить язык.
551 .UNINDENT
552 .INDENT 0.0
553 .TP
554 .B \-\-pubdate
555 Установить дату публикации (предполагается, что дата соответствует местному часовому поясу, если не задано)
556 .UNINDENT
557 .INDENT 0.0
558 .TP
559 .B \-\-publisher
560 Установить издателя электронной книги.
561 .UNINDENT
562 .INDENT 0.0
563 .TP
564 .B \-\-rating
565 Поставьте оценку. Должна быть числом от 1 до 5.
566 .UNINDENT
567 .INDENT 0.0
568 .TP
569 .B \-\-read\-metadata\-from\-opf, \-\-from\-opf, \-m
570 Прочитать метаданные из указанного OPF\-файла. Метаданные, прочитанные таким образом, заменят все метаданные исходного документа
571 .UNINDENT
572 .INDENT 0.0
573 .TP
574 .B \-\-series
575 Установить серию этой электронной книги.
576 .UNINDENT
577 .INDENT 0.0
578 .TP
579 .B \-\-series\-index
580 Указать номер книги в серии.
581 .UNINDENT
582 .INDENT 0.0
583 .TP
584 .B \-\-tags
585 Указать теги для книги. Должны быть разделены запятыми.
586 .UNINDENT
587 .INDENT 0.0
588 .TP
589 .B \-\-timestamp
590 Установить дату книги (больше нигде не используется)
591 .UNINDENT
592 .INDENT 0.0
593 .TP
594 .B \-\-title
595 Указать название.
596 .UNINDENT
597 .INDENT 0.0
598 .TP
599 .B \-\-title\-sort
600 Версия названия, используемая для сортировки.
601 .UNINDENT
602 .SH ОТЛАДКА
603 .sp
604 Настройки для облегчения отладки преобразования
605 .INDENT 0.0
606 .TP
607 .B \-\-debug\-pipeline, \-d
608 Сохранить вывод из разных этапов конвейера конвертации в указанную папку. Полезно, если вы не уверены, на каком этапе процесса конвертации возникает ошибка.
609 .UNINDENT
610 .INDENT 0.0
611 .TP
612 .B \-\-verbose, \-v
613 Уровень детальности. Используйте несколько раз для большей детальности. Использование дважды приведёт к максимальной детальности, единожды \- к средней и ни разу \- к наименьшей детальности.
614 .UNINDENT
615 .SH Author
616 Kovid Goyal
617 .SH Copyright
618 Kovid Goyal
619 .\" End of generated man page.