الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

Texdoc - ابحث عن الوثائق في Tex Live وعرضها

معلومات عامة

  • الموقع الإلكتروني: https://www.tug.org/texdoc/
  • المستودع: https://github.com/tex-live/texdoc/
  • القائمة البريدية: [email protected]

باستخدام Texdoc

Texdoc جزء من توزيع Tex Live. بشكل عام ، ليس عليك تثبيته بنفسك.

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

كيفية تثبيت الإصدار تطوير

باستخدام bundler

أسهل طريقة لتثبيت إصدار تطوير Texdoc هي استخدام Bundler and Rake: 

bundle install
rake install

إذا كنت ترغب في إلغاء تثبيت الإصدار تطوير (لاستخدام إصدار Tex Live) ، فقط حاول: 

rake uninstall

التثبيت يدويًا

هنا ، تعني $TEXDOC المسار إلى مصادر Texdoc Dev التي تم استنساخها (أو تنزيلها) kpsewhich --var-value TEXMFHOME ويشير $TEXMFHOME

  • الأمر. symlink أو نسخ $TEXDOC/script $TEXMFHOME/scripts/texdoc .
  • ملف التكوين. symlink أو نسخ $TEXDOC/texdoc.cnf مثل $TEXMFHOME/texdoc/texdoc-dist.cnf (لاحظ الجزء -dist ). سيتغلب تمامًا على ملفات التكوين الأخرى باستثناء $TEXMFHOME/texdoc/texdoc.cnf والتي لا يزال بإمكانك استخدامها في الإعدادات الشخصية.

يمكنك التأكد من استخدام الملفات الصحيحة عن طريق تشغيل texdoc --files : يحتوي السطر الأول على المسار الكامل لإصدار texdoclib.tlu المستخدمة ، والباقي يسرد ملفات التكوين المستخدمة.

الملفات في هذا المستودع

  • doc/ يحتوي على الوثائق ،
  • script/ يحتوي على الرمز المصدر ،
  • spec/ دليل لاختبار البرامج النصية ، و
  • texdoc.cnf هو ملف التكوين الافتراضي.

بناء واختبار

يتم تعريف العديد من مهام البناء على أنها مهام أشعل النار.

توليد جميع الوثائق

سيؤدي ما يلي إلى إنشاء كل من PDF و Manpage في doc/ Directory. 

rake doc

إنشاء ملف ذاكرة التخزين المؤقت مسبقًا

سيؤدي ما يلي إلى إنشاء script/Data.tlpdb.lua الذي تم تحريكه مسبقًا. يجب أن يتم هذه المهمة تحت إعداد Tex Live مع TLPDB. 

rake gen_datafile

Running tests

سيتم تشغيل ما يلي جميع الاختبارات في spec/ الدليل. 

rake test

بدلاً من ذلك ، يمكنك إعطاء أسماء المواصفات مع خيار --list ( -l ) لهذه المهمة. على سبيل المثال ، سيتم تشغيل ما يلي فقط spec/action/help_spec.rb و spec/mode/list_spec.rb : 

rake test -- -l action/help,mode/list

إظهار جميع المهام المتاحة

سيظهر فيما يلي جميع المهام المتاحة مع وصف قصير. 

rake -T

بالإضافة إلى ذلك ، بالنسبة للمهام المتاحة للخيارات ، على سبيل المثال ، rake test و rake run_texdoc ، يمكنك الحصول على معلومات الخيارات مع -h خيار لكل مهمة: 

rake test -- -h

مزيد من المعلومات

يمكن العثور على مزيد من المعلومات المحددة ، مثل قائمة TODO لهذا المشروع وبعض المعلومات للموزعين ، في ويكي مستودع GitHub الخاص بنا. يرجى زيارة:

  • https://github.com/tex-live/texdoc/wiki

حقوق الطبع والنشر والترخيص

حقوق الطبع والنشر 2008-2024 Manuel Pégourié-Gonnard ، Takuto Asakura ، Tex Live Team.

يتم توزيع هذه الحزمة بموجب شروط رخصة GNU العامة العامة كما تم نشرها بواسطة Free Software Foundation ، إما الإصدار 3 من الترخيص ، أو (وفقًا لخيارك) أي إصدار لاحق.

العمل السابق (برنامج TEXDOC) في المجال العام:

  • مساهمات من راينهارد كوتوشا (2008).
  • إصدارات Texlua الأولى من قبل Frank Küster (2007).
  • نص شل الأصلي من تأليف توماس إيسر ، ديفيد أسبينال ، وسيمون ويلكينسون.
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل