ja:toc
目次
目次は、ページ概要を表示します。 通常ページ内容の右上隅の簡潔な小さな囲みの中に章の見出しを一覧表示します。 これによって、利用者はページの構造を把握し、自分の望むページの場所に素早く移動できます。
ページ上に対象となる見出しが一定数存在する場合のみ、目次は表示されます。 詳細については、以下の設定を参照して下さい。
ヒント
目次の無効化
制御用のマクロ ~~NOTOC~~
を使用することで、特定のページ上で目次を無効化できます。
Wiki 内全部で目次を無効化するには、設定項目: maxtoclevel か 設定項目: tocminheads に 0 を設定して下さい。
ページ題名を目次に表示しない
ページ題名なことも多い、ページの先頭見出しを目次に表示しないようにするには、設定項目: toptoclevel に 2 を設定して下さい。
設定
目次に表示する見出しのレベル(設定項目: toptoclevel・設定項目: maxtoclevel)とページに目次を表示するのに必要な見出し数(設定項目: tocminheads)を制御する設定項目が存在します。
- 設定項目: toptoclevel - 目次に表示される見出しの最上位レベルを設定
- 設定項目: maxtoclevel - 目次に表示される見出しの最下位レベルを設定
- 設定項目: tocminheads - 目次を表示するのに必要な最小見出し数を設定
例えば、以下の設定の場合:
- toptoclevel = 2 つまり
=====
(HTML ページ内で <h2> に対応する) - maxtoclevel = 4 つまり
===
(HTML ページ内で <h4> に対応する) - tocminheads = 3
目次付きでページを表示するには、レベル2〜4の見出しが少なくとも三個必要です。
開発
- DokuWiki テンプレート開発を参照して下さい。
Release 2008-05-05
以降、tpl_toc 関数は、ページ内容とは分離して目次を表示するのに使用できます。
ja/toc.txt · 最終更新: 2014-07-25 08:01 by 106.136.2.122