リンクを貼りたい

Sphinxでリンクを貼る方法はいくつかあります。

URL直書き

一番シンプルな方法です。前後に半角スペース、もしくは¥+半角スペース(前後に隙間をあけたくない場合)を付けてください。

詳しくは、 http://sphinx-users.jp を参照してください。

適用例

詳しくは、 http://sphinx-users.jp を参照してください。

reSTのインライン構文

一番柔軟に利用できる方法がこれです。生のHTMLではなく、自分の好きなラベルを表示させることができます。

`Sphinxを知りたい方はこちらをクリック <http://sphinx-users.jp>`__

適用例

論文の参考文献のような記述法

外部ターゲットと呼ばれるreSTの構文です。

Sphinxの詳しい情報源: SphinxJP_

.. _SphinxJP: http://sphinx-users.jp

適用例

Sphinxの詳しい情報源: SphinxJP

画像をクリックした時のリンク

:target: オプションを使ってURLを埋め込みます。URL以外にも、Sphinx内で使えるリファレンス名(上記の SphinxJP_)も使えます。

.. image:: /reverse-dict/img/sphinx.png
   :alt: Sphinx-Users.jpのロゴ
   :target: http://sphinx-users.jp

適用例

同じ Sphinx プロジェクト内のドキュメントへのリンク

同じ Sphinx プロジェクト内のドキュメントファイルパス(相対パス/絶対パス、拡張子なし)を :doc: ロールに書くことでリンクになります

くわしい使い方は :doc:`../images/target` に書かれています。

適用例

くわしい使い方は画像からリンクを貼りたいに書かれています。