latexdiff - Online di Cloud

PROGRAM:

NAMA

latexdiff - menentukan dan menandai perbedaan antara dua file lateks

RINGKASAN

lateksdiff [ PILIHAN ] lama.tex baru.tex > diff.tex

DESKRIPSI

Secara singkat, lateksdiff adalah program utilitas untuk membantu dalam pengelolaan revisi lateks
dokumen. Ini membandingkan dua file lateks yang valid, di sini disebut "old.tex" dan "new.tex", temukan
perbedaan signifikan di antara mereka (yaitu, mengabaikan jumlah spasi putih dan
posisi jeda baris), dan menambahkan perintah khusus untuk menyoroti perbedaannya. Di mana
penyorotan visual tidak dimungkinkan, misalnya untuk perubahan format, perbedaan
tetap ditandai di sumbernya.

Program memperlakukan pembukaan berbeda dari dokumen utama. Perbedaan antara
pembukaan ditemukan menggunakan pembedaan berbasis garis (mirip dengan perintah Unix diff,
tetapi mengabaikan spasi). Sebuah komentar, ""%DIF >"" ditambahkan ke setiap baris yang ditambahkan, yaitu a
baris hadir di "new.tex" tetapi tidak di "old.tex". Garis yang dibuang
dinonaktifkan dengan menambahkan ""%DIF <"". Blok yang diubah didahului oleh baris komentar
memberikan informasi tentang nomor baris dalam file asli. Dimana ada?
perbedaan tidak signifikan, file yang dihasilkan "diff.tex" akan mirip dengan "new.tex". Pada
akhir pembukaan, definisi untuk lateksdiff perintah markup dimasukkan. Di dalam
membedakan tubuh utama teks, lateksdiff mencoba untuk memenuhi berikut:
pedoman (dalam urutan prioritas):

1. Jika "old.tex" dan "new.tex" keduanya adalah LaTeX yang valid, maka "diff.tex" yang dihasilkan seharusnya
juga berlaku LateX. (NB Jika beberapa perintah TeX biasa digunakan dalam "old.tex" atau
"new.tex" lalu "diff.tex" tidak dijamin berfungsi tetapi biasanya akan berhasil).

2. Perbedaan signifikan ditentukan pada tingkat kata individu. Semua
perbedaan yang signifikan, termasuk perbedaan antara komentar harus jelas
ditandai dalam kode sumber yang dihasilkan "diff.tex".

3. Jika bagian yang diubah berisi teks atau perintah penghasil teks, maka jalankan "diff.tex"
melalui LateX harus menghasilkan output di mana bagian yang ditambahkan dan yang dibuang disorot.

4. Apabila terdapat perbedaan yang tidak signifikan, misalnya dalam penempatan jeda baris,
"diff.tex" harus mengikuti format "new.tex"

Untuk membedakan algoritma yang sama dengan diff digunakan tetapi kata-kata alih-alih garis adalah
dibandingkan. Upaya dilakukan untuk mengenali blok yang benar-benar berubah sedemikian rupa sehingga
mereka dapat ditandai sebagai satu kesatuan. Komentar berbeda baris demi baris tetapi jumlah
spasi dalam komentar diabaikan. Perintah termasuk semua argumen mereka umumnya
dibandingkan sebagai satu unit, yaitu, tidak ada mark-up yang dimasukkan ke dalam argumen perintah.
Namun, untuk sejumlah perintah yang dipilih (misalnya, "\caption" dan semua bagian
perintah) argumen terakhir dikenal sebagai teks. Teks ini dibagi menjadi kata-kata dan
dibedakan seperti teks biasa (gunakan opsi untuk menampilkan dan mengubah daftar teks
perintah, lihat di bawah). Karena algoritme tidak memiliki pengetahuan rinci tentang LaTeX, ia mengasumsikan semua:
pasang kurung kurawal segera setelah perintah (yaitu urutan huruf
dimulai dengan garis miring terbalik) adalah argumen untuk perintah itu. Sebagai batasan kondisi
1 di atas dengan demikian perlu untuk mengelilingi semua argumen dengan kurung kurawal, dan untuk tidak
menyisipkan ruang asing. Misalnya, tulis

\section{\textem{Ini adalah judul bagian yang ditekankan}}

dan tidak

