पुनर्संरचना में एक कड़ी में पाठ प्रारूप

Question 1

आप reStructuredText में एक निरूपित लिंक के भीतर पाठ को कैसे प्रारूपित करते हैं?

विशेष रूप से, मैं अपने rst से निम्न HTML उत्पन्न करना चाहता हूं:

<a href="http://docs.python.org/library/optparse.html"><tt>optparse.OptionParser</tt> documentation documentation</a>

परिणाम इस तरह दिखना चाहिए:

optparse.OptionParser प्रलेखन

जहां "Optparse.OptionParser" भाग निश्चित-चौड़ाई वाले फ़ॉन्ट में है।

मैंने कोशिश की

```optparse.OptionParser`` <http://docs.python.org/library/optparse.html>`_

हालाँकि, यह दिया गया

<tt class="docutils literal">`optparse.OptionParser</tt> documentation &lt;<a class="reference external" href="http://docs.python.org/library/optparse.html">http://docs.python.org/library/optparse.html</a>&gt;`_

जो इस तरह दिखता है

`` Optparse.OptionParser documentation <http://docs.python.org/library/optparse.html>\_

Question 2

यह निर्माण:

Here you have |optparse.OptionParser|_.

.. |optparse.OptionParser| replace:: ``optparse.OptionParser`` documentation
.. _optparse.OptionParser: http://docs.python.org/library/optparse.html

इस HTML का उत्पादन करता है (कुछ लाइनब्रेक जोड़े गए):

<p>Here you have 
  <a class="reference external" href="http://docs.python.org/library/optparse.html">
  <tt class="docutils literal"><span class="pre">optparse.OptionParser</span></tt> documentation</a>.
</p>

मुझे एहसास है कि यह वही नहीं है जो आपने पूछा था, लेकिन शायद यह काफी करीब है। Http://docutils.sourceforge.net/FAQ.html#is-nested-inline-markup-possible भी देखें ।

Question 3

क्या आपने इंटरसेफिंक्स की कोशिश की है ? उस एक्सटेंशन का उपयोग करते हुए, निम्नलिखित मार्कअप:

:py:class:`optparse.OptionParser`

इस HTML का उत्पादन करता है:

<a class="reference external" href="http://docs.python.org/2.6/library/optparse.html#optparse.OptionParser" title="(in Python v2.6)"><tt class="xref py py-class docutils literal"><span class="pre">optparse.OptionParser</span></tt></a>

पायथन 2.6 और स्फिंक्स 1.0.5 के साथ परीक्षण किया गया।

Question 4

Mzjn द्वारा संदर्भित एक ही FAQ पृष्ठ से लेना:

The "raw" directive can be used to insert raw HTML into HTML output:

Here is some |stuff|.

.. |stuff| raw:: html

   <em>emphasized text containing a
   <a href="http://example.org">hyperlink</a> and
   <tt>inline literals</tt></em>

सिद्धांत रूप में इसके साथ जटिल चीजें करना संभव होना चाहिए जो कि आरएसटी के साथ नहीं किया जा सकता है।

Question 5

यदि आप अनिवार्य रूप से HTML / CSS के बराबर प्राप्त करना चाहते हैं

<span class="red">This is red text</span>

Sphinx का उपयोग करके reStructuredText में, आप एक भूमिका बनाकर ऐसा कर सकते हैं:

.. role:: red

तो आप इसे इस तरह से उपयोग करें:

:red:`This is red text`

`ऊपर की रेखा के अंत में केवल एक टिक मार्क होना चाहिए । तुम, ज़ाहिर है, है

.red { color: red }

अपने सीएसएस फ़ाइल में।