プロジェクト内へのリンク
=========================

.. highlight:: rest


ドキュメントへのリンク
-----------------------
* 他のドキュメント( :term:`rstファイル` )へリンクを張りたい時は ``:doc:`` というマークアップをします。

  記述例::

     昨日のタイトルは :doc:`../10/write_rest7` です。一昨日は :doc:`toctree <../09/write_rest6>` について説明しましたね。

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

    昨日のタイトルは :doc:`../10/write_rest7` です。一昨日は :doc:`toctree <../09/write_rest6>` について説明しましたね。

* ファイルへのパスは拡張子が不要です。
* ファイルパスはドキュメントの起点となる *index.rst* を */ (ルート)* とした絶対パスか、相対パスで記述して下さい。

.. _link_section:

セクションへのリンク
---------------------

アンカーを設置する
~~~~~~~~~~~~~~~~~~~
* :term:`セクション` へリンクを張る為にはリンクを張りたい :term:`セクション` にアンカーを配置する必要があります。

  .. note:: :term:`セクション` は同じ :term:`プロジェクト` 内であれば違う :term:`rstファイル` であっても構いません。

  記述例::

         .. _schedule:

         タイトル(予定かつ順不同)
         -------------------------

  アンカー自体は表示されません。

アンカーを配置したセクションへリンクする
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* ``:ref:`` でセクションへリンクします。

  記述例::


        このアドベントカレンダーについての :ref:`schedule` へジャンプしましょう。

        :ref:`こういう書き方 <schedule>` もできますよ。

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

        このアドベントカレンダーについての :ref:`schedule` へジャンプしましょう。

        :ref:`こういう書き方 <schedule>` もできますよ。

  .. note:: アンカーは前に **:: (セミコロン×2)** と文字列の頭に **_ (アンダーバー)** が付いていますが ``:ref:`` で指定する際はどちらも外します。