latexdiff - En ligne dans le Cloud

PROGRAMME:

Nom

latexdiff - détermine et marque les différences entre deux fichiers latex

SYNOPSIS

latexdiff [ OPTIONS ] vieux.tex nouveau.tex > diff.tex

DESCRIPTION

Brièvement, latexdiff est un programme utilitaire pour aider à la gestion des révisions de latex
documents. Il compare deux fichiers latex valides, appelés ici "old.tex" et "new.tex", trouve
différences significatives entre eux (c'est-à-dire en ignorant le nombre d'espaces blancs et
position des sauts de ligne) et ajoute des commandes spéciales pour mettre en évidence les différences. Où
la mise en évidence visuelle n'est pas possible, par exemple pour les changements de formatage, les différences
sont néanmoins balisés dans la source.

Le programme traite le préambule différemment du document principal. Différences entre
les préambules sont trouvés en utilisant la différenciation par ligne (de la même manière que la commande Unix diff,
mais en ignorant les espaces blancs). Un commentaire, ""%DIF >"" est ajouté à chaque ligne ajoutée, c'est-à-dire un
ligne présente dans "new.tex" mais pas dans "old.tex". Lignes supprimées
sont désactivés en préfixant ""%DIF <"". Les blocs modifiés sont précédés de lignes de commentaires
donnant des informations sur les numéros de ligne dans les fichiers originaux. Où il y a
différences insignifiantes, le fichier résultant "diff.tex" sera similaire à "new.tex". À
la fin du préambule, les définitions de latexdiff des commandes de balisage sont insérées. Dans
en différenciant le corps principal du texte, latexdiff essaie de satisfaire ce qui suit
directives (par ordre de priorité) :

1. Si à la fois "old.tex" et "new.tex" sont des LaTeX valides, alors le "diff.tex" résultant devrait
également être valide LateX. (NB Si quelques commandes TeX simples sont utilisées dans "old.tex" ou
"new.tex" puis "diff.tex" n'est pas garanti de fonctionner mais fonctionnera généralement).

2. Des différences significatives sont déterminées au niveau des mots individuels. Tous
les différences significatives, y compris les différences entre les commentaires doivent être clairement
marqué dans le code source résultant "diff.tex".

3. Si un passage modifié contient du texte ou des commandes de production de texte, exécutez "diff.tex"
à LateX devrait produire une sortie où les passages ajoutés et supprimés sont mis en évidence.

4. Lorsqu'il y a des différences insignifiantes, par exemple dans le positionnement des sauts de ligne,
"diff.tex" doit suivre le formatage de "new.tex"

Pour différencier le même algorithme que diff est utilisé mais des mots au lieu de lignes sont
par rapport. Une tentative est faite pour reconnaître les blocs qui sont complètement modifiés de telle sorte que
ils peuvent être marqués comme une unité. Les commentaires sont différenciés ligne par ligne mais le nombre de
les espaces dans les commentaires sont ignorés. Les commandes incluant tous leurs arguments sont généralement
comparé comme une unité, c'est-à-dire qu'aucune balise n'est insérée dans les arguments des commandes.
Cependant, pour un nombre sélectionné de commandes (par exemple, "\caption" et toutes les sections
commandes) le dernier argument est connu pour être du texte. Ce texte est divisé en mots et
différent comme du texte ordinaire (utilisez les options pour afficher et modifier la liste de texte
commandes, voir ci-dessous). Comme l'algorithme n'a aucune connaissance détaillée de LaTeX, il suppose que tous
paires d'accolades suivant immédiatement une commande (c'est-à-dire une séquence de lettres
commençant par une barre oblique inverse) sont des arguments pour cette commande. Comme restriction à la condition
1 ci-dessus, il est donc nécessaire d'entourer tous les arguments d'accolades, et de ne pas
insérer des espaces superflus. Par exemple, écrivez

\section{\textem{Ceci est un titre de section souligné}}

ne le comptant pas

\section {\textem{Ceci est un titre de section souligné}}

or

