latexdiff - Online in de cloud

PROGRAMMA:

NAAM

latexdiff - bepaal en markeer verschillen tussen twee latexbestanden

KORTE INHOUD

latexverschil [ OPTIES ] oude.tex nieuw.tex > diff.tex

PRODUCTBESCHRIJVING

Kort, latexverschil is een hulpprogramma om te helpen bij het beheer van revisies van latex
documenten. Het vergelijkt twee geldige latexbestanden, hier "old.tex" en "new.tex" genoemd, en vindt
significante verschillen tussen hen (dwz negeren van het aantal spaties en
positie van regeleinden), en voegt speciale opdrachten toe om de verschillen te benadrukken. Waar
visuele markering is niet mogelijk, bijv. voor wijzigingen in de opmaak, de verschillen
zijn niettemin gemarkeerd in de bron.

Het programma behandelt de preambule anders dan het hoofddocument. Verschillen tussen
de preambules worden gevonden met behulp van op regels gebaseerde differentiëring (vergelijkbaar met het Unix diff-commando,
maar het negeren van witruimtes). Een opmerking, ""%DIF >"" wordt toegevoegd aan elke toegevoegde regel, bijv. een
regel aanwezig in "new.tex" maar niet in "old.tex". Weggegooide lijnen
worden gedeactiveerd door ""%DIF <"" voor te zetten. Gewijzigde blokken worden voorafgegaan door commentaarregels
informatie geven over regelnummers in de originele bestanden. Waar er zijn
onbeduidende verschillen, zal het resulterende bestand "diff.tex" vergelijkbaar zijn met "new.tex". Bij
het einde van de preambule, de definities voor latexverschil opmaakopdrachten worden ingevoegd. In
het verschil in de hoofdtekst van de tekst, latexverschil probeert te voldoen aan het volgende:
richtlijnen (in volgorde van prioriteit):

1. Als zowel "old.tex" als "new.tex" geldige LaTeX zijn, moet de resulterende "diff.tex"
ook geldige LateX zijn. (NB Als een paar gewone TeX-commando's worden gebruikt binnen "old.tex" of
"new.tex" dan "diff.tex" werkt niet gegarandeerd, maar werkt meestal wel).

2. Significante verschillen worden bepaald op het niveau van individuele woorden. Alle
significante verschillen, inclusief verschillen tussen opmerkingen, moeten duidelijk worden
gemarkeerd in de resulterende broncode "diff.tex".

3. Als een gewijzigde passage tekst of tekstproducerende commando's bevat, voer dan "diff.tex" uit
via LateX moet uitvoer produceren waar toegevoegde en verwijderde passages zijn gemarkeerd.

4. Waar er onbeduidende verschillen zijn, bijv. in de plaatsing van regeleinden,
"diff.tex" moet de opmaak van "new.tex" volgen

Voor het differentiëren van hetzelfde algoritme als diff wordt gebruikt, maar woorden in plaats van lijnen zijn
vergeleken. Er wordt geprobeerd om blokken te herkennen die volledig zijn veranderd, zodat:
ze kunnen worden gemarkeerd als een eenheid. Opmerkingen verschillen regel voor regel, maar het aantal
spaties in opmerkingen worden genegeerd. Commando's inclusief al hun argumenten zijn over het algemeen:
vergeleken als één eenheid, dwz er wordt geen mark-up ingevoegd in de argumenten van commando's.
Echter, voor een geselecteerd aantal commando's (bijvoorbeeld "\caption" en alle secties
commando's) waarvan bekend is dat het laatste argument tekst is. Deze tekst is opgesplitst in woorden en
gedifferentieerd net als gewone tekst (gebruik opties om de lijst met tekst weer te geven en te wijzigen
commando's, zie hieronder). Aangezien het algoritme geen gedetailleerde kennis van LaTeX heeft, gaat het ervan uit dat alles
paar accolades direct na een commando (dwz een reeks letters)
beginnend met een backslash) zijn argumenten voor die opdracht. Als een beperking tot conditie
1 hierboven is het dus noodzakelijk om alle argumenten met accolades te omringen, en niet
vreemde spaties invoegen. Schrijf bijvoorbeeld

\section{\textem{Dit is een benadrukte sectietitel}}

en niet

\sectie {\textem{Dit is een benadrukte sectietitel}}

