Sandcastle दस्तावेज़ वेबसाइट में लिंक की तरह एमएसडीएन कैसे बनाएं?

Question

मैंने सैंडकैसल के साथ अपने प्रोजेक्ट का एक वेबसाइट प्रलेखन तैयार किया है। यह वेबसाइट फ़्रेम का उपयोग करती है, इसलिए जब मैं साइट पर क्लिक करता हूं तो ब्राउजर में मेरा यूआरएल नहीं बदलता है।

जब मैं Sandcastle से उत्पन्न वेबसाइट प्रलेखन के माध्यम से ब्राउज़ करता हूं तो मैं ब्राउज़र में यूआरएल बदलना चाहता हूं। क्यूं कर? क्योंकि मैं अपने डेवलपर पर्यावरण के अन्य हिस्सों से दस्तावेज़ीकरण के ठोस उपपृष्ठों से लिंक करना चाहता हूं।

और और भी मैं यह लिंक स्थायी रखना चाहता हूं। इसलिए जब मैं एक बार फिर से अपनी परियोजना के नए संस्करण से दस्तावेज उत्पन्न करता हूं, तो लिंक नहीं बदलेंगे ताकि मुझे सभी लिंक नए में बदलने की आवश्यकता न पड़े।

क्या यह संभव है और इसे कैसे लागू किया जाए?

Answer 1

आदेश दस्तावेज के विशिष्ट उपपृष्ठ आप समान अनुरोध का उपयोग कर सकते करने के लिए सही लिंक बनाने के लिए: $ DOCUMENTATION_ROOT $/index.aspx विषय = html/$ TOPIC_ID $ .htm

जैसे http://www.ewoodruff.us/shfbdocs/Index.aspx?topic=html/8dcbb69b-7a1a-4049-8e6b-2bf344efbbc9.htmhttp://www.ewoodruff.us/shfbdocs/html/8dcbb69b-7a1a-4049-8e6b-2bf344efbbc9.htm

Answer 2

के बजाय आप SplitScreen.js के शीर्ष करने के लिए नीचे दिए गए कोड जोड़ दें, तो ब्राउज़र टीओसी फ्रेम "इंजेक्षन" होगा और सामग्री से सीधा जुड़ा (चाल विटाली Shibaev से पता चला है का उपयोग) पर ध्यान केंद्रित।

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

इस कोड को यह काम करता है प्रलेखन अपनी वेबसाइट की जड़ में रख दिया गया है - आप एक उप फ़ोल्डर में है, तो आप पर? "/ विषय" का विस्तार और से उप-फ़ोल्डर हिस्सा हटाने की जरूरत पथनाम भाग।

इस परिवर्तन के साथ आप "सीधा लिंक" का उपयोग कर सकते हैं। मैं उन लोगों से भी अपेक्षा करता हूं जो आपको Google के माध्यम से ढूंढते हैं, एक बेहतर अनुभव प्राप्त करते हैं (वे जिस सामग्री की खोज करते हैं और टीओसी बार) प्राप्त करते हैं।

Answer 3

Vitaliy और mawtex ने आपके प्रश्न के 'दस्तावेज़ उपपृष्ठों को कैसे लिंक करें' हल किया है।

"लिंक बनाना स्थायी है इसलिए दस्तावेज़ों को पुनर्जीवित करते समय वे बदलते नहीं हैं" आपके प्रश्नों का हिस्सा स्वचालित रूप से हल हो जाता है, क्योंकि HTML फ़ाइल नाम डिफ़ॉल्ट रूप से विषय नाम के हैश पर आधारित होते हैं। अर्थात। यदि आप अपने कोड का हिस्सा नहीं बदलते हैं जिसे आप दस्तावेज कर रहे हैं, तो यह उसी फ़ाइल नाम का उपयोग करेगा।

आप एचटीएमएल फ़ाइल नाम उत्पन्न करने के तरीके को बदल सकते हैं, लेकिन सभी दिए गए तरीके सदस्य नाम या विषय आईडी के हैश पर आधारित हैं, इसलिए यदि कोड नहीं बदला गया है तो लिंक तोड़ना नहीं चाहिए।

अधिक जानकारी के लिए Sandcastle सहायता फ़ाइल निर्माता NamingMethod दस्तावेज़ देखें।