\section\textem{Ceci est un titre de section souligné}

même si toutes les variétés sont identiques à LaTeX (mais voir --autoriser les espaces option qui
permet la deuxième variété).

Pour les environnements dont le contenu n'est pas conforme à la norme LaTeX ou où les graphiques
le balisage n'a pas de sens toutes les commandes de balisage peuvent être supprimées en définissant PICTUREENV
variable de configuration, définie par défaut sur les environnements « picture » ​​et « DIFnomarkup » ; voir
--config option). Ce dernier environnement ("DIFnomarkup") peut être utilisé pour protéger des parties de
le fichier latex où le balisage entraîne un balisage illégal. Vous devez entourer le
passage incriminé dans l'ancien et le nouveau fichier par "\begin{DIFnomarkup}" et
"\end{DIFnomarkup}". Vous devez définir l'environnement dans les préambules de l'ancien et du nouveau
documents. Je préfère le définir comme un environnement nul,

"\newenvironment{DIFnomarkup}{}{}"

mais le choix vous appartient. Tout balisage dans l'environnement sera supprimé, et généralement
tout ce qui se trouve dans l'environnement sera simplement extrait du nouveau fichier.

Il est également possible de différencier les fichiers qui n'ont pas de préambule.
Dans ce cas, le fichier est traité en mode document principal, mais les définitions des
les commandes de balisage ne sont pas insérées.

Toutes les commandes de balisage insérées par latexdiff commencer par ""\DIF"". Ajout de blocs contenant
les mots, commandes ou commentaires qui sont dans "new.tex" mais pas dans "old.tex" sont marqués par
"\DIFaddbegin" et "\DIFaddend". Les blocs rejetés sont marqués par "\DIFdelbegin" et
"\DIFdelend". Dans les blocs ajoutés, tout le texte est surligné avec "\DIFadd" comme ceci :
"\DIFadd{Bloc de texte ajouté}" Les commandes "sûres" sélectionnées peuvent être contenues dans ces blocs de texte
ainsi (utilisez les options pour afficher et modifier la liste des commandes sûres, voir ci-dessous). Tous les autres
les commandes ainsi que les accolades "{" et "}" ne sont jamais placées dans la portée de "\DIFadd". Ajoutée
les commentaires sont marqués en préfixant ""%DIF > "".

Dans les blocs supprimés, le texte est surligné avec "\DIFdel". Les commentaires supprimés sont signalés par
avant ""%DIF < "". Les commandes non sécurisées et les accolades dans les blocs supprimés sont
commenté avec ""%DIFDELCMD < "".

OPTIONS

Préambule
Les options suivantes déterminent le style de balisage visuel en ajoutant la commande appropriée
définitions au préambule. Voir la fin de cette section pour une description des
modes.

--type=style de balisage or -t style de balisage
Ajoutez du code au préambule pour le style de balisage sélectionné. Cette option définit "\DIFadd" et
Commandes "\DIFdel". Modèles disponibles :

"SOULIGNER CTRADITIONNEL TRADITIONNEL CFONT FONTSTRIKE INVISIBLE CHANGEBAR CCHANGEBAR
CULINECHBAR CFONTCBHBAR BOLD"

[Par défaut : "SOULIGNÉ"]

--subtype=marquestyle or -s style de marque
Ajouter du code au préambule pour le style sélectionné pour les commandes de bracketing (par exemple pour marquer les changements
en marge). Cette option définit "\DIFaddbegin", "\DIFaddend", "\DIFdelbegin" et
Commandes "\DIFdelend". Styles disponibles : "SAFE MARGIN COLOR DVIPSCOL ZLABEL
CHANGEMENT DE PAGE UNIQUEMENT (ÉTIQUETTE)*"

[ Par défaut : " SAFE " ] * Le sous-type " LABEL " est obsolète

--floattype=marquestyle or -f style de marque
Ajouter du code au préambule pour le style sélectionné qui remplace le marquage et le balisage standard
commandes dans les flottants (par exemple, les remarques marginales provoquent une erreur dans les flottants donc
le marquage marginal peut ainsi être désactivé). Cette option définit toutes les commandes "\DIF...FL".
Styles disponibles : "FLOATSAFE TRADITIONALSAFE IDENTIQUE"

