प्रारूपण / वेब-प्रकाशन ट्यूटोरियल-प्रकार, तकनीकी लेखों के लिए सॉफ्टवेयर

Question

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

मेरे लेख एक ब्लॉग के रूप में नहीं हैं, वे सिर्फ ट्यूटोरियल के संग्रह के रूप में हैं और कैसे-कैसे हैं, लेकिन मुझे लगता है कि ब्लॉग-प्रकार का सॉफ़्टवेयर संभवतः उस तरह के सामान को प्रारूपित करने का सबसे उपयुक्त तरीका होगा।

अभी मैं cite u जैसे ब्लॉग फीचर का उपयोग कर रहा हूं, जो बहुत कम तकनीक है और मुझे वास्तव में कुछ बेहतर करने की आवश्यकता है। मेरी इच्छा सूची में, अन्य बातों के अलावा:

• स्क्रॉल करने योग्य बक्से में कोड स्निपेट
• स्रोत कोड स्निपेट के लिए सिंटैक्स हाइलाइटिंग
• विषय के अनुसार आलेखीय चिह्नों के साथ लेखों को टैग करना, जैसे स्लैशडॉट में
• बेशक उपयोगकर्ताओं (यानी पाठकों) लेख पर टिप्पणी करने में सक्षम होना चाहिए
• इसके अलावा, एक सुपर-सरल ब्लॉग की तुलना में सिर्फ अधिक विकल्प
• चालाक दिखना चाहिए! विकिपीडिया की तरह नहीं दिखना चाहिए

क्या कोई ऐसा सॉफ़्टवेयर है जिसे आप इस उद्देश्य के लिए सुझा सकते हैं?

Comments

क्या आप स्वयं इसकी मेजबानी करेंगे?

— डैनियल एंडर्सन

@ डैनियल एंडरसन: हाँ। मुझे "सेवा के रूप में सॉफ़्टवेयर" या ऐसी कोई चीज़ नहीं चाहिए जहाँ मेरा कुल नियंत्रण न हो। ओपन सोर्स होगा तो बेस्ट होगा।

Answer 1

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

यह सुपर सरल ब्लॉग के अंतर्गत आता है - यदि आप अधिक सुविधाएँ चाहते हैं, तो वर्डप्रेस एक विकल्प है।

Answer 2

ऑनलाइन तकनीकी दस्तावेज़ीकरण के लिए, उदाहरण के लिए http://sphinx.pocoo.org/ जैसी कोई चीज़ कैसे ?

Answer 3

यह सबसे मुख्यधारा की पसंद नहीं है, लेकिन मुझे वास्तव में ikiwiki ( जो डेबी प्रसिद्धि के जॉय हेस द्वारा ) पसंद है। यह पर्ल में लिखी गई प्रणाली है जो डिफ़ॉल्ट मार्काडाउन पेजों को स्थिर HTML फाइलों में संकलित करता है । इसका "ब्लॉग" टेम्प्लेट आप जो करना चाहते हैं उसके लिए काम करता है।

सबसे पहले और सबसे महत्वपूर्ण, यह प्रणाली बहुत ही लचीली है और जो कुछ भी अपने बहुत ही डिजाइन के द्वारा करना चाहता है वह करने में सक्षम है। बेसिक पर्ल के साथ, कस्टम आसानी और समय के साथ कस्टम प्लगइन्स भी बना सकते हैं।

पूरा सिस्टम संस्करण नियंत्रण प्रणालियों, जैसे Git पर बनाया गया है। सामग्री के प्रतिबद्ध होने पर साइट को फिर से बनाया गया है (अच्छी तरह से, प्रासंगिक भागों) , जो अंतर्निहित सुविधा के रूप में संस्करण नियंत्रण देता है।

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

अपने डिफ़ॉल्ट कॉन्फ़िगरेशन में, यह मेरी राय में काफी गैर-मनभावन लगता है, लेकिन स्थानीय सीएसएस फ़ाइल के साथ हर पहलू शैलीगत है।

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