सार्वजनिक ज्ञान के आधार के लिए संगम: डिजाइन में बदलाव और भाषा पृथक्करण स्थापित करना

हमारे पास छह उत्पाद हैं जो रूस और विदेशों में उपयोग किए जाते हैं। इसका मतलब यह है कि उनके लिए प्रलेखन एक जगह पर होना चाहिए, लेकिन उत्पादों और भाषाओं द्वारा विभाजित।

हम मीडियाविकि का उपयोग करते थे, लेकिन समय के साथ यह पुराना हो गया। मंच से, हमने लेखों के एक अच्छे लेआउट, लचीली खोज और एक आंतरिक पाठ संपादक की भी अपेक्षा की। एक विकल्प के रूप में संघर्ष को चुना गया था।

इस प्रक्रिया में, यह स्पष्ट हो गया कि इस प्लेटफ़ॉर्म की क्षमताएँ हमारे सभी कार्यों के लिए पर्याप्त नहीं हैं। मुझे स्क्रॉल व्यूपोर्ट प्लगइन खरीदना था और इसे स्थापित करने में कुछ समय बिताना था।

आप देख सकते हैं कि अंत में क्या हुआ , और मैं आपको बताऊंगा कि कैसे मैंने डिज़ाइन को बदल दिया, भाषा पृथक्करण, आंतरिक खोज और अनुक्रमण स्थापित किया।

डिज़ाइन को बदलें

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

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

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

स्क्रॉल व्यूपोर्ट प्लगइन

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

थीम रिक्त स्थान के लिए बनाई गई हैं। कंफ्लुएंस में स्पेस कंटेंट एंटिटीज हैं जो किसी एक प्रोजेक्ट के बारे में जानकारी स्टोर करती हैं। हमारे पास उत्पादों के लिए जगह है: ISPmanager, BILLmanager, आदि, साथ ही साथ मुख्य पृष्ठ के लिए। अंतरिक्ष में एक कुंजी, एक शीर्षक, कई सेटिंग्स और वास्तव में एक विषय है।

स्क्रॉल व्यूपोर्ट में थीम का संपादन: लेआउट, स्टाइल और html

आइए स्क्रॉल व्यूपोर्ट की खोज शुरू करें। जब प्लगइन स्थापित और सक्षम होता है, तो आपको गियर पर क्लिक करने की आवश्यकता होती है और फिर - मूल सेटिंग्स - अनुभाग स्क्रॉल व्यूपोर्ट - थीम ।

एक विषय का चयन करें, प्रतिलिपि बनाएँ या बनाएँ और संपादित करें पर क्लिक करें । स्क्रॉल व्यूपोर्ट थीम एडिटर खुलता है।

कृपया ध्यान दें कि स्क्रॉल व्यूपोर्ट स्क्रैच से थीम बनाने की नहीं, बल्कि स्क्रॉल वेबहेल थीम को आधार के रूप में लेने की सलाह देता है।


स्क्रॉल व्यूपोर्ट थीम एडिटर: बाईं ओर थीम संरचना है, शीर्ष पर फ़ाइल नाम है, मुख्य भाग में फ़ाइलें स्वयं हैं

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

मार्कअप: संपादित करें, कक्षाएं जोड़ें और एक ही प्रकार के तत्वों को एक लूप में प्रदर्शित करें

पृष्ठ संरचना प्रकार द्वारा

विषय की जड़ में मुख्य टेम्पलेट हैं: page.vm, search.vm, error.vm, साथ ही थंबनेल.पिंग थीम कवर छवि।

टेम्पलेट "page.vm" विषय के सभी पृष्ठों की संरचना को परिभाषित करता है। यहां आप html को संपादित कर सकते हैं और यह निर्दिष्ट करने के लिए कि सामग्री कहाँ प्रदर्शित होगी, प्लेसहोल्डर्स चर का उपयोग करें। प्लेसहोल्डर अंतरिक्ष या उपयोगकर्ता डेटा (सामग्री का शीर्षक, स्थान का नाम, लेखक का नाम) की सामग्री को संदर्भित करते हैं, उनकी पूरी सूची डेवलपर स्क्रॉल व्यूपोर्ट के सहायता केंद्र में पाई जा सकती है।