\section {\textem{Ini adalah judul bagian yang ditekankan}}

or

\section\textem{Ini adalah judul bagian yang ditekankan}

meskipun semua varietas sama dengan LaTeX (tapi lihat --izinkan-spasi pilihan yang
memungkinkan varietas kedua).

Untuk lingkungan yang isinya tidak sesuai dengan standar LaTeX atau di mana grafis
markup tidak masuk akal semua perintah markup dapat dihapus dengan mengatur PICTUREENV
variabel konfigurasi, diatur secara default ke lingkungan "gambar" dan "DIFnomarkup"; Lihat
--konfigurasi pilihan). Lingkungan terakhir ("DIFnomarkup") dapat digunakan untuk melindungi bagian dari
file lateks di mana markup menghasilkan markup ilegal. Anda harus mengelilingi
menyinggung bagian di file lama dan baru dengan "\begin{DIFnomarkup}" dan
"\end{DIFnomarkup}". Anda harus mendefinisikan lingkungan dalam pembukaan baik yang lama maupun yang baru
dokumen. Saya lebih suka mendefinisikannya sebagai lingkungan nol,

"\newenvironment{DIFnomarkup}{}{}"

tapi pilihan ada di tanganmu. Setiap markup dalam lingkungan akan dihapus, dan umumnya
segala sesuatu di dalam lingkungan hanya akan diambil dari file baru.

Dimungkinkan juga untuk membedakan file yang tidak memiliki pembukaan.
Dalam hal ini, file diproses dalam mode dokumen utama, tetapi definisi dari
perintah markup tidak dimasukkan.

