latexdiff - מקוון בענן

תָכְנִית:

שֵׁם

latexdiff - קבע וסימון הבדלים בין שני קבצי לטקס

תַקצִיר

latexdiff [ אפשרויות ] old.tex new.tex > diff.tex

תיאור

בקצרה, latexdiff היא תוכנית שירות לסיוע בניהול תיקונים של לטקס
מסמכים. הוא משווה שני קבצי לטקס חוקיים, הנקראים כאן "old.tex" ו-"new.tex", מוצא
הבדלים משמעותיים ביניהם (כלומר, התעלמות ממספר הרווחים הלבנים ו
מיקום מעברי שורה), ומוסיף פקודות מיוחדות כדי להדגיש את ההבדלים. איפה
הדגשה חזותית אינה אפשרית, למשל עבור שינויים בעיצוב, ההבדלים
בכל זאת מסומנים במקור.

התוכנית מתייחסת להקדמה בצורה שונה מהמסמך הראשי. הבדלים בין
ההקדמות נמצאות באמצעות הבדל מבוסס-קו (בדומה לפקודת Unix diff,
אבל מתעלמים מרווחים לבנים). הערה, ""%DIF >"" מצורפת לכל שורה שנוספה, כלומר א
שורה קיימת ב-"new.tex" אך לא ב-"old.tex". קווים שהושלכו
מושבתים על ידי הכנסת ""%DIF <"". לחסומים שהשתנו מקדימות שורות הערה
מתן מידע על מספרי שורות בקבצים המקוריים. איפה הם
הבדלים לא משמעותיים, הקובץ שיתקבל "diff.tex" יהיה דומה ל-"new.tex". בְּ
סוף ההקדמה, ההגדרות ל latexdiff מוכנסות פקודות סימון. ב
הבדל בין הגוף העיקרי של הטקסט, latexdiff מנסה לספק את הדברים הבאים
הנחיות (לפי סדר עדיפות):

1. אם גם "old.tex" וגם "new.tex" הם LaTeX חוקיים, אז ה-"diff.tex" המתקבל צריך
יהיה גם LateX חוקי. (הערה אם נעשה שימוש בכמה פקודות TeX פשוטות בתוך "old.tex" או
"new.tex" ואז "diff.tex" לא מובטח שיעבוד אבל בדרך כלל יעבוד).

2. הבדלים משמעותיים נקבעים ברמת המילים הבודדות. את כל
הבדלים משמעותיים, כולל הבדלים בין הערות צריכים להיות ברורים
מסומן בקוד המקור המתקבל "diff.tex".

3. אם קטע שהשתנה מכיל טקסט או פקודות יוצרות טקסט, הפעלת "diff.tex"
דרך LateX אמור לייצר פלט שבו קטעים שנוספו והושלכו מודגשים.

4. כאשר יש הבדלים לא משמעותיים, למשל במיקום של מעברי קו,
"diff.tex" צריך לעקוב אחר העיצוב של "new.tex"

להבדיל את אותו אלגוריתם כמו הבדל משמש אבל מילים במקום שורות כן
בהשוואה. נעשה ניסיון לזהות בלוקים אשר משתנים לחלוטין כך
ניתן לסמן אותם כיחידה. הערות מובדלות שורה אחר שורה אך מספרן של
מתעלמים מרווחים בתוך הערות. פקודות כולל כל הטיעונים שלהן הם בדרך כלל
בהשוואה כיחידה אחת, כלומר, לא מוכנס סימון לארגומנטים של פקודות.
עם זאת, עבור מספר נבחר של פקודות (לדוגמה, "\caption" וכל המקטעים
פקודות) ידוע שהארגומנט האחרון הוא טקסט. טקסט זה מחולק למילים ו
שונה בדיוק כמו טקסט רגיל (השתמש באפשרויות כדי להציג ולשנות את רשימת הטקסט
פקודות, ראה להלן). מכיוון שלאלגוריתם אין ידע מפורט על LaTeX, הוא מניח הכל
זוגות של פלטה מתולתלת מיד לאחר פקודה (כלומר רצף של אותיות
המתחיל עם קו נטוי אחורי) הם ארגומנטים לפקודה זו. כמגבלה לתנאי
1 לעיל, לכן יש צורך להקיף את כל הטיעונים בסוגרים מסולסלים, ולא
להכניס רווחים זרים. למשל, לכתוב

\section{\textem{זוהי כותרת קטע מודגשת}}

ולא

\section {\textem{זוהי כותרת קטע מודגשת}}

or

