स्फिंक्स में संख्याओं के साथ संदर्भों को संदर्भित करना और पुन: संरचित पाठ

Question

आरएसटी लिखते समय Sphinx के साथ संसाधित किया जाएगा, मुझे आंकड़ों का संदर्भ देते समय चित्र संख्याओं का उपयोग करने के लिए स्फिंक्स लाटेक्स आउटपुट नहीं मिल सकता है। उदाहरण के लिए, इस कोड:

The lemmings are attacking, as can be seen in :ref:`figlem`. 

.. _figlem: 

.. figure:: _static/lemming_invasion.* 

    They're coming! 

इस में कनवर्ट कर दिया जाएगा:

lemmings हमले कर रहे हैं, के रूप में किया जा देखा जा में वे आ रहे हैं!

/छवि यहाँ जाता है/

चित्र 1.1: वे आ रहे हैं! ,

lemmings हमले कर रहे हैं के रूप में किया जा चित्र 1.1 में

कैसे देखा जा सकता है:

लेकिन क्या मैं चाहता हूँ संदर्भित आंकड़ों के "मानक" LaTeX तरह से, इस तरह है क्या मैं इसे प्राप्त करूं? कोड जो मैं वर्तमान में उपयोग कर रहा हूं वह है स्फिंक्स मैनुअल की सिफारिश करता है, लेकिन यह आउटपुट का उत्पादन नहीं करता है।

Answer 1

numfig एक्सटेंशन बिल्कुल यही करता है। मैंने कोशिश की और यह मेरे लिए काम किया।

Answer 2

मुझे लगता है कि आंकड़े संदर्भित करना अभी तक आरएसटी में लागू नहीं किया गया है, लेकिन यहां वर्कअराउंड http://article.gmane.org/gmane.text.docutils.user/5623 है जो आपको करीब ले जाता है।

Answer 3

कोई कच्चे लेटेक्स कोड, इनलाइन का उपयोग कर सकते हैं। ऊपर दिए गए उदाहरण के लिए, कच्चे लेटेक्स कोड की भूमिका को पहले परिभाषित किया गया है और \ref{} लेटेक्स कमांड के साथ आकृति को संदर्भित करने के लिए उपयोग किया गया है, और \label{} लेटेक्स कमांड के साथ आकृति में लेबल सेट करने के लिए।

निम्नलिखित काम करना चाहिए:

.. role:: raw-latex(raw) 
    :format: latex 

The lemmings are attacking, as can be seen in :ref:`figlem` 
on figure :raw-latex:`\ref{pic:lem}`. 

.. _figlem: 

.. figure:: _static/lemming_invasion.* 

    They're coming! :raw-latex:`\label{pic:lem}` 

ध्यान दें कि \label{} आदेश tex फ़ाइल में शीर्षक के अंदर दिखाई देगा, लेकिन यह अभी भी स्वीकार्य है, कम से कम pdflatex द्वारा। यह भी ध्यान रखें कि :raw-latex से पहले कम से कम एक स्थान होना चाहिए।

Answer 4

स्वीकृत उत्तर पर विस्तार करने के लिए, आप इस सेट को जल्दी से प्राप्त कर सकते हैं। numfig.py फ़ाइल को source निर्देशिका में रखें। तब conf.py खोलने के लिए और लाइन

sys.path.insert(0, os.path.abspath('.')) 

फिर extensions सूची 'numfig' जोड़ने का कहना है कि uncomment। , पहले लेबल अपने आंकड़ा

अपने rst दस्तावेज़ में उपयोग करने के लिए (जैसे, fig-main):

.. _fig-main: 

.. figure:: main.png 

    This is the figure caption. 

अंत में, आप :num: निर्देशों का उपयोग अपने आंकड़ा संख्या संदर्भित कर सकते हैं, इस तरह:

Refer to the main figure (Figure :num:`fig-main`). 

Answer 5

स्फिंक्स के नवीनतम संस्करणों में (1।3+), संख्याओं को आंकड़े और पाठ से संदर्भित करना थोड़ा आसान हो गया है क्योंकि इसके लिए समर्थन अब अंतर्निहित है।

अपने पाठ में, आप की तरह कुछ कर सकते हैं:

.. _label: 
.. figure:: images/figure.* 


At :numref:`label` you can see... 

अंतिम परिणाम की तरह कुछ होना चाहिए "आप देख सकते हैं कि चित्र 1.1 पर ..."। यह तकनीक डिफ़ॉल्ट HTML आउटपुट और लाटेक्स आउटपुट दोनों के साथ काम करती है।

अपनी conf.py फ़ाइल में, ध्वज numfig = True सेट करना सुनिश्चित करें। संदर्भों के टेक्स्ट प्रारूप (numfig_format और numfig_secnum_depth) के लिए कॉन्फ़िगरेशन विकल्प भी हैं।

संदर्भ:

• http://www.sphinx-doc.org/en/stable/config.html#confval-numfig
• http://www.sphinx-doc.org/en/stable/markup/inline.html#cross-referencing-figures-by-figure-number