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

برنامج:

اسم

bibclean - طبعة جميلة وبناء الجملة تحقق من ملفات قاعدة بيانات BibTeX و Scribe

موجز

com.bibclean [ -مؤلف ] [ -سجل الخطأ اسم الملف ] [ -مساعدة ] [ -? ] [ -init- ملف اسم الملف ]
[ -طويلة المجال اسم الحقل ] [ العرض الأقصى NNN ] [ - [لا] محاذاة يساوي ]
[ - [no-] فحص القيم ] [ - [لا] حذف-قيم فارغة ] [ - [لا] وضع الملف ]
[ - [لا] إصلاح تغيير الخط ] [ - [no-] تصحيح الأحرف الأولى ] [ - [لا] إصلاح الأسماء ]
[ - [لا] على الطراز الألماني ] [ - [لا] احتفظ بفواصل الخطوط ] [ - [no-] إبقاء parbreaks ]
[ - [لا] الاحتفاظ بمسافات التمهيد ] [ - [لا] مساحات حفظ ] [ - [لا] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ]
[ - [لا] شظايا ] [ - [لا] بريتي برينت ] [ - [no-] أنماط الطباعة ]
[ - ملفات [no-] قراءة-init-files ] [ - [no-] إزالة البادئات OPT ] [ - [لا] الكاتب ]
[ - [لا] فتح ملف التتبع ] [ - [no-] تحذيرات ] [ -الإصدار ]
( <شرير | البيبفيلي 1 البيبفيلي 2 البيبفيلي 3 ) >ملف

يمكن اختصار جميع الخيارات إلى بادئة رائدة فريدة.

يمثل اسم ملف واضح "- '' إدخالًا قياسيًا ؛ من المفترض في حالة عدم وجود ملفات إدخال
محددة.

الوصف

com.bibclean prettyprints إدخال ملفات BibTeX إلى المعياري، ويتحقق من توازن الدعامة و
بناء جملة إدخال الببليوغرافيا كذلك. يمكن استخدامه لاكتشاف المشاكل في ملفات BibTeX التي
في بعض الأحيان تخلط حتى BibTeX نفسها ، والأهم من ذلك ، يمكن استخدامها لتطبيع ملف
ظهور مجموعات من ملفات BibTeX.

فيما يلي ملخص لإجراءات التنسيق:

· يتم تنسيق عناصر BibTeX في هيكل متناسق مع واحد حقل = "القيمة" زوج
في كل سطر ، وعلامة @ الأولية والقوس الأيمن اللاحق في العمود 1.

· يتم توسيع علامات التبويب إلى سلاسل فارغة. يتم تثبيط استخدامها لأنها تمنع
قابلية النقل ، ويمكن أن تعاني من الفساد في البريد الإلكتروني.

· يتم تقسيم قيم السلسلة الطويلة على فارغة وتستمر في السطر التالي مع بادئة
المسافة الفارغة.

· سطر فارغ واحد يفصل بين مدخلات الببليوغرافيا المجاورة.

· يتم تمرير النص خارج مدخلات BibTeX حرفيا.

· يتم تحويل الأقواس الخارجية حول الإدخالات إلى أقواس.

· الأسماء الشخصية بتنسيق المؤلفة رئيس التحرير يتم تطبيع قيم الحقل إلى النموذج `` PDQ
باخ ، من `` PDQ Bach '' و `` Bach، PDQ ''.

يتم تحويل تسلسل الواصلة في أرقام الصفحات إلى شرطات قصيرة.

يتم تحويل قيم الشهر إلى اختصارات سلسلة BibTeX القياسية.

· في العناوين ، يتم دعم تسلسل الأحرف الكبيرة عند مستوى الصفر للحماية
من تحويلها إلى أحرف صغيرة من خلال بعض أنماط المراجع.

· كودن ، ISBN (رقم الكتاب القياسي الدولي) و ISSN (المعيار الدولي
الرقم التسلسلي) يتم فحص قيم الإدخال للتحقق من المجاميع الاختبارية لكل رقم مدرج ،
ويتم توفير واصلة ISBN الصحيحة تلقائيًا.

التنسيق القياسي لإخراج com.bibclean يسهل التطبيق اللاحق لـ
مرشحات بسيطة ، مثل bibcheck(1) com.bibdup(1) معرف com لهذا التطبيق هو com.bibeextract(1) com.bibindex(1) bibjoin(1)
بببلابل(1) bibbook(1) الحدود(1) بيبسورت(1) سيفيند(1)، و علامات الاقتباس(1) ، للمعالجة
النص ، وهو أيضًا النص الذي تتوقعه وظائف دعم GNU Emacs BibTeX.

OPTIONS

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

يمكن مضاعفة الواصلة البادئة التي تميز خيارًا عن اسم الملف ، لـ
التوافق مع اتفاقيات GNU و POSIX. هكذا، -مؤلف --مؤلف متكافئة.

لتجنب الالتباس مع الخيارات ، إذا كان اسم الملف يبدأ بواصلة ، فيجب إخفاءه
من خلال مسار الدليل المطلق أو النسبي البادئ ، على سبيل المثال ، /tmp/-foo.bib or ./-foo.bib.

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

