latexdiff — Online w chmurze

PROGRAM:

IMIĘ

latexdiff - określa i oznacza różnice między dwoma plikami lateksowymi

STRESZCZENIE

lateksdiff [ OPCJE ] stary.teks nowy.tex > różnica.tex

OPIS

Krótko, lateksdiff to program narzędziowy pomagający w zarządzaniu wersjami lateksu
dokumenty. Porównuje dwa prawidłowe pliki lateksowe, tutaj zwane „stary.tex” i „nowy.tex”, stwierdza
znaczące różnice między nimi (np. ignorowanie liczby spacji i
pozycji łamania wierszy) i dodaje specjalne polecenia w celu podkreślenia różnic. Gdzie
wyróżnienie wizualne nie jest możliwe, np. w przypadku zmian w formatowaniu, różnic
są jednak zaznaczone w źródle.

Program traktuje preambułę inaczej niż dokument główny. Różnice pomiędzy
preambuły są znajdowane przy użyciu różnicowania opartego na wierszach (podobnie do polecenia uniksowego diff,
ale ignorując spacje). Komentarz ""%DIF >"" jest dołączany do każdej dodanej linii, tj
linia obecna w "new.tex", ale nie w "old.tex". Odrzucone linie
są dezaktywowane przez dodanie ""%DIF <"". Zmienione bloki są poprzedzone liniami komentarza
podanie informacji o numerach wierszy w oryginalnych plikach. Gdzie są
nieznaczne różnice, wynikowy plik „diff.tex” będzie podobny do „new.tex”. Na
koniec preambuły, definicje dla lateksdiff wstawiane są polecenia znaczników. w
różnicowanie głównej części tekstu, lateksdiff stara się spełnić następujące
wytyczne (w kolejności priorytetów):

1. Jeśli oba „stary.tex” i „nowy.tex” są poprawne LaTeX, to wynikowy „diff.tex” powinien
być również poprawnym LateXem. (Uwaga: jeśli kilka prostych poleceń TeX jest używanych w "old.tex" lub
„new.tex”, a następnie „diff.tex” nie gwarantuje działania, ale zwykle będzie).

2. Istotne różnice określane są na poziomie poszczególnych słów. Wszystko
istotne różnice, w tym różnice między komentarzami powinny być wyraźnie
oznaczone w otrzymanym kodzie źródłowym "diff.tex".

3. Jeśli zmieniony fragment zawiera tekst lub polecenia tworzące tekst, uruchom „diff.tex”
przez LateX powinien generować dane wyjściowe, w których zaznaczone są dodane i odrzucone fragmenty.

4. W przypadku nieznacznych różnic, np. w rozmieszczeniu przerw w linii,
„diff.tex” powinien być zgodny z formatowaniem „new.tex”

Do rozróżniania tego samego algorytmu co diff jest używany, ale słowa zamiast linii są
w porównaniu. Podejmowana jest próba rozpoznania bloków całkowicie zmienionych w taki sposób, że:
można je oznaczyć jako jednostkę. Komentarze różnią się wiersz po wierszu, ale liczba
spacje w komentarzach są ignorowane. Komendy zawierające wszystkie ich argumenty są generalnie
porównywane jako jedna jednostka, tj. do argumentów poleceń nie są wstawiane żadne znaczniki.
Jednak dla wybranej liczby poleceń (na przykład „\caption” i wszystkich sekcji
poleceń) ostatnim argumentem jest tekst. Ten tekst jest podzielony na słowa i
różni się tak jak zwykły tekst (użyj opcji, aby wyświetlić i zmienić listę tekstów
polecenia, patrz poniżej). Ponieważ algorytm nie ma szczegółowej wiedzy na temat LaTeX-a, zakłada, że ​​wszystko
pary nawiasów klamrowych bezpośrednio po poleceniu (tj. sekwencja liter
rozpoczynające się odwrotnym ukośnikiem) są argumentami dla tego polecenia. Jako ograniczenie stanu
1 powyżej należy więc otoczyć wszystkie argumenty nawiasami klamrowymi, a nie
wstaw dodatkowe spacje. Na przykład napisz

\section{\textem{To jest wyróżniony tytuł sekcji}}

i uwaga

\section {\textem{To jest wyróżniony tytuł sekcji}}

or

\section\textem{To jest wyróżniony tytuł sekcji}

