تحويل Doxygen إلى تعليقات XML

Question

لدينا مشروع C# يستخدم لأسباب تاريخية كل من تعليقات نمط Doxygen و Visual Studio في نفس الرمز. هل حاول أي شخص أن يترجم بشكل منهجي معيارًا إلى آخر ، ويفضل أن يكون ذلك إلى مجموعة XML المشتركة؟

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

Answer 1

أعلم أن الأمر مرت بعض الوقت منذ أن طلبت ، لكنني واجهت نفس المشكلة. إليكم مشروعي مفتوح المصدر لمدة 10 دقائق والذي من شأنه أن يجعل التحويل أقل ألمًا. :-) الامتدادات مرحب بها!

https://code.google.com/p/doxygentoxmlconverter/

Answer 2

لم تتضمن الإجابة الأصلية على هذا السؤال سوى رابط ، لذلك أفعل نفس الشيء:

أولاً الرابط أعلاه قديم ، إليك نسخة أحدث من الرابط: وصلة,

بجانب لقد أضفت متغيرًا جديدًا تمامًا من SCRIPT من الحل: وصلة

نظرًا لأن نص Python الأصلي لم ينجح بالنسبة لي لأنه في حالتي ، كان لدينا " Brief" تدوين بدلاً من "brief" ، لذلك كتبت بلدي. (أنا لا أتحدث بيثون حتى الآن)

ميزة مفتاح مهمة واحدة هي أنه يمكنك إضافة ترجمة العلامة بسهولة ، أو تخطي بعضها:

translate["\\fn"]     = "skip";
translate["\\def"]    = "skip";
translate["\\class"]  = "skip";
translate["\\enum"]   = "skip";
translate["\\struct"] = "skip";
translate["\\author"] = "skip";
translate["\\brief"]  = "summary";
translate["\\param"]  = "param";
translate["\\return"] = "returns";

في وقت لاحق ، وجدت أيضًا الإصدار الجديد من البرنامج النصي الأصلي Python ، لذلك آمل ألا يضطر أحد لبدءه من الصفر مرة أخرى!

إذا كنت قد وجدت "الرابط فقط" للنص الجديد في وقت سابق ، فقد يحميني من بعض الصداع.