or

\section\textem{Dit is een benadrukte sectietitel}

ook al zijn alle varianten hetzelfde voor LaTeX (maar zie --sta-spaties toe optie die
staat de tweede variëteit toe).

Voor omgevingen waarvan de inhoud niet voldoet aan de standaard LaTeX of waar grafische
opmaak slaat nergens op alle opmaakcommando's kunnen worden verwijderd door de PICTUREENV
configuratievariabele, standaard ingesteld op "picture" en "DIFnomarkup"-omgevingen; zien
--config optie). De laatste omgeving ("DIFnomarkup") kan worden gebruikt om delen van
het latexbestand waar de opmaak resulteert in illegale opmaak. Je moet de omringen
beledigende passage in zowel het oude als het nieuwe bestand door "\begin{DIFnomarkup}" en
"\end{DIFnomarkup}". Je moet de omgeving definiëren in de preambules van zowel oud als nieuw
documenten. Ik definieer het liever als een nul-omgeving,

"\nieuweomgeving{DIFnomarkup}{}{}"

maar de keuze is aan jou. Alle markeringen in de omgeving worden verwijderd, en in het algemeen:
alles in de omgeving wordt gewoon uit het nieuwe bestand gehaald.

Het is ook mogelijk om bestanden te onderscheiden die geen preambule hebben.
In dit geval wordt het bestand verwerkt in de hoofddocumentmodus, maar de definities van de
opmaakopdrachten worden niet ingevoegd.

