差分

このページの2つのバージョン間の差分を表示します。

--- ja:toc [2009-11-28 13:30] – kazmiya
+++ ja:toc [2014-07-25 08:01] (現在) – 2014-07-18 09:17 版 106.136.2.122
@@ 行 2: / 行 2: @@
 ====== 目次 ======
-目次 (Table of Contents: TOC) は、セクションの見出しをリストすることによりページの概要を示すものです。目次は、標準のテンプレートではコンテンツ部の右上に位置するボックスの中に表示されます。訪問者は、目次を見てそのページの構造をざっくりと把握することができ、興味のあるセクションに簡単にジャンプすることができます。
+目次は、ページ概要を表示します。
+通常ページ内容の右上隅の簡潔な小さな囲みの中に章の見出しを一覧表示します。
+これによって、利用者はページの構造を把握し、自分の望むページの場所に素早く移動できます。
-DokuWiki 2008-05-05 から、目次をコンテンツ部から切り離して表示するための [[:ja:devel:templates#tpl_toc|tpl_toc()]] 関数を利用できるようになりました。
+ページ上に対象となる見出しが一定数存在する場合のみ、目次は表示されます。
+詳細については、以下の[[#設定]]を参照して下さい。
+===== ヒント =====
+==== 目次の無効化 ====
+[[ja:wiki:syntax#制御用のマクロ|制御用のマクロ]] **''%%~~NOTOC~~%%''** を使用することで、特定のページ上で目次を無効化できます。
+Wiki 内全部で目次を無効化するには、[[ja:config:maxtoclevel|設定項目: maxtoclevel]] か [[ja:config:tocminheads|設定項目: tocminheads]] に 0 を設定して下さい。
+====  ページ題名を目次に表示しない ====
+ページ題名なことも多い、ページの先頭見出しを目次に表示しないようにするには、[[ja:config:toptoclevel|設定項目: toptoclevel]] に 2 を設定して下さい。
 ===== 設定 =====
-  * [[:ja:config:toptoclevel|設定項目: toptoclevel]]
+目次に表示する見出しのレベル（[[ja:config:toptoclevel|設定項目: toptoclevel]]・[[ja:config:maxtoclevel|設定項目: maxtoclevel]]）とページに目次を表示するのに必要な見出し数（[[ja:config:tocminheads|設定項目: tocminheads]]）を制御する設定項目が存在します。
-  * [[:ja:config:maxtoclevel|設定項目: maxtoclevel]]
+  * [[ja:config:toptoclevel|設定項目: toptoclevel]] - 目次に表示される見出しの最上位レベルを設定
+  * [[ja:config:maxtoclevel|設定項目: maxtoclevel]] - 目次に表示される見出しの最下位レベルを設定
+  * [[ja:config:tocminheads|設定項目: tocminheads]] - 目次を表示するのに必要な最小見出し数を設定
+例えば、以下の設定の場合：
+  * toptoclevel = 2 つまり ''====='' （HTML ページ内で <h2> に対応する）
+  * maxtoclevel = 4 つまり ''==='' （HTML ページ内で <h4> に対応する）
+  * tocminheads = 3
+目次付きでページを表示するには、レベル2〜4の見出しが少なくとも三個必要です。
 ===== 開発 =====
-  * [[:ja:devel:templates|テンプレートの開発]]
+  * [[ja:devel:templates|DokuWiki テンプレート開発]]を参照して下さい。
+**''Release 2008-05-05''** 以降、[[ja:devel:templates#tpl_toc|tpl_toc]] 関数は、ページ内容とは分離して目次を表示するのに使用できます。