Sphinx Advent Calendar 2012 (全部俺)

初心者がどのようにSphinxを使ってきたかという記録

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

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

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

外部URLへのリンク

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

    記述例:

    http://sphinx-users.jp/
    

    このように表示されます。

  • URLを見せずに文字列を見せたい場合は下記のように記述します。

    記述例:

    `sphinx <http://sphinx-users.jp/>`_
    

    このように表示されます。

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

    まず ターゲット定義 を書く:

    .. _`sphinx`: http://sphinx-users.jp/
    

    記述例:

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

    このように表示されます。

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

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

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