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

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

Cụ thể, tôi muốn tạo HTML sau từ lần đầu tiên của mình:

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

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

optparse.OptionParser tài liệu

trong đó phần "optparse.OptionParser" ở phông chữ có độ rộng cố định.

Tôi đã thử

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

tuy nhiên, điều này đã cho

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

trông như thế này

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

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 ra HTML này (một số dấu ngắt dòng được thêm vào):

<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 là chính xác những gì bạn yêu cầu, nhưng có lẽ nó đủ gần. Xem thêm http://docutils.sourceforge.net/FAQ.html#is-nested-inline-markup-possible .

Bạn đã thử interphinx chưa? Sử dụng tiện ích mở rộng đó, đánh dấu sau:

:py:class:`optparse.OptionParser`

tạo ra 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.

Lấy từ cùng một trang Câu hỏi thường gặp do mzjn tham khảo:

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>

Về lý thuyết, có thể làm những việc phức tạp mà không thể làm được với RST.

Nếu bạn muốn về cơ bản, hãy lấy HTML / CSS tương đương với

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

trong reStructuredText bằng Sphinx, bạn có thể thực hiện việc này bằng cách tạo 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 dòng trên. Bạn, tất nhiên, phải có

.red { color: red }

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