“Page.vm” उन टेम्पलेट्स को संदर्भित करता है जो “शामिल” फ़ोल्डर में एक स्तर कम हैं और उन्हें टैग और ब्लॉक में लपेटता है। इस फ़ाइल (page.vm) में, हम पृष्ठ को टुकड़ों में इकट्ठा करते हैं, और एक html दस्तावेज़ के सभी आवश्यक गुणों के साथ मार्कअप को पूरक करते हैं। यह यहां है कि हम सिद्धांत को निर्दिष्ट करते हैं, सिर और शरीर को निर्धारित करते हैं।

पृष्ठ तत्व

"शामिल करें" फ़ोल्डर में पृष्ठ के टुकड़े हैं। फ़ाइल नामों से आप अनुमान लगा सकते हैं कि इनमें से कौन ज़िम्मेदार है:

• शामिल- htmlhead.vm में वह सब कुछ शामिल है जो हम आमतौर पर एक html दस्तावेज़ के प्रमुख में इंगित करते हैं: स्टाइल शीट, फ़ॉन्ट फ़ाइलों तक पहुंच, मानक कॉन्फ्लुएंस और स्क्रॉल व्यूपोर्ट स्क्रिप्ट सहित कुछ स्क्रिप्ट;
• शामिल-हेडरबार। एमएम हेडर संरचना सेट करता है;
• शामिल- footer.vm पाद लेख संरचना सेट करता है;
• शामिल- content.vm मुख्य सामग्री ब्लॉक की संरचना का वर्णन करता है;
• शामिल- sidebar.vm साइड मेनू के लेआउट का वर्णन करता है, जिसमें आमतौर पर अंतरिक्ष में सभी लेखों की एक सूची होती है।

स्क्रॉल व्यूपोर्ट टेम्पलेट सिंटैक्स को समझना आसान है। संचालन एक जाली से शुरू होता है, उदाहरण के लिए "#if (स्थिति)" या "#foreach ($ भाषा में उपलब्ध भाषा। उपलब्ध)", और ऑपरेटर के शरीर के अंदर "#end" के साथ समाप्त होता है। बाकी सब HTML टैग्स हैं।

स्टाइल: शैली, चित्र और स्क्रिप्ट जोड़ें

"एसेट्स" फोल्डर के अंदर, js और css फाइलें जमा हो जाती हैं। चूंकि हमने स्क्रैच से थीम नहीं बनाई है, इसलिए इसमें पहले से ही स्क्रॉल व्यूपोर्ट के डेवलपर्स की फाइलें हैं।

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

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

एक नया डिज़ाइन बनाते समय, हमने प्लगइन की क्षमताओं को ध्यान में रखा और स्क्रॉल व्यूपोर्ट में मौजूदा विषयों पर ध्यान केंद्रित किया, इसलिए कुछ समय के लिए परिसंपत्तियों / जेएस के अंदर मैं सुस्त रहा। मौजूदा स्क्रिप्ट फ़ाइलों में छोटे बदलाव किए और आवश्यक पुस्तकालयों की फ़ाइलों को जोड़ा। यदि परिवर्तन अधिक महत्वपूर्ण हैं, तो आपको अधिक विस्तार से लिपियों से निपटना होगा।

लेख सामग्री के लिए HTML सामग्री संपादक

स्क्रॉल व्यूपोर्ट के साथ काम करने की प्रक्रिया में, यह पता चला कि हम टाइपसेट कर सकते हैं, लेकिन सभी नहीं। प्लगइन टेम्पलेट अनुमतियाँ चर $ page.renderContent के साथ समाप्त होती हैं। मुख्य कक्षाओं और लिंक के साथ तत्वों को कैसे लेआउट करें? यह स्पष्ट नहीं है। HTML कहाँ है? डिफ़ॉल्ट रूप से, यह वहां नहीं है। चर हमें बताता है कि हमें लेआउट का हिस्सा सीधे लेख पृष्ठ पर पूरा करना होगा, हालांकि, अभी तक केवल पाठ को वहां संपादित किया जा सकता है, लेकिन वे टैग नहीं हैं।



