Jeffrey Cross
Jeffrey Cross

ओ'रेली के लिए एक हैक कैसे लिखें

[एड नोट: यह मूल रूप से 30 अगस्त, 2005 को O’Reilly नेटवर्क पर पोस्ट किया गया था।]

O’Reilly's Hacks श्रृंखला के लिए मुख्य संपादक के रूप में, मैं दैनिक आधार पर Hacks पुस्तकों के लिए प्रस्ताव रखता हूं। मेरे पास आम तौर पर अधिग्रहण, लेखन, या उत्पादन के विभिन्न चरणों में कई किताबें हैं, जिनमें से सभी में लेखक हैं और (यह हैक्स) कई योगदानकर्ता हैं। जिन टॉपिक क्षेत्रों के बारे में हम प्रकाशित करना चाहते हैं, उन सवालों से परे, जो प्रश्न सबसे अधिक बार आते हैं, वे आमतौर पर विषय की विविधता पर होते हैं। क्या हैक करता है तथा कैसे लिखा जाना चाहिए.

मैं लंबे समय से वर्तमान और भावी लेखकों, योगदानकर्ताओं, और अन्य ओ'रेली संपादकों (अपने लेखकों के साथ साझा करने के लिए) के लिए कुछ लिखना चाहता था, जो वास्तव में "दिलचस्प समस्या के लिए एक गैर-स्पष्ट समाधान" से हमारा मतलब बताता है। , मेरे पास ऐसा करने के लिए समय नहीं था, इसलिए मैं अक्सर कुछ समझाने की कोशिश करने के विभिन्न दौर से गुजरता हूं, जब यह सही हो जाता है, तो आपको वास्तव में बस कमर कसने की जरूरत है। दुर्भाग्य से, शब्द पर एक ठीक बिंदु लगाने के कुछ प्रयासों के बाद किराये का (जैसा कि O’Reilly द्वारा उपयोग किया जाता है), मैं अक्सर एक विवरण का सहारा लेता हूं जो जस्टिस स्टीवर्ट की अश्लीलता की बदनाम परिभाषा से बहुत बेहतर नहीं है: अर्थात्, "जब मैं इसे देखता हूं तो मुझे पता है।"

आज, मैं पॉल बॉश के साथ एक नई परियोजना पर चर्चा कर रहा था, जिसने खुद को श्रृंखला के लिए एक मॉडल लेखक के रूप में स्थापित किया है (अमेज़ॅन हैक्स सहित,) आगामी याहू! हैक्स, एक के रूप में अभी तक अघोषित तीसरे Hacks शीर्षक, फ़्लिकर हैक्स, और गूगल हैक्स, तीसरा संस्करण), और मैंने सीखा कि उन्होंने चुपचाप इस विषय पर अपना स्वयं का मसौदा तैयार किया है। पॉल के लेखक, जो पर्यवेक्षण या मार्गदर्शन की कम आवश्यकता के साथ हैक्स प्रारूप को ग्रो करते हैं, इसलिए मुझे उनके परिप्रेक्ष्य में विशेष रूप से दिलचस्पी थी। वह निराश नहीं हुआ, इसलिए मैंने उसे अपनी ऋषि सलाह दुनिया के साथ साझा करने के लिए कहा। शुक्र है, वह सहमत हो गया। उसने जो कुछ भी अपने रूप में वर्णित किया है हैक टेम्पलेट:

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

  1. क्यों इस हैक की जरूरत है (कहानी, इच्छा का निर्माण)
  2. प्रासंगिक विशेषताओं का वर्णन करें
  3. हैक पूर्वापेक्षाएँ
  4. हैक कोड / प्रक्रिया
  5. हैक इन एक्शन का उदाहरण
  6. संक्षिप्त सारांश (क्यों पाठक चट्टानों!)

  7. यदि संभव हो, तो विकल्प को हैक करें

जब भी संभव हो मैं कोड के पारंपरिक हैक हेडिंग का उपयोग करता हूं और कोड को अलग-अलग 4 और 5 भागों में चलाता हूं।

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

यदि आप हॅक्स सीरीज़ के लिए लिखने की सोच रहे हैं, वर्तमान में हमारे लिए लिख रहे हैं, या बस एक पीछे के दृश्य को देखना चाहते हैं कि सॉसेज कैसे बनाया जाता है, तो आप निश्चित रूप से इसे याद नहीं करना चाहते हैं।

शेयर

एक टिप्पणी छोड़