[Par défaut : «                                          ]

--encoding=enc or -e enc
Spécifiez l'encodage de old.tex et new.tex. Les encodages typiques sont "ascii", "utf8",
"latin1", "latin9". Une liste des encodages disponibles peut être obtenue en exécutant

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

[Le codage par défaut est utf8 à moins que les premières lignes du préambule contiennent un
invocation "\usepackage[..]{inputenc}" auquel cas l'encodage choisi par ce
la commande est assumée. Notez que ASCII (latex standard) est un sous-ensemble de utf8]

--preambule=fichier or -p filet
Insérez le fichier à la fin du préambule au lieu de générer le préambule. Le préambule doit
définir les commandes suivantes "\DIFaddbegin, \DIFaddend, \DIFadd{..},
\DIFdelbegin,\DIFdelend,\DIFdel{..}" et les variétés à utiliser dans les flottants
"\DIFaddbeginFL, \DIFaddendFL, \DIFaddFL{..}, \DIFdelbeginFL, \DIFdelendFL,
\DIFdelFL{..}" (Si cette option est définie -t, -set -f les options sont ignorées.)

--packages=pkg1,pkg2,..
Dites à latexdiff que le fichier .tex est traité avec les packages de la liste chargés. C'est
normalement pas nécessaire si le fichier .tex inclut le préambule, car le préambule est
automatiquement analysé les commandes "\usepackage". Utilisation du --paquets option
désactive l'analyse automatique, donc si, pour une raison quelconque, l'analyse spécifique au package doit être
éteint, utiliser --packages=aucun. Les packages suivants déclenchent un comportement spécial :

« amsmath »
La variable de configuration MATHARRREPL est définie sur "align*" (par défaut : "eqnarray*").
(Notez que de nombreux environnements de tableaux amsmath sont déjà reconnus par
par défaut en tant que tel)

« flotteur »
Assurez-vous que "\begin{figure}" et "\end{figure}" apparaissent toujours seuls sur
une ligne.

"hyperréf"
Remplacez le nom des commandes "\DIFadd" et "\DIFdel" par "\DIFaddtex" et
"\DIFdeltex" et définissez de nouvelles commandes "\DIFadd" et "\DIFdel", qui fournissent un
wrapper pour ces commandes, en les utilisant pour le texte mais pas pour le lien
définissant la commande (où tout balisage provoquerait des erreurs).

"apaiser"
Redéfinissez les commandes reconnues comme commandes de citation.

