2012-08-16 12 views
29

में बोल्ड इटालिक, मैं स्फिंक्स का उपयोग कर बाद वाली वेब पेज पीढ़ी के लिए पुन: संरचित टेक्स्ट (रीस्ट) प्रारूप का उपयोग करके कुछ दस्तावेज लिख रहा हूं, और मुझे कुछ "बोल्ड इटैलिक" टेक्स्ट लिखने का कोई तरीका नहीं मिल रहा है।ReStructuredText

तथाकथित 'जोर' (इटैलिक) और 'ज्यादा जोर दिया' (बोल्ड) पाठ के लिए मार्कर रहे हैं। वे *italic text* और **bold text** क्रमशः हैं। मैंने इस प्रारूप पर कुछ दस्तावेज में भी पढ़ा है कि इन स्वरूपण मार्करों को बस "नेस्टेड" नहीं किया जा सकता है। अर्थात। ***text*** (या ** *text* **) बोल्ड इटैलिक टेक्स्ट का उत्पादन नहीं करता है।

अभी भी बोल्ड और इटालिक मार्करों के साथ जोर देने वाले पाठ का उत्पादन करने का कोई तरीका होना चाहिए, क्योंकि यह टेक्स्ट के टुकड़ों को चिह्नित करने के लिए एक व्यापक अभ्यास है।

उत्तर

17

हालांकि Markdown नेस्टिंग बोल्ड और इटैलिक का समर्थन करता है, reStructuredText नहीं (के रूप में वहाँ reStructuredText में बोल्ड इटैलिक प्रतिनिधित्व करने के लिए कोई रास्ता नहीं है यह, दुर्लभ मामलों में जहां Markdown अधिक शक्तिशाली है में से एक है)।

https://gist.github.com/1855764

+6

दुर्लभ मामलों में से एक है, लेकिन एक महत्वपूर्ण! – Dacav

+5

नहीं, यह गलत है ("पुनर्वित्तित पाठ में बोल्ड इटालिक्स का प्रतिनिधित्व करने का कोई तरीका नहीं है")। वास्तव में कई अलग-अलग विधियां हैं (जैसा कि अन्य उत्तरदाताओं द्वारा इंगित किया गया है)। मैं सहमत हूं - हालांकि - यह दुर्भाग्यपूर्ण है कि यह स्ट्रिंग के दोनों तरफ ट्रिपल '*' के माध्यम से "बॉक्स से बाहर" समर्थित नहीं है ... – mac

8

स्फिंक्स में इस custome भूमिकाओं के माध्यम से संभव है: आप सीएसएस में एक शैली बनाने के लिए, और एक भूमिका है कि शैली की ओर इशारा करते हैं। यहां रेखांकित पाठ का एक पूर्ण कार्य उदाहरण है: sphinx-dev thread

संपादित: HTML आउटपुट के लिए ReST strikethrough

8

पकाने की विधि:

यहाँ एक अच्छा उदाहरण है।

my.rst:

.. role:: red 
    :class: red 

.. role:: boltitalic 
    :class: boltitalic 

:red:`WARNING` :boltitalic:`Don't be stupid!` 

my.css:

.red { color: red; } 
.boltitalic { 
    font-weight: bold; 
    font-style: italic; 
} 

बिल्ड द्वारा:

rst2html --strip-comments --halt warning --stylesheet=my.css my.rst my.html