\section\textem{זוהי כותרת קטע מודגשת}

למרות שכל הזנים זהים ל-LaTeX (אבל ראה --אפשר-רווחים אפשרות אשר
מאפשר את המגוון השני).

עבור סביבות שהתוכן שלהן אינו תואם ל-LaTeX הסטנדרטי או בהן הוא גרפי
סימון לא הגיוני ניתן להסיר את כל פקודות הסימון על ידי הגדרת ה- PICTUREENV
משתנה תצורה, מוגדר כברירת מחדל לסביבות "תמונה" ו-"DIFnomarkup"; לִרְאוֹת
--config אוֹפְּצִיָה). הסביבה האחרונה ("DIFnomarkup") יכולה לשמש כדי להגן על חלקים של
קובץ הלטקס שבו הסימון גורם לסימון לא חוקי. אתה צריך להקיף את
קטע פוגע בקובץ הישן והחדש על ידי "\begin{DIFnomarkup}" ו
"\end{DIFnomarkup}". עליך להגדיר את הסביבה בהקדמה של הישן והחדש כאחד
מסמכים. אני מעדיף להגדיר את זה כסביבה אפסית,

"\newenvironment{DIFnomarkup}{}{}"

אבל הבחירה היא שלך. כל סימון בתוך הסביבה יוסר, ובאופן כללי
כל מה שנמצא בסביבה פשוט יילקח מהקובץ החדש.

אפשר גם להבדיל בין קבצים שאין להם הקדמה.
במקרה זה, הקובץ מעובד במצב המסמך הראשי, אך ההגדרות של ה
פקודות סימון אינן מוכנסות.

כל פקודות הסימון הוספו על ידי latexdiff התחל עם ""\DIF"". נוספו בלוקים המכילים
מילים, פקודות או הערות שנמצאות ב-"new.tex" אך לא ב-"old.tex" מסומנות ב-
"\DIFaddbegin" ו-"\DIFaddend". בלוקים שהושלכו מסומנים על ידי "\DIFdelbegin" ו
"\DIFdelend". בתוך בלוקים שנוספו כל הטקסט מסומן עם "\DIFadd" כך:
"\DIFadd{Added text block}" ניתן להכיל פקודות 'בטוחות' שנבחרו בלוקי טקסט אלה
כמו כן (השתמש באפשרויות כדי להציג ולשנות את רשימת הפקודות הבטוחות, ראה להלן). כל שאר
פקודות כמו גם סוגריים מסוג "{" ו-"}" לעולם אינם מונחים בטווח של "\DIFadd". נוסף
הערות מסומנות על ידי ""%DIF > "".

בתוך בלוקים שנמחקו הטקסט מסומן ב-"\DIFdel". הערות שנמחקו מסומנות על ידי
לפני ""%DIF < "". פקודה לא בטוחה וסוגרים מסולסלים בתוך בלוקים שנמחקו הם
הגיב עם ""%DIFDELCMD < "".

אפשרויות

הַקדָמָה
האפשרויות הבאות קובעות את סגנון הסימון החזותי על ידי הוספת הפקודה המתאימה
הגדרות לפתיח. עיין בסוף סעיף זה לתיאור של זמין
סגנונות.

--type=markupstyle or -t סימון סימון
הוסף קוד להקדמה עבור סגנון הסימון שנבחר. אפשרות זו מגדירה "\DIFadd" ו
פקודות "\DIFdel". סגנונות זמינים:

"הדגיש CTRADITIONAL TRADITIONAL CFONT FONTSTRIKE INVISIBLE CHANGEBAR CCHANGEBAR
CULINECHBAR CFONTCBHBAR BOLD"

[ברירת מחדל: "UNDERLINE" ]

--subtype=markstyle or -s markstyle
הוסף קוד להקדמה לסגנון שנבחר עבור פקודות סוגריים (למשל כדי לסמן שינויים
בשוליים). אפשרות זו מגדירה "\DIFaddbegin", "\DIFadend", "\DIFdelbegin" ו
פקודות "\DIFdelend". סגנונות זמינים: "SAFE MARGIN COLOR DVIPSCOL ZLABEL
ONLYCHANGEDPAGE (LABEL)*"

[ברירת מחדל: "SAFE" ] * סוג המשנה "LABEL" הוצא משימוש

--floattype=markstyle or -f markstyle
הוסף קוד להקדמה עבור סגנון נבחר המחליף סימון וסימון סטנדרטיים
פקודות בתוך צפים (למשל, הערות שוליים גורמות לשגיאה בתוך צפים ולכן
כך ניתן לבטל סימון שוליים). אפשרות זו מגדירה את כל הפקודות "\DIF...FL".
סגנונות זמינים: "FLOATSAFE TRADITIONALSAFE IDENTICAL"

