91

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

このように見える

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

4

4 に答える 4

97

この構造:

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も参照してください。

于 2011-01-29T11:11:35.490 に答える
7

インタースフィンクスを試しましたか?その拡張機能を使用して、次のマークアップ:

: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 でテスト済み。

于 2011-01-20T17:57:59.887 に答える
4

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 では実行できない複雑なことを実行できるはずです。

于 2014-01-10T19:24:36.983 に答える
0

基本的にHTML/CSSに相当するものを取得したい場合

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

Sphinx を使用した reStructuredText では、ロールを作成することでこれを行うことができます。

.. role:: red

次に、次のように使用します。

:red:`This is red text`

`上の行の最後に目盛りが 1 つだけあるはずです。もちろん、持っている必要があります

.red { color: red }

あなたのCSSファイルで。

于 2011-08-04T17:51:42.010 に答える