المزايا النسبية للxdoc وصيغ ملائمة

Question

ما هي المزايا النسبية للxdoc وصيغ ملائمة لكتابة المواقع من مشاريع مخضرم؟ هي واحدة أكثر تعبيرا من غيرها؟ واحدة حصلت أداة دعم أفضل من الآخر؟

Answer 1

وتنسيق XDOC هو بالتأكيد آلية أكثر ثراء وثائق إنشاء ومطلوب إذا كنت تريد أن تنتج وثائق مع TOC / TOF والرؤوس والتذييلات أو الحواشي (وسمات وثيقة أخرى)، منذ شكل APT لا يدعم هذه.

وأن يقال، وأنا أميل إلى استخدام شكل APT عن وثائق داخلية كلها تقريبا وأنا أستمتع الكتابة في شكل APT. بالمقارنة مع كتابة XDOC (مع كل المحبة XML الخاصة به)، APT هو نسيم. وعلى نفس المنوال، وعندما كنت أكتب البرنامج المساعد الذي يولد المحتوى، وأنا أميل إلى استخدام تنسيق XDOC، لأنه من السهل جدا لكتابة البرامج التي تخلق XML المطلوب.

Answer 2

وشكل APT سهل الاستخدام. ومع ذلك، فإنه لا يعتمد التصميم حسب الطلب (على سبيل المثال التصميم حرف أو العنوان). الأقرب إلى النص مسبقا التي يمكنك استخدامها مع APT هو "النص الحرفي" في مثل HTML، النص الحرفي غير مهيأة مسبقا. على عكس HTML، ونجا النص الحرفي: داخل عرض الحرفي، لا يتم تفسير العلامات من قبل المعالج APT

.