सौभाग्य से, आप हमेशा प्लगइन्स की खोज कर सकते हैं, और क्या भाग्य, सही एक लगभग तुरंत मिल गया था। यह कॉन्फ्लुएंस सोर्स एडिटर है। इसे स्थापित करने के बाद, आप लेख संपादन मोड में अच्छे पुराने हाइपरटेक्स्ट को भी आकर्षित कर सकते हैं। अंत में!


स्रोत संपादक प्लगइन

स्क्रॉल व्यूपोर्ट में हम हेडर, साइडबार, फूटर बनाते हैं और स्टाइल सेट करते हैं। हम स्रोत संपादक का उपयोग करके सामग्री लगाते हैं। कुल में, मैंने दो विषय बनाए: लेख पृष्ठों के लिए और मुख्य दस्तावेज़ पृष्ठ के लिए।

व्यूपोर्ट स्पेस सेटिंग: थीम को लागू करें

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

वांछित उत्पाद का स्थान दर्ज करें, स्पेस सेटिंग्स खोलें - ऐड-ऑन । यहां आप व्यूपोर्ट बना सकते हैं और प्रबंधित कर सकते हैं: थीम, सामग्री प्रकार, अनुमतियां, डोमेन और पथ सेट करें।


एक विषय के साथ अंतरिक्ष को जोड़ने के लिए एक रूप, एक व्यूपोर्ट बना

एक विषय चुनें

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

सामग्री टैब आपको उस सामग्री के प्रकार का चयन करने की अनुमति देता है जिसमें विषय लागू होगा। यह हमारे लिए कम से कम रुचि है, क्योंकि अंतरिक्ष की कुंजी स्वचालित रूप से हटा दी जाती है।

पते निर्धारित करें

URL टैब पर, आप डोमेन और पथ का चयन कर सकते हैं, जिसके साथ ही स्थान खुलेगा, साथ ही पतों की संरचना भी निर्दिष्ट करेगा। भाषा द्वारा प्रलेखन को दो भाषाओं में विभाजित करने की भी आवश्यकता होगी।

दो प्रकार के URL संरचना हैं:

• बहु-स्तरीय - पथ अंतरिक्ष लेखों और पृष्ठ नामों के पदानुक्रम को दर्शाता है,
• एक-स्तर - सभी लेख संख्यात्मक प्रत्यय के साथ समान स्तर पर उपलब्ध हैं

पृष्ठ के पते के साथ एक अति सूक्ष्म अंतर है। विभिन्न भाषाओं के लेखों के लिए, Confluence URL को अलग तरीके से उत्पन्न करता है। अंग्रेजी में, नाम प्रदर्शित करता है, और रूसी में - अक्षरों, वर्णों और संख्याओं का एक विशाल सेट। स्क्रॉल व्यूपोर्ट आपको पतों को एक फॉर्म में लाने की अनुमति देता है। यदि आप एक बहु-स्तरीय संरचना चुनते हैं, तो रूसी लेखों का पता अनुवाद किए गए पाठ का नाम प्रदर्शित करेगा।

लेकिन ध्यान रखें कि बहु-स्तरीय URL चुनते समय, URL लेख के शीर्षक पर निर्भर करेगा। नाम बदल जाएगा - लेख का पता भी बदल जाएगा। यदि आप एकल-स्तरीय संरचना का चयन करते हैं, तो पता कम पठनीय और समझने योग्य होगा, लेकिन अब पृष्ठ शीर्षक पर निर्भर नहीं होगा।

हमने एक बहुस्तरीय प्रकार की संरचना और पठनीय पतों को चुना है, लेकिन हमें लेख के शीर्षक के परिवर्तन की निगरानी करनी होगी और समय में पुनर्निर्देशन की स्थापना करनी होगी। और हम अभी भी सही विकल्प की तलाश कर रहे हैं। हम छोटे लिंक का भी उपयोग करते हैं जो हमेशा लेख की ओर ले जाते हैं और बदलते नहीं हैं, इस तरह के लिंक को पृष्ठ के सूचना अनुभाग में पाया जा सकता है।

विषय शामिल करें