-سجل الخطأ اسم الملف
إعادة توجيه ستدير إلى الملف المشار إليه ، والذي سيحتوي بعد ذلك على كل الأخطاء
ورسائل التحذير. يتم توفير هذا الخيار لتلك الأنظمة التي لديها
صعوبة في إعادة التوجيه ستدير.

-مساعدة or -?
اعرض رسالة تعليمات على ستدير، مع إعطاء وصف استخدام مشابه لهذا
من صفحات الدليل ، ثم الخروج برمز إرجاع ناجح.

-init- ملف اسم الملف
قم بتوفير ملف تهيئة نمط القيمة الصريح. سيتم معالجتها
بعد أي ملفات تهيئة على مستوى النظام وعلى مستوى الوظيفة ، وقد تتجاوزها.
قد يتم تجاوزه بدوره بواسطة ملف تهيئة لاحق خاص بالملف.
لمزيد من التفاصيل ، انظر التهيئة FILES قسم الدليل.

-طويلة المجال اسم الحقل
قم بإلغاء التحذيرات بهذا الحقل المسمى اسم الحقل أطوال تتجاوز المعيار
حدود BibTeX. NB! هذه is a خاص بدبيان تمديد!

العرض الأقصى NNN
com.bibclean عادةً ما يحد عرض خط الإخراج إلى 72 حرفًا ، وفي تنسيق
مصالح الاتساق ، لا ينبغي تغيير تلك القيمة. أحياناً،
قد تتطلب التطبيقات ذات الأغراض الخاصة عروض خطوط قصوى مختلفة ، لذلك هذا
يوفر الخيار تلك القدرة. يمكن أن يكون الرقم الذي يلي اسم الخيار
محدد بالنظام العشري أو الثماني (بدءًا من 0) أو السداسي العشري (بدءًا من
0x). يتم تفسير القيمة الصفرية أو السالبة على أنها تعني غير محدود ، لذلك العرض الأقصى 0
يمكن استخدامها لضمان ظهور كل زوج حقل / قيمة في سطر واحد.

متى -لا-بريتي برينت طلبات com.bibclean ليكون بمثابة محلل معجمي ، الافتراضي
عرض الخط غير محدود ، ما لم يتم تجاوزه بواسطة هذا الخيار.

متى com.bibclean هو عبارة عن طباعة جميلة ، سيتم التفاف الخط فقط في مساحة.
وبالتالي ، قد يؤدي تسلسل أحرف طويل غير فارغ إلى الإخراج
يتجاوز عرض الخط المطلوب.

متى com.bibclean هو lexing ، يتم التفاف الخط عن طريق إدخال خط جديد مائل عكسي
الزوج عند الوصول إلى الحد الأقصى المحدد ، لذلك لن يتجاوز طول الخط أبدًا
الحد الأقصى.

- [لا] محاذاة يساوي
باستخدام الشكل الموجب ، قم بمحاذاة تسجيلات التساوي في تعيينات المفتاح / القيمة في
نفس العمود ، مفصولة بمسافة واحدة من سلسلة القيمة. وإلا فإن
علامة يساوي تتبع المفتاح ، مفصولة بمسافة واحدة. تقصير: لا.

- [no-] فحص القيم
باستخدام النموذج الموجب ، قم بتطبيق النمط الإرشادي المطابق لقيم الحقل في
من أجل اكتشاف الأخطاء المحتملة (على سبيل المثال ، ``عام = "192""بدلاً من"عام =
"1992"'') ، وإصدار تحذيرات عند العثور على أنماط غير متوقعة.

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

- [لا] حذف-قيم فارغة
باستخدام النموذج الموجب ، قم بإزالة جميع أزواج الحقول / القيم التي تكون القيمة لها
سلسلة فارغة. هذا مفيد في تنظيف الببليوجرافيات الناتجة عن النص
قوالب المحرر. قارن هذا الخيار مع - [no-] إزالة البادئات OPT وصف
أقل. تقصير: لا.

- [لا] وضع الملف
مع الشكل الإيجابي ، قم بإعطاء معلومات مفصلة عن موقع الملف في التحذير و
رسائل خاطئة. تقصير: لا.

- [لا] إصلاح تغيير الخط
باستخدام الشكل الإيجابي ، قم بتوفير مستوى قوس إضافي حول تغييرات الخط في
عناوين للحماية من التقليل من حجمها بواسطة بعض أنماط BibTeX. يغير الخط ذلك
لديها بالفعل أكثر من مستوى واحد من الأقواس لا يتم تعديلها.

على سبيل المثال ، إذا كان العنوان يحتوي على العبارة اللاتينية {\ م Dictyostelium ديسكويدوم}
or {\ م {د} ictyostelium {D} iscoideum}، ثم سيتم تحويل downcasing بشكل غير صحيح
العبارة لأحرف صغيرة. يتفاجأ معظم مستخدمي BibTeX من هذا الدعم
الأحرف الأولى لا تمنع عمل downcase. الترميز الصحيح هو
{{\ م Dictyostelium ديسكويدوم}}. ومع ذلك ، هناك أيضًا حالات مشروعة
حيث يحمي مستوى إضافي من التدعيم بشكل خاطئ من تقليل الحجم. بالتالي،
com.bibclean سوف عادة ليس قم بتوفير مستوى إضافي من الأقواس ، ولكن إذا كان لديك
قائمة المراجع حيث تكون الأقواس الزائدة مفقودة بشكل روتيني ، يمكنك استخدام هذا
خيار لتزويدهم.

