latexdiff - Online în cloud

PROGRAM:

NUME

latexdiff - determinați și marcați diferențele dintre două fișiere latex

REZUMAT

latexdiff [ OPŢIUNI ] vechi.tex nou.tex > dif.tex

DESCRIERE

Scurt, latexdiff este un program utilitar pentru a ajuta la gestionarea revizuirilor de latex
documente. Acesta compară două fișiere latex valide, numite aici „old.tex” și „new.tex”, constată
diferențe semnificative între ele (de exemplu, ignorând numărul de spații albe și
poziția întreruperilor de linie) și adaugă comenzi speciale pentru a evidenția diferențele. Unde
evidențierea vizuală nu este posibilă, de exemplu, pentru modificări ale formatării, diferențelor
sunt totuși marcate în sursă.

Programul tratează preambulul diferit de documentul principal. Diferente intre
preambulurile sunt găsite folosind diferențierea bazată pe linii (în mod similar cu comanda Unix diff,
dar ignorând spațiile albe). Un comentariu, „"%DIF >"" este atașat la fiecare linie adăugată, adică a
linie prezentă în „new.tex” dar nu în „old.tex”. Liniile aruncate
sunt dezactivate adăugând „"%DIF <"". Blocurile modificate sunt precedate de linii de comentarii
oferind informații despre numerele de rând din fișierele originale. Unde sunt
diferențe nesemnificative, fișierul rezultat „diff.tex” va fi similar cu „new.tex”. La
sfârşitul preambulului, definiţiile pentru latexdiff sunt introduse comenzi de marcare. În
diferențierea corpului principal al textului, latexdiff încearcă să satisfacă următoarele
orientări (în ordinea priorităților):

1. Dacă atât „old.tex” cât și „new.tex” sunt LaTeX valide, atunci „diff.tex” rezultat ar trebui
să fie valabil și LateX. (NB Dacă sunt folosite câteva comenzi TeX simple în „old.tex” sau
„new.tex” apoi „diff.tex” nu este garantat să funcționeze, dar de obicei va funcționa).

2. Diferențele semnificative sunt determinate la nivelul cuvintelor individuale. Toate
diferențele semnificative, inclusiv diferențele dintre comentarii ar trebui să fie clar
marcat în codul sursă rezultat „diff.tex”.

3. Dacă un pasaj modificat conține text sau comenzi care produc text, atunci rulați „diff.tex”
prin LateX ar trebui să producă rezultate în care pasajele adăugate și eliminate sunt evidențiate.

4. Acolo unde există diferențe nesemnificative, de exemplu în poziționarea întreruperilor de linie,
„diff.tex” ar trebui să urmeze formatarea „new.tex”

Pentru diferențierea aceluiași algoritm ca dif este folosit dar cuvintele în loc de linii sunt
comparat. Se încearcă recunoașterea blocurilor care sunt complet modificate astfel încât
ele pot fi marcate ca o unitate. Comentariile sunt diferențiate rând cu rând, dar numărul de
spațiile din comentarii sunt ignorate. Comenzile care includ toate argumentele lor sunt în general
comparat ca o singură unitate, adică nu este introdus niciun marcaj în argumentele comenzilor.
Cu toate acestea, pentru un număr selectat de comenzi (de exemplu, „\caption” și toate secțiunile
comenzi) ultimul argument este cunoscut a fi text. Acest text este împărțit în cuvinte și
diferă la fel ca textul obișnuit (utilizați opțiuni pentru a afișa și modifica lista de text
comenzi, vezi mai jos). Deoarece algoritmul nu are cunoștințe detaliate despre LaTeX, presupune totul
perechi de acolade imediat după o comandă (adică o secvență de litere
începând cu o bară oblică inversă) sunt argumente pentru acea comandă. Ca o restricție la condiție
1 de mai sus este astfel necesar să înconjurăm toate argumentele cu acolade și să nu
introduceți spații străine. De exemplu, scrie

\section{\textem{Acesta este un titlu de secțiune accentuat}}

si nu

\section {\textem{Acesta este un titlu de secțiune accentuat}}