[ברירת מחדל: "FLOATSAFE" ]

--encoding=enc or -e ENC
ציין קידוד של old.tex ו-new.tex. קידודים אופייניים הם "ascii", "utf8",
"latin1", "latin9". ניתן לקבל רשימה של קידודים זמינים על ידי ביצוע

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

[קידוד ברירת המחדל הוא utf8 אלא אם השורות הראשונות של ההקדמה מכילות
הפעלת "\usepackage[..]{inputenc}" ובמקרה זה הקידוד שנבחר על ידי זה
הפקודה מתקבלת. שימו לב ש-ASCII (לטקס סטנדרטי) הוא תת-קבוצה של utf8]

--preamble=קובץ or -p פילה
הוסף קובץ בסוף ההקדמה במקום ליצור הקדמה. ההקדמה חייבת
הגדר את הפקודות הבאות "\DIFaddbegin, \DIFaddden, \DIFadd{..},
\DIFdelbegin,\DIFdelend,\DIFdel{..}," וזנים לשימוש בתוך מצופים
"\DIFaddbeginFL, \DIFaddendFL, \DIFaddFL{..}, \DIFdelbeginFL, \DIFdelendFL,
\DIFdelFL{..}" (אם אפשרות זו מוגדרת -t, -s, ו -f מתעלמים מהאפשרויות.)

--packages=pkg1,pkg2,..
אמור ל-latexdiff שקובץ tex מעובד כשהחבילות ברשימה טעונות. זה
בדרך כלל אין צורך אם קובץ ה-.tex כולל את ההקדמה, כפי שהיא
נסרק אוטומטית עבור פקודות "\usepackage". שימוש ב --חבילות אוֹפְּצִיָה
משבית את הסריקה האוטומטית, כך שאם מסיבה כלשהי יש צורך בניתוח ספציפי של החבילה
כבוי, השתמש --חבילות=אין. החבילות הבאות מעוררות התנהגות מיוחדת:

"אמסמת"
משתנה התצורה MATHARRREPL מוגדר ל-"align*" (ברירת מחדל: "eqnarray*").
(שים לב שרבות מסביבות מערך amsmath כבר מזוהות על ידי
ברירת מחדל ככזו)

"אנדרפלוט"
ודא ש-"\begin{figure}" ו-"\end{figure}" יופיעו תמיד לבד
שורה.

"היפר"
שנה את השם של הפקודות "\DIFadd" ו-"\DIFdel" ל-"\DIFaddtex" ו
"\DIFdeltex" והגדר פקודות חדשות "\DIFadd" ו-"\DIFdel", המספקות
עטיפה עבור פקודות אלה, תוך שימוש בהן עבור הטקסט אך לא עבור הקישור
הגדרת פקודה (כאשר כל סימון יגרום לשגיאות).

"אדיבות"
הגדר מחדש את הפקודות המוכרות כפקודות ציטוט.