إذا كنت تعتقد أنك بحاجة إلى هذا الخيار ، فهو كذلك بقوة أوصيت بأنك
تطبيق com.bibclean إلى ملف الببليوغرافيا الخاص بك مع وبدون -إصلاح-الخط-التغييرات,
ثم قارن بين ملفي الإخراج للتأكد من عدم وجود أقواس إضافية
يتم توفيرها في العناوين حيث لا ينبغي أن تكون موجودة. سيكون عليك أن تقرر
أي من ملفي الإخراج هو الخيار الأفضل ، ثم قم بإصلاح ملف
عنوان يستعد باليد.

نظرًا لأن تغييرات الخط في العناوين غير شائعة ، باستثناء حالات من النوع الذي
تم تصميم هذا الخيار للتصحيح ، يجب أن يكون أكثر نفعًا من الأذى. تقصير:
لا.

- [no-] تصحيح الأحرف الأولى
باستخدام الشكل الموجب ، أدخل مسافة بعد فترة بعد الأحرف الأولى من اسم المؤلف.
الافتراضي: نعم .

- [لا] إصلاح الأسماء
مع الشكل الإيجابي ، أعد الترتيب المؤلفة رئيس التحرير قوائم الاسم لإزالة الفواصل في
قوس المستوى صفر ، وضع الأسماء الأولى أو الأحرف الأولى من اسم العائلة. تقصير:
نعم .