or

\section\textem{Acesta este un titlu de secțiune accentuat}

chiar dacă toate soiurile sunt la fel cu LaTeX (dar vezi --permite-spații varianta care
permite a doua varietate).

Pentru medii al căror conținut nu este conform standardului LaTeX sau unde este grafic
marcajul nu are sens, toate comenzile de marcare pot fi eliminate prin setarea PICTUREENV
variabilă de configurare, setată implicit la mediile „picture” și „DIFnomarkup”; vedea
--config opțiune). Cel din urmă mediu ("DIFnomarkup") poate fi utilizat pentru a proteja părți ale
fișierul latex în care marcajul are ca rezultat marcaj ilegal. Trebuie să încerci
pasaj jignitor atât în ​​fișierul vechi, cât și în cel nou de către „\begin{DIFnomarkup}” și
„\end{DIFnomarkup}”. Trebuie să definiți mediul în preambulele vechi și noi
documente. Prefer să-l definesc ca un mediu nul,

„\newenvironment{DIFnomarkup}{}{}”

dar alegerea este a ta. Orice marcaj din mediu va fi eliminat și, în general
totul din mediu va fi preluat din noul fișier.

De asemenea, este posibil să diferențiezi fișierele care nu au preambul.
În acest caz, fișierul este procesat în modul document principal, dar definițiile
comenzile de marcare nu sunt introduse.

Toate comenzile de marcare introduse de latexdiff începe cu „"\DIF"". S-au adăugat blocuri care conțin
cuvintele, comenzile sau comentariile care sunt în „new.tex” dar nu în „old.tex” sunt marcate cu
„\DIFaddbegin” și „\DIFaddend”. Blocurile aruncate sunt marcate cu „\DIFdelbegin” și
„\DIFdelend”. În blocurile adăugate, tot textul este evidențiat cu „\DIFadd” astfel:
„\DIFadd{Adăugat bloc de text}” Comenzile „sigure” selectate pot fi conținute în aceste blocuri de text
de asemenea (utilizați opțiunile pentru a afișa și modifica lista de comenzi sigure, vezi mai jos). Toti ceilalti
comenzile, precum și acoladele „{” și „}” nu sunt niciodată incluse în domeniul de aplicare al „\DIFadd”. Adăugat
comentariile sunt marcate prin adăugarea „"%DIF > "".

În cadrul blocurilor șterse, textul este evidențiat cu „\DIFdel”. Comentariile șterse sunt marcate cu
înainte de „"%DIF < "". Comandă nesigură și acolade în blocurile șterse sunt
a comentat cu „"%DIFDELCMD < "".

OPŢIUNI

preambul
Următoarele opțiuni determină stilul de marcare vizuală prin adăugarea comenzii corespunzătoare
definiții la preambul. Consultați sfârșitul acestei secțiuni pentru o descriere a celor disponibile
stiluri.

--type=markupstyle or -t stil de marcare
Adăugați cod în preambul pentru stilul de marcare selectat. Această opțiune definește „\DIFadd” și
Comenzile „\DIFdel”. Stiluri disponibile:

„SUBLINEIȚI CTRADIȚIONAL TRADIȚIONAL CFONT FONTSTRIKE CCHANGEBAR INVIZIBIL CCHANGEBAR
CULINECHBAR CFONTCBHBAR BOLD"

[ Implicit: „SUBLINET” ]

--subtype=markstyle or -s stilul de marcare
Adăugați cod în preambul pentru stilul selectat pentru comenzile de bracketing (de exemplu, pentru a marca modificările
în marjă). Această opțiune definește „\DIFaddbegin”, „\DIFaddend”, „\DIFdelbegin” și
Comenzile „\DIFdelend”. Stiluri disponibile: „SAFE MARGIN COLOR DVIPSCOL ZLABEL
ONLYCHANGEDPAGE (LABEL)*"

[ Implicit: „SAFE” ] * Subtipul „LABEL” este învechit

