latexdiff - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

latexdiff - xác định và đánh dấu sự khác biệt giữa hai tệp latex

SYNOPSIS

mủ cao su [ LỰA CHỌN ] cũ.tex mới.tex > khác biệt.tex

MÔ TẢ

Tóm tắt, mủ cao su là một chương trình tiện ích để hỗ trợ trong việc quản lý các bản sửa đổi của mủ
các tài liệu. Nó so sánh hai tệp latex hợp lệ, ở đây được gọi là "old.tex" và "new.tex", tìm thấy
sự khác biệt đáng kể giữa chúng (tức là bỏ qua số lượng khoảng trắng và
vị trí của các ngắt dòng), và thêm các lệnh đặc biệt để làm nổi bật sự khác biệt. Ở đâu
không thể làm nổi bật trực quan, ví dụ: đối với những thay đổi trong định dạng, sự khác biệt
tuy nhiên được đánh dấu trong nguồn.

Chương trình xử lý phần mở đầu khác với tài liệu chính. Những điểm khác biệt giữa
phần mở đầu được tìm thấy bằng cách sử dụng tính năng khác biệt dựa trên dòng (tương tự như lệnh Unix diff,
nhưng bỏ qua khoảng trắng). Nhận xét, ""% DIF> "" được thêm vào mỗi dòng đã thêm, tức là
dòng có trong "new.tex" nhưng không có trong "old.tex". Các dòng bị hủy
bị vô hiệu hóa bằng cách viết trước ""% DIF <"". Các khối đã thay đổi được đặt trước bởi các dòng nhận xét
cung cấp thông tin về số dòng trong tệp gốc. Ở đâu có
khác biệt không đáng kể, tệp kết quả "diff.tex" sẽ tương tự như "new.tex". Tại
phần cuối của phần mở đầu, các định nghĩa cho mủ cao su lệnh đánh dấu được chèn. Trong
khác biệt nội dung chính của văn bản, mủ cao su cố gắng đáp ứng những điều sau đây
hướng dẫn (theo thứ tự ưu tiên):

1. Nếu cả "old.tex" và "new.tex" đều là LaTeX hợp lệ, thì kết quả "diff.tex" sẽ
cũng là LateX hợp lệ. (NB Nếu một vài lệnh TeX đơn giản được sử dụng trong "old.tex" hoặc
"new.tex" thì "diff.tex" không được đảm bảo hoạt động nhưng thường sẽ).

2. Sự khác biệt đáng kể được xác định trên mức độ của các từ riêng lẻ. Tất cả các
sự khác biệt đáng kể, bao gồm cả sự khác biệt giữa các bình luận phải rõ ràng
được đánh dấu trong mã nguồn kết quả "diff.tex".

3. Nếu một đoạn văn đã thay đổi có chứa văn bản hoặc các lệnh tạo văn bản, thì hãy chạy "diff.tex"
thông qua LateX sẽ tạo ra đầu ra trong đó các đoạn được thêm vào và loại bỏ được đánh dấu.

4. Khi có sự khác biệt không đáng kể, ví dụ như vị trí của các dấu ngắt dòng,
"diff.tex" phải tuân theo định dạng của "new.tex"

Để phân biệt thuật toán giống như khác được sử dụng nhưng các từ thay vì dòng được
so. Một nỗ lực được thực hiện để nhận ra các khối được thay đổi hoàn toàn để
chúng có thể được đánh dấu là một đơn vị. Các nhận xét là khác nhau từng dòng nhưng số lượng
không gian trong các bình luận bị bỏ qua. Các lệnh bao gồm tất cả các đối số của chúng nói chung là
được so sánh như một đơn vị, tức là, không có đánh dấu nào được chèn vào các đối số của lệnh.
Tuy nhiên, đối với một số lệnh đã chọn (ví dụ: "\ caption" và tất cả các phần
lệnh) đối số cuối cùng được biết là văn bản. Văn bản này được chia thành các từ và
khác biệt giống như văn bản thông thường (sử dụng các tùy chọn để hiển thị và thay đổi danh sách văn bản
lệnh, xem bên dưới). Vì thuật toán không có kiến ​​thức chi tiết về LaTeX, nó giả định tất cả
các cặp dấu ngoặc nhọn ngay sau một lệnh (tức là một chuỗi các chữ cái
bắt đầu bằng dấu gạch chéo ngược) là các đối số cho lệnh đó. Như một hạn chế đối với điều kiện
1 ở trên, do đó cần phải bao quanh tất cả các đối số bằng dấu ngoặc nhọn và không
chèn các khoảng trắng không liên quan. Ví dụ, viết

\ section {\ textem {Đây là tiêu đề phần được nhấn mạnh}}

và không

\ section {\ textem {Đây là tiêu đề phần được nhấn mạnh}}

or

