.. index:: refer

.. _writing-refer:

参照 (Internal Hyperlink) したい
------------------------------------

同じ文書中の他の項や節を参照するには、Internal Hyperlinkを使います。

.. code-block:: rst

  .. _sample:
  
  ---------------
  定義
  ---------------
  
このように、章や節の上に記述して定義しておきます。別の場所から参照する
には以下のように書きます。

.. code-block:: rst

  ------------
  他の場所で
  ------------
  
  参照は :ref:`sample` としても参照できますし、
  :ref:`ほげほげ<sample>` として任意のテキストでも参照できます。

テキストを指定しない場合、参照先のセクションタイトルを自動的に挿入して
くれます。また、この場合は ``<>`` をつけないことに気をつけてください。

また、定義する時にはアンダーバー( ``_`` )を先頭に付けますが、参照する時にはこ
のアンダーバーは必要ありません。

.. _sample:
  
~~~~~~~~~~
適用例
~~~~~~~~~~

参照は :ref:`sample` としても参照できますし、
:ref:`ほげほげ<sample>` として任意のテキストでも参照できます。