--floattype=markstyle or -f stilul de marcare
Adăugați cod în preambul pentru stilul selectat, care înlocuiește marcarea și marcarea standard
comenzile din floats (de exemplu, remarcile marginale cauzează o eroare în floats, deci
marcarea marginală poate fi astfel dezactivată). Această opțiune definește toate comenzile „\DIF...FL”.
Stiluri disponibile: „FLOATSAFE TRADITIONALSAFE IDENTICAL”

[ Implicit: „FLOATSAFE” ]

--encoding=enc or -e pe
Specificați codificarea old.tex și new.tex. Codificările tipice sunt „ascii”, „utf8”,
„latin1”, „latin9”. O listă de codificări disponibile poate fi obținută prin executare

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

[Codificarea implicită este utf8, cu excepția cazului în care primele rânduri ale preambulului conțin un
invocarea „\usepackage[..]{inputenc}”, caz în care codificarea aleasă de acest
se presupune comanda. Rețineți că ASCII (latex standard) este un subset al utf8]

--preamble=fișier or -p fişier
Inserați fișierul la sfârșitul preambulului în loc să generați preambul. Preambulul trebuie
definiți următoarele comenzi „\DIFaddbegin, \DIFaddend, \DIFadd{..},
\DIFdelbegin,\DIFdelend,\DIFdel{..}," și varietăți pentru utilizare în floats
„\DIFaddbeginFL, \DIFaddendFL, \DIFaddFL{..}, \DIFdelbeginFL, \DIFdelendFL,
\DIFdelFL{..}" (Dacă această opțiune este setată -t, -s, și -f opțiunile sunt ignorate.)

--packages=pkg1,pkg2,..
Spuneți lui latexdiff că fișierul .tex este procesat cu pachetele din listă încărcate. Aceasta este
în mod normal, nu este necesar dacă fișierul .tex include preambulul, așa cum este preambulul
scanat automat pentru comenzi „\usepackage”. Utilizarea --pachete opțiune
dezactivează scanarea automată, deci dacă din orice motiv trebuie să fie analizată specifică pachetului
oprit, folosire --packages=niciunul. Următoarele pachete declanșează un comportament special:

"amsmath"
Variabila de configurare MATHARREREPL este setată la „align*” (implicit: „eqnarray*”).
(Rețineți că multe dintre mediile de matrice amsmath sunt deja recunoscute de
implicit ca atare)

"endfloat"
Asigurați-vă că „\begin{figure}” și „\end{figure}” apar întotdeauna singure pe
o linie.

"hiperref"
Schimbați numele comenzilor „\DIFadd” și „\DIFdel” în „\DIFaddtex” și
„\DIFdeltex” și definiți noi comenzi „\DIFadd” și „\DIFdel”, care oferă o
wrapper pentru aceste comenzi, folosindu-le pentru text, dar nu pentru link
definirea comenzii (unde orice marcaj ar cauza erori).

"apacit"
Redefiniți comenzile recunoscute ca comenzi de citare.

