قم بإنشاء ملف تعليمات Sandcastle لموقع ويب بدون خيار "ملف وثائق Xml".

Question

أحاول إنشاء ملف مساعدة Sandcastle لموقع ويب.في نافذة خصائص المشروع، لا توجد أي خيارات لإنشاء ملف وثائق XML المطلوب لـ Sandcastle.

تحتوي علامة التبويب "إنشاء" في صفحات الخصائص فقط على خيارات لما يلي:بدء الإجراء وبناء إجراء الحل والتحقق من إمكانية الوصول.ليس لدي أي خيارات للإخراج أو ملف وثائق XML، مثل مشاريعي الأخرى.

لا يحتوي موقع الويب الذي أعمل معه على ملف ‎.proj فعلي، مما قد يكون هو المشكلة.إذا كانت هذه هي المشكلة، فما هي أفضل طريقة لإنشاء واحدة لمشروع يخضع للتحكم بالمصادر ويعمل عليه العديد من الأشخاص بأقل قدر من التعطيل؟

وهذا باستخدام Visual Studio 2005 Professional.

Answer 1

المشكلة في مواقع الويب في VS2k5 هي أنه عندما يتم تجميعها، تكون ملفات dll الناتجة في حالة من الفوضى.لا توجد مساحات أسماء، وأسماء غريبة، وما إلى ذلك.

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

Answer 2

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

تحديث:لقد قمت بتجربته ويعمل مع المواقع العادية.المشكلة الوحيدة التي يمكنني رؤيتها هي أن مواقع الويب لا تحتوي على مساحات أسماء.لذلك عندما أقوم بتشغيله ، أحصل على موضوع بواسطة FolderName_WebPage format دون أي مجموعة منطقية.لذلك هو alhpabetic من قبل المجلد والصفحة اسم.بمجرد إنشاء المحتوى ، يمكنك تحرير ملف المساعدة باستخدام HelpCompiler / Builder وتجميع الموضوعات حسب الحاجة.