अनुमतियाँ टैब में, आप निर्दिष्ट कर सकते हैं कि कौन से उपयोगकर्ता व्यूपोर्ट का उपयोग करके स्थान देख पाएंगे।

अनाम उपयोगकर्ताओं को केवल दिए गए डिज़ाइन में दस्तावेज़ देखने के लिए, आपको दो चेकमार्क लगाने होंगे:

• कॉन्फ्लुएंस यूआई तक पहुंच को प्रतिबंधित करें,
• उपयोगकर्ताओं को देखने के लिए स्वचालित रूप से पुनर्निर्देशित करें।

अनुमतियाँ टैब में स्थान दृश्य सेटिंग

भाषा पृथक्करण स्थापित करें

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

स्क्रॉल व्यूपोर्ट ऐसी सेटिंग्स प्रदान करता है, लेकिन यदि आप डोमेन नाम क्षेत्र में URL टैब में मुख्य डोमेन से अलग एक डोमेन दर्ज करते हैं, तो दो डोमेन काम नहीं करेंगे। यह स्क्रॉल व्यूपोर्ट प्लगइन की एक विशेषता है।

रिवर्स प्रॉक्सी को कॉन्फ़िगर करना आवश्यक है ताकि उपयोगकर्ता अनुरोध कॉन्फ्लुएंस द्वारा प्रेषित हों और दो डोमेन में हल हो जाएं - स्क्रॉल व्यूपोर्ट निर्देश देखें (Nginx और TOMCAT के लिए कॉन्फ़िगरेशन)। उसके बाद, आपको सह-संपादन मोड को बंद करना होगा या अतिरिक्त परिवर्तन करना होगा । अब आप व्यूपोर्ट सेटिंग्स में दो डोमेन में से एक को निर्दिष्ट कर सकते हैं।

विभिन्न भाषाओं के लिए विषय-वस्तु

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

वास्तव में, मैं ऐसे विषय बनाता हूं जो शैली में समान हैं, लेकिन उनके लिए टेम्पलेट अलग-अलग हैं, मुख्य रूप से पाठ के संदर्भ में। यह एक अतिरिक्त और दोहराव है, हां, लेकिन मुझे अभी तक दूसरा रास्ता नहीं मिला है। इसके अलावा, विषय खोज को भी नियंत्रित करता है, और यह भाषा द्वारा अलगाव के पक्ष में एक और तर्क है।

नतीजतन, मुझे चार विषय मिले: रूसी और अंग्रेजी में मुख्य पृष्ठों के लिए दो, और प्रत्येक भाषा के लिए सामग्री पृष्ठों के लिए दो और।

साइट खोज अनुकूलित करें

खोज पैरामीटर "शामिल" फ़ोल्डर से फ़ाइलों में कॉन्फ़िगर किए गए हैं। उनके अंदर हम खोज पैरामीटर सेट करते हैं:

• शामिल- quicksearch.vm सभी सामग्री पृष्ठों पर खोज क्षेत्र के लिए जिम्मेदार है,
• शामिल- search.vm खोज परिणाम पृष्ठों की संरचना सेट करता है।

जहां देखो

डिफ़ॉल्ट रूप से, खोज केवल वर्तमान स्थान पर काम करती है। उदाहरण के लिए, ISPmanager स्पेस में - ISPmanager के बारे में लेखों पर। यदि आपको रिक्त स्थान की सूची की खोज करने की आवश्यकता है, तो आपको शामिल की-quicksearch.vm की सेटिंग में उनकी कुंजी निर्दिष्ट करने की आवश्यकता है।

<div id="ht-search"> #set($search = "/search") #if ($stringUtils.equals(${viewport.link}, "/") == false) #set($search = "${viewport.link}/search") #end <div class="ht-search-input"> <form action="$search" method="GET"> <input class="search-input" type="text" autocomplete="off" name="q" value="$!searchRequest.queryString" placeholder="  ?"/> <input type="hidden" name="max" value="20" /> <input type="submit" style="display:none" value="Submit"> ## --- START --- Scroll Versions and Scroll Translations Integration ------------------------------------------- #if ($versions || $variants || $languages) #if($versions) <input id="version" type="hidden" name="scroll-versions:version-name" value="$versions.current.value"/> #end #if($variants) <input id="variant" type="hidden" name="scroll-versions:variant-name" value="$variants.current.value"/> #end #if($languages) <input id="language" type="hidden" name="scroll-translations:language-key" value="$languages.current.value"/> #end #end ## --- END ----------------------------------------------------------------------------------------------------- </form> </div> </div> 

