tagbar
1.0.0
TagBar هو مكون إضافي VIM يوفر طريقة سهلة لتصفح علامات الملف الحالي والحصول على نظرة عامة على هيكله. يقوم بذلك عن طريق إنشاء شريط جانبي يعرض العلامات التي تم إنشاؤها بواسطة CTAGS للملف الحالي ، والتي تم طلبها بواسطة نطاقها. هذا يعني أنه على سبيل المثال ، يتم عرض الطرق في C ++ ضمن الفئة التي يتم تعريفها فيها.
TagBar ليس أداة للأغراض العامة لإدارة ملفات tags . إنه ينشئ فقط العلامات التي تحتاجها في الذاكرة أثناء التنقل دون إنشاء أي ملفات. يتم توفير إدارة ملفات tags عن طريق الإضافات الأخرى ، مثل Gutentags على سبيل المثال.
VIM> = 7.3.1058 أو أي نسخة من Neovim.
تطبيق CTAGS: نوصي بشدة بأي نسخة من CTAGs Universal. إنه شوكة محفوظة من CTAGs المفرطة مع العديد من مجموعات الأخطاء ، ودعم العديد من التنسيقات ، ودعم Unicode المناسب.
CTAGs الغزيرة 5.5 أو أعمال أعلى إلى حد ما ولكن سيتم إهمالها في نهاية المطاف.
يمكن أيضًا التعامل مع بعض التنسيقات الإضافية من قبل مقدمي الخدمات الآخرين مثل JSCTAGS أو PHPCTAGs.
استخراج الأرشيف أو استنساخ المستودع في دليل في 'runtimepath' ، أو استخدم مدير إضافي من اختيارك مثل Pathogen. لا تنسَ تشغيل :helptags إذا لم يفعل مدير البرنامج المساعد الخاص بك ذلك من أجلك حتى تتمكن من الوصول إلى الوثائق مع :help tagbar .
إذا لم يتم تثبيت CTAGS القابلة للتنفيذ في أحد الدلائل في متغير بيئة $PATH الخاص بك ، يجب عليك تعيين متغير g:tagbar_ctags_bin ، راجع الوثائق لمزيد من المعلومات.
ضع شيئًا مثل ما يلي في ~/.vimrc:
nmap <F8> :TagbarToggle <CR> إذا قمت بذلك ، فسيقوم مفتاح F8 بتبديل نافذة TagBar. يمكنك بالطبع استخدام أي اختصار تريده. للاطلاع على طرق أكثر مرونة لفتح وإغلاق النافذة (وبقية الوظائف) ، راجع الوثائق التي تستخدم :help tagbar .
بالنسبة إلى الأنواع ، لا تدعمها CTAGs المفرطة ، تحقق من الويكي لمعرفة ما إذا كانت المشاريع الأخرى تقدم الدعم لهم وكيفية استخدامها. يرجى إضافة أي مشاريع/تكوينات أخرى تجدها أو تنشئها حتى يتمكن الآخرون من الاستفادة منها أيضًا.
إذا لاحظت أن هناك بعض الأخطاء في الطريقة التي يتم بها عرض بنية ملفك في Tagbar ، فيرجى التأكد من أن الخلل موجود بالفعل في TagBar قبل الإبلاغ عن مشكلة. نظرًا لأن TagBar يستخدم ctags veberant والبرامج المتوافقة للقيام بتوصيل الملف الفعلي ، فمن المحتمل أن يكون الخطأ في البرنامج المسؤول عن هذا filetype بدلاً من ذلك.
هناك مثال في :h tagbar-issues حول كيفية تشغيل CTAGs يدويًا حتى تتمكن من تحديد مكان وجود الخطأ بالفعل. إذا كان الخطأ في CTAGs فعليًا ، فيرجى الإبلاغ عن ذلك على موقع الويب الخاص بهم بدلاً من ذلك ، حيث لا يوجد شيء يمكنني فعله حيال ذلك في Tagbar. شكرًا لك!
يمكنك أيضًا إلقاء نظرة على أخطاء CTAGS التي سبق تقديمها ضد Tagbar.
يتم توزيع Tagbar بموجب شروط ترخيص VIM ، راجع ملف الترخيص المضمن.
تم كتابة Tagbar في الأصل بواسطة Jan Larres. يتم الحفاظ عليه بنشاط من قبل كاليب ماكلينان وديفيد هيغلاند. ساهم 75 آخرين على الأقل بميزات وإصلاحات الأخطاء على مر السنين. يرجى توثيق المشكلات أو إرسال طلبات سحب على Github.