Semua perintah markup dimasukkan oleh lateksdiff mulai dengan ""\DIF"". Menambahkan blok yang mengandung
kata-kata, perintah atau komentar yang ada di "new.tex" tetapi tidak di "old.tex" ditandai dengan
"\DIFaddbegin" dan "\DIFaddend". Blok yang dibuang ditandai dengan "\DIFdelbegin" dan
"\DIFdelend". Di dalam blok yang ditambahkan, semua teks disorot dengan "\DIFadd" seperti ini:
"\DIFadd{Added text block}" Perintah `aman' yang dipilih dapat dimuat dalam blok teks ini
juga (gunakan opsi untuk menampilkan dan mengubah daftar perintah aman, lihat di bawah). Semua lainnya
perintah serta tanda kurung kurawal "{" dan "}" tidak pernah dimasukkan ke dalam lingkup "\DIFadd". Ditambahkan
komentar ditandai dengan menambahkan ""%DIF > "".

Di dalam blok yang dihapus, teks disorot dengan "\DIFdel". Komentar yang dihapus ditandai dengan
awalan ""%DIF < "". Perintah yang tidak aman dan kurung kurawal dalam blok yang dihapus adalah
berkomentar dengan ""%DIFDELCMD < "".

PILIHAN

Pembukaan
Opsi berikut menentukan gaya markup visual dengan menambahkan perintah yang sesuai
definisi pembukaan. Lihat akhir bagian ini untuk deskripsi yang tersedia
gaya.

--type=gaya markup or -t gaya markup
Tambahkan kode ke pembukaan untuk gaya markup yang dipilih. Opsi ini mendefinisikan "\DIFadd" dan
perintah "\DIFdel". gaya yang tersedia:

"Garisbawahi CFONT TRADITIONAL TRADISIONAL FONTSTRIKE CHANGEBAR TAK TERLIHAT
CULINECHBAR CFONTCBHBAR BOLD"

[ Bawaan: "GARIS BAWAH" ]

--subtipe=gaya tanda or -s gaya tanda
Tambahkan kode ke pembukaan untuk gaya yang dipilih untuk perintah kurung (misalnya untuk menandai perubahan
dalam margin). Opsi ini mendefinisikan "\DIFaddbegin", "\DIFaddend", "\DIFdelbegin" dan
Perintah "\DIFdelend". Gaya yang tersedia: "WARNA MARGIN AMAN DVIPSCOL ZLABEL
HANYA BERUBAH HALAMAN (LABEL)*"

[ Default: "AMAN" ] * Subtipe "LABEL" tidak digunakan lagi

--floattype=gaya tanda or -f gaya tanda
Tambahkan kode ke pembukaan untuk gaya yang dipilih yang menggantikan penandaan dan markup standar
perintah di dalam float (misalnya, komentar marginal menyebabkan kesalahan di dalam float, jadi
penandaan marjinal dapat dinonaktifkan dengan demikian). Opsi ini mendefinisikan semua perintah "\DIF...FL".
Gaya yang tersedia: "FLOATSAFE TRADITIONALSAFE IDENTICAL"

[ Bawaan: "FLOATSAFE" ]

--pengkodean=enc or -e enc
Tentukan pengkodean old.tex dan new.tex. Pengkodean tipikal adalah "ascii", "utf8",
"latin1", "latin9". Daftar pengkodean yang tersedia dapat diperoleh dengan mengeksekusi

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

[Pengkodean default adalah utf8 kecuali beberapa baris pertama dari pembukaan berisi
doa "\usepackage[..]{inputenc}" dalam hal ini pengkodean dipilih oleh ini
perintah diasumsikan. Perhatikan bahwa ASCII (lateks standar) adalah bagian dari utf8]

--pembukaan=file or -p fillet
Sisipkan file di akhir pembukaan alih-alih menghasilkan pembukaan. Pembukaan harus
tentukan perintah berikut "\DIFaddbegin, \DIFaddend, \DIFadd{..},
\DIFdelbegin,\DIFdelend,\DIFdel{..}," dan varietas untuk digunakan dalam pelampung
"\DIFaddbeginFL, \DIFaddendFL, \DIFaddFL{..}, \DIFdelbeginFL, \DIFdelendFL,
\DIFdelFL{..}" (Jika opsi ini disetel -t, -s, dan -f pilihan diabaikan.)

--paket=pkg1,pkg2,..
Beri tahu latexdiff bahwa file .tex diproses dengan paket-paket dalam daftar yang dimuat. Ini adalah
biasanya tidak diperlukan jika file .tex menyertakan pembukaan, karena pembukaannya adalah
secara otomatis memindai perintah "\usepackage". Penggunaan --paket Option
menonaktifkan pemindaian otomatis, jadi jika karena alasan apa pun penguraian paket tertentu perlu dilakukan
dimatikan, gunakan --paket=tidak ada. Paket berikut memicu perilaku khusus:

"amsmath"
Variabel konfigurasi MATHARRREPL diatur ke "align*" (Default: "eqnarray*").
(Perhatikan bahwa banyak lingkungan array amsmath sudah dikenali oleh
default seperti itu)

"endfloat"
Pastikan "\begin{figure}" dan "\end{figure}" selalu muncul sendiri di
sebuah garis.

"hiperref"
Ubah nama perintah "\DIFadd" dan "\DIFdel" menjadi "\DIFaddtex" dan
"\DIFdeltex" dan tentukan perintah "\DIFadd" dan "\DIFdel" baru, yang menyediakan
pembungkus untuk perintah-perintah ini, menggunakannya untuk teks tetapi tidak untuk tautan
mendefinisikan perintah (di mana setiap markup akan menyebabkan kesalahan).

"apasit"
Mendefinisikan ulang perintah yang dikenali sebagai perintah kutipan.

"siunitx"
Perlakukan "\SI" sebagai setara dengan perintah kutipan (yaitu lindungi dengan "\mbox" jika
gaya markup menggunakan paket ulem.

"pintar"
Perlakukan "\cref,\Cref", dll sebagai setara dengan perintah kutipan (yaitu melindungi dengan
"\mbox" jika gaya markup menggunakan paket ulem.

"glosarium"
Tetapkan sebagian besar perintah glosarium sebagai aman, lindungi dengan \mbox'es
di mana dibutuhkan

"mhchem"
Perlakukan "\ce" sebagai perintah yang aman, yaitu akan disorot (perhatikan bahwa "\cee"
tidak akan disorot dalam persamaan karena ini menyebabkan kesalahan pemrosesan)

"chemformula" atau "chemmacro"
Perlakukan "\ch" sebagai perintah yang aman di luar persamaan, yaitu akan disorot
(perhatikan bahwa "\ch" tidak akan disorot dalam persamaan karena ini mengarah ke
kesalahan pemrosesan)

[ Default: pindai pembukaan untuk perintah "\usepackage" untuk menentukan
paket yang dimuat. ]

--show-pembukaan
Cetak perintah pembukaan yang dibuat atau disertakan ke stdout.

konfigurasi
--exclude-safecmd=file-kecualikan or -A mengecualikan-file or --exclude-safecmd="cmd1,cmd2,..."
--replace-safecmd=ganti-file
--append-safecmd=tambahkan-file or -a tambahkan file or --append-safecmd="cmd1,cmd2,..."
Kecualikan dari, ganti, atau tambahkan ke daftar pencocokan ekspresi reguler (RegEx)
perintah yang aman digunakan dalam lingkup perintah "\DIFadd" atau "\DIFdel".
File harus berisi satu Perl-RegEx per baris (Baris komentar dimulai dengan # atau % are
diabaikan). Perhatikan bahwa RegEx harus cocok dengan seluruh token, yaitu /^regex$/
tersirat dan bahwa "\" awal dari perintah tidak disertakan. NS
--kecualikan-safecmd dan --tambahkan-safecmd pilihan dapat dikombinasikan dengan
---ganti-safecmd opsi dan dapat digunakan berulang kali untuk menambahkan secara kumulatif ke daftar.
--kecualikan-safecmd dan --tambahkan-safecmd juga dapat mengambil daftar yang dipisahkan koma sebagai input.
Jika koma untuk salah satu regex diperlukan, keluarkan "\,". Dalam kebanyakan kasus itu
akan diperlukan untuk melindungi daftar yang dipisahkan koma dari shell dengan memasukkannya
tanda kutip.

--exclude-textcmd=file-kecualikan or -X mengecualikan-file or --exclude-textcmd="cmd1,cmd2,..."
--replace-textcmd=ganti-file
--append-textcmd=tambahkan-file or -x tambahkan file or --append-textcmd="cmd1,cmd2,..."
Kecualikan dari, ganti, atau tambahkan ke daftar perintah pencocokan ekspresi reguler
yang argumen terakhirnya adalah teks. Lihat entri untuk --kecualikan-safecmd tepat di atas untuk
keterangan lebih lanjut.

--replace-context1cmd=ganti-file
--append-context1cmd=tambahkan-file atau = barang --append-context1cmd="cmd1,cmd2,..."
Ganti atau tambahkan ke daftar perintah pencocokan regex yang argumen terakhirnya adalah teks
tetapi yang memerlukan konteks tertentu untuk bekerja, misalnya \caption hanya akan bekerja dalam a
gambar atau tabel. Perintah ini berperilaku seperti perintah teks, kecuali jika muncul di
bagian yang dihapus, ketika dinonaktifkan, tetapi argumennya ditampilkan sebagai dihapus
teks.

--replace-context2cmd=ganti-file
--append-context2cmd=tambahkan-file atau = barang --append-context2cmd="cmd1,cmd2,..."
Sebagai perintah yang sesuai untuk context1. Satu-satunya perbedaan adalah bahwa perintah konteks2
sepenuhnya dinonaktifkan di bagian yang dihapus, termasuk argumennya.

--exclude-mboxsafecmd=file-kecualikan or --exclude-mboxsafecmd="cmd1,cmd2,..."
--append-mboxsafecmd=tambahkan-file or --append-mboxsafecmd="cmd1,cmd2,..."
Tetapkan perintah aman, yang juga perlu dilindungi dengan mengenkapsulasi dalam sebuah
\\mbox{..}. Ini terkadang diperlukan untuk mengatasi ketidakcocokan antara eksternal
paket dan paket ulem, yang digunakan untuk menyorot dalam gaya default
UNDERLINE serta CULINECHBAR CFONTSTRIKE

--konfigurasi var1=val1,var2=val2,... or -c var1=val1,..
-c file konfigurasi
Tetapkan variabel konfigurasi. Opsi dapat diulang untuk mengatur variabel yang berbeda
(sebagai alternatif dari daftar yang dipisahkan koma). Variabel yang tersedia (lihat di bawah untuk
penjelasan lebih lanjut):

"ARRENV" (RegEx)

"COUNTERCMD" (RegEx)

"FLOATENV" (RegEx)

"ITEMCMD" (RegEx)

"DENGARKAN" (RegEx)

"MATHARRENV" (RegEx)

"MATHARRREPL" (Dawai)

"MATHENV" (RegEx)

"MATHREPL" (String)

"MINWORDSBLOK" (bilangan bulat)

"PICTUREENV" (RegEx)

--tunjukkan-safecmd
Cetak daftar pencocokan RegEx dan tidak termasuk perintah aman.

--tampilkan-tekscmd
Cetak daftar perintah RegEx yang cocok dan tidak termasuk dengan argumen teks.

--tampilkan-config
Tampilkan nilai variabel konfigurasi.

--tunjukkan semua
Gabungkan semua --show perintah.

NB Untuk semua perintah --show, tidak ada file "old.tex" atau "new.tex" yang perlu ditentukan, dan
tidak terjadi perbedaan.

Lainnya konfigurasi pilihan:
--izinkan-spasi
Izinkan spasi antara argumen kurung atau kurung untuk perintah. Perhatikan bahwa opsi ini
mungkin memiliki efek samping yang tidak diinginkan (cakupan yang tidak terkait mungkin disamakan dengan sebelumnya
perintah) jadi hanya boleh digunakan jika default menghasilkan hasil yang salah. (Bawaan
membutuhkan argumen untuk langsung mengikuti satu sama lain tanpa mengintervensi spasi).

--math-markup=tingkat
Tentukan perincian markup di lingkungan matematika yang ditampilkan: Nilai yang mungkin untuk
level adalah (label numerik dan teks dapat diterima):

"off" atau 0: menekan markup untuk lingkungan matematika. Persamaan yang dihapus tidak akan muncul
dalam file diff. Mode ini dapat digunakan jika semua mode lainnya menyebabkan kode lateks tidak valid.

"keseluruhan" atau 1: Perbedaan pada tingkat persamaan keseluruhan. Bahkan perubahan sepele menjadi
persamaan menyebabkan seluruh persamaan ditandai berubah. Mode ini dapat digunakan jika
pemrosesan dalam mode kasar atau halus menghasilkan kode lateks yang tidak valid.

"kasar" atau 2: Mendeteksi perubahan dalam persamaan yang ditandai dengan perincian kasar;
perubahan jenis persamaan (misalnya tampilan ke persamaan) muncul sebagai perubahan pada
persamaan lengkap. Mode ini direkomendasikan untuk situasi di mana konten dan pesanan
beberapa persamaan masih diubah. [Bawaan]

"baik" atau 3: Deteksi perubahan kecil dalam persamaan dan tandai dengan perincian halus. Ini
mode paling cocok, jika hanya perubahan kecil pada persamaan yang diharapkan, mis
koreksi kesalahan ketik.

--nonaktifkan-kutipan-markup or --nonaktifkan-auto-mbox
Menekan markup kutipan dan markup perintah rentan lainnya dalam gaya menggunakan ulem
(UNDERLINE,FONTSTRIKE, CULINECHBAR) (dua opsi itu identik dan sederhana
alias)

--aktifkan-kutipan-markup or --menerapkan-auto-mbox
Lindungi perintah kutipan dan perintah rentan lainnya di bagian yang diubah dengan
Perintah "\mbox", yaitu menggunakan perilaku default untuk paket ulem untuk paket lain (the
dua opsi identik dan hanya alias)

bermacam-macam
--bertele-tele or -V
Keluarkan berbagai informasi status ke stderr selama pemrosesan. Defaultnya adalah bekerja
diam-diam.

--driver=ketik
Pilih driver untuk paket changebar (hanya relevan untuk gaya yang menggunakan
changebar: CCHANGEBAR CFONTCHBAR CULINECHBAR CHANGEBAR). Kemungkinan pengemudi adalah:
tercantum dalam manual changebar, misalnya pdftex,dvips,dvitops
[Awal: dvips]

--abaikan-peringatan
Menekan peringatan tentang inkonsistensi panjang antara input dan string yang diuraikan dan
karakter yang hilang. Pesan peringatan ini sering dikaitkan dengan lateks non-standar atau
konstruksi lateks dengan sintaks yang tidak diketahui "latexdiff" tetapi perbedaan yang dihasilkan
argumen seringkali berfungsi penuh, terutama jika lateks non-standar saja
terjadi pada bagian teks yang tidak berubah.

--label=label or -L label
Menyetel label yang digunakan untuk mendeskripsikan file lama dan baru. Penggunaan pertama dari opsi ini
mengatur label yang menjelaskan file lama dan penggunaan opsi yang kedua mengatur label
untuk file baru, yaitu atur kedua label seperti ini "-L labelold -L labelnew". [Bawaan:
gunakan nama file dan tanggal modifikasi untuk label]

--tanpa label
Menekan penyertaan nama file lama dan baru sebagai komentar dalam file output

--terlihat-label
Sertakan nama file lama dan baru (atau label yang disetel dengan opsi "--label") sebagai keluaran yang terlihat.

--meratakan
Ganti perintah "\input" dan "\include" di dalam badan dengan konten file di
argumen mereka. Jika "\includeonly" ada di pembukaan, hanya file-file itu yang
diperluas ke dalam dokumen. Namun, tidak ada rekursi yang dilakukan, yaitu "\input" dan
Perintah "\include" di dalam bagian yang disertakan tidak diperluas. File yang disertakan adalah
diasumsikan
ditempatkan di direktori yang sama dengan file master lama dan baru, masing-masing,
memungkinkan untuk mengatur file ke dalam direktori lama dan baru. --ratakan adalah
diterapkan secara rekursif, sehingga file yang dimasukkan dapat berisi pernyataan "\input" lebih lanjut.

Penggunaan opsi ini dapat mengakibatkan waktu pemrosesan yang mahal untuk dokumen yang lebih besar,
dan dokumen perbedaan yang dihasilkan tidak lagi mencerminkan struktur input
dokumen.

--membantu or -h
Tampilkan teks bantuan

--Versi: kapan
Tampilkan nomor versi

Sudah ditentukan sebelumnya gaya
Utama jenis
Jenis utama menentukan markup teks biasa dan beberapa perintah lateks yang dipilih di luar
mengapung dengan mendefinisikan perintah markup "\DIFadd{...}" dan "\DIFdel{...}" .

"MENGGARISBAWAHI"
Teks yang ditambahkan digarisbawahi bergelombang dan berwarna biru, teks yang dibuang dicoret dan berwarna merah
(Memerlukan paket warna dan ulem). Menyerang berlebihan tidak berfungsi dalam tampilan
persamaan matematika sehingga bagian persamaan yang dihapus digarisbawahi, bukan dicoret
out (ini adalah kekurangan yang melekat pada paket ulem).

"KTRADISIONAL"
Teks yang ditambahkan berwarna biru dan diatur dalam sans-serif, dan catatan kaki merah dibuat untuk masing-masing
potongan teks yang dibuang. (Memerlukan paket warna)

"TRADISIONAL"
Seperti "CTRADITIONAL" tapi tanpa menggunakan warna.

"CFONT" Teks yang ditambahkan berwarna biru dan diatur dalam sans-serif, dan teks yang dibuang berwarna merah dan sangat
ukuran kecil.

"FONTSTRIK"
Teks yang ditambahkan diatur dalam sans-serif, teks yang dibuang kecil dan dicoret

"GANTUNGAN"
Teks yang ditambahkan berwarna biru, dan teks yang dibuang berwarna merah. Selain itu, teks yang diubah
ditandai dengan bar di margin (Memerlukan paket warna dan changebar).

"CFONTCHBAR"
Seperti "CFONT" tetapi dengan bilah perubahan tambahan (Memerlukan warna dan bilah perubahan
paket).

"KULINECHBAR"
Seperti "UNDERLINE" tetapi dengan bilah perubahan tambahan (Memerlukan warna, ulem dan
paket changebar).

"BARU GANTI"
Tidak ada mark up teks, tapi tandai margin dengan changebars (Memerlukan changebar
kemasan).

"TAK TERLIHAT"
Tidak ada markup yang terlihat (tetapi perintah markup umum akan tetap dimasukkan.

"BOLD" Teks yang ditambahkan disetel dalam huruf tebal, yang dibuang tidak ditampilkan.

Subtipe
Subtipe mendefinisikan perintah yang disisipkan di awal dan akhir dari or yang ditambahkan
blok yang dibuang, terlepas dari apakah blok ini berisi teks atau perintah (Didefinisikan
perintah: "\DIFaddbegin, \DIFaddend, \DIFdelbegin, \DIFdelend")

"AMAN" Tidak ada markup tambahan (Pilihan yang disarankan)

"MARGIN" Tandai awal dan akhir blok yang diubah dengan simbol di margin terdekat
(menggunakan perintah "\marginpar" standar - perhatikan bahwa ini terkadang bergerak
agak dari posisi yang dimaksudkan.

"COLOR" Cara alternatif untuk menandai bagian yang ditambahkan dengan warna biru, dan yang dihapus dengan warna merah.
(Disarankan untuk menggunakan jenis utama sebagai gantinya untuk mempengaruhi markup berwarna,
meskipun dalam beberapa kasus pewarnaan dengan dvipscol bisa lebih lengkap, misalnya
dengan perintah kutipan).

"DVIPSCOL"
Cara alternatif untuk menandai bagian yang ditambahkan dengan warna biru, dan yang dihapus dengan warna merah.
Perhatikan bahwa "DVIPSCOL" hanya berfungsi dengan konverter dvips, misalnya bukan pdflatex.
(disarankan untuk menggunakan jenis utama untuk mempengaruhi markup berwarna,
meskipun dalam beberapa kasus pewarnaan dengan dvipscol bisa lebih lengkap).

"ZLABEL" hanya dapat digunakan untuk menyorot halaman yang diubah, tetapi memerlukan pasca-pemrosesan. Dia
merekomendasikan untuk tidak memanggil opsi ini secara manual tetapi gunakan "latexdiff-vc" dengan
opsi "--only-changes". Atau, gunakan skrip yang diberikan dalam pembukaan dari
file diff yang dibuat menggunakan gaya ini.

"HANYA BERUBAH HALAMAN"
juga menyoroti halaman yang diubah, tanpa perlu pasca-pemrosesan, tetapi mungkin
tidak bekerja dengan andal jika ada bahan mengambang (gambar, tabel).

"LABEL" mirip dengan "ZLABEL", tetapi tidak memerlukan paket zref dan bekerja lebih sedikit
andal (tidak digunakan lagi).

Mengapung jenis
Beberapa markup yang digunakan dalam teks utama dapat menyebabkan masalah saat digunakan dalam float
(misalnya gambar atau tabel). Untuk alasan ini, versi alternatif dari semua perintah markup adalah
digunakan dalam pelampung. Tipe float mendefinisikan perintah alternatif ini.

"FLOATSAFE"
Gunakan markup identik untuk teks seperti di badan utama, tetapi atur semua tanda perintah
awal dan akhir blok yang diubah menjadi perintah-nol. Anda harus memilih ini
tipe float jika subtipe Anda adalah "MARGIN" karena "\marginpar" tidak berfungsi dengan baik
dalam pelampung.

"AMAN TRADISIONAL"
Tandai tambahan dengan cara yang sama seperti pada teks utama. Lingkungan yang dihapus adalah
ditandai dengan kurung sudut \[ dan \] dan teks yang dihapus diatur dalam skrip
ukuran. Jenis float ini harus selalu digunakan dengan "TRADITIONAL" dan
Jenis markup "CTRADITIONAL" karena perintah \catatan kaki tidak berfungsi dengan baik di
lingkungan mengambang.

"IDENTIK"
Jangan membuat perbedaan antara teks utama dan float.

konfigurasi Variabel
"ARRENV" Jika kecocokan dengan "ARRENV" ditemukan dalam lingkungan matematika sebaris dalam a
dihapus atau ditambahkan blok, maka matematika inline dikelilingi oleh "\mbox{"..."}".
Ini diperlukan karena garis bawah tidak berfungsi dalam array sebaris
lingkungan.

[ Bawaan: "ARRENV"="(?:array|[pbvBV]matriks)"

"COUNTERCMD"
Jika perintah di blok yang dihapus yang juga ada dalam daftar textcmd cocok
"COUNTERCMD" lalu perintah tambahan "\addtocounter{"cntcmd"}{-1}", di mana
cntcmd adalah perintah yang cocok, ditambahkan dalam file diff sedemikian rupa sehingga
penomoran di file diff tetap sinkron dengan penomoran di file baru
file.

[ Bawaan: "COUNTERCMD"="(?:catatan kaki|bagian|bagian|subbagian" ...

"|subayat|paragraf|subparagraf)" ]

"FLOATENV"
Lingkungan yang namanya cocok dengan ekspresi reguler di "FLOATENV" adalah
dianggap mengapung. Dalam lingkungan ini, lateksdiff perintah markup adalah
digantikan oleh variasi FL mereka.

[ Bawaan: "(?:gambar|tabel|piring)[\w\d*@]*" ]

Perintah "ITEMCMD" mewakili baris item baru dengan lingkungan daftar.

[ Bawaan: \"barang" ]

Lingkungan "LISTENV" yang namanya cocok dengan ekspresi reguler di "LISTENV" adalah daftar
lingkungan.

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

"MATHENV", "MATHREPL"
Jika keduanya \begin dan \end untuk lingkungan matematika (pencocokan nama lingkungan
"MATHENV" atau \[ dan \]) berada dalam blok terhapus yang sama, mereka digantikan oleh
a \begin dan \end perintah untuk "MATHREPL" daripada dikomentari.

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

"MATHARRENV", "MATHARRREPL"
sebagai "MATHENV", "MATHREPL" tetapi untuk array persamaan

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

"MINWORDSBLOK"
Jumlah minimum token yang diperlukan untuk membentuk blok independen. Nilai ini adalah
digunakan dalam algoritma untuk mendeteksi perubahan blok lengkap dengan menggabungkan identik
bagian teks kurang dari "MINWORDSBLOCK" ke yang sebelumnya ditambahkan dan dibuang
bagian.

[ Bawaan: 3 ]

"GAMBAR"
Dalam lingkungan yang namanya cocok dengan ekspresi reguler di "PICTUREENV"
semua markup latexdiff dihapus (dalam kasus patologis ini dapat menyebabkan
markup yang tidak konsisten tetapi situasi ini seharusnya jarang terjadi).

[ Bawaan: "(?:gambar|DIFnomarkup)[\w\d*@]*" ]

UMUM MASALAH DAN FAQ

Kutipan menghasilkan kotak yang terlalu penuh
Ada ketidakcocokan antara paket "ulem", yang digunakan "latexdiff"
untuk menggarisbawahi dan menonjolkan gaya UNDERLINE, gaya default, dan
cara kutipan dihasilkan. Untuk dapat menandai kutipan
dengan benar, mereka diapit dengan perintah "\mbox". Karena mbox tidak dapat dipecahkan
melintasi garis, prosedur ini sering menghasilkan kotak yang terlalu penuh, mungkin
mengaburkan konten karena melampaui margin kanan. Hal yang sama terjadi
untuk beberapa paket lain (misalnya, siunitx). Jika ini masalah, Anda punya dua
kemungkinan.

1. Gunakan markup tipe "CFONT" (opsi "-t CFONT"): Jika markup ini dipilih, maka
kutipan yang diubah tidak lagi ditandai dengan garis bergelombang (tambahan) atau
dicoret (dihapus), tetapi tetap disorot dengan warna yang sesuai, dan
teks yang dihapus ditampilkan dengan font yang berbeda. Gaya lain tidak menggunakan "ulem"
paket juga akan bekerja.

2. Pilih opsi "--disable-citation-markup" yang menonaktifkan penandaan
kutipan: kutipan yang dihapus tidak lagi ditampilkan, dan kutipan yang ditambahkan ditampilkan
tanpa markup. (Ini adalah perilaku default latexdiff pada versi 0.6 dan
lebih tua)

Untuk paket khusus, Anda dapat menentukan perintah yang perlu dilindungi oleh
"\mbox" dengan opsi "--append-mboxsafecmd" dan "--excludemboxsafecmd" (kirim
daftar perintah Anda sebagai permintaan fitur di halaman github untuk mengatur default
perilaku versi masa depan, lihat bagian 6)

Perubahan persamaan matematika yang rumit menghasilkan kesalahan pemrosesan lateks
Coba opsi "--math-markup=whole". Jika itu gagal, Anda dapat mematikan tanda
untuk persamaan dengan "--math-markup=off".

Bagaimana saya bisa menunjukkan halaman di mana perubahan telah dibuat?
Gunakan opsi -"-s ZLABEL" (beberapa pascapemrosesan diperlukan) atau "-s
ONLYCHANGEDPAGE". "latexdiff-vc --ps|--pdf" dengan opsi "--only-changes" membutuhkan
mengurus pasca-pemrosesan untuk Anda (memerlukan paket zref untuk diinstal).

Gunakan latexdiff online menggunakan layanan onworks.net