\ section \ textem {Đây là tiêu đề phần được nhấn mạnh}

mặc dù tất cả các giống đều giống nhau đối với LaTeX (nhưng hãy xem --allow-space tùy chọn nào
cho phép giống thứ hai).

Đối với các môi trường có nội dung không tuân theo LaTeX tiêu chuẩn hoặc nơi đồ họa
đánh dấu không có ý nghĩa tất cả các lệnh đánh dấu có thể bị xóa bằng cách đặt PICTUREENV
biến cấu hình, được đặt theo mặc định thành môi trường "ảnh" và "DIFnomarkup"; Thấy chưa
--config Lựa chọn). Môi trường thứ hai ("DIFnomarkup") có thể được sử dụng để bảo vệ các phần của
tệp latex nơi đánh dấu dẫn đến đánh dấu bất hợp pháp. Bạn phải bao quanh
đoạn văn vi phạm trong cả tệp cũ và tệp mới bởi "\ begin {DIFnomarkup}" và
"\ end {DIFnomarkup}". Bạn phải xác định môi trường trong phần mở đầu của cả cũ và mới
các tài liệu. Tôi thích định nghĩa nó là một môi trường rỗng,

"\ newenosystem {DIFnomarkup} {} {}"

nhưng sự lựa chọn là của bạn. Mọi đánh dấu trong môi trường sẽ bị xóa và nói chung
mọi thứ trong môi trường sẽ chỉ được lấy từ tệp mới.

Cũng có thể phân biệt các tệp không có phần mở đầu.
Trong trường hợp này, tệp được xử lý ở chế độ tài liệu chính, nhưng các định nghĩa của
các lệnh đánh dấu không được chèn.

