هل من الممكن دمج صفحتين تم إنشاؤه بواسطة Sandcastle في صفحة رئيسية واحدة؟

Question

لكل فصل في المشروع، يخلق Sandcastle (من بين أمور أخرى) صفحتين:

• الصفحة الرئيسية، تسمى كما T_class_full_name, مع الوصف، بناء الجملة، التسلسل الهرمي للميراث ونرى أيضا
• صفحة الأعضاء، تسمى AllMembers_T_class_full_name, مع المنشئين والأساليب والحقول، إلخ.

هل هناك طريقة لدمج هذين معا - مع members page يجري إلحاق الصفحة الرئيسية؟

Answer 1

لا أستطيع تقديم إجابة عاملة لهذا الغرض، لكن يمكنني تقديم بعض الأفكار التي قد تعمل إذا كان شخص ما على استعداد للاختراق معه:

1. يحدد التكوين htmlbody.xsl بعض الهيكل بما في ذلك قسم مع اختبار للأعضاء: <xsl:if test="$subgroup='members'"> إذا تم تشغيل هذا على مستوى الفصل (أو تعيينه فقط، فقد يمنحك فكرة عن كيفية إنتاج هذا الإخراج. (لا أعتقد أنه سيكون هناك إعداد رصاصة سحرية هنا).

2. هنا (أعتقد) حيث تتم إضافة وصلات إلى مجموعات فرعية الأعضاء، وأود أن ألعب أيضا مع هذا:

<!-- add a link to the member list section for this subgroup -->
<a href="#{$elementVisibility}Toggle" onclick="OpenSection({$elementVisibility}Toggle)">

3. لدي أفكار أخرى تحاول اللعب مع الهيكل، لكنني سأحتاج إلى اختراقها لتوفير أي إجابة واضحة. أنا لست بالقرب من التأكد من أن htmlbody.xsl هو المكان المناسب للقيام بذلك. إذا كان لدي بالفعل حاجة هنا، أعتقد أنه يمكنني تحقيق هدفك أسهل عن طريق القيام بما يلي:

• توليد الوثائق بالطريقة القياسية
• تحليل الوثائق التي تم إنشاؤها ودمج الاثنين باستخدام محلل DOM / XML (أي دمج اثنين من التعليمات البرمجية وإخراج مستند HTML صفحة واحدة جديدة مع تحديث عناوين URL إلى المراسين على الصفحة الحالية)

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

التحذير: أنا لست قريبا من خبير ساندككاسل، بعد أن استخدمته قبل الحد الأدنى وعلى مدار عام. أنا أيضا لم أنفقت في أي وقت قبل اليوم للنظر في كيفية اختراقها، فقط استخدامها خارج الصندوق. لن أجيب حتى الآن على هذا باستثناء عدم وجود ردود أخرى. قد يكون هناك طريقة تكوين مدعومة لإنجاز هذا، لكنني لا يمكن للمستخدم غير الرسمي أن يفكر حتى كيفية التعامل معها.

أنا أيضا جعل بعض الافتراضات هنا حول كيفية النظر إلى إخراج HTML بناء على تجربتي مع SHFB. قد أكون قد تجاوزت هناك أيضا. لم يعد لدي مشروع يمكنني إنشاء وثائق Sandcastle من، ولكن إذا كان بإمكان شخص ما نشر رابط لبعض إخراج HTML من Sandcastle وهو مهتم بهذا النهج سأكون سعيدا بالمساعدة.