इस पर कुछ और देखने के बाद मैंने डॉक्यूमेंट रीस्ट्रक्टर्डटेक्स्ट इंटरप्रिटेड टेक्स्ट रोल्स पर ठोकर खाई । इस दस्तावेज़ से:
व्याख्या किए गए पाठ पाठ के चारों ओर backquotes (`) का उपयोग करता है। एक स्पष्ट भूमिका मार्कर वैकल्पिक रूप से पाठ से पहले या बाद में दिखाई दे सकता है, जिसे कॉलन के साथ सीमांकित किया गया है। उदाहरण के लिए:
This is `interpreted text` using the default role.
This is :title:`interpreted text` using an explicit role.
ऐसा लगता है कि एक code
भूमिका है , इसलिए आप बस टाइप कर सकते हैं
:code:`a = b + c`
एक इनलाइन कोड ब्लॉक को रेंडर करने के लिए। सिंटैक्स हाइलाइट करने के लिए आप एक कस्टम भूमिका को परिभाषित कर सकते हैं। उदाहरण के लिए
.. role:: bash(code)
:language: bash
जिसके बाद आप इसका उपयोग कर सकते हैं:
Here is some awesome bash code :bash:`a = b + c`.
ध्यान दें कि भूमिका की परिभाषा भूमिका के संदर्भ से पहले रखी जानी चाहिए।
ध्यान दें, जिस दस्तावेज़ को मैं लिंक करता हूं, वह डोकुटिल के संस्करण का कोई उल्लेख नहीं करता है, जिसके लिए यह संदर्भित है। कोड भूमिका docutils 0.8.1 में उपलब्ध नहीं है (जो कि एकमात्र संस्करण है जिसके खिलाफ मुझे परीक्षण करना है)।