latexdiff - عبر الإنترنت في السحابة

برنامج:

اسم

اختلاف اللاتكس - تحديد الفروق بين ملفي اللاتكس وترميزها

موجز

اللاتكس [ OPTIONS ] old.tex new.tex > فرق

الوصف

موجز، اللاتكس هو برنامج فائدة للمساعدة في إدارة المراجعات من مادة اللاتكس
وثائق. يقوم بمقارنة ملفين صالحين من مادة اللاتكس ، يُطلق عليهما هنا اسم "old.tex" و "new.tex"
فروق ذات دلالة إحصائية بينهما (أي تجاهل عدد المساحات البيضاء و
موضع فواصل الأسطر) ، ويضيف أوامر خاصة لإبراز الاختلافات. أين
التمييز المرئي غير ممكن ، على سبيل المثال للتغييرات في التنسيق والاختلافات
مع ذلك تم ترميزها في المصدر.

يتعامل البرنامج مع التمهيد بشكل مختلف عن المستند الرئيسي. الاختلافات بين
تم العثور على التمهيدات باستخدام الاختلاف المستند إلى الأسطر (على غرار أمر فرق Unix ،
ولكن تجاهل المساحات البيضاء). يتم إلحاق تعليق ""٪ DIF> "" بكل سطر مضاف ، أي أ
السطر موجود في "new.tex" ولكن ليس في "old.tex". الخطوط المهملة
يتم إلغاء تنشيطها عن طريق تقديم ""٪ DIF <"" مسبقًا. الكتل المتغيرة مسبوقة بأسطر تعليق
إعطاء معلومات حول أرقام الأسطر في الملفات الأصلية. حيث هناك
اختلافات طفيفة ، سيكون الملف الناتج "diff.tex" مشابهًا لملف "new.tex". في
نهاية الديباجة ، التعاريف الخاصة بـ اللاتكس يتم إدراج أوامر الترميز. في
الاختلاف في النص الرئيسي للنص ، اللاتكس يحاول تلبية ما يلي
المبادئ التوجيهية (حسب الأولوية):

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 أعلاه ، من الضروري إحاطة جميع الحجج بأقواس معقوفة ، وليس ذلك
أدخل مسافات دخيلة. على سبيل المثال ، اكتب

\ قسم {\ textem {هذا عنوان قسم بارز}}

و لا

\ قسم {\ textem {هذا عنوان قسم بارز}}

or

\ section \ textem {هذا عنوان قسم بارز}

على الرغم من أن جميع الأصناف هي نفسها لـ LaTeX (لكن انظر - مساحات الخيار الذي
يسمح للصنف الثاني).

بالنسبة للبيئات التي لا يتوافق محتواها مع معايير LaTeX أو التي لا يتوافق محتواها مع الرسوم البيانية
الترميز غير منطقي يمكن إزالة جميع أوامر الترميز من خلال تعيين PICTUREENV
متغير التكوين ، يتم تعيينه افتراضيًا على بيئات "الصورة" و "DIFnomarkup" ؛ يرى
- تكوين خيار). يمكن استخدام البيئة الأخيرة ("DIFnomarkup") لحماية أجزاء من
ملف اللاتكس حيث ينتج عن الترميز ترميز غير قانوني. عليك أن تحيط بـ
المقطع المسيء في الملفين القديم والجديد بواسطة "\ begin {DIFnomarkup}" و
"\ end {DIFnomarkup}". يجب تحديد البيئة في مقدمات كل من القديم والجديد
وثائق. أفضل تعريفها على أنها بيئة خالية ،

"\ newenvironment {DIFnomarkup} {} {}"

لكن الخيار لك. ستتم إزالة أي ترميز داخل البيئة بشكل عام
كل شيء داخل البيئة سيؤخذ فقط من الملف الجديد.

من الممكن أيضًا التمييز بين الملفات التي لا تحتوي على مقدمة.
في هذه الحالة ، تتم معالجة الملف في وضع المستند الرئيسي ، ولكن تعريفات
لا يتم إدراج أوامر الترميز.

