latexdiff - Online nel cloud

PROGRAMMA:

NOME

latexdiff: determina e contrassegna le differenze tra due file latex

SINOSSI

latticediff [ VERSIONI ] vecchio.tex nuovo.tex > diff.tex

DESCRIZIONE

Brevemente, latticediff è un programma di utilità per aiutare nella gestione delle revisioni di latex
documenti. Confronta due file latex validi, qui chiamati "old.tex" e "new.tex", trova
differenze significative tra loro (cioè, ignorando il numero di spazi bianchi e
posizione delle interruzioni di riga) e aggiunge comandi speciali per evidenziare le differenze. In cui si
l'evidenziazione visiva non è possibile, ad esempio per i cambiamenti nella formattazione, le differenze
sono comunque contrassegnati nella fonte.

Il programma tratta il preambolo in modo diverso dal documento principale. Differenze tra
i preamboli si trovano usando la differenziazione basata sulla linea (in modo simile al comando Unix diff,
ma ignorando gli spazi bianchi). Un commento, ""%DIF >"" viene aggiunto a ciascuna riga aggiunta, ad es
riga presente in "new.tex" ma non in "old.tex". Linee scartate
vengono disattivate anteponendo ""%DIF <"". I blocchi modificati sono preceduti da righe di commento
fornendo informazioni sui numeri di riga nei file originali. Dove ci sono
differenze insignificanti, il file risultante "diff.tex" sarà simile a "new.tex". In
alla fine del preambolo, le definizioni per latticediff vengono inseriti i comandi di markup. In
differenziare il corpo principale del testo, latticediff tenta di soddisfare quanto segue
linee guida (in ordine di priorità):

1. Se sia "old.tex" che "new.tex" sono LaTeX validi, allora il "diff.tex" risultante dovrebbe
essere valido anche Latex. (NB Se vengono utilizzati alcuni semplici comandi TeX all'interno di "old.tex" o
"new.tex" quindi "diff.tex" non è garantito che funzioni, ma di solito lo farà).

2. Le differenze significative sono determinate a livello delle singole parole. Tutto
differenze significative, comprese le differenze tra i commenti dovrebbero essere chiaramente
contrassegnato nel codice sorgente risultante "diff.tex".

3. Se un passaggio modificato contiene testo o comandi per la produzione di testo, eseguire "diff.tex"
attraverso LateX dovrebbe produrre un output in cui sono evidenziati i passaggi aggiunti e scartati.

4. In caso di differenze insignificanti, ad esempio nel posizionamento delle interruzioni di riga,
"diff.tex" dovrebbe seguire la formattazione di "new.tex"

Per differenziare lo stesso algoritmo di diff è usato ma le parole invece delle linee sono
rispetto. Si tenta di riconoscere i blocchi completamente modificati in modo tale che
possono essere contrassegnati come un'unità. I commenti sono differenziati riga per riga ma il numero di
gli spazi all'interno dei commenti vengono ignorati. I comandi che includono tutti i loro argomenti sono generalmente
confrontato come un'unità, ovvero nessun markup viene inserito negli argomenti dei comandi.
Tuttavia, per un numero selezionato di comandi (ad esempio, "\caption" e tutte le sezioni
comandi) l'ultimo argomento è noto come testo. Questo testo è diviso in parole e
differenziato proprio come il testo normale (usa le opzioni per mostrare e cambiare l'elenco di testo
comandi, vedi sotto). Poiché l'algoritmo non ha una conoscenza dettagliata di LaTeX, assume tutto
coppie di parentesi graffe immediatamente dopo un comando (cioè una sequenza di lettere
che iniziano con una barra rovesciata) sono argomenti per quel comando. Come restrizione alla condizione
1 sopra è quindi necessario circondare tutti gli argomenti con parentesi graffe, e non
inserire spazi estranei. Ad esempio, scrivi

\section{\textem{Questo è un titolo di sezione enfatizzato}}

e non

\section {\textem{Questo è un titolo di sezione enfatizzato}}

or

\section\textem{Questo è un titolo di sezione enfatizzato}

