1. ホーム
  2. python-sphinx

[解決済み] reStructuredTextでリンク内のテキストをフォーマットする

2023-03-16 23:58:47

質問

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

どのように解決するのですか?

この構成です。

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 .