"siunitx"
Traiter "\SI" comme équivalent aux commandes de citation (c'est-à-dire protéger avec "\mbox" si
le style de balisage utilise le package ulem.

"intelligent"
Traitez "\cref,\Cref", etc. comme équivalent aux commandes de citation (c'est-à-dire protéger avec
"\mbox" si le style de balisage utilise le package ulem.

"glossaires"
Définissez la plupart des commandes de glossaires comme sûres, en les protégeant avec \mbox'es
là où c'est nécessaire

"mhchem"
Traitez "\ce" comme une commande sûre, c'est-à-dire qu'elle sera mise en surbrillance (notez que "\cee"
ne sera pas mis en évidence dans les équations car cela conduit à des erreurs de traitement)

« formule chimique » ou « chemmacros »
Traiter "\ch" comme une commande sûre en dehors des équations, c'est-à-dire qu'elle sera mise en évidence
(notez que "\ch" ne sera pas mis en évidence dans les équations car cela conduit à
erreurs de traitement)

[ Par défaut : recherchez dans le préambule les commandes « \usepackage » pour déterminer
colis chargés. ]

--show-preambule
Imprimez les commandes de préambule générées ou incluses sur stdout.

configuration
--exclude-safecmd=exclure-fichier or -A fichier-exclure or --exclude-safecmd="cmd1,cmd2,..."
--replace-safecmd=remplacer-fichier
--append-safecmd=ajouter-fichier or -a ajouter-fichier or --append-safecmd="cmd1,cmd2,..."
Exclure, remplacer ou ajouter à la liste des expressions régulières (RegEx) correspondant
commandes qui peuvent être utilisées en toute sécurité dans le cadre d'une commande "\DIFadd" ou "\DIFdel".
Le fichier doit contenir un Perl-RegEx par ligne (les lignes de commentaires commençant par # ou % sont
ignoré). Notez que RegEx doit correspondre à l'ensemble du jeton, c'est-à-dire /^regex$/
est implicite et que le "\" initial de la commande n'est pas inclus. Les
--exclude-safecmd ainsi que --append-safecmd les options peuvent être combinées avec les
---remplacer-safecmd option et peut être utilisé à plusieurs reprises pour ajouter cumulativement aux listes.
--exclude-safecmd ainsi que --append-safecmd peut également prendre une liste séparée par des virgules en entrée.
Si une virgule pour l'une des expressions régulières est requise, échappez-la ainsi "\,". Dans la plupart des cas, il
sera nécessaire de protéger la liste séparée par des virgules du shell en la mettant dans
guillemets.

--exclude-textcmd=exclure-fichier or -X fichier-exclure or --exclude-textcmd="cmd1,cmd2,..."
--replace-textcmd=remplacer-fichier
--append-textcmd=ajouter-fichier or -x ajouter-fichier or --append-textcmd="cmd1,cmd2,..."
Exclure, remplacer ou ajouter à la liste des expressions régulières correspondant aux commandes
dont le dernier argument est du texte. Voir l'entrée pour --exclude-safecmd juste au-dessus pour
plus de détails.

--replace-context1cmd=remplacer-fichier
--append-context1cmd=ajouter-fichier ou = élément --append-context1cmd="cmd1,cmd2,..."
Remplacer ou ajouter à la liste des commandes de correspondance regex dont le dernier argument est du texte
mais qui nécessitent un contexte particulier pour fonctionner, par exemple \caption ne fonctionnera que dans un
figure ou tableau. Ces commandes se comportent comme des commandes de texte, sauf lorsqu'elles se produisent dans
une section supprimée, lorsqu'ils sont désactivés, mais leur argument est affiché comme supprimé
texte.

--replace-context2cmd=remplacer-fichier
--append-context2cmd=ajouter-fichier ou = élément --append-context2cmd="cmd1,cmd2,..."
En tant que commandes correspondantes pour context1. La seule différence est que les commandes context2
sont complètement désactivés dans les sections supprimées, y compris leurs arguments.

--exclude-mboxsafecmd=exclure-fichier or --exclude-mboxsafecmd="cmd1,cmd2,..."
--append-mboxsafecmd=ajouter-fichier or --append-mboxsafecmd="cmd1,cmd2,..."
Définir des commandes sûres, qui doivent en outre être protégées en s'encapsulant dans un
\\mbox{..}. Cela est parfois nécessaire pour contourner les incompatibilités entre les
packages et le package ulem, qui est utilisé pour mettre en évidence dans le style par défaut
SOULIGNE ainsi que CULINECHBAR CFONTSTRIKE

--config var1=val1,var2=val2,... or -c var1=val1,..
-c fichier de configuration
Définissez les variables de configuration. L'option peut être répétée pour définir différentes variables
(comme alternative à la liste séparée par des virgules). Variables disponibles (voir ci-dessous pour
plus d'explications):

"ARRENV" (RegEx)

"COUNTERCMD" (RegEx)

"FLOATENV" (RegEx)

"ITEMCMD" (RegEx)

"LISTENV" (RegEx)

"MATHARRENV" (RegEx)

"MATHARRREPL" (chaîne)

"MATHENV" (RegEx)

"MATHREPL" (chaîne)

"MINWORDSBLOCK" (entier)

"PICTUREENV" (RegEx)

--show-safecmd
Imprimer la liste des correspondances RegEx et excluant les commandes sécurisées.

--show-textcmd
Affiche la liste des commandes de correspondance et d'exclusion RegEx avec un argument de texte.

--show-config
Afficher les valeurs des variables de configuration.

--Afficher tout
Combinez toutes les commandes --show.

NB Pour toutes les commandes --show, aucun fichier "old.tex" ou "new.tex" n'a besoin d'être spécifié, et
aucune différence n'a lieu.

Autre paramétrage options:
--autoriser les espaces
Autorisez des espaces entre les arguments entre crochets ou accolades pour les commandes. Notez que cette option
peut avoir des effets secondaires indésirables (la portée non liée peut être regroupée avec la précédente
commandes) ne doit donc être utilisé que si la valeur par défaut produit des résultats erronés. (Défaut
exige que les arguments se succèdent directement sans espaces intermédiaires).

--math-markup=niveau
Déterminer la granularité du balisage dans les environnements mathématiques affichés : valeurs possibles pour
niveau sont (les étiquettes numériques et textuelles sont acceptables) :

"off" ou 0 : supprimez le balisage pour les environnements mathématiques. Les équations supprimées n'apparaîtront pas
dans le fichier diff. Ce mode peut être utilisé si tous les autres modes provoquent un code latex invalide.

"entier" ou 1 : Différenciation au niveau d'équations entières. Des changements même insignifiants
les équations provoquent le changement de l'ensemble de l'équation. Ce mode peut être utilisé si
le traitement en mode grossier ou fin entraîne un code latex invalide.

« grossier » ou 2 : Détecter les changements au sein d'équations marquées avec une granularité grossière ;
les changements dans le type d'équation (par exemple, displaymath en équation) apparaissent comme un changement dans le
équation complète. Ce mode est recommandé pour les situations où le contenu et l'ordre
de certaines équations sont encore en cours de modification. [Défaut]

"fin" ou 3 : Détectez les petits changements dans les équations et marquez avec une granularité fine. Cette
le mode est le plus approprié, si seuls des changements mineurs aux équations sont attendus, par exemple
correction des fautes de frappe.

--disable-citation-markup or --disable-auto-mbox
Supprimer le balisage de citation et le balisage d'autres commandes vulnérables dans les styles utilisant ulem
(SOULIGNÉ, FONTSTRIKE, CULINECHBAR) (les deux options sont identiques et sont simplement
alias)

--enable-citation-markup or --enforce-auto-mbox
Protégez les commandes de citation et autres commandes vulnérables dans les sections modifiées avec
Commande "\mbox", c'est-à-dire utiliser le comportement par défaut du package ulem pour les autres packages (le
deux options sont identiques et sont simplement des alias)

Divers
--verbeux or -V
Sortir diverses informations d'état sur stderr pendant le traitement. La valeur par défaut est de travailler
silencieusement.

--pilote=type
Choisissez le pilote pour le package changebar (uniquement pertinent pour les styles utilisant
barre de changement : CCHANGEBAR CFONTCHBAR CULINECHBAR CHANGEBAR). Les pilotes possibles sont
répertorié dans le manuel de la barre de changement, par exemple pdftex, dvips, dvitops
[Par défaut : dvips]

--ignore-avertissements
Supprimer les avertissements concernant les incohérences de longueur entre les chaînes d'entrée et analysées et
caractères manquants. Ces messages d'avertissement sont souvent liés à du latex non standard ou
constructions en latex avec une syntaxe inconnue de "latexdiff" mais la différence résultante
l'argument est souvent pleinement fonctionnel de toute façon, en particulier si le latex non standard
apparaît dans des parties du texte qui n'ont pas changé.

--label=étiquette or -L étiquette
Définit les étiquettes utilisées pour décrire les anciens et les nouveaux fichiers. La première utilisation de cette option
définit l'étiquette décrivant l'ancien fichier et la deuxième utilisation de l'option définit l'étiquette
pour le nouveau fichier, c'est-à-dire définir les deux étiquettes comme ceci "-L labelold -L labelnew". [Défaut:
utiliser le nom de fichier et les dates de modification pour l'étiquette]

--pas de label
Supprimer l'inclusion des anciens et des nouveaux noms de fichiers en tant que commentaire dans le fichier de sortie

--étiquette-visible
Incluez les anciens et les nouveaux noms de fichiers (ou les étiquettes définies avec l'option "--label") en tant que sortie visible.

--aplatir
Remplacez les commandes "\input" et "\include" dans le corps par le contenu des fichiers dans
leur argumentation. Si "\includeonly" est présent dans le préambule, seuls ces fichiers sont
étendu dans le document. Cependant, aucune récursivité n'est effectuée, c'est-à-dire "\input" et
Les commandes "\include" dans les sections incluses ne sont pas développées. Les fichiers inclus sont
supposé
être situés dans les mêmes répertoires que l'ancien et le nouveau fichier maître, respectivement,
permettant d'organiser les fichiers dans les anciens et les nouveaux répertoires. --flatten est
appliqué de manière récursive, de sorte que les fichiers entrés peuvent contenir d'autres instructions "\input".

L'utilisation de cette option peut entraîner des délais de traitement prohibitifs pour les documents plus volumineux,
et le document de différence résultant ne reflète plus la structure de l'entrée
documents.

--Aidez-moi or -h
Afficher le texte d'aide

--version
Afficher le numéro de version

Prédéfini modes
Majeurs types
Le type principal détermine le balisage du texte brut et de certaines commandes latex sélectionnées en dehors
flotte en définissant les commandes de balisage "\DIFadd{...}" et "\DIFdel{...}" .

"SOULIGNER"
Le texte ajouté est souligné de manière ondulée et bleu, le texte supprimé est barré et rouge
(Nécessite des packages de couleur et d'ulem). Overstrike ne fonctionne pas dans affiché
équations mathématiques telles que les parties supprimées de l'équation sont soulignées et non barrées
out (il s'agit d'une lacune inhérente au package ulem).

"CRADITIONNEL"
Le texte ajouté est bleu et défini en sans-serif, et une note de bas de page rouge est créée pour chaque
morceau de texte jeté. (Nécessite un ensemble de couleurs)

"TRADITIONNEL"
Comme "CTRADITIONNEL" mais sans l'utilisation de couleur.

"CFONT" Le texte ajouté est bleu et défini en sans-serif, et le texte supprimé est rouge et très
petite taille.

"FONTSTRIKE"
Le texte ajouté est défini en sans-serif, le texte supprimé est petit et barré

" BARRE DE CHANGEMENT "
Le texte ajouté est bleu et le texte supprimé est rouge. De plus, le texte modifié
est marqué d'une barre dans la marge (Nécessite des packages de couleur et de barre de changement).

"CFONTCHBAR"
Comme "CFONT" mais avec des barres de changement supplémentaires (nécessite une couleur et une barre de changement
paquets).

"CULINECHBAR"
Comme "UNDERLINE" mais avec des barres de changement supplémentaires (Nécessite une couleur, un ulem et
paquets changebar).

" BARRE DE CHANGEMENT "
Pas de balisage de texte, mais marque les marges avec des barres de changement (nécessite une barre de changement
paquet).

"INVISIBLE"
Pas de balisage visible (mais des commandes de balisage génériques seront toujours insérées.

"GRAS" Le texte ajouté est mis en gras, rejeté n'est pas affiché.

Sous-types
Le sous-type définit les commandes qui sont insérées au début et à la fin de l'ajout ou
blocs supprimés, que ces blocs contiennent du texte ou des commandes (défini
commandes : "\DIFaddbegin, \DIFaddend, \DIFdelbegin, \DIFdelend")

"SÉCURISÉ" Pas de balisage supplémentaire (Choix recommandé)

"MARGE" Marque le début et la fin des blocs modifiés avec des symboles dans la marge à proximité
(en utilisant la commande standard "\marginpar" - notez que cela se déplace parfois
quelque peu de la position prévue.

"COULEUR" Une autre façon de marquer les passages ajoutés en bleu et ceux supprimés en rouge.
(Il est recommandé d'utiliser à la place les types principaux pour effectuer un balisage coloré,
bien que dans certains cas la coloration avec dvipscol puisse être plus complète, par exemple
avec les commandes de citation).

"DVIPSCOL"
Une autre façon de marquer les passages ajoutés en bleu et ceux supprimés en rouge.
Notez que "DVIPSCOL" ne fonctionne qu'avec le convertisseur dvips, par exemple pas pdflatex.
(il est recommandé d'utiliser à la place les types principaux pour effectuer un balisage coloré,
bien que dans certains cas, la coloration avec dvipscol puisse être plus complète).

"ZLABEL" peut être utilisé pour mettre en évidence uniquement les pages modifiées, mais nécessite un post-traitement. Il est
recommande de ne pas appeler cette option manuellement mais d'utiliser "latexdiff-vc" avec
Option "--seulement-changements". Alternativement, utilisez le script donné dans le préambule de
diff créés à l'aide de ce style.

"SEULEMENT CHANGER DE PAGE"
met également en évidence les pages modifiées, sans avoir besoin de post-traitement, mais peut
ne fonctionne pas de manière fiable s'il y a du matériel flottant (chiffres, tableaux).

"LABEL" est similaire à "ZLABEL", mais n'a pas besoin du package zref et fonctionne moins
de manière fiable (obsolète).

flotteur Types
Certains des balisages utilisés dans le texte principal peuvent causer des problèmes lorsqu'ils sont utilisés dans des flottants
(par exemple des figures ou des tableaux). Pour cette raison, des versions alternatives de toutes les commandes de balisage sont
utilisé dans les flotteurs. Le type float définit ces commandes alternatives.

"SÉCURITÉ FLOTTANTE"
Utilisez un balisage identique pour le texte comme dans le corps principal, mais définissez toutes les commandes de marquage
le début et la fin des blocs modifiés en commandes nulles. Vous devez choisir ceci
type float si votre sous-type est "MARGIN" car "\marginpar" ne fonctionne pas correctement
à l'intérieur des flotteurs.

"TRADITIONNEL SÉCURISÉ"
Marquez les ajouts de la même manière que dans le texte principal. Les environnements supprimés sont
marqué par des crochets angulaires \[ et \] et le texte supprimé est défini en scriptscript
Taille. Ce type de flotteur doit toujours être utilisé avec le "TRADITIONNEL" et
Les types de balisage "CTRADITIONNELS" car la commande \footnote ne fonctionne pas correctement dans
environnements flottants.

"IDENTIQUE"
Ne faites aucune différence entre le texte principal et les flottants.

configuration Variables
"ARRENV" Si une correspondance avec "ARRENV" est trouvée dans un environnement mathématique en ligne dans un
bloc supprimé ou ajouté, le calcul en ligne est entouré de "\mbox{"..."}".
Ceci est nécessaire car le soulignement ne fonctionne pas dans un tableau en ligne
environnements.

[ Par défaut : "ARRENV"="(?:array|[pbvBV]matrice)"

"CONTRECMD"
Si une commande dans un bloc supprimé qui est également dans la liste textcmd correspond
"COUNTERCMD" puis une commande supplémentaire "\addtocounter{"cntcmd"}{-1}", où
cntcmd est la commande correspondante, est ajouté dans le fichier diff de telle sorte que le
la numérotation dans le fichier diff reste synchronisée avec la numérotation dans le nouveau
fichier.

[ Par défaut : "COUNTERCMD"="(?:note de bas de page|partie|section|sous-section" ...

"|sous-sous-section|paragraphe|sous-paragraphe)" ]

"FLOTTEUR V"
Les environnements dont le nom correspond à l'expression régulière dans "FLOATENV" sont
considérés comme des flotteurs. Au sein de ces environnements, le latexdiff les commandes de balisage sont
remplacés par leurs variantes FL.

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

"ITEMCMD" Commandes représentant une nouvelle ligne d'article avec des environnements de liste.

[Par défaut : \"élément"]

"LISTENV" Les environnements dont le nom correspond à l'expression régulière dans "LISTENV" sont listés
environnements.

[ Par défaut : "(?:itemize|enumerate|description)" ]

"MATHENV","MATHREPL"
Si à la fois \begin et \end pour un environnement mathématique (correspondance du nom de l'environnement
"MATHENV" ou \[ et \]) sont dans le même bloc supprimé, ils sont remplacés par
une commande \begin et \end pour "MATHREPL" plutôt que d'être commentée.

[ Par défaut : "MATHENV"="(?:displaymath|equation)" , "MATHREPL"="displaymath" ]

"MATHARRENV","MATHARRREPL"
comme "MATHENV","MATHREPL" mais pour les tableaux d'équations

[ Par défaut : "MATHARRENV"="eqnarray\*?" , "MATHREPL"="eqnarray" ]

"MINWORDS BLOCK"
Nombre minimum de jetons requis pour former un bloc indépendant. Cette valeur est
utilisé dans l'algorithme pour détecter les changements de blocs complets en fusionnant les mêmes
parties de texte inférieures à "MINWORDSBLOCK" au précédent ajoutées et supprimées
des pièces.

[ Par défaut : 3 ]

"PICTUREENV"
Dans les environnements dont le nom correspond à l'expression régulière dans "PICTUREENV"
tout le balisage latexdiff est supprimé (dans les cas pathologiques, cela peut conduire à
balisage incohérent mais cette situation devrait être rare).

[ Par défaut : "(?:picture|DIFnomarkup)[\w\d*@]*" ]

COMMUNE PROBLÈMES ET QFP

Les citations entraînent des cases trop pleines
Il existe une incompatibilité entre le package "ulem", que "latexdiff" utilise
pour souligner et barrer dans le style UNDERLINE, le style par défaut, et
la façon dont les citations sont générées. Afin de pouvoir annoter les citations
correctement, ils sont entourés d'une commande "\mbox". Comme les mbox ne peuvent pas être cassés
à travers les lignes, cette procédure entraîne fréquemment des cases trop pleines, peut-être
obscurcissant le contenu lorsqu'il s'étend au-delà de la marge de droite. La même chose se produit
pour certains autres packages (par exemple, siunitx). Si c'est un problème, vous avez deux
possibilités.

1. Utiliser un balisage de type "CFONT" (option "-t CFONT") : Si ce balisage est choisi, alors
les citations modifiées ne sont plus marquées par la ligne ondulée (ajouts) ou
biffés (suppressions), mais toujours surlignés dans la couleur appropriée, et
le texte supprimé est affiché avec une police différente. Autres styles n'utilisant pas le "ulem"
paquet fonctionnera également.

2. Choisissez l'option "--disable-citation-markup" qui désactive le balisage de
citations : les citations supprimées ne sont plus affichées et les citations ajoutées sont affichées
sans balisage. (C'était le comportement par défaut de latexdiff dans les versions 0.6 et
plus âgée)

Pour les packages personnalisés, vous pouvez définir les commandes qui doivent être protégées par
"\mbox" avec les options "--append-mboxsafecmd" et "--excludemboxsafecmd" (soumettre
vos listes de commandes en tant que demande de fonctionnalité sur la page github pour définir la valeur par défaut
comportement des futures versions, voir section 6)

Les changements dans les équations mathématiques compliquées entraînent des erreurs de traitement du latex
Essayez les options "--math-markup=whole". Si même cela échoue, vous pouvez désactiver la marque
pour les équations avec "--math-markup=off".

Comment puis-je simplement afficher les pages où des modifications ont été apportées
Utilisez les options -"-s ZLABEL" (un post-traitement requis) ou "-s
ONLYCHANGEDPAGE". "latexdiff-vc --ps|--pdf" avec l'option "--only-changes" prend
s'occuper du post-traitement pour vous (nécessite l'installation du package zref).

Utilisez latexdiff en ligne en utilisant les services onworks.net