anche se tutte le varietà sono uguali a LaTeX (ma vedi --allow-spazi opzione che
consente la seconda varietà).

Per ambienti il ​​cui contenuto non è conforme allo standard LaTeX o dove la grafica
markup non ha senso tutti i comandi di markup possono essere rimossi impostando PICTUREENV
variabile di configurazione, impostata di default sugli ambienti "picture" e "DIFnomarkup"; vedere
--config opzione). Quest'ultimo ambiente ("DIFnomarkup") può essere utilizzato per proteggere parti di
il file latex in cui il markup risulta in markup illegale. Devi circondare il
passaggio offensivo sia nel vecchio che nel nuovo file di "\begin{DIFnomarkup}" e
"\end{DIFnomarkup}". È necessario definire l'ambiente nei preamboli sia del vecchio che del nuovo
documenti. Preferisco definirlo un ambiente nullo,

"\newenvironment{DIFnomarkup}{}{}"

ma la scelta è tua. Qualsiasi markup all'interno dell'ambiente verrà rimosso e generalmente
tutto all'interno dell'ambiente verrà semplicemente preso dal nuovo file.

È anche possibile differenziare i file che non hanno un preambolo.
In questo caso, il file viene elaborato nella modalità documento principale, ma le definizioni del
i comandi di markup non vengono inseriti.

