.. index:: contents, directive; contents ページ内の目次を作りたい ------------------------ ``contents`` を使います。 ``contents`` はページ内のセクションに対してリンクを作ります。以下のオプションが使えます。 文字列 目次のタイトルを指定します。必ず他のオプションより先か、 ``contents`` ディレクティブと同じ行に書いてください。 \:depth: <数値> 目次に含めるセクションの深さを指定します。指定がない場合はすべてのセクションを目次に含めます。 \:local: このディレクティブ以降にあるセクションだけを目次に含めます。指定がない場合はページ内のセクションをすべて含む目次を作ります。 また、このオプションを指定すると目次のタイトルがなくなりますので、別途指定してください。 \:backlinks: セクションから目次に戻るリンク(バックリンク)に対しての動作を決めます。以下の引数を持ちます。 +------+---------------------------------------------------------+ |引数 |動作 | +======+=========================================================+ |entry |目次の各項目に対してバックリンクを作ります(デフォルト)。 | +------+---------------------------------------------------------+ |top |目次のタイトルに対してバックリンクを作ります。 | +------+---------------------------------------------------------+ |none |バックリンクを作りません。 | +------+---------------------------------------------------------+ ~~~~~~ 適応例 ~~~~~~ .. code-block:: rst .. contents:: これは目次です :depth: 2 .. contents:: これは目次です :depth: 2