Định dạng văn bản trong liên kết trong reStructuredText

Question

Làm cách nào để định dạng văn bản trong liên kết được biểu thị trong reStructuredText?

Cụ thể, tôi muốn tạo ra mã HTML sau đây từ đầu tiên của tôi:

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

Kết quả sẽ giống như thế này:

optparse.OptionParser documentation

nơi "optparse.OptionParser "phần nằm trong phông chữ có chiều rộng cố định.

tôi đã cố gắng

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

Tuy nhiên, điều này đã

<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;`_ 

mà trông như thế này

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

Answer 1

cấu trúc này:

Here you have |optparse.OptionParser|_. 

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

tạo HTML này (một số xuống hàng gia tăng):

<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> 

Tôi nhận ra rằng đây không phải chính xác gì bạn yêu cầu là, nhưng có lẽ nó đủ gần. Xem thêm http://docutils.sourceforge.net/FAQ.html#is-nested-inline-markup-possible.

Answer 2

Bạn đã thử intersphinx chưa? Sử dụng phần mở rộng đó, đánh dấu sau:

:py:class:`optparse.OptionParser` 

tạo HTML này:

<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> 

Thử nghiệm với Python 2.6 và Sphinx 1.0.5.

Answer 3

Nếu bạn muốn về cơ bản làm được HTML/CSS tương đương với

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

trong reStructuredText sử dụng Sphinx, bạn có thể làm điều này bằng cách tạo ra một vai trò:

.. role:: red 

Sau đó, bạn sử dụng nó như thế này :

:red:`This is red text` 

Chỉ nên có một dấu tick ` ở cuối của li ne ở trên. Bạn, tất nhiên, phải có

.red { color: red } 

trong tệp CSS của bạn.

Answer 4

Lấy từ trang FAQ cùng tham chiếu bởi mzjn:

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> 

Nó nên về mặt lý thuyết có thể làm những điều phức tạp với điều đó mà không thể được thực hiện với RST.