سؤال
أحاول إنشاء RDoc باستخدام تنسيق XML.إليك الأمر الذي أستخدمه:
$ rdoc --fmt=xml --opname=api.xml
تم إنشاء الملف ولكن لم يتم إنشاء قائمة الأساليب.أنا استخدم rdoc (2.4.3)
.يتضمن قالب RDoc لـ XML علامات لعرض الطريقة.
هل هو ممكن؟
المحلول
منذ الإصدار 2.4، أصبح إخراج XML غير مدعوم.انظر على سبيل المثال. هذه المدونة من أحد المشرفين :
تم نقل مولدات HTML وXML إلى حالة غير قابلة للصيانة
- لن يتم توفير أي جوهرة لأنه من الصعب جدًا تشغيلها
- الخيارات التي تمت إزالتها - ملف واحد، - النمط =، - مصدر مضمّن، - غير شرعي، - اسم المرجع
لا أعتقد أنه يمكنك تشغيل الإصدار 2.4.3 - فالخيارات التي تحددها في المثال الخاص بك لا تعمل مع هذا الإصدار.لقد قمت للتو بتنزيل أحدث إصدار من الأحجار الكريمة وأكدت ذلك:
$ rdoc --format=xml --opname=api.xml
invalid argument: --format=xml
ربما لديك نسخة أقدم من rdoc
المثبتة التي تظهر في وقت سابق في الخاص بك $PATH
?
حاولت rdoc 1.0.1
وحصلت على السلوك الذي تصفه (إخراج XML، لا توجد طرق).لذا يبدو أن الإجابة على سؤالك هي "لا، هذا غير ممكن (كان به عربات التي تجرها الدواب، والآن غير مدعوم)".
يمكنك محاولة اقتراح هذا باعتباره طلب المواصفات, ، على الرغم من أنه يبدو أنه لن يحدث لفترة من الوقت، إذا حدث ذلك.