Tất cả các lệnh đánh dấu được chèn bởi mủ cao su bắt đầu bằng "" \ DIF "". Đã thêm các khối có chứa
các từ, lệnh hoặc nhận xét có trong "new.tex" nhưng không có trong "old.tex" được đánh dấu bằng
"\ DIFaddbegin" và "\ DIFaddend". Các khối bị loại bỏ được đánh dấu bằng "\ DIFdelbegin" và
"\ DIFdelend". Trong các khối đã thêm, tất cả văn bản được đánh dấu bằng "\ DIFadd" như thế này:
"\ DIFadd {Đã thêm khối văn bản}" Các lệnh `an toàn 'đã chọn có thể được chứa trong các khối văn bản này
cũng như (sử dụng các tùy chọn để hiển thị và thay đổi danh sách các lệnh an toàn, xem bên dưới). Tất cả những thứ khác
các lệnh cũng như dấu ngoặc nhọn "{" và "}" không bao giờ được đặt trong phạm vi của "\ DIFadd". Thêm
nhận xét được đánh dấu bằng cách thêm trước ""% DIF> "".

Trong các khối đã xóa, văn bản được đánh dấu bằng "\ DIFdel". Nhận xét đã xóa được đánh dấu bởi
thêm trước ""% DIF <"". Lệnh không an toàn và dấu ngoặc nhọn trong các khối đã xóa là
đã nhận xét với ""% DIFDELCMD <"".

LỰA CHỌN

Lời mở đầu
Các tùy chọn sau xác định kiểu đánh dấu trực quan bằng cách thêm lệnh thích hợp
định nghĩa cho phần mở đầu. Xem phần cuối của phần này để biết mô tả về
phong cách.

--type = markupstyle or -t phong cách đánh dấu
Thêm mã vào phần mở đầu cho kiểu đánh dấu đã chọn. Tùy chọn này xác định "\ DIFadd" và
Các lệnh "\ DIFdel". Các kiểu có sẵn:

"TRUYỀN THỐNG TRUYỀN THỐNG TRUYỀN THỐNG CỔNG TRUYỀN THỐNG CỔNG TRUYỀN THỐNG TRUYỀN THỐNG TRUYỀN THỐNG NGƯỢC
CULINECHBAR CFONTCBHBAR BOLD "

[Mặc định: "UNDERLINE"]

--subtype = markstyle or -s phong cách đánh dấu
Thêm mã vào phần mở đầu cho kiểu đã chọn cho các lệnh tiếp thị (ví dụ: để đánh dấu các thay đổi
trong lề). Tùy chọn này xác định "\ DIFaddbegin", "\ DIFaddend", "\ DIFdelbegin" và
Các lệnh "\ DIFdelend". Các kiểu có sẵn: "SAFE MARGIN COLOR DVIPSCOL ZLABEL
ONLYCHANGEDPAGE (LABEL) * "

[Mặc định: "SAFE"] * Loại phụ "LABEL" không được dùng nữa

--floattype = markstyle or -f phong cách đánh dấu
Thêm mã vào phần mở đầu cho kiểu đã chọn thay thế cho việc đánh dấu và đánh dấu tiêu chuẩn
các lệnh trong float (ví dụ: các nhận xét ngoài lề gây ra lỗi trong float nên
do đó, đánh dấu biên có thể bị vô hiệu hóa). Tùy chọn này xác định tất cả các lệnh "\ DIF ... FL".
Các kiểu hiện có: "FLOATSAFE TRUYỀN THỐNGSAFE IDENTICAL"

[Mặc định: "FLOATSAFE"]

--encoding = enc or -e mã hóa
Chỉ định mã hóa của old.tex và new.tex. Các mã hóa điển hình là "ascii", "utf8",
"latin1", "latin9". Danh sách các mã hóa có sẵn có thể thu được bằng cách thực thi

"perl -MEncode -e 'print join (" \ n ", Encode-" các bảng mã (": all"));' >

[Mã hóa mặc định là utf8 trừ khi một vài dòng đầu tiên của phần mở đầu chứa
lệnh gọi "\ usepackage [..] {inputenc}" trong trường hợp này mã hóa được chọn
lệnh được giả định. Lưu ý rằng ASCII (tiêu chuẩn cao su) là một tập con của utf8]

--preamble = tệp or -p hồ sơ
Chèn tệp vào cuối phần mở đầu thay vì tạo phần mở đầu. Lời mở đầu phải
xác định các lệnh sau "\ DIFaddbegin, \ DIFaddend, \ DIFadd {..},
\ DIFdelbegin, \ DIFdelend, \ DIFdel {..} "và các loại để sử dụng trong float
"\ DIFaddbeginFL, \ DIFaddendFL, \ DIFaddFL {..}, \ DIFdelbeginFL, \ DIFdelendFL,
\ DIFdelFL {..} "(Nếu tùy chọn này được đặt -t, -svà -f các tùy chọn bị bỏ qua.)

--packages = pkg1, pkg2, ..
Nói với latexdiff rằng tệp .tex được xử lý với các gói trong danh sách được tải. Đây là
thường không cần thiết nếu tệp .tex bao gồm phần mở đầu, vì phần mở đầu là
tự động quét các lệnh "\ usepackage". Sử dụng - gói hàng tùy chọn
tắt tính năng quét tự động, vì vậy nếu vì bất kỳ lý do gì thì phân tích cú pháp cụ thể của gói cần phải được
tắt, sử dụng --packages = none. Các gói sau kích hoạt hành vi đặc biệt:

"amsmath"
Biến cấu hình MATHARRREPL được đặt thành "align *" (Mặc định: "eqnarray *").
(Lưu ý rằng nhiều môi trường mảng amsmath đã được
mặc định như vậy)

"endfloat"
Đảm bảo rằng "\ begin {figure}" và "\ end {figure}" luôn tự xuất hiện trên
một dòng.

"hyperref"
Thay đổi tên của các lệnh "\ DIFadd" và "\ DIFdel" thành "\ DIFaddtex" và
"\ DIFdeltex" và xác định các lệnh "\ DIFadd" và "\ DIFdel" mới, cung cấp
trình bao bọc cho các lệnh này, sử dụng chúng cho văn bản nhưng không sử dụng cho liên kết
lệnh xác định (trong đó bất kỳ đánh dấu nào sẽ gây ra lỗi).

"apacite"
Định nghĩa lại các lệnh được công nhận là lệnh trích dẫn.

"siunitx"
Coi "\ SI" tương đương với lệnh trích dẫn (nghĩa là bảo vệ bằng "\ mbox" nếu
kiểu đánh dấu sử dụng gói ulem.

"cleveref"
Xử lý "\ cref, \ Cref", v.v. tương đương với lệnh trích dẫn (nghĩa là bảo vệ bằng
"\ mbox" nếu kiểu đánh dấu sử dụng gói ulem.

"bảng chú giải thuật ngữ"
Xác định hầu hết các lệnh bảng thuật ngữ là an toàn, bảo vệ chúng bằng \ mbox'es
Khi cần thiết

"mhchem"
Coi "\ ce" là một lệnh an toàn, tức là nó sẽ được đánh dấu (lưu ý rằng "\ cee"
sẽ không được đánh dấu trong phương trình vì điều này dẫn đến lỗi xử lý)

"chemformula" hoặc "chemmacros"
Coi "\ ch" như một lệnh an toàn bên ngoài các phương trình, tức là nó sẽ được đánh dấu
(lưu ý rằng "\ ch" sẽ không được đánh dấu trong phương trình vì điều này dẫn đến
xử lý lỗi)

[Mặc định: quét phần mở đầu cho các lệnh "\ usepackage" để xác định
các gói đã tải. ]

--show-lời mở đầu
In các lệnh mở đầu được tạo hoặc bao gồm vào stdout.

Cấu hình
--exclude-safecmd = loại trừ tệp or -A loại trừ tệp or --exclude-safecmd = "cmd1, cmd2, ..."
--replace-safecmd = thay thế-tệp
--append-safecmd = append-file or -a nối thêm tập tin or --append-safecmd = "cmd1, cmd2, ..."
Loại trừ, thay thế hoặc thêm vào danh sách đối sánh cụm từ thông dụng (RegEx)
các lệnh an toàn để sử dụng trong phạm vi của lệnh "\ DIFadd" hoặc "\ DIFdel".
Tệp phải chứa một Perl-RegEx trên mỗi dòng (Các dòng chú thích bắt đầu bằng # hoặc% là
mặc kệ). Lưu ý rằng RegEx cần phải khớp với toàn bộ mã thông báo, tức là / ^ regex $ /
được ngụ ý và "\" ban đầu của lệnh không được bao gồm. Các
--loại trừ-safecmd và --chắp thêm-safecmd các tùy chọn có thể được kết hợp với
---thay thế-safecmd và có thể được sử dụng nhiều lần để thêm tích lũy vào danh sách.
--loại trừ-safecmd và --chắp thêm-safecmd cũng có thể lấy một danh sách được phân tách bằng dấu phẩy làm đầu vào.
Nếu bắt buộc phải có dấu phẩy cho một trong các regex, hãy thoát khỏi dấu "\,". Trong hầu hết các trường hợp, nó
sẽ cần thiết để bảo vệ danh sách được phân tách bằng dấu phẩy khỏi trình bao bằng cách đưa nó vào
dấu ngoặc kép.

--exclude-textcmd = loại trừ tệp or -X loại trừ tệp or --exclude-textcmd = "cmd1, cmd2, ..."
--replace-textcmd = Replace-file
--append-textcmd = append-file or -x nối thêm tập tin or --append-textcmd = "cmd1, cmd2, ..."
Loại trừ khỏi, thay thế hoặc thêm vào danh sách các lệnh đối sánh biểu thức chính quy
đối số cuối cùng của nó là văn bản. Xem mục nhập cho --loại trừ-safecmd trực tiếp ở trên cho
biết thêm chi tiết.

--replace-context1cmd = Replace-file
--append-context1cmd = append-file hoặc = item --append-context1cmd = "cmd1, cmd2, ..."
Thay thế hoặc thêm vào danh sách các lệnh so khớp regex có đối số cuối cùng là văn bản
nhưng yêu cầu một ngữ cảnh cụ thể để hoạt động, ví dụ: \ caption sẽ chỉ hoạt động trong
hình hoặc bảng. Các lệnh này hoạt động giống như lệnh văn bản, ngoại trừ khi chúng xảy ra trong
một phần đã xóa, khi chúng bị vô hiệu hóa, nhưng đối số của chúng được hiển thị là đã xóa
văn bản.

--replace-context2cmd = Replace-file
--append-context2cmd = append-file hoặc = item --append-context2cmd = "cmd1, cmd2, ..."
Như các lệnh tương ứng cho ngữ cảnh1. Sự khác biệt duy nhất là các lệnh context2
hoàn toàn bị vô hiệu hóa trong các phần đã xóa, bao gồm cả các đối số của chúng.

--exclude-mboxsafecmd = loại trừ tệp or --exclude-mboxsafecmd = "cmd1, cmd2, ..."
--append-mboxsafecmd = append-file or --append-mboxsafecmd = "cmd1, cmd2, ..."
Xác định các lệnh an toàn, các lệnh này cũng cần được bảo vệ bằng cách đóng gói trong
\\ mbox {..}. Điều này đôi khi cần thiết để khắc phục sự không tương thích giữa các
gói và gói ulem, được sử dụng để đánh dấu theo kiểu mặc định
UNDERLINE cũng như CULINECHBAR CFONTSTRIKE

--config var1 = val1, var2 = val2, ... or -c var1 = val1, ..
-c tập tin cấu hình
Đặt các biến cấu hình. Tùy chọn có thể được lặp lại để đặt các biến khác nhau
(thay thế cho danh sách được phân tách bằng dấu phẩy). Các biến có sẵn (xem bên dưới để biết
giải thích thêm):

"ARRENV" (RegEx)

"COUNTERCMD" (RegEx)

"FLOATENV" (RegEx)

"ITEMCMD" (RegEx)

"LISTENV" (RegEx)

"MATHARRENV" (RegEx)

"MATHARRREPL" (Chuỗi)

"MATHENV" (RegEx)

"MATHREPL" (Chuỗi)

"MINWORDSBLOCK" (số nguyên)

"PICTUREENV" (RegEx)

--show-safecmd
In danh sách khớp RegEx và loại trừ các lệnh an toàn.

--show-textcmd
In danh sách các lệnh đối sánh và loại trừ RegEx với đối số văn bản.

--show-config
Hiển thị giá trị của các biến cấu hình.

--hiển thị tất cả
Kết hợp tất cả các lệnh --show.

NB Đối với tất cả các lệnh --show, không cần chỉ định tệp "old.tex" hoặc "new.tex" và
không có sự khác biệt diễn ra.

Nền tảng khác cấu hình lựa chọn:
--allow-space
Cho phép khoảng cách giữa các đối số trong dấu ngoặc đơn hoặc dấu ngoặc nhọn cho các lệnh. Lưu ý rằng tùy chọn này
có thể có các tác dụng phụ không mong muốn (phạm vi không liên quan có thể bị gộp lại với phần trước
lệnh) do đó chỉ nên được sử dụng nếu mặc định tạo ra kết quả sai. (Vỡ nợ
yêu cầu các lập luận tiếp nối trực tiếp nhau mà không có dấu cách xen kẽ).

--math-markup = level
Xác định mức độ chi tiết của đánh dấu trong môi trường toán học được hiển thị: Các giá trị có thể có cho
mức là (cả nhãn số và nhãn văn bản đều được chấp nhận):

"off" hoặc 0: chặn đánh dấu cho môi trường toán học. Các phương trình đã xóa sẽ không xuất hiện
trong tệp khác nhau. Chế độ này có thể được sử dụng nếu tất cả các chế độ khác gây ra mã latex không hợp lệ.

"whole" hoặc 1: Khác biệt ở cấp của toàn bộ phương trình. Ngay cả những thay đổi nhỏ đối với
phương trình làm cho toàn bộ phương trình được đánh dấu thay đổi. Chế độ này có thể được sử dụng nếu
chế biến ở chế độ thô hoặc mịn dẫn đến mã mủ không hợp lệ.

"thô" hoặc 2: Phát hiện những thay đổi trong các phương trình được đánh dấu bằng độ chi tiết thô;
các thay đổi trong loại phương trình (ví dụ: hiển thị thành phương trình) xuất hiện như một thay đổi đối với
hoàn thành phương trình. Chế độ này được khuyến nghị cho các tình huống mà nội dung và thứ tự
của một số phương trình vẫn đang được thay đổi. [Vỡ nợ]

"fine" hoặc 3: Phát hiện thay đổi nhỏ trong phương trình và đánh dấu ở mức độ chi tiết nhỏ. Cái này
chế độ là phù hợp nhất, nếu chỉ có những thay đổi nhỏ đối với phương trình được mong đợi, ví dụ:
sửa lỗi chính tả.

--vô hiệu hóa-trích dẫn-đánh dấu or --disable-auto-mbox
Ngăn chặn đánh dấu trích dẫn và đánh dấu các lệnh dễ bị tấn công khác trong các kiểu bằng cách sử dụng ulem
(UNDERLINE, FONTSTRIKE, CULINECHBAR) (hai tùy chọn giống hệt nhau và chỉ đơn giản là
bí danh)

--kích hoạt-trích dẫn-đánh dấu or --enforce-auto-mbox
Bảo vệ các lệnh trích dẫn và các lệnh dễ bị tấn công khác trong các phần đã thay đổi bằng
Lệnh "\ mbox", tức là sử dụng hành vi mặc định cho gói ulem cho các gói khác (
hai tùy chọn giống hệt nhau và chỉ đơn giản là bí danh)

hỗn hợp
--dài dòng or -V
Đưa ra các thông tin trạng thái khác nhau cho stderr trong quá trình xử lý. Mặc định là hoạt động
thầm lặng.

--driver = loại
Chọn trình điều khiển cho gói thanh thay đổi (chỉ phù hợp với các kiểu sử dụng
thanh thay đổi: CCHANGEBAR CFONTCHBAR CULINECHBAR THAY ĐỔI). Trình điều khiển có thể là
được liệt kê trong hướng dẫn sử dụng thanh thay đổi, ví dụ: pdftex, dvips, dvitops
[Mặc định: dvips]

--ignore-cảnh báo
Loại bỏ cảnh báo về sự không nhất quán về độ dài giữa các chuỗi đầu vào và các chuỗi được phân tích cú pháp và
ký tự thiếu. Các thông báo cảnh báo này thường liên quan đến cao su không tiêu chuẩn hoặc
cấu trúc latex với cú pháp không xác định là "latexdiff" nhưng kết quả là sự khác biệt
đối số thường có đầy đủ chức năng, đặc biệt nếu chỉ latex không tiêu chuẩn
xảy ra trong các phần của văn bản mà không thay đổi.

--label = nhãn or -L nhãn
Đặt các nhãn được sử dụng để mô tả các tệp cũ và mới. Lần sử dụng đầu tiên của tùy chọn này
đặt nhãn mô tả tệp cũ và việc sử dụng tùy chọn thứ hai sẽ đặt nhãn
cho tệp mới, tức là đặt cả hai nhãn như thế này "-L labelold -L labelnew". [Vỡ nợ:
sử dụng tên tệp và ngày sửa đổi cho nhãn]

--không nhãn hiệu
Loại bỏ việc bao gồm tên tệp cũ và mới dưới dạng nhận xét trong tệp đầu ra

- nhãn có thể nhìn thấy
Bao gồm tên tệp cũ và mới (hoặc nhãn được đặt với tùy chọn "--label") dưới dạng đầu ra hiển thị.

--làm phẳng
Thay thế các lệnh "\ input" và "\ include" trong phần thân bằng nội dung của các tệp trong
lập luận của họ. Nếu "\ includeonly" có trong phần mở đầu, thì chỉ những tệp đó mới
được mở rộng vào tài liệu. Tuy nhiên, không có đệ quy nào được thực hiện, tức là "\ input" và
Các lệnh "\ include" trong các phần được bao gồm không được mở rộng. Các tệp bao gồm là
giả định
được đặt trong cùng thư mục với các tệp chính cũ và mới,
làm cho nó có thể tổ chức các tệp thành các thư mục cũ và mới. --flatten là
được áp dụng đệ quy, vì vậy các tệp đã nhập có thể chứa thêm các câu lệnh "\ input".

Việc sử dụng tùy chọn này có thể dẫn đến thời gian xử lý nghiêm ngặt đối với các tài liệu lớn hơn,
và tài liệu khác biệt kết quả không còn phản ánh cấu trúc của đầu vào
các tài liệu.

--Cứu giúp or -h
Hiển thị văn bản trợ giúp

--phiên bản
Hiển thị số phiên bản

Được xác định trước phong cách
Chính loại
Loại chính xác định đánh dấu của văn bản thuần túy và một số lệnh latex được chọn bên ngoài
nổi bằng cách xác định các lệnh đánh dấu "\ DIFadd {...}" và "\ DIFdel {...}".

"UNDERLINE"
Văn bản đã thêm có gạch chân gợn sóng và màu xanh lam, văn bản bị loại bỏ bị gạch ngang và có màu đỏ
(Yêu cầu gói màu và ulem). Vượt quá giới hạn không hoạt động trong hiển thị
các phương trình toán học sao cho các phần đã xóa của phương trình được gạch chân, không bị gạch đầu dòng
out (đây là một thiếu sót vốn có của gói ulem).

"TRUYỀN THỐNG"
Văn bản đã thêm có màu xanh lam và được đặt bằng sans-serif và chú thích màu đỏ được tạo cho mỗi
đoạn văn bản bị loại bỏ. (Yêu cầu gói màu)

"TRUYÊN THÔNG"
Giống như "CTRADITIONAL" nhưng không sử dụng màu sắc.

"CFONT" Văn bản đã thêm có màu xanh lam và được đặt bằng sans-serif và văn bản bị loại bỏ có màu đỏ và rất
kích thước nhỏ.

"FONTSTRIKE"
Chữ viết đã thêm được đặt bằng sans-serif, văn bản bị loại bỏ nhỏ và bị gạch bỏ

"CCHANGEBAR"
Văn bản đã thêm có màu xanh lam và văn bản bị loại bỏ có màu đỏ. Ngoài ra, văn bản đã thay đổi
được đánh dấu bằng một thanh ở lề (Yêu cầu gói màu và thanh thay đổi).

"CFONTCHBAR"
Giống như "CFONT" nhưng có thêm thanh thay đổi (Yêu cầu màu sắc và thanh thay đổi
gói).

"CULINECHBAR"
Giống như "UNDERLINE" nhưng có thêm thanh thay đổi (Yêu cầu màu sắc, màu và
các gói thanh đổi).

"THAY ĐỔI"
Không đánh dấu văn bản, nhưng đánh dấu lề bằng thanh thay đổi (Yêu cầu thanh thay đổi
gói).

"VÔ HÌNH"
Không có đánh dấu hiển thị nào (nhưng các lệnh đánh dấu chung sẽ vẫn được chèn.

"BOLD" Văn bản đã thêm được đặt ở dạng in đậm, loại bỏ sẽ không được hiển thị.

Kiểu phụ
Kiểu con xác định các lệnh được chèn vào đầu và cuối của thêm hoặc
các khối bị loại bỏ, không phân biệt liệu các khối này có chứa văn bản hay lệnh hay không (Đã xác định
lệnh: "\ DIFaddbegin, \ DIFaddend, \ DIFdelbegin, \ DIFdelend")

"AN TOÀN" Không có đánh dấu bổ sung (Lựa chọn được đề xuất)

"MARGIN" Đánh dấu phần đầu và phần cuối của các khối đã thay đổi bằng các ký hiệu ở lề gần đó
(sử dụng lệnh "\ marginpar" tiêu chuẩn - lưu ý rằng điều này đôi khi di chuyển
phần nào từ vị trí đã định.

"COLOR" Một cách thay thế để đánh dấu những đoạn đã thêm bằng màu xanh lam và những đoạn đã xóa bằng màu đỏ.
(Nên sử dụng thay thế các loại chính để tạo hiệu ứng đánh dấu màu,
mặc dù trong một số trường hợp, tô màu bằng dvipscol có thể hoàn thiện hơn, chẳng hạn
với các lệnh trích dẫn).

"DVIPSCOL"
Một cách khác để đánh dấu những đoạn đã thêm bằng màu xanh lam và những đoạn đã xóa bằng màu đỏ.
Lưu ý rằng "DVIPSCOL" chỉ hoạt động với trình chuyển đổi dvips, ví dụ: không phải pdflatex.
(Nên sử dụng thay thế các loại chính để tạo hiệu ứng đánh dấu màu,
mặc dù trong một số trường hợp tô màu bằng dvipscol có thể hoàn thiện hơn).

"ZLABEL" chỉ có thể được sử dụng để đánh dấu các trang đã thay đổi nhưng yêu cầu xử lý hậu kỳ. Nó là
khuyên bạn không nên gọi tùy chọn này theo cách thủ công mà hãy sử dụng "latexdiff-vc" với
Tùy chọn "--chỉ-thay đổi". Ngoài ra, hãy sử dụng tập lệnh được đưa ra trong phần mở đầu của
các tệp khác nhau được thực hiện bằng cách sử dụng kiểu này.

"ONLYCHANGEDPAGE"
cũng đánh dấu các trang đã thay đổi mà không cần xử lý hậu kỳ, nhưng có thể
không hoạt động đáng tin cậy nếu có tài liệu nổi (hình, bảng).

"LABEL" tương tự như "ZLABEL", nhưng không cần gói zref và hoạt động ít hơn
đáng tin cậy (không dùng nữa).

Phao Các loại
Một số đánh dấu được sử dụng trong văn bản chính có thể gây ra sự cố khi sử dụng trong phao
(ví dụ: hình hoặc bảng). Vì lý do này, các phiên bản thay thế của tất cả các lệnh đánh dấu là
được sử dụng trong phao. Kiểu float xác định các lệnh thay thế này.

"FLOATSAFE"
Sử dụng đánh dấu giống hệt nhau cho văn bản như trong nội dung chính, nhưng đặt tất cả các lệnh đánh dấu
đầu và cuối của các khối đã thay đổi thành lệnh null. Bạn phải chọn cái này
kiểu float nếu kiểu phụ của bạn là "MARGIN" vì "\ marginpar" không hoạt động bình thường
trong phao.

"TRUYỀN THỐNGSAFE"
Đánh dấu phần bổ sung theo cách tương tự như trong văn bản chính. Môi trường đã xóa là
được đánh dấu bằng dấu ngoặc nhọn \ [và \] và văn bản đã xóa được đặt trong scriptscript
kích thước. Loại float này phải luôn được sử dụng với "TRADITIONAL" và
Loại đánh dấu "CTRADITIONAL" vì lệnh \ footnote không hoạt động bình thường trong
môi trường nổi.

"GIỐNG HỆT NHAU"
Không tạo ra sự khác biệt giữa văn bản chính và phao nổi.

Cấu hình Biến
"ARRENV" Nếu kết quả khớp với "ARRENV" được tìm thấy trong môi trường toán học nội tuyến trong
đã xóa hoặc thêm khối, thì phép toán nội dòng được bao quanh bởi "\ mbox {" ... "}".
Điều này là cần thiết vì gạch chân không hoạt động trong mảng nội tuyến
môi trường.

[Mặc định: "ARRENV" = "(?: Mảng | [pbvBV] ma trận)"

"COUNTERCMD"
Nếu một lệnh trong khối đã xóa cũng nằm trong danh sách textcmd khớp
"COUNTERCMD" rồi đến một lệnh bổ sung "\ addtocounter {"cntcmd"} {- 1}", ở đâu
cntcmd là lệnh phù hợp, được thêm vào trong tệp khác biệt sao cho
đánh số trong tệp khác biệt vẫn được đồng bộ hóa với đánh số trong tệp mới
tập tin.

[Mặc định: "COUNTERCMD" = "(?: Footnote | part | section | subection" ...

"| tiểu mục | đoạn văn | tiểu mục)"]

"FLOATENV"
Các môi trường có tên khớp với biểu thức chính quy trong "FLOATENV" là
được coi là phao nổi. Trong những môi trường này, mủ cao su các lệnh đánh dấu là
được thay thế bởi các biến thể FL của chúng.

[Mặc định: "(?: Figure | table | plate) [\ w \ d * @] *"]

Các lệnh "ITEMCMD" đại diện cho dòng mục mới với môi trường danh sách.

[Mặc định: \ "item"]

Môi trường "LISTENV" có tên khớp với biểu thức chính quy trong "LISTENV" là danh sách
môi trường.

[Mặc định: "(?: Itemize | liệt kê | mô tả)"]

"MATHENV", "MATHREPL"
Nếu cả \ begin và \ end cho một môi trường toán học (khớp tên môi trường
"MATHENV" hoặc \ [và \]) nằm trong cùng một khối đã xóa, chúng được thay thế bằng
a \ begin và \ end các lệnh cho "MATHREPL" thay vì được nhận xét.

[Mặc định: "MATHENV" = "(?: Displaymath | method)", "MATHREPL" = "displaymath"]

"MATHARRENV", "MATHARRREPL"
là "MATHENV", "MATHREPL" nhưng dành cho mảng phương trình

[Mặc định: "MATHARRENV" = "eqnarray \ *?" , "MATHREPL" = "eqnarray"]

"MINWORDSBLOCK"
Số lượng mã thông báo tối thiểu cần thiết để tạo thành một khối độc lập. Giá trị này là
được sử dụng trong thuật toán để phát hiện những thay đổi của các khối hoàn chỉnh bằng cách hợp nhất
phần văn bản của ít hơn "MINWORDSBLOCK" cho phần trước được thêm vào và loại bỏ
các bộ phận.

[Mặc định: 3]

"PICTUREENV"
Trong các môi trường có tên khớp với biểu thức chính quy trong "PICTUREENV"
tất cả đánh dấu latexdiff đều bị xóa (trong trường hợp bệnh lý, điều này có thể dẫn đến
đánh dấu không nhất quán nhưng trường hợp này nên hiếm).

[Mặc định: "(?: Picture | DIFnomarkup) [\ w \ d * @] *"]

CHUNG VẤN ĐỀ VÀ Câu Hỏi Thường Gặp

Trích dẫn dẫn đến quá nhiều hộp
Có sự không tương thích giữa gói "ulem" mà "latexdiff" sử dụng
để gạch chân và làm nổi bật theo kiểu UNDERLINE, kiểu mặc định và
cách các trích dẫn được tạo. Để có thể đánh dấu các trích dẫn
đúng cách, chúng được kèm theo lệnh "\ mbox". Vì mbox không thể bị phá vỡ
trên các dòng, quy trình này thường dẫn đến các hộp quá đầy, có thể
che khuất nội dung khi nó vượt ra ngoài lề phải. Điều tương tự cũng xảy ra
cho một số gói khác (ví dụ: siunitx). Nếu đây là một vấn đề, bạn có hai
khả năng.

1. Sử dụng đánh dấu loại "CFONT" (tùy chọn "-t CFONT"): Nếu đánh dấu này được chọn, thì
các trích dẫn đã thay đổi không còn được đánh dấu bằng đường lượn sóng (bổ sung) hoặc
được đánh dấu (xóa), nhưng vẫn được đánh dấu bằng màu thích hợp, và
văn bản đã xóa được hiển thị với một phông chữ khác. Các kiểu khác không sử dụng "ulem"
gói cũng sẽ hoạt động.

2. Chọn tùy chọn "--disable-citation-markup" để tắt đánh dấu
trích dẫn: trích dẫn đã xóa không còn được hiển thị và các trích dẫn đã thêm được hiển thị
mà không có đánh dấu. (Đây là hành vi mặc định của latexdiff ở phiên bản 0.6 và
lớn hơn)

Đối với các gói tùy chỉnh, bạn có thể xác định các lệnh cần được bảo vệ bởi
"\ mbox" với các tùy chọn "--append-mboxsafecmd" và "--excludemboxsafecmd" (gửi
danh sách lệnh của bạn dưới dạng yêu cầu tính năng tại trang github để đặt mặc định
hành vi của các phiên bản trong tương lai, xem phần 6)

Những thay đổi trong các phương trình toán học phức tạp dẫn đến lỗi xử lý mủ
Hãy thử các tùy chọn "--math-markup = whole". Nếu thậm chí không thành công, bạn có thể tắt đánh dấu
tính toán cho các phương trình với "--math-markup = off".

Làm cách nào để tôi có thể hiển thị các trang đã thực hiện các thay đổi
Sử dụng các tùy chọn - "- s ZLABEL" (một số yêu cầu xử lý sau) hoặc "-s
ONLYCHANGEDPAGE "." Latexdiff-vc --ps | --pdf "với tùy chọn" --only-changes "thực hiện
chăm sóc hậu kỳ cho bạn (yêu cầu gói zref được cài đặt).

Sử dụng latexdiff trực tuyến bằng các dịch vụ onworks.net