- [لا] على الطراز الألماني
باستخدام الصيغة الموجبة ، فسر علامات الاقتباس ["] بالداخل استعدت قيمنا
السلاسل في مستوى القوس الأول وفقًا لاتفاقيات ملف نمط TeX
ألماني، والتي تفرط في الاقتباس لتبسيط مدخلات وتمثيل اللغة الألمانية
لهجات أوملاوت ، شارب (إس زييت) ، فواصل الأربطة ، واصلات غير مرئية ،
علامات الاقتباس المرتفعة / المخفضة ، والرقص الفرنسية ، والواصلات التقديرية. معروف
سيتم دعم مجموعات الأحرف لمنع BibTeX من تفسير
اقتباس كمحدد سلسلة.

لا تتلقى السلاسل المقتبسة أي معالجة خاصة من هذا الخيار ، ومنذ اللغة الألمانية
يجب حماية الأسماء الموجودة في العناوين على أي حال من عملية تقليص الأحرف لمعظم الأسماء
أنماط ببليوغرافيا BibTeX ، سلاسل القيمة الألمانية التي تستخدم الاقتباس المحمّل بشكل زائد
يمكن دائمًا إدخال الحرف بالشكل "{...}" ، دون الحاجة إلى التحديد
هذا الخيار على الإطلاق.

الافتراضي: لا.

- [لا] احتفظ بفواصل الخطوط
عادة ، يتم طي فواصل الأسطر داخل سلاسل القيمة في مسافة واحدة ، لذلك
يمكن لاحقًا كسر سلاسل القيمة الطويلة لتوفير سطور معقولة
الطول.

مع الشكل الموجب ، يتم الاحتفاظ بفواصل الأسطر في سلاسل القيمة. لو -الأعلى-
عرض مضبوطة على الصفر ، وهذا يحافظ على فواصل الأسطر الأصلية. تباعد في الخارج
سلاسل القيمة لا تزال تحت com.bibclean، ولا يتأثر بهذا
الخيار.

الافتراضي: لا.

- [no-] إبقاء parbreaks
باستخدام الشكل الموجب ، احتفظ بفواصل الفقرات (إما تغذية نموذجية أو سطور
تحتوي على مسافات فقط) في سلاسل القيمة. عادة ، فواصل الفقرات هي
انهار في فراغ واحد. تباعد في الخارج سلاسل القيمة لا تزال تحت
com.bibclean، ولا يتأثر بهذا الخيار. تقصير: لا.

- [لا] الاحتفاظ بمسافات التمهيد
باستخدام الشكل الموجب ، احتفظ بجميع المسافات في إدخالاتPreamble {...}.
الافتراضي: لا.

- [لا] مساحات حفظ
مع الشكل الموجب ، احتفظ بجميع المسافات في سلاسل القيمة. عادة،
تنهار مسافات متعددة في مساحة واحدة. يمكن استخدام هذا الخيار
مع - الحفاظ على فواصل الخطوط, -حفظ-parbreaksو العرض الأقصى 0 للحفاظ على
شكل سلاسل القيمة مع الاستمرار في توفير التحقق من بناء الجملة والقيمة.
التباعد في الخارج سلاسل القيمة لا تزال تحت com.bibcleanالسيطرة ، وليس كذلك
تتأثر بهذا الخيار. تقصير: لا.

- [لا] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
باستخدام الشكل الموجب ، احتفظ بجميع المسافات البيضاء في إدخالاتString {...}.
الافتراضي: لا.

- [لا] شظايا
باستخدام النموذج السالب ، فاصل فقرة (إما تغذية نموذج أو سطر
التي تحتوي على مسافات فقط) غير مسموح بها في سلاسل القيمة أو بين
أزواج الحقل / القيمة. قد يكون هذا مفيدًا لسرعة اصطياد السلاسل الجامحة الناشئة
من محددات غير متطابقة. تقصير: نعم .

- [لا] بريتي برينت
عادة، com.bibclean تعمل كطابعة جميلة. ومع ذلك ، مع السلبية
شكل هذا الخيار ، يعمل كمحلل معجمي بدلاً من ذلك ، ينتج تدفقًا
من الرموز المعجمية. انظر معجمي تحليل قسم دليل لمزيد من التفاصيل.
الافتراضي: نعم .

- [no-] أنماط الطباعة
باستخدام النموذج الموجب ، اطبع أنماط القيمة المقروءة من ملفات التهيئة
حيث يتم إضافتها إلى الجداول الداخلية. استخدم هذا الخيار للتحقق من إضافته حديثًا
الأنماط ، أو لمعرفة الأنماط المستخدمة.

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

- ملفات [no-] قراءة-init-files
باستخدام النموذج السلبي ، قم بإيقاف تحميل النظام ، والمستخدم ، والملف المحدد
ملفات التهيئة. سيأتي التهيئة فقط من تلك الملفات
صراحة من قبل -init- ملف اسم الملف خيارات. تقصير: نعم .

- [no-] إزالة البادئات OPT
باستخدام النموذج الموجب ، قم بإزالة البادئة `` OPT '' من كل اسم حقل حيث يكون ملف
القيمة المقابلة هي ليس سلسلة فارغة. يجب أن تكون البادئة `` OPT '' كاملة
في الأحرف الكبيرة ليتم التعرف عليها.

هذا الخيار مخصص للببليوجرافيات التي تم إنشاؤها بمساعدة GNU Emacs
دعم تحرير BibTeX ، والذي يقوم بإنشاء قوالب ذات حقول اختيارية
تم تحديده بواسطة بادئة `` OPT ''. على الرغم من أن الوظيفة مكس bibtex-إزالة-OPT
عادة ملزمة بضربات المفاتيح نسخة شارك يؤدي المهمة ، غالبًا ما ينسى المستخدمون ، مع
النتيجة أن BibTeX لا يتعرف على اسم الحقل ويتجاهل القيمة
خيط. قارن هذا الخيار مع - [لا] حذف-قيم فارغة موصوف بالاعلى.
الافتراضي: لا.

- [لا] الكاتب
باستخدام الصيغة الموجبة ، اقبل بناء جملة الإدخال المطابق لوثيقة الكاتب
نظام. سيتم تحويل الإخراج ليتوافق مع بناء جملة BibTeX. انظر
SCRIBE فهرس FORMAT قسم دليل لمزيد من التفاصيل. تقصير: لا.

- [لا] فتح ملف التتبع
باستخدام النموذج الموجب ، سجل في ملف سجل الأخطاء أسماء جميع الملفات
التي com.bibclean يحاول فتح. استخدم هذا الخيار لتحديد مكان
توجد ملفات التهيئة. تقصير: لا.

- [no-] تحذيرات
مع الشكل الإيجابي ، اسمح بجميع رسائل التحذير. الشكل السلبي هو ليس
موصى به لأنه قد يخفي المشكلات التي يجب إصلاحها. تقصير: نعم .

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

خطأ RECOVERY لأي لبس تحذيرات

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

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

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

للراحة ، تم إرسال السطر الأول من كل خطأ ورسالة تحذير إلى ستدير is
منسقة وفقًا لتوقعات GNU Emacs التالي الخطأ يأمر. أنت تستطيع
استدعاء com.bibclean مع إيماكس مكس تجميع bibclean اسم الملف > اسم الملف
الأمر ، ثم استخدم التالي الخطأ القيادة ، ملزمة عادة Cx ` (هذا قبر ، أو
back، accent) ، للانتقال إلى موقع الخطأ في ملف الإدخال.

إذا تم تجاهل رسائل الخطأ ، وتركت في ملف الببليوغرافيا الناتج ، فسوف يفعلون
التعجيل بخطأ عند معالجة الببليوغرافيا مع BibTeX بعد ذلك.

بعد إصدار رسالة خطأ ، com.bibclean ثم يعيد مزامنة مدخلاته بنسخه
حرفيا ل المعياري حتى يتم التعرف على إدخال ببليوغرافيا جديد في السطر الذي يتم فيه التعرف على
الحرف الأول غير الفارغ هو علامة (@). هذا يضمن عدم فقد أي شيء من ملف
ملف (ملفات) الإدخال ، مما يسمح بإجراء التصحيحات في ملفات الإدخال أو الإخراج.
ومع ذلك، إذا com.bibclean يكتشف خطأ داخلي في هياكل البيانات الخاصة به ، وسوف ينتهي
فجأة دون مزيد من المدخلات أو معالجة الإخراج ؛ هذا النوع من الخطأ لا ينبغي أبدا
إذا حدث ذلك ، وإذا حدث ذلك ، فيجب إبلاغ مؤلف البرنامج بذلك على الفور.
كما ستظهر أخطاء في ملفات التهيئة ونفاد الذاكرة الديناميكية على الفور
الانتهاء com.bibclean.

التهيئة FILES

com.bibclean يمكن تجميعها بواحد من ثلاثة أنواع مختلفة من مطابقة الأنماط ؛ الاختيار
تم إجراؤه بواسطة المثبت في وقت الترجمة:

تستخدم النسخة الأصلية اختبارات صريحة مشفرة يدويًا لبناء جملة سلسلة القيمة.

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

يستخدم الإصدار الثالث أنماطًا خاصة تأتي بالكامل من التهيئة
الملفات.

هذه النسخة Debianized من com.bibclean يستخدم الإصدار الثالث. ومع ذلك ، خيارات سطر الأوامر
يمكن أيضًا تحديدها في ملفات التهيئة ، بغض النظر عن اختيار مطابقة النمط
المحدد.

متى com.bibclean يبدأ ، بالبحث عن ملفات التهيئة ، باستخدام أول ملف
$ (HOME) /. bibcleanrc, / usr / share / bibcleanrcو / etc / bibcleanrc موجود. عقب ذلك مباشرة،
يقرأ الأول .bibcleanrc وجدت في البيبين مسار البحث. الاسم .bibcleanrc
يمكن تغييرها في وقت التشغيل من خلال إعداد متغير البيئة البيبكلياني. إذا
يبدأ الاسم بنقطة ، وسيتم تجريده عند النظر فيه / البيرة / مشاركة / الخ.

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

عندما يتم أخذ المدخلات من ستدين، لا توجد تهيئة خاصة بالملف.

للتحكم الدقيق ، فإن -لا يوجد قراءة- ملفات- init الخيار يمنع كافة ملفات التهيئة
باستثناء تلك المذكورة صراحة من قبل -init- ملفاسم الملف خيارات ، إما في سطر الأوامر ،
أو في ملفات التهيئة المطلوبة.

التنفيذ التكراري لملفات التهيئة المتداخلة -init- ملف الخيارات مسموح بها ؛
إذا كانت العودية دائرية ، com.bibclean سيحصل أخيرًا على ملف تهيئة غير فادح
فشل فتح بعد فتح عدد كبير جدًا من الملفات. هذا ينهي ملف التهيئة الإضافية
يعالج. مع تلاشي العودية ، يتم إغلاق جميع الملفات ، ثم يستمر التنفيذ
بشكل طبيعي.

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

٪ هذا ملف تهيئة bibclean صغير

-init-file /u/math/bib/.bibcleanrc ٪٪ أنماط الأقسام

الفصل = "\" D \ "" ٪٪ 23

الصفحات = "\" D - D \ "" ٪٪ 23--27

الحجم = "\" D \\ an \\ d D \ "" ٪٪ 11 و 12

سنة = \
"\" dddd، dddd، dddd \ "" \
"عدة سنوات محددة". ٪٪ 1989 ، 1990 ، 1991

-لا يوجد إصلاح-أسماء ٪٪ لا تعدل قوائم المؤلفين / المحررين

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

يجب أن يحتوي كل سطر منطقي على خيار كامل (وقيمته ، إن وجدت) ، أو كامل
حقل / نمط زوج ، أو حقل / نمط / رسالة ثلاثية.

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

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

يجب أن تكون سلاسل النقش محاطة بعلامات اقتباس ؛ ضمن هذه السلاسل ، شرطة مائلة للخلف
يبدأ آلية هروب تُستخدم بشكل شائع في برامج UNIX. الهروب المعترف به
التسلسلات هي:

\a جرس الإنذار (ثماني 007)

\b مسافة للخلف (ثماني 010)

\f فورمفيد (ثماني 014)

\n خط جديد (ثماني 012)

\r حرف إرجاع (رقم ثماني 015)

\t علامة تبويب أفقية (ثماني 011)

\v علامة تبويب عمودية (ثماني 013)

\ أوو رقم الحرف ثماني إنفست (على سبيل المثال \ 012 هو تغذية خطية). ما يصل إلى 3 أرقام ثماني
يستخدم.

\ 0xhh رقم الحرف الست عشري hh (على سبيل المثال، \ 0x0a هو تغذية خطية). xhh قد يكون في
كلا الحرفين. يمكن استخدام أي عدد من الأرقام السداسية العشرية.

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

ASCII NUL (\ 0) في سلسلة ستنهيها ؛ هذه هي سمة من سمات البرمجة سي
اللغة التي com.bibclean تم تنفيذه.

يمكن فصل أزواج الحقول / النمط بمسافة عشوائية ، واختيارياً ، إما يساوي
الإشارة أو القولون يعمل كعامل تعيين. وبالتالي ، فإن ما يلي متكافئ:

الصفحات = "\" D - D \ ""
الصفحات: "\" D - D \ ""
الصفحات "\" D - D \ ""
الصفحات = "\" D - D \ ""
الصفحات: "\" D - D \ ""
الصفحات "\" D - D \ ""

يمكن أن يكون لكل اسم حقل عدد تعسفي من الأنماط المرتبطة به ؛ ومع ذلك ، هم
يجب تحديده في تعيينات حقل / نمط منفصل.

تؤدي سلسلة النمط الفارغة إلى ظهور أنماط تم تحميلها مسبقًا لاسم هذا الحقل
نسي. تسمح هذه الميزة لملف تهيئة بتجاهل الأنماط تمامًا
من ملفات التهيئة السابقة.

يتم تمثيل أنماط سلاسل القيمة بلغة صغيرة ذات غرض خاص تكون كلاهما
مريحة ومناسبة لفحص بنية سلسلة القيمة الببليوغرافية. بينما لا
قوية كلغة أنماط التعبير العادي ، يمكن أن يكون تحليلها قابلاً للنقل
تم تنفيذه في أقل من 3٪ من التعليمات البرمجية في محلل التعبير العادي واسع الاستخدام (ملف
جنو REGEXP طَرد).

يتم تمثيل الأنماط بالأحرف الخاصة التالية:

مسافة واحدة أو أكثر

a حرف واحد بالضبط

A حرف واحد أو أكثر

d رقم واحد بالضبط

D رقم واحد أو أكثر

r رقم روماني واحد بالضبط

R رقم روماني واحد أو أكثر (أي رقم روماني)

w كلمة واحدة بالضبط (حرف أو أكثر من الأحرف والأرقام)

W كلمة واحدة أو أكثر مفصولة بمسافات ، تبدأ بكلمة وتنتهي

. شخصية "خاصة" واحدة ، واحدة من الشخصيات ! # () * +، -. /:؛؟ [] ~، أ
مجموعة فرعية من علامات الترقيم التي تُستخدم عادةً في قيم السلسلة

: حرف "خاص" واحد أو أكثر

X كلمة واحدة أو أكثر مفصولة عن بعضها البعض ، تبدأ بكلمة وتنتهي

\x x واحد بالضبط (x هو أي حرف) ، ربما مع تسلسل هروب
التفسير المقدم في وقت سابق

x بالضبط الحرف x (x ليس سوى واحد من هذه الأنماط
الشخصيات: aAdDrRwW: \)

تشير X شخصية النمط قوية جدًا ، لكنها غير مستحسنة بشكل عام ، لأنها تتطابق
تقريبًا أي شيء يمكن العثور عليه في سلسلة قيمة BibTeX. سبب تقديم
تطابق النمط على سلاسل القيمة هو الكشف عن الأخطاء المحتملة ، وليس إخفاءها.

لا يوجد شرط لتحديد نطاقات أو تكرار الأحرف ، ولكن هذا ممكن
عادة ما يتم ذلك بأنماط منفصلة. من الجيد إرفاق النمط بامتداد
تعليق يوضح نوع الشيء الذي يُتوقع مطابقته. هنا جزء من ملف
يعطي ملف التهيئة بعض الأنماط المستخدمة للمطابقة عدد سلاسل القيمة:

الرقم = "\" D \ "" ٪٪ 23
رقم = "\" AD \ "" ٪٪ PN LPS5001
number = "\" AD (D) \ "" ٪٪ RJ 34(49)
number = "\" AD \ "" ٪٪ XNSS 288811
number = "\" AD \\. D \ "" ٪٪ الإصدار 3.20
رقم = "\" AADD \ "" ٪٪ UMIAC-TR-89-11
رقم = "\" AAD \ "" ٪٪ CS-TR-2189
رقم = "\" AAD \\. D \ "" ٪٪ CS-TR-21.7

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

يجب أن تتأكد من استخدام سلاسل النمط الفارغة في ملف النمط هذا لتجاهل الأنماط
من ملفات التهيئة السابقة.

تحتوي سلاسل القيمة التي تم تمريرها إلى أداة مطابقة النمط على علامات اقتباس محيطة ، لذا فإن ملف
يجب أن أنماط أيضا. ومع ذلك ، يمكنك استخدام مواصفات نمط مثل "\" D "للمطابقة
سلسلة من الأرقام الأولية متبوعة بأي شيء آخر ؛ حذف الاقتباس النهائي
علامة \ "في النمط تسمح للمطابقة بالنجاح دون التحقق من التالي
الحرف في سلسلة القيمة هو علامة اقتباس.

لأن سلاسل القيمة مخصصة لتتم معالجتها بواسطة TeX ، مطابقة النمط
يتجاهل الأقواس ، وتسلسلات التحكم TeX ، جنبًا إلى جنب مع أي مسافة بعد تلك الضوابط
التسلسلات. يتم الحفاظ على المسافات حول الأقواس. تسمح هذه الاتفاقية بالنمط
شظية أ-أ-د لتتناسب مع سلسلة القيمة TN-K \ القطع 27-70، لأن القيمة
انهار ضمنيًا إلى تن-K27-70 أثناء عملية المطابقة.

com.bibcleanالإجراء العادي عندما تفشل قيمة سلسلة في مطابقة أي من القيم المقابلة
أنماط لإصدار تحذير أرسل شيئًا مثل هذا: "غير متوقع قيمنا in عام =
"192" ". في معظم الحالات ، يكون هذا كافيًا لتنبيه المستخدم إلى وجود مشكلة. في بعض
ومع ذلك ، قد يكون من المرغوب فيه ربط رسالة مختلفة برسالة معينة
نمط. يمكن القيام بذلك عن طريق توفير سلسلة رسالة تتبع سلسلة النمط.
تنسيق العناصر %% (نسبة مئوية واحدة) ، %e (اسم الدخول)، %f (اسم الحقل)، %k (مفتاح الاقتباس) و
%v (قيمة السلسلة) متاحة لتوسيع القيم الحالية في الرسائل. هنا
مثال:

فصل = "\" D: D \ "" "تم العثور على القولون في` `٪ f =٪ v ''" ٪٪ 23: 2

لتكون متسقة مع الرسائل الأخرى التي يتم إخراجها بواسطة com.bibclean، يجب أن تكون سلسلة الرسالة ليس النهاية
مع علامات الترقيم.

إذا كنت ترغب في جعل الرسالة خطأً ، بدلاً من مجرد تحذير ، فابدأها بامتداد
الاستعلام (؟) ، مثل هذا:

فصل = "\" D: D \ "" "؟ تم العثور على القولون في` `٪ f =٪ v ''" ٪٪ 23: 2

لن يتم تضمين الاستعلام في رسالة الإخراج.

يتم دعم تسلسل Escape في سلاسل الرسائل ، تمامًا كما هو الحال في سلاسل النمط.
يمكنك استخدام هذا للاستفادة من الأشياء الفاخرة ، مثل التحكم في وضع العرض في المحطة الطرفية. لو
قمت بإعادة كتابة المثال السابق كـ

الفصل = "\" D: D \ "" \
"؟ \ 033 [7mColon موجود في` `٪ f =٪ v '' \ 033 [0m" ٪٪ 23: 2

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

بالنسبة لبعض أنواع حقول الببليوغرافيا ، com.bibclean يحتوي على رمز الغرض الخاص لـ
استكمال أو استبدال مطابقة النمط:

· كودن, ISBN ISSN يتم التعامل مع قيم الحقول بهذه الطريقة بسبب التحقق من صحتها
يتطلب تقييم المجاميع الاختبارية التي لا يمكن التعبير عنها بأنماط بسيطة ؛ لا
تستخدم الأنماط حتى في هذه الحالات الثلاث.

· الفصل, عدد, صفحاتو حجم يتم فحص القيم فقط عن طريق مطابقة النمط.

· شهر يتم التحقق أولاً من القيم مقابل اختصارات شهر BibTeX القياسية ،
وفقط إذا لم يتم العثور على تطابق يتم استخدام الأنماط.

· عام يتم فحص القيم أولاً مقابل الأنماط ، ثم إذا لم يتم العثور على تطابق ، فسيتم فحص
يتم العثور على أرقام السنة وتحويلها إلى قيم صحيحة للاختبار مقابلها
حدود معقولة.

يتم فحص قيم الحقول الأخرى مقابل الأنماط فقط. يمكنك تقديم أنماط لـ
أي وقت المجال الذي تريده ، حتى منها com.bibclean لا يعرف عنها بالفعل. الجديد هو ببساطة
يضاف إلى جدول داخلي يتم البحث فيه عن كل سلسلة ليتم التحقق من صحتها.

المجال الخاص ، مفتاح، يمثل مفتاح الاقتباس الببليوغرافي. يمكن أن تعطى
الأنماط ، مثل أي مجال آخر. هنا ملف تهيئة نمط التعيين
سيطابق اسم المؤلف ونقطتين وسلسلة أبجدية وسنة مكونة من رقمين:

مفتاح = "A: إضافة" ٪٪ Knuth: TB86

لاحظ أنه لا توجد علامات اقتباس مضمنة في النمط ، لأن مفاتيح الاقتباس موجودة
غير مقتبسة. يمكنك استخدام هذه الأنماط للمساعدة في فرض اصطلاحات تسمية موحدة لـ
مفاتيح الاقتباس ، والتي تزداد أهمية مع نمو قاعدة بيانات الببليوغرافيا الخاصة بك.

معجمي تحليل

متى -لا-بريتي برينت محدد، com.bibclean يعمل كمحلل معجمي بدلاً من ملف
prettyprinter تنتج الإخراج في سطور من النموذج

" "

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

يتم تمثيل الأحرف الخاصة في سلسلة قيمة الرمز المميز باستخدام ANSI / ISO Standard C
تسلسلات الهروب ، لذلك يمكن تمثيل جميع الأحرف بخلاف NUL ومتعددة الأسطر
يمكن تمثيل القيم في سطر واحد.

فيما يلي أرقام الرموز المميزة وأسماء أنواع الرموز التي يمكن أن تظهر في الإخراج عندما
- بريتي برينت محدد:

0 غير معروف
1 أبريف
2 AT
3 فاصلة
شنومك كومنت
5 دخول
6 يساوي
7 الميدان
8 تضمين
9 مضمن
10 مفتاح
11 سوار
12 حرفيا
13 خط جديد
14 ديباجة
15 ربريس
16 شارب
مساحة 17
18 سلسلة
19 قيمة

يجب أيضًا إعداد البرامج التي تحلل مثل هذا الإخراج للأسطر التي تبدأ بـ
بادئة التحذير ، ٪٪ ، أو بادئة الخطأ ، ؟؟ ، ورقم سطر ANSI / ISO القياسي C.
توجيهات النموذج
# سطر 273 "texbook1.bib"
التي تسجل رقم السطر واسم ملف ملف الإدخال الحالي.

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

كمثال على استخدام -لا-بريتي برينت، خط أنابيب قيادة UNIX
com.bibclean -لا-بريتي برينت mylib.bib | \
AWK '$ 2 == "KEY" {print $ 3}' | \
عطش -e / "// g '| \
sort
سيستخرج قائمة مرتبة بجميع مفاتيح الاقتباس في الملف mylib.bib.

سيتم إجراء قدر معين من المعالجة على الرموز المميزة. بخاصة،
سيتم استبدال المحددات المكافئة للأقواس بالأقواس ، وسوف يتم استبدال السلاسل المقواة
أصبحت سلاسل مقتبسة.

يتم استخدام نوع الرمز المميز LITERAL للنص التعسفي الذي com.bibclean لا تفحص أكثر ،
مثل محتوياتPreamble {...} أوComment {...}.

يجب ألا يظهر نوع الرمز المميز غير المعروف في تدفق الإخراج. يتم استخدامه داخليا ل
تهيئة متغيرات نوع الرمز المميز.

SCRIBE فهرس FORMAT

com.bibcleanيعتمد دعم تنسيق ببليوغرافيا Scribe على وصف بناء الجملة
في دليل المستخدم التمهيدي للناسخ ، الإصدار الثالث ، مايو 3. كان الكاتب في الأصل
تم تطويره بواسطة Brian Reid من جامعة Carnegie-Mellon ، ويتم تسويقه الآن بواسطة Unilogic ،
المحدودة.

تأثر تنسيق ببليوغرافيا BibTeX بشدة بواسطة Scribe ، وفي الواقع ، بعناية ،
من الممكن مشاركة ملفات المراجع بين النظامين. ومع ذلك ، هناك
هناك بعض الاختلافات ، لذا إليك ملخص لميزات ملف ببليوغرافيا Scribe
شكل:

(1) حالة الأحرف ليست مهمة في أسماء الحقول وأسماء الإدخال ، ولكن يتم الاحتفاظ بالحالة
في سلاسل القيمة.

(2) في أزواج الحقل / القيمة ، يمكن فصل الحقل والقيمة بواحد من ثلاثة
الأحرف: = أو / أو مسافة. قد يحيط الفضاء اختياريًا بهذه الفواصل.

(3) محددات القيمة هي أي من هذه الأزواج السبعة: {} [] () <> "" ""
`

(4) لا يجوز تداخل محددات القيمة ، على الرغم من وجود أزواج المحددات الأربعة الأولى ،
المحددات المتداخلة المتوازنة لا لبس فيها.

(5) يمكن حذف المحددات حول القيم التي تحتوي فقط على أحرف وأرقام وحادة
(#) وعلامة العطف (&) والنقطة (.) والنسبة المئوية (٪).

(6) خارج القيم المحددة ، يتم تمثيل علامة at-الحرفية (@) بمضاعفة عند-
علامات (@@).

(7) تبدأ إدخالات الببليوغرافيا بـname ، كما هو الحال بالنسبة لـ BibTeX ، ولكن أي من المؤلفين السبعة
يمكن استخدام أزواج محدد القيمة لإحاطة القيم في أزواج الحقل / القيمة. مثل
في (4) ، تُحظر المحددات المتداخلة.

(8) قد تفصل المساحة التعسفية أسماء الإدخال عن المحددات التالية.

(9)Comment هو أمر خاص يتم تجاهل قيمته المحددة. كما في (4) ، متداخل
المحددات ممنوعة.

(10) النموذج الخاص

Begin {comment}

End {تعليق}

يسمح بتغليف النص التعسفي الذي يحتوي على أي أحرف أو محددات ، أخرى
من "End {comment}". يمكن استخدام أي من أزواج المحددات السبعة حول
كلمة `` تعليق '' بعد ``Begin '' أو ``End '' ؛ المحددات في الاثنين
لا يلزم أن تكون الحالات هي نفسها ، وبالتالي ، ``Begin {comment} '' / "End {comment}"
قد أزواج ليس تكون متداخلة.

(11) و مفتاح الحقل مطلوب في كل إدخال ببليوغرافيا.

(12) يُفترض أن يكون الاقتباس المائل للخلف في سلسلة من علامات TeX ، ويتم تقويته
بشكل مناسب. في حين أن مثل هذه اللكنات لا تتوافق مع بناء جملة Scribe ، تنسيق Scribe
تم العثور على الببليوجرافيات التي يبدو أنها مخصصة لمعالجة TeX.

بسبب هذا التركيب الفضفاض ، com.bibcleanأساليب الكشف عن الخطأ العادية أقل
فعال ، وبالتالي ، إدخال وضع الكاتب ليس هو الافتراضي ؛ يجب أن يكون صريحًا
المطلوب.

البيئة المتغيرات

الكتاب المقدس امتداد الملف لملفات التهيئة الخاصة بببليوغرافيا. تقصير: . الأولية.

البيبكلياني اسم com.bibclean ملفات التهيئة. تقصير: .bibcleanrc.

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

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