2012-12-14 16 views
10

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

तो मैं info field lists से परिचित हूं और मैं अपने दस्तावेज़ों में cross-referencing का उपयोग करने से परिचित हूं।

हालांकि, किसी विधि या फ़ंक्शन के लिए डॉकस्ट्रिंग लिखते समय मुझे टेक्स्ट में उनके पैरामीटर को संदर्भित करना उपयोगी लगता है। लेकिन ऐसा करने के लिए एक संरचित तरीका प्रतीत नहीं होता है।

  1. हम कह सकते हैं उदा।

    Use ``name`` to set the username 
    

    लेकिन है कि कोई संरचना है, क्या शैली तुम उस के लिए इस्तेमाल किया है और यदि आप शैली बदलने के आप शिकार और सभी गलत शैलियों को मारने के लिए है याद करने के लिए की आवश्यकता है।

  2. : param: एक जानकारी क्षेत्र सूची के बाहर काम नहीं करता है तो आप

    Use :param:`name` to set the username 
    
  3. नहीं लिख सकते हैं मैंने देखा है कुछ परियोजनाओं का उपयोग करें: parm: लेकिन यह है कि दस्तावेज और नहीं करता है नहीं कर रहा है काम नहीं लग रहा है। तो उनके पास कुछ अनुकूलन होना चाहिए

  4. मैं जेनेरिक_रोल्स का उपयोग कर सकता हूं लेकिन ऐसा लगता है कि मुझे ऐसी समस्या के आसपास काम करना है जो मुझे यकीन है कि दूसरों का सामना करना पड़ा है।

तो उम्मीद है कि मैंने कुछ अंधेरे से स्पष्ट रूप से याद किया है।

उत्तर

2

आप autodoc-process-docstring का उपयोग करके अपना खुद का एक्सटेंशन लिख सकते हैं - यह वास्तव में सरल है।

एक्सटेंशन :param: के लिए खोज करें और इसे अपनी शैली की पसंद के साथ बदलें।

+0

ऐसा लगता है कि जेनेरिक_रोल्स पहले से मौजूद है और यह अधिक सही तरीके से कर सकता है। – Dwayne