mimo że wszystkie odmiany są takie same jak LaTeX (ale zobacz --pozwól-spacje opcja która
pozwala na drugą odmianę).

Dla środowisk, których zawartość nie jest zgodna ze standardowym LaTeXem lub gdzie jest graficzna
znacznik nie ma sensu wszystkie polecenia znaczników można usunąć, ustawiając PICTUREENV
zmienna konfiguracyjna, domyślnie ustawiona na środowiska "picture" i "DIFnomarkup"; zobaczyć
--konfig opcja). To ostatnie środowisko („DIFnomarkup”) może być używane do ochrony części
plik lateksowy, w którym znaczniki powodują niedozwolone znaczniki. Musisz otoczyć
obraźliwy fragment zarówno w starym, jak i nowym pliku przez "\begin{DIFnomarkup}" i
"\end{DIFnoznacznik}". Musisz zdefiniować środowisko w preambułach zarówno starych, jak i nowych
dokumenty. Wolę określić to jako środowisko zerowe,

"\noweśrodowisko{DIFnoznacznik}{}{}"

ale wybór należy do Ciebie. Wszelkie znaczniki w środowisku zostaną usunięte i ogólnie
wszystko w środowisku zostanie po prostu pobrane z nowego pliku.

Możliwe jest również rozróżnienie plików, które nie posiadają preambuły.
W tym przypadku plik jest przetwarzany w trybie dokumentu głównego, ale definicje
polecenia znaczników nie są wstawiane.