व्यक्तिगत स्थान के लिए खोज फ़ॉर्म

 <div id="ht-search"> #set($search = "/search") #if ($stringUtils.equals(${viewport.link}, "/") == false) #set($search = "${viewport.link}/search") #end <div class="ht-search-input"> <form action="$search" method="GET"> <input class="search-input" type="text" autocomplete="off" placeholder="  ?" name="q" value="$!searchRequest.queryString" /> <input type="hidden" name="s" value="BILLmgr" /> <input type="hidden" name="s" value="VMKVM" /> <input type="hidden" name="s" value="VMmgr5Cloud" /> <input type="hidden" name="s" value="VMmgr5OVZ" /> <input type="hidden" name="s" value="DCImgr" /> <input type="hidden" name="s" value="IPmgr5" /> <input type="hidden" name="s" value=" ISPmgr5BUSINESS" /> <input type="hidden" name="s" value="ISPmgr5Lite" /> <input type="hidden" name="s" value=" DNSmgr" /> <input type="hidden" name="s" value=" COREmgr" /> <input type="hidden" name="max" value="20" /> <input type="submit" style="display:none" value="Submit"> ## --- START --- Scroll Versions and Scroll Translations Integration ------------------------------------------- #if ($versions || $variants || $languages) #if($versions) <input id="version" type="hidden" name="scroll-versions:version-name" value="$versions.current.value"/> #end #if($variants) <input id="variant" type="hidden" name="scroll-versions:variant-name" value="$variants.current.value"/> #end #if($languages) <input id="language" type="hidden" name="scroll-translations:language-key" value="$languages.current.value"/> #end #end ## --- END ----------------------------------------------------------------------------------------------------- </form> </div> </div> 

रिक्त स्थान सूची खोज प्रपत्र

परिणाम कैसे प्रदर्शित करें

खोज परिणामों की सूची इस तरह दिखेगी, जिसमें शामिल हैं- search.vm टेम्प्लेट सेट। मेरे मामले में, प्रत्येक लिंक में एक शीर्षक, विवरण और उस स्थान का नाम है, जहां लेख है। यहां आप यह निर्दिष्ट कर सकते हैं कि यदि खोज में कुछ नहीं मिला तो उपयोगकर्ता क्या देखेगा।

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

  <div id="ht-wrap-container"> <div id="search-results"> #if ($searchResults.total > 0) #foreach($result in $searchResults.items) <section class="search-result"> #set( $space = '' ) #if( $result.type == 'page' ) #set( $space = $result.getObject().fromConfluence.getSpace().getName() ) #end <header> <h4> <a href="$result.link">$result.displayTitle</a> </h4> </header> <div class="search-result-content"> <p class="search-result-desc">$result.getDescription(280)</p> #if( $space ) <p class="search-result-space">$space</p> #end </div> </section> #end #else <h4>    :(</h4> <p>   ,     .</p> #end <div class="search-results-pager"> #if($pager.hasPrev) <a class="back" href="$pager.prevLink"></a> #end #foreach ($pagerPage in $pager.pages) <a href="$pagerPage.link" #if ($pagerPage.current) class="current" #end>$velocityCount</a> #end #if($pager.hasNext) <a class="next" href="$pager.nextLink"></a> #end </div> </div> </div> </div> </section> 

खोज पृष्ठ कैसा दिखता है

"Search.vm" टेम्प्लेट खोज पृष्ठों की संपूर्ण संरचना को परिभाषित करता है, जो शुरुआती टैग से शुरू होता है। इस टेम्पलेट में, आपको खोज फ़ॉर्म और उसके परिणाम को एक साथ लाना चाहिए। परिणामस्वरूप, हमें "खोज" प्रकार का एक पृष्ठ मिलता है, जिसमें खोज प्रपत्र और मिलान शामिल हैं, जो कई पृष्ठों में विभाजित हैं।

