Debian Codegraph @

man-pages/it/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" "settembre 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 file_di_input file_di_output [opzioni]
39 .EE
40 .UNINDENT
41 .UNINDENT
42 .sp
43 Converti un e\-book da un formato a un altro.
44 .sp
45 file_di_input è il file da convertire e file_di_output è il file convertito. Entrambi devono essere specificati come primi due argomenti del comando.
46 .sp
47 Il formato di output viene dedotto dall\(aqestensione del file convertito file_di_output. file_di_output può anche essere del formato speciale .EXT dove EXT è l\(aqestensione del file di output. In questo caso il nome del file di output è derivato dal nome del file di input. Nota che i nomi dei file non devono cominciare un un trattino. Infine, se file_di_output non ha estensione verrà trattato come cartella e un \(dqopen e\-book\(dq (OEB) formato da file HTML viene inserito nella cartella. Questi file HTML sono quelli che normalmente sarebbero stati passati al plugin atto a generare l\(aqoutput.
48 .sp
49 Dopo aver specificato i file di input e output è possibile personalizzare la conversione specificando varie opzioni. Le opzioni disponibili dipendono dal tipo di file di input e output. Per avere maggiori informazioni sulle opzioni specifiche, indica i file di input e output e poi inserisci l\(aqopzione \-h.
50 .sp
51 Per la documentazione completa sul sistema di conversione, vedi
52 Conversione E\-book \%<#\:conversion>
53 .sp
54 Ogni qualvolta vengono passati argomenti con degli spazi a \fBebook\-convert\fP, è necessario mettere l\(aqargomento fra virgolette. Ad esempio: \(dq/some path/with spaces\(dq
55 .sp
56 Le opzioni e i valori predefiniti cambiano a seconda sia del
57 formato di input che ti output, quindi bisognerebbe sempre controllare:
58 .sp
59 ebook\-convert myfile.input_format myfile.output_format \-h
60 .sp
61 Sotto sono presentate le opzioni comuni per tutte le conversioni, seguite da
62 opzioni specifiche per ogni formato di input e di output.
63 .INDENT 0.0
64 .IP \(bu 2
65 OPZIONI DI INPUT
66 .IP \(bu 2
67 OPZIONI DI OUTPUT
68 .IP \(bu 2
69 IMPRESSIONE VISIVA
70 .IP \(bu 2
71 ELABORAZIONE EURISTICA
72 .IP \(bu 2
73 CERCA E SOSTITUISCI
74 .IP \(bu 2
75 RILEVAZIONE STRUTTURA
76 .IP \(bu 2
77 INDICE
78 .IP \(bu 2
79 METADATI
80 .IP \(bu 2
81 DEBUG
82 .UNINDENT
83 .INDENT 0.0
84 .TP
85 .B \-\-help, \-h
86 mostra questo messaggio di aiuto ed esci
87 .UNINDENT
88 .INDENT 0.0
89 .TP
90 .B \-\-input\-profile
91 Specifica il profilo di input. Il profilo di input fornisce informazioni al sistema di conversione su come interpretare i vari dati del documento di input. Per esempio le lunghezze dipendenti dalla risoluzione (es. lunghezze in pixel). Le scelte sono: cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad, irexdr1000, irexdr800, kindle, msreader, mobipocket, nook, sony, sony300, sony900
92 .UNINDENT
93 .INDENT 0.0
94 .TP
95 .B \-\-list\-recipes
96 Elenca i nomi delle ricette integrate. Puoi creare un e\-book da una ricetta integrata in questo modo: ebook\-convert \fB\(dq\fPNome Ricetta.recipe\fB\(dq\fP output.epub
97 .UNINDENT
98 .INDENT 0.0
99 .TP
100 .B \-\-output\-profile
101 Specifica il profilo di output. Il profilo di output indica al sistema di conversione come ottimizzare il documento creato per il dispositivo indicato. In alcuni casi il profilo di output può essere usato per ottimizzare l\fB\(aq\fPoutput per un particolare dispositivo, ma ciò è necessario raramente. Le scelte sono:cybookg3, cybook_opus, default, generic_eink, generic_eink_hd, generic_eink_large, 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
102 .UNINDENT
103 .INDENT 0.0
104 .TP
105 .B \-\-version
106 mostra la versione del programma ed esci
107 .UNINDENT
108 .SH OPZIONI DI INPUT
109 .sp
110 Opzioni per controllare l\(aqelaborazione dei file di input mobi
111 .INDENT 0.0
112 .TP
113 .B \-\-input\-encoding
114 Specifica la codifica dei caratteri del documento di origine. Se impostata, questa opzione sovrascrive l\fB\(aq\fPeventuale codifica indicata nel documento stesso. Particolarmente utile per documenti in cui la codifica non è esplicitamente indicata o che hanno dichiarazioni di codifica errate.
115 .UNINDENT
116 .SH OPZIONI DI OUTPUT
117 .sp
118 Opzioni per controllare l\(aqelaborazione dell\(aqoutput epub
119 .INDENT 0.0
120 .TP
121 .B \-\-dont\-split\-on\-page\-breaks
122 Disattiva la divisione dei file alle interruzioni di pagina. Normalmente i file di input sono automaticamente divisi a ogni interruzione di pagina in due file. Ciò dà in output un e\-book che può essere decodificato più velocemente e con minore uso di risorse. Tuttavia, la suddivisione è lenta e se il tuo file sorgente contiene un gran numero di interruzioni di pagina, è consigliabile disattivare la suddivisione alle interruzioni di pagina.
123 .UNINDENT
124 .INDENT 0.0
125 .TP
126 .B \-\-epub\-flatten
127 Questa opzione è necessaria solo se si intende usare l\fB\(aq\fPepub con FBReaderJ. Verrà linearizzata la struttura all\fB\(aq\fPinterno dell\fB\(aq\fPepub, tutti i file saranno spostati nella cartella principale.
128 .UNINDENT
129 .INDENT 0.0
130 .TP
131 .B \-\-epub\-inline\-toc
132 Inserisci un indice che apparirà come parte del contenuto principale del libro
133 .UNINDENT
134 .INDENT 0.0
135 .TP
136 .B \-\-epub\-max\-image\-size
137 La massima dimensione dell\fB\(aq\fPimmagine (larghezza x altezza). Il valore profile vuol dire che verrà usata la dimensione dello schermo del profilo di output. Il valore none non applicherà alcuna limitazione alla dimensione. Per esempio, un valore di 100x200 ridimensionerà tutte le immagini in modo che la loro larghezza non sia più di 100 pixel, né la loro altezza più di 200 pixel. Tieni presente che questa opzione si riferisce solo alla dimensione effettiva dei file di immagine stessi. Un\fB\(aq\fPimmagine potrebbe apparire con una dimensione differente in base agli stili ad essa applicati nel documento.
138 .UNINDENT
139 .INDENT 0.0
140 .TP
141 .B \-\-epub\-toc\-at\-end
142 Metti l\fB\(aq\fPindice nel testo creato alla fine del libro invece che all\fB\(aq\fPinizio.
143 .UNINDENT
144 .INDENT 0.0
145 .TP
146 .B \-\-epub\-version
147 La versione del file EPUB da generare. EPUB 2 è quello largamente compatibile, usa EPUB 3 solo se ritieni sia necessario.
148 .UNINDENT
149 .INDENT 0.0
150 .TP
151 .B \-\-extract\-to
152 Estrai i contenuti del libro generato nella cartella selezionata. I contenuti della cartella vengono prima eliminati, quindi fai attenzione.
153 .UNINDENT
154 .INDENT 0.0
155 .TP
156 .B \-\-flow\-size
157 Separa tutti i file HTML più grandi di questa dimensione (in KB). Ciò è necessario in quanto molti lettori EPUB non sono in grado di gestire file di dimensioni maggiori. La dimensione di 260KB è quella predefinita per le Edizioni Digitali di Adobe. Imposta a 0 per disabilitare la divisione basata sulla dimensione.
158 .UNINDENT
159 .INDENT 0.0
160 .TP
161 .B \-\-no\-default\-epub\-cover
162 In genere, se il file di input non ha una copertina e non ne viene specificata una, viene generata una copertina predefinita con il titolo, l\fB\(aq\fPautore, etc. Questa opzione disabilita la generazione di questa copertina.
163 .UNINDENT
164 .INDENT 0.0
165 .TP
166 .B \-\-no\-svg\-cover
167 Non utilizzare SVG per la copertina del libro. Usa questa opzione se l\fB\(aq\fPEPUB verrà usato su un dispositivo che non supporta SVG, come l\fB\(aq\fPiPhone o il JetBook Lite. Senza questa opzione, questi dispositivi visualizzeranno come copertina una pagina bianca.
168 .UNINDENT
169 .INDENT 0.0
170 .TP
171 .B \-\-preserve\-cover\-aspect\-ratio
172 Quando viene usata una copertina SVG, questa opzione ridimensiona la copertina per coprire l\fB\(aq\fParea dello schermo, ma preservando le proporzioni. Questo significa che potrebbero esserci dei bordi bianchi intorno alla copertina, ma questa non verrà distorta. Senza questa opzione l\fB\(aq\fPimmagine potrebbe essere sproporzionata anche se non avrà bordi bianchi.
173 .UNINDENT
174 .INDENT 0.0
175 .TP
176 .B \-\-pretty\-print
177 Se specificato, il plugin tenta di creare un output il più leggibile possibile. Potrebbe non avere effetto per alcuni plugin.
178 .UNINDENT
179 .INDENT 0.0
180 .TP
181 .B \-\-toc\-title
182 Titolo da dare a ciascun indice nel testo generato.
183 .UNINDENT
184 .SH IMPRESSIONE VISIVA
185 .sp
186 Opzioni per controllare l\(aqaspetto dell\(aqoutput
187 .INDENT 0.0
188 .TP
189 .B \-\-asciiize
190 Converti i caratteri Unicode in una rappresentazione ASCII. Usa con attenzione perché sostituirà i caratteri Unicode con caratteri ASCII. Per esempio sostituirà \fB\(dq\fPPelé\fB\(dq\fP con \fB\(dq\fPPele\fB\(dq\fP\&. In più, nota che nei casi in cui ci sia più di una rappresentazione per un carattere (caratteri presenti sia in cinese che in giapponese per esempio) la rappresentazione basata sul linguaggio corrente dell\fB\(aq\fPinterfaccia di calibre sarà usata.
191 .UNINDENT
192 .INDENT 0.0
193 .TP
194 .B \-\-base\-font\-size
195 La dimensione base dei caratteri in pt. Tutte le dimensioni dei caratteri nel libro prodotto saranno scalate in base a questa dimensione. Scegliendo una dimensione maggiore si possono ottenere caratteri più grandi nell\fB\(aq\fPoutput e viceversa. In modo predefinito, quando il valore è zero, la dimensione base dei caratteri è scelta in base al profilo di output scelto.
196 .UNINDENT
197 .INDENT 0.0
198 .TP
199 .B \-\-change\-justification
200 Cambia allineamento del testo. Impostato a \fB\(dq\fPsinistra\fB\(dq\fP il testo della sorgente sarà convertito con un allineamento a sinistra. Impostato a \fB\(dq\fPgiustificato\fB\(dq\fP il testo verrà distribuito per larghezza della pagina. Impostato a \fB\(dq\fPoriginale\fB\(dq\fP (predefinito) l\fB\(aq\fPallineamento non verrà cambiato. Notare che solo alcuni formati di output supportano il testo giustificato.
201 .UNINDENT
202 .INDENT 0.0
203 .TP
204 .B \-\-disable\-font\-rescaling
205 Disabilita ogni ridimensionamento delle dimensioni dei caratteri.
206 .UNINDENT
207 .INDENT 0.0
208 .TP
209 .B \-\-embed\-all\-fonts
210 Incorpora qualsiasi carattere che sia referenziato ma non ancora incorporato nel documento di input. Verranno cercati i caratteri nel sistema e, se trovati, verranno incorporati. L\fB\(aq\fPincorporamento funziona solo se il formato di destinazione, come EPUB, AZW3, DOCX o PDF, supporta l\fB\(aq\fPincorporamento dei caratteri. Assicurati di avere una licenza valida per l\fB\(aq\fPincorporamento dei caratteri usati nel documento.
211 .UNINDENT
212 .INDENT 0.0
213 .TP
214 .B \-\-embed\-font\-family
215 Incorpora la famiglia caratteri specificata nel libro. Permette di specificare il carattere di \fB\(dq\fPbase\fB\(dq\fP utilizzato per il libro. Se il documento di input specifica i propri caratteri, potrebbero sovrascrivere il carattere di base. Nota che l\fB\(aq\fPincorporamento dei caratteri funziona solo con alcuni formati di output, tra cui EPUB, AZW3 e DOCX.
216 .UNINDENT
217 .INDENT 0.0
218 .TP
219 .B \-\-expand\-css
220 Per impostazione predefinita, calibre utilizza la forma abbreviata per varie proprietà CSS come margin, padding, border, ecc. Questa opzione farà usare invece la loro forma completa. Tieni presente che il CSS è sempre espanso quando si generano file EPUB con il profilo di output impostato su uno dei profili Nook, in quanto il Nook non può gestire un CSS abbreviato.
221 .UNINDENT
222 .INDENT 0.0
223 .TP
224 .B \-\-extra\-css
225 Questo può essere il percorso di un foglio di stile CSS o semplice codice CSS. Il CSS verrà unito alle regole di stile del file sorgente e pertanto può essere usato per prevalere su di esse.
226 .UNINDENT
227 .INDENT 0.0
228 .TP
229 .B \-\-filter\-css
230 Un elenco separato da virgole delle proprietà CSS che saranno rimosse da tutte le regole di stile CSS. Ciò è utile se la presenza di alcune informazioni di stile impedisce l\fB\(aq\fPapplicazione delle regole del dispositivo. Ad esempio: font\-family,color,margin\-left,margin\-right
231 .UNINDENT
232 .INDENT 0.0
233 .TP
234 .B \-\-font\-size\-mapping
235 Correla le dimensioni relative dei caratteri CSS a valori di dimensione in pt. Un esempio di valori è 10,12,14,16,18,20,22,24. Questi sono i valori per le dimensioni che vanno da xx\-small a xx\-large, con l\fB\(aq\fPultima dimensione usata per caratteri enormi. L\fB\(aq\fPalgoritmo di ridimensionamento usa questi riferimenti per ridimensionare i caratteri. L\fB\(aq\fPimpostazione predefinita è l\fB\(aq\fPutilizzo di valori basati sul profilo di output scelto.
236 .UNINDENT
237 .INDENT 0.0
238 .TP
239 .B \-\-insert\-blank\-line
240 Inserisci una riga vuota tra i paragrafi. Non funzionerà se il file sorgente non usa i paragrafi (tag <p> o <div>).
241 .UNINDENT
242 .INDENT 0.0
243 .TP
244 .B \-\-insert\-blank\-line\-size
245 Imposta l\fB\(aq\fPaltezza delle righe vuote inserite (in em). L\fB\(aq\fPaltezza delle righe tra i paragrafi sarà doppia del valore impostato qui.
246 .UNINDENT
247 .INDENT 0.0
248 .TP
249 .B \-\-keep\-ligatures
250 Mantieni le legature presenti nel documento di ingresso. Una legatura è un carattere combinato dato dall\fB\(aq\fPunione di una coppia di caratteri, come ff, fi, fl, eccetera. La maggior parte dei lettori non supporta le legature nei loro caratteri predefiniti, perciò probabilmente queste non verranno mostrate correttamente. Per impostazione predefinita calibre divide le legature nei due caratteri normali corrispondenti. Tieni presente che qui per legature si intendono solo le legature unicode, e non le legature create con CSS o stili di carattere. Questa opzione invece le manterrà.
251 .UNINDENT
252 .INDENT 0.0
253 .TP
254 .B \-\-line\-height
255 Altezza della riga, espressa in punti. Gestisce la spaziatura tra righe consecutive di testo. Si applica solo ad elementi che non definiscono la propria altezza di riga. Nella maggior parte dei casi, l\fB\(aq\fPopzione che definisce l\fB\(aq\fPaltezza minima della riga è più utile. Per impostazione predefinita non viene applicata alcuna manipolazione di altezza di riga.
256 .UNINDENT
257 .INDENT 0.0
258 .TP
259 .B \-\-linearize\-tables
260 Alcuni documenti mal costruiti usano tabelle per controllare la struttura del testo nella pagina. Questi documenti, una volta convertiti, spesso presentano testi non allineati nella pagina ed altri difetti grafici. Questa opzione estrae il contenuto dalle tabelle e lo presenta in maniera lineare.
261 .UNINDENT
262 .INDENT 0.0
263 .TP
264 .B \-\-margin\-bottom
265 Imposta il margine inferiore in pt. Il valore predefinito è 5.0. L\fB\(aq\fPimpostazione a un valore minore di zero non produrrà alcuna variazione del margine (rimarrà impostato il valore originale). Nota: formati basati sulle pagine come PDF e DOCX hanno impostazioni interne sui margini, che prevalgono.
266 .UNINDENT
267 .INDENT 0.0
268 .TP
269 .B \-\-margin\-left
270 Imposta il margine sinistro in pt. Il valore predefinito è 5.0. L\fB\(aq\fPimpostazione a un valore minore di zero non produrrà alcuna variazione del margine (rimarrà impostato il valore originale). Nota: formati basati sulle pagine come PDF e DOCX hanno impostazioni interne sui margini, che prevalgono.
271 .UNINDENT
272 .INDENT 0.0
273 .TP
274 .B \-\-margin\-right
275 Imposta il margine destro in pt. Il valore predefinito è 5.0. L\fB\(aq\fPimpostazione a un valore minore di zero non produrrà alcuna variazione del margine (rimarrà impostato il valore originale). Nota: formati basati sulle pagine come PDF e DOCX hanno impostazioni interne sui margini, che prevalgono.
276 .UNINDENT
277 .INDENT 0.0
278 .TP
279 .B \-\-margin\-top
280 Imposta il margine superiore in pt. Il valore predefinito è 5.0. L\fB\(aq\fPimpostazione a un valore minore di zero non produrrà alcuna variazione del margine (rimarrà impostato il valore originale). Nota: formati basati sulle pagine come PDF e DOCX hanno impostazioni interne sui margini, che prevalgono.
281 .UNINDENT
282 .INDENT 0.0
283 .TP
284 .B \-\-minimum\-line\-height
285 L\fB\(aq\fPaltezza minima della riga, come percentuale della dimensione carattere calcolata dell\fB\(aq\fPelemento. calibre farà in modo che ogni elemento abbia un\fB\(aq\fPaltezza di riga di almeno questo valore, senza tenere conto di quanto specifica il documento sorgente. Per disabilitare, imposta il valore a zero. Il valore predefinito è 120%. Usa questa impostazione come prima scelta rispetto all\fB\(aq\fPimpostazione diretta dell\fB\(aq\fPaltezza della riga, a meno di non sapere esattamente cosa stai facendo. Ad esempio, puoi ottenere impostare una \fB\(dq\fPspaziatura doppia\fB\(dq\fP utilizzando come valore 240.
286 .UNINDENT
287 .INDENT 0.0
288 .TP
289 .B \-\-remove\-paragraph\-spacing
290 Rimuovi gli spazi fra i paragrafi. Imposta anche un rientro dei paragrafi di 1.5em. La rimozione degli spazi non funzionerà se il documento sorgente non usa la notazione per i paragrafi del tipo <p> o <div>.
291 .UNINDENT
292 .INDENT 0.0
293 .TP
294 .B \-\-remove\-paragraph\-spacing\-indent\-size
295 Quando calibre rimuove le righe vuote tra paragrafi, imposta automaticamente un rientro di paragrafo, per assicurare che i paragrafi siano facilmente distinguibili. Questa opzione controlla l\fB\(aq\fPampiezza di questo rientro (in em). Se imposti un valore negativo, viene utilizzato il rientro specificato nel documento in ingresso, in altre parole, calibre non cambierà il rientro.
296 .UNINDENT
297 .INDENT 0.0
298 .TP
299 .B \-\-smarten\-punctuation
300 Converti virgolette, trattini e puntini di sospensione semplici nei loro equivalenti tipografici corretti. Per dettagli, vedi: \%<https://\:daringfireball\:.net/\:projects/\:smartypants>\&.
301 .UNINDENT
302 .INDENT 0.0
303 .TP
304 .B \-\-subset\-embedded\-fonts
305 Crea un sottoinsieme di tutti i caratteri integrati. Ogni carattere integrato è ridotto per contenere solo i glifi utilizzati in questo documento. Ciò riduce la dimensione dei file dei caratteri. Utile se stai incorporando un carattere particolarmente grande con molti glifi non utilizzati.
306 .UNINDENT
307 .INDENT 0.0
308 .TP
309 .B \-\-transform\-css\-rules
310 Percorso a un file che contiene regole per trasformare gli stili CSS di questo libro. Il modo più semplice per creare questo file è quello di usare la procedura guidata per la creazione di regole nell\fB\(aq\fPinterfaccia utente di calibre. Avvialo dalla sezione della finestra di conversione \fB\(dq\fPAspetto\->Trasforma stili\fB\(dq\fP\&. Dopo aver creato queste regole, puoi usare il pulsante \fB\(dq\fPEsporta\fB\(dq\fP per salvarle in un file.
311 .UNINDENT
312 .INDENT 0.0
313 .TP
314 .B \-\-transform\-html\-rules
315 Percorso a un file che contiene regole per trasformare il codice HTML di questo libro. Il modo più semplice per creare questo file è quello di usare la procedura guidata per la creazione di regole nell\fB\(aq\fPinterfaccia utente di calibre. Avvialo dalla sezione della finestra di conversione \fB\(dq\fPAspetto\->Trasforma HTML\fB\(dq\fP\&. Dopo aver creato queste regole, puoi usare il pulsante \fB\(dq\fPEsporta\fB\(dq\fP per salvarle in un file.
316 .UNINDENT
317 .INDENT 0.0
318 .TP
319 .B \-\-unsmarten\-punctuation
320 Converti virgolette eleganti, trattini e punti di sospensione nel loro equivalente semplice.
321 .UNINDENT
322 .SH ELABORAZIONE EURISTICA
323 .sp
324 Modifica il testo e la struttura del documento utilizzando schemi comuni. Disabilitata in modo predefinito. Usa \-\-enable\-heuristics per abilitarla. Azioni singole possono essere disabilitate con le opzioni \-\-disable\-
325 .nf
326 *
327 .fi
328 \&.
329 .INDENT 0.0
330 .TP
331 .B \-\-disable\-dehyphenate
332 Analizza nel documento le parole che contengono un trattino. Lo stesso documento è utilizzato come un dizionario per determinare quando i trattini devono essere rimossi o mantenuti.
333 .UNINDENT
334 .INDENT 0.0
335 .TP
336 .B \-\-disable\-delete\-blank\-paragraphs
337 Rimuovi i paragrafi vuoti dal documento quando sono presenti tra gli altri paragrafi
338 .UNINDENT
339 .INDENT 0.0
340 .TP
341 .B \-\-disable\-fix\-indents
342 Cambia il rientro ottenuto con spazi multipli in un rientro CSS.
343 .UNINDENT
344 .INDENT 0.0
345 .TP
346 .B \-\-disable\-format\-scene\-breaks
347 I marcatori di interruzione di scena allineati a sinistra sono centrati. Sostituisci le interruzioni di scena leggere, che usano più paragrafi vuoti, con un tratteggio orizzontale.
348 .UNINDENT
349 .INDENT 0.0
350 .TP
351 .B \-\-disable\-italicize\-common\-cases
352 Cerca parole e segni che indicano l\fB\(aq\fPuso del corsivo e rendili in corsivo.
353 .UNINDENT
354 .INDENT 0.0
355 .TP
356 .B \-\-disable\-markup\-chapter\-headings
357 Rileva i titoli e i sottotitoli di paragrafo non formattati. Cambia i tag in h2 e h3. Questa impostazione non creerà un indice, ma può essere utilizzata con la funzione di rilevamento della struttura crearne uno.
358 .UNINDENT
359 .INDENT 0.0
360 .TP
361 .B \-\-disable\-renumber\-headings
362 Cerca occorrenze di sequenze di tag <h1> o <h2>. I tag sono rinumerati per prevenire la divisione a metà del titolo di capitolo.
363 .UNINDENT
364 .INDENT 0.0
365 .TP
366 .B \-\-disable\-unwrap\-lines
367 Unisci le righe utilizzando la punteggiatura o altri metodi di formattazione.
368 .UNINDENT
369 .INDENT 0.0
370 .TP
371 .B \-\-enable\-heuristics
372 Abilita l\fB\(aq\fPelaborazione euristica. Questa opzione deve essere impostata per attivare l\fB\(aq\fPelaborazione euristica.
373 .UNINDENT
374 .INDENT 0.0
375 .TP
376 .B \-\-html\-unwrap\-factor
377 Scala usata per determinare la posizione alla quale una riga dovrebbe essere ricongiunta. I valori ammessi sono i decimali compresi tra 0 e 1. Il valore predefinito è 0.4, appena inferiore al valore mediano della lunghezza. Se solo alcune righe del documento richiedono il ricongiungimento questo valore dovrebbe essere ridotto.
378 .UNINDENT
379 .INDENT 0.0
380 .TP
381 .B \-\-replace\-scene\-breaks
382 Sostituisci i marcatori di interruzione scena con un testo specifico. In modo predefinito, viene usato il testo del documento.
383 .UNINDENT
384 .SH CERCA E SOSTITUISCI
385 .sp
386 Modifica il testo e la struttura del documento usando pattern definiti.
387 .INDENT 0.0
388 .TP
389 .B \-\-search\-replace
390 Percorso a un file che contiene espressioni regolari di ricerca e sostituzione. Il file deve contenere linee alternate di espressione regolare seguita da un modello di sostituzione (anche una riga vuota). L\fB\(aq\fPespressione regolare deve seguire la sintassi regex di Python e il file deve utilizzare la codifica UTF\-8.
391 .UNINDENT
392 .INDENT 0.0
393 .TP
394 .B \-\-sr1\-replace
395 Elemento sostitutivo del testo trovato con sr1\-search.
396 .UNINDENT
397 .INDENT 0.0
398 .TP
399 .B \-\-sr1\-search
400 Pattern di ricerca (espressione regolare) da sostituire con sr1\-replace.
401 .UNINDENT
402 .INDENT 0.0
403 .TP
404 .B \-\-sr2\-replace
405 Elemento sostitutivo del testo trovato con sr2\-search.
406 .UNINDENT
407 .INDENT 0.0
408 .TP
409 .B \-\-sr2\-search
410 Pattern di ricerca (espressione regolare) da sostituire con sr2\-replace.
411 .UNINDENT
412 .INDENT 0.0
413 .TP
414 .B \-\-sr3\-replace
415 Elemento sostitutivo del testo trovato con sr3\-search.
416 .UNINDENT
417 .INDENT 0.0
418 .TP
419 .B \-\-sr3\-search
420 Pattern di ricerca (espressione regolare) da sostituire con sr3\-replace.
421 .UNINDENT
422 .SH RILEVAZIONE STRUTTURA
423 .sp
424 Controlla il rilevamento automatico della struttura del documento.
425 .INDENT 0.0
426 .TP
427 .B \-\-add\-alt\-text\-to\-img
428 Quando un tag <img> non contiene l\fB\(aq\fPattributo alt, controlla nel file di immagine associato la presenza di metadati che specificano un testo alternativo, e usali per riempire l\fB\(aq\fPattributo alt. L\fB\(aq\fPattributo alt migliora l\fB\(aq\fPaccessibilità fornendo descrizioni testuali agli utenti che non sono in grado di vedere o interpretare completamente il contenuto visuale.
429 .UNINDENT
430 .INDENT 0.0
431 .TP
432 .B \-\-chapter
433 Un\fB\(aq\fPespressione XPath per rilevare i titoli dei capitoli. Per impostazione predefinita si considerano come titoli di capitolo i tag <h1> o <h2> che contengono le parole \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 o \fB\(dq\fPpart\fB\(dq\fP, così come ogni tag che contenga class=\fB\(dq\fPchapter\fB\(dq\fP\&. L\fB\(aq\fPespressione usata deve restituire un elenco di elementi. Per disabilitare la rilevazione dei capitoli, usa l\fB\(aq\fPespressione \fB\(dq\fP/\fB\(dq\fP\&. Vedi la Guida XPath nel manuale utente di calibre per ulteriore aiuto nell\fB\(aq\fPusare questa funzione.
434 .UNINDENT
435 .INDENT 0.0
436 .TP
437 .B \-\-chapter\-mark
438 Specificare come marcare i capitoli rilevati. Il valore \fB\(dq\fPpagebreak\fB\(dq\fP inserirà un\fB\(aq\fPinterruzione di pagina prima del capitolo. Il valore \fB\(dq\fPrule\fB\(dq\fP inserirà una linea prima del capitolo. Il valore \fB\(dq\fPnone\fB\(dq\fP disabiliterà la marcatura dei capitoli e il valore \fB\(dq\fPboth\fB\(dq\fP userà sia l\fB\(aq\fPinterruzione di pagina che la linea per marcare i capitoli.
439 .UNINDENT
440 .INDENT 0.0
441 .TP
442 .B \-\-disable\-remove\-fake\-margins
443 Alcuni documenti specificano i margini destro e sinistro per ogni singolo paragrafo. calibre cercherà di trovare ed eliminare questi margini. Qualche volta questo meccanismo elimina però dei margini che non dovrebbero essere rimossi. In questo caso disabilita la funzione.
444 .UNINDENT
445 .INDENT 0.0
446 .TP
447 .B \-\-insert\-metadata
448 Inserisci i metadati del libro all\fB\(aq\fPinizio. Utile se il dispositivo non supporta la visualizzazione/ricerca di metadati direttamente.
449 .UNINDENT
450 .INDENT 0.0
451 .TP
452 .B \-\-page\-breaks\-before
453 Un\fB\(aq\fPespressione XPath. Le interruzioni di pagina sono inserite prima degli elementi specificati. Per disabilitarla, usa l\fB\(aq\fPespressione: /
454 .UNINDENT
455 .INDENT 0.0
456 .TP
457 .B \-\-prefer\-metadata\-cover
458 Usa la copertina rilevata dal file di origine al posto di quella specificata.
459 .UNINDENT
460 .INDENT 0.0
461 .TP
462 .B \-\-remove\-first\-image
463 Rimuovi la prima immagine dall\fB\(aq\fPe\-book in ingresso. Utile se il documento in ingresso ha un\fB\(aq\fPimmagine di copertina che non è identificata come tale. In questo caso, se imposti una copertina tramite calibre, il documento si troverà con due immagini di copertina se non specifichi questa opzione.
464 .UNINDENT
465 .INDENT 0.0
466 .TP
467 .B \-\-start\-reading\-at
468 Un\fB\(aq\fPespressione XPath per rilevare la posizione nel documento da cui cominciare la lettura. Alcuni programmi di lettura e\-book (in particolare Kindle) usano questa posizione come quella in cui il libro viene aperto. Vedi la guida XPath nel manuale utente di calibre per maggiori informazioni sull\fB\(aq\fPutilizzo di questa funzione.
469 .UNINDENT
470 .SH INDICE
471 .sp
472 Gestisce la generazione automatica dell\(aqindice. In modo predefinito, se il file sorgente ha un indice, questo sarà preferito a quello generato automaticamente.
473 .INDENT 0.0
474 .TP
475 .B \-\-duplicate\-links\-in\-toc
476 Quando crei un indice dai collegamenti nel documento in ingresso, consenti la duplicazione delle voci, ovvero permetti più di una voce con lo stesso testo, a condizione che si riferiscano a una posizione diversa.
477 .UNINDENT
478 .INDENT 0.0
479 .TP
480 .B \-\-level1\-toc
481 L\fB\(aq\fPespressione XPath che specifica tutti i tag che devono essere aggiunti al primo livello dell\fB\(aq\fPindice. Se è specificato, ha la precedenza su altre forme di rilevamento automatico. Vedi la guida a XPath del manuale utente di calibre per gli esempi.
482 .UNINDENT
483 .INDENT 0.0
484 .TP
485 .B \-\-level2\-toc
486 L\fB\(aq\fPespressione XPath che specifica tutti i tag che devono essere aggiunti al secondo livello dell\fB\(aq\fPindice. Ogni voce è aggiunta sotto la precedente voce di primo livello. Vedi la guida a XPath del manuale utente di calibre per gli esempi.
487 .UNINDENT
488 .INDENT 0.0
489 .TP
490 .B \-\-level3\-toc
491 L\fB\(aq\fPespressione XPath che specifica tutti i tag che devono essere aggiunti al terzo livello dell\fB\(aq\fPindice. Ogni voce è aggiunta sotto la precedente voce di secondo livello. Vedi la guida a XPath del manuale utente di calibre per gli esempi.
492 .UNINDENT
493 .INDENT 0.0
494 .TP
495 .B \-\-max\-toc\-links
496 Massimo numero di collegamenti da inserire nell\fB\(aq\fPindice. Inserisci 0 per disabilitare. Il valore predefinito è 50. I collegamenti sono aggiunti all\fB\(aq\fPindice soltanto se non viene raggiunto il valore soglia dei capitoli.
497 .UNINDENT
498 .INDENT 0.0
499 .TP
500 .B \-\-no\-chapters\-in\-toc
501 Non aggiungere i capitoli rilevati automaticamente all\fB\(aq\fPindice.
502 .UNINDENT
503 .INDENT 0.0
504 .TP
505 .B \-\-toc\-filter
506 Rimuovi dall\fB\(aq\fPindice le voci il cui titolo corrisponde alla espressione specificata. Le voci che corrispondono saranno rimosse insieme alle voci \fB\(dq\fPfiglie\fB\(dq\fP\&.
507 .UNINDENT
508 .INDENT 0.0
509 .TP
510 .B \-\-toc\-threshold
511 Se viene rilevato un numero di capitoli inferiore a questo numero, i collegamenti interni al libro saranno aggiunti all\fB\(aq\fPindice. Predefinito: 6
512 .UNINDENT
513 .INDENT 0.0
514 .TP
515 .B \-\-use\-auto\-toc
516 Normalmente, se il file sorgente possiede già un indice, esso è usato di preferenza rispetto a quello auto\-generato. Con questa opzione, verrà sempre usato l\fB\(aq\fPindice auto\-generato.
517 .UNINDENT
518 .SH METADATI
519 .sp
520 Opzioni per impostare i metadati in output
521 .INDENT 0.0
522 .TP
523 .B \-\-author\-sort
524 Stringa da utilizzare quando si ordina per autore.
525 .UNINDENT
526 .INDENT 0.0
527 .TP
528 .B \-\-authors
529 Imposta gli autori. Autori multipli devono essere separati dal carattere &.
530 .UNINDENT
531 .INDENT 0.0
532 .TP
533 .B \-\-book\-producer
534 Imposta il produttore del libro.
535 .UNINDENT
536 .INDENT 0.0
537 .TP
538 .B \-\-comments
539 Imposta la descrizione dell\fB\(aq\fPe\-book.
540 .UNINDENT
541 .INDENT 0.0
542 .TP
543 .B \-\-cover
544 Seleziona la copertina da un file o da un URL
545 .UNINDENT
546 .INDENT 0.0
547 .TP
548 .B \-\-isbn
549 Imposta il codice ISBN del libro.
550 .UNINDENT
551 .INDENT 0.0
552 .TP
553 .B \-\-language
554 Imposta la lingua.
555 .UNINDENT
556 .INDENT 0.0
557 .TP
558 .B \-\-pubdate
559 Imposta la data di pubblicazione (viene usata l\fB\(aq\fPora locale, a meno che il fuso orario non sia specificato esplicitamente)
560 .UNINDENT
561 .INDENT 0.0
562 .TP
563 .B \-\-publisher
564 Imposta l\fB\(aq\fPeditore dell\fB\(aq\fPe\-book.
565 .UNINDENT
566 .INDENT 0.0
567 .TP
568 .B \-\-rating
569 Imposta la valutazione. Deve essere un numero compreso tra 1 e 5.
570 .UNINDENT
571 .INDENT 0.0
572 .TP
573 .B \-\-read\-metadata\-from\-opf, \-\-from\-opf, \-m
574 Leggi i metadati dal file OPF specificato. I metadati letti da questo file sovrascrivono qualunque altro metadato presente nel file sorgente.
575 .UNINDENT
576 .INDENT 0.0
577 .TP
578 .B \-\-series
579 Imposta la serie alla quale questo e\-book appartiene.
580 .UNINDENT
581 .INDENT 0.0
582 .TP
583 .B \-\-series\-index
584 Imposta la numerazione del libro in questa serie.
585 .UNINDENT
586 .INDENT 0.0
587 .TP
588 .B \-\-tags
589 Imposta i tag per il libro. Deve essere un elenco separato da virgole.
590 .UNINDENT
591 .INDENT 0.0
592 .TP
593 .B \-\-timestamp
594 Imposta la marca temporale del libro (non più utilizzata ovunque)
595 .UNINDENT
596 .INDENT 0.0
597 .TP
598 .B \-\-title
599 Imposta il titolo.
600 .UNINDENT
601 .INDENT 0.0
602 .TP
603 .B \-\-title\-sort
604 La versione del titolo da usare per l\fB\(aq\fPordinamento.
605 .UNINDENT
606 .SH DEBUG
607 .sp
608 Opzioni per aiutare a individuare problemi con la conversione
609 .INDENT 0.0
610 .TP
611 .B \-\-debug\-pipeline, \-d
612 Salva l\fB\(aq\fPoutput dei differenti stadi di conversione raggiunti nella cartella specificata. Utile se non si conosce in quale stadio del processo di conversione si verifica l\fB\(aq\fPerrore.
613 .UNINDENT
614 .INDENT 0.0
615 .TP
616 .B \-\-verbose, \-v
617 Livello di verbosità. Specificare più volte per maggiore verbosità. Due volte verbosità massima, una volta per verbosità media e zero per quella più bassa.
618 .UNINDENT
619 .SH Author
620 Kovid Goyal
621 .SH Copyright
622 Kovid Goyal
623 .\" End of generated man page.