[python-sphinx] reStructuredText에서 링크의 텍스트 서식 지정

Program / 글쓴이

reStructuredText에서 표시된 링크 내의 텍스트 서식을 어떻게 지정합니까?

특히 내 첫 번째에서 다음 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>\_

답변

이 구성 :

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 도 참조하십시오 .

답변

intersphinx 를 사용해 보셨습니까 ? 해당 확장을 사용하여 다음 마크 업을 사용합니다.

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

Python 2.6 및 Sphinx 1.0.5로 테스트되었습니다.

답변

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>

이론적으로 RST로는 할 수없는 복잡한 일을 할 수 있어야합니다.

답변

본질적으로 HTML / CSS를 얻으려면 

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

Sphinx를 사용하는 reStructuredText에서 역할을 생성하여이를 수행 할 수 있습니다.

.. role:: red

그런 다음 다음과 같이 사용합니다.

:red:`This is red text`

`위 줄 끝에 체크 표시가 하나만 있어야합니다 . 물론 당신은 

.red { color: red }

CSS 파일에서.

답변