"siunitx"
Tratați „\SI” ca echivalent cu comenzile de citare (adică protejați cu „\mbox” dacă
stilul de marcare folosește pachetul ulem.

"inteligent"
Tratați „\cref,\Cref”, etc ca echivalent cu comenzile de citare (adică protejați cu
„\mbox” dacă stilul de marcare folosește pachetul ulem.

"glosare"
Definiți majoritatea comenzilor glosarelor ca fiind sigure, protejându-le cu \mbox's
acolo unde este nevoie

"mhchem"
Tratați „\ce” ca pe o comandă sigură, adică va fi evidențiată (rețineți că „\cee”
nu vor fi evidențiate în ecuații, deoarece acest lucru duce la erori de procesare)

„chemformula” sau „chemacros”
Tratați „\ch” ca o comandă sigură în afara ecuațiilor, adică va fi evidențiată
(rețineți că „\ch” nu va fi evidențiat în ecuații, deoarece aceasta duce la
erori de procesare)

[ Implicit: scanați preambulul pentru comenzi „\usepackage” pentru a determina
pachete încărcate. ]

--arata-preambul
Imprimați comenzile de preambul generate sau incluse în stdout.

Configuraţie
--exclude-safecmd=exclude-fișier or -A fişier-exclude or --exclude-safecmd="cmd1,cmd2,..."
--replace-safecmd=înlocuiește fișierul
--append-safecmd=adăugați fișierul or -a anexa-fisier or --append-safecmd="cmd1,cmd2,..."
Excludeți, înlocuiți sau adăugați la lista de potriviri expresii regulate (RegEx).
comenzi care sunt sigure de utilizat în cadrul unei comenzi „\DIFadd” sau „\DIFdel”.
Fișierul trebuie să conțină un Perl-RegEx pe linie (liniile de comentarii care încep cu # sau % sunt
ignorat). Rețineți că RegEx trebuie să se potrivească cu întregul simbol, adică /^regex$/
este subînțeles și că inițialul „\” al comenzii nu este inclus. The
--exclude-safecmd și --append-safecmd opțiunile pot fi combinate cu
---replace-safecmd opțiune și poate fi folosit în mod repetat pentru a adăuga cumulativ listelor.
--exclude-safecmd și --append-safecmd poate lua, de asemenea, o listă separată prin virgulă ca intrare.
Dacă este necesară o virgulă pentru una dintre expresiile regex, evadați astfel „\,”. În cele mai multe cazuri, acesta
va fi necesar pentru a proteja lista separată prin virgulă din shell prin introducerea acesteia
ghilimele.

--exclude-textcmd=exclude-fișier or -X fişier-exclude or --exclude-textcmd="cmd1,cmd2,..."
--replace-textcmd=înlocuiește fișierul
--append-textcmd=adăugați fișierul or -x anexa-fisier or --append-textcmd="cmd1,cmd2,..."
Excludeți, înlocuiți sau adăugați la lista de expresii regulate care se potrivesc comenzi
al cărui ultim argument este textul. Vezi intrarea pentru --exclude-safecmd direct deasupra pentru
mai multe detalii.

--replace-context1cmd=înlocuiește fișierul
--append-context1cmd=adăugați fișierul sau =item --append-context1cmd="cmd1,cmd2,..."
Înlocuiți sau adăugați la lista comenzilor de potrivire regex al căror ultim argument este text
dar care necesită un anumit context pentru a funcționa, de exemplu \caption va funcționa numai în cadrul unui
figură sau tabel. Aceste comenzi se comportă ca comenzi text, cu excepția cazului în care apar în
o secțiune ștearsă, când sunt dezactivate, dar argumentul lor este afișat ca șters
text.

--replace-context2cmd=înlocuiește fișierul
--append-context2cmd=adăugați fișierul sau =item --append-context2cmd="cmd1,cmd2,..."
Ca comenzi corespunzătoare pentru context1. Singura diferență este că comenzile context2
sunt complet dezactivate în secțiunile șterse, inclusiv argumentele lor.

--exclude-mboxsafecmd=exclude-fișier or --exclude-mboxsafecmd="cmd1,cmd2,..."
--append-mboxsafecmd=adăugați fișierul or --append-mboxsafecmd="cmd1,cmd2,..."
Definiți comenzi sigure, care, în plus, trebuie protejate prin încapsularea într-un
\\mbox{...}. Acest lucru este uneori necesar pentru a evita incompatibilitățile dintre externe
pachete și pachetul ulem, care este folosit pentru evidențierea în stilul implicit
SUBLINEI cat si CULINECHBAR CFONTSTRIKE

--config var1=val1,var2=val2,... or -c var1=val1,..
-c configfile
Setați variabilele de configurare. Opțiunea poate fi repetată pentru a seta diferite variabile
(ca o alternativă la lista separată prin virgulă). Variabile disponibile (vezi mai jos pentru
explicatii suplimentare):

„ARRENV” (RegEx)

„COUNTERCMD” (RegEx)

„FLOATENV” (RegEx)

„ITEMCMD” (RegEx)

„LISTENV” (RegEx)

„MATHARRENV” (RegEx)

„MATHARREPL” (șir)

„MATHENV” (RegEx)

„MATHREPL” (șir)

„MINWORDSBLOCK” (întreg)

„PICTUREENV” (RegEx)

--show-safecmd
Imprimați lista cu RegEx care se potrivesc și exclud comenzile sigure.

--show-textcmd
Imprimați lista de comenzi de potrivire și excludere RegEx cu argument text.

--show-config
Afișați valorile variabilelor de configurare.

--arata tot
Combină toate comenzile --show.

NB Pentru toate comenzile --show, nu trebuie specificat niciun fișier „old.tex” sau „new.tex” și
nu are loc nicio diferență.

Altele configuraţie opţiuni:
--permite-spații
Permiteți spații între argumentele între paranteze sau între paranteze la comenzi. Rețineți că această opțiune
ar putea avea reacții adverse nedorite (domeniul de aplicare care nu are legătură s-ar putea concentra cu precedentul
comenzi) deci ar trebui să fie folosit numai dacă implicit produce rezultate eronate. (Mod implicit
necesită argumente pentru a se urma direct fără spații intermediare).

--math-markup=nivel
Determinați granularitatea marcajului în mediile matematice afișate: Valori posibile pentru
nivel sunt (atât etichetele numerice, cât și cele de text sunt acceptabile):

„off” sau 0: suprimați marcajul pentru mediile matematice. Ecuațiile șterse nu vor apărea
în fișierul diff. Acest mod poate fi folosit dacă toate celelalte moduri cauzează cod latex nevalid.

„întreg” sau 1: diferențierea la nivelul ecuațiilor întregi. Chiar și schimbări banale la
ecuațiile fac ca întreaga ecuație să fie marcată ca fiind schimbată. Acest mod poate fi utilizat dacă
procesarea în modul grosier sau fin are ca rezultat un cod latex nevalid.

„grosier” sau 2: Detectează modificări în cadrul ecuațiilor marcate cu o granularitate grosieră;
modificările tipului de ecuație (de exemplu, displaymath la ecuație) apar ca o modificare a
ecuație completă. Acest mod este recomandat pentru situațiile în care conținutul și ordinea
a unor ecuații sunt încă în curs de modificare. [Mod implicit]

„fin” sau 3: Detectează mici modificări în ecuații și marcați la granularitate fină. Acest
modul este cel mai potrivit, dacă sunt de așteptat doar modificări minore ale ecuațiilor, de ex
corectarea greselilor de scriere.

--disable-citation-markup or --disable-auto-mbox
Suprimați marcarea citatelor și marcarea altor comenzi vulnerabile în stiluri care utilizează ulem
(SUBLINE, FONTSTRIKE, CULINECHBAR) (cele două opțiuni sunt identice și sunt simple
aliasuri)

--enable-citation-markup or --enforce-auto-mbox
Protejați comenzile de citare și alte comenzi vulnerabile în secțiunile modificate cu
Comanda „\mbox”, adică folosiți comportamentul implicit pentru pachetul ulem pentru alte pachete (
două opțiuni sunt identice și sunt pur și simplu pseudonime)

Diverse
--verbos or -V
Trimiteți diverse informații de stare către stderr în timpul procesării. Implicit este să funcționeze
în tăcere.

--driver=tip
Alegeți driverul pentru pachetul changebar (relevant doar pentru stilurile care utilizează
bară de schimb: CCHANGEBAR CFONTCHBAR CULINECHBAR CHANGE BAR). Posibilii șoferi sunt
listate în manualul changebar, de exemplu pdftex,dvips,dvitops
[Implicit: dvips]

--ignora-avertismente
Suprimați avertismentele despre inconsecvențele în lungime între șirurile de caractere introduse și analizate și
personaje lipsă. Aceste mesaje de avertizare sunt adesea legate de latexul non-standard sau
construcții din latex cu o sintaxă necunoscută pentru „latexdiff”, dar diferența rezultată
Argumentul este adesea complet funcțional oricum, mai ales dacă este doar latexul non-standard
apare în părți ale textului care nu s-au modificat.

--label=etichetă or -L etichetă
Setează etichetele folosite pentru a descrie fișierele vechi și noi. Prima utilizare a acestei opțiuni
setează eticheta care descrie fișierul vechi și a doua utilizare a opțiunii setează eticheta
pentru noul fișier, adică setați ambele etichete astfel „-L labelold -L labelnew”. [Mod implicit:
utilizați numele fișierului și datele modificării pentru etichetă]

--fara eticheta
Suprimați includerea numelor de fișiere vechi și noi ca comentarii în fișierul de ieșire

--visible-label
Includeți nume de fișiere vechi și noi (sau etichete setate cu opțiunea „--label”) ca rezultat vizibil.

--aplatiza
Înlocuiți comenzile „\input” și „\include” din body cu conținutul fișierelor din
argumentul lor. Dacă „\includeonly” este prezent în preambul, doar acele fișiere sunt
extins în document. Cu toate acestea, nu se face recursivitate, adică „\input” și
Comenzile „\include” din secțiunile incluse nu sunt extinse. Fișierele incluse sunt
presupus a
să fie localizate în aceleași directoare ca și fișierele master vechi și, respectiv, noi,
făcând posibilă organizarea fișierelor în directoare vechi și noi. --aplatiza este
aplicat recursiv, astfel încât fișierele introduse pot conține instrucțiuni suplimentare „\input”.

Utilizarea acestei opțiuni poate duce la timpi de procesare prohibitivi pentru documente mai mari,
iar documentul de diferență rezultat nu mai reflectă structura intrării
documente.

--Ajutor or -h
Afișează textul de ajutor

--versiune
Afișați numărul versiunii

Predefinit stiluri
Major Tipuri
Tipul major determină marcarea textului simplu și a unor comenzi din latex selectate în exterior
plutește prin definirea comenzilor de marcare „\DIFadd{...}” și „\DIFdel{...}” .

„SUBLINEIȚI”
Textul adăugat este ondulat subliniat și albastru, textul eliminat este tăiat și roșu
(Necesită pachete color și ulem). Depășirea nu funcționează în afișat
ecuații matematice astfel încât părțile șterse ale ecuației să fie subliniate, nu bătute
afară (acesta este un neajuns inerent pachetului ulem).

„CTRADIȚIONAL”
Textul adăugat este albastru și setat în sans-serif, iar pentru fiecare este creată o notă de subsol roșie
fragment de text aruncat. (Necesită pachet color)

"TRADIŢIONAL"
Ca „CTRADIȚIONAL”, dar fără folosirea culorii.

„CFONT” Textul adăugat este albastru și setat în sans-serif, iar textul aruncat este roșu și foarte
mărime mică.

„FONTSTRIKE”
Textul adăugat este setat în sans-serif, textul eliminat este mic și eliminat

„CCHANGEBAR”
Textul adăugat este albastru, iar textul eliminat este roșu. În plus, textul modificat
este marcat cu o bară în margine (Necesită pachete de culoare și bară de schimbare).

„CFONTCH BAR”
Ca „CFONT”, dar cu bare de schimbare suplimentare (Necesită culoare și bară de schimbare
pachete).

"CULINECHBAR"
Ca „SUBLINEI”, dar cu bare de schimbare suplimentare (Necesită culoare, ulem și
pachete changebar).

„SCHIMBARE”
Fără marcare a textului, dar marcați marginile cu bare de modificare (Necesită bara de modificare
pachet).

"INVIZIBIL"
Niciun marcaj vizibil (dar comenzile generice de marcare vor fi în continuare inserate.

„BOLD” Textul adăugat este setat cu caractere aldine, iar eliminat nu este afișat.

Subtipuri
Subtipul definește comenzile care sunt inserate la începutul și sfârșitul add or
blocuri aruncate, indiferent dacă aceste blocuri conțin text sau comenzi (Definit
comenzi: „\DIFaddbegin, \DIFaddend, \DIFdelbegin, \DIFdelend”)

„SIGUR” Fără markup suplimentar (alegere recomandată)

„MARGIN” Marcați începutul și sfârșitul blocurilor modificate cu simboluri în margine din apropiere
(folosind comanda standard "\marginpar" - rețineți că aceasta se mișcă uneori
oarecum din poziția prevăzută.

„CULOARE” O modalitate alternativă de a marca pasajele adăugate în albastru și cele șterse în roșu.
(Este recomandat să folosiți în schimb principalele tipuri pentru a efectua marcajele colorate,
deși în unele cazuri colorarea cu dvipscol poate fi mai completă, de exemplu
cu comenzi de citare).

„DVIPSCOL”
O modalitate alternativă de a marca pasajele adăugate în albastru și cele șterse în roșu.
Rețineți că „DVIPSCOL” funcționează numai cu convertorul dvips, de exemplu, nu pdflatex.
(se recomandă utilizarea în schimb a principalelor tipuri pentru a efectua marcajele colorate,
deși în unele cazuri colorarea cu dvipscol poate fi mai completă).

„ZLABEL” poate fi folosit pentru a evidenția numai paginile modificate, dar necesită o postprocesare. Este
recomandăm să nu apelați manual această opțiune, ci să utilizați „latexdiff-vc” cu
Opțiunea „--only-changes”. Ca alternativă, utilizați scriptul dat în preambulul
fișierele diff realizate folosind acest stil.

„NUMAISCHANGEDPAGE”
evidențiază, de asemenea, paginile modificate, fără a fi nevoie de post-procesare, dar s-ar putea
nu funcționează în mod fiabil dacă există material plutitor (figuri, tabele).

„LABEL” este similar cu „ZLABEL”, dar nu are nevoie de pachetul zref și funcționează mai puțin
fiabil (depreciat).

pluti Tipuri de
Unele dintre markupurile utilizate în textul principal pot cauza probleme atunci când sunt folosite în floats
(de ex. cifre sau tabele). Din acest motiv, versiunile alternative ale tuturor comenzilor de marcare sunt
folosit în flotoare. Tipul float definește aceste comenzi alternative.

„FLOATSAFE”
Utilizați un marcaj identic pentru text ca în corpul principal, dar setați marcarea tuturor comenzilor
începutul și sfârșitul blocurilor schimbate în comenzi nule. Trebuie să alegi asta
tip float dacă subtipul dvs. este „MARGIN”, deoarece „\marginpar” nu funcționează corect
în flotoare.

„TRADITIONALSAFE”
Marcați completările la fel ca în textul principal. Mediile șterse sunt
marcat de paranteze unghiulare \[ și \] iar textul șters este setat în script
mărimea. Acest tip de plutitor ar trebui să fie întotdeauna folosit cu „TRADIȚIONAL” și
Tipuri de marcaj „CTRADIȚIONAL”, deoarece comanda \footnote nu funcționează corect
medii plutitoare.

"IDENTIC"
Nu faceți nicio diferență între textul principal și flotanți.

Configuraţie Variabile
„ARRENV” Dacă se găsește o potrivire cu „ARRENV” într-un mediu matematic inline în a
bloc șters sau adăugat, apoi matematica aliniată este înconjurată de „\mbox{”...}”.
Acest lucru este necesar deoarece sublinierea nu funcționează în cadrul matricei inline
medii.

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

"COUNTERCMD"
Dacă o comandă dintr-un bloc șters care se află și în lista textcmd se potrivește
„COUNTERCMD”, apoi o comandă suplimentară „\addtocounter{”cntcmd„}{-1}”, unde
cntcmd este comanda potrivită, este atașată în fișierul diff astfel încât
numerotarea din fișierul dif rămâne sincronizată cu numerotarea din noul
fișier.

[ Implicit: "COUNTERCMD"="(?:footnote|part|section|subsection" ...

„|subsubsecțiune|paragraf|subparagraf)” ]

"FLOATENV"
Mediile al căror nume se potrivește cu expresia regulată din „FLOATENV” sunt
considerate plutitoare. În aceste medii, latexdiff comenzile de marcare sunt
înlocuite cu variantele lor FL.

[ Implicit: „(?:figura|tabel|placă)[\w\d*@]*” ]

„ITEMCMD” Comenzi reprezentând o linie nouă de articole cu medii de listă.

[ Implicit: \"articol"]

„LISTENV” Mediile al căror nume se potrivește cu expresia regulată din „LISTENV” sunt liste
medii.

[ Implicit: „(?:itemize|enumerate|description)” ]

"MATHENV","MATHREPL"
Dacă atât \begin cât și \end pentru un mediu matematic (potrivirea numelui mediului
„MATHENV” sau \[ și \]) se află în același bloc șters, sunt înlocuite cu
o comandă \begin și \end pentru „MATHREPL” în loc să fie comentată.

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

„MATHARRENV”, „MATHARRENV”
ca "MATHENV","MATHREPL", dar pentru matrice de ecuații

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

„MINWORDSBLOCK”
Numărul minim de jetoane necesare pentru a forma un bloc independent. Această valoare este
folosit în algoritm pentru a detecta modificări ale blocurilor complete prin îmbinarea identice
text părți mai mici de „MINWORDSBLOCK” la cele precedente adăugate și eliminate
părţi.

[ Implicit: 3 ]

"PICTUREENV"
În medii al căror nume se potrivește cu expresia regulată din „PICTUREENV”
toate marcajele latexdiff sunt eliminate (în cazuri patologice, acest lucru ar putea duce la
marcaj inconsecvent, dar această situație ar trebui să fie rară).

[ Implicit: „(?:picture|DIFnomarkup)[\w\d*@]*” ]

COMUNĂ PROBLEME AND FAQ

Citările au ca rezultat casete prea pline
Există o incompatibilitate între pachetul „ulem”, pe care îl folosește „latexdiff”.
pentru sublinierea și bătarea în stilul SUBLINEI, stilul implicit și
modul în care sunt generate citările. Pentru a putea marca citările
corect, acestea sunt incluse cu o comandă „\mbox”. Deoarece boxele nu pot fi sparte
peste linii, această procedură are ca rezultat, probabil, casete prea pline
ascunzând conținutul pe măsură ce acesta se extinde dincolo de marginea dreaptă. La fel se întâmplă
pentru alte pachete (de exemplu, siunitx). Dacă aceasta este o problemă, aveți două
posibilități.

1. Folosiți marcajul de tip „CFONT” (opțiunea „-t CFONT”): Dacă este ales acest marcaj, atunci
citările modificate nu mai sunt marcate cu linia ondulată (adăugiri) sau
eliminate (ștergeri), dar sunt încă evidențiate în culoarea corespunzătoare și
textul șters este afișat cu un font diferit. Alte stiluri care nu folosesc „ulem”
va funcționa și pachetul.

2. Alegeți opțiunea „--disable-citation-markup” care dezactivează marcarea
citate: citatele șterse nu mai sunt afișate, iar citațiile adăugate sunt afișate
fără marcaj. (Acesta a fost comportamentul implicit al latexdiff la versiunile 0.6 și
mai in varsta)

Pentru pachetele personalizate puteți defini comenzile de care trebuie protejate
„\mbox” cu opțiunile „--append-mboxsafecmd” și „--excludemboxsafecmd” (trimiteți
listele dvs. de comandă ca cerere de caracteristică pe pagina github pentru a seta valoarea implicită
comportamentul versiunilor viitoare, vezi secțiunea 6)

Modificările în ecuațiile matematice complicate duc la erori de procesare a latexului
Încercați opțiunile „--math-markup=whole”. Dacă chiar și asta nu reușește, puteți dezactiva marcajul
pentru ecuațiile cu „--math-markup=off”.

Cum pot să arăt doar paginile în care au fost făcute modificări
Utilizați opțiunile -"-s ZLABEL" (sunt necesare unele postprocesare) sau "-s
ONLYCHANGEDPAGE". „latexdiff-vc --ps|--pdf" cu opțiunea „--only-changes” ia
aveți grijă de post-procesare pentru dvs. (necesită instalarea pachetului zref).

Utilizați latexdiff online folosind serviciile onworks.net