Wszystkie polecenia znaczników wstawione przez lateksdiff zaczynają się od ""\DIF"". Dodano bloki zawierające
słowa, polecenia lub komentarze, które znajdują się w „new.tex”, ale nie w „starym.tex”, są oznaczone przez
„\DIFaddbegin” i „\DIFaddend”. Odrzucone bloki są oznaczone przez "\DIFdelbegin" i
"\DIFdelend". W dodanych blokach cały tekst jest podświetlony za pomocą „\DIFadd” w następujący sposób:
"\DIFadd{Dodany blok tekstowy}" Wybrane `bezpieczne' polecenia mogą być zawarte w tych blokach tekstowych
również (użyj opcji, aby wyświetlić i zmienić listę bezpiecznych poleceń, patrz poniżej). Wszystkie inne
polecenia, a także nawiasy klamrowe „{” i „}” nigdy nie są umieszczane w zakresie „\DIFadd”. Dodany
komentarze są oznaczone na początku ""%DIF > "".

W usuniętych blokach tekst jest wyróżniony za pomocą „\DIFdel”. Usunięte komentarze są oznaczone
poprzedzony ""%DIF < "". Niebezpieczne polecenia i nawiasy klamrowe w usuniętych blokach są
skomentowano z ""%DIFDELCMD < "".

OPCJE

Preambuła
Poniższe opcje określają styl wizualnych znaczników poprzez dodanie odpowiedniego polecenia
definicje do preambuły. Zobacz koniec tej sekcji, aby uzyskać opis dostępnych
style.

--type=styl znaczników or -t styl znaczników
Dodaj kod do preambuły dla wybranego stylu znaczników. Ta opcja definiuje "\DIFadd" i
Polecenia „\DIFdel”. Dostępne style:

„PODSTAWIENIE TRADYCYJNA TRADYCYJNA CZCIONKA CZCIONKI NIEWIDOCZNY PASEK ZMIANY CHANGEBAR
CULINECHBAR CFONTCBHBAR WZMOCNIONY"

[Domyślnie: „PODkreślenie” ]

--podtyp=styl znaku or -s styl markowy
Dodaj kod do preambuły dla wybranego stylu poleceń nawiasów (np. w celu zaznaczenia zmian)
na marginesie). Ta opcja definiuje „\DIFaddbegin”, „\DIFaddend”, „\DIFdelbegin” i
Polecenia „\DIFdelend”. Dostępne style: „SAFE MARGIN COLOR DVIPSCOL ZLABEL
TYLKOZMIENIONA STRONA (ETYKIETA)*"

[Domyślnie: „BEZPIECZNY” ] * Podtyp „LABEL” jest przestarzały

--floattype=styl znaku or -f styl markowy
Dodaj kod do preambuły dla wybranego stylu, który zastępuje standardowe oznaczenia i znaczniki
polecenia w elementach zmiennoprzecinkowych (np. uwagi marginalne powodują błąd w elementach zmiennoprzecinkowych, więc
w ten sposób można wyłączyć znakowanie brzeżne). Ta opcja definiuje wszystkie polecenia "\DIF...FL".
Dostępne style: "FLOATSAFE TRADITIONALSAFE IDENTICAL"

[Domyślnie: „FLOATSAFE”]

--kodowanie=enc or -e enc
Określ kodowanie starego.texu i nowego.texu. Typowe kodowania to „ascii”, „utf8”,
„łac.1”, „łac.9”. Listę dostępnych kodowań można uzyskać, wykonując

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

[Domyślne kodowanie to utf8, chyba że kilka pierwszych linijek preambuły zawiera
wywołanie "\usepackage[..]{inputenc}", w którym to przypadku kodowanie wybrane przez to
zakładane jest polecenie. Zauważ, że ASCII (standardowy lateks) jest podzbiorem utf8]

--preambuła=plik or -p filet
Wstaw plik na końcu preambuły zamiast generowania preambuły. Preambuła musi…
zdefiniuj następujące polecenia „\DIFaddbegin, \DIFaddend, \DIFadd{..},
\DIFdelbegin,\DIFdelend,\DIFdel{..}" i odmiany do użytku w pływakach
"\DIFaddbeginFL, \DIFaddendFL, \DIFaddFL{..}, \DIFdelbeginFL, \DIFdelendFL,
\DIFdelFL{..}" (Jeśli ta opcja jest ustawiona -t, -s, -f opcje są ignorowane.)

--pakiety=pkg1,pkg2,..
Poinformuj latexdiff, że plik .tex jest przetwarzany z załadowanymi pakietami z listy. To jest
zwykle nie jest to konieczne, jeśli plik .tex zawiera preambułę, ponieważ preambuła jest
automatycznie skanowane w poszukiwaniu poleceń „\usepackage”. Korzystanie z --pakiety opcja
wyłącza automatyczne skanowanie, więc jeśli z jakiegoś powodu konieczne jest parsowanie specyficzne dla pakietu
wyłączony, użyj --pakiety=brak. Następujące pakiety wywołują specjalne zachowanie:

„amsmat”
Zmienna konfiguracji MATHARRREPL jest ustawiona na „align*” (domyślnie: „eqnarray*”).
(Zauważ, że wiele środowisk macierzy amsmath jest już rozpoznawanych przez
domyślne jako takie)

„pływak końcowy”
Upewnij się, że „\begin{figure}” i „\end{figure}” zawsze wyświetlają się same
linia.

„hiperref”
Zmień nazwę poleceń „\DIFadd” i „\DIFdel” na „\DIFaddtex” i
„\DIFdeltex” i zdefiniuj nowe polecenia „\DIFadd” i „\DIFdel”, które zapewniają
wrapper dla tych poleceń, używając ich dla tekstu, ale nie dla linku
definiowanie polecenia (gdzie jakikolwiek znacznik spowodowałby błędy).

„apacyt”
Przedefiniuj polecenia rozpoznawane jako polecenia cytowania.

„sunitx”
Traktuj "\SI" jako równoważnik poleceń cytowania (tj. chroń za pomocą "\mbox" jeśli
styl znaczników używa pakietu ulem.

"sprytny"
Traktuj "\cref,\Cref" itp. jako równoważne z poleceniami cytowania (tj. chroń za pomocą
"\mbox", jeśli styl znaczników używa pakietu ulem.

„glosariusze”
Zdefiniuj większość poleceń glosariuszy jako bezpieczną, chroniąc je za pomocą \mbox'es
gdzie potrzebne

„mhchem”
Traktuj "\ce" jako bezpieczne polecenie, tzn. będzie podświetlone (zwróć uwagę, że "\cee"
nie będą wyróżnione w równaniach, ponieważ prowadzi to do błędów przetwarzania)

„chemformuła” lub „chemmakro”
Traktuj "\ch" jako bezpieczne polecenie poza równaniami, tzn. zostanie podświetlone
(zwróć uwagę, że „\ch” nie będzie wyróżnione w równaniach, ponieważ prowadzi to do
błędy przetwarzania)

[ Domyślnie: przeskanuj preambułę w poszukiwaniu poleceń „\usepackage”, aby określić
załadowane pakiety. ]

--pokaż preambułę
Drukuj wygenerowane lub dołączone polecenia preambuły na standardowe wyjście.

systemu
--exclude-safecmd=wyklucz-plik or -A wyklucz-plik or --exclude-safecmd="cmd1,cmd2,..."
--replace-safecmd=zamień-plik
--append-safecmd=dołącz-plik or -a dołącz-plik or --append-safecmd="cmd1,cmd2,..."
Wyklucz, zastąp lub dołącz do listy pasujących wyrażeń regularnych (RegEx)
polecenia, których można bezpiecznie używać w ramach polecenia „\DIFadd” lub „\DIFdel”.
Plik musi zawierać jeden Perl-RegEx w każdym wierszu (wiersze komentarza zaczynające się od # lub % są
ignorowane). Zauważ, że RegEx musi pasować do całego tokena, tj. /^regex$/
jest dorozumiana i że początkowy znak „\" polecenia nie jest uwzględniony. ten
--wyklucz bezpiecznecmd i --dołącz-safecmd opcje można łączyć z
---replace-safecmd opcja i mogą być używane wielokrotnie, aby dodawać je skumulowane do list.
--wyklucz bezpiecznecmd i --dołącz-safecmd może również przyjąć jako dane wejściowe listę oddzieloną przecinkami.
Jeśli wymagany jest przecinek dla jednego z wyrażeń regularnych, pomiń go w ten sposób „\,”. W większości przypadków to
będzie konieczne, aby chronić listę oddzieloną przecinkami od powłoki, umieszczając ją w
cudzysłów.

--exclude-textcmd=wyklucz-plik or -X wyklucz-plik or --exclude-textcmd="cmd1,cmd2,..."
--replace-textcmd=zamień-plik
--append-textcmd=dołącz-plik or -x dołącz-plik or --append-textcmd="cmd1,cmd2,..."
Wyklucz, zastąp lub dołącz do listy wyrażeń regularnych pasujących do poleceń
którego ostatnim argumentem jest tekst. Zobacz wpis dla --wyklucz bezpiecznecmd bezpośrednio nad dla
dalsze szczegóły.

--replace-context1cmd=zamień-plik
--append-context1cmd=dołącz-plik lub =pozycja --append-context1cmd="cmd1,cmd2,..."
Zastąp lub dołącz do listy poleceń pasujących do wyrażeń regularnych, których ostatnim argumentem jest tekst
ale które wymagają określonego kontekstu do działania, np. \caption będzie działać tylko w obrębie a
rysunek lub stół. Te polecenia zachowują się jak polecenia tekstowe, z wyjątkiem sytuacji, gdy występują w
usunięta sekcja, gdy są wyłączone, ale ich argument jest wyświetlany jako usunięty
tekst.

--replace-context2cmd=zamień-plik
--append-context2cmd=dołącz-plik lub =pozycja --append-context2cmd="cmd1,cmd2,..."
Jako odpowiednie polecenia dla context1. Jedyna różnica polega na tym, że polecenia context2
są całkowicie wyłączone w usuniętych sekcjach, łącznie z ich argumentami.

--exclude-mboxsafecmd=wyklucz-plik or --exclude-mboxsafecmd="cmd1,cmd2,..."
--append-mboxsafecmd=dołącz-plik or --append-mboxsafecmd="cmd1,cmd2,..."
Zdefiniuj bezpieczne polecenia, które dodatkowo muszą być chronione przez enkapsulację w
\\mbox{..}. Czasami jest to potrzebne, aby ominąć niezgodności między zewnętrznymi
pakiety i pakiet ulem, który służy do podświetlania w domyślnym stylu
UNDERLINE oraz CULINECHBAR CFONTSTRIKE

--konfig zm1=wart1,zm2=wart2,... or -c zm1=wart1,...
-c plik konfiguracyjny
Ustaw zmienne konfiguracyjne. Opcję można powtórzyć, aby ustawić różne zmienne
(jako alternatywa dla listy rozdzielanej przecinkami). Dostępne zmienne (patrz poniżej dla
dalsze wyjaśnienia):

„ARRENV” (wyrażenie regularne)

„COUNTERCMD” (regEx)

„FLOATENV” (regEx)

„ITEMCMD” (regEx)

„LISTENV” (regEx)

„MATHARRENV” (regEx)

„MATHARRREPL” (ciąg)

„MATHENV” (regEx)

„MATHREPL” (ciąg)

"MINWORDSBLOCK" (liczba całkowita)

„PICTUREENV” (RegEx)

--show-safecmd
Wydrukuj listę pasujących do RegEx i wykluczających bezpiecznych poleceń.

--pokaż tekstcmd
Wydrukuj listę pasujących i wykluczających RegEx poleceń z argumentem tekstowym.

--show-config
Pokaż wartości zmiennych konfiguracyjnych.

--Pokaż wszystko
Połącz wszystkie polecenia --show.

NB Dla wszystkich poleceń --show nie trzeba określać pliku „stary.tex” ani „nowy.tex” oraz
żadne różnicowanie nie ma miejsca.

Inne konfiguracja opcje:
--pozwól-spacje
Zezwalaj na spacje między argumentami w nawiasach lub w nawiasach klamrowych w poleceniach. Zauważ, że ta opcja
może mieć niepożądane skutki uboczne (niezwiązany zakres może zostać połączony z poprzednim
polecenia), więc powinno być używane tylko wtedy, gdy wartość domyślna daje błędne wyniki. (Domyślny
wymaga, aby argumenty następowały bezpośrednio po sobie bez spacji).

--math-znacznik=poziom
Określ szczegółowość znaczników w wyświetlanych środowiskach matematycznych: Możliwe wartości dla
poziom to (dopuszczalne są zarówno etykiety numeryczne, jak i tekstowe):

"off" lub 0: pomiń znaczniki dla środowisk matematycznych. Usunięte równania nie pojawią się
w pliku diff. Ten tryb może być użyty, jeśli wszystkie inne tryby powodują nieprawidłowy kod lateksowy.

„całość” lub 1: Różnicowanie na poziomie całych równań. Nawet trywialne zmiany w
równania powodują zmianę oznaczenia całego równania. Ten tryb może być używany, jeśli
przetwarzanie w trybie zgrubnym lub dokładnym skutkuje nieprawidłowym kodem lateksowym.

„zgrubny” lub 2: wykrywa zmiany w równaniach oznaczonych zgrubną ziarnistością;
zmiany w typie równania (np. displaymath do równania) pojawiają się jako zmiana w
pełne równanie. Ten tryb jest zalecany w sytuacjach, w których zawartość i porządek
niektórych równań wciąż się zmienia. [Domyślny]

„dokładnie” lub 3: wykrywaj niewielkie zmiany w równaniach i zaznaczaj z drobną ziarnistością. Ten
tryb jest najbardziej odpowiedni, jeśli oczekuje się tylko niewielkich zmian w równaniach, np.
korekta literówek.

--wyłącz-znacznik-cytatów or --wyłącz-auto-mbox
Pomiń znaczniki cytowań i inne podatne polecenia w stylach za pomocą ulem
(UNDERLINE,FONTSTRIKE,CULINECHBAR) (dwie opcje są identyczne i są po prostu
skróty)

--włącz-znacznik-cytatów or --enforce-auto-mbox
Chroń polecenia cytowania i inne wrażliwe polecenia w zmienionych sekcjach za pomocą
polecenie "\mbox", tzn. użyj domyślnego zachowania pakietu ulem dla innych pakietów (
dwie opcje są identyczne i są po prostu aliasami)

Różne
--gadatliwy or -V
Wysyła różne informacje o stanie do stderr podczas przetwarzania. Domyślnie działa
bezgłośnie.

--sterownik=typ
Wybierz sterownik dla pakietu zmian (dotyczy tylko stylów używających
changebar: CCHANGEBAR CFONTCHBAR CULINECHBAR CHANGEBAR). Możliwe sterowniki to
wymienione w instrukcji paska zmian, np. pdftex, dvips, dvitops
[Domyślnie: dvips]

--ignoruj-ostrzeżenia
Pomiń ostrzeżenia o niespójności długości między ciągami wejściowymi i przeanalizowanymi oraz
brakujące znaki. Te komunikaty ostrzegawcze są często związane z niestandardowym lateksem lub
konstrukcje lateksowe o składni nieznanej dla „latexdiff”, ale wynikająca z tego różnica
argument i tak często jest w pełni funkcjonalny, zwłaszcza jeśli tylko niestandardowy lateks
występuje w niezmienionych częściach tekstu.

--etykieta=etykieta or -L etykieta
Ustawia etykiety używane do opisu starych i nowych plików. Pierwsze użycie tej opcji
ustawia etykietę opisującą stary plik, a drugie użycie opcji ustawia etykietę
dla nowego pliku, tj. ustaw obie etykiety w taki sposób "-L etykietastara -L etykietanowa". [Domyślny:
użyj nazwy pliku i dat modyfikacji dla etykiety]

--bez etykiety
Pomiń dołączanie starych i nowych nazw plików jako komentarza w pliku wyjściowym

--widoczna-etykieta
Dołącz stare i nowe nazwy plików (lub etykiety ustawione za pomocą opcji "--label") jako widoczne wyjście.

--spłaszczyć
Zastąp polecenia „\input” i „\include” w treści zawartością plików w
ich argument. Jeśli w preambule występuje „\includeonly”, tylko te pliki są
rozwinięty w dokumencie. Jednak rekursja nie jest wykonywana, tj. "\input" i
Polecenia „\include” w zawartych sekcjach nie są rozwijane. Dołączone pliki są
zakłada się, że
znajdować się w tych samych katalogach, co odpowiednio stare i nowe pliki główne,
umożliwiając organizowanie plików w stare i nowe katalogi. --spłaszcz to
stosowane rekursywnie, więc wprowadzane pliki mogą zawierać dalsze instrukcje „\input”.

Użycie tej opcji może skutkować zbyt dużymi czasami przetwarzania większych dokumentów,
a wynikowy dokument różnicy nie odzwierciedla już struktury danych wejściowych
dokumentów.

--help or -h
Pokaż tekst pomocy

--wersja
Pokaż numer wersji

Predefiniowane style
Major typy
Główny typ określa znaczniki zwykłego tekstu i niektóre wybrane polecenia lateksowe na zewnątrz
pływa przez zdefiniowanie poleceń znaczników "\DIFadd{...}" i "\DIFdel{...}" .

"PODKREŚLAĆ"
Dodany tekst jest falisty, podkreślony i niebieski, odrzucony tekst jest przekreślony i czerwony
(Wymaga pakietów kolorów i ulem). Overstrking nie działa w wyświetlanym
równania matematyczne takie, że usunięte części równania są podkreślone, a nie przekreślone
out (jest to wada związana z pakietem ulem).

„TRADYCYJNY”
Dodany tekst jest niebieski i jest bezszeryfowy, a dla każdego tworzony jest czerwony przypis
wyrzucony fragment tekstu. (Wymaga pakietu kolorów)

"TRADYCYJNY"
Jak „TRADYCYJNY”, ale bez użycia koloru.

„CFONT” Dodany tekst jest niebieski i bezszeryfowy, a odrzucony tekst jest czerwony i bardzo
mały rozmiar.

„CZCIONKĘ”
Dodany tekst jest ustawiony bezszeryfowo, odrzucony tekst jest mały i przekreślony

„PASEK ZMIANY”
Dodany tekst jest niebieski, a odrzucony jest czerwony. Dodatkowo zmieniony tekst
jest oznaczony paskiem na marginesie (Wymaga pakietów kolorów i pasków wymiany).

„CFONTCHBAR”
Jak „CFONT”, ale z dodatkowymi paskami zmiany (wymaga koloru i paska zmian
pakiety).

„Kulineczbar”
Jak „UNDERLINE”, ale z dodatkowymi paskami zmiany (wymaga koloru, ulem i
pakiety zmiany biegów).

„PASEK ZMIANY”
Bez znaczników tekstu, ale zaznacz marginesy paskami zmian (wymaga paska zmian
pakiet).

"NIEWIDZIALNY"
Brak widocznych znaczników (ale ogólne polecenia znaczników będą nadal wstawiane.

„BOLD” Dodany tekst jest pogrubiony, odrzucony nie jest pokazywany.

Podtypy
Podtyp definiuje polecenia, które są wstawiane na początku i na końcu dodanego lub
odrzucone bloki, niezależnie od tego, czy te bloki zawierają tekst czy polecenia (Definicja
polecenia: "\DIFaddbegin, \DIFaddend, \DIFdelbegin, \DIFdelend")

„BEZPIECZNY” Brak dodatkowych znaczników (zalecany wybór)

„MARGIN” Zaznacz początek i koniec zmienionych bloków symbolami na marginesie obok
(za pomocą standardowego polecenia "\marginpar" - zauważ, że czasami się to porusza
nieco od zamierzonej pozycji.

"KOLOR" Alternatywny sposób oznaczania dodanych fragmentów na niebiesko, a usuniętych na czerwono.
(Zaleca się używanie zamiast głównych typów do tworzenia kolorowych znaczników,
chociaż w niektórych przypadkach kolorowanie za pomocą dvipscol może być pełniejsze, na przykład
z poleceniami cytowania).

„DVIPSCOL”
Alternatywny sposób oznaczania dodanych fragmentów na niebiesko, a usuniętych na czerwono.
Zauważ, że "DVIPSCOL" działa tylko z konwerterem dvips, np. nie pdflatex.
(zaleca się używanie zamiast głównych typów do wykonania kolorowych znaczników,
chociaż w niektórych przypadkach kolorowanie za pomocą dvipscol może być pełniejsze).

„ZLABEL” może służyć do podświetlania tylko zmienionych stron, ale wymaga przetwarzania końcowego. To jest
Zalecam, aby nie wywoływać tej opcji ręcznie, ale używać "latexdiff-vc" z
Opcja „--tylko-zmiany”. Alternatywnie użyj skryptu podanego w preambule do
pliki diff utworzone przy użyciu tego stylu.

"TYLKOZMIENIONA STRONA"
podkreśla również zmienione strony, bez potrzeby przetwarzania końcowego, ale może
nie działa niezawodnie, jeśli jest pływający materiał (rysunki, tabele).

„LABEL” jest podobny do „ZLABEL”, ale nie wymaga pakietu zref i działa mniej
niezawodnie (przestarzałe).

pływak rodzaje
Niektóre znaczniki użyte w tekście głównym mogą powodować problemy, gdy są używane w pływakach
(np. ryciny lub tabele). Z tego powodu alternatywne wersje wszystkich poleceń znaczników to
używane w pływakach. Typ float definiuje te alternatywne polecenia.

"BEZPIECZNY PŁYWAJĄCY"
Użyj identycznych znaczników dla tekstu, jak w treści głównej, ale ustaw zaznaczanie wszystkich poleceń
początek i koniec zmienionych bloków na polecenia null. Musisz to wybrać
typ zmiennoprzecinkowy, jeśli Twój podtyp to „MARGIN”, ponieważ „\marginpar” nie działa poprawnie
w pływakach.

„TRADYCYJNY BEZPIECZNY”
Uzupełnij w taki sam sposób, jak w tekście głównym. Usunięte środowiska są
oznaczone nawiasami kątowymi \[ i \], a usunięty tekst jest ustawiany w skrypcie
rozmiar. Ten typ zmiennoprzecinkowy powinien być zawsze używany z „TRADYCYJNYM” i
Typy znaczników „TRADYCYJNE”, ponieważ polecenie \footnote nie działa poprawnie w
pływające środowiska.

"IDENTYCZNY"
Nie ma różnicy między tekstem głównym a pływakami.

systemu Zmienne
„ARRENV” Jeśli dopasowanie do „ARRENV” zostanie znalezione we wbudowanym środowisku matematycznym w obrębie
usunięty lub dodany blok, wtedy wbudowana matematyka jest otoczona przez "\mbox{"..."}".
Jest to konieczne, ponieważ podkreślenie nie działa w tablicy śródliniowej
środowisk.

[ Domyślnie: "ARRENV"="(?:array|[pbvBV]macierz)"

„PRZECIWPOMP”
Jeśli pasuje polecenie w usuniętym bloku, który znajduje się również na liście textcmd
„COUNTERCMD”, a następnie dodatkowe polecenie „\addtocounter{”cntcmd„}{-1}”, gdzie
cntcmd jest pasującym poleceniem, jest dodawane do pliku diff tak, że
numeracja w pliku diff pozostaje zsynchronizowana z numeracją w nowym
plik.

[ Domyślnie: "COUNTERCMD"="(?:footnote|part|section|subsection" ...

"|podpunkt|akapit|podpunkt)" ]

"PŁYWAJĄCY"
Środowiska, których nazwa odpowiada wyrażeniu regularnemu w „FLOATENV”, to
uważane za pływaki. W tych środowiskach lateksdiff polecenia znaczników są
zastąpione przez ich odmiany FL.

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

"ITEMCMD" Polecenia reprezentujące nową linię pozycji ze środowiskami list.

[Domyślnie: \"pozycja" ]

"LISTENV" Środowiska, których nazwa odpowiada wyrażeniu regularnemu w "LISTENV" to list
środowisk.

[ Domyślnie: "(?:itemize|enumerate|opis)" ]

„MATHENV”, „MATHREPL”
Jeśli zarówno \begin, jak i \end dla środowiska matematycznego (dopasowanie nazwy środowiska
„MATHENV” lub \[ i \]) znajdują się w tym samym usuniętym bloku, są zastępowane przez
komendy \begin i \end dla "MATHREPL" zamiast komentowania.

[ Domyślnie: "MATHENV"="(?:displaymath|equation)" , "MATHREPL"="displaymath" ]

„MATHARRENV”, „MATHARRREPL”
jako „MATHENV”, „MATHREPL”, ale dla tablic równań

[ Domyślnie: "MATHARRENV"="eqnarray\*?" , "MATHREPL"="eqnarray" ]

"MINSŁOWA BLOK"
Minimalna liczba tokenów wymagana do utworzenia niezależnego bloku. Ta wartość to
używany w algorytmie do wykrywania zmian w całych blokach poprzez łączenie identycznych
części tekstowe mniejsze niż "MINWORDSBLOCK" do poprzedniego dodane i odrzucone
części.

[Domyślnie: 3 ]

"OBRAZENV"
W środowiskach, których nazwa odpowiada wyrażeniu regularnemu w „PICTUREENV”
wszystkie znaczniki latexdiff są usuwane (w przypadkach patologicznych może to prowadzić do:
niespójne znaczniki, ale taka sytuacja powinna być rzadka).

[ Domyślnie: "(?:obraz|DIFnoznacznik)[\w\d*@]*" ]

WSPÓLNY PROBLEMY ROLNICZE FAQ

Cytaty powodują przepełnienie pudełek
Istnieje niezgodność między pakietem „ulem”, którego używa „latexdiff”
za podkreślenie i wykreślenie w stylu UNDERLINE, domyślnym stylu oraz
sposób generowania cytatów. Aby móc oznaczać cytaty
prawidłowo, są one ujęte w poleceniu „\mbox”. Ponieważ mboxy nie mogą być zepsute
w poprzek linii, ta procedura często skutkuje przepełnieniem pudełek, prawdopodobnie
zasłanianie treści, która wykracza poza prawy margines. To samo dzieje się
dla niektórych innych pakietów (np. siunitx). Jeśli to jest problem, masz dwa
możliwości.

1. Użyj znacznika typu „CFONT” (opcja „-t CFONT”): Jeśli wybrano ten znacznik, to
zmienione cytaty nie są już oznaczane linią falistą (dodatki) lub
przekreślone (skreślenia), ale nadal wyróżnione odpowiednim kolorem, oraz
usunięty tekst jest wyświetlany inną czcionką. Inne style nie używające „ulem”
pakiet również zadziała.

2. Wybierz opcję „--disable-citation-markup”, która wyłącza znaczniki
cytaty: usunięte cytaty nie są już wyświetlane, a dodane cytaty są wyświetlane
bez znaczników. (Było to domyślne zachowanie latexdiff w wersjach 0.6 i
starszy)

W przypadku pakietów niestandardowych możesz zdefiniować polecenia, które mają być chronione przez
"\mbox" z opcjami "--append-mboxsafecmd" i "--excludemboxsafecmd" (prześlij
Twoje listy poleceń jako żądanie funkcji na stronie github, aby ustawić domyślne
zachowanie przyszłych wersji, patrz rozdział 6)

Zmiany w skomplikowanych równaniach matematycznych powodują błędy przetwarzania lateksu
Wypróbuj opcje „--math-markup=całość”. Jeśli nawet to się nie powiedzie, możesz wyłączyć mark
dla równań z „--math-markup=off”.

Jak mogę po prostu pokazać strony, na których dokonano zmian?
Użyj opcji -"-s ZLABEL" (wymagane przetwarzanie końcowe) lub "-s
ONLYCHANGEDPAGE”. „latexdiff-vc --ps|--pdf” z opcją „--only-changes” trwa
opieka nad przetwarzaniem końcowym (wymaga zainstalowania pakietu zref).

Korzystaj z latexdiff online za pomocą usług onworks.net