Alle opmaakcommando's ingevoegd door latexverschil beginnen met ""\DIF"". Blokken toegevoegd met
woorden, commando's of opmerkingen die in "new.tex" maar niet in "old.tex" staan, zijn gemarkeerd met
"\DIFaddbegin" en "\DIFaddend". Weggegooide blokken worden gemarkeerd met "\DIFdelbegin" en
"\DIFdelend". Binnen toegevoegde blokken wordt alle tekst gemarkeerd met "\DIFadd" als volgt:
"\DIFadd{Toegevoegd tekstblok}" Geselecteerde `veilige' commando's kunnen in deze tekstblokken staan
ook (gebruik opties om de lijst met veilige commando's te tonen en te wijzigen, zie hieronder). Alle andere
commando's en accolades "{" en "}" worden nooit binnen het bereik van "\DIFadd" geplaatst. Toegevoegd
opmerkingen worden gemarkeerd door ""%DIF > "".

Binnen verwijderde blokken wordt tekst gemarkeerd met "\DIFdel". Verwijderde opmerkingen zijn gemarkeerd met
voor ""%DIF < "". Niet-veilige commando's en accolades binnen verwijderde blokken zijn
becommentarieerd met ""%DIFDELCMD < "".

OPTIES

Preambule
De volgende opties bepalen de visuele opmaakstijl door de juiste opdracht toe te voegen:
definities in de preambule. Zie het einde van dit gedeelte voor een beschrijving van beschikbare
stijlen.

--type=opmaakstijl or -t opmaakstijl
Voeg code toe aan de preambule voor de geselecteerde opmaakstijl. Deze optie definieert "\DIFadd" en
"\DIFdel"-opdrachten. Beschikbare stijlen:

"ONDERSTREEP CTRADITIONELE TRADITIONELE CFONT FONTSTRIKE ONZICHTBARE CHANGEBAR CCHANGEBAR
CULINECHBAR CONTCBHBAR BOLD"

[ Standaard: "ONDERLIJNEN" ]

--subtype=markstijl or -s merkstijl
Voeg code toe aan de preambule voor geselecteerde stijl voor opdrachten voor bracketing (bijv. om wijzigingen te markeren
in de marge). Deze optie definieert "\DIFaddbegin", "\DIFaddend", "\DIFdelbegin" en
"\DIFdelend" commando's. Beschikbare stijlen: "VEILIGE MARGE KLEUR DVIPSCOL ZLABEL
ALLEEN GEWIJZIGDE PAGINA (LABEL)*"

[ Standaard: "SAFE" ] * Subtype "LABEL" is verouderd

--floattype=markstijl or -f merkstijl
Voeg code toe aan preambule voor geselecteerde stijl die standaardmarkering en opmaak vervangt
commando's binnen floats (bijv. kanttekeningen veroorzaken een fout binnen floats dus
marginale markering kan dus worden uitgeschakeld). Deze optie definieert alle "\DIF...FL" commando's.
Beschikbare stijlen: "FLOATSAFE TRADITIONALSVEILIG IDENTIEK"

[ Standaard: "FLOATSAFE" ]

--codering=enc or -e enc
Specificeer de codering van old.tex en new.tex. Typische coderingen zijn "ascii", "utf8",
"latin1", "latin9". Een lijst met beschikbare coderingen kan worden verkregen door het uitvoeren van

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

[Standaardcodering is utf8 tenzij de eerste paar regels van de preambule een . bevatten
aanroep "\usepackage[..]{inputenc}" in welk geval de codering gekozen door deze
opdracht wordt aangenomen. Merk op dat ASCII (standaard latex) een subset is van utf8]

--preamble=bestand or -p filet
Voeg bestand toe aan het einde van de preambule in plaats van de preambule te genereren. De preambule moet
definieer de volgende commando's "\DIFaddbegin, \DIFaddend, \DIFadd{..},
\DIFdelbegin,\DIFdelend,\DIFdel{..}," en varianten voor gebruik binnen floats
"\DIFaddbeginFL, \DIFaddendFL, \DIFaddFL{..}, \DIFdelbeginFL, \DIFdelendFL,
\DIFdelFL{..}" (Als deze optie is ingesteld -t, -s en -f opties worden genegeerd.)

--pakketten=pkg1,pkg2,..
Vertel latexdiff dat het .tex-bestand wordt verwerkt met de pakketten in de lijst geladen. Dit is
normaal gesproken niet nodig als het .tex-bestand de preambule bevat, aangezien de preambule is
automatisch gescand op "\usepackage"-opdrachten. Gebruik van de --pakketjes optie
schakelt automatisch scannen uit, dus als om welke reden dan ook pakketspecifieke parsing moet worden
uitgeschakeld, gebruik --pakketten=geen. De volgende pakketten triggeren speciaal gedrag:

"amsmath"
Configuratievariabele MATHARRREPL is ingesteld op "align*" (Standaard: "eqnarray*").
(Merk op dat veel van de amsmath array-omgevingen al worden herkend door:
standaard als zodanig)

"eindzweven"
Zorg ervoor dat "\begin{figuur}" en "\end{figuur}" altijd afzonderlijk verschijnen op
een lijn.

"hyperreferentie"
Verander de naam van "\DIFadd" en "\DIFdel" commando's in "\DIFaddtex" en
"\DIFdeltex" en definieer nieuwe "\DIFadd" en "\DIFdel" commando's, die een
wrapper voor deze commando's, gebruik ze voor de tekst, maar niet voor de link
definiërende opdracht (waar elke opmaak fouten zou veroorzaken).

"apaciet"
Definieer de commando's die worden herkend als citatiecommando's opnieuw.

"siunitx"
Behandel "\SI" als equivalent aan citatiecommando's (dwz beveilig met "\mbox" als
opmaakstijl gebruikt ulem-pakket.

"slim"
Behandel "\cref,\Cref", enz. als gelijkwaardig aan citatiecommando's (dwz beschermen met
"\mbox" als de opmaakstijl ulem-pakket gebruikt.

"woordenlijsten"
Definieer de meeste woordenlijsten als veilig en bescherm ze met \mbox'es
waar nodig

"mhchem"
Behandel "\ce" als een veilige opdracht, dwz het zal worden gemarkeerd (merk op dat "\cee"
wordt niet gemarkeerd in vergelijkingen omdat dit tot verwerkingsfouten leidt)

"chemformula" of "chemmacros"
Behandel "\ch" als een veilige opdracht buiten vergelijkingen, dwz het wordt gemarkeerd
(merk op dat "\ch" niet wordt gemarkeerd in vergelijkingen, omdat dit leidt tot
verwerkingsfouten)

[ Standaard: scan de preambule voor "\usepackage"-opdrachten om te bepalen
geladen pakketten. ]

--show-preambule
Print gegenereerde of opgenomen preambule-opdrachten naar stdout.

Configuratie
--exclude-safecmd=exclude-bestand or -A bestand uitsluiten or --exclude-safecmd="cmd1,cmd2,..."
--replace-safecmd=vervang-bestand
--append-safecmd=append-bestand or -a append-bestand or --append-safecmd="cmd1,cmd2,..."
Uitsluiten van, vervangen of toevoegen aan de lijst met overeenkomende reguliere expressies (RegEx)
commando's die veilig kunnen worden gebruikt in het kader van een "\DIFadd" of "\DIFdel" commando.
Het bestand moet één Perl-RegEx per regel bevatten (Commentaarregels die beginnen met # of % are
buiten beschouwing gelaten). Merk op dat de RegEx moet overeenkomen met het hele token, dat wil zeggen, /^regex$/
is geïmpliceerd en dat de initiële "\" van de opdracht niet is opgenomen. De
--exclusief-safecmd en --toevoegen-safecmd opties kunnen worden gecombineerd met de
---replace-safecmd optie en kan herhaaldelijk worden gebruikt om cumulatief aan de lijsten toe te voegen.
--exclusief-safecmd en --toevoegen-safecmd kan ook een door komma's gescheiden lijst als invoer nemen.
Als een komma voor een van de regex vereist is, laat deze dan ontsnappen met "\,". In de meeste gevallen is het
zal nodig zijn om de door komma's gescheiden lijst van de shell te beschermen door deze in te voegen
aanhalingstekens.

--exclude-textcmd=exclude-bestand or -X bestand uitsluiten or --exclude-textcmd="cmd1,cmd2,..."
--replace-textcmd=vervang-bestand
--append-textcmd=append-bestand or -x append-bestand or --append-textcmd="cmd1,cmd2,..."
Uitsluiten van, vervangen of toevoegen aan de lijst met reguliere expressies die overeenkomen met opdrachten
wiens laatste argument tekst is. Zie vermelding voor --exclusief-safecmd direct boven voor
verdere details.

--replace-context1cmd=vervang-bestand
--append-context1cmd=append-bestand of =item --append-context1cmd="cmd1,cmd2,..."
Vervang of voeg toe aan de lijst met regex-overeenkomsten waarvan het laatste argument tekst is
maar die een bepaalde context nodig hebben om te werken, bijv. \caption werkt alleen binnen a
figuur of tafel. Deze commando's gedragen zich als tekstcommando's, behalve wanneer ze voorkomen in
een verwijderde sectie, wanneer ze zijn uitgeschakeld, maar hun argument wordt weergegeven als verwijderd
tekst.

--replace-context2cmd=vervang-bestand
--append-context2cmd=append-bestand of =item --append-context2cmd="cmd1,cmd2,..."
Als overeenkomstige opdrachten voor context1. Het enige verschil is dat context2-commando's
zijn volledig uitgeschakeld in verwijderde secties, inclusief hun argumenten.

--exclude-mboxsafecmd=exclude-bestand or --exclude-mboxsafecmd="cmd1,cmd2,..."
--append-mboxsafecmd=append-bestand or --append-mboxsafecmd="cmd1,cmd2,..."
Definieer veilige commando's, die bovendien moeten worden beschermd door ze in te kapselen in een
\\mbox{..}. Dit is soms nodig om onverenigbaarheden tussen externe
pakketten en het ulem-pakket, dat wordt gebruikt voor het markeren in de standaardstijl
UNDERLINE en CULINECHBAR CFONTSTRIKE

--config var1=waarde1,var2=waarde2,... or -c var1=val1,..
-c configuratiebestand
Configuratievariabelen instellen. De optie kan worden herhaald om verschillende variabelen in te stellen
(als alternatief voor de door komma's gescheiden lijst). Beschikbare variabelen (zie hieronder voor
verdere uitleg):

"ARRENV" (RegEx)

"COUNTERCMD" (RegEx)

"FLOATENV" (RegEx)

"ITEMCMD" (RegEx)

"LISTENV" (RegEx)

"MATHARRENV" (RegEx)

"MATHARRREPL" (Snaar)

"MATHENV" (RegEx)

"MATHREPL" (string)

"MINWORDBLOK" (geheel getal)

"PICTUREENV" (RegEx)

--show-safecmd
Lijst afdrukken met RegEx-overeenkomsten en met uitzondering van veilige commando's.

--show-textcmd
Lijst afdrukken met RegEx-overeenkomsten en opdrachten met tekstargument uitsluiten.

--show-config
Toon waarden van configuratievariabelen.

--toon alles
Combineer alle --show commando's.

NB Voor alle --show commando's hoeft geen "old.tex" of "new.tex" bestand gespecificeerd te worden, en
er vindt geen differentiatie plaats.

Overige configuratie opties:
--sta-spaties toe
Sta spaties toe tussen argumenten tussen haakjes of accolades voor opdrachten. Merk op dat deze optie
kan ongewenste bijwerkingen hebben (niet-gerelateerde reikwijdte kan op één hoop worden gegooid met voorgaande)
commando's) mag dus alleen worden gebruikt als de standaard foutieve resultaten oplevert. (Standaard
vereist dat argumenten direct op elkaar volgen zonder tussenliggende spaties).

--math-markup=niveau
Bepaal de granulariteit van opmaak in weergegeven wiskundige omgevingen: Mogelijke waarden voor
niveau zijn (zowel numerieke als tekstlabels zijn acceptabel):

"uit" of 0: opmaak onderdrukken voor wiskundige omgevingen. Verwijderde vergelijkingen verschijnen niet
in diff-bestand. Deze modus kan worden gebruikt als alle andere modi ongeldige latexcode veroorzaken.

"geheel" of 1: differentiëren op het niveau van hele vergelijkingen. Zelfs triviale veranderingen in
vergelijkingen zorgen ervoor dat de hele vergelijking als gewijzigd wordt gemarkeerd. Deze modus kan worden gebruikt als:
verwerking in grove of fijne modus resulteert in ongeldige latexcode.

"grof" of 2: Detecteer veranderingen binnen vergelijkingen die zijn gemarkeerd met een grove granulariteit;
wijzigingen in het type vergelijking (bijv. displaymath in vergelijking) verschijnen als een wijziging in de
volledige vergelijking. Deze modus wordt aanbevolen voor situaties waarin de inhoud en volgorde
van sommige vergelijkingen worden nog steeds gewijzigd. [Standaard]

"fijn" of 3: kleine veranderingen in vergelijkingen detecteren en markeren met fijne granulariteit. Dit
modus is het meest geschikt als er slechts kleine wijzigingen in vergelijkingen worden verwacht, bijv
correctie van typefouten.

--disable-citatie-opmaak or --uitschakelen-auto-mbox
Onderdruk citatie-opmaak en opmaak van andere kwetsbare commando's in stijlen met ulem
(ONDERSTREEP,FONTSTRIKE, CULINECHBAR) (de twee opties zijn identiek en eenvoudig:
aliassen)

--enable-citatie-opmaak or --enforce-auto-mbox
Bescherm citatiecommando's en andere kwetsbare commando's in gewijzigde secties met
"\mbox" commando, dwz gebruik standaard gedrag voor ulem pakket voor andere pakketten (de
twee opties zijn identiek en zijn gewoon aliassen)

Diversen
--uitgebreid or -V
Voer tijdens de verwerking verschillende statusinformatie uit naar stderr. Standaard is om te werken
stil.

--stuurprogramma=type
Kies driver voor changebar-pakket (alleen relevant voor stijlen met
changebar: CCHANGEBAR CFONTCHBAR CULINECHBAR CHANGEBAR). Mogelijke stuurprogramma's zijn:
vermeld in de handleiding van de changebar, bijv. pdftex,dvips,dvitops
[Standaard: dvips]

--negeer-waarschuwingen
Onderdruk waarschuwingen over inconsistenties in lengte tussen ingevoerde en geparseerde strings en
ontbrekende tekens. Deze waarschuwingsberichten hebben vaak betrekking op niet-standaard latex of
latexconstructies met een voor "latexdiff" onbekende syntaxis, maar het resulterende verschil
argument is vaak toch volledig functioneel, vooral als alleen de niet-standaard latex
komt voor in delen van de tekst die niet zijn gewijzigd.

--label=label or -L label
Stelt de labels in die worden gebruikt om de oude en nieuwe bestanden te beschrijven. Het eerste gebruik van deze optie
stelt het label in dat het oude bestand beschrijft en het tweede gebruik van de optie stelt het label in
voor het nieuwe bestand, dwz stel beide labels als volgt in "-L labelold -L labelnew". [Standaard:
gebruik de bestandsnaam en wijzigingsdatums voor het label]

--geen label
Onderdruk het opnemen van oude en nieuwe bestandsnamen als commentaar in het uitvoerbestand

--zichtbaar-label
Voeg oude en nieuwe bestandsnamen toe (of labels die zijn ingesteld met de optie "--label") als zichtbare uitvoer.

--afvlakken
Vervang de commando's "\input" en "\include" in de body door de inhoud van de bestanden in
hun betoog. Als "\includeonly" aanwezig is in de preambule, zijn alleen die bestanden:
uitgebreid naar het document. Er wordt echter geen recursie uitgevoerd, dwz "\input" en
"\include" commando's binnen opgenomen secties worden niet uitgevouwen. De meegeleverde bestanden zijn:
aangenomen dat
zich in dezelfde mappen bevinden als respectievelijk de oude en nieuwe hoofdbestanden,
waardoor het mogelijk wordt om bestanden in oude en nieuwe mappen te ordenen. --afvlakken is
recursief toegepast, dus ingevoerde bestanden kunnen verdere "\input"-statements bevatten.

Het gebruik van deze optie kan leiden tot onbetaalbare verwerkingstijden voor grotere documenten,
en het resulterende verschildocument weerspiegelt niet langer de structuur van de invoer
documenten.

--help or -h
Help-tekst weergeven

--versie
Versienummer weergeven

Vooraf gedefinieerde stijlen
Groot types
Het hoofdtype bepaalt de opmaak van platte tekst en enkele geselecteerde latex-commando's daarbuiten
floats door de opmaakcommando's "\DIFadd{...}" en "\DIFdel{...}" te definiëren.

"ONDERSTREPEN"
Toegevoegde tekst is golvend, onderstreept en blauw, weggegooide tekst is doorgehaald en rood
(Vereist kleur- en ulem-pakketten). Overslaan werkt niet in weergegeven
wiskundige vergelijkingen zodanig dat verwijderde delen van de vergelijking zijn onderstreept, niet doorgestreept
out (dit is een tekortkoming die inherent is aan het ulem-pakket).

"CTRADITIONEEL"
Toegevoegde tekst is blauw en geschreven in schreefloos, en voor elke tekst wordt een rode voetnoot gemaakt
weggegooid stukje tekst. (Vereist kleurenpakket)

"TRADITIONEEL"
Zoals "CTRADITIONAL" maar zonder het gebruik van kleur.

"CFONT" Toegevoegde tekst is blauw en geschreven in schreefloos, en weggegooide tekst is rood en erg
kleine maat.

"LETTERTYPE"
Toegevoegde tekst is schreefloos, weggegooide tekst klein en doorgehaald

"CHANGEBAR"
Toegevoegde tekst is blauw en verwijderde tekst is rood. Bovendien is de gewijzigde tekst
is gemarkeerd met een balk in de marge (vereist kleur- en wisselbalkpakketten).

"CFONTCHBAR"
Zoals "CFONT" maar met extra changebars (vereist kleur en changebar
pakketjes).

"CULINECHBAR"
Zoals "UNDERLINE" maar met extra wijzigingsbalken (vereist kleur, ulem en
changebar-pakketten).

"VERANDERINGSBAR"
Geen opmaak van tekst, maar markeer marges met wijzigingsbalken (vereist wijzigingsbalk
pakket).

"ONZICHTBAAR"
Geen zichtbare opmaak (maar generieke opmaakcommando's zullen nog steeds worden ingevoegd.

"BOLD" Toegevoegde tekst is vetgedrukt, weggegooide tekst wordt niet weergegeven.

Subtypen
Het subtype definieert de commando's die worden ingevoegd aan het begin en einde van toegevoegd of
verwijderde blokken, ongeacht of deze blokken tekst of commando's bevatten (Defined
commando's: "\DIFaddbegin, \DIFaddend, \DIFdelbegin, \DIFdelend")

"SAFE" Geen extra opmaak (aanbevolen keuze)

"MARGIN" Markeer begin en einde van gewijzigde blokken met symbolen in de marge in de buurt
(gebruik het standaard commando "\marginpar" - let op: dit beweegt soms
enigszins van de beoogde positie.

"KLEUR" Een alternatieve manier om toegevoegde passages in blauw te markeren en verwijderde passages in rood.
(Het wordt aanbevolen om in plaats daarvan de belangrijkste typen te gebruiken om gekleurde opmaak te bewerkstelligen,
hoewel in sommige gevallen kleuren met dvipscol bijvoorbeeld completer kan zijn
met citatiecommando's).

"DVIPSCOL"
Een alternatieve manier om toegevoegde passages in blauw te markeren en verwijderde passages in rood.
Merk op dat "DVIPSCOL" alleen werkt met de dvips-converter, bijvoorbeeld niet met pdflatex.
(het wordt aanbevolen om in plaats daarvan de belangrijkste typen te gebruiken om gekleurde opmaak te bewerkstelligen,
hoewel in sommige gevallen het kleuren met dvipscol vollediger kan zijn).

"ZLABEL" kan worden gebruikt om alleen gewijzigde pagina's te markeren, maar vereist nabewerking. Het is
raad aan om deze optie niet handmatig aan te roepen, maar gebruik "latexdiff-vc" met
"--only-changes" optie. U kunt ook het script gebruiken dat wordt gegeven in de preambule van
diff-bestanden gemaakt met deze stijl.

"ALLEEN GEWIJZIGDE PAGINA"
markeert ook gewijzigde pagina's, zonder dat nabewerking nodig is, maar misschien
werken niet betrouwbaar als er drijvend materiaal is (figuren, tabellen).

"LABEL" lijkt op "ZLABEL", maar heeft het zref-pakket niet nodig en werkt minder
betrouwbaar (verouderd).

Vlotter Types
Sommige markeringen die in de hoofdtekst worden gebruikt, kunnen problemen veroorzaken bij gebruik binnen floats
(bijvoorbeeld figuren of tabellen). Om deze reden zijn alternatieve versies van alle opmaakcommando's:
gebruikt binnen drijvers. Het type float definieert deze alternatieve commando's.

"FLOATSAFE"
Gebruik identieke opmaak voor tekst als in de hoofdtekst, maar stel alle commando's in als markering
het begin en einde van gewijzigde blokken in null-commando's. Dit moet je kiezen
float type als uw subtype "MARGE" is omdat "\marginpar" niet goed werkt
binnen drijft.

"TRADITIONEEL VEILIG"
Markeer toevoegingen op dezelfde manier als in de hoofdtekst. Verwijderde omgevingen zijn
gemarkeerd door hoekhaken \[ en \] en de verwijderde tekst wordt in scriptscript gezet
maat. Dit vlottertype moet altijd worden gebruikt met de "TRADITIONELE" en
"CTRADITIONAL" markeringstypes omdat het \footnote-commando niet goed werkt in
drijvende omgevingen.

"IDENTIEK"
Maak geen onderscheid tussen de hoofdtekst en floats.

Configuratie Variabelen
"ARRENV" Als een overeenkomst met "ARRENV" wordt gevonden in een inline wiskundige omgeving binnen een
verwijderd of toegevoegd blok, dan wordt de inline wiskunde omringd door "\mbox{"..."}".
Dit is nodig omdat onderstrepen niet werkt binnen een inlined array
omgevingen.

[ Standaard: "ARRENV"="(?:array|[pbvBV]matrix)"

"COUNTERCMD"
Als een commando in een verwijderd blok dat ook in de textcmd-lijst staat overeenkomt met
"COUNTERCMD" en vervolgens een extra commando "\addtocounter{"cntcmd"}{-1}", waarbij
cntcmd is het overeenkomende commando, wordt toegevoegd aan het diff-bestand zodat de
nummering in het diff-bestand blijft gesynchroniseerd met de nummering in de nieuwe
bestand.

[ Standaard: "COUNTERCMD"="(?:footnote|part|sectie|subsectie" ...

"|subsubsectie|paragraaf|subparagraaf)" ]

"FLOATENV"
Omgevingen waarvan de naam overeenkomt met de reguliere expressie in "FLOATENV" zijn
beschouwd als drijvers. Binnen deze omgevingen is de latexverschil opmaakcommando's zijn
vervangen door hun FL varianten.

[ Standaard: "(?:figuur|tabel|bord)[\w\d*@]*" ]

"ITEMCMD" Commando's die een nieuwe itemregel met lijstomgevingen vertegenwoordigen.

[ Standaard: \"item" ]

"LISTENV" Omgevingen waarvan de naam overeenkomt met de reguliere expressie in "LISTENV" zijn lijst
omgevingen.

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

"MATHENV","MATHREPL"
Als zowel \begin als \end voor een wiskundige omgeving (overeenkomstige omgevingsnaam)
"MATHENV" of \[ en \]) bevinden zich in hetzelfde verwijderde blok, ze worden vervangen door
a \begin en \end commando's voor "MATHREPL" in plaats van commentaar te geven.

[ Standaard: "MATHENV"="(?:displaymath|vergelijking)" , "MATHREPL"="displaymath"]

"MATHARRENV","MATHARRREPL"
als "MATHENV","MATHREPL" maar voor vergelijkingsarrays

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

"MINWOORDENBLOK"
Minimum aantal tokens dat nodig is om een ​​onafhankelijk blok te vormen. Deze waarde is
gebruikt in het algoritme om wijzigingen van volledige blokken te detecteren door identieke samen te voegen
tekstdelen van minder dan "MINWORDSBLOCK" aan de voorgaande toegevoegd en weggegooid
delen.

[ Standaard: 3 ]

"BEELDENV"
Binnen omgevingen waarvan de naam overeenkomt met de reguliere expressie in "PICTUREENV"
alle latexdiff-markeringen worden verwijderd (in pathologische gevallen kan dit leiden tot:
inconsistente opmaak, maar deze situatie zou zeldzaam moeten zijn).

[ Standaard: "(?:afbeelding|DIFnomarkup)[\w\d*@]*" ]

GEMEENSCHAPPELIJKE PROBLEMEN EN FAQ

Citaten resulteren in overvolle dozen
Er is een incompatibiliteit tussen het "ulem"-pakket, dat "latexdiff" gebruikt
voor onderstrepen en doorhalen in de UNDERLINE-stijl, de standaardstijl en
de manier waarop citaten worden gegenereerd. Om citaten te kunnen markeren
correct zijn, zijn ze omsloten met een "\mbox"-opdracht. Omdat mboxen niet kapot kunnen gaan
over lijnen, resulteert deze procedure vaak in overvolle dozen, mogelijk
waardoor de inhoud wordt verdoezeld omdat deze buiten de rechtermarge uitsteekt. Hetzelfde gebeurt
voor sommige andere pakketten (bijv. siunitx). Als dit een probleem is, heb je er twee
mogelijkheden.

1. Gebruik opmaak van het type "CFONT" (optie "-t CFONT"): Als deze opmaak is gekozen,
gewijzigde citaten worden niet langer gemarkeerd met de golvende lijn (toevoegingen) of
doorgehaald (verwijderingen), maar nog steeds gemarkeerd in de juiste kleur, en
verwijderde tekst wordt weergegeven met een ander lettertype. Andere stijlen die de "ulem" niet gebruiken
pakket zal ook werken.

2. Kies de optie "--disable-citation-markup" die de markering van uitschakelt
citaties: verwijderde citaten worden niet langer weergegeven en toegevoegde citaten worden weergegeven
zonder opmaak. (Dit was het standaardgedrag van latexdiff bij versies 0.6 en
ouder)

Voor aangepaste pakketten kunt u de opdrachten definiëren die moeten worden beschermd door:
"\mbox" met "--append-mboxsafecmd" en "--excludemboxsafecmd" opties (verzend
uw lijsten met opdrachten als functieverzoek op de github-pagina om de standaard in te stellen
gedrag van toekomstige versies, zie paragraaf 6)

Veranderingen in ingewikkelde wiskundige vergelijkingen resulteren in latexverwerkingsfouten
Probeer opties "--math-markup=whole". Als zelfs dat niet lukt, kun je markering uitschakelen
up voor vergelijkingen met "--math-markup=off".

Hoe kan ik gewoon de pagina's tonen waar wijzigingen zijn aangebracht?
Gebruik opties -"-s ZLABEL" (enige nabewerking vereist) of "-s
ONLYCHANGEDPAGE". "latexdiff-vc --ps|--pdf" met de optie "--only-changes" duurt
zorg voor de nabewerking voor u (vereist het installeren van het zref-pakket).

Latexdiff online gebruiken met onworks.net-services