अपाचे JSPWiki 2.11 - दस्तावेज़ीकरण

Apache सॉफ़्टवेयर फाउंडेशन (ASF) को एक या अधिक योगदानकर्ता लाइसेंस समझौतों के तहत लाइसेंस प्राप्त है। इस कार्य के साथ वितरित NOTICE फ़ाइल देखें जो कॉपीराइट स्वामित्व के बारे में अतिरिक्त जानकारी प्रदान करती है। ASF आपको इस फ़ाइल को Apache लाइसेंस, संस्करण 2.0 (जिसे "लाइसेंस" कहा जाता है) के तहत लाइसेंस देता है; आप लाइसेंस के अनुपालन के अलावा इस फ़ाइल का उपयोग नहीं कर सकते। आप निम्नलिखित पते पर लाइसेंस की एक प्रति प्राप्त कर सकते हैं:

   http://www.apache.org/licenses/LICENSE-2.0

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

लाइसेंस फ़ाइल LICENSE में पाई जा सकती है।

JSPWiki क्या है?

JSPWiki एक सरल (ठीक है, अब नहीं) WikiWiki क्लोन है, जो Java और JSP में लिखा गया है। WikiWiki एक वेब साइट है जो किसी को भी इसके विकास में भाग लेने की अनुमति देती है। JSPWiki सभी पारंपरिक विकी सुविधाओं के साथ-साथ JAAS का उपयोग करके बहुत विस्तृत पहुँच नियंत्रण और सुरक्षा एकीकरण का समर्थन करता है।

• अधिक जानकारी के लिए देखें https://jspwiki-wiki.apache.org/

पूर्वापेक्षाएँ

ठीक है, तो आप Wiki चाहते हैं? आपको निम्नलिखित चीज़ों की आवश्यकता होगी:

आवश्यक:

• एक JSP इंजन जो Servlet API 3.1 का समर्थन करता है। हम वास्तव में आसान स्थापना के लिए http://tomcat.apache.org/ से Tomcat की सलाह देते हैं। Tomcat 8.x या बाद के संस्करण समर्थित हैं।

• कुछ पिछला प्रशासनिक अनुभव... यदि आपने कभी Apache या कोई अन्य वेब सर्वर स्थापित किया है, तो आपको काफी अच्छी समझ होनी चाहिए।

• और निश्चित रूप से, JSP इंजन चलाने के लिए एक सर्वर।

• JDK 8+

वैकल्पिक:

• java.sun.com से JavaMail पैकेज, यदि आप log4j मेलिंग क्षमताओं का उपयोग करना चाहते हैं। आपको Java Activation Framework की भी आवश्यकता होगी।

बहुत सरल स्थापना

यह अनुभाग आपके लिए है, यदि आप बिना अधिक चिंता के वास्तव में त्वरित स्थापना चाहते हैं। यदि आप अधिक जटिल स्थापना चाहते हैं (चीज़ों को कैसे करना है, इस पर अधिक शक्ति के साथ), तो नीचे दिए गए "Install" अनुभाग देखें।

JSPWiki 2.1.153 के बाद से, JSPWiki एक बहुत ही सरल स्थापना इंजन के साथ आता है। बस निम्नलिखित करें:

1. http://tomcat.apache.org/ से Tomcat स्थापित करें (या कोई अन्य सर्वलेट कंटेनर)

2. डाउनलोड से JSPWiki.war फ़ाइल का नाम बदलें और इसे अपने इच्छित URL के आधार पर नाम बदलें (यदि आप इसे /JSPWiki से अलग चाहते हैं)। उदाहरण के लिए, यदि आप चाहते हैं कि आपका URL http://.../wiki हो, तो इसे wiki.war में बदलें। इस नाम को नीचे के रूप में संदर्भित किया जाएगा। इस WAR को अपने $TOMCAT_HOME/webapps फ़ोल्डर में रखें और फिर Tomcat प्रारंभ करें।

3. अपने ब्राउज़र को http://<myhost>/<appname>/Install.jsp पर इंगित करें

4. कुछ सरल प्रश्नों के उत्तर दें

5. अपने कंटेनर को पुनरारंभ करें

6. अपने ब्राउज़र को http://<myhost>/<appname>/ पर इंगित करें

बस इतना ही!

उन्नत स्थापना

अपने $TOMCAT_HOME/lib फ़ोल्डर (या आपके सर्वलेट कंटेनर के आधार पर समतुल्य) में, एक jspwiki-custom.properties फ़ाइल रखें, जिसमें JSPWiki JAR में डिफ़ॉल्ट ini/jspwiki.properties फ़ाइल के किसी भी ओवरराइड हो सकते हैं। jspwiki-custom.properties फ़ाइल में नहीं रखे गए किसी भी मान के लिए JSPWiki डिफ़ॉल्ट फ़ाइल पर निर्भर करेगा। कस्टम फ़ाइल में उन मानों की तलाश करने के लिए डिफ़ॉल्ट फ़ाइल की समीक्षा करें जिन्हें आप ओवरराइड करना चाह सकते हैं। आपकी कस्टम फ़ाइल में ओवरराइड करने के लिए कुछ सामान्य मानों में jspwiki.xmlUserDatabaseFile, jspwiki.xmlGroupDatabaseFile, jspwiki.fileSystemProvider.pageDir, jspwiki.basicAttachmentProvider.storageDir, और log4j.appender.FileLog.File शामिल हैं। डिफ़ॉल्ट फ़ाइल में टिप्पणियाँ उनके साथ ओवरराइड करने के लिए उपयुक्त मान सुझाएँगी।

कस्टम फ़ाइल को WAR के WEB-INF/ फ़ोल्डर में भी रखा जा सकता है, लेकिन इस फ़ाइल को $TOMCAT_HOME/lib में संग्रहीत करने से आप अपनी अनुकूलन को पुनः सम्मिलित किए बिना JSPWiki WAR को अपग्रेड कर सकते हैं।

jspwiki-corepages.zip की सामग्री को अपनी नवनिर्मित निर्देशिका में अनज़िप करें। आप शेष दस्तावेज़ीकरण JSPWiki-doc.zip फ़ाइल में पा सकते हैं।

(पुनः) टॉमकैट प्रारंभ करें।

अपने ब्राउज़र को http://<where your Tomcat is installed>/MyWiki/ पर इंगित करें। आपको मुख्य विकी पृष्ठ देखना चाहिए। यदि आप पृष्ठों को संपादित करना चाहते हैं तो अगला अनुभाग देखें =)।

WEB-INF/jspwiki.policy फ़ाइल का उपयोग विकी के लिए पहुँच अनुमतियाँ बदलने के लिए किया जाता है।

अतिरिक्त सेटअप और कॉन्फ़िगरेशन सुझावों के लिए Apache JSPWiki वेबसाइट और परियोजना दस्तावेज़ीकरण देखें।

पिछले संस्करणों से उन्नयन

कृपया इस वितरण के साथ उपलब्ध ReleaseNotes और UPGRADING दस्तावेज़ पढ़ें।

संपर्क

प्रश्न jspwiki-users मेलिंग सूची के माध्यम से JSPWiki टीम के सदस्यों और साथी उपयोगकर्ताओं से पूछे जा सकते हैं: देखें http://jspwiki.apache.org/community/mailing_lists.html। कृपया टीम के सदस्यों से सीधे संपर्क करने के बजाय उपयोगकर्ता मेलिंग सूची का उपयोग करें, और चूंकि यह सार्वजनिक अभिलेखागार में संग्रहीत एक सार्वजनिक सूची है, इसलिए अपने प्रश्नों में कोई भी संवेदनशील जानकारी (पासवर्ड, डेटा, आदि) शामिल करने से बचना सुनिश्चित करें।