Tutti i comandi di markup inseriti da latticediff iniziare con ""\DIF"". Aggiunti blocchi contenenti
parole, comandi o commenti che sono in "new.tex" ma non in "old.tex" sono contrassegnati da
"\DIFaddbegin" e "\DIFaddend". I blocchi scartati sono contrassegnati da "\DIFdelbegin" e
"\DIFdelend". All'interno dei blocchi aggiunti tutto il testo è evidenziato con "\DIFadd" in questo modo:
"\DIFadd{Blocco di testo aggiunto}" I comandi `sicuri' selezionati possono essere contenuti in questi blocchi di testo
anche (usa le opzioni per mostrare e modificare l'elenco dei comandi sicuri, vedi sotto). Tutti gli altri
i comandi e le parentesi graffe "{" e "}" non vengono mai inseriti nell'ambito di "\DIFadd". Aggiunto
i commenti sono contrassegnati anteponendo ""%DIF > "".

All'interno dei blocchi eliminati il ​​testo è evidenziato con "\DIFdel". I commenti eliminati sono contrassegnati da
anteponendo ""%DIF < "". Il comando non sicuro e le parentesi graffe all'interno dei blocchi eliminati sono
commentato con ""%DIFDELCMD < "".

VERSIONI

Preambolo
Le seguenti opzioni determinano lo stile di markup visivo aggiungendo il comando appropriato
definizioni al preambolo. Vedere la fine di questa sezione per una descrizione di disponibile
stili.

--type=stile di markup or -t stile di markup
Aggiungi codice al preambolo per lo stile di markup selezionato. Questa opzione definisce "\DIFadd" e
comandi "\DIFdel". Stili disponibili:

"SOTTOLINEATO CFONT TRADIZIONALE TRADIZIONALE FONTSTRIKE INVISIBLE CHANGEBAR CCHANGEBAR
CULINECHBAR CFONTCBHBAR BOLD"

[ Predefinito: "SOTTOLINEA" ]

--subtype=stile segno or -s stile di contrassegno
Aggiungi codice al preambolo per lo stile selezionato per i comandi di parentesi (ad esempio per contrassegnare le modifiche
a margine). Questa opzione definisce "\DIFaddbegin", "\DIFaddend", "\DIFdelbegin" e
comandi "\DIFdelend". Stili disponibili: "SAFE MARGIN COLOR DVIPSCOL ZLABEL
SOLO PAGINA CAMBIATA (ETICHETTA)*"

[ Predefinito: "SAFE" ] * Il sottotipo "LABEL" è deprecato

--floattype=stile segno or -f stile di contrassegno
Aggiungi codice al preambolo per lo stile selezionato che sostituisce la marcatura e il markup standard
comandi all'interno di float (ad esempio, le osservazioni marginali causano un errore all'interno di float così
la marcatura marginale può essere così disabilitata). Questa opzione definisce tutti i comandi "\DIF...FL".
Stili disponibili: "FLOATSAFE TRADIZIONALSAFE IDENTICAL"

[ Predefinito: "FLOATSAFE" ]

--codifica=enc or -e enc
Specificare la codifica di old.tex e new.tex. Le codifiche tipiche sono "ascii", "utf8",
"latino1", "latino9". Un elenco delle codifiche disponibili può essere ottenuto eseguendo

"perl -MEncode -e 'print join ("\n",Encode-"encodings( ":all" )) ;' >

[La codifica predefinita è utf8 a meno che le prime righe del preambolo non contengano an
invocazione "\usepackage[..]{inputenc}" nel qual caso la codifica scelta da questo
si assume il comando. Nota che ASCII (lattice standard) è un sottoinsieme di utf8]

--preambolo=file or -p filetto
Inserisci il file alla fine del preambolo invece di generare il preambolo. Il preambolo deve
definire i seguenti comandi "\DIFaddbegin, \DIFaddend, \DIFadd{..},
\DIFdelbegin,\DIFdelend,\DIFdel{..}," e varietà da usare all'interno dei float
"\DIFaddbeginFL, \DIFaddendFL, \DIFaddFL{..}, \DIFdelbeginFL, \DIFdelendFL,
\DIFdelFL{..}" (Se questa opzione è impostata -t, -se -f le opzioni vengono ignorate.)

--pacchetti=pkg1,pkg2,..
Dire a latexdiff che il file .tex viene elaborato con i pacchetti nell'elenco caricati. Questo è
normalmente non è necessario se il file .tex include il preambolo, come lo è il preambolo
scansionato automaticamente per i comandi "\usepackage". Uso del --Pacchetti opzione
disabilita la scansione automatica, quindi se per qualsiasi motivo l'analisi specifica del pacchetto deve essere
spento, utilizzare --pacchetti=nessuno. I seguenti pacchetti attivano un comportamento speciale:

"amsmath"
La variabile di configurazione MATHARRREPL è impostata su "align*" (predefinito: "eqnarray*").
(Nota che molti degli ambienti array amsmath sono già riconosciuti da
predefinito in quanto tale)

"endfloat"
Assicurati che "\begin{figure}" e "\end{figure}" appaiano sempre da soli su
una linea.

"iperref"
Cambia il nome dei comandi "\DIFadd" e "\DIFdel" in "\DIFaddtex" e
"\DIFdeltex" e definire i nuovi comandi "\DIFadd" e "\DIFdel", che forniscono a
wrapper per questi comandi, usandoli per il testo ma non per il collegamento
definendo il comando (dove qualsiasi markup causerebbe errori).

"apacita"
Ridefinire i comandi riconosciuti come comandi di citazione.

"siunix"
Considera "\SI" come equivalente ai comandi di citazione (cioè proteggi con "\mbox" se
lo stile di markup utilizza il pacchetto ulem.

"intelligente"
Tratta "\cref,\Cref", ecc. come equivalente ai comandi di citazione (cioè proteggi con
"\mbox" se lo stile di markup utilizza il pacchetto ulem.

"glossari"
Definisci la maggior parte dei comandi dei glossari come sicuri, proteggendoli con \mbox'es
dove necessario

"mhchem"
Considera "\ce" come un comando sicuro, cioè verrà evidenziato (nota che "\cee"
non verrà evidenziato nelle equazioni in quanto ciò porta a errori di elaborazione)

"chemformula" o "chemmacros"
Tratta "\ch" come un comando sicuro al di fuori delle equazioni, cioè verrà evidenziato
(nota che "\ch" non sarà evidenziato nelle equazioni poiché questo porta a
errori di elaborazione)

[ Predefinito: scansiona il preambolo per i comandi "\usepackage" per determinare
pacchi caricati. ]

--show-preambolo
Stampa comandi preambolo generati o inclusi su stdout.

Configurazione
--exclude-safecmd=escludi-file or -A file-escludi or --exclude-safecmd="cmd1,cmd2,..."
--replace-safecmd=sostituisci-file
--append-safecmd=aggiungi-file or -a file-append or --append-safecmd="cmd1,cmd2,..."
Escludi da, sostituisci o aggiungi all'elenco di espressioni regolari (RegEx) corrispondenti
comandi che sono sicuri da usare nell'ambito di un comando "\DIFadd" o "\DIFdel".
Il file deve contenere un Perl-RegEx per riga (le righe di commento che iniziano con # o % sono
ignorato). Nota che RegEx deve corrispondere all'intero token, ad esempio /^regex$/
è implicito e che l'iniziale "\" del comando non è inclusa. Il
--exclude-safecmd ed --append-safecmd le opzioni possono essere combinate con il
---replace-safecmd opzione e può essere utilizzato ripetutamente per aggiungere cumulativamente agli elenchi.
--exclude-safecmd ed --append-safecmd può anche prendere un elenco separato da virgole come input.
Se è richiesta una virgola per una delle espressioni regolari, esegui l'escape in questo modo "\,". Nella maggior parte dei casi è
sarà necessario per proteggere l'elenco separato da virgole dalla shell inserendolo
Virgolette.

--exclude-textcmd=escludi-file or -X file-escludi or --exclude-textcmd="cmd1,cmd2,..."
--replace-textcmd=sostituisci-file
--append-textcmd=aggiungi-file or -x file-append or --append-textcmd="cmd1,cmd2,..."
Escludi da, sostituisci o aggiungi all'elenco delle espressioni regolari che corrispondono ai comandi
il cui ultimo argomento è il testo. Vedi voce per --exclude-safecmd direttamente sopra per
maggiori dettagli.

--replace-context1cmd=sostituisci-file
--append-context1cmd=aggiungi-file o = oggetto --append-context1cmd="cmd1,cmd2,..."
Sostituisci o aggiungi all'elenco dei comandi corrispondenti alle espressioni regolari il cui ultimo argomento è testo
ma che richiedono un contesto particolare per funzionare, ad esempio \caption funzionerà solo all'interno di a
figura o tabella. Questi comandi si comportano come comandi di testo, tranne quando si verificano in
una sezione cancellata, quando sono disabilitati, ma il loro argomento viene mostrato come cancellato
testo.

--replace-context2cmd=sostituisci-file
--append-context2cmd=aggiungi-file o = oggetto --append-context2cmd="cmd1,cmd2,..."
Come comandi corrispondenti per context1. L'unica differenza è che i comandi context2
sono completamente disabilitati nelle sezioni eliminate, inclusi i loro argomenti.

--exclude-mboxsafecmd=escludi-file or --exclude-mboxsafecmd="cmd1,cmd2,..."
--append-mboxsafecmd=aggiungi-file or --append-mboxsafecmd="cmd1,cmd2,..."
Definire comandi sicuri, che devono inoltre essere protetti mediante l'incapsulamento in an
\\mbox{..}. Questo a volte è necessario per aggirare le incompatibilità tra esterni
pacchetti e il pacchetto ulem, che viene utilizzato per evidenziare nello stile predefinito
SOTTOLINEATO e CULINECHBAR CFONTSTRIKE

--config var1=val1,var2=val2,... or -c var1=val1,..
-c file di configurazione
Imposta le variabili di configurazione. L'opzione può essere ripetuta per impostare variabili diverse
(in alternativa all'elenco separato da virgole). Variabili disponibili (vedi sotto per
ulteriori spiegazioni):

"ARRENV" (RegEx)

"COUNTERCMD" (RegEx)

"FLOATENV" (RegEx)

"ITEMCMD" (RegEx)

"ASCOLTA" (RegEx)

"MATHARRENV" (RegEx)

"MATHARREPL" (Archi)

"MATHENV" (RegEx)

"MATHREPL" (Archi)

"MINWORDSBLOCK" (intero)

"PICTUREENV" (RegEx)

--show-safecmd
Stampa l'elenco dei comandi RegEx corrispondenti ed esclusi.

--mostra-testocmd
Stampa l'elenco dei comandi di corrispondenza ed esclusione di RegEx con argomento di testo.

--show-config
Mostra i valori delle variabili di configurazione.

--mostra tutto
Combina tutti i comandi --show.

NB Per tutti i comandi --show, non è necessario specificare alcun file "old.tex" o "new.tex", e
non avviene alcuna differenza.

Altro configurazione opzioni:
--allow-spazi
Consenti spazi tra gli argomenti tra parentesi quadre o tra parentesi quadre ai comandi. Nota che questa opzione
potrebbe avere effetti collaterali indesiderati (l'ambito non correlato potrebbe essere raggruppato con precedenti
comandi) quindi dovrebbe essere usato solo se l'impostazione predefinita produce risultati errati. (Predefinito
richiede che gli argomenti si susseguono direttamente senza spazi intermedi).

--math-markup=livello
Determinare la granularità del markup negli ambienti matematici visualizzati: possibili valori per
livello sono (sono accettabili sia etichette numeriche che di testo):

"off" o 0: sopprime il markup per gli ambienti matematici. Le equazioni eliminate non appariranno
nel file diff. Questa modalità può essere utilizzata se tutte le altre modalità causano codice latex non valido.

"intero" o 1: Differenziazione a livello di intere equazioni. Anche le modifiche banali a
le equazioni fanno sì che l'intera equazione venga contrassegnata come modificata. Questa modalità può essere utilizzata se
l'elaborazione in modalità grossolana o fine determina un codice in lattice non valido.

"grossolano" o 2: rileva le modifiche all'interno di equazioni contrassegnate con una granularità grossolana;
le modifiche al tipo di equazione (ad es. da displaymath a equazione) vengono visualizzate come una modifica al
equazione completa. Questa modalità è consigliata per situazioni in cui il contenuto e l'ordine
di alcune equazioni sono ancora in fase di modifica. [Predefinito]

"fine" o 3: rileva piccoli cambiamenti nelle equazioni e annota con granularità fine. Questo
la modalità è più adatta, se sono previste solo modifiche minori alle equazioni, ad es
correzione di errori di battitura.

--disable-citation-markup or --disable-auto-mbox
Sopprime il markup delle citazioni e il markup di altri comandi vulnerabili negli stili che utilizzano ulem
(SOTTOLINEA,FONTSTRIKE, CULINECHBAR) (le due opzioni sono identiche e sono semplicemente
alias)

--enable-citation-markup or --enforce-auto-mbox
Proteggi i comandi di citazione e altri comandi vulnerabili nelle sezioni modificate con
comando "\mbox", cioè usa il comportamento predefinito per il pacchetto ulem per altri pacchetti (il
due opzioni sono identiche e sono semplicemente degli alias)

Miscellanea
--verboso or -V
Invia varie informazioni di stato a stderr durante l'elaborazione. L'impostazione predefinita è lavorare
silenziosamente.

--driver=tipo
Scegli il driver per il pacchetto changebar (rilevante solo per gli stili che utilizzano
changebar: CCHANGEBAR CFONTCHBAR CULINECHBAR CHANGEBAR). I possibili driver sono
elencato nel manuale della barra di modifica, ad esempio pdftex, dvips, dvitops
[Predefinito: dvips]

--ignora-avvisi
Elimina gli avvisi sulle incongruenze di lunghezza tra le stringhe di input e analizzate e
personaggi mancanti. Questi messaggi di avviso sono spesso correlati a lattice non standard o
costruzioni in lattice con una sintassi sconosciuta a "latexdiff" ma la differenza risultante
l'argomento è spesso perfettamente funzionante comunque, in particolare se solo il lattice non standard
si verifica in parti del testo che non sono cambiate.

--label=etichetta or -L etichetta
Imposta le etichette utilizzate per descrivere i file vecchi e nuovi. Il primo utilizzo di questa opzione
imposta l'etichetta che descrive il vecchio file e il secondo utilizzo dell'opzione imposta l'etichetta
per il nuovo file, cioè imposta entrambe le etichette come questa "-L labelold -L labelnew". [Predefinito:
usa il nome del file e le date di modifica per l'etichetta]

--senza etichetta
Elimina l'inclusione di nomi di file vecchi e nuovi come commento nel file di output

--etichetta-visibile
Includi nomi di file vecchi e nuovi (o etichette impostate con l'opzione "--label") come output visibile.

--appiattire
Sostituisci i comandi "\input" e "\include" all'interno del corpo con il contenuto dei file in
il loro argomento. Se "\includeonly" è presente nel preambolo, solo quei file sono
ampliato nel documento. Tuttavia, non viene eseguita alcuna ricorsione, ad esempio "\input" e
I comandi "\include" all'interno delle sezioni incluse non vengono espansi. I file inclusi sono
si presumeva
trovarsi nelle stesse directory del vecchio e del nuovo file master, rispettivamente,
rendendo possibile organizzare i file in directory vecchie e nuove. --appiattire è
applicato in modo ricorsivo, quindi i file immessi possono contenere ulteriori istruzioni "\input".

L'utilizzo di questa opzione potrebbe comportare tempi di elaborazione proibitivi per documenti di grandi dimensioni,
e il documento di differenza risultante non riflette più la struttura dell'input
documenti.

--Aiuto or -h
Mostra il testo della guida

--versione
Mostra numero di versione

predefiniti stili
Maggiore Tipi di
Il tipo principale determina il markup del testo normale e alcuni comandi latex selezionati all'esterno
float definendo i comandi di markup "\DIFadd{...}" e "\DIFdel{...}" .

"SOTTOLINEARE"
Il testo aggiunto è sottolineato ondulato e blu, il testo scartato è barrato e rosso
(Richiede pacchetti colore e ulem). L'overstriking non funziona nella visualizzazione
equazioni matematiche tali che le parti cancellate dell'equazione siano sottolineate, non colpite
out (questo è un difetto inerente al pacchetto ulem).

"TRADIZIONALE"
Il testo aggiunto è blu e impostato in sans-serif, e per ciascuno viene creata una nota a piè di pagina rossa
pezzo di testo scartato. (Richiede il pacchetto colori)

"TRADIZIONALE"
Come "CTRADIZIONALE" ma senza l'uso del colore.

"CFONT" Il testo aggiunto è blu e impostato in sans-serif, mentre il testo scartato è rosso e molto
taglia piccola.

"COLPI DI FONT"
Il testo aggiunto è impostato in sans-serif, il testo scartato è piccolo e cancellato

"CAMBIO BARRA"
Il testo aggiunto è blu e il testo scartato è rosso. Inoltre, il testo modificato
è contrassegnato da una barra a margine (richiede pacchetti colore e barra di modifica).

"CFONTCHBAR"
Come "CFONT" ma con barre di modifica aggiuntive (richiede colore e barra di modifica
pacchi).

"CULINECHBAR"
Come "SOTTOLINEA" ma con barre di modifica aggiuntive (richiede colore, ulem e
pacchetti cambio).

"CAMBIO"
Nessun contrassegno del testo, ma contrassegna i margini con le barre di modifica (richiede la barra di modifica
pacchetto).

"INVISIBILE"
Nessun markup visibile (ma verranno comunque inseriti comandi di markup generici.

"BOLD" Il testo aggiunto è in grassetto, quello scartato non viene mostrato.

Sottotipi
Il sottotipo definisce i comandi che vengono inseriti all'inizio e alla fine di aggiunto o
blocchi scartati, indipendentemente dal fatto che questi blocchi contengano testo o comandi (Definito
comandi: "\DIFaddbegin, \DIFaddend, \DIFdelbegin, \DIFdelend")

"SAFE" Nessun markup aggiuntivo (Scelta consigliata)

"MARGIN" Contrassegna l'inizio e la fine dei blocchi modificati con i simboli nel margine vicino
(usando il comando standard "\marginpar" - nota che a volte questo si sposta
un po' dalla posizione prevista.

"COLORE" Un modo alternativo per contrassegnare in blu i passaggi aggiunti e in rosso quelli eliminati.
(Si consiglia di utilizzare invece i tipi principali per effettuare il markup colorato,
anche se in alcuni casi la colorazione con dvipscol può essere più completa, ad esempio
con comandi di citazione).

"DVIPSCOL"
Un modo alternativo per contrassegnare in blu i passaggi aggiunti e in rosso quelli eliminati.
Nota che "DVIPSCOL" funziona solo con il convertitore dvips, ad esempio non con pdflatex.
(si consiglia di utilizzare invece i tipi principali per effettuare il markup colorato,
anche se in alcuni casi la colorazione con dvipscol può essere più completa).

"ZLABEL" può essere utilizzato per evidenziare solo le pagine modificate, ma richiede la post-elaborazione. è
consiglio di non chiamare questa opzione manualmente ma di usare "latexdiff-vc" con
opzione "--only-changes". In alternativa, usa lo script fornito nel preambolo di
diff file realizzati con questo stile.

"SOLO PAGINA CAMBIATA"
evidenzia anche le pagine modificate, senza la necessità di post-elaborazione, ma potrebbe
non funziona in modo affidabile se è presente materiale fluttuante (figure, tabelle).

"LABEL" è simile a "ZLABEL", ma non necessita del pacchetto zref e funziona di meno
affidabile (deprecato).

galleggiante Tipi
Alcuni dei markup usati nel testo principale potrebbero causare problemi se usati all'interno di float
(es. figure o tabelle). Per questo motivo sono disponibili versioni alternative di tutti i comandi di markup
utilizzato all'interno di galleggianti. Il tipo float definisce questi comandi alternativi.

"SICURO PER IL GALLEGGIANTE"
Usa markup identico per il testo come nel corpo principale, ma imposta tutti i comandi di marcatura
l'inizio e la fine dei blocchi modificati in comandi null. Devi scegliere questo
tipo float se il tuo sottotipo è "MARGIN" poiché "\marginpar" non funziona correttamente
all'interno di galleggianti.

"TRADIZIONALE SICURO"
Segna le aggiunte allo stesso modo del testo principale. Gli ambienti eliminati sono
contrassegnato da parentesi angolari \[ e \] e il testo cancellato è impostato in scriptscript
dimensione. Questo tipo di galleggiante deve essere sempre utilizzato con il "TRADIZIONALE" e
Tipi di markup "CTRADIZIONALI" poiché il comando \footnote non funziona correttamente in
ambienti galleggianti.

"IDENTICO"
Non fare alcuna differenza tra il testo principale e i float.

Configurazione Variabili
"ARRENV" Se viene trovata una corrispondenza con "ARRENV" all'interno di un ambiente matematico in linea all'interno di a
blocco eliminato o aggiunto, quindi la matematica in linea è circondata da "\mbox{"..."}".
Ciò è necessario poiché la sottolineatura non funziona all'interno dell'array inline
ambienti.

[ Predefinito: "ARRENV"="(?:array|[pbvBV]matrice)"

"COUNTERCMD"
Se un comando in un blocco eliminato che si trova anche nell'elenco textcmd corrisponde
"COUNTERCMD" quindi un comando aggiuntivo "\addtocounter{"cntcmd"}{-1}", dove
cntcmd è il comando corrispondente, viene aggiunto nel file diff in modo tale che il
la numerazione nel file diff rimane sincronizzata con la numerazione nel nuovo
file.

[ Predefinito: "COUNTERCMD"="(?: nota a piè di pagina|parte|sezione|sottosezione" ...

"|sottosezione|paragrafo|sottoparagrafo)" ]

"FLOATENV"
Gli ambienti il ​​cui nome corrisponde all'espressione regolare in "FLOATENV" sono
considerati galleggianti. All'interno di questi ambienti, il latticediff i comandi di markup sono
sostituiti dalle loro variazioni FL.

[ Predefinito: "(?:figure|table|plate)[\w\d*@]*" ]

"ITEMCMD" Comandi che rappresentano una nuova riga di elementi con ambienti di elenco.

[Predefinito: \"elemento"]

"LISTENV" Gli ambienti il ​​cui nome corrisponde all'espressione regolare in "LISTENV" sono lista
ambienti.

[ Predefinito: "(?:itemize|enumerate|description)" ]

"MATHENV","MATHREPL"
Se sia \begin che \end per un ambiente matematico (corrispondenza del nome dell'ambiente
"MATHENV" o \[ e \]) sono all'interno dello stesso blocco eliminato, vengono sostituiti da
a \begin e \end comandi per "MATHREPL" piuttosto che essere commentati.

[ Predefinito: "MATHENV"="(?:displaymath|equation)" , "MATHREPL"="displaymath" ]

"MATHARRENV","MATHARRREPL"
come "MATHENV","MATHREPL" ma per gli array di equazioni

[ Predefinito: "MATHARRENV"="eqnarray\*?" , "MATHREPL"="eqnarray" ]

"MINWORDBLOCK"
Numero minimo di token necessari per formare un blocco indipendente. Questo valore è
utilizzato nell'algoritmo per rilevare i cambiamenti di blocchi completi unendo identici
parti di testo inferiori a "MINWORDSBLOCK" alla precedente aggiunte e scartate
parti.

[ Predefinito: 3 ]

"IMMAGINE ENV"
All'interno di ambienti il ​​cui nome corrisponde all'espressione regolare in "PICTUREENV"
tutto il markup latexdiff viene rimosso (in casi patologici questo potrebbe portare a
markup incoerente ma questa situazione dovrebbe essere rara).

[ Predefinito: "(?:immagine|DIFnomarkup)[\w\d*@]*" ]

COMUNI PROBLEMI E FAQ

Le citazioni risultano in riquadri troppo pieni
C'è un'incompatibilità tra il pacchetto "ulem", che usa "latexdiff"
per sottolineare e barrare nello stile UNDERLINE, lo stile predefinito, e
il modo in cui vengono generate le citazioni. Per poter contrassegnare le citazioni
correttamente, sono racchiusi da un comando "\mbox". Poiché le mbox non possono essere interrotte
tra le righe, questa procedura spesso si traduce in scatole troppo piene, possibilmente
oscurando il contenuto mentre si estende oltre il margine destro. Lo stesso accade
per alcuni altri pacchetti (es. siunitx). Se questo è un problema, ne hai due
possibilità.

1. Usa markup di tipo "CFONT" (opzione "-t CFONT"): Se viene scelto questo markup, allora
le citazioni modificate non sono più contrassegnate con la linea ondulata (addizioni) o
cancellati (cancellazioni), ma sono ancora evidenziati con il colore appropriato, e
il testo eliminato viene mostrato con un carattere diverso. Altri stili che non utilizzano "ulem"
anche il pacchetto funzionerà.

2. Scegli l'opzione "--disable-citation-markup" che disattiva il markup di
citazioni: le citazioni eliminate non vengono più mostrate e le citazioni aggiunte vengono mostrate
senza contrassegno. (Questo era il comportamento predefinito di latexdiff nelle versioni 0.6 e
più vecchio)

Per i pacchetti personalizzati puoi definire i comandi che devono essere protetti da
"\mbox" con le opzioni "--append-mboxsafecmd" e "--excludemboxsafecmd" (invia
i tuoi elenchi di comandi come richiesta di funzionalità nella pagina github per impostare l'impostazione predefinita
comportamento delle versioni future, vedere la sezione 6)

I cambiamenti nelle equazioni matematiche complicate provocano errori di elaborazione del lattice
Prova le opzioni "--math-markup=whole". Se anche questo fallisce, puoi disattivare mark
up per equazioni con "--math-markup=off".

Come posso mostrare solo le pagine in cui sono state apportate modifiche?
Usa le opzioni -"-s ZLABEL" (è richiesta una post-elaborazione) o "-s
ONLYCHANGEDPAGE". "latexdiff-vc --ps|--pdf" con l'opzione "--only-changes" prende
cura della post-elaborazione per te (richiede l'installazione del pacchetto zref).

Usa latexdiff online utilizzando i servizi onworks.net