"siunitx"
התייחס ל-"\SI" כשווה ערך לפקודות ציטוט (כלומר הגן באמצעות "\mbox" if
סגנון סימון משתמש בחבילת ulem.

"חכם"
התייחס ל-"\cref,\Cref", וכו' כשקול לפקודות ציטוט (כלומר הגן עם
"\mbox" אם סגנון הסימון משתמש בחבילת ulem.

"מילון מונחים"
הגדר את רוב פקודות מילוני המונחים כבטוחות, הגן עליהן באמצעות \mbox'es
איפה שצריך

"מחם"
התייחס ל-"\ce" כאל פקודה בטוחה, כלומר הוא יודגש (שים לב ש-"\cee"
לא יודגש במשוואות מכיוון שזה מוביל לשגיאות עיבוד)

"כימפורמולה" או "כימאקרו"
התייחס ל-"\ch" כאל פקודה בטוחה מחוץ למשוואות, כלומר הוא יודגש
(שים לב ש"\ch" לא יודגש במשוואות מכיוון שזה מוביל
שגיאות עיבוד)

[ברירת מחדל: סרוק את ההקדמה עבור פקודות "\usepackage" כדי לקבוע
חבילות טעונות. ]

--הצג-הקדמה
הדפס פקודות הקדמה שנוצרו או נכללו ל-stdout.

תְצוּרָה
--exclude-safecmd=exclude-file or -A exclude-file or --exclude-safecmd="cmd1,cmd2,..."
--replace-safecmd=replace-file
--append-safecmd=append-file or -a append-file or --append-safecmd="cmd1,cmd2,..."
אל תכלול, החלף או הוסף לרשימת התאמת הביטויים הרגולריים (RegEx).
פקודות בטוחות לשימוש בטווח של פקודת "\DIFadd" או "\DIFdel".
הקובץ חייב להכיל Perl-RegEx אחד בכל שורה (שורות הערה המתחילות ב-# או % הן
התעלמו). שימו לב שה-RegEx צריך להתאים לכל האסימון, כלומר /^regex$/
משתמע ושה"\" הראשוני של הפקודה אינו כלול. ה
--exclude-safecmd ו --append-safecmd ניתן לשלב אפשרויות עם
---replace-safecmd אפשרות וניתן להשתמש בה שוב ושוב כדי להוסיף באופן מצטבר לרשימות.
--exclude-safecmd ו --append-safecmd יכול גם לקחת רשימה מופרדת בפסיקים כקלט.
אם נדרש פסיק עבור אחד מהביטויים הרגולריים, הסר אותו כך "\,". ברוב המקרים זה
יהיה צורך להגן על הרשימה המופרדת בפסיקים מהקליפה על ידי הכנסתה
מרכאות.

--exclude-textcmd=exclude-file or -X exclude-file or --exclude-textcmd="cmd1,cmd2,..."
--replace-textcmd=replace-file
--append-textcmd=append-file or -x append-file or --append-textcmd="cmd1,cmd2,..."
אל תכלול, החלף או הוסף לרשימת הפקודות התואמות לביטויים רגולריים
שהטיעון האחרון שלו הוא טקסט. ראה ערך עבור --exclude-safecmd ישירות מעל עבור
פרטים נוספים.

--replace-context1cmd=replace-file
--append-context1cmd=append-file או =פריט --append-context1cmd="cmd1,cmd2,..."
החלף או הוסף לרשימת הפקודות התואמות לביטויים רגולריים שהארגומנט האחרון שלהן הוא טקסט
אבל שדורשים הקשר מסוים כדי לעבוד, למשל \caption יעבוד רק בתוך a
דמות או טבלה. פקודות אלו מתנהגות כמו פקודות טקסט, למעט כאשר הן מתרחשות ב
קטע שנמחק, כאשר הם מושבתים, אך הארגומנט שלהם מוצג כמחוק
טקסט.

--replace-context2cmd=replace-file
--append-context2cmd=append-file או =פריט --append-context2cmd="cmd1,cmd2,..."
כפקודות מתאימות להקשר1. ההבדל היחיד הוא שהפקודות context2
מושבתים לחלוטין בקטעים שנמחקו, כולל הטיעונים שלהם.

--exclude-mboxsafecmd=exclude-file or --exclude-mboxsafecmd="cmd1,cmd2,..."
--append-mboxsafecmd=append-file or --append-mboxsafecmd="cmd1,cmd2,..."
הגדר פקודות בטוחות, אשר בנוסף צריכות להיות מוגנות על ידי עטיפה ב-an
\\mbox{..}. זה נחוץ לפעמים כדי לעקוף חוסר התאמה בין חיצוני
חבילות וחבילת ulem, המשמשת להדגשה בסגנון ברירת המחדל
UNDERLINE וכן CULINECHBAR CFONTSTRIKE

--config var1=val1,var2=val2,... or -c var1=val1,..
-c configfile
הגדר משתני תצורה. ניתן לחזור על האפשרות כדי להגדיר משתנים שונים
(כחלופה לרשימה המופרדת בפסיקים). משתנים זמינים (ראה להלן עבור
הסברים נוספים):

"ARRENV" (RegEx)

"COUNTERCMD" (RegEx)

"FLOATENV" (RegEx)

"ITEMCMD" (RegEx)

"LISTENV" (RegEx)

"MATHARRENV" (RegEx)

"MATHARRREPL" (מחרוזת)

"MATHENV" (RegEx)

"MATHREPL" (מחרוזת)

"MINWORDSBLOCK" (מספר שלם)

"PICTUEENV" (RegEx)

--show-safecmd
הדפס רשימה של התאמת פקודות בטוחות ואי הכללה של RegEx.

--show-textcmd
הדפס רשימה של פקודות התאמה ואי הכללה של RegEx עם ארגומנט טקסט.

--show-config
הצג ערכים של משתני תצורה.

--הצג הכול
שלב את כל הפקודות --הצג.

הערה עבור כל הפקודות --show, אין צורך לציין קובץ "old.tex" או "new.tex", ו
לא מתרחש הבדל.

אחר תצורה אפשרויות:
--אפשר-רווחים
אפשר רווחים בין ארגומנטים בסוגריים או מסוגרים לפקודות. שימו לב שאופציה זו
עשויות להיות תופעות לוואי לא רצויות (ההיקף שאינו קשור עלול להצטופף בגבשושיות עם הקודמות
פקודות) אז יש להשתמש רק אם ברירת המחדל מייצרת תוצאות שגויות. (בְּרִירַת מֶחדָל
דורש טיעונים לעקוב ישירות זה אחר זה ללא רווחים מתערבים).

--math-markup=רמה
קבע את הפירוט של הסימון בסביבות מתמטיות המוצגות: ערכים אפשריים עבור
הרמה הן (הן תוויות מספריות והן תוויות טקסט מקובלות):

"כבוי" או 0: דחק סימון עבור סביבות מתמטיקה. משוואות שנמחקו לא יופיעו
בקובץ diff. ניתן להשתמש במצב זה אם כל שאר המצבים גורמים לקוד לטקס לא חוקי.

"שלם" או 1: הבדל ברמת המשוואות השלמות. אפילו שינויים טריוויאליים ל
משוואות גורמות לכל המשוואה להיות מסומנת כשינוי. ניתן להשתמש במצב זה אם
עיבוד במצב גס או עדין מביא לקוד לטקס לא חוקי.

"גס" או 2: זיהוי שינויים בתוך משוואות המסומנות בפירוט גס;
שינויים בסוג המשוואה (למשל, displaymath למשוואה) מופיעים כשינוי ל-
משוואה שלמה. מצב זה מומלץ למצבים שבהם התוכן והסדר
מכמה משוואות עדיין משתנים. [בְּרִירַת מֶחדָל]

"בסדר" או 3: זהה שינוי קטן במשוואות וסמן בפירוט עדין. זֶה
המצב המתאים ביותר, אם צפויים רק שינויים קלים במשוואות, למשל
תיקון שגיאות הקלדה.

--disable-citation-markup or --disable-auto-mbox
דחק סימון ציטוטים וסימון של פקודות פגיעות אחרות בסגנונות המשתמשים ב-ulem
(UNDERLINE,FONTSTRIKE, CULINECHBAR) (שתי האפשרויות זהות והן פשוטות
כינויים)

--enable-citation-markup or --enforce-auto-mbox
הגן על פקודות ציטוט ופקודות פגיעות אחרות בקטעים שהשתנו עם
הפקודה "\mbox", כלומר השתמש בהתנהגות ברירת המחדל עבור חבילת ulem עבור חבילות אחרות (
שתי אפשרויות זהות והן פשוט כינויים)

שונות
--מִלוּלִי or -V
פלט מידע סטטוס שונים ל-stderr במהלך העיבוד. ברירת המחדל היא לעבוד
חֶרֶשׁ.

--driver=סוג
בחר מנהל התקן עבור חבילת סרגל השינוי (רלוונטי רק עבור סגנונות המשתמשים
סרגל שינוי: CCHANGEBAR CFONTCHBAR CULINECHBAR CHANGEBAR). נהגים אפשריים הם
מופיע במדריך לסרגל השינוי, למשל pdftex,dvips,dvitops
[ברירת מחדל: dvips]

--התעלם מאזהרות
דחק אזהרות לגבי חוסר עקביות באורך בין מחרוזות קלט ומנותחות ו
דמויות חסרות. הודעות אזהרה אלו קשורות לרוב ללטקס לא סטנדרטי או
קונסטרוקציות לטקס עם תחביר שאינו ידוע ל"latexdiff" אך ההבדל הנובע מכך
הארגומנט לרוב מתפקד במלואו בכל מקרה, במיוחד אם הלטקס הלא סטנדרטי בלבד
מופיע בחלקים מהטקסט שלא השתנו.

--label=label or -L תווית
מגדיר את התוויות המשמשות לתיאור הקבצים הישנים והחדשים. השימוש הראשון באפשרות זו
מגדיר את התווית המתארת ​​את הקובץ הישן והשימוש השני באפשרות מגדיר את התווית
עבור הקובץ החדש, כלומר הגדר את שתי התוויות כך "-L labelold -L labelnew". [בְּרִירַת מֶחדָל:
השתמש בשם הקובץ ובתאריכי השינוי עבור התווית]

--אין תווית
דחק הכללת שמות קבצים ישנים וחדשים כהערה בקובץ הפלט

--visble-label
כלול שמות קבצים ישנים וחדשים (או תוויות המוגדרות עם אפשרות "--label") כפלט גלוי.

--לְשַׁטֵחַ
החלף את הפקודות "\input" ו-"\include" בתוך הגוף בתוכן הקבצים ב
הטיעון שלהם. אם "\includeonly" קיים בהקדמה, רק הקבצים האלה נמצאים
מורחבת לתוך המסמך. עם זאת, לא מתבצעת רקורסיה, כלומר "\input" ו
פקודות "\include" בתוך הקטעים הכלולים אינן מורחבות. הקבצים הכלולים הם
הניחו לכך
להיות ממוקם באותן ספריות כמו קבצי המאסטר הישנים והחדשים, בהתאמה,
מה שמאפשר לארגן קבצים בספריות ישנות וחדשות. --שטוח הוא
מיושם באופן רקורסיבי, כך שקבצים שהוזנו יכולים להכיל הצהרות "\input" נוספות.

שימוש באפשרות זו עלול לגרום לזמני עיבוד מופרזים של מסמכים גדולים יותר,
ומסמך ההבדל שנוצר כבר לא משקף את מבנה הקלט
מסמכים.

- עזרה or -h
הצג טקסט עזרה

--גִרְסָה
הצג מספר גרסה

מוגדר מראש סגנונות
רב סרן סוגים
הסוג העיקרי קובע את הסימון של טקסט רגיל וכמה פקודות לטקס נבחרות בחוץ
צף על ידי הגדרת פקודות הסימון "\DIFadd{...}" ו-"\DIFdel{...}" .

"לָשִׂים דָגֵשׁ"
הטקסט שנוסף עם קו תחתון גלי וכחול, הטקסט שנמחק באדום
(דורש אריזות צבע ואולם). חבטת יתר לא עובדת בתצוגה
משוואות מתמטיות כך שחלקים שנמחקו מהמשוואה יהיו מסומנים בקו תחתון, לא מכות
החוצה (זהו חסרון טבוע בחבילת ulem).

"CTRADITIONAL"
הטקסט שנוסף הוא כחול ומוגדר ב-sans-serif, ולכל אחד מהם נוצרת הערת שוליים אדומה
חתיכת טקסט זרוקה. (דורש חבילת צבע)

"מָסוֹרתִי"
כמו "CTRADITIONAL" אבל ללא שימוש בצבע.

"CFONT" הטקסט שנוסף הוא כחול ומוגדר ב-sans-serif, והטקסט שנמחק הוא אדום ומאוד
מידה קטנה.

"FONTSTRIKE"
טקסט נוסף מוגדר ב-sans-serif, טקסט שנמחק קטן ונמחק

"CCHANGEBAR"
הטקסט שנוסף הוא כחול, והטקסט שנמחק הוא אדום. בנוסף, הטקסט שהשתנה
מסומן בפס בשוליים (דורש חבילות צבע וסרגל שינוי).

"CFONTCHBAR"
כמו "CFONT" אבל עם פסי שינוי נוספים (דורש צבע וסרגל שינוי
חבילות).

"CULINECHBAR"
כמו "UNDERLINE" אבל עם פסי שינוי נוספים (דורש צבע, ulem ו
חבילות סרגל שינוי).

"CHANGEBAR"
אין סימון של טקסט, אבל סמן שוליים עם סרגלי שינוי (דורש סרגל שינוי
חֲבִילָה).

"בלתי נראה"
אין סימון גלוי (אך עדיין יוכנסו פקודות סימון כלליות.

"BOLD" טקסט שנוסף מוגדר בפנים מודגשות, מושלך לא מוצג.

תת-סוגים
תת-הסוג מגדיר את הפקודות המוכנסות בהתחלה ובסוף של הוספת או
בלוקים שהושלכו, ללא קשר אם בלוקים אלה מכילים טקסט או פקודות (מוגדר
פקודות: "\DIFaddbegin, \DIFaddend, \DIFdelbegin, \DIFdelend")

"בטוח" ללא סימון נוסף (בחירה מומלצת)

"MARGIN" סמן את ההתחלה והסוף של בלוקים שהשתנו עם סמלים בשוליים בקרבת מקום
(באמצעות הפקודה הסטנדרטית "\marginpar" - שימו לב שזה לפעמים זז
קצת מהמיקום המיועד.

"COLOR" דרך חלופית לסימון קטעים שנוספו בכחול, ואלה שנמחקו באדום.
(מומלץ להשתמש במקום זאת בסוגים העיקריים לביצוע סימון צבעוני,
אם כי במקרים מסוימים צביעה עם dvipscol יכולה להיות מלאה יותר, למשל
עם פקודות ציטוט).

"DVIPSCOL"
דרך חלופית לסימון קטעים שנוספו בכחול, ואלה שנמחקו באדום.
שימו לב ש"DVIPSCOL" עובד רק עם ממיר ה-dvips, למשל לא pdflatex.
(מומלץ להשתמש במקום זאת בסוגים העיקריים לביצוע סימון צבעוני,
אם כי במקרים מסוימים צביעה עם dvipscol יכולה להיות מלאה יותר).

"ZLABEL" יכול לשמש כדי להדגיש רק עמודים שהשתנו, אך דורש עיבוד לאחר. זה
ממליץ לא לקרוא לאפשרות זו ידנית אלא להשתמש ב-"latexdiff-vc" עם
אפשרות "--רק-שינויים". לחלופין, השתמש בסקריפט שניתן בהקדמה של
קבצי diff שנעשו באמצעות סגנון זה.

"רק CHANGEDPAGE"
מדגיש גם דפים שהשתנו, ללא צורך בעיבוד לאחר, אבל אולי
לא עובד בצורה מהימנה אם יש חומר צף (דמויות, טבלאות).

"LABEL" דומה ל-"ZLABEL", אך אינו זקוק לחבילת zref ועובד פחות
מהימן (הוצא משימוש).

לָצוּף סוגים
חלק מהסימון המשמש בטקסט הראשי עלול לגרום לבעיות בשימוש בתוך צפים
(למשל דמויות או טבלאות). מסיבה זו יש גרסאות חלופיות של כל פקודות הסימון
משמש בתוך מצופים. סוג הצוף מגדיר את הפקודות החלופיות הללו.

"FLOATSAFE"
השתמש בסימון זהה לטקסט כמו בגוף הראשי, אך הגדר את כל הפקודות לסימון
ההתחלה והסוף של בלוקים שהשתנו לפקודות null. אתה צריך לבחור בזה
סוג צף אם תת-הסוג שלך הוא "MARGIN" שכן "\marginpar" אינו פועל כראוי
בתוך מצופים.

"בטוח מסורתי"
סמן תוספות באותו אופן כמו בטקסט הראשי. סביבות שנמחקו הן
מסומן בסוגריים זוויתיים \[ ו-\] והטקסט שנמחק מוגדר בסקריפט
גודל. יש להשתמש תמיד בסוג צף זה עם ה-"TRADITIONAL" ו
סוג סימון "CTRADITIONAL" מכיוון שהפקודה \footnote לא פועלת כראוי
סביבות צפות.

"זֵהֶה"
אל תעשה הבדל בין הטקסט הראשי לבין הצפים.

תְצוּרָה משתנים
"ARRENV" אם נמצאה התאמה ל-"ARRENV" בתוך סביבת מתמטיקה מוטבעת בתוך a
נמחק או נוסף בלוק, אז המתמטיקה המוטבעת מוקפת ב-"\mbox{"..."}".
זה הכרחי מכיוון שהקו תחתון אינו פועל בתוך מערך משולב
סביבות.

[ ברירת מחדל: "ARRENV"="(?:array|[pbvBV]מטריקס)"

"COUNTERCMD"
אם פקודה בבלוק שנמחק שנמצאת גם ברשימת textcmd תואמת
"COUNTERCMD" ואז פקודה נוספת "\addtocounter{"cntcmd"}{-1}", איפה
cntcmd היא הפקודה המתאימה, מצורפת לקובץ ה-diff כך שה-
המספור בקובץ ה-diff נשאר מסונכרן עם המספור בקובץ החדש
קובץ.

[ ברירת מחדל: "COUNTERCMD"="(?:footnote|חלק|סעיף|תת-סעיף" ...

"|תת-תת-סעיף|פסקה|פסקת משנה)" ]

"FLOATENV"
סביבות ששמם תואם לביטוי הרגולרי ב-"FLOATENV" הן
נחשב מצופים. בתוך סביבות אלה, ה latexdiff פקודות סימון הן
הוחלפו בווריאציות FL שלהם.

[ברירת מחדל: "(?:figure|table|plate)[\w\d*@]*" ]

פקודות "ITEMCMD" המייצגות שורת פריט חדשה עם סביבות רשימה.

[ברירת מחדל: \"פריט"]

"LISTENV" סביבות ששמם תואם לביטוי הרגולרי ב-"LISTENV" מופיעות ברשימה
סביבות.

[ברירת מחדל: "(?:itemize|enumerate|description)" ]

"MATHENV","MATHREPL"
אם גם \begin וגם \end עבור סביבה מתמטית (התאמת שם סביבה
"MATHENV" או \[ ו-\]) נמצאים בתוך אותו בלוק שנמחק, הם מוחלפים ב
פקודות \begin ו\end עבור "MATHREPL" במקום להגיב.

[ברירת מחדל: "MATHENV"="(?:displaymath|equation)" , "MATHREPL"="displaymath" ]

"MATHARRRENV","MATHARRREPL"
בתור "MATHENV","MATHREPL" אלא עבור מערכי משוואות

[ ברירת מחדל: "MATHARRENV"="eqnarray\*?" , "MATHREPL"="eqnarray" ]

"MINWORDSBLOCK"
המספר המינימלי של אסימונים הנדרש ליצירת בלוק עצמאי. ערך זה הוא
משמש באלגוריתם כדי לזהות שינויים של בלוקים שלמים על ידי מיזוג זהים
טקסט חלקים של פחות מ-"MINWORDSBLOCK" לקודם שנוספו ונמחקו
חלקים.

[ברירת מחדל: 3]

"PICTURENV"
בתוך סביבות ששמם תואם לביטוי הרגולרי ב-"PICTUREENV"
כל סימון ה-latexdiff מוסר (במקרים פתולוגיים זה עלול להוביל ל
סימון לא עקבי אבל מצב זה אמור להיות נדיר).

[ברירת מחדל: "(?:picture|DIFnomarkup)[\w\d*@]*" ]

משותף בעיות ו שאלות נפוצות

ציטוטים מביאים לתיבות מלאות מדי
קיימת אי התאמה בין חבילת "ולם", שבה משתמש "latexdiff".
להדגשה והבלטה בסגנון UNDERLINE, סגנון ברירת המחדל, ו
הדרך בה נוצרים ציטוטים. על מנת שניתן יהיה לסמן ציטוטים
כראוי, הם מוקפים בפקודה "\mbox". מכיוון שלא ניתן לשבור mboxes
על פני קווים, הליך זה גורם לעתים קרובות לתיבות מלאות מדי, אולי
מטשטש את התוכן כשהוא משתרע מעבר לשוליים הימניים. אותו דבר מתרחש
עבור כמה חבילות אחרות (למשל, siunitx). אם זו בעיה, יש לך שניים
אפשרויות.

1. השתמש בסימון מסוג "CFONT" (אפשרות "-t CFONT"): אם נבחר סימון זה, אז
ציטוטים שהשתנו כבר לא מסומנים בקו הגלי (תוספות) או
נמחק (מחיקות), אך עדיין מודגשים בצבע המתאים, ו
טקסט שנמחק מוצג בגופן אחר. סגנונות אחרים שאינם משתמשים ב"אולם"
גם החבילה תעבוד.

2. בחר באפשרות "--disable-citation-markup" שמכבה את הסימון של
ציטוטים ביבליוגרפיים: ציטוטים שנמחקו אינם מוצגים עוד, וציטוטים שנוספו מוצגים
ללא סימון. (זו הייתה התנהגות ברירת המחדל של latexdiff בגרסאות 0.6 ו
מבוגר יותר)

עבור חבילות מותאמות אישית אתה יכול להגדיר את הפקודות שעליהן צריך להגן
"\mbox" עם האפשרויות "--append-mboxsafecmd" ו-"--excludemboxsafecmd" (שלח
רשימות הפקודות שלך כבקשת תכונה בדף github כדי להגדיר את ברירת המחדל
התנהגות של גרסאות עתידיות, ראה סעיף 6)

שינויים במשוואות מתמטיות מסובכות גורמים לשגיאות עיבוד לטקס
נסה את האפשרויות "--math-markup=whole". אם אפילו זה נכשל, אתה יכול לבטל את הסימון
למעלה עבור משוואות עם "--math-markup=off".

איך אני יכול פשוט להראות את הדפים שבהם בוצעו שינויים
השתמש באפשרויות -"-s ZLABEL" (נדרשת עיבוד אחר) או "-s
ONLYCHANGEDPAGE". "latexdiff-vc --ps|--pdf" עם אפשרות "--only-changes" לוקח
לטפל בפוסט-עיבוד עבורך (דורש התקנה של חבילת zref).

השתמש ב-latexdiff באינטרנט באמצעות שירותי onworks.net