पृष्ठ के आगे की संरचना में स्थित सभी प्रथम-स्तरीय टेम्पलेट पृष्ठ के ढांचे को उसके प्रकार के आधार पर पुनर्परिभाषित करते हैं। तो search.vm खोज पृष्ठों का लेआउट सेट करता है, और error.vm त्रुटि पृष्ठों को सेट करता है।

यह तत्वों के लिए शैलियों को सेट करने के लिए बनी हुई है, लिपियों को जोड़ना संभव है, और हमारा विषय कार्यात्मक हो जाता है, डिजाइन के अनुसार कार्य करता है और दिखता है।

अनुक्रमण को अनुकूलित करें

अनुक्रमण को कॉन्फ़िगर करने के लिए, आपको साइट मैप को रूट फ़ोल्डर में रखना होगा। लेकिन हमारे पास रूट फ़ोल्डर नहीं है, क्योंकि कॉन्फ्लुएंस एक जावा एप्लिकेशन है, न कि साइट। क्या करें?

संकेत स्क्रॉल व्यूपोर्ट प्रलेखन में पाया गया था। फैलने वाले पृष्ठों के स्थान के अंदर जहां मुख्य पृष्ठ संग्रहीत है, आपको एक नया लेख बनाने की आवश्यकता है, इसे साइटमैप कहें। xml और इसे मुख्य पृष्ठ के एक स्तर नीचे रखें।

स्थान महत्वपूर्ण है क्योंकि, जैसा कि दस्तावेज़ीकरण में उल्लेख किया गया है, नक्शा फ़ाइल पथ के उपसर्ग "/" के साथ व्यूपोर्ट के लिए उपलब्ध नहीं होगी। मुख्य पृष्ठ पर व्यूपोर्ट स्थान के लिए बस ऐसा उपसर्ग।


अंतरिक्ष संरचना में साइटमैप ।xml लेख

हमें याद है कि कॉन्फ्लुएंस में, लेख का शीर्षक और उसके URL संबंधित हैं। जब पृष्ठ बनाया जाता है और पहले से ही docs.ispsystem.com/sitemap-xml पर खुलता है , तो हम इसके सही प्रदर्शन का ध्यान रखेंगे । यह URL प्रारूप काफी विशिष्ट नहीं है, लेकिन यह हमारे अनुरूप होगा।

एक साइट का नक्शा अनावश्यक टैग और शैलियों के बिना होना चाहिए, क्योंकि यह खोज इंजन के लिए बनाया गया है। पहले से परिभाषित शैलियों को साइटमैप पर लागू होने से रोकने के लिए, आपको एक शामिल-साइटमैप बनाने की आवश्यकता है। टेम्पलेट और उसमें तैयार साइटमैप की सामग्री की प्रतिलिपि बनाएँ - साइटमैप। Xml। यह इस तरह दिखेगा:



अब साइटमैप पेज के लिए, पेज .vm टेम्पलेट में एक अलग स्थिति बनाएं ताकि टेम्पलेट से शैलियों और संरचना साइट मानचित्र को छोड़कर सभी पृष्ठों पर लागू हो।

शर्त के लिए एक पहचानकर्ता की आवश्यकता होती है। आप इसे पृष्ठ को खोलकर पहचान सकते हैं, और फिर एलिप्सीस - पेज सूचना पर क्लिक करके, पता बार के अंत में एक पहचानकर्ता होगा। अब हम शर्त लिखते हैं:

 #if ($page.id == 25370522) $include.template("/include/include-sitemap.vm") #else /   / 

वर्णित जोड़तोड़ के बाद, साइट के नक्शे का पथ यैंडेक्स और Google वेबमास्टर्स के पैनल में निर्दिष्ट किया जा सकता है, और अनुक्रमण शुरू हो जाएगा।

सामान्य तौर पर, अनुक्रमण का मुद्दा मेरे लिए खुला रहता है। यह पूरी तरह से स्पष्ट नहीं है कि कनफ्लुएंस सामग्री पृष्ठ कैसे अनुक्रमित किए जाते हैं। आपको यह सोचने की ज़रूरत है कि प्रक्रिया को कैसे स्वचालित किया जाए।

ऐसी बातें

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