tldr-pages هو مجموعه من الملخصات لأكثر الخيارات استخداما مع الأدوات المختلفة
يتم كتابته بواسطة المجتمع كبديل مختصر لملف التعليمات الخاص بالأداة كما يتم استضافة المستندات علي مستودع GitHub , يمكنك البحث من خلال محرك البحث الخاص بالمستندات من خلال الرابط التالي
سنتناول اليوم طريقة استخدام اداة الطرفية للوصول للمستندات بسهوله
مثال توضحي لإستعمال الأداة
في حال أردت ان تفك ضغط ملف باستعمال الامر zip و تريد إستذكار الأمر المستخدم لفك الضغط هناك ثلاث طرق سريعة بداخل الطرفية
خيارman مناسب في حال أردت أن تعرف تفاصيل البرنامج فمخرج الأمر يتكون من توثيق الأداة المحتوي علي كل الخيارات المتاحة
خيار help-- يختلف من برنامج لأخر جرت العادة أن يحتوي علي الخيارات الموجودة لتشغيل البرنامج
أداة اليوم tldr تحتوي علي ملخص كتبه مستخدمين اخرين لتذكيرك باهم الأوامر التي قد تحتاج اليها
لاحظ الفرق
معني TL;DR
اختصار ل “Too Long Didn’t Read” و تعني طويل جدا لم اقرأه
و تستخدم للتعبير عن ملخص مختصر جدا للمقال موجه لمن لا يملك الوقت لفراءته
ما هو tldr-pages
tldr-pages هو مستودع يتم اضافة المستندات الخاصة بكل برنامج اليه , بإمكانك تصفح المستندات المتاحة باللغة الإنكليزية من هنا و العربية من هنا
ستلاحظ قلة المستندات العربية لعدم وجود مساهمين كثر , بإمكانك المشاركه في كتابة المستندات عبر اضافتها الي المستودع
تحميل الأداة
المستودع عبارة عن مستندات فقط هناك عدة أدوات للطرفية تتصفح هذه المستندات و سنستخدم اشهرها و المكتوبة بلغة بايثون
تقوم بالتحميل بواسطة مدير حزم بايثون pip باستخدام الأمر
pip install tldr
الأداة موجوده علي مستودعي ارش و فيدورا و بإمكانك تحميلهم باستخدام
#arch
sudo pacman -S tldr
#federo
sudo dnf install tldr
استعمال و تخصيص الأداة
الاستخدام
نكتب الأمر متبوعا بإسم الأداة في حالتنا هنا تصفحنا الخيارات الشائعة للأمر ip
اللغة
لتحديد اللغة نضيف الخِيار -L يتبعه اللغة
و لتغير اللغة الإفتراضية نضيف متغير البيئة TLDR_LANGUAGE
مثال للغة العربيه مع صدفية bash
echo "export TLDR_LANGUAGE='ar' " >> ~/.bashrc
في حال لم يتوفر المستند باللغة العربية سيعرض الخاص باللغة الإنجليزية
النظام
لتحديد مستند نظام غير الحالي استخدم الخيار
-pثم النظام من بين الخيارات المتاحة [linux, osx, sunos, windows, common]
تحديث الكاش
لتحديث النسخة المتوفرة علي ذاكرة الجهاز و الحصول علي احدث نسخة من المستودع الخاص بالمستندات قم بكتابة الأمر
ltdr -u
تنبيه لأهمية الكتيب و طريقة الاستخدام الأمثل للأداه
الأداة لا تغني عن التوثيق فهي تحتوي علي أهم الأوامر بشكل ملخص علي عكس التوثيق الذي يحتوي علي جميع الأوامر التي قد تحتاجها , جميعنا نثتثقل قراءة التوثيق في البداية, مع الوقت ستتعلم استخلاص الفوائد منه و تحسين طرق استعمالك لأدواتك ما دمت تملك الوقت استخدم man و تصفح الخيارات المتاحة و قم بتجربتها , مع الوقت ستتقن إستخدام أدواتك
و أنت أخبرنا بتجربتك مع التوثيق
- افضل البحث في حال أحتجت للميزة أو استخدام معين
- استهوي قرائة التوثيق لأكتشف خبايا الأداة
- مدرك لأهميه التوثيق لذلك أحاول قرائة التوثيق للأدوات التي أستخدمها بشكل مستمر
- خيار اخر سأذكر في التعليقات
المصادر
ترخيص
هذا الموضوع يتبع ترخيص جميع مواضيع أسس هو CC-BY-SA 4.0
هذا الموضوع فائز بجائزة أسس للكتابة
هذا الموضوع فائز بجائزة أسس للكتابة وهي اول جائزة عربية مخصصة للكتابة عن البرمجيات الحرة والمفتوحة.
الموضوع متوفر على مدونة gnulinuxsa هنا: