मेरी कंपनी मीडियाविकी का उपयोग कर अंतिम उपयोगकर्ता/डेवलपर दस्तावेज़ों पर काम कर रही है। मैं बहुत से एपीआई दस्तावेज़ लेना चाहता हूं जो phpdoc थूक आउट (विशिष्ट कार्यों/विधियों के लिए) और इसे आसान हस्तांतरण के लिए विकी मार्कअप में रखें।phpDocumentor?
phpDoc से विकी मार्कअप या विकी आउटपुट प्राप्त करने के लिए वहां कोई समाधान है? मैंने चारों ओर देखा है और कुछ भी नहीं मिला है।
एक विकल्प (मेरे सिर के ऊपर से) APIWiki में मीडिया निर्माण में उपयोग करना है, और डेटा को स्वयं पोस्ट करना है। (निश्चित रूप से स्क्रिप्ट के माध्यम से)।
एकमात्र अन्य तरीका phpDoc को हैक करना होगा, और फिर भी, आपको इसे किसी भी तरह MediaWiki पर पोस्ट करना होगा।
PHPDocumentor वेबसाइट के अनुसार और उनके documentation HTML और XML आउटपुट संभव है। इसके बाद आप मीडियाविकि की अंतर्निहित import सुविधाओं का उपयोग करके एक्सएमएल आयात कर सकते हैं, हालांकि आप एक्सएमएल के प्रारूप को देखने के लिए पहले निर्यात करना चाहते हैं। वे यह भी उल्लेख करते हैं कि बड़ी मात्रा में डेटा आयात करने के लिए एक्सएमएल का उपयोग समय-समय पर हो सकता है और एक विकल्प है जो आपको डेटा डालने के लिए SQL क्वेरी बनाने की अनुमति देता है। इसके अलावा आपको शायद मीडियाविकी के लिए कोड दिखाने के लिए एक एक्सटेंशन की आवश्यकता होगी (SyntaxHighlight GeSHi जैसे कुछ)।
यह सब वास्तव में यह नहीं बताता है कि PHPWocumentor के आउटपुट को मीडियाविकि (यानी विकी वाक्यविन्यास का उपयोग करके) में उपयोग करने योग्य तरीके से कैसे परिवर्तित किया जाए। सबसे अधिक संभावना है कि आप एक वाक्यविन्यास को दूसरे में परिवर्तित करने के लिए स्क्रिप्ट का उपयोग करेंगे। ऐसा लगता है कि PHPDocumentor के माध्यम से अपना खुद का आउटपुट प्रारूप बनाना सबसे आसान तरीका है (हालांकि एक्सएमएल के रूप में आउटपुट करना: डॉकबुक काम कर सकता है)।
आप एक एक्सएसएलटी स्क्रिप्ट का उपयोग कर एक एक्सएमएल दस्तावेज़ को अलग-अलग संरचित एक्सएमएल में भी परिवर्तित कर सकते हैं। काफी आसान, और अच्छा प्रदर्शन है। –
phpDoc से Twiki आउटपुट उत्पन्न करने के लिए एक रास्ता तलाशते समय बस इस पर आया। मुझे इसके लिए कोई अच्छा समाधान नहीं मिला है और इस पर एक प्रोजेक्ट शुरू किया है: http://step2.co.in/content/phpdoc-twiki इस पर काम शुरू करने के लिए। अगर कोई मदद करने में रूचि रखता है, तो कृपया संपर्क में रहें।
क्या आपने कभी समाधान ढूंढ लिया है या विकसित किया है? मुझे इस तरह के समाधान में दिलचस्पी है। –