كيفية إنشاء MSDN مثل الروابط في موقع توثيق Sandcastle؟

Question

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

أرغب في تغيير عنوان URL في المتصفح عندما أتصفح توثيق موقع الويب الذي تم إنشاؤه مع Sandcastle. لماذا ا؟ لأنني أرغب في الارتباط بالصفوف الفرعية الملموسة من الوثائق من أجزاء أخرى من بيئة المطورين الخاصة بي.

علاوة على ذلك ، أود الحصول على هذه الروابط دائمة. لذلك عندما أقوم بإنشاء توثيق مرة أخرى من إصدار جديد من مشروعي ، لن تتغير الروابط حتى لا أحتاج إلى تغيير جميع الروابط إلى New.

هل هذا ممكن وكيفية هذا؟

Answer 1

من أجل إنشاء روابط صحيحة إلى صفحات فرعية محددة من الوثائق ، يمكنك استخدام طلب مماثل: $ documentation_root $/index.aspx؟ topic = html/$ topic_id $ .htm

على سبيل المثال http://www.ewoodruff.us/shfbdocs/Index.aspx?topic=html/8dcbb69b-7a1a-4049-8e6b-2bf344efbbc9.htmبدلاً من http://www.ewoodruff.us/shfbdocs/html/8dcbb69b-7a1a-4049-8e6b-2bf3444efbc9.htm

Answer 2

إذا قمت بإضافة الرمز أدناه إلى أعلى SplitScreen.js سيقوم المتصفح "بحقن" إطار TOC والتركيز على المحتوى الذي ربطته مباشرة (باستخدام خدعة Vitaly Shibaev التي أظهرها).

if (window==top) {
    window.location = "/?topic=" + (window.location.pathname.substring(1));
}

يعمل هذا الرمز ، يتم وضع الوثائق في جذر موقع الويب الخاص بك-إذا كان لديك في مجلد فرعي ، فأنت بحاجة إلى التوسع في "Topic/؟ Topic" وإزالة الجزء الفرعي من جزء المسار.

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

Answer 3

فيتالي و mawtex قمت بحل جزء "كيفية الارتباط إلى الوثائق الفرعية" من سؤالك.

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

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

انظر Sandcastle Help File Builder's Namingmethod وثائق لمزيد من المعلومات.