警告

この記事は古い為 sphinx-users.jp を参照してください。

第10日目 Sphinxドキュメントを編集するその７¶

昨日は toctree ディレクティブを使用してSphinxドキュメントを ツリー構造化 する方法を説明しました。

今日からドキュメントのネットワーク構造(リンクの張り方)の説明をします。

外部URLへのリンク¶

一番単純なURLへのリンクの張り方は、単にURLを記述する事です。

記述例:
```
http://sphinx-users.jp/
```
このように表示されます。

http://sphinx-users.jp/
URLを見せずに文字列を見せたい場合は下記のように記述します。

記述例:
```
`sphinx <http://sphinx-users.jp/>`_
```
このように表示されます。

sphinx

もし、同じリンクを使いまわしたい時は、

まず ターゲット定義 を書く:
```
.. _`sphinx`: http://sphinx-users.jp/
```
記述例:
```
この `sphinx`_ を会得すると、身も心も `sphinx`_ 化してしまい、 どんなドキュメントも `sphinx`_ にしないと気が済まなくなるらしい。
```
このように表示されます。

この sphinx を会得すると、身も心も sphinx 化してしまい、どんなドキュメントも sphinx にしないと気が済まなくなるらしい。

明日はSphinxドキュメント内へのリンクを説明します。

※ このアドベントカレンダーについてはこのアドベントカレンダーについてを参照して下さい。

本家 Sphinx Advent Calendar 2012 10日目～サクラエディタから make html～第11日目 Sphinxドキュメントを編集するその８