تم إدراج جميع أوامر العلامات بواسطة اللاتكس ابدأ بـ "" \ DIF "". الكتل المضافة التي تحتوي على
يتم تمييز الكلمات أو الأوامر أو التعليقات الموجودة في "new.tex" ولكن ليست في "old.tex" بواسطة
"\ DIFaddbegin" و "\ DIFaddend". يتم تمييز الكتل المهملة بعلامة "\ DIFdelbegin" و
"\ DIFdelend". ضمن الكتل المضافة ، يتم تمييز كل النص بـ "\ DIFadd" مثل هذا:
"\ DIFadd {added text block}" يمكن احتواء الأوامر "الآمنة" المحددة في هذه المربعات النصية
كذلك (استخدم الخيارات لإظهار قائمة الأوامر الآمنة وتغييرها ، انظر أدناه). كل الآخرين
الأوامر بالإضافة إلى الأقواس المعقوفة "{" و "}" لا يتم وضعها أبدًا في نطاق "\ DIFadd". مضاف
يتم تمييز التعليقات من خلال إضافة ""٪ DIF> "" مسبقًا.

داخل الكتل المحذوفة يتم تمييز النص بـ "\ DIFdel". التعليقات المحذوفة يتم تمييزها بـ
قبل ""٪ DIF <"". الأوامر غير الآمنة والأقواس المتعرجة داخل الكتل المحذوفة هي
علّق مع ""٪ DIFDELCMD <"".

OPTIONS

مقدمة
تحدد الخيارات التالية نمط العلامات المرئية عن طريق إضافة الأمر المناسب
تعريفات الديباجة. انظر نهاية هذا القسم للحصول على وصف متاح
الأساليب.

- type = markupstyle or -t com.markupstyle
أضف رمزًا إلى التمهيد لنمط الترميز المحدد. يعرّف هذا الخيار "\ DIFadd" و
أوامر "\ DIFdel". الأنماط المتوفرة:

"تحت خط CTRADITIONAL التقليدية CFONT FONTSTRIKE غير مرئي CHANGEBAR CCHANGEBAR
CULINECHBAR CFONTCBHBAR BOLD "

[افتراضي: "UNDERLINE"]

- نوع فرعي = مارك ستايل or -s مارك ستايل
أضف رمزًا إلى التمهيد للنمط المحدد لأوامر التصحيح (على سبيل المثال لتمييز التغييرات
في الهامش). يعرّف هذا الخيار "\ DIFaddbegin" و "\ DIFaddend" و "\ DIFdelbegin" و
أوامر "\ DIFdelend". الأنماط المتوفرة: "SAFE MARGIN COLOR DVIPSCOL ZLABEL
ONLYCHANGEDPAGE (LABEL) * "

[الافتراضي: "آمن"] * تم إهمال النوع الفرعي "LABEL"

- نوع مستوي = مارك ستايل or -f مارك ستايل
أضف رمزًا إلى التمهيد للنمط المحدد الذي يحل محل العلامات القياسية والترميز
الأوامر داخل العوامات (على سبيل المثال ، تسبب الملاحظات الهامشية خطأً داخل العوامات
يمكن تعطيل وضع العلامات الهامشية على هذا النحو). يعرّف هذا الخيار كافة أوامر "\ DIF ... FL".
الأنماط المتاحة: "FLOATSAFE TRADITIONALSAFE IDENTICAL"

[افتراضي: "FLOATSAFE"]

- التشفير = encoding or -e ENC
حدد ترميز old.tex و new.tex. الترميزات النموذجية هي "ascii" ، "utf8" ،
"latin1" ، "latin9". يمكن الحصول على قائمة الترميزات المتوفرة عن طريق التنفيذ

"perl -MEncode -e 'ربط الطباعة (" \ n "، ترميز-" ترميزات (": all"))؛' >

[الترميز الافتراضي هو utf8 ما لم تحتوي الأسطر القليلة الأولى من التمهيد على ملف
استدعاء "\ usepackage [..] {inputenc}" وفي هذه الحالة الترميز الذي اختاره هذا
يفترض الأمر. لاحظ أن ASCII (اللاتكس القياسي) عبارة عن مجموعة فرعية من utf8]

--preamble = ملف or -p ملف
أدخل الملف في نهاية التمهيد بدلاً من إنشاء التمهيد. يجب أن تكون الديباجة
حدد الأوامر التالية "\ DIFaddbegin، \ DIFaddend، \ DIFadd {..}،
\ DIFdelbegin ، \ DIFdelend ، \ DIFdel {..} ، "وأصناف للاستخدام داخل العوامات
"\ DIFaddbeginFL ، \ DIFaddendFL ، \ DIFaddFL {..} ، \ DIFdelbeginFL ، \ DIFdelendFL ،
\ DIFdelFL {..} "(إذا تم تعيين هذا الخيار -t, -sو -f يتم تجاهل الخيارات.)

- الحزم = pkg1 ، pkg2 ، ..
أخبر latexdiff أن ملف .tex تتم معالجته مع تحميل الحزم الموجودة في القائمة. هذا هو
عادة لا تكون ضرورية إذا كان ملف .tex يتضمن التمهيد ، كما هو الحال في التمهيد
تم فحصها تلقائيًا بحثًا عن أوامر "\ usepackage". استخدام - الحزم خيار
لتعطيل المسح التلقائي ، لذلك إذا كان يلزم تحليل الحزمة لأي سبب من الأسباب
مغلق ، استخدم - الحزم = لا شيء. تؤدي الحزم التالية إلى سلوك خاص:

"أمسمث"
تم تعيين متغير التكوين MATHARRREPL على "محاذاة *" (الافتراضي: "eqnarray *").
(لاحظ أن العديد من بيئات صفيف amsmath يتم التعرف عليها بالفعل بواسطة
الافتراضي على هذا النحو)

"endfloat"
تأكد من ظهور "\ start {figure}" و "\ end {figure}" بمفردهما دائمًا في
خط.

"hyperref"
تغيير اسم الأمرين "\ DIFadd" و "\ DIFdel" إلى "\ DIFaddtex" و
"\ DIFdeltex" وحدد أوامر "\ DIFadd" و "\ DIFdel" الجديدة ، والتي توفر
التفاف لهذه الأوامر ، واستخدامها للنص وليس للارتباط
تحديد الأمر (حيث قد يتسبب أي ترميز في حدوث أخطاء).

"أباسيت"
أعد تعريف الأوامر التي تم التعرف عليها كأوامر استشهاد.

"سيونتكس"
تعامل مع "\ SI" كمكافئ لأوامر الاقتباس (مثل الحماية باستخدام "\ mbox" إذا كان
يستخدم أسلوب الترميز حزمة ulem.

"ذكي"
تعامل مع "\ cref، \ Cref" وما إلى ذلك على أنها مكافئة لأوامر الاقتباس (على سبيل المثال ، Protect with
"\ mbox" إذا كان أسلوب الترميز يستخدم حزمة ulem.

"المسارد"
حدد معظم أوامر المسارد على أنها آمنة ، وحمايتها بـ \ mbox'es
عند الحاجة

"مشيم"
تعامل مع "\ ce" كأمر آمن ، أي أنه سيتم تمييزه (لاحظ أن "\ cee"
لن يتم تمييزه في المعادلات لأن هذا يؤدي إلى أخطاء في المعالجة)

"chemformula" أو "chemmacros"
تعامل مع "\ ch" كأمر آمن خارج المعادلات ، أي سيتم إبرازه
(لاحظ أنه لن يتم تمييز "\ ch" في المعادلات لأن هذا يؤدي إلى
أخطاء المعالجة)

[افتراضي: تفحص التمهيد بحثًا عن أوامر "\ usepackage" لتحديدها
الحزم المحملة. ]

- عرض الديباجة
يتم إنشاء أوامر تمهيد الطباعة أو تضمينها إلى stdout.

الاعداد
--exclude-safecmd = استبعاد ملف or -A استبعاد ملف or --exclude-safecmd = "cmd1، cmd2، ..."
--replace-safecmd = replace-file
--append-safecmd = إلحاق ملف or -a إلحاق ملف or --append-safecmd = "cmd1، cmd2، ..."
الاستبعاد من قائمة مطابقة التعبيرات العادية (RegEx) أو استبدالها أو إلحاقها بها
أوامر آمنة للاستخدام في نطاق أمر "\ DIFadd" أو "\ DIFdel".
يجب أن يحتوي الملف على Perl-RegEx واحد لكل سطر (أسطر التعليق التي تبدأ بـ # أو٪ هي
تم تجاهله). لاحظ أن RegEx يحتاج إلى مطابقة الرمز المميز بالكامل ، مثل / ^ regex $ /
ضمنيًا وأنه لم يتم تضمين "\" الأولي للأمر. ال
- استثناء- safecmd و --لحق- safecmd يمكن دمج الخيارات مع
-- استبدل- safecmd ويمكن استخدامه بشكل متكرر للإضافة التراكمية إلى القوائم.
- استثناء- safecmd و --لحق- safecmd يمكن أيضًا أن تأخذ قائمة مفصولة بفواصل كإدخال.
إذا كانت الفاصلة لأحد regex مطلوبة ، فقم بتخطيها وبالتالي "\،". في معظم الحالات
سيكون ضروريًا لحماية القائمة المفصولة بفواصل من الغلاف عن طريق وضعها
علامات الاقتباس.

--exclude-textcmd = استبعاد ملف or -X استبعاد ملف or - استثناء-textcmd = "cmd1، cmd2، ..."
--replace-textcmd = استبدل الملف
--append-textcmd = إلحاق ملف or -x إلحاق ملف or --append-textcmd = "cmd1، cmd2، ..."
استبعد أو استبدل أو ألحق بقائمة التعبيرات العادية المطابقة للأوامر
حجة الأخير هي النص. انظر دخول - استثناء- safecmd مباشرة فوق
تفاصيل أكثر.

--replace-Context1cmd = replace-file
--append-Context1cmd = إلحاق الملف أو = عنصر --إضافة سياق 1cmd = "cmd1، cmd2، ..."
استبدل أو ألحق بقائمة أوامر مطابقة regex التي تكون وسيطتها الأخيرة عبارة عن نص
ولكنها تتطلب سياقًا معينًا للعمل ، على سبيل المثال ، لن تعمل التسمية التوضيحية إلا في نطاق
الشكل أو الجدول. تعمل هذه الأوامر مثل الأوامر النصية ، إلا عندما تحدث في ملفات
قسم محذوف ، عندما يتم تعطيلهم ، ولكن يتم عرض وسيطتهم على أنها محذوفة
نص.

--replace-Context2cmd = replace-file
--append-Context2cmd = إلحاق الملف أو = عنصر --إضافة سياق 2cmd = "cmd1، cmd2، ..."
كأوامر مقابلة للسياق 1. الاختلاف الوحيد هو أن أوامر Context2
تم تعطيلها تمامًا في الأقسام المحذوفة ، بما في ذلك الوسائط الخاصة بهم.

--exclude-mboxsafecmd = استبعاد ملف or - exclude-mboxsafecmd = "cmd1، cmd2، ..."
--append-mboxsafecmd = إلحاق ملف or --append-mboxsafecmd = "cmd1، cmd2، ..."
حدد الأوامر الآمنة ، والتي تحتاج أيضًا إلى الحماية من خلال تغليفها في ملف
\\ mbox {..}. هذا مطلوب في بعض الأحيان للالتفاف على عدم التوافق بين العوامل الخارجية
الحزم وحزمة ulem ، والتي تُستخدم للتمييز بالنمط الافتراضي
UNDERLINE وكذلك CULINECHBAR CFONTSTRIKE

- تكوين var1 = val1، var2 = val2، ... or -c var1 = val1، ..
-c ملف التكوين
تعيين متغيرات التكوين. يمكن تكرار الخيار لتعيين متغيرات مختلفة
(كبديل للقائمة المفصولة بفواصل). المتغيرات المتاحة (انظر أدناه للحصول على
مزيد من التفسيرات):

"ARRENV" (RegEx)

"COUNTERCMD" (RegEx)

"FLOATENV" (RegEx)

"ITEMCMD" (RegEx)

"LISTENV" (RegEx)

"MATHARRENV" (RegEx)

"MATHARRREPL" (سلسلة)

"MATHENV" (RegEx)

"MATHREPL" (سلسلة)

"MINWORDSBLOCK" (عدد صحيح)

"PICTUREENV" (RegEx)

--إظهار- Safecmd
طباعة قائمة مطابقة RegEx واستبعاد الأوامر الآمنة.

- إظهار-textcmd
طباعة قائمة مطابقة RegEx واستبعاد الأوامر باستخدام وسيطة النص.

--إظهار التكوين
إظهار قيم متغيرات التكوين.

--عرض الكل
اجمع كل أوامر العرض.

ملاحظة: بالنسبة لجميع أوامر العرض ، لا يلزم تحديد ملف "old.tex" أو "new.tex" ، و
لا يوجد اختلاف.

أخرى ترتيب الخيارات:
- مساحات
السماح بمسافات بين الوسيطات الموضوعة بين قوسين أو قوسين للأوامر. لاحظ أن هذا الخيار
قد يكون لها آثار جانبية غير مرغوب فيها (قد يتم خلط النطاق غير ذي الصلة مع السابق
أوامر) لذلك يجب استخدامها فقط إذا كان الإعداد الافتراضي ينتج عنه نتائج خاطئة. (تقصير
تتطلب الحجج لتتبع بعضها البعض مباشرة دون مسافات).

--math-markup = المستوى
تحديد دقة العلامات في بيئات الرياضيات المعروضة: القيم المحتملة لـ
المستوى (كل من التسميات الرقمية والنصية مقبولة):

"إيقاف" أو 0: إلغاء الترميز لبيئات الرياضيات. لن تظهر المعادلات المحذوفة
في ملف فرق. يمكن استخدام هذا الوضع إذا تسببت جميع الأوضاع الأخرى في وجود رمز لاتكس غير صالح.

"كامل" أو 1: التفاضل على مستوى المعادلات الكاملة. حتى التغييرات التافهة ل
تتسبب المعادلات في تغيير المعادلة بأكملها. يمكن استخدام هذا الوضع إذا
ينتج عن المعالجة في الوضع الخشن أو الدقيق شفرة لاتكس غير صالحة.

"تقريبي" أو 2: اكتشاف التغييرات داخل المعادلات التي تم ترميزها بدقة تقريبية ؛
التغييرات في نوع المعادلة (مثل العرض إلى المعادلة) تظهر كتغيير في
معادلة كاملة. يوصى بهذا الوضع للحالات التي يكون فيها المحتوى والنظام
من بعض المعادلات لا تزال قيد التغيير. [تقصير]

"غرامة" أو 3: اكتشف التغيير الطفيف في المعادلات وقم بترميزها بدقة عالية. هذا
الأسلوب هو الأكثر ملاءمة ، إذا كان من المتوقع فقط تغييرات طفيفة على المعادلات ، على سبيل المثال
تصحيح الأخطاء المطبعية.

- تعطيل-ترميز الاقتباس or --تعطيل-auto-mbox
قم بإلغاء ترميز الاقتباس وترميز الأوامر الضعيفة الأخرى في الأنماط باستخدام ulem
(UNDERLINE، FONTSTRIKE، CULINECHBAR) (الخياران متطابقان وهما ببساطة
اسماء مستعارة)

- تمكين-ترميز الاقتباس or --enforce-auto-mbox
حماية أوامر الاقتباس والأوامر الضعيفة الأخرى في الأقسام التي تم تغييرها باستخدام
الأمر "\ mbox" ، أي استخدم السلوك الافتراضي لحزمة ulem للحزم الأخرى (ملف
خياران متطابقان وهما ببساطة أسماء مستعارة)

منوع
- الإسراف or -V
إخراج معلومات الحالة المختلفة إلى stderr أثناء المعالجة. الافتراضي هو العمل
بصمت.

- السائق = النوع
اختر برنامج التشغيل لحزمة التغيير (ذات الصلة فقط بالأنماط التي تستخدم
شريط التغيير: CCHANGEBAR CFONTCHBAR CULINECHBAR CHANGEBAR). السائقين المحتملين
المدرجة في دليل التغيير ، على سبيل المثال pdftex ، dvips ، dvitops
[افتراضي: dvips]

- تجاهل - تحذيرات
قم بإلغاء التحذيرات حول التناقضات في الطول بين سلاسل الإدخال والسلاسل التي تم تحليلها و
الأحرف المفقودة. غالبًا ما ترتبط رسائل التحذير هذه بمطاط اللاتكس غير القياسي أو
تركيبات لاتكس ذات بناء جملة غير معروف لـ "اختلاف اللاتكس" ولكن الاختلاف الناتج
غالبًا ما تكون الحجة تعمل بكامل طاقتها على أي حال ، خاصةً إذا كانت مادة اللاتكس غير القياسية فقط
يحدث في أجزاء من النص لم تتغير.

- التسمية = التسمية or -L ملصق
يضبط التسميات المستخدمة لوصف الملفات القديمة والجديدة. أول استخدام لهذا الخيار
يحدد التسمية التي تصف الملف القديم والاستخدام الثاني للخيار يحدد التسمية
للملف الجديد ، على سبيل المثال ، قم بتعيين كلتا الملصقات مثل "-L labelold -L labelnew". [تقصير:
استخدم اسم الملف وتواريخ التعديل للتسمية]

--لا تسمية
قم بإلغاء إدراج أسماء الملفات القديمة والجديدة كتعليق في ملف الإخراج

- ملصق مرئي
قم بتضمين أسماء ملفات قديمة وجديدة (أو تسميات معدة بخيار "--label") كإخراج مرئي.

- تسطيح
استبدل الأمرين "\ input" و "\ include" داخل النص بمحتوى الملفات الموجودة في
حجتهم. إذا كان "includeonly" موجودًا في التمهيد ، فلا توجد سوى هذه الملفات
موسعة في المستند. ومع ذلك ، لا يتم إجراء أي تكرار ، مثل "\ input" و
لا يتم توسيع أوامر "تضمين" داخل الأقسام المضمنة. الملفات المضمنة هي
يفترض أن
أن تكون موجودة في نفس الدلائل مثل الملفات الرئيسية القديمة والجديدة ، على التوالي ،
مما يجعل من الممكن تنظيم الملفات في دلائل قديمة وجديدة. - تسطيح هو
يتم تطبيقه بشكل متكرر ، لذلك يمكن أن تحتوي الملفات المدخلة على المزيد من عبارات "\ input".

قد يؤدي استخدام هذا الخيار إلى أوقات معالجة باهظة للمستندات الأكبر حجمًا ،
ولم يعد مستند الفرق الناتج يعكس هيكل المدخلات
الوثائق.

--مساعدة or -h
إظهار نص المساعدة

--الإصدار
إظهار رقم الإصدار

معرفة مسبقا أنماط
الاكتئاب أنواع
يحدد النوع الرئيسي ترميز النص العادي وبعض أوامر اللاتكس المحددة بالخارج
يطفو عن طريق تحديد أوامر الترميز "\ DIFadd {...}" و "\ DIFdel {...}".

"خط سفلي"
النص المضاف مسطر مموج والأزرق ، والنص المهمل مكتوب باللون الأحمر
(يتطلب عبوات ألوان و أولم). overstriking لا يعمل في المعروض
المعادلات الرياضية بحيث يتم تسطير الأجزاء المحذوفة من المعادلة وليس ضربها
الخروج (هذا عيب متأصل في حزمة العلماء).

"التقليدية"
النص المضاف أزرق ومضبط في sans-serif ، ويتم إنشاء حاشية سفلية حمراء لكل منها
جزء مهمل من النص. (يتطلب حزمة ألوان)

"تقليدي"
مثل "CTRADITIONAL" ولكن بدون استخدام اللون.

النص المضاف "CFONT" باللون الأزرق ويتم تعيينه في sans-serif ، والنص المهمل باللون الأحمر للغاية
حجم صغير.

"FONTSTRIKE"
تم تعيين النص المضاف في نص بلا سيريف ، والنص المهمل صغير ومشطوب

"CCHANGEBAR"
النص المضاف أزرق ، والنص المهمل أحمر. بالإضافة إلى ذلك ، تم تغيير النص
تم تمييزه بشريط في الهامش (يتطلب حزم اللون وتغيير الشريط).

"CFONTCHBAR"
مثل "CFONT" ولكن مع أشرطة تغيير إضافية (يتطلب اللون وشريط التغيير
حزم).

"CULINECHBAR"
مثل "UNDERLINE" ولكن مع أشرطة تغيير إضافية (تتطلب اللون و ulem و
حزم التغيير).

"CHANGEBAR"
لا يوجد ترميز للنص ، ولكن قم بتمييز الهوامش بأشرطة التغيير (يتطلب شريط التغيير
طَرد).

"غير مرئى"
لا توجد علامات تمييز مرئية (ولكن سيستمر إدراج أوامر الترميز العامة.

تم تعيين النص "غامق" المضاف بخط غامق ، ولا يتم عرض النص المهمل.

الأنواع الفرعية
يعرّف النوع الفرعي الأوامر التي تم إدراجها في بداية ونهاية الملف المضاف أو
الكتل المهملة ، بصرف النظر عما إذا كانت هذه الكتل تحتوي على نص أو أوامر (معرف
الأوامر: "\ DIFaddbegin ، \ DIFaddend ، \ DIFdelbegin ، \ DIFdelend")

"آمن" بدون ترميز إضافي (اختيار موصى به)

حدد "MARGIN" بداية ونهاية الكتل المتغيرة برموز في الهامش المجاور
(باستخدام الأمر القياسي "marginpar" - لاحظ أن هذا يتحرك في بعض الأحيان
نوعا ما من الموقف المقصود.

"COLOR" طريقة بديلة لتمييز المقاطع المضافة باللون الأزرق ، والمقاطع المحذوفة باللون الأحمر.
(يُنصح باستخدام الأنواع الرئيسية بدلاً من ذلك لتأثير العلامات الملونة ،
على الرغم من أنه في بعض الحالات يمكن أن يكون التلوين باستخدام dvipscol أكثر اكتمالاً ، على سبيل المثال
بأوامر الاقتباس).

"DVIPSCOL"
طريقة بديلة لتمييز المقاطع المضافة باللون الأزرق والمقاطع المحذوفة باللون الأحمر.
لاحظ أن "DVIPSCOL" يعمل فقط مع محول dvips ، على سبيل المثال لا يعمل مع pdflatex.
(يُنصح باستخدام الأنواع الرئيسية بدلاً من ذلك لتأثير العلامات الملونة ،
على الرغم من أنه في بعض الحالات يمكن أن يكون التلوين باستخدام dvipscol أكثر اكتمالاً).

يمكن استخدام "ZLABEL" لتمييز الصفحات التي تم تغييرها فقط ، ولكنها تتطلب معالجة لاحقة. إنها
نوصي بعدم استدعاء هذا الخيار يدويًا ولكن باستخدام "latexdiff-vc" مع
خيار "- التغييرات فقط". بدلاً من ذلك ، استخدم النص الوارد في ديباجة
تم إنشاء ملفات diff باستخدام هذا النمط.

"الصفحة التي تم تغييرها فقط"
يسلط الضوء أيضًا على الصفحات التي تم تغييرها ، دون الحاجة إلى معالجة لاحقة ، ولكن ربما
لا تعمل بشكل موثوق إذا كانت هناك مادة عائمة (أشكال ، جداول).

"LABEL" مشابه لـ "ZLABEL" ، لكنه لا يحتاج إلى حزمة zref ويعمل بشكل أقل
موثوق (مهمل).

تطفو الأنواع
قد تتسبب بعض العلامات المستخدمة في النص الرئيسي في حدوث مشكلات عند استخدامها داخل العوامات
(مثل الأشكال أو الجداول). لهذا السبب ، فإن الإصدارات البديلة لجميع أوامر التوصيف هي
تستخدم داخل العوامات. يعرّف نوع float هذه الأوامر البديلة.

"عائم"
استخدم ترميزًا متطابقًا للنص كما هو الحال في النص الأساسي ، ولكن قم بتعيين جميع الأوامر
بداية ونهاية الكتل المتغيرة إلى أوامر فارغة. عليك أن تختار هذا
نوع float إذا كان النوع الفرعي الخاص بك هو "MARGIN" لأن "\ marginpar" لا يعمل بشكل صحيح
داخل يطفو.

"سلامة تقليدية"
قم بتمييز الإضافات بنفس الطريقة كما في النص الرئيسي. البيئات المحذوفة هي
تم تمييزه بأقواس زاوية \ [و \] ويتم تعيين النص المحذوف في النص النصي
مقاس. يجب دائمًا استخدام نوع الطفو هذا مع "TRADITIONAL" و
أنواع الترميز "CTRADITIONAL" حيث أن الأمر \ الحاشية السفلية لا يعمل بشكل صحيح
البيئات العائمة.

"تطابق"
لا فرق بين النص الرئيسي والعوامات.

الاعداد المتغيرات
"ARRENV" إذا تم العثور على تطابق مع "ARRENV" داخل بيئة الرياضيات المضمنة داخل ملف
كتلة محذوفة أو مضافة ، فإن الرياضيات المضمنة محاطة بـ "\ mbox {" ... "}".
هذا ضروري لأن التسطير لا يعمل ضمن مجموعة مضمنة
البيئات.

[افتراضي: "ARRENV" = "(؟: مصفوفة | [pbvBV])"

"COUNTERCMD"
إذا كان هناك أمر في كتلة محذوفة وهو موجود أيضًا في قائمة textcmd يطابق
"COUNTERCMD" ثم أمر إضافي "\ addtocounter {"com.cntcmd"} {- 1}" ، أين
com.cntcmd هو أمر المطابقة ، يتم إلحاقه في ملف diff بحيث يكون ملف
يظل الترقيم في ملف الاختلافات متزامنًا مع الترقيم في الملف الجديد
ملف.

[الافتراضي: "COUNTERCMD" = "(؟: حاشية سفلية | جزء | قسم | قسم فرعي" ...

"| قسم فرعي | فقرة | فقرة فرعية)"]

"FLOATENV"
البيئات التي يتطابق اسمها مع التعبير العادي في "FLOATENV" هي
تعتبر تطفو. ضمن هذه البيئات ، فإن اللاتكس أوامر الترميز
استبدالها بصيغ FL الخاصة بهم.

[الافتراضي: "(؟: figure | table | plate) [\ w \ d * @] *"]

تمثل أوامر "ITEMCMD" سطر بند جديد مع بيئات القائمة.

[الافتراضي: \ "العنصر"]

البيئات "LISTENV" التي يتطابق اسمها مع التعبير العادي في "LISTENV" هي قائمة
البيئات.

[افتراضي: "(؟: itemize | enumerate | description)"]

"ماثنف" ، "ماثريب"
إذا كان كلاهما \ start و \ end لبيئة رياضية (مطابقة اسم البيئة
"MATHENV" أو \ [و \]) داخل نفس الكتلة المحذوفة ، يتم استبدالها بـ
أوامر a \ start and \ end لـ "MATHREPL" بدلاً من التعليق عليها.

[الافتراضي: "MATHENV" = "(؟: displaymath | معادلة)"، "MATHREPL" = "displaymath"]

"MATHARRENV" ، "MATHARRREPL"
كـ "MATHENV" ، "MATHREPL" ولكن لمصفوفات المعادلات

[الافتراضي: "MATHARRENV" = "eqnarray \ *؟" ، "MATHREPL" = "eqnarray"]

"MINWORDSBLOCK"
الحد الأدنى لعدد الرموز المطلوبة لتشكيل كتلة مستقلة. هذه القيمة
المستخدمة في الخوارزمية لاكتشاف التغييرات في الكتل الكاملة عن طريق دمج متطابقة
أجزاء نصية من أقل من "MINWORDSBLOCK" إلى الأجزاء السابقة المضافة والمهملة
أجزاء.

[الافتراضي: 3]

"PICTUREENV"
في البيئات التي يتطابق اسمها مع التعبير العادي في "PICTUREENV"
تتم إزالة كل علامات تمييز اللاتكس (في الحالات المرضية قد يؤدي ذلك إلى
ترميز غير متسق ولكن هذا الموقف يجب أن يكون نادرًا).

[افتراضي: "(؟: picture | DIFnomarkup) [\ w \ d * @] *"]

COMMON مشاكل لأي لبس الأسئلة الشائعة

تؤدي الاقتباسات إلى مربعات ممتلئة
يوجد عدم توافق بين حزمة "ulem" التي تستخدمها "latexdiff"
للتسطير والإبراز في نمط UNDERLINE والنمط الافتراضي و
طريقة إنشاء الاستشهادات. من أجل التمكن من ترميز الاقتباسات
بشكل صحيح ، يتم إرفاقها بأمر "\ mbox". لا يمكن كسر mboxes
عبر الخطوط ، غالبًا ما ينتج عن هذا الإجراء صناديق مفرطة ، ربما
التعتيم على المحتوى لأنه يمتد إلى ما بعد الهامش الأيمن. يحدث الشيء نفسه
لبعض الحزم الأخرى (على سبيل المثال ، siunitx). إذا كانت هذه مشكلة ، فلديك مشكلتان
الاحتمالات.

1. استخدم ترميز النوع "CFONT" (الخيار "-t CFONT"): إذا تم اختيار هذا الترميز ، فحينئذٍ
لم تعد الاستشهادات المتغيرة يتم ترميزها بالخط المتموج (الإضافات) أو
محذوف (عمليات حذف) ، ولكن لا يزال يتم تمييزه باللون المناسب ، و
يظهر النص المحذوف بخط مختلف. أنماط أخرى لا تستخدم "ulem"
الحزمة سوف تعمل أيضا.

2. اختر الخيار "--disable-citation-markup" الذي يوقف عمل الترميز
الاقتباسات: لم تعد الاقتباسات المحذوفة تظهر ، ويتم عرض الاقتباسات المضافة
بدون ترميز. (كان هذا هو السلوك الافتراضي لـ latexdiff في الإصدارين 0.6 و
اكبر سنا)

بالنسبة للحزم المخصصة ، يمكنك تحديد الأوامر التي تحتاج إلى الحماية بواسطة
"\ mbox" مع خيارات "--append-mboxsafecmd" و "--excludemboxsafecmd" (إرسال
قوائم الأوامر الخاصة بك كطلب ميزة في صفحة جيثب لتعيين الافتراضي
سلوك الإصدارات المستقبلية ، انظر القسم 6)

تؤدي التغييرات في المعادلات الرياضية المعقدة إلى أخطاء معالجة اللاتكس
جرب الخيارات "--math-markup = whole". حتى إذا فشل ذلك ، يمكنك إيقاف العلامة
حتى معادلات مع "--math-markup = off".

كيف يمكنني فقط إظهار الصفحات التي تم إجراء التغييرات فيها
استخدم الخيارات - "- s ZLABEL" (تتطلب بعض عمليات المعالجة اللاحقة) أو "-s
فقط CHANGEDPAGE "." latexdiff-vc --ps | --pdf "مع خيار" - only-Changes "
رعاية ما بعد المعالجة بالنسبة لك (يتطلب تثبيت حزمة zref).

استخدم latexdiff عبر الإنترنت باستخدام خدمات onworks.net