توليد (وتثبيت) وثائق Doxygen مع AutoTools
https://stackoverflow.com//questions/10682603
italiano
english
français
española
中国
日本の
العربية
Deutsch
한국어
Português
Russianسؤال
أنا أكتب مكتبة (باستخدام libtools)، حيث تتم جميع وثائق API باستخدام Doxygen.
أتساءل عما إذا كانت هناك طريقة سهلة لإدماج تثبيت وثائق Doxygen التي تم إنشاؤها في AutoTools.
أنا الشكل أن بناء الوثائق يجب أن يكون سهلا بما فيه الكفاية. ولكن بمجرد ركضت Doxygen، ما هي الطريقة الصحيحة للحصول على ملفات .html التي تم إنشاؤها (E.G.) في $ (htmldir)؟
يبدو أن المشكلة لا أعرفها (ولا أريد أن أعرف) التي ستخلق الملفات doxygen من أجلي، لذلك لا أستطيع تعدادها بالكامل في HTML_DATA
أنا أعرف شيئا مثل 'html_data= html /*.*' هو سيئة فكرة
المحلول
بينما ليس لدي الكثير من الخبرة مع autotools نفسي، يتم إجراء عدة اقتراحات على مؤشر ترابط البريد الذي قد يكون استخدامه: http://old.nabble.com/TD17029178.HTML
نصائح أخرى
قد يكون أكثر إحكاما لاستخدام بعض وحدات الماكرو المساهمة.هنا لدي معرفة طريقة بسيطة بناء على الأمثلة من كتاب Autotools من قبل John Calcote Pg 246.
أضف ما يلي لتكوينه. ساك فقط فوق giveacodicetagpre.
خط giveacodicetagpre.
في دليل ProjectDir / مستندات
إضافة ملفين: doxyfile.in و makefile.am
استخدام متغير الاستبدال على سبيل المثال: giveacodicetagpre.
ثم إجراء تعديل مناسب لحقول تكوين Doxygen الأخرى. giveacodicetagpre.
بهذه الطريقة سوف تقوم بتوليد ملف PDF.
يجب أن يكون makefile.am بسيطا: giveacodicetagpre.
(تأكد من احترام المسافة البادئة MICFILE أثناء نسخ هذا.)
يبدو أن هذا قد عمل لي.يتم إنشاء الوثائق الناتجة في مجلد المستندات.واسمحوا لي أن أعرف إذا قمت بأي أخطاء.
يمكنني استخدام ماكرو من oren ben-kiki، راجع http://www.ben-kiki.org/oren/ doxample/ أو جوجل ذلك.يقوم البرنامج النصي بإنشاء وثائق Doxygen بتنسيق PDF / HTML / MAN (شكلي).
أضف ملفات التعليمات التي تم إنشاؤها إلى قائمة * dist_doc_data * في makefile.am، للحصول عليها مثبتة.
