Doxygen for Mac - Download

لقد كنت أتصارع مع الوثائق القديمة أو المفقودة في مشاريعي الجانبية لسنوات. إنه مثل محاولة تصحيح التعليمات البرمجية التي لم يتم التطرق إليها منذ ستة أشهر وفجأة اختفت التعليقات. وذلك عندما وجدت Doxygen لنظام التشغيل Mac - تنزيل لنظام التشغيل Mac. بصراحة، إنه ليس مبهرجًا، لكنه يعمل فقط. لقد قمت بإسقاطه وتشغيله على مشروع C++ مع عدد قليل من التعليقات // الموضوعة بشكل جيد، والازدهار - أصبحت مستندات HTML جاهزة في أقل من دقيقة. لا يوجد معالج إعداد، ولا يوجد تسجيل دخول، فقط أشر وانطلق.

الاشياء الجيدة

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

والتكوين؟ بسيطة ولكنها مرنة. يمكنك تعديل ملف .cfg لتجاهل ملفات معينة، وتضمين الرؤوس، وتعيين تنسيق الإخراج (HTML، LaTeX، RTF)، ويتم تشغيله فقط. لقد قارنتها بـ Javadoc وSphinx، وعلى الرغم من أن هؤلاء لديهم المزيد من الأجراس والصفارات، فإن Doxygen ينجز المهمة دون أن يجعلني أشعر وكأنني أحارب الأداة